Cara Mengimpor Aplikasi BizTalk

Topik ini menjelaskan cara menggunakan konsol Administrasi BizTalk Server atau baris perintah mengimpor aplikasi BizTalk ke dalam grup BizTalk. Mengimpor aplikasi BizTalk mendaftarkan artefak dalam database BizTalk Management dan menulis data artefak ke database BizTalk yang sesuai. Untuk detailnya, lihat Apa yang Terjadi Saat Artefak Diimpor. Mengimpor aplikasi tidak menginstal aplikasi. Anda harus menginstal aplikasi yang menyertakan artefak berbasis file sebelum dapat berjalan.

Saat Anda menggunakan konsol Administrasi BizTalk Server untuk mengimpor aplikasi, lokasi dari mana Anda memulai Wizard Impor MSI menentukan apakah Anda dapat membuat aplikasi baru pada saat yang sama ketika Anda mengimpor artefak. Jika Anda memulai wizard dengan mengklik kanan grup BizTalk, Anda harus memberikan nama aplikasi. Jika aplikasi yang ada di grup BizTalk memiliki nama yang Anda tentukan, artefak dalam file diimpor ke dalam aplikasi ini; jika tidak, aplikasi baru yang memiliki nama yang ditentukan dibuat, dan artefak diimpor ke dalamnya. Jika Anda memulai wizard dengan mengklik kanan aplikasi, Anda tidak dapat menentukan nama aplikasi, dan artefak diimpor ke dalam aplikasi saat ini.

Saat Anda menggunakan alat baris perintah BTSTask untuk mengimpor file .msi, memberikan nama aplikasi bersifat opsional. Jika Anda tidak memberikan nama, artefaknya diimpor ke dalam aplikasi default.

Setelah mengimpor artefak, Anda dapat melihatnya di folder yang sesuai di bawah folder aplikasi di konsol Administrasi BizTalk Server. Anda juga dapat melihat daftar artefak dalam aplikasi dengan menggunakan BTSTask, seperti yang dijelaskan dalam ListApp Command.

Prasyarat

Untuk mengimpor aplikasi BizTalk, Anda harus masuk dengan akun yang merupakan anggota grup Administrator BizTalk Server. Untuk menginstal aplikasi BizTalk, Anda juga harus memiliki izin Tulis pada sistem file lokal. Untuk informasi selengkapnya tentang izin, lihat Izin yang Diperlukan untuk Menyebarkan dan Mengelola Aplikasi BizTalk.

Pertimbangan untuk mengimpor aplikasi

Saat mengimpor aplikasi, pertimbangan berikut mungkin berlaku:

• Mengimpor aplikasi dari versi BizTalk Server sebelumnya. Jika Anda mengimpor aplikasi dari BizTalk Server 2006 R2 atau BizTalk Server 2009, dan aplikasi berisi data pihak EDI/AS2, impor aplikasi mungkin gagal karena model manajemen mitra dagang telah banyak berubah di BizTalk Server. Sebagai gantinya, Anda harus menggunakan Alat Migrasi Pihak untuk memigrasikan data pihak dari versi BizTalk Server sebelumnya. Untuk informasi selengkapnya tentang alat ini, lihat Utilitas Migrasi EDI.

• Pengikatan yang ada selalu ditimpa oleh pengikatan yang diimpor. Saat Anda mengimpor file .msi yang berisi pengikatan ke dalam aplikasi yang ada, pengikatan yang ada ditimpa oleh pengikatan impor yang memiliki nama yang sama. Ini adalah kasus bahkan ketika Anda belum memilih opsi untuk menimpa artefak yang ada saat mengimpor file .msi. Jika Anda tidak ingin pengikatan dalam aplikasi yang Anda ekspor untuk menimpa pengikatan dalam aplikasi tempat Anda mengimpor file .msi, maka Anda tidak boleh memilih file pengikatan sebagai sumber daya untuk diekspor selama operasi ekspor. Untuk informasi selengkapnya, lihat Cara Mengekspor Aplikasi BizTalk.

  Karena pengikatan diterapkan selama proses impor, pengikatan yang telah diterapkan ditimpa oleh pengikatan baru yang memiliki nama yang sama. Dengan kata lain, pengikatan terakhir nama tertentu yang akan diterapkan berlaku. Saat Anda mengimpor aplikasi, pengikatan diterapkan dalam urutan berikut:

  1. Pengikatan aplikasi yang dihasilkan oleh BizTalk Server yang tidak secara eksplisit ditambahkan ke aplikasi melalui file pengikatan, tetapi itu secara eksplisit dipilih oleh pengguna untuk diekspor ke file .msi aplikasi.

  2. Mengikat file yang telah ditambahkan secara eksplisit, dan tidak memiliki lingkungan penyebaran target yang ditentukan. Pengikatan dalam set ini diterapkan tanpa urutan tertentu.

  3. Pengikatan yang telah ditambahkan secara eksplisit, dan yang memiliki lingkungan penyebaran target terkait yang cocok dengan lingkungan penyebaran yang dipilih untuk impor aplikasi. Pengikatan dalam set ini diterapkan tanpa urutan tertentu.

