Passa al contenuto principale

Aggiornamento di XClarity Administrator come contenitore

Quando Lenovo XClarity Administrator viene eseguito come contenitore, utilizzare questa procedura di aggiornamento per installare il software più recente come nuovo contenitore e collegare i volumi del contenitore originale al nuovo contenitore.

Prima di iniziare

Per eseguire l'aggiornamento di XClarity Administrator come contenitore Docker da v4.0 a v4.1, vedere Aggiornamento di XClarity Administrator 4.0 alla versione v4.1 come contenitore.

Non è possibile eseguire l'aggiornamento da una versione precedente di XClarity Administrator come contenitore Docker a XClarity Administrator v4.0. È invece necessario installare l'immagine completa di XClarity Administrator v4.0 (vedere Installazione di Lenovo XClarity Administrator in un ambiente Docker, CentOS, Citrix, Red Hat KVM, Rocky, Ubuntu, VMware ESXi o Windows Hyper-V).

Per gestire XClarity Administrator v4.0 o istanze successive mediante Lenovo XClarity Orchestrator, è necessario XClarity Orchestrator v2.0 o una versione successiva. Se si sta aggiornando XClarity Administrator alla versione 4.0 o successive, verificare che la versione di XClarity Orchestrator sia già la 2.0 o successive.

Informazioni su questa attività

Il file docker-compose.yml utilizza le seguenti variabili di ambiente, impostate durante l'installazione del contenitore originale. Queste variabili di ambiente vengono utilizzate anche dal nuovo contenitore.

  • CONTAINER_NAME. Nome univoco del contenitore, utilizzato per creare volumi docker per ciascuna istanza XClarity Administrator (ad esempio, CONTAINER_NAME=LXCA-203)

    XClarity Administrator utilizza il nome del contenitore per creare i volumi per il contenitore. Se si utilizza lo stesso nome del contenitore per il nuovo contenitore, la nuova istanza XClarity Administrator utilizzerà gli stessi volumi e avrà quindi avrà accesso agli stessi dati e impostazioni di sistema dell'istanza XClarity Administrator originale (contenitore).

    Se si modifica il nome del contenitore vengono creati nuovi volumi per il contenitore e la nuova istanza XClarity Administrator non avrà accesso agli stessi dati e impostazioni di sistema dell'istanza XClarity Administrator originale (contenitore). Se è necessario modificare il nome del contenitore o l'indirizzo IP, eseguire il backup dei dati e delle impostazioni di sistema per l'istanza XClarity Administrator originale, prima di installare il nuovo contenitore. Utilizzare quindi questo backup per ripristinare i dati di sistema e le impostazioni nel nuovo contenitore.

  • INDIRIZZO. Indirizzo IPv4 statico o IPv6 per il contenitore (ad esempio, ADDRESS=192.0.2.0)

    La modifica dell'indirizzo IP di XClarity Administrator dopo la gestione dei dispositivi potrebbe determinare l'attivazione dello stato offline dei dispositivi in XClarity Administrator. Verificare che tutti i dispositivi risultino non gestiti prima di modificare l'indirizzo IP.

  • BACKUP_MOUNT e FIRMWARE_MOUNT (facoltativo). Percorsi per le condivisioni remote che possono essere utilizzati per memorizzare i backup di XClarity Administrator o come repository remoto per gli aggiornamenti firmware. I percorsi devono essere, rispettivamente, /mnt/backup_share e /mnt/fw_share.

Nota
XClarity Administratornon viene eseguito come contenitore con privilegi.

Procedura

Per importare un contenitore XClarity Administrator, completare la seguente procedura.

  1. Scaricare l'immagine del contenitore XClarity Administrator dalla Pagina Web di download di XClarity Administrator in una workstation client. Accedere al sito Web, quindi utilizzare la chiave di accesso fornita per scaricare l'immagine.
  2. Importare l'immagine del contenitore XClarity Administrator nell'host docker, utilizzando il comando seguente.
    docker load -i lnvgy_sw_lxca_110-3.5.0_anyos_noarch
  3. Modificare lo stesso file docker-compose.yml utilizzato per il contenitore originale. Aggiornare la proprietà dell'immagine nella parte superiore del file in modo che punti alla nuova immagine del docker del passaggio 2. È possibile modificare l'etichetta dell'immagine utilizzando il comando docker tag.

    Di seguito viene riportato un file yml di esempio.

    version: '3.8'

    services:

    lxca:
    image: lenovo/lxca:lnvgy_sw_lxca_container_111-4.0.0_anyos_noarch
    container_name: ${CONTAINER_NAME}
    tty: true
    stop_grace_period: 60s
    volumes:
    # Bind mount remote shares to the container
    - /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/data
    - log:/var/log
    - confluent-etc:/etc/confluent
    - confluent-log:/var/log/confluent
    - confluent:/var/lib/confluent
    - propconf:/opt/lenovo/lxca/bin/conf
    networks:
    lan:
    ipv4_address: ${ADDRESS}

    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

    networks:
    lan:
    name: lan
    driver: macvlan
    driver_opts:
    parent: eth0
    ipam:
    config:
    - subnet: 192.0.0.0/19
    gateway: 192.0.30.1

  4. Arrestare il contenitore originale utilizzando il comando seguente.
    docker-compose -p ${CONTAINER_NAME} down
  5. Distribuire la nuova immagine nel docker utilizzando il comando seguente, dove <ENV_FILENAME> è il nome del file delle variabili di ambiente.
    COMPOSE_HTTP_TIMEOUT=300 docker-compose -p ${CONTAINER_NAME} ––env-file <ENV_FILENAME> up -d