Bagikan melalui

Mengonfigurasi Adapter FTP

  • Artikel

Sebelum Anda mulai

  • Adaptor FTP mendukung pembacaan dan penulisan data dari server FTP yang aman. Adaptor menyediakan dukungan untuk transfer file dari server FTP melalui Secure Sockets Layer (SSL)/Transport Level Security (TLS).
  • Adaptor FTP mendukung pengunduhan file dari lokasi file baca-saja.
  • Adaptor FTP juga mendukung transfer file atom untuk mode ASCII.

Lihat Praktik terbaik dan rekomendasi untuk adaptor FTP.

Mengonfigurasi lokasi penerimaan

Anda dapat mengatur properti adaptor lokasi terima FTP di konsol Administrasi BizTalk Server. Jika properti tidak diatur di lokasi terima, maka nilai handler penerima default di konsol Administrasi BizTalk Server digunakan.

Catatan

Sebelum menyelesaikan prosedur berikut, Anda harus sudah menambahkan port penerima. Lihat Cara Membuat Port Penerima.

  1. Di konsol Administrasi BizTalk Server, perluas BizTalk Server Administration, perluas BizTalk Group, perluas Aplikasi, lalu perluas aplikasi tempat Anda ingin membuat lokasi penerimaan.

  1. Di panel kiri, klik simpul Terima Port . Di panel kanan, klik kanan port terima yang terkait dengan lokasi penerima yang sudah ada atau yang ingin Anda kaitkan dengan lokasi penerimaan baru, lalu klik Properti.

  2. Dalam kotak dialog Terima Properti Port , di panel kiri, pilih Terima Lokasi. Di panel kanan, klik dua kali lokasi terima yang sudah ada atau klik Baru untuk membuat lokasi penerimaan baru.

  3. Dalam kotak dialog Terima Properti Lokasi , di bagian Transportasi di samping Jenis, pilih FTP dari daftar drop-down lalu klik Konfigurasikan.

  4. Di Properti Transportasi FTP, lakukan hal berikut:

    Batch

    Gunakan ini Untuk melakukan ini
    File Maksimum Tentukan jumlah maksimum file per batch BizTalk Server.

    Nol (0) menunjukkan tidak ada batasan.

    Nilai default: 0
    Ukuran Maksimum Tentukan jumlah maksimum byte per batch BizTalk Server.

    Nol (0) menunjukkan tidak ada batasan.

    Nilai default: 0

    Firewall

    Gunakan ini Untuk melakukan ini
    Alamat Tentukan alamat firewall, baik nama DNS atau alamat IP.
    Mode Tentukan mode di mana adaptor tersambung ke server FTP.

    Nilai yang valid: Pasif dan Aktif

    Dalam mode aktif, server FTP tersambung ke port yang dibuka oleh adaptor FTP. Dalam mode pasif, adaptor FTP tersambung ke port yang dibuka oleh server FTP. Mode aktif mungkin tidak berfungsi jika Anda menggunakan IP internal dan Anda tersambung ke IP eksternal. Dalam hal ini, Anda perlu menggunakan mode Pasif atau mode Aktif dengan gateway lapisan aplikasi (ALG) dengan dukungan FTP.

    Nilai default: Aktif
    Kata sandi Tentukan kata sandi untuk firewall.
    Port Tentukan port untuk firewall.

    Nilai yang valid: 1 hingga 65535 inklusif

    Nilai default: 21
    Jenis Tentukan jenis firewall yang disebarkan.

    Nilai yang valid: None, Socks 4, dan Socks 5

    Nilai default: Tidak
    Pengguna Tentukan nama pengguna untuk firewall.

    FTP

    Gunakan ini Untuk melakukan ini
    Akun Tentukan nama akun untuk server FTP. Opsi ini tidak digunakan lagi dan penggunaan properti ini tidak disarankan.
    Setelah Dapatkan Tentukan perintah FTP yang akan dijalankan setelah file GET. Pisahkan perintah dengan titik koma (;).
    Sebelum Dapatkan Tentukan perintah FTP yang akan dijalankan sebelum file GET. Pisahkan perintah dengan titik koma (;). Catatan: Perintah QUIT tidak didukung sebelum file GET.
    Ambang Kesalahan Tentukan jumlah kesalahan yang dapat ditemui BizTalk Server sebelum lokasi dinonaktifkan.

    Nilai default: 10
    Masker File Tentukan filter masker file yang akan digunakan saat mengirimkan file.
    Folder Tentukan lokasi polling pada server FTP.
    Jenis Server FTP Baru dimulai dengan BizTalk Server 2016.

    Gunakan properti ini untuk memilih server FTP yang tidak memerlukan perintah SYST. Opsinya adalah None, AIX, Detect, GXS, MVS, OS400, dan Lainnya.

    Jika diatur ke Tidak Ada, perintah SYST akan digunakan. Lainnya digunakan ketika jenis OS tidak cocok dengan salah satu kategori yang ditentukan.

    Nilai default: Tidak
    Log Tentukan jalur lengkap termasuk nama file file log yang akan di-output. Anda menggunakan file ini untuk mendiagnosis kondisi kesalahan saat mengirim atau menerima berkas melalui FTP.
    Ukuran File Maks Tentukan ukuran file maksimum yang dapat diunduh, dalam megabyte.

    Nol (0) menunjukkan tidak ada batasan pada ukuran file.

    Nilai default: 100
    Kata sandi Tentukan kata sandi pengguna untuk masuk ke server FTP.
    Port Tentukan alamat port untuk server FTP ini.

    Nilai default: 21
    Representasi Pilih bagaimana FTP menerima data.

    Nilai yang valid: biner atau ASCII

    Nilai default: biner
    Server Tentukan nama server atau alamat IP server FTP. Catatan: URI untuk port kirim atau lokasi terima tidak boleh melebihi 256 karakter.
    Afiliasi SSO Tentukan aplikasi afiliasi Sign-On Tunggal Perusahaan.
    Gunakan daftar nama (NLST) Tentukan bagaimana adaptor mencantumkan file. Untuk melihat nama file alih-alih daftar file yang ditentukan sistem, atur nilai ini ke Ya.

    Nilai default: Tidak
    Nama Pengguna Tentukan nama pengguna untuk masuk ke server FTP.

    Polling

    Gunakan ini Untuk melakukan ini
    Hapus Setelah Pengunduhan Tentukan apakah adaptor menghapus file dari server FTP setelah mengunduhnya.

    Nilai default: Ya Catatan:
    Aktifkan Perbandingan Tanda Waktu Tentukan apakah adapter mengunduh file lagi berdasarkan tanda waktu yang dimodifikasi. Dalam kasus ketika adaptor tidak memiliki izin penghapusan pada server FTP, perintah MDTM (Waktu Modifikasi) memungkinkan adaptor untuk mengetahui apakah file telah dimodifikasi sejak pengunduhan terakhir. Berdasarkan nilai properti ini, file diunduh lagi.

    Nilai default: Tidak Ada Catatan: Jika server FTP tidak mendukung MDTM, atur properti Interval Unduh Ulang . Catatan: Properti ini hanya berlaku saat Hapus Setelah Unduhan diatur ke Tidak.
    Interval Tentukan nomor interval untuk polling lokasi ini. Untuk melakukan polling terus menerus, atur nilai ini ke nol (0).

    Nilai default: 60
    Interval Pengunduhan Ulang Tentukan interval setelah adapter mengunduh file lagi. Properti ini hanya berlaku saat Hapus Setelah Pengunduhan dan Aktifkan Perbandingan Tanda Waktu diatur ke Tidak.

    Nilai default: -1

    -1 menunjukkan bahwa adaptor tidak akan mengunduh file lagi.

    0 menunjukkan bahwa adaptor akan mengunduh file di setiap siklus polling.
    Unit Tentukan jenis unit untuk properti Interval dan Interval Unduh Ulang .

    Nilai yang valid: Detik, Menit, Jam, dan Hari

    Nilai default: Detik

    SSL

    Gunakan ini Untuk melakukan ini
    Hash Sertifikat Klien Tentukan hash SHA1 dari sertifikat klien yang harus digunakan dalam negosiasi Secure Sockets Layer (SSL).

    Berdasarkan hash ini, sertifikat klien diambil dari penyimpanan pribadi akun pengguna tempat instans host BizTalk berjalan.
    Mode Koneksi FTPS Tentukan mode koneksi SSL yang dibuat ke server FTPS.

    Nilai yang Valid: Implisit atau Eksplisit

    Nilai Default: Eksplisit
    Menggunakan Perlindungan Data Tentukan ini sebagai Ya jika adaptor harus menggunakan enkripsi SSL saat mengirim dan menerima file data dari server FTPS. Tentukan ini sebagai Tidak untuk adaptor untuk mengirim dan menerima file data sebagai teks biasa. Catatan: Properti ini hanya berlaku jika properti Gunakan SSL diatur ke Ya.

    Nilai yang Valid: Ya atau tidak

    Nilai Default: Ya
    Gunakan SSL Tentukan apakah adaptor FTP harus menggunakan SSL untuk berkomunikasi dengan server FTPS.

    Nilai yang Valid: Ya atau tidak

    Nilai Default: Tidak

    Parameter Penyetelan

    Gunakan ini Untuk melakukan ini
    Waktu Tunggu Data Penerimaan Tentukan waktu dalam milidetik sebelum panggilan terima akan dibatalkan. Anda menggunakan properti ini untuk mencegah server lambat menyebabkan lokasi terima berhenti merespons.

    Nilai default: 90000
    Folder Sementara Tentukan lokasi untuk folder sementara. Anda menggunakan lokasi ini untuk menjamin pemulihan dari kegagalan transfer.

  5. Klik OK untuk menyimpan pengaturan.

  6. Dalam kotak dialog Terima Properti Lokasi , masukkan nilai yang sesuai untuk menyelesaikan konfigurasi lokasi terima lalu klik OK untuk menyimpan pengaturan. Untuk informasi tentang kotak dialog Terima Properti Lokasi , lihat Cara Membuat Lokasi Penerimaan.