• Host harus ada dalam grup. Host yang sesuai dengan host yang ditentukan dalam pengikatan aplikasi yang terkandung dalam file .msi harus sudah ada di grup BizTalk atau operasi impor akan gagal. Selain itu, tingkat kepercayaan host harus cocok.

• Anda mungkin perlu menambahkan referensi ke aplikasi lain. Jika aplikasi yang Anda impor tergantung pada artefak di aplikasi lain, Anda perlu menambahkan referensi ke aplikasi ini. Aplikasi dan artefak yang diperlukan harus sudah ada dalam grup. Wizard Impor menyediakan opsi ini. Namun, jika Anda menggunakan perintah ImportApp dari BTSTask, Anda harus menambahkan referensi ke aplikasi setelah impor, seperti yang dijelaskan dalam Cara Menambahkan Referensi ke Aplikasi Lain. Untuk informasi latar belakang, lihat Dependensi dan Penyebaran Aplikasi. Wizard Impor cocok dengan referensi ke aplikasi yang sudah ada dalam grup dan memberi Anda opsi untuk menambahkan referensi baru atau mengubah referensi yang sudah ada. Anda harus mengambil langkah tambahan untuk memverifikasi bahwa aplikasi yang dirujuk berisi artefak yang diperlukan.

• Jika waktu operasi impor habis, bagi aplikasi menjadi file .msi tambahan. Operasi impor akan kehabisan waktu jika melebihi 3600 detik dalam durasi. Jika Anda mencoba mengimpor file .msi, dan waktu operasi habis, Anda harus membagi konten aplikasi menjadi lebih dari satu file .msi dengan mengekspor ulang aplikasi dan memilih subset artefak untuk diekspor. Untuk informasi selengkapnya, lihat Cara Mengekspor Aplikasi BizTalk.

Mengimpor aplikasi BizTalk menggunakan Administrasi BizTalk Server

1. Klik Mulai, klik Semua Program, klik Microsoft BizTalk Server 20xx, lalu klik BizTalk Server Administration.

2. Di pohon konsol, perluas Administrasi BizTalk Server, perluas grup BizTalk, dan lakukan salah satu hal berikut ini:

   • Untuk mengimpor aplikasi dan artefak yang terkandung dalam file .msi ke dalam grup BizTalk, klik kanan Aplikasi, arahkan ke Impor, lalu klik file MSI.

   • Untuk mengimpor artefak yang terkandung dalam file .msi ke dalam aplikasi yang ada, perluas Aplikasi, klik kanan aplikasi, arahkan ke Impor, lalu klik file MSI.

3. Pada halaman Selamat Datang di Wizard Impor MSI, dalam file MSI untuk diimpor, ketik jalur file .msi, lalu klik Berikutnya. Jika perlu, Anda dapat menelusuri file .msi dengan mengklik tombol ... .

4. Pada halaman Pengaturan Aplikasi, di daftar drop-down Nama aplikasi, pilih nama aplikasi, jika tersedia. Daftar ini tersedia jika Anda mengimpor aplikasi ke dalam grup BizTalk.

   Catatan

   Daftar ini mencakup nama semua aplikasi yang saat ini ada di grup BizTalk serta aplikasi tempat file .msi diekspor. Jika Anda memilih nama aplikasi terakhir, dan aplikasi belum ada di grup BizTalk ini, Wizard Impor membuat aplikasi baru. Jika Anda memilih aplikasi yang sudah ada dalam grup, Wizard Impor mengimpor artefak dari file .msi ke dalam aplikasi yang ada.

5. Di Aplikasi yang tersedia untuk ditambahkan referensi, pilih aplikasi yang akan ditambahkan referensi, jika ada, lalu klik Berikutnya.

6. Jika Anda mengimpor file .msi ke aplikasi yang ada dan ingin menimpa artefak di aplikasi yang ada, pilih Timpa sumber daya.

   Catatan

   Jika Anda tidak memilih opsi ini, dan file .msi berisi artefak yang sudah ada dalam aplikasi, operasi impor akan gagal dan digulung balik. Jenis artefak tertentu dalam aplikasi atau grup BizTalk harus unik. Jika Anda menambahkan artefak yang sudah ada di grup BizTalk, tetapi tidak dalam aplikasi saat ini, operasi impor akan gagal, bahkan jika Anda menentukan opsi timpa. Untuk informasi selengkapnya tentang artefak mana yang harus unik dan dengan cara apa artefak harus unik, lihat Artefak yang Harus Unik dalam Aplikasi atau Grup.

