Das Z-Understand-und-Refactor-Add-on in einem bestehenden IBM-Bob-On-Premises-Deployment installieren, konfigurieren und verwalten.

Z Understand and Refactor ist ein optionales IBM-Z-Premium-Paket-Add-on für IBM Bob On-Premises. Es erweitert ein Bob-Core-Basis-Deployment um z/OS-Anwendungsanalyse- und Modernisierungsfunktionen. Das Add-on muss auf Infrastrukturebene aktiviert und Benutzern zugewiesen werden, bevor es verwendet werden kann. Weitere Informationen findest du unter Berechtigungsverwaltung.

Z Understand bietet automatisierte Analyse von z/OS-Anwendungsassets einschließlich COBOL-, PL/I-, JCL- und HLASM-Quellcode. Refactor stellt die Dienste bereit, die die IBM-Bob-IDE-Erweiterung zur Generierung von Modernisierungsempfehlungen verwendet.

Voraussetzungen

Bevor du den Z-Understand-und-Refactor-Workload installierst und konfigurierst, stelle sicher, dass die folgenden Voraussetzungen erfüllt sind:

Ein IBM-Bob-On-Premises-Deployment ist installiert und in Betrieb. Weitere Informationen findest du unter Installation.

Eine unterstützte relationale Datenbank ist verfügbar und vom Red Hat OpenShift Container Platform (OCP)-Cluster aus erreichbar:

Db2: Standardport 50000
Microsoft SQL Server: Standardport 1433

cluster-admin-Berechtigungen oder gleichwertige Berechtigungen sind für den Ziel-OCP-Cluster verfügbar.

Die Datei config.yaml ist mit dem entsprechenden instanceNamespace-Wert für dein Deployment konfiguriert.

Einrichtungsübersicht

Workload aktivieren

Aktiviere in config.yaml Z Understand:

bob:
  understand:
    enabled: true

Wende die Konfiguration an:

# Neue Installation
./bobctl install

# Bestehende Installation
./bobctl upgrade

Z Understand konfigurieren

Erstelle eine setup.json-Konfigurationsdatei aus dem datenbankspezifischen Beispiel:

Für Db2:

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

Für SQL Server:

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

Bearbeite setup.json und ersetze alle <INSERT_...>-Platzhalter durch deine Umgebungswerte:

Feld	Beschreibung
`relationalDatabaseServer.host`	Hostname oder IP-Adresse des relationalen Datenbankservers.
`relationalDatabaseServer.port`	Port für die Verbindung zum Datenbankserver. Verwende `50000` für Db2 oder `1433` für Microsoft SQL Server.
`relationalDatabaseServer.username`	Benutzername eines Datenbankkontos mit Lese- und Schreibberechtigungen.
`relationalDatabaseServer.password`	Passwort für das Datenbankbenutzerkonto.
`graphDatabaseServer.password`	Passwort für den internen Graph-Datenbankdienst. Wird während der Einrichtung konfiguriert und sicher gespeichert.
`userAccess.password`	Passwort für das Z-Understand-Administratorkonto.

Hinweis:

generalSettings.ip erfordert keine manuelle Konfiguration. Der Controller erkennt und befüllt automatisch den entsprechenden Cluster-Ingress-Hostnamen während des Deployments.

Einrichtung ausführen

Führe den Setup-Befehl aus, um die Konfiguration als Kubernetes-Secret zu speichern, die Bob-CR zur Aktivierung des Workloads zu aktualisieren und den Deployment-Status zu überwachen:

./bobctl understand setup --config setup.json

Der Befehl:

Erstellt ein Kubernetes-Secret mit Datenbank-Anmeldeinformationen.
Aktualisiert die benutzerdefinierte Bob-Ressource, um auf das Secret zu verweisen.
Wartet, bis der Workload den Status Ready erreicht.

Der Einrichtungsprozess kann bis zu 15 Minuten dauern.

Flag	Erforderlich	Standard	Beschreibung
`--config <filepath>`	Ja	Keiner	Pfad zur `setup.json`-Konfigurationsdatei.
`--secret-name <name>`	Nein	`bobz-understand-setup`	Name des zur Speicherung der Konfiguration erstellten Kubernetes-Secrets.
`--no-wait`	Nein	Keiner	Sofort beenden, ohne auf den Status `Ready` des Workloads zu warten.
`--dry-run`	Nein	Keiner	Änderungen validieren und in der Vorschau anzeigen, ohne sie auf den Cluster anzuwenden.

Hinweis: Der Befehl setup kann nur einmal während des initialen Deployments ausgeführt werden. Für das weitere Lifecycle-Management verwende die Befehle enable und disable.

Deployment überprüfen

Überprüfe, ob die Z-Understand-und-Refactor-Pods laufen:

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

Überprüfe den Workload-Status:

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

Erwarteter Status: Ready

Z Understand and Refactor