Cara Menginstal Aplikasi BizTalk

Topik ini menjelaskan cara menginstal aplikasi di komputer lokal dengan mengklik dua kali file Pemasang Windows (.msi) untuk aplikasi di antarmuka Windows atau dengan menjalankan msiexec dari baris perintah. Anda juga dapat memulai Wizard Penginstalan sebagai langkah terakhir Wizard Impor, seperti yang dijelaskan dalam Cara Mengimpor Aplikasi BizTalk.

Sebelum Anda dapat mengoperasikan aplikasi, Anda harus menginstalnya di komputer BizTalk Server yang akan menjalankannya. Menginstal aplikasi menempatkan sumber dayanya pada sistem file lokal. Tergantung pada aplikasi, kontennya, dan konfigurasinya, penginstalan juga dapat melakukan hal berikut:

• Menambahkan rakitan ke cache rakitan global (GAC)

• Menginstal sertifikat dan direktori virtual

• Tambahkan komponen ke registri Windows.

• Jalankan skrip pra-atau pasca-pemrosesan, jika ada dalam file .msi.

  Untuk informasi latar belakang, lihat Apa yang Terjadi pada Artefak Selama Penginstalan dan Penghapusan Instalasi.

Prasyarat

Untuk melakukan prosedur dalam topik ini, Anda harus masuk dengan akun yang memiliki izin Tulis pada sistem file lokal. Bergantung pada item yang disertakan dalam aplikasi, Anda mungkin juga memerlukan izin Tulis pada Registri Windows, GAC, penyimpanan sertifikat, dan Layanan Informasi Internet. Akun Administrator pada komputer lokal memiliki izin ini. Untuk informasi selengkapnya tentang izin, lihat Izin yang Diperlukan untuk Menyebarkan dan Mengelola Aplikasi BizTalk.

Pertimbangan untuk menginstal aplikasi

Saat menginstal aplikasi, pertimbangan berikut mungkin berlaku:

• Anda juga harus menginstal aplikasi apa pun di mana aplikasi ini memiliki dependensi. Ketika Anda menginstal aplikasi yang memiliki dependensi pada artefak, seperti rakitan BizTalk, yang terkandung dalam aplikasi lain, Anda juga harus menginstal aplikasi yang berisi artefak. Anda harus melakukan ini sebelum dapat menjalankan aplikasi. Misalnya, jika Aplikasi A bergantung pada perakitan di Aplikasi B, Anda juga harus menginstal Aplikasi B. Kemudian Anda dapat menginstal Aplikasi A. Untuk informasi latar belakang, lihat Dependensi dan Penyebaran Aplikasi.

• Anda harus menghentikan aplikasi yang sedang Anda perbarui. Jika Anda melakukan penginstalan untuk memperbarui artefak dalam aplikasi, Anda tidak perlu menghentikan aplikasi kecuali pembaruan menyertakan satu atau beberapa rakitan yang memiliki versi yang sama dengan rakitan yang ada. Dalam hal ini, Anda harus menghentikan aplikasi sebelum menginstal pembaruan. Namun, kami sarankan Anda menghentikan aplikasi dalam semua kasus kecuali Anda tahu bahwa pembaruan tidak akan mengganggu aplikasi saat berjalan. Untuk informasi selengkapnya, lihat Memperbarui Aplikasi BizTalk.

• Ketika Anda menginstal beberapa file .msi untuk aplikasi yang sama, hanya ada satu entri yang dibuat di Tambahkan atau Hapus Program. Anda mungkin melakukan ini untuk memperbarui aplikasi yang ada, misalnya. Anda kemudian dapat menggunakan Tambahkan atau Hapus Program (dalam Panel Kontrol) untuk menghapus instalasi aplikasi sepenuhnya, termasuk item yang diperbarui. Perhatikan bahwa menghapus instalan aplikasi dengan mengklik dua kali file .msi atau menggunakan msiexec tidak didukung. Untuk informasi selengkapnya, lihat Cara Menghapus Instalasi Aplikasi BizTalk.