Catatan

Jangan mengonfigurasi beberapa lokasi penerima FTP untuk melakukan polling URL FTP yang sama. Jika beberapa lokasi penerima FTP melakukan polling URL yang sama secara bersamaan maka setiap lokasi penerima dapat menerima salinan file, yang dapat menyebabkan duplikasi data. Perilaku ini terjadi karena protokol FTP tidak memiliki ketentuan untuk mengunci file saat membacanya dari URL target.

Untuk memberikan ketersediaan tinggi untuk adaptor penerima FTP, Anda harus mengonfigurasi adaptor penerima FTP untuk dijalankan dalam instans BizTalk Host berkluster. Lihat Pertimbangan untuk Menjalankan Handler Adapter dalam Host Berkluster.

Mengonfigurasi port kirim

Anda dapat mengatur properti adaptor port kirim FTP di konsol Administrasi BizTalk Server. Jika properti tidak diatur untuk port kirim, nilai handler pengiriman default di konsol Administrasi BizTalk Server digunakan.

  1. Di konsol Administrasi BizTalk Server, buat port kirim baru atau klik dua kali port kirim yang ada untuk memodifikasinya. Lihat Cara Membuat Port Kirim. Konfigurasikan semua opsi port kirim, dan di bagian Transportasi dari halaman Umum , tentukan FTP untuk opsi Jenis .

  2. Pada halaman Umum , di bagian Transportasi , klik tombol Konfigurasi di samping Ketik.

  3. Di Properti Transportasi FTP, lakukan hal berikut:

    Firewall

    Gunakan ini Untuk melakukan ini
    Alamat Tentukan alamat firewall, baik nama DNS atau alamat IP.
    Mode Pilih mode di mana adaptor tersambung ke server FTP.

    Nilai yang valid: Pasif dan Aktif

    Dalam mode aktif, server FTP tersambung ke port yang dibuka oleh adaptor FTP. Dalam mode pasif, adaptor FTP tersambung ke port yang dibuka oleh server FTP. Mode aktif mungkin tidak berfungsi jika Anda menggunakan IP internal dan Anda tersambung ke IP eksternal. Dalam hal ini, Anda perlu menggunakan mode Pasif atau mode Aktif dengan gateway lapisan aplikasi (ALG) dengan dukungan FTP.

    Nilai default: Aktif
    Kata sandi Tentukan kata sandi untuk firewall.
    Port Tentukan port untuk firewall.

    Nilai yang valid: 1 hingga 65535 secara inklusif

    Nilai default: 21
    Jenis Pilih jenis firewall yang disebarkan.

    Nilai yang valid: Kaus kaki 4, Kaus Kaki 5, Tidak Ada

    Nilai default: Tidak
    Pengguna Tentukan nama pengguna untuk firewall.

    FTP

    Gunakan ini Untuk melakukan ini
    Akun Opsional. Tentukan nama akun untuk server FTP. Opsi ini adalah dan penggunaan properti ini tidak disarankan.
    Setelah Diletakkan Tentukan perintah FTP yang akan dijalankan setelah file PUT. Pisahkan perintah dengan titik koma (;).
    Alokasikan Penyimpanan Tentukan apakah akan mengalokasikan ruang penyimpanan untuk sistem host warisan. Opsi ini disediakan untuk kompatibilitas mundur.

    Nilai yang valid: Tidak dan Ya

    Nilai default: Tidak
    Sebelum Diletakkan Tentukan perintah FTP yang akan dijalankan sebelum file PUT, seperti perintah untuk mengubah nilai default pada server FTP. Pisahkan perintah dengan titik koma (;). Tidak diperlukan perintah terbuka. Catatan: Perintah QUIT tidak didukung sebelum file PUT.
    Folder Tentukan lokasi untuk memindahkan file ke server FTP.
    Jenis Server FTP Baru dimulai dengan BizTalk Server 2016.

    Gunakan properti ini untuk memilih server FTP yang tidak memerlukan perintah SYST. Opsinya adalah None, AIX, Detect, GXS, MVS, OS400, dan Lainnya.

    Jika diatur ke Tidak Ada, perintah SYST akan digunakan. Lainnya digunakan ketika jenis OS tidak cocok dengan salah satu kategori yang ditentukan.

    Nilai default: Tidak
    Log Tentukan jalur lengkap termasuk nama file file log yang akan di-output. Gunakan file ini untuk mendiagnosis kondisi kesalahan saat mengirim atau menerima file melalui adaptor FTP.
    Kata sandi Tentukan kata sandi untuk masuk ke server FTP.
    Port Tentukan alamat port untuk server FTP.

    Nilai default: 21
    Representasi Pilih bagaimana adaptor FTP mengirim data, baik sebagai biner atau sebagai ASCII.

    Nilai yang valid: biner atau ASCII

    Nilai default: biner
    Server Tentukan nama server atau alamat IP server FTP.
    Afiliasi SSO Tentukan aplikasi afiliasi Sign-On Tunggal Perusahaan.
    Nama File Target Tentukan nama alternatif untuk file tersebut. Mempertahankan nama default menjamin nama pesan unik untuk setiap pesan yang dikirim.

    Nilai default: %MessageID%.xml
    Nama Pengguna Tentukan nama pengguna untuk masuk ke server FTP.

    SSL

    Gunakan ini Untuk melakukan ini
    Hash Sertifikat Klien Tentukan hash SHA1 dari sertifikat klien yang harus digunakan dalam negosiasi Secure Sockets Layer (SSL).

    Berdasarkan hash ini, sertifikat klien diambil dari penyimpanan pribadi akun pengguna tempat instans host BizTalk berjalan.
    Mode Koneksi FTPS Tentukan mode koneksi SSL yang dibuat ke server FTPS.

    Nilai yang valid: Implisit atau Eksplisit

    Nilai default: Eksplisit
    Menggunakan Perlindungan Data Tentukan ini sebagai Ya jika adaptor harus menggunakan enkripsi SSL saat mengirim dan menerima file data dari server FTPS. Tentukan ini sebagai Tidak untuk adaptor untuk mengirim dan menerima file data sebagai teks biasa. Catatan: Properti ini hanya berlaku jika properti Gunakan SSL diatur ke Ya.

    Nilai yang valid: Ya atau tidak

    Nilai default: Ya
    Gunakan SSL Tentukan apakah adaptor FTP harus menggunakan SSL untuk berkomunikasi dengan server FTPS.

    Nilai yang valid: Ya atau tidak

    Nilai default: Tidak

    Parameter Penyetelan

    Gunakan ini Untuk melakukan ini
    Batas koneksi Tentukan jumlah maksimum koneksi FTP bersamaan yang dapat dibuka ke server. Nilai 0 berarti tidak ada batasan.

    Nilai default: 0 Catatan: Properti ini menggantikan entri registri yang digunakan dalam versi BizTalk Server sebelumnya untuk mengatur batas koneksi. BizTalk Server mengabaikan entri registri yang digunakan untuk mengontrol batas koneksi.
    Folder Sementara Tentukan lokasi untuk folder sementara pada server FTP. File pertama kali diunggah di sini dan kemudian dipindahkan ke folder FTP tujuan. Jika terjadi kegagalan transfer, adaptor memulai ulang pengunggahan file dalam mode transfer dan resume ASCII dalam mode transfer biner. Catatan: Jika transfer file bersifat atomik antara lokasi sementara dan lokasi yang relevan di server FTP, maka unggahan file juga atomik.

  4. Klik OK dan OK lagi untuk menyimpan pengaturan.

