既存のIBM Bobオンプレミスデプロイメントにおいて、Z Understand and Refactorアドオンをインストール、設定、および管理します。

Z Understand and Refactor は、IBM Bob オンプレミス向けのオプションの IBM Z プレミアムパッケージアドオンです。ベースの Bob Core デプロイメントを z/OS アプリケーション分析とモダナイゼーション機能で拡張します。このアドオンを使用するには、インフラストラクチャレベルで有効化され、ユーザーに割り当てられている必要があります。詳細については、エンタイトルメントの管理を参照してください。

Z Understand は COBOL、PL/I、JCL、HLASM ソースコードを含む z/OS アプリケーションアセットの自動分析を提供します。Refactor は IBM Bob IDE 拡張機能がモダナイゼーション推奨事項を生成するために使用するサービスを公開します。

前提条件

Z Understand and 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 は手動での設定は不要です。コントローラーはデプロイメント中に適切なクラスター ingress ホスト名を自動的に検出して設定します。

セットアップの実行

セットアップコマンドを実行して、設定をKubernetes Secretとして保存し、Bob CRを更新してワークロードを有効にし、デプロイメントの状態を監視します：

./bobctl understand setup --config setup.json

このコマンドは以下を行います：

データベースクレデンシャルを含むKubernetes Secretを作成します。
Bob カスタムリソースを更新して、Secretを参照するようにします。
ワークロードが Ready 状態になるまで待機します。

セットアッププロセスには最大15分かかる場合があります。

フラグ	必須	デフォルト	説明
`--config <filepath>`	はい	なし	`setup.json` 設定ファイルへのパス。
`--secret-name <name>`	いいえ	`bobz-understand-setup`	設定を保存するために作成されるKubernetes Secretの名前。
`--no-wait`	いいえ	なし	ワークロードが `Ready` 状態になるのを待たずにすぐに終了します。
`--dry-run`	いいえ	なし	クラスターに変更を適用せずに、変更内容を検証してプレビューします。

注意： setup コマンドは初期デプロイメント時に一度だけ実行できます。その後のライフサイクル管理には enable および disable コマンドを使用してください。

デプロイメントの確認

Z Understand and Refactor の Pod が実行されていることを確認します：

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 and Refactor