Aller au contenu principal

Mise à jour de XClarity Administrator en tant que conteneur

Lors de l’exécution de Lenovo XClarity Administrator en tant que conteneur, suivez cette procédure de mise à jour pour installer le logiciel le plus récent comme nouveau conteneur et lier les volumes du conteneur d’origine au nouveau conteneur.

Avant de commencer

Vous pouvez mettre à jour XClarity Administrator version 4.0 ou ultérieure uniquement à partir d'une instance XClarity Administrator version 3.0 ou ultérieure. Si vous utilisez une version de XClarity Administrator antérieure à la version 3.0, vous devez passer à la version 3.0 ou une version ultérieure avant de procéder à la mise à niveau à la version 4.0.

Pour gérer des instances XClarity Administrator de version 4.0 ou ultérieure à l'aide de Lenovo XClarity Orchestrator, XClarity Orchestrator version 2.0 ou ultérieure est requis. Si vous mettez à jour XClarity Administrator à la version 4.0 ou une version ultérieure, assurez-vous que XClarity Orchestrator est déjà à la version 2.0 ou ultérieure.

À propos de cette tâche

Le fichier docker-compose.yml utilise les variables d’environnement suivantes, que vous avez définies lors de l’installation du conteneur d’origine. Ces variables d’environnement sont également utilisées par le nouveau conteneur.

  • CONTAINER_NAME. Nom de conteneur unique, utilisé pour créer des volumes Docker pour chaque instance XClarity Administrator (par exemple, CONTAINER_NAME=LXCA-203)

    XClarity Administrator utilise le nom de conteneur pour créer les volumes du conteneur. Si vous utilisez le même nom de conteneur pour le nouveau conteneur, la nouvelle instance XClarity Administrator va utiliser les mêmes volumes et, par conséquent, aura accès aux mêmes données du système et paramètres de l’instance XClarity Administrator d’origine (conteneur).

    Si vous modifiez le nom de conteneur, de nouveaux volumes sont créés pour le conteneur. La nouvelle instance XClarity Administrator n’aura pas accès aux mêmes données système et aux paramètres de l’instance XClarity Administrator d’origine (conteneur). Si vous devez modifier le nom de conteneur ou l’adresse IP, effectuez une sauvegarde des données système et des paramètres de l’instance XClarity Administrator d’origine avant d’installer le nouveau conteneur. Ensuite, utilisez cette sauvegarde pour restaurer les données du système et les paramètres vers le nouveau conteneur.

  • ADDRESS. Adresse IPv4 ou IPv6 statique pour le conteneur (par exemple, ADDRESS=192.0.2.0)

    Le fait de modifier l'adresse IP de XClarity Administrator après avoir géré des appareils peut avoir pour effet de placer les appareils dans un état hors ligne dans XClarity Administrator. Vérifiez que la gestion de tous les appareils a été annulée avant de modifier l'adresse IP.

  • BACKUP_MOUNT et FIRMWARE_MOUNT. (Facultatif) Chemins pour les partages distants pouvant être utilisés pour stocker les sauvegardes XClarity Administrator ou utilisés en tant que référentiel distant pour les mises à jour de microprogramme. Les chemins doivent respectivement être /mnt/backup_share et /mnt/fw_share.

Remarque
XClarity Administratorn’est pas exécuté en tant que conteneur avec privilèges.

Procédure

Pour mettre à jour un conteneur XClarity Administrator, procédez comme suit.

  1. Téléchargez l’image du conteneur XClarity Administrator depuis le site Page Web de téléchargements XClarity Administrator vers un poste de travail client. Connectez-vous au site Web, puis utilisez la clé d'accès qui vous a été fournie pour télécharger l'image.
  2. Importez l’image de conteneur XClarity Administrator dans votre hôte Docker en exécutant la commande suivante.
    docker load -i lnvgy_sw_lxca_110-3.5.0_anyos_noarch
  3. Modifiez le même fichier docker-compose.yml utilisé pour le conteneur d’origine. Mettez à jour la propriété d’image en haut du fichier pour pointer vers la nouvelle image Docker de l’étape 2. Vous pouvez modifier l’étiquette d’image à l’aide de la commande docker tag.

    Ce qui suit est un exemple de fichier yml, avec IPv6 activé.

    version: '3.8'

    services:

    lxca:
    image: lenovo/lxca:4.1.0-124
    container_name: ${CONTAINER_NAME}
    tty: true
    stop_grace_period: 60s
    volumes:
    #bind mount example
    - /home/<HOST_MOUNT_POINT_FOR_BACKUP>:${BACKUP_MOUNT}
    - /home/<HOST_MOUNT_POINT_FOR_FW_SHARE>:${FIRMWARE_MOUNT}
    #docker volume mount
    - data:/opt/lenovo/lxca/data
    - postgresql:/var/lib/postgresql
    - log:/var/log
    - confluent-etc:/etc/confluent
    - confluent-log:/var/log/confluent
    - confluent:/var/lib/confluent
    - propconf:/opt/lenovo/lxca/bin/conf
    - ssh:/etc/ssh
    - xcat:/etc/xcat
    networks:
    lan:
    ipv4_address: ${ADDRESS}
    ipv6_address: "2001:8003:7d51:2003::2"
    dns:
    - 192.0.2.10
    - 192.0.2.11
    deploy:
    resources:
    limits:
    cpus: "2.0"
    memory: "8g"

    volumes:
    data:
    name: ${CONTAINER_NAME}-data
    postgresql:
    name: ${CONTAINER_NAME}-postgresql
    log:
    name: ${CONTAINER_NAME}-log
    confluent-etc:
    name: ${CONTAINER_NAME}-confluent-etc
    confluent-log:
    name: ${CONTAINER_NAME}-confluent-log
    confluent:
    name: ${CONTAINER_NAME}-confluent
    propconf:
    name: ${CONTAINER_NAME}-propconf
    ssh:
    name: ${CONTAINER_NAME}-ssh
    xcat:
    name: ${CONTAINER_NAME}-xcat

    networks:
    lan:
    name: lan
    driver: macvlan
    enable_ipv6: true
    driver_opts:
    parent: eth0
    ipam:
    config:
    - subnet: 192.0.0.0/19
    gateway: 192.0.30.1
    - subnet: "2001:8003:7d51:2000::/80"
    gateway: "2001:8003:7d51:2000::1"

  4. Arrêtez le conteneur d’origine en exécutant la commande suivante.
    docker-compose -p ${CONTAINER_NAME} down
  5. Déployez la nouvelle image dans Docker en exécutant la commande ci-après, <ENV_FILENAME> étant le nom du fichier des variables d’environnement.
    <span className="ph">COMPOSE_HTTP_TIMEOUT=300</span> docker-compose -p ${CONTAINER_NAME} ––env-file <ENV_FILENAME> up -d