• Sertifikat harus ada di semua komputer yang menghosting port pengiriman sebelum aplikasi dapat berjalan. Penyimpanan Sertifikat Orang Lainnya berisi sertifikat yang digunakan oleh port pengiriman.

• Anda dapat memperhitungkan artefak aplikasi ke dalam file .msi yang berbeda untuk penginstalan. Anda tidak perlu menginstal semua artefak aplikasi di setiap komputer yang akan menjalankan aplikasi. Sebagai gantinya, Anda dapat mengekspor subset artefak aplikasi ke file .msi yang berbeda untuk diinstal di komputer yang berbeda. Untuk petunjuknya, lihat Cara Mengekspor Aplikasi BizTalk.

• Jika file .msi aplikasi menyertakan direktori virtual, Internet Information Services (IIS) harus berjalan di komputer lokal. Jika tidak, penginstalan akan gagal.

• Jika aplikasi menyertakan direktori virtual dengan nama yang sama dengan yang sudah ada di komputer lokal, sumber daya dari aplikasi ditambahkan ke dalamnya. Jika tidak, direktori virtual dibuat. File yang ada yang memiliki nama yang sama dengan file yang ditambahkan akan ditimpa. Selain itu, pengaturan keamanan untuk direktori virtual yang ada tidak diubah, dan Anda harus memverifikasi bahwa mereka cukup aman.

• Buat kumpulan aplikasi untuk direktori virtual sebelum menginstal aplikasi. Jika aplikasi Anda menyertakan direktori virtual, dan kumpulan aplikasi belum ada di IIS, Anda harus membuat kumpulan aplikasi secara manual sebelum penginstalan. Dengan cara ini, direktori virtual akan terikat ke kumpulan aplikasi selama penginstalan. Jika Anda tidak membuat aplikasi, direktori virtual akan terikat ke kumpulan aplikasi default saat penginstalan.

• Pastikan BTSHttpReceive.dll terdaftar sebagai Pemetaan Handler dengan Internet Information Services (IIS) 7.0. Anda harus melakukan ini jika aplikasi Anda menyertakan direktori virtual agar lokasi penerima HTTP berfungsi.

• Anda mungkin mengalami masalah saat menginstal aplikasi yang menyertakan artefak 64-bit pada komputer 32-bit. Untuk informasi selengkapnya, lihat Cara Menambahkan Artefak 64-Bit ke Aplikasi.

• Anda mungkin mengalami masalah jika panjang direktori target melebihi 260 karakter. Jika jumlah karakter dalam direktori target yang ditentukan selama penginstalan paket MSI melebihi 260 karakter, penginstalan akan gagal. Untuk mengatasi masalah ini, pastikan jumlah karakter yang ditentukan untuk direktori target tidak melebihi 260 karakter.

• Anda tidak boleh merelokasi folder penginstalan. Setelah menginstal aplikasi, Anda tidak boleh merelokasi folder penginstalan atau file yang dikandungnya. Jika Anda melakukannya, dan kemudian mencoba menghapus (menghapus instalan) aplikasi, operasi penghapusan mungkin gagal. Secara khusus, folder penginstalan aplikasi berisi file yang dihasilkan oleh BizTalk Server yang diperlukan untuk melakukan penghapusan. Anda tidak boleh mengganti nama, memindahkan, atau menghapus file-file ini. Filenya adalah:

  • ApplicationDefinition.adf

  • Microsoft.BizTalk.CustomInstaller.dll

  • Microsoft.BizTalk.CustomInstaller.InstallState

