3.3 將 OpenText Identity Console 升級為 Docker 容器

當有新版的 OpenText Identity Console 映像時，管理員可以執行升級程序，以部署含最新版 OpenText Identity Console 的容器。請確保將所有必要的應用程式相關資料，永久儲存在 Docker 磁碟區中，再執行升級。執行下列步驟以使用 Docker 容器升級 OpenText Identity Console：

如同安裝 OpenText Identity Console 中所述，從軟體授權和下載下載並載入最新版本的 Docker 映像，然後執行步驟以安裝最新版本的 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>
```
附註：
- 您可以接受 EULA，作法是將 ACCEPT_EULA 環境變數設為 'Y'。您可以在啟動容器時，透過使用 Docker 中的 -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 位址或網域名稱

使用以下指令啟動第二個容器：

docker start identityconsole-container-name

範例：

docker start identityconsole-container-2

若要檢查執行容器的狀態，請執行下列指令：
```
docker ps -a
```