Instaluj, konfiguruj i zarządzaj dodatkiem Z Understand and Refactor w istniejącym wdrożeniu IBM Bob on-premises.

Z Understand and Refactor to opcjonalny dodatek IBM Z Premium Package dla IBM Bob on-premises. Rozszerza bazowe wdrożenie Bob Core o możliwości analizy aplikacji z/OS i modernizacji. Dodatek musi być włączony na poziomie infrastruktury i przypisany użytkownikom przed jego użyciem. Więcej informacji można znaleźć w artykule Zarządzanie uprawnieniami.

Z Understand zapewnia zautomatyzowaną analizę zasobów aplikacji z/OS, w tym kodu źródłowego COBOL, PL/I, JCL i HLASM. Refactor udostępnia usługi, z których korzysta rozszerzenie IBM Bob IDE do generowania rekomendacji dotyczących modernizacji.

Wymagania wstępne

Przed instalacją i konfiguracją obciążenia Z Understand and Refactor upewnij się, że spełnione są następujące wymagania:

Wdrożenie IBM Bob on-premises jest zainstalowane i działa poprawnie. Więcej informacji znajdziesz w Instalacji.

Obsługiwana relacyjna baza danych jest dostępna i osiągalna z klastra Red Hat OpenShift Container Platform (OCP):

Db2: domyślny port 50000
Microsoft SQL Server: domyślny port 1433

Uprawnienia cluster-admin lub równoważne są dostępne dla docelowego klastra OCP.

Plik config.yaml jest skonfigurowany z odpowiednią wartością instanceNamespace dla Twojego wdrożenia.

Przegląd konfiguracji

Włącz obciążenie

W pliku config.yaml włącz Z Understand:

bob:
  understand:
    enabled: true

Zastosuj konfigurację:

# Nowa instalacja
./bobctl install

# Istniejąca instalacja
./bobctl upgrade

Skonfiguruj Z Understand

Utwórz plik konfiguracyjny setup.json na podstawie przykładu właściwego dla używanej bazy danych:

Dla Db2:

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

Dla SQL Server:

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

Edytuj plik setup.json i zastąp wszystkie symbole zastępcze <INSERT_...> wartościami ze swojego środowiska:

Pole	Opis
`relationalDatabaseServer.host`	Nazwa hosta lub adres IP serwera relacyjnej bazy danych.
`relationalDatabaseServer.port`	Port używany do połączenia z serwerem bazy danych. Użyj `50000` dla Db2 lub `1433` dla Microsoft SQL Server.
`relationalDatabaseServer.username`	Nazwa użytkownika konta bazy danych z uprawnieniami odczytu i zapisu.
`relationalDatabaseServer.password`	Hasło do konta użytkownika bazy danych.
`graphDatabaseServer.password`	Hasło do wewnętrznej usługi grafowej bazy danych. Skonfiguruj podczas konfiguracji i przechowuj w bezpiecznym miejscu.
`userAccess.password`	Hasło do konta administratora Z Understand.

Uwaga:

generalSettings.ip nie wymaga ręcznej konfiguracji. Kontroler automatycznie wykrywa i uzupełnia odpowiednią nazwę hosta ingress klastra podczas wdrożenia.

Uruchom konfigurację

Uruchom polecenie setup, aby zapisać konfigurację jako Kubernetes Secret, zaktualizować Bob CR w celu włączenia obciążenia i monitorować stan wdrożenia:

./bobctl understand setup --config setup.json

Polecenie:

Tworzy Kubernetes Secret zawierający dane uwierzytelniające bazy danych.
Aktualizuje niestandardowy zasób Bob, aby odwoływał się do sekretu.
Czeka, aż obciążenie osiągnie stan Ready.

Proces konfiguracji może potrwać do 15 minut.

Flaga	Wymagana	Domyślna	Opis
`--config <filepath>`	Tak	Brak	Ścieżka do pliku konfiguracyjnego `setup.json`.
`--secret-name <name>`	Nie	`bobz-understand-setup`	Nazwa Kubernetes Secret tworzonego do przechowywania konfiguracji.
`--no-wait`	Nie	Brak	Zakończ natychmiast bez oczekiwania na osiągnięcie stanu `Ready`.
`--dry-run`	Nie	Brak	Weryfikuje i wyświetla podgląd zmian bez ich stosowania w klastrze.

Uwaga: Polecenie setup może być uruchomione tylko raz podczas wstępnego wdrożenia. Do kolejnego zarządzania cyklem życia używaj poleceń enable i disable.

Zweryfikuj wdrożenie

Sprawdź, czy pody Z Understand and Refactor działają:

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

Sprawdź stan obciążenia:

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

Oczekiwany status: Ready

Z Understand and Refactor