3.3 DockerコンテナとしてのOpenText Identity Consoleのアップグレード

OpenText Identity Consoleイメージの新しいバージョンが使用可能になった場合、管理者は、最新バージョンのOpenText Identity Consoleを使用してコンテナを展開するためのアップグレード手順を実行できます。アップグレードを実行する前に、すべての必要なアプリケーション関連データをDockerボリュームに永続的に保存するようにしてください。Dockerコンテナを使用してOpenText Identity Consoleをアップグレードするには、次の手順を実行します。

ソフトウェアライセンスとダウンロードから最新バージョンのDockerイメージをダウンロードしてロードし、OpenText Identity Consoleのインストールに記載されている、最新バージョンのOpenText Identity Consoleをインストールする手順を実行します。
最新のDockerイメージがロードされた後、次のコマンドを使用して現在のDockerコンテナを停止します。
```
docker stop identityconsole-container-name
```
例:
```
docker stop identityconsole-container-1
```
次のコマンドを実行して、既存のOpenText Identity Consoleコンテナを削除します。
```
docker rm identityconsole-container-name
```
例:
```
docker rm identityconsole-container-1
```
(オプション)次のコマンドを実行して、廃止されたOpenText Identity Console Dockerイメージを削除します。
```
docker rmi identityconsole-image
```
例:
```
docker rmi identityconsole:<version>
```
イメージをローカルのDockerレジストリにロードする必要があります。次のコマンドを使用して、IdentityConsole_<version>_Containers.tar.gzファイルを抽出してロードします。
```
tar -xvf IdentityConsole_version_Containers.tar.gz              
```
```
docker load --input identityconsole.tar.gz
```
次のコマンドで、OpenText Identity Console Dockerコンテナを作成します。
```
docker create --name identityconsole-container-name --env ACCEPT_EULA=Y --network=network-type --volume volume-name:/config/ identityconsole:version
```
例:
```
docker create --name identityconsole-container-2 --env ACCEPT_EULA=Y --network=host --volume IDConsole-volume:/config/ identityconsole:<version>
```
メモ:
- ACCEPT_EULA環境変数を「Y」に設定することによって、EULAに同意することができます。対話型モードのDocker createコマンドで-itオプションを使用することにより、コンテナの起動中に画面のプロンプトからEULAに同意することもできます。
- 上のコマンドの--volumeパラメータによって、環境設定データとログデータを保存するボリュームが作成されます。この場合、IDConsole-volumeというサンプルボリュームが作成されます。
次のコマンドを使用して、ローカルファイルシステムから新しく作成されたコンテナに、環境設定ファイル(edirapi.conf)を/etc/opt/novell/eDirAPI/conf/edirapi.confとしてコピーします。
```
docker cp absolute path of configuration file identityconsole-container-name:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
例:
```
docker cp /home/user/edirapi.conf identityconsole-container-2:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
(OpenText Identity Console 1.9以降)サンプルの環境設定ファイルを次に示します。
```
listen = ":9000"
pfxpassword = "novell"
bcert = "/etc/opt/novell/eDirAPI/cert/"
ospmode=false
auto-fetch=false
```
メモ:
- 環境設定ファイルからedir-hostsパラメータを削除し、auto-fetchパラメータを追加します。
- auto-fetch = falseの場合は、CA証明書を手動でcertフォルダにコピーする必要があります。
(OpenText Identity Console 1.8以前)サンプルの環境設定ファイルを次に示します。
```
listen = ":9000"
pfxpassword = "novell"
bcert = "/etc/opt/novell/eDirAPI/cert/"
ospmode=false
edir-hosts = "<ip_address-1>:636,<ip_address-2>:636"
```
メモ:
- OpenText Identity Console 1.7.2および1.8にアップグレードする際は、OpenText eDirectoryサーバIPをedirapi.confファイルに追加してから、そのファイルをコンテナにコピーする必要があります。
- OpenText Identity Consoleを複数のOpenText eDirectoryツリーに接続する場合は、それらのツリーのIPアドレスまたはドメイン名をカンマで区切って入力します。

次のコマンドを使用して、2番目のコンテナを開始します。

docker start identityconsole-container-name

例:

docker start identityconsole-container-2

実行中のコンテナのステータスを確認するには、次のコマンドを実行します。
```
docker ps -a
```