コンテナー化されたツールキット環境のセットアップ

開発者は、 Docker Compose スクリプトを使用してデベロッパーズ・ツールキット環境をセットアップするために、デベロッパーズ・ツールキット・ファイルをダウンロードし、 Docker Compose スクリプトを実行できます。

始める前に

Docker Compose スクリプトを使用してデベロッパーズ・ツールキット環境をセットアップする前に、必ず前提条件を完了してください。必要な前提条件について詳しくは、 Docker Compose スクリプトを使用してデベロッパーズ・ツールキットをインストールするための前提条件を参照してください。

手順

デベロッパーズ・ツールキット・ファイルをダウンロードして解凍します。
1. 特定のディレクトリーを作成 devtoolkit_dockerします。ここで、 Docker Compose スクリプトを使用して、デベロッパーズ・ツールキット環境をセットアップします。
  
  警告: devtoolkit_docker ディレクトリーを作成するパスを賢明に選択してください。後でこの環境を新しいランタイム・イメージでアップグレードする予定の場合は、このディレクトリーを変更することはできません。
2. <runtime>/docker-samples/compose をディレクトリにコピーまたはダウンロードします。はモードで devtoolkit_docker <runtime> Docker Sterling™ Order Management システムをインストールするときに作成されるインストール・ディレクトリです。 Docker モードでの Sterling Order Management System のインストールを参照してください。
3. Sterling Order Management System を Docker モードでインストールする際に作成されるランタイム・ディレクトリからビルドされた Sterling Order Management System Docker イメージをコピーまたはダウンロードします。
4. 以下のコマンドを実行して、ディレクトリーを変更し、Compose スクリプトを実行できるようにします。
  cd devtoolkit_docker/compose && chmod +x *.sh

以下のコマンドを実行して、 Docker Compose スクリプトを使用してデベロッパーズ・ツールキット環境をセットアップします。
./om-compose.sh setup <optional: full_path_to_customization_package>

セットアップを実行する前に、以下の点に注意してください。

セットアップを再試行する場合、クリーン・スレートから開始するには、以下のコマンドを使用して、すべての古いコンテナーまたはボリュームのデータがクリーンアップされていることを確認してください。
./om-compose.sh wipe-clean
注: このコマンドは既存のすべてのデータと構成を消去するため、 Docker Compose スクリプトを使用してデベロッパーズ・ツールキット環境をアップグレードする場合は、これを実行しないでください。
カスタマイズ・パッケージがある場合は、 ステップ 2で説明されているように、コマンドの引数として絶対パスを指定して、カスタマイズをセットアップの一部として組み込みます。

デフォルトでは、このコマンドは、デフォルト構成で Docker Compose スクリプトを最初から使用してデベロッパーズ・ツールキット環境をセットアップすることを前提としています。デフォルト構成を変更またはオーバーライドする場合は、必要に応じて om-compose.properties ファイルを更新します。プロパティーについては、以下の表を参照してください。

表 1. om-compose.properties
プロパティー	デフォルト値	説明
AP_WAR_FILES	smcfs、sbc、sma、isccs、wsc、sfs	デフォルトでインストールされるアプリケーション。デフォルトでは、すべてのアプリケーションが EAR の一部です。 EAR の一部ではないアプリケーションをすべて削除します。
Om_install_localization	いいえ	ロケールおよびローカリゼーション・パッケージをインストールする必要がある場合は、これを true に設定します。
ロケール (OM_LOCALE)	ブランク	次のロケールがサポートされています: zh_CN、zh_TW、fr_FR、ja_JP、pt_BR、ko_KR、ru_RU、tr_TR、it_IT、es_ES、de_DE、pl_PL プロパティー値を、インストールするロケールのみに設定します。
* ポート		_PORT を含むすべてのプロパティー。他のサービスが同じポートで実行されている場合は、これらのプロパティーの値を変更します。理想的には、セットアップを実行する前に、 Db2、Websphere Application Server、Liberty、または MQ アプリケーション・サービスをネイティブに実行して停止する必要があります。したがって、これらのプロパティーの値を変更する必要はありません。
MQ_JNDI_DIR	/var/oms/jndi	MQ .bindings ファイルを保管するローカル・ディレクトリー。このファイルには、すべての MQ オブジェクトの JNDI マッピングが保管されます。デフォルト値を保持する場合は、このディレクトリーが作成されており、書き込み権限を持っていることを確認してください。それ以外の場合は、この値をローカル・ディレクトリーにオーバーライドします。例: /home/user/jndi

注:

この表には、 om-compose.properties ファイルのプロパティーのみがリストされています。これらは、顧客がオーバーライドする可能性があるプロパティーです。ただし、上記のプロパティーを含むプロパティーの完全なリストは、 docker/docker-compose.properties ファイルに記載されています。お客様は、このファイルの任意のプロパティーを om-compose.properties ファイルでもオーバーライドできます。

外部データベースの使用に関連する一連のプロパティーがあります。これらのプロパティーは、 om-compose.properties ファイルでコメント化されています。コメントを外してオーバーライドすることで、使用する外部データベース (Oracle/Db2) をセットアップできます。

注:

Docker の資料に記載されているすべてのファイルまたはコマンドは、 compose ディレクトリーを基準にしています。
実行ログは、 logs ディレクトリーにあります。

セットアップ・コマンドを実行すると、複数のライセンスを読んで同意するように求めるプロンプトが出されます。画面に表示されるライセンスに同意するには、 Enter を押すか、必要に応じて accept と入力します。
セットアップは、約 30 分から 1 時間で終了します。すべてのログは、 logs ディレクトリーに生成されます。
セットアップが完了したら、アプリケーションにアクセスしてインストール済み環境を検証します。
1. http://<IP>:<Port>/sbc/sbc/login.do URLして、Sterling Business Center の展開を確認してください。同様に、他のアプリケーションにアクセスしてみることもできます。
  ここで、IP は環境がデプロイされているマシンの IP アドレス (ローカルにデプロイされている場合はlocalhost ) であり、ポートは 9080(http) または 9443(https)のいずれかです (ユーザーによってオーバーライドされている場合を除く)。
2. URL を使用してAPIテスターにアクセスします。 http://<IP>:<Port>/smcfs/yfshttpapi/yantrahttpapitester.jsp