Cara menginstal hotfix Microsoft Dynamics AX

Berlaku Untuk
Microsoft Dynamics AX 2009 Microsoft Dynamics AX 4.0

Microsoft Business Solutions-Axapta 3.0 kini menjadi bagian dari Microsoft Dynamics AX 3.0. Semua referensi ke Microsoft Business Solutions-Axapta dan Microsoft Axapta terkait dengan Microsoft Dynamics AX.

PENDAHULUAN

Artikel ini menyediakan tautan ke dokumentasi tentang cara menginstal hotfix untuk Microsoft Dynamics AX 2012. Contoh ini juga menjelaskan cara menginstal hotfix untuk Microsoft Dynamics AX 2009 dan Microsoft Dynamics AX 4.0.

Catatan Pastikan Anda meninjau secara menyeluruh artikel Pangkalan Pengetahuan Microsoft yang mendokumentasikan hotfix tertentu untuk menentukan objek, tabel database, atau file yang akan terpengaruh.

Informasi Selengkapnya

Hotfix yang dirilis untuk Microsoft Dynamics AX 2012

Proses mendetail untuk menginstal pembaruan dan hotfix untuk Microsoft Dynamics AX 2012 didokumentasikan di TechNet, di bagian berikut: Menerapkan pembaruan dan hotfix.

Hotfix yang dirilis untuk Microsoft Dynamics AX 2009 dan untuk Microsoft Dynamics AX 4.0

Catatan Proses umum untuk menginstal pembaruan dan hotfix untuk Microsoft Dynamics AX 2009 didokumentasikan dalam laporan resmi berikut: Servicing Microsoft Dynamics AX 2009.

Microsoft merilis hotfix untuk Microsoft Dynamics AX dalam format berikut:

  • Hotfix dirilis dalam format file terkompresi (.zip). File yang terkandung dalam file .zip menggantikan file yang sudah ada di komputer.
  • Hotfix dirilis sebagai pembaruan Microsoft Windows Installer. Hotfix ini berisi file Setup.exe.

Microsoft merilis hotfix untuk Microsoft Dynamics AX 4.0 dalam format berikut:

  • Hotfix dirilis sebagai pembaruan Microsoft Windows Installer. Hotfix ini berisi file Setup.exe.
  • Hotfix dirilis sebagai file DIS-layer (AxDIS.aod) atau sebagai file DIP-layer (AxDIP.aod). Perubahan lapisan DISIS mengatasi masalah dalam kode lapisan SYS. Perubahan lapisan DIP mengatasi masalah dalam kode lapisan GLS.
  • Sangat jarang, hotfix dirilis sebagai file .xpo yang berisi kode. Kode diterapkan ke objek yang sudah ada, ke tabel database, atau keduanya.

Panduan umum untuk hotfix yang menggantikan file

Beberapa hotfix Microsoft Dynamics AX menggantikan file di komputer. Untuk instruksi tentang cara menginstal hotfix yang menggantikan file, baca dokumentasi yang menyertai unduhan hotfix dengan cermat. Berikut ini adalah rekomendasi umum untuk menginstal hotfix yang menggantikan file:

  • Sebelum menyalin file yang disertakan dalam hotfix ke komputer, gunakan proses pencadangan biasa untuk mencadangkan file server yang terpengaruh oleh hotfix.

  • Uji semua hotfix di lingkungan pengujian untuk memverifikasi bahwa kustomisasi Anda tidak terpengaruh secara negatif.

  • Minta semua pengguna keluar dari aplikasi klien Microsoft Dynamics AX. Hentikan instans Application Object Server (AOS) sebelum Anda mengganti nama dan menyalin file hotfix.

  • Ketika file label disertakan dalam hotfix, salin semua file label yang disertakan ke folder aplikasi Microsoft Dynamics AX. File label akan memiliki ekstensi nama file berikut:

    • .ali
    • .acd
    • .alc

    Secara default, folder aplikasi memiliki jalur berikut:
    direktori akar\Axapta Application\appl\StandardNote Di jalur ini, direktori akar mewakili hard disk drive dan direktori utama tempat Microsoft Dynamics AX diinstal.

Lingkungan yang disesuaikan

