Instal, konfigurasikan, dan kelola add-on Z Understand and Refactor dalam deployment IBM Bob self-hosted yang sudah ada.

Z Understand and Refactor adalah add-on IBM Z Premium Package opsional untuk IBM Bob self-hosted. Add-on ini memperluas deployment Bob Core dasar dengan kapabilitas analisis dan modernisasi aplikasi z/OS. Add-on ini harus diaktifkan di tingkat infrastruktur dan ditetapkan kepada pengguna sebelum dapat digunakan. Untuk informasi lebih lanjut, lihat Mengelola entitlemen.

Z Understand menyediakan analisis otomatis aset aplikasi z/OS termasuk kode sumber COBOL, PL/I, JCL, dan HLASM. Refactor mengekspos layanan yang digunakan oleh ekstensi IBM Bob IDE untuk menghasilkan rekomendasi modernisasi.

Prasyarat

Sebelum menginstal dan mengonfigurasi workload Z Understand and Refactor, pastikan prasyarat berikut terpenuhi:

Deployment IBM Bob self-hosted sudah terinstal dan beroperasi. Untuk informasi lebih lanjut, lihat Instalasi.

Database relasional yang didukung tersedia dan dapat diakses dari cluster Red Hat OpenShift Container Platform (OCP):

Db2: port default 50000
Microsoft SQL Server: port default 1433

Hak cluster-admin, atau izin yang setara, tersedia untuk cluster OCP target.

File config.yaml dikonfigurasi dengan nilai instanceNamespace yang sesuai untuk deploymentmu.

Ikhtisar setup

Aktifkan workload

Di config.yaml, aktifkan Z Understand:

bob:
  understand:
    enabled: true

Terapkan konfigurasi:

# Instalasi baru
./bobctl install

# Instalasi yang sudah ada
./bobctl configure

Konfigurasikan Z Understand

Buat file konfigurasi setup.json dari sampel spesifik database:

Untuk Db2:

cp setup.sample.ocp.db2.json setup.json

Untuk SQL Server:

cp setup.sample.ocp.sqlserver.json setup.json

Edit setup.json dan ganti semua placeholder <INSERT_...> dengan nilai lingkunganmu:

Field	Deskripsi
`relationalDatabaseServer.host`	Hostname atau alamat IP server database relasional.
`relationalDatabaseServer.port`	Port yang digunakan untuk terhubung ke server database. Gunakan `50000` untuk Db2 atau `1433` untuk Microsoft SQL Server.
`relationalDatabaseServer.username`	Username akun database dengan izin baca dan tulis.
`relationalDatabaseServer.password`	Password untuk akun pengguna database.
`graphDatabaseServer.password`	Password untuk layanan database graph internal. Konfigurasikan saat setup dan simpan dengan aman.
`userAccess.password`	Password untuk akun admin Z Understand.

Catatan:

generalSettings.ip tidak memerlukan konfigurasi manual. Controller secara otomatis mendeteksi dan mengisi hostname ingress cluster yang sesuai selama deployment.

Jalankan setup

Jalankan perintah setup untuk menyimpan konfigurasi sebagai Kubernetes Secret, memperbarui Bob CR untuk mengaktifkan workload, dan memantau status deployment:

./bobctl understand setup --config setup.json

Perintah ini:

Membuat Kubernetes Secret yang berisi kredensial database.
Memperbarui custom resource Bob untuk merujuk ke secret.
Menunggu workload mencapai status Ready.

Proses setup dapat memakan waktu hingga 15 menit.

Flag	Wajib	Default	Deskripsi
`--config <filepath>`	Ya	Tidak ada	Path ke file konfigurasi `setup.json`.
`--secret-name <name>`	Tidak	`bobz-understand-setup`	Nama Kubernetes Secret yang dibuat untuk menyimpan konfigurasi.
`--no-wait`	Tidak	Tidak ada	Keluar segera tanpa menunggu workload mencapai `Ready`.
`--dry-run`	Tidak	Tidak ada	Validasi dan pratinjau perubahan tanpa menerapkannya ke cluster.

Catatan:

Perintah setup hanya dapat dijalankan sekali selama deployment awal. Untuk manajemen siklus hidup berikutnya, perbarui config.yaml dan jalankan ./bobctl configure. Lihat Mengaktifkan dan menonaktifkan Z Understand and Refactor.

Verifikasi deployment

Verifikasi bahwa pod Z Understand and Refactor sedang berjalan:

oc get pods -n <instance-namespace> -l app=ibm-bobz-understand
oc get pods -n <instance-namespace> -l app=ibm-bobz-refactor

Periksa status workload:

oc get bob <cr-name> -n <instance-namespace> \
  -o jsonpath='{.status.understand.status}'

Status yang diharapkan: Ready

Z Understand and Refactor