• Anda mungkin perlu mengubah Jalur lokal: penandaan direktori virtual yang direferensikan oleh lokasi penerima HTTP setelah dibuat pada komputer target.

  Ketika direktori virtual dibuat pada komputer target, direktori tersebut akan menunjuk ke salah satu direktori fisik berikut:

  <drive >penginstalan\Program Files\Microsoft BizTalk Server\HttpReceive

  - atau –

  <drive >penginstalan\Program Files (x86)\Microsoft BizTalk Server\HttpReceive

  Jika HTTP BizTalk menerima ekstensi ISAPI BTSHTTPReceive.dll tidak terletak di direktori yang ditentukan atau jika komputer target menjalankan sistem operasi 64 bit maka Anda harus mengubah jalur Lokal: penunjukan direktori virtual untuk menunjuk ke direktori fisik yang berisi HTTP BizTalk menerima file ekstensi ISAPI. Misalnya, jika komputer target menjalankan Windows Vista versi 64 bit, maka jalur Lokal: penandaan direktori virtual harus diubah menjadi <drive> penginstalan\Program Files (x86)\Microsoft BizTalk Server\HttpReceive64.

Untuk menginstal aplikasi BizTalk

Menggunakan antarmuka Windows

1. Salin file .msi untuk aplikasi ke komputer lokal.

2. Jika Anda menginstal ulang atau meningkatkan aplikasi BizTalk yang ada, dan penginstalan baru menyertakan rakitan yang memiliki versi yang sama dengan yang sudah ada di aplikasi, atau berinteraksi dengan artefak yang Anda perbarui, pastikan bahwa aplikasi dihentikan dengan mengklik kanan folder aplikasi lalu mengklik Hentikan.

3. Di Windows Explorer, klik dua kali file .msi untuk memulai Wizard Penginstalan.

4. Pada halaman Pilih Folder Penginstalan , di Folder, ketik jalur penginstalan lengkap untuk aplikasi BizTalk. Contoh: C:\Program Files\Generated by BizTalk\MyApplication.

5. Klik Berikutnya empat kali, lalu pada halaman Penginstalan Selesai , klik Tutup.

6. Jika beberapa komputer akan menjalankan aplikasi, ulangi langkah-langkah sebelumnya di setiap komputer.

   Setelah aplikasi diinstal di semua komputer yang akan menjalankannya, dan aplikasi telah diimpor ke grup BizTalk, Anda dapat memulai aplikasi dari konsol Administrasi BizTalk Server dengan mengklik kanan folder aplikasi dan mengklik Mulai. Untuk petunjuk lengkapnya, lihat Cara Memulai dan Menghentikan Aplikasi BizTalk.

Menggunakan baris perintah

1. Salin file .msi untuk aplikasi ke komputer lokal.

2. Klik Mulai, klik Jalankan, ketik cmd, lalu tekan ENTER.

3. Navigasi ke lokasi tempat file .msi disimpan.

4. Ketik perintah berikut untuk menginstal aplikasi, menyediakan parameter dan nilai yang sesuai, seperti yang ditunjukkan dalam tabel berikut:

   Penting

   Hanya parameter msiexec yang ditampilkan dalam tabel berikut yang didukung.

   msiexec [/i] Package [/qn] TARGETDIR="value"]

   Contoh: msiexec /i MyApplication.msi

   Parameter	Nilai
   /I	Menginstal aplikasi.
   Paket	Nama file Pemasang Windows (.msi).
   /qn	Melakukan penginstalan tanpa menampilkan antarmuka pengguna.
   TARGETDIR="value"	Menentukan folder penginstalan aplikasi. Nilai ini juga diatur dalam variabel lingkungan %BTAD_InstallDir%. Contoh: TARGETDIR="C:\Programs\BizTalk Applications\My Application"

5. Jika beberapa komputer akan menjalankan aplikasi, ulangi langkah-langkah sebelumnya di setiap komputer.

   Setelah aplikasi diinstal di semua komputer yang akan menjalankannya, Anda dapat memulai aplikasi dari konsol Administrasi BizTalk Server dengan mengklik kanan folder aplikasi dan mengklik Mulai. Untuk petunjuk lengkapnya, lihat Cara Memulai dan Menghentikan Aplikasi BizTalk.

Lihat juga

Menyebarkan Aplikasi BizTalk
Cara Menghapus Instalasi Aplikasi BizTalk