Jika Anda menyesuaikan lingkungan sebelum menginstal hotfix, tinjau secara menyeluruh artikel Pangkalan Pengetahuan Microsoft yang mendokumentasikan hotfix yang ingin Anda instal. Objek apa pun yang terpengaruh oleh hotfix akan ditimpa. Hal ini dapat menyebabkan hilangnya kustomisasi pada objek tersebut.

Pencadangan database

Jika tabel database terpengaruh, buat cadangan database lengkap sebelum menerapkan hotfix. Untuk instruksi tentang cara mencadangkan database, lihat dokumentasi Microsoft SQL Server. Atau, lihat dokumentasi Oracle Database Server.

Informasi penginstalan

Hotfix yang dirilis untuk Microsoft Dynamics AX 2009

Untuk menginstal hotfix yang dirilis sebagai pembaruan aplikasi untuk Microsoft Dynamics AX 2009, ikuti langkah-langkah berikut:

  1. Ekstrak file dari paket.

  2. Buka file kbxxxxxx.txt dalam paket hotfix untuk mengidentifikasi objek mana yang akan ditambal saat hotfix diinstal.

  3. Keluar dari semua klien Microsoft Dynamics AX 2009, lalu hentikan instans AOS.

  4. Cadangkan database.

  5. Cadangkan folder aplikasi.

  6. Mulai ulang instans AOS, lalu tinjau log Aplikasi di server yang menjalankan layanan AOS untuk memastikan bahwa instans AOS dimulai dengan benar. Instans AOS menyusun ulang indeks objek aplikasi. File Axapd.aoi berisi indeks objek aplikasi. 

    Catatan Tergantung pada perangkat keras server yang Anda gunakan, pengaktifan instans AOS mungkin akan habis sebelum proses selesai. Masalah ini terjadi karena proses tidak memiliki cukup waktu untuk menyusun ulang file Axapd.aoi sebelum AOS mencoba menggunakan file tersebut. 

    Instans AOS tetap dalam status awal hingga pembuatan ulang file *.aoi selesai. Pada saat itu, instans AOS memiliki status "dimulai". Tidak ada langkah tambahan yang diperlukan. Tunggu hingga pembuatan ulang selesai, lalu tinjau log Aplikasi untuk indikasi bahwa instans AOS dimulai.

  7. Jalankan file Axpatch.exe untuk penginstalan hotfix aplikasi.

    1. Pilih bahasa yang digunakan untuk menjalankan penginstalan, lalu klik OK.

    2. Saat wizard penginstal dimulai, klik Berikutnya.

    3. Tinjau Persyaratan Lisensi Perangkat Lunak Microsoft, klik untuk mencentang kotak untuk menerima persyaratan lisensi jika Anda setuju, lalu klik Berikutnya.

    4. Pada halaman Pilih komponen , opsi File aplikasi harus dipilih secara default. Klik Berikutnya.

    5. Pada halaman Pilih konfigurasi , tunjukkan konfigurasi yang benar, lalu klik Berikutnya.

    6. Pada halaman Siap menerapkan hotfix , klik Instal.

    7. Setelah penyiapan selesai, klik Selesai untuk keluar dari wizard.

  8. Dari klien, verifikasi bahwa Anda dapat tersambung ke instans AOS sebagai administrator Microsoft Dynamics AX.

  9. Validasi penginstalan hotfix dengan melakukan hal berikut:

    • Buka kelas SysHotfixManifest di AOT.
    • Verifikasi bahwa kelas berisi metode yang memiliki nama yang sama dengan nomor artikel hotfix yang diinstal.

  10. Gunakan alat peningkatan kode ("Perbandingan kode") untuk membandingkan perubahan SYP atau GLP dengan lapisan VAR atau CUS apa pun. Jika ada penyesuaian, staf TI mitra atau pelanggan mungkin diminta untuk menggabungkan hotfix ke dalam sistem yang disesuaikan.

Hotfix yang dirilis sebagai pembaruan Windows Installer

