Installa, configura e gestisci l'add-on Z Understand and Refactor in un deployment IBM Bob on-premises esistente.

Z Understand and Refactor è un add-on IBM Z Premium Package opzionale per IBM Bob on-premises. Estende un deployment base di Bob Core con funzionalità di analisi e modernizzazione delle applicazioni z/OS. L'add-on deve essere abilitato a livello infrastrutturale e assegnato agli utenti prima di poter essere usato. Per ulteriori informazioni, vedere Gestione degli entitlement.

Z Understand fornisce analisi automatizzata degli asset applicativi z/OS inclusi sorgenti COBOL, PL/I, JCL e HLASM. Refactor espone i servizi che l'estensione IBM Bob IDE usa per generare raccomandazioni di modernizzazione.

Prerequisiti

Prima di installare e configurare il workload Z Understand and Refactor, assicurati che i seguenti prerequisiti siano soddisfatti:

Un deployment IBM Bob on-premises è installato e operativo. Per ulteriori informazioni, vedere Installazione.

Un database relazionale supportato è disponibile e accessibile dal cluster Red Hat OpenShift Container Platform (OCP):

Db2: porta predefinita 50000
Microsoft SQL Server: porta predefinita 1433

Sono disponibili privilegi cluster-admin, o permessi equivalenti, per il cluster OCP di destinazione.

Il file config.yaml è configurato con il valore instanceNamespace appropriato per il tuo deployment.

Panoramica della configurazione

Abilitare il workload

In config.yaml, abilita Z Understand:

bob:
  understand:
    enabled: true

Applica la configurazione:

# Nuova installazione
./bobctl install

# Installazione esistente
./bobctl upgrade

Configurare Z Understand

Crea un file di configurazione setup.json dall'esempio specifico per il database:

Per Db2:

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

Per SQL Server:

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

Modifica setup.json e sostituisci tutti i segnaposto <INSERT_...> con i valori del tuo ambiente:

Campo	Descrizione
`relationalDatabaseServer.host`	Hostname o indirizzo IP del server di database relazionale.
`relationalDatabaseServer.port`	Porta usata per connettersi al server di database. Usa `50000` per Db2 o `1433` per Microsoft SQL Server.
`relationalDatabaseServer.username`	Nome utente di un account del database con permessi di lettura e scrittura.
`relationalDatabaseServer.password`	Password per l'account utente del database.
`graphDatabaseServer.password`	Password per il servizio di database a grafo interno. Configurala durante la configurazione e conservala in modo sicuro.
`userAccess.password`	Password per l'account amministratore Z Understand.

Nota:

generalSettings.ip non richiede configurazione manuale. Il controller rileva e popola automaticamente il nome host ingress del cluster durante il deployment.

Eseguire la configurazione

Esegui il comando di configurazione per memorizzare la configurazione come Kubernetes Secret, aggiornare la Bob CR per abilitare il workload e monitorare lo stato del deployment:

./bobctl understand setup --config setup.json

Il comando:

Crea un Kubernetes Secret contenente le credenziali del database.
Aggiorna la custom resource Bob per fare riferimento al secret.
Attende che il workload raggiunga lo stato Ready.

Il processo di configurazione può richiedere fino a 15 minuti.

Flag	Obbligatorio	Predefinito	Descrizione
`--config <filepath>`	Sì	Nessuno	Percorso del file di configurazione `setup.json`.
`--secret-name <name>`	No	`bobz-understand-setup`	Nome del Kubernetes Secret creato per memorizzare la configurazione.
`--no-wait`	No	Nessuno	Esci immediatamente senza attendere che il workload raggiunga lo stato `Ready`.
`--dry-run`	No	Nessuno	Valida e visualizza in anteprima le modifiche senza applicarle al cluster.

Nota: Il comando setup può essere eseguito una sola volta durante il deployment iniziale. Per la successiva gestione del ciclo di vita, usa i comandi enable e disable.

Verificare il deployment

Verifica che i pod Z Understand and Refactor siano in esecuzione:

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

Controlla lo stato del workload:

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

Stato atteso: Ready

Z Understand and Refactor