27.8 Mise à niveau des services REST pour OpenText eDirectory

Quand une nouvelle version de l'image REST est disponible, l'administrateur peut effectuer une mise à niveau pour déployer le conteneur à l'aide de la dernière version des services REST. Veillez à assurer le stockage persistant de toutes les données nécessaires liées à l'application dans les volumes Docker avant d'effectuer une mise à niveau. Procédez comme suit pour effectuer la mise à niveau des services REST à l'aide d'un conteneur Docker :

  1. Téléchargez et chargez la dernière version de l'image Docker à partir du portail de téléchargements et de licences de logiciels, puis suivez la procédure pour installer la dernière version d'OpenText eDirectory.

  2. Une fois la dernière image Docker chargée, arrêtez votre conteneur Docker actuel à l'aide de la commande suivante :

    docker stop <edirapi-container-name>

    Exemple

    docker stop edirapi-container-1
  3. Supprimez le conteneur OpenText eDirectory existant en exécutant la commande suivante :

    docker rm < edirapi -container-name>

    Exemple

    docker rm edirapi -container-1
  4. (Facultatif) Supprimez l'image Docker obsolète d'OpenText eDirectory en exécutant la commande suivante :

    docker rmi <edirapi-image ID>

    Exemple

    docker rmi edirapi: 1.4.1.0000
  5. Créez un conteneur à l'aide de la nouvelle image Docker REST à l'aide de la commande suivante :

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

    Exemple

    docker create --name edirapi -container-2 --env ACCEPT_EULA=Y --network=host --volume edirapi -volume:/config/ edirapi: 1.4.1.0000 
    
  6. Copiez le fichier de configuration (edirapi.conf) de votre système de fichiers local vers le nouveau conteneur en tant que /etc/opt/novell/eDirAPI/conf/edirapi.conf à l'aide de la commande suivante :

    docker cp <absolute path of configuration file> edirapi- containername:/etc/opt/novell/eDirAPI/conf/edirapi.conf 

    Exemple

    docker cp /home/user/edirapi.conf edirapi-container-2:/etc/opt/novell/eDirAPI/conf/edirapi.conf

    Voici un exemple de fichier de configuration :

    listen = ":9000" 
    
    pfxpassword = "novell" 
    
    bcert = "/etc/opt/novell/eDirAPI/cert/" 
    
    ospmode=false 
    
    edir-hosts = "<ip_address-1>:636,<ip_address-2>:636"

    REMARQUE :

    • Lors de la mise à niveau vers OpenText eDirectory 1.7.2 et version ultérieure, il est nécessaire d'ajouter l'adresse IP du serveur OpenText OpenText eDirectory au fichier edirapi.conf avant de la copier dans le conteneur.

    • Si vous souhaitez qu'OpenText eDirectory se connecte à plusieurs arborescences OpenText eDirectory, entrez leur adresse IP ou nom de domaine en les séparant par des virgules.

  7. Démarrez le second conteneur à l'aide de la commande suivante :

    docker start <edirapi-container-name>

    Exemple

    docker start edirapi -container-2
  8. Consultez l'état du conteneur en cours d'exécution à l'aide de la commande suivante :

    docker ps -a

REMARQUE :La version 1.4 des services REST suit immédiatement la version 1.3. Il n'y a pas eu de version intermédiaire pour les services REST entre ces deux versions. Après la version 1.4, OpenText eDirectory a publié la version 1.4.0.0100 des services REST, qui ajoute la prise en charge d'OpenSSL 1.0.2zd. Cette version d'OpenSSL inclut un correctif pour une vulnérabilité potentielle de sécurité. Pour plus d'informations sur le problème, consultez cette page.