Penting Tindakan berikut harus dilakukan:

  • File kernel ObjectServer harus diinstal di setiap server AOS.
  • File kernel klien harus diinstal di setiap komputer klien.
  • File kernel NetBusinessConnector dan file kernel ComBusinessConnector harus diinstal di setiap komputer yang menjalankan Microsoft Dynamics AX .NET Business Connector dan Microsoft Dynamics AX Com Business Connector.
  • File kernel ApplicationIntegrationServer adalah Adaptor BizTalk. Pastikan Anda menginstal file kernel ApplicationIntegrationServer bersama dengan file kernel NetBusinessConnector saat memperbarui Adaptor BizTalk.

Pembaruan Windows Installer memperbarui file biner klien Microsoft Dynamics AX 4.0 berikut:

  • File .exe
  • File .dll

File ini juga dikenal sebagai file kernel. Untuk menerapkan pembaruan Windows Installer, ikuti langkah-langkah berikut:

  1. Ekstrak file dari hotfix. File yang diekstrak mungkin berisi folder berikut:

    • ApplicationIntegrationServer
    • Klien
    • ComBusinessConnector
    • NETBusinessConnector
    • ObjectServer

  2. Uji hotfix di lingkungan pengujian. Kemudian, jadwalkan waktu henti.

  3. Keluar dari semua klien perangkat lunak Microsoft Dynamics AX. Kemudian, matikan instans AOS yang tersambung ke file share program produksi.

  4. Cadangkan database, lalu cadangkan folder aplikasi.

  5. Jalankan file Setup.exe yang disertakan dalam setiap folder dalam hotfix.

  6. Mulai ulang instans AOS. Tinjau log kejadian aplikasi di server yang menjalankan layanan AOS untuk memastikan bahwa instans AOS dimulai dengan benar. Instans AOS menyusun ulang indeks objek aplikasi. File Axapd.aoi berisi indeks objek aplikasi.

    Catatan: Tergantung pada perangkat keras server yang Anda gunakan, pengaktifan instans AOS mungkin akan habis sebelum proses selesai. Masalah ini terjadi karena proses tidak cukup waktu untuk menyusun ulang file Axapd.aoi.

  7. Gunakan instans AOS untuk masuk ke klien menggunakan akun Administrator Microsoft Dynamics AX 4.0. Verifikasi bahwa Anda dapat berhasil menyambungkan.

Hotfix yang dirilis sebagai file .xpo yang berisi kode

Hotfix yang dirilis sebagai file .xpo berisi perbaikan tingkat kode yang secara langsung memengaruhi objek atau tabel database di Microsoft Dynamics AX.

Penting Sebelum melanjutkan, periksa setiap file .xpo untuk objek atau tabel yang akan diubah. Catat setiap penyesuaian pada lingkungan Anda saat ini yang mungkin terpengaruh. Kami sangat menyarankan Anda menerapkan semua hotfix di lingkungan pengujian sebelum menerapkan hotfix ke sistem langsung Anda.

  1. Masuk ke Microsoft Dynamics AX menggunakan akun Administrator Microsoft Dynamics AX. Pastikan tidak ada pengguna lain yang masuk ke Microsoft Dynamics AX.

  2. Buka kotak dialog Pohon Objek Aplikasi . Untuk melakukannya, gunakan salah satu metode berikut:

    • Pada toolbar Standar , klik Pohon Objek Aplikasi.
    • Pada keyboard, tekan Ctrl+D.
    • Pada menu File , arahkan ke Buka, lalu klik Pohon Objek Aplikasi.

  3. Dalam kotak dialog Pohon Objek Aplikasi , klik Impor pada toolbar.

  4. Klik Telusuri, lalu temukan file .xpo.

  5. Dalam kotak dialog Buka , klik file .xpo, lalu klik Buka.

  6. Klik OK untuk menyelesaikan proses impor.

    Catatan: Anda mungkin harus menyelesaikan kompilasi terusan atau proses kompilasi Application Object Tree (AOT) penuh.

Cara menginstal hotfix yang dirilis sebagai file DIS-layer atau DIP-layer

