Instala, configura y gestiona el complemento Z Understand and Refactor en un despliegue existente de IBM Bob on-premises.

Z Understand and Refactor es un complemento opcional del paquete IBM Z Premium para IBM Bob on-premises. Extiende un despliegue base de Bob Core con capacidades de análisis y modernización de aplicaciones z/OS. El complemento debe habilitarse a nivel de infraestructura y asignarse a los usuarios antes de poder utilizarse. Para más información, consulta Gestión de asignaciones.

Z Understand proporciona análisis automatizado de activos de aplicaciones z/OS, incluyendo código fuente COBOL, PL/I, JCL y HLASM. Refactor expone los servicios que usa la extensión IBM Bob IDE para generar recomendaciones de modernización.

Requisitos previos

Antes de instalar y configurar la carga de trabajo Z Understand and Refactor, asegúrate de que se cumplen los siguientes requisitos previos:

Un despliegue de IBM Bob on-premises está instalado y en funcionamiento. Para más información, consulta Instalación.

Hay una base de datos relacional compatible disponible y accesible desde el clúster de Red Hat OpenShift Container Platform (OCP):

Db2: puerto predeterminado 50000
Microsoft SQL Server: puerto predeterminado 1433

Están disponibles privilegios de cluster-admin, o permisos equivalentes, para el clúster OCP de destino.

El archivo config.yaml está configurado con el valor instanceNamespace apropiado para tu despliegue.

Descripción general de la configuración

Habilitar la carga de trabajo

En config.yaml, habilita Z Understand:

bob:
  understand:
    enabled: true

Aplica la configuración:

# Nueva instalación
./bobctl install

# Instalación existente
./bobctl upgrade

Configurar Z Understand

Crea un archivo de configuración setup.json a partir de la muestra específica para tu base de datos:

Para Db2:

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

Para SQL Server:

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

Edita setup.json y reemplaza todos los marcadores <INSERT_...> con los valores de tu entorno:

Campo	Descripción
`relationalDatabaseServer.host`	Hostname o dirección IP del servidor de base de datos relacional.
`relationalDatabaseServer.port`	Puerto utilizado para conectarse al servidor de base de datos. Usa `50000` para Db2 o `1433` para Microsoft SQL Server.
`relationalDatabaseServer.username`	Nombre de usuario de una cuenta de base de datos con permisos de lectura y escritura.
`relationalDatabaseServer.password`	Contraseña de la cuenta de usuario de la base de datos.
`graphDatabaseServer.password`	Contraseña del servicio interno de base de datos de grafos. Configúrala durante la instalación y guárdala de forma segura.
`userAccess.password`	Contraseña para la cuenta de administrador de Z Understand.

Nota:

generalSettings.ip no requiere configuración manual. El controlador detecta y completa automáticamente el hostname de entrada del clúster durante el despliegue.

Ejecutar la configuración

Ejecuta el comando de configuración para almacenar la configuración como un Kubernetes Secret, actualizar el CR de Bob para habilitar la carga de trabajo y monitorear el estado del despliegue:

./bobctl understand setup --config setup.json

El comando:

Crea un Kubernetes Secret con las credenciales de la base de datos.
Actualiza el recurso personalizado de Bob para referenciar el secreto.
Espera a que la carga de trabajo alcance el estado Ready.

El proceso de configuración puede tardar hasta 15 minutos.

Flag	Requerido	Predeterminado	Descripción
`--config <filepath>`	Sí	Ninguno	Ruta al archivo de configuración `setup.json`.
`--secret-name <name>`	No	`bobz-understand-setup`	Nombre del Kubernetes Secret creado para almacenar la configuración.
`--no-wait`	No	Ninguno	Sale inmediatamente sin esperar a que la carga de trabajo alcance el estado `Ready`.
`--dry-run`	No	Ninguno	Valida y previsualiza los cambios sin aplicarlos al clúster.

Nota: El comando setup solo puede ejecutarse una vez durante el despliegue inicial. Para la gestión posterior del ciclo de vida, usa los comandos enable y disable.

Verificar el despliegue

Verifica que los pods de Z Understand and Refactor están en ejecución:

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

Comprueba el estado de la carga de trabajo:

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

Estado esperado: Ready

Z Understand and Refactor