기존 IBM Bob 온프레미스 배포에서 Z Understand 및 Refactor 애드온을 설치, 구성 및 관리합니다.

Z Understand 및 Refactor는 IBM Bob 온프레미스를 위한 선택적 IBM Z Premium Package 애드온입니다. 기본 Bob Core 배포에 z/OS 애플리케이션 분석 및 현대화 기능을 추가합니다. 이 애드온은 인프라 수준에서 활성화되고 사용자에게 할당되어야 사용할 수 있습니다. 자세한 내용은 자격 증명 관리를 참조하세요.

Z Understand는 COBOL, PL/I, JCL, HLASM 소스 코드를 포함한 z/OS 애플리케이션 자산에 대한 자동화된 분석을 제공합니다. Refactor는 IBM Bob IDE 확장이 현대화 권장 사항을 생성하는 데 사용하는 서비스를 노출합니다.

전제 조건

Z Understand 및 Refactor 워크로드를 설치하고 구성하기 전에 다음 전제 조건이 충족되었는지 확인하세요:

IBM Bob 온프레미스 배포가 설치되어 작동 중이어야 합니다. 자세한 내용은 설치를 참조하세요.

지원되는 관계형 데이터베이스를 사용할 수 있고 Red Hat OpenShift Container Platform(OCP) 클러스터에서 접근할 수 있어야 합니다:

Db2: 기본 포트 50000
Microsoft SQL Server: 기본 포트 1433

대상 OCP 클러스터에 대한 cluster-admin 권한 또는 이에 상응하는 권한이 있어야 합니다.

config.yaml 파일에 배포에 적합한 instanceNamespace 값이 구성되어 있어야 합니다.

설정 개요

워크로드 활성화

config.yaml에서 Z Understand를 활성화합니다:

bob:
  understand:
    enabled: true

구성을 적용합니다:

# 신규 설치
./bobctl install

# 기존 설치
./bobctl upgrade

Z Understand 구성

데이터베이스별 샘플에서 setup.json 구성 파일을 생성합니다:

Db2의 경우:

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

SQL Server의 경우:

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

setup.json을 편집하고 모든 <INSERT_...> 자리표시자를 사용자 환경 값으로 바꿉니다:

필드	설명
`relationalDatabaseServer.host`	관계형 데이터베이스 서버의 호스트 이름 또는 IP 주소입니다.
`relationalDatabaseServer.port`	데이터베이스 서버에 연결하는 데 사용되는 포트입니다. Db2의 경우 `50000`, Microsoft SQL Server의 경우 `1433`을 사용하세요.
`relationalDatabaseServer.username`	읽기 및 쓰기 권한이 있는 데이터베이스 계정의 사용자 이름입니다.
`relationalDatabaseServer.password`	데이터베이스 사용자 계정의 비밀번호입니다.
`graphDatabaseServer.password`	내부 그래프 데이터베이스 서비스의 비밀번호입니다. 설정 중에 이를 구성하고 안전하게 보관하세요.
`userAccess.password`	Z Understand 관리자 계정의 비밀번호입니다.

참고:

generalSettings.ip는 수동 구성이 필요하지 않습니다. 컨트롤러가 배포 중에 적절한 클러스터 인그레스 호스트 이름을 자동으로 감지하여 채웁니다.

설정 실행

설정 명령을 실행하여 구성을 Kubernetes Secret으로 저장하고, Bob CR을 업데이트하여 워크로드를 활성화하며, 배포 상태를 모니터링합니다:

./bobctl understand setup --config setup.json

이 명령은 다음 작업을 수행합니다:

데이터베이스 자격 증명이 포함된 Kubernetes Secret을 생성합니다.
Bob 사용자 정의 리소스(CR)가 시크릿을 참조하도록 업데이트합니다.
워크로드가 Ready 상태에 도달할 때까지 대기합니다.

설정 프로세스는 최대 15분이 소요될 수 있습니다.

플래그	필수 여부	기본값	설명
`--config <filepath>`	예	없음	`setup.json` 구성 파일의 경로입니다.
`--secret-name <name>`	아니요	`bobz-understand-setup`	구성을 저장하기 위해 생성된 Kubernetes Secret의 이름입니다.
`--no-wait`	아니요	없음	워크로드가 `Ready` 상태에 도달할 때까지 기다리지 않고 즉시 종료합니다.
`--dry-run`	아니요	없음	클러스터에 변경 사항을 적용하지 않고 유효성을 검사하고 미리 봅니다.

참고: setup 명령은 초기 배포 중에 한 번만 실행할 수 있습니다. 이후의 라이프사이클 관리에는 enable 및 disable 명령을 사용하세요.

배포 확인

Z Understand 및 Refactor 파드가 실행 중인지 확인합니다:

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

워크로드 상태를 확인합니다:

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

예상 상태: Ready

Z Understand 및 Refactor