27.8 OpenText eDirectory用のRESTサービスのアップグレード

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

ソフトウェアライセンスおよびダウンロードポータルから最新バージョンのDockerイメージをダウンロードしてロードし、最新バージョンのOpenText eDirectoryをインストールする手順を実行します。
最新のDockerイメージがロードされた後、次のコマンドを使用して現在のDockerコンテナを停止します。
```
docker stop <edirapi-container-name>
```
例:
```
docker stop edirapi-container-1
```
次のコマンドを実行して、既存のOpenText eDirectoryコンテナを削除します。
```
docker rm < edirapi -container-name>
```
例:
```
docker rm edirapi -container-1
```
(省略可能) 次のコマンドを実行して、廃止されたOpenText eDirectory Dockerイメージを削除します。
```
docker rmi <edirapi-image ID>
```
例:
```
docker rmi edirapi: 1.4.1.0000
```

次のコマンドを使用して、新しいREST Dockerイメージを使用して新しいコンテナを作成します。

docker create --name < edirapi -container-name> --env ACCEPT_EULA=Y --network=<network-type> --volume <volume-name>:/config/ edirapi:<version>

例:

docker create --name edirapi -container-2 --env ACCEPT_EULA=Y --network=host --volume edirapi -volume:/config/ edirapi: 1.4.1.0000

次のコマンドを使用して、ローカルファイルシステムから新しく作成されたコンテナに、環境設定ファイル((edirapi.conf))を/etc/opt/novell/eDirAPI/conf/edirapi.confとしてコピーします。
```
docker cp <absolute path of configuration file> edirapi- containername:/etc/opt/novell/eDirAPI/conf/edirapi.conf 
```
例:
```
docker cp /home/user/edirapi.conf edirapi-container-2:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
サンプルの環境設定ファイルを以下に示します。
```
listen = ":9000" 

pfxpassword = "novell" 

bcert = "/etc/opt/novell/eDirAPI/cert/" 

ospmode=false 

edir-hosts = "<ip_address-1>:636,<ip_address-2>:636"
```
メモ:
- OpenText eDirectory 1.7.2以上にアップグレードする場合、コンテナにコピーする前に、OpenText eDirectoryサーバIPをedirapi.confファイルに追加する必要があります。
- OpenText eDirectoryを複数のOpenText eDirectoryツリーに接続する場合は、それらのIPアドレスまたはドメイン名をコンマで区切って入力します。
次のコマンドを使用して、2番目のコンテナを開始します。
```
docker start <edirapi-container-name>
```
例:
```
docker start edirapi -container-2
```
実行中のコンテナのステータスを確認するには、次のコマンドを実行します。
```
docker ps -a
```

メモ:REST Services 1.4は、REST 1.3に続く次のリリースです。これら2つのリリースの間に、RESTサービスの暫定リリースはありませんでした。1.4の後、OpenText eDirectoryではREST 1.4.0.0100をリリースし、OpenSSL 1.0.2zdのサポートを追加しました。このOpenSSLバージョンには、潜在的なセキュリティ脆弱性の修正が含まれています。この問題の詳細については、このページを参照してください。