コンテナー化されたデベロッパーズ・ツールキット環境のセットアップ

SI は、ローカル・システム上でコンテナー化されたデベロッパーズ・ツールキット環境のクリーン・セットアップを実行できます。

始める前に

Docker Compose 資料に記載されているすべてのファイルまたはコマンドは、特に明記されていない限り、 devtoolkit_docker/compose ディレクトリーに関連しています。
実行ログは logs ディレクトリーにあります。古いログは、 logs/backups ディレクトリーにバックアップされます。
デフォルトの Docker Compose プロパティー・ファイルの値を確認し、必要に応じて値を変更します。詳しくは、デフォルトの Docker Compose プロパティーのオーバーライドを参照してください。
デベロッパーズ・ツールキット固有の機能プロパティーを追加するには、デベロッパーズ・ツールキット固有の値での機能プロパティーのオーバーライドを参照してください。

手順

デベロッパーズ・ツールキット環境のセットアップのビデオ

スナップショットにおけるデベロッパーズ・ツールキット環境を理解するには、このビデオをご覧ください。

デベロッパーズ・ツールキットを抽出した後、デベロッパーズ・ツールキット環境のセットアップに進むことができます。この手順は、初めてデベロッパーズ・ツールキットをセットアップするユーザー、または既存のデベロッパーズ・ツールキット環境を完全に削除した後でクリーンなデベロッパーズ・ツールキットをセットアップするユーザーに適用できます。

既存のデベロッパーズ・ツールキット環境をアップグレードする場合は、以下の手順は適用されません。アップグレードについて詳しくは、既存のコンテナー化されたデベロッパーズ・ツールキット環境のアップグレードを参照してください。

重要: コマンドを実行してデベロッパーズ・ツールキット環境をセットアップする前に、以下の点を確認してください。

また、このコマンドはワイプ・クリーンを実行して、既存の Docker コンテナーまたはボリューム・データをすべて消去します。
デフォルトでは、このコマンドは、デフォルト構成を使用してデベロッパーズ・ツールキット環境を最初からセットアップすることを想定しています。一般的なユース・ケースでは、 om-compose.properties ファイル内のプロパティーをオーバーライドしたり変更したりする必要はありません。各プロパティーは、既にデフォルト値を想定しています。高度な使用法の場合は、プロパティーのコメントを外してデフォルト値を変更し、必要に応じてオーバーライドすることができます。
ただし、macOS, 上で開発者ツールキットをセットアップする場合は、HOST_OS および JAVA_HOME プロパティをオーバーライドする必要があります。

プロパティーについて詳しくは、デフォルトの Docker Compose プロパティーのオーバーライドを参照してください。
説明に従って devtoolkit_extras.tar ファイルをインストールした場合、セットアッププロセスではデフォルトで Sterling™ Intelligent Promising Inventory Visibility アダプターフェーズ 2 がインストールされます。
開発者ツールキットのテナントで V2 APIを有効にする場合は、 Inventory Visibility、 V2 API がテナントで有効になっていることを確認してください。 Inventory Visibility テナントで有効になっていることを確認してください。開発者ツールキットで V2 APIを有効にするには、 om-compose.properties ファイルの IV_V2_ENABLE=Y プロパティを設定します。

代わりに Sterling Intelligent Promising Inventory Visibility Sterling Intelligent Promising Inventory Visibility フェーズ 1 アダプタを使用した開発者ツールキットのインストールを参照してください。詳細は、インベントリー・サービスを参照。

以下のコマンドを実行して、デベロッパーズ・ツールキット環境をセットアップします。
```
./om-compose.sh setup optional: full_path_to_customization_package
```
セットアップ・コマンドを実行すると、デベロッパーズ・ツールキットのライセンスを読んで同意するように求めるプロンプトが出されます。画面に表示されるライセンスに同意するには、 Enter を押し、 acceptと入力します。
ライセンスを既に読み、受け入れており、プロンプトを出さずにセットアップを実行する場合は、以下のプロパティーを om-compose.propertiesに追加できます。
DTK_LICENSE=accept
セットアップは約 1 時間で終了します。すべてのログは logs ディレクトリーに生成されます。セットアップが完了したら、アプリケーションにアクセスしてインストールを検証します。デフォルトのログイン名は admin で、パスワードは passwordです。
1. 以下の URL にアクセスし、 IBM® Sterling Business Center の展開を確認してください：
```
http://<HOST>:<Port>/sbc/sbc/login.do
```
  - < HOST> は、localhost、またはコンテナーが実行されているホストです。
  - om-compose.properties ファイルでポートを設定しない限り、ポートは 9080(http) または 9443(https)のいずれかです。
2. 以下の URLから APIテスターにアクセスしてください：
```
http://<HOST>:<Port>/smcfs/yfshttpapi/yantrahttpapitester.jsp
```
また、setup コマンドは、ランタイムを om-runtime Docker コンテナーからホスト・システム上の devtoolkit_docker ディレクトリーにコピーします。既存のランタイム・ディレクトリーは、タイム・スタンプ付きで名前変更され、削除されません。
注: ホスト・マシン上のランタイム・ディレクトリーは full path to devtoolkit_docker/runtimeです。

重要: Windows 環境でデベロッパーズ・ツールキットをセットアップした場合は、 localhostではなく、Windows システムからさまざまな UI アプリケーション ( Applications Manager、 IBM MQ コンソールなど) にアクセスするための URL で、WSL 2 システムの IP アドレスを使用する必要があります。 localhostを使用するには、これらのサービスが実行されている関連ポートを WSL2 システムの IP アドレスに転送する必要があります。詳細については、Windows 環境でコンテナ型開発者ツールキットをセットアップするための前提条件を参照してください。
オプションで、次のコマンドを実行することで、デベロッパーズ・ツールキットからクラウド上の Sterling Intelligent Promising Inventory Visibility および Sterling Intelligent Promising Inventory Visibility インスタンスへの接続をいつでも確認できます。
./om-compose.sh check-services
<extracted runtime directory>/bin ディレクトリから以下の統合サーバーを起動し、インベントリの更新がローカルインスタンスからSterling Intelligent Promising Inventory Visibility クラウド上のインスタンスに流れるようにします:
- bash ./startIntegrationServer.sh IV_ADJUST_IS
- bash ./startIntegrationServer.sh IV_ADJUST_ID
注: 統合サーバーは、 IV_DEMAND_EVENT_Q および IV_SUPPLY_EVENT_Q メッセージ・キューを使用します。これらのキューは、統合の目的でのみ使用することをお勧めします。

次のタスク

セットアップ後にCDTデータをインポートしたい場合は、構成展開ツール(CDT)を使用して構成をインポートする構成展開ツール(CDT)を使用して構成をインポートするを参照してください。