Bagikan melalui

Mengonfigurasi Adaptor FTP

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 yang hanya dapat dibaca.
  • Adaptor FTP juga mendukung transfer file atom untuk mode ASCII.

Lihat Praktik dan rekomendasi terbaik untuk adaptor FTP.

Mengonfigurasi lokasi penerimaan

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

Nota

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 penerima.

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

  2. Dalam kotak dialog Penerimaan Properti Port, di panel kiri, pilih Lokasi Penerimaan. Di panel kanan, klik dua kali lokasi penerima 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 kelompok 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.
    Modus 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 terhubung 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
    Tipe Tentukan jenis firewall yang disebarkan.

    Nilai yang valid: Tidak ada, Socks 4, dan Socks 5

    Nilai default: Tidak
    Pengguna Tentukan nama pengguna untuk firewall.

    FTP

    Gunakan ini Untuk melakukan ini
    Rekening 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 Mendapatkan Tentukan perintah FTP yang akan dijalankan sebelum file GET. Pisahkan perintah dengan titik koma (;). Nota: 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 Hal 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 digunakan. Lainnya digunakan ketika jenis OS tidak cocok dengan salah satu kategori yang ditentukan.

    Nilai default: Tidak
    Catatan Tentukan jalur lengkap termasuk nama file file log yang akan di-output. Anda menggunakan file ini untuk mendiagnosis kondisi kesalahan saat mengirim atau menerima file melalui FTP.
    Ukuran File Maksimum 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. Nota: URI untuk port kirim atau lokasi terima tidak boleh melebihi 256 karakter.
    Afiliasi SSO Tentukan aplikasi afiliasi untuk Enterprise Single Sign-On.
    Gunakan daftar nama (NLST) Jelaskan 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 Unduhan Tentukan apakah adaptor menghapus file dari server FTP setelah mengunduhnya.

    Nilai default: Ya Catatan:
    Aktifkan Perbandingan Tanda Waktu Tentukan apakah adaptor 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 unduhan terakhir. Berdasarkan nilai properti ini, file diunduh lagi.

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

    Nilai default: 60
    Interval Pengunduhan Ulang Tentukan interval setelah adaptor mengunduh file lagi. Properti ini hanya berlaku ketika Hapus Setelah Unduh 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.
    Satuan Tentukan jenis unit untuk properti Interval dan Redownload Interval .

    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. Nota: Properti ini hanya berlaku jika properti Gunakan SSL diatur ke Ya.

    Nilai yang Valid: Ya atau tidak

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

    Nilai yang Valid: Ya atau tidak

    Nilai Default: Tidak

    Parameter Pengaturan

    Gunakan ini Untuk melakukan ini
    Batas Waktu Penerimaan Data 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 Properti Lokasi Penerimaan, lihat Cara Membuat Lokasi Penerimaan.

Nota

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, 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 menyediakan 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 pengiriman 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 kirim port, 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.
    Modus 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 terhubung 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
    Tipe 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
    Rekening Fakultatif. Tentukan nama akun untuk server FTP. Opsi ini dan penggunaan properti ini tidak disarankan.
    Setelah Dimasukkan 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 ke belakang.

    Nilai yang valid: Tidak dan Ya

    Nilai default: Tidak
    Sebelum Dimasukkan 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. Nota: Perintah QUIT tidak didukung sebelum file PUT.
    Folder Tentukan lokasi untuk memindahkan file ke server FTP.
    Jenis Server FTP Hal 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 digunakan. Lainnya digunakan ketika jenis OS tidak cocok dengan salah satu kategori yang ditentukan.

    Nilai default: Tidak
    Catatan 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 untuk Enterprise Single Sign-On.
    Nama Berkas Sasaran 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 standar: 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. Nota: Properti ini hanya berlaku jika properti Gunakan SSL diatur ke Ya.

    Nilai yang valid: Ya atau tidak

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

    Nilai yang valid: Ya atau tidak

    Nilai default: Tidak

    Parameter Pengaturan

    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 unggahan file dalam mode transfer ASCII dan kemudian melanjutkan dalam mode transfer biner. Nota: Jika transfer file 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 Disyaratkan oleh Receive Diperlukan oleh Kirim
SYST ✔

Opsional dimulai dengan BizTalk Server 2016		 ✔

Opsional dimulai dengan BizTalk Server 2016
TOKO ✔
RETR ✔
PENGGUNA ✔ ✔
LULUS ✔ ✔
CWD ✔ ✔
BERHENTI ✔ ✔
PELABUHAN ✔ ✔
PASV ✔ ✔
ABOR ✔ ✔
JENIS ✔ ✔
RNFR ✔ ✔
RNTO ✔ ✔
Diploma DELE (Diploma Bahasa Spanyol sebagai Bahasa Asing) ✔ ✔
Penyandang Disabilitas ✔ ✔
DAFTAR ✔ ✔
NLST ✔ ✔
NOOP ✔ ✔
APPE ✔
ALLO ✔ ✔
MDTM ✔
AUTH TLS (Autentikasi Transport Layer Security) ✔ ✔
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.

Nota

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 "Quote" ke dalam bidang Sebelum GET, Sebelum PUT, Setelah GET, dan Setelah 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 dimasukkan adalah quote site namefmt 1. Perintah ini memberi tahu sistem AS400 untuk menggunakan konvensi penamaan IFS.

Hal-hal yang lebih baik

Skema Properti dan Properti Adapter FTP

Praktik dan rekomendasi terbaik untuk adaptor FTP

Adaptor FTP