Perintah FTP yang diperlukan oleh adaptor FTP

Adaptor FTP tunduk pada batasan protokol FTP, dan mengharuskan perintah FTP tertentu tersedia di Server FTP sumber atau tujuan.

Adaptor FTP beroperasi sebagai klien FTP dan mungkin mengharuskan perintah berikut tersedia di server FTP agar berfungsi dengan benar:

Perintah Diperlukan oleh Terima Diperlukan oleh Kirim
SYST ✔

Opsional dimulai dengan BizTalk Server 2016		 ✔

Opsional dimulai dengan BizTalk Server 2016
TOKO ✔
RETR ✔
USER ✔ ✔
LULUS ✔ ✔
CWD ✔ ✔
BERHENTI ✔ ✔
PORT ✔ ✔
PASV ✔ ✔
ABOR ✔ ✔
JENIS ✔ ✔
RNFR ✔ ✔
RNTO ✔ ✔
DELE ✔ ✔
PWD ✔ ✔
LIST ✔ ✔
NLST ✔ ✔
NOOP ✔ ✔
BANDING ✔
ALLO ✔ ✔
MDTM ✔
AUTH TLS ✔ ✔
PBSZ ✔ ✔
PROT ✔ ✔

Untuk informasi selengkapnya tentang perintah FTP ini, lihat:

