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

È possibile aggiornare XClarity Administrator v4.0 o versioni successive solo da un'istanza XClarity Administrator v3.0 o successiva. Se si utilizza una versione precedente alla 3.0, è necessario eseguire l'aggiornamento alla versione 3.0 o successive, prima di eseguire l'aggiornamento a XClarity Administrator v4.0.

Per gestire istanze v4.0 o successive XClarity Administrator mediante Lenovo XClarity Orchestrator, è necessario XClarity Orchestrator v2.0 o versioni successive. 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 mostrato un file yml di esempio, con IPv6 abilitato.

    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. 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.
    <span className="ph">COMPOSE_HTTP_TIMEOUT=300</span> docker-compose -p ${CONTAINER_NAME} ––env-file <ENV_FILENAME> up -d