7. Pada halaman Pengaturan Lingkungan Target Aplikasi, di daftar drop-down Lingkungan Penahapan Target , pilih lingkungan target untuk aplikasi ini, dan klik Berikutnya. Daftar ini berisi semua lingkungan yang telah ditentukan untuk file pengikatan apa pun yang telah ditambahkan ke aplikasi ini. Pilih <Default> jika Anda ingin menerapkan semua pengikatan dalam aplikasi kecuali yang memiliki lingkungan target yang ditentukan. Jika file .msi tidak berisi file pengikatan yang ingin Anda terapkan secara eksplisit, Anda dapat membiarkan <Default> dipilih.

   Catatan

   Anda menentukan lingkungan target untuk pengikatan saat menambahkan file pengikatan ke aplikasi. Untuk informasi latar belakang, lihat Mengikat File dan Penyebaran Aplikasi. Untuk petunjuk tentang menambahkan file pengikatan, lihat Cara Menambahkan File Pengikatan ke Aplikasi.

8. Pada halaman Impor Ringkasan, konfirmasikan bahwa informasi ringkasan sudah benar, lalu klik Impor.

9. Pada halaman Impor Berhasil, jika Anda ingin menginstal aplikasi di komputer lokal, pilih kotak centang Jalankan Wizard Penginstalan Aplikasi untuk menginstal aplikasi di komputer lokal .

   Catatan

   Kecuali Anda perlu menjalankan aplikasi seperti yang saat ini dikonfigurasi di komputer lokal, Anda tidak perlu menginstalnya. Namun, jika aplikasi menyertakan artefak berbasis file, Anda harus menginstal aplikasi di semua komputer yang akan menjalankannya sebelum dapat mulai berfungsi, karena mengimpor aplikasi hanya menambahkannya ke database BizTalk Management.

10. Klik Selesai.

Mengimpor aplikasi BizTalk menggunakan baris perintah

1. Buka perintah sebagai berikut: Klik Mulai, klik Jalankan, ketik cmd, lalu klik OK.

2. Ketik perintah berikut, mengganti nilai yang sesuai, seperti yang dijelaskan dalam tabel berikut ini:

   BTSTask ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]

   Contoh:

   BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite

   Parameter	Nilai
   /Paket	Jalur lengkap file .msi. Jika jalur menyertakan spasi, Anda harus mengapitnya dalam tanda kutip (").
   /Lingkungan	Lingkungan penyebaran target file pengikatan yang akan diterapkan, seperti Uji. Ini adalah nilai yang ditentukan untuk lingkungan penyebaran target ketika file pengikatan ditambahkan ke aplikasi.
   /ApplicationName	Nama aplikasi BizTalk tempat artefak dalam file .msi diimpor. Jika tidak ditentukan, nama aplikasi yang ditentukan saat mengekspor file .msi digunakan. Jika aplikasi yang ditentukan tidak ada, aplikasi akan dibuat. Nama aplikasi yang menyertakan spasi harus diapit dengan tanda kutip ganda (").
   /Menimpa	Opsi untuk menimpa artefak dalam aplikasi dengan artefak dalam file .msi yang memiliki pengidentifikasi unik lokal (LUID) yang sama. Jika opsi ini tidak ditentukan, dan ada satu atau beberapa artefak dalam aplikasi yang memiliki LUID yang sama dengan artefak dalam file .msi, impor gagal. Anda dapat melihat LUID artefak dalam aplikasi dengan menggunakan Perintah ListApp.
   /Server	Nama instans SQL Server yang menghosting database Manajemen BizTalk, dalam bentuk ServerName\InstanceName,Port. Nama instans hanya diperlukan ketika nama instans berbeda dari nama server. Port hanya diperlukan ketika SQL Server menggunakan nomor port selain default (1433). Contoh: Server=MyServer Server=MyServer\MySQLServer,1533 Jika tidak disediakan, nama instans SQL Server yang berjalan di komputer lokal digunakan.
   /Database	Nama database BizTalk Management. Jika tidak ditentukan, database BizTalk Management yang berjalan dalam instans lokal SQL Server digunakan.

Lihat juga

Mengimpor Aplikasi, Pengikatan, dan Kebijakan BizTalk
Perintah ImportApp