Mengonfigurasi Adapter FTP untuk Bekerja dengan Host Warisan

Bagian ini membahas apa yang perlu Anda ketahui untuk memfasilitasi komunikasi antara adaptor FTP dan komputer mainframe.

Catatan

Anda tidak dapat menggunakan fungsi folder sementara saat mengirim file ke host MVS atau AS400. Input ke bidang ini tidak didukung dan akan menyebabkan kesalahan.

Penting

Informasi berikut disediakan sebagai panduan dan tidak boleh diganti dengan informasi yang ditemukan dalam dokumentasi AS400 atau IBM.

MVS

Untuk mengirim file ke server FTP pada mainframe, mainframe harus mendukung IBM Generation Data Group (GDG). Di bidang nama, setiap nama file akan menambahkan (+1) ke nama file tujuan (jalur lengkap dengan tanda kutip di sekitarnya).

AS400

Ada tiga metode penamaan file dan menentukan jalurnya saat mentransfer file ke dan dari sistem AS400:

  • Bidang nama file: Saat mengirim file ke server FTP, masukkan nama file di bidang Nama file . Nama file harus sesuai dengan konvensi penamaan file sistem AS400 karena file akan disimpan dalam Sistem File Pustaka.

  • Perintah kutipan: Gunakan perintah Kutipan untuk menjalankan skrip di komputer jarak jauh. Masukkan perintah Kuotasi ke bidang Sebelum GET, Before PUT, After GET, dan After PUT di salah satu titik akhir. Masukkan perintah Kutipan dalam format berikut:

    QUOTE RCMD <command to be run on the remote system>.

  • Integrated File System (IFS): IFS adalah area pada sistem AS400 yang memungkinkan penyimpanan file berbasis PC dan oleh karena itu konvensi penamaan yang sama dengan PC. Untuk menggunakan IFS alih-alih Sistem File Pustaka default, perintah pertama yang harus dimasukkan adalah quote site namefmt 1. Perintah ini memberi tahu sistem AS400 untuk menggunakan konvensi penamaan IFS.

Hal-hal yang lebih baik

Skema dan Properti Properti Adapter FTP

Praktik terbaik dan rekomendasi untuk adaptor FTP

FTP Adapter