3.3 Upgrade di OpenText Identity Console come container di Docker

Quando è disponibile una nuova versione dell'immagine di OpenText Identity Console, l'amministratore può eseguire una procedura di upgrade per la distribuzione del container con la versione più recente di OpenText Identity Console. Accertarsi di memorizzare costantemente tutti i dati necessari relativi alle applicazioni nei volumi di Docker prima di eseguire un upgrade. Eseguire i seguenti passaggi per eseguire l'upgrade di OpenText Identity Console mediante il container di Docker:

Effettuare il download e caricare l'ultima versione dell'immagine Docker da Software License and Download (Licenze software e download) ed eseguire i passaggi per installare la versione più recente di OpenText Identity Console come indicato in Installazione di OpenText Identity Console.
Una volta caricata l'immagine Docker più recente, arrestare il container di Docker corrente utilizzando il seguente comando:
```
docker stop identityconsole-container-name
```
Esempio:
```
docker stop identityconsole-container-1
```
Eliminare il container di OpenText Identity Console esistente eseguendo il seguente comando:
```
docker rm identityconsole-container-name
```
Ad esempio:
```
docker rm identityconsole-container-1
```
(Facoltativo) Eliminare l'immagine Docker di OpenText Identity Console obsoleta eseguendo il seguente comando:
```
docker rmi identityconsole-image
```
Esempio:
```
docker rmi identityconsole:<version>
```
L'immagine deve essere caricata nel registro locale di Docker. Estrarre e caricare il file IdentityConsole_<version>_Containers.tar.gz utilizzando i comandi seguenti:
```
tar -xvf IdentityConsole_version_Containers.tar.gz              
```
```
docker load --input identityconsole.tar.gz
```
Creare il container di Docker di OpenText Identity Console utilizzando il seguente comando:
```
docker create --name identityconsole-container-name --env ACCEPT_EULA=Y --network=network-type --volume volume-name:/config/ identityconsole:version
```
Ad esempio:
```
docker create --name identityconsole-container-2 --env ACCEPT_EULA=Y --network=host --volume IDConsole-volume:/config/ identityconsole:<version>
```
NOTA:
- È possibile accettare l'EULA impostando la variabile d'ambiente ACCEPT_EULA su 'Y'. È anche possibile accettare l'EULA dal prompt sullo schermo mentre si avvia il container utilizzando l'opzione -it nel comando di creazione di Docker per la modalità interattiva.
- Il parametro --volume nel comando precedente creerà un volume per la memorizzazione dei dati di configurazione e di log. In questo caso, è stato creato un volume di esempio denominato IDConsole-volume.
Copiare il file di configurazione (edirapi.conf) dal file system locale al container appena creato come /etc/opt/novell/eDirAPI/conf/edirapi.conf utilizzando il seguente comando:
```
docker cp absolute path of configuration file identityconsole-container-name:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
Ad esempio:
```
docker cp /home/user/edirapi.conf identityconsole-container-2:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
(OpenText Identity Console 1.9 e versioni successive) Di seguito è riportato un file di configurazione di esempio:
```
listen = ":9000"
pfxpassword = "novell"
bcert = "/etc/opt/novell/eDirAPI/cert/"
ospmode=false
auto-fetch=false
```
NOTA:
- Rimuovere il parametro edir-hosts dal file di configurazione e aggiungere il parametro auto-fetch.
- Se auto-fetch = false, è necessario copiare manualmente il certificato CA nella cartella cert.
(OpenText Identity Console 1.8 e versioni precedenti) Di seguito è riportato un file di configurazione di esempio:
```
listen = ":9000"
pfxpassword = "novell"
bcert = "/etc/opt/novell/eDirAPI/cert/"
ospmode=false
edir-hosts = "<ip_address-1>:636,<ip_address-2>:636"
```
NOTA:
- Durante l'upgrade a OpenText Identity Console 1.7.2 e 1.8, è necessario aggiungere l'IP del server OpenText eDirectory al file edirapi.conf prima di copiarlo nel container.
- Se si desidera che OpenText Identity Console si connetta a più alberi OpenText eDirectory, immettere i relativi indirizzi IP o nomi di dominio separati da virgole

Avviare il secondo container utilizzando il seguente comando:

docker start identityconsole-container-name

Esempio:

docker start identityconsole-container-2

Eseguire il seguente comando per verificare lo stato del container in esecuzione:
```
docker ps -a
```