Installez, configurez et gérez l'add-on Z Understand and Refactor dans un déploiement IBM Bob on-premises existant.

Z Understand and Refactor est un add-on IBM Z Premium Package optionnel pour IBM Bob on-premises. Il étend un déploiement Bob Core de base avec des fonctionnalités d'analyse et de modernisation des applications z/OS. L'add-on doit être activé au niveau de l'infrastructure et attribué aux utilisateurs avant de pouvoir être utilisé. Pour plus d'informations, voir Gestion des droits.

Z Understand fournit une analyse automatisée des ressources applicatives z/OS, y compris le code source COBOL, PL/I, JCL et HLASM. Refactor expose les services que l'extension IBM Bob IDE utilise pour générer des recommandations de modernisation.

Prérequis

Avant d'installer et de configurer la charge de travail Z Understand and Refactor, assurez-vous que les prérequis suivants sont satisfaits :

Un déploiement IBM Bob on-premises est installé et opérationnel. Pour plus d'informations, voir Installation.

Une base de données relationnelle prise en charge est disponible et accessible depuis le cluster Red Hat OpenShift Container Platform (OCP) :

Db2 : port par défaut 50000
Microsoft SQL Server : port par défaut 1433

Des privilèges cluster-admin, ou des permissions équivalentes, sont disponibles pour le cluster OCP cible.

Le fichier config.yaml est configuré avec la valeur instanceNamespace appropriée pour votre déploiement.

Présentation de la configuration

Activer la charge de travail

Dans config.yaml, activez Z Understand :

bob:
  understand:
    enabled: true

Appliquez la configuration :

# Nouvelle installation
./bobctl install

# Installation existante
./bobctl upgrade

Configurer Z Understand

Créez un fichier de configuration setup.json à partir de l'exemple correspondant à la base de données :

Pour Db2 :

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

Pour SQL Server :

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

Modifiez setup.json et remplacez tous les espaces réservés <INSERT_...> par les valeurs de votre environnement :

Champ	Description
`relationalDatabaseServer.host`	Nom d'hôte ou adresse IP du serveur de base de données relationnelle.
`relationalDatabaseServer.port`	Port utilisé pour se connecter au serveur de base de données. Utilisez `50000` pour Db2 ou `1433` pour Microsoft SQL Server.
`relationalDatabaseServer.username`	Nom d'utilisateur d'un compte de base de données avec des permissions de lecture et d'écriture.
`relationalDatabaseServer.password`	Mot de passe du compte utilisateur de la base de données.
`graphDatabaseServer.password`	Mot de passe pour le service de base de données graphique interne. À configurer lors de la mise en place et à stocker en lieu sûr.
`userAccess.password`	Mot de passe du compte administrateur Z Understand.

Remarque :

generalSettings.ip ne nécessite pas de configuration manuelle. Le contrôleur détecte et renseigne automatiquement le nom d'hôte d'entrée du cluster lors du déploiement.

Exécuter la configuration

Exécutez la commande de configuration pour stocker la configuration en tant que secret Kubernetes, mettre à jour la CR Bob afin d'activer la charge de travail et surveiller l'état du déploiement :

./bobctl understand setup --config setup.json

La commande :

Crée un secret Kubernetes contenant les identifiants de la base de données.
Met à jour la ressource personnalisée Bob pour référencer le secret.
Attend que la charge de travail atteigne l'état Ready.

Le processus de configuration peut prendre jusqu'à 15 minutes.

Flag	Obligatoire	Défaut	Description
`--config <filepath>`	Oui	Aucun	Chemin vers le fichier de configuration `setup.json`.
`--secret-name <name>`	Non	`bobz-understand-setup`	Nom du secret Kubernetes créé pour stocker la configuration.
`--no-wait`	Non	Aucun	Quitter immédiatement sans attendre que la charge de travail atteigne l'état `Ready`.
`--dry-run`	Non	Aucun	Valider et prévisualiser les modifications sans les appliquer au cluster.

Remarque : La commande setup ne peut être exécutée qu'une seule fois lors du déploiement initial. Pour la gestion ultérieure du cycle de vie, utilisez les commandes enable et disable.

Vérifier le déploiement

Vérifiez que les pods Z Understand and Refactor sont en cours d'exécution :

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

Vérifiez l'état de la charge de travail :

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

État attendu : Ready

Z Understand and Refactor