Untuk menginstal hotfix yang dirilis sebagai file DIS-layer atau DIP-layer, ikuti langkah-langkah berikut:

  1. Ekstrak file dari paket hotfix.

  2. Sebelum menyalin file yang disertakan dalam hotfix ke komputer, gunakan proses pencadangan biasa untuk mencadangkan folder aplikasi dan file server yang terpengaruh oleh hotfix.

  3. Uji hotfix di lingkungan pengujian. Kemudian, jadwalkan waktu henti ketika tidak ada pengguna lain di sistem.

  4. Keluar dari semua klien perangkat lunak Microsoft Dynamics AX. Kemudian, matikan instans Application Object Server yang tersambung ke file share program produksi.

  5. Salin file AxDIS.aod dan file AxDISen-us.ald ke setiap folder aplikasi yang memiliki file .aod lainnya. Secara default, folder ini berada di lokasi berikut:
    \application\appl\standardNote Pada langkah ini, selalu gunakan fungsi salin. Jangan gunakan fungsi pemindahan. Saat Anda memindahkan file, izin folder sumber akan diambil untuk file ini. Saat Anda menyalin file, file akan memerlukan izin dari folder target.

  6. Buat salinan cadangan file Axapd.aoi dengan mengganti nama file. Atau, hapus file Axapd.aoi di setiap folder aplikasi.

  7. Mulai ulang instans AOS. Tinjau log Aplikasi di server yang menjalankan instans AOS untuk memastikan bahwa instans AOS dimulai dengan benar. Instans AOS menyusun ulang indeks objek aplikasi. File Axapd.aoi berisi indeks objek aplikasi.

    Catatan: Tergantung pada perangkat keras server yang Anda gunakan, pengaktifan instans AOS mungkin akan habis sebelum proses selesai. Masalah ini terjadi karena proses tidak cukup waktu untuk menyusun ulang file Axapd.aoi.

    Instans AOS akan tetap dalam status awal hingga file .aoi dibuat ulang. Pada saat itu, instans AOS akan memiliki status "dimulai". Tidak ada langkah tambahan yang diperlukan. Tunggu hingga pembuatan ulang selesai, lalu tinjau log Aplikasi untuk indikasi bahwa instans AOS dimulai.

  8. Gunakan instans AOS untuk masuk ke komputer klien menggunakan akun Administrator Microsoft Dynamics AX 4.0. Selanjutnya, sambungkan ke instans AOS ini menggunakan perangkat lunak klien untuk memverifikasi bahwa Anda dapat berhasil tersambung. Terakhir, verifikasi bahwa perubahan terdeteksi oleh Microsoft Dynamics AX dan terlihat di AOT.

  9. Jika daftar periksa peningkatan muncul, lengkapi daftar periksa untuk memastikan tidak akan ada masalah tambahan. Jika tidak ada daftar periksa peningkatan yang muncul, lapisan DIS atau DIP tidak dikenali. Jika lapisan DIS atau DIP tidak dikenali, gunakan satu atau beberapa metode berikut:

    • Buat folder aplikasi baru. Kemudian, salin semua file dari folder aplikasi yang ada ke folder aplikasi baru.

    • Ubah konfigurasi instans AOS untuk menggunakan folder aplikasi baru. Untuk melakukannya, ikuti langkah-langkah berikut:

      1. Klik Mulai, klik Jalankan, ketik Control Admintools, lalu klik OK.

      2. Klik ganda Utilitas Konfigurasi Microsoft Dynamics AX.

      3. Pada tab Server Objek Aplikasi , pilih folder aplikasi baru yang Anda buat di daftar instans aplikasi.

      4. Terapkan konfigurasi, lalu mulai ulang instans AOS.

      5. Ulangi langkah 8.

  10. Setelah daftar periksa selesai, kompilasi ulang seluruh aplikasi.

  11. Jika Anda menggunakan beberapa folder aplikasi dan beberapa instans AOS, hentikan semua instans AOS, lalu mulai ulang semua instans AOS.

Referensi

Untuk informasi selengkapnya tentang opsi impor untuk file .xpo, lihat Panduan Pengembang Microsoft Dynamics AX.

Produk pihak ketiga yang dibahas dalam artikel ini dibuat oleh perusahaan yang bukan merupakan bagian dari Microsoft. Microsoft tidak memberikan jaminan, secara tersirat maupun tersurat, terkait kinerja atau keandalan produk tersebut.