Passaggio 6. Installare e configurare un contenitore XClarity Administrator (Docker)

Installare e configurare l'Lenovo XClarity Administrator nel contenitore sull'host Docker appena installato.

Procedura

Per installare un contenitore XClarity Administrator utilizzando Docker Compose, completare la seguente procedura.

1. Scaricare l'immagine, il file di ambiente e il file YAML dell'appliance virtuale 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_<ver>_anyos_noarch.tar.gz
   

3. Modificare il file docker_compose.env e aggiornare le variabili di ambiente che seguono.
   • CONTAINER_NAME. Nome univoco del contenitore, utilizzato per creare volumi docker per ogni istanza di XClarity Administrator (ad esempio, CONTAINER_NAME=LXCA-203)
   • INDIRIZZO. Indirizzo IPv4 statico per il contenitore (ad esempio, ADDRESS=192.0.2.0)
   • BACKUP_MOUNT. (Facoltativo) Percorso per la condivisione remota che può essere utilizzata per archiviare i backup di XClarity Administrator. Il percorso deve essere: /mnt/backup_share.
   • FIRMWARE_MOUNT. (Facoltativo) Percorso per la condivisione remota che può essere utilizzata come repository remoto per gli aggiornamenti firmware. Il percorso deve essere: /mnt/fw_share.

   Di seguito viene riportato un file di ambiente.

   CONTAINER_NAME="LXCA-203"
   ADDRESS="192.0.2.0"
   BACKUP_MOUNT="/mnt/backup_share"
   FIRMWARE_MOUNT="/mnt/fw_share"
   
   

4. Modificare il file docker_compose.yml e aggiornare le proprietà che seguono.
   • Impostare la proprietà image con il nome del file dell'immagine di installazione utilizzato nel passaggio 2.
     Nota

     È possibile modificare il nome del file di immagine (ad esempio, in "più recente") utilizzando il comando docker tag.
   • Se si desidera utilizzare la condivisione remota come repository firmware remoto per archiviare i backup di XClarity Administrator impostare il punto di montaggio dell'host per ciascuna condivisione remota nella proprietà volumi.
   • Impostare la proprietà dns sull'indirizzo IP dei server DNS.
   • Il contenitore condivide il pool di risorse di memoria e processore disponibili per l'host. Facoltativamente definire i limiti sull'utilizzo delle risorse impostando le proprietà cpus e memoria.
   • Impostare la proprietà principale sul nome dell'interfaccia di rete del sistema host da utilizzare come interfaccia principale per l'interfaccia macvlan nel contenitore. Questa interfaccia deve disporre dell'accesso diretto alla sottorete assegnata al contenitore.
   • Impostare la sottorete e il gateway in base alla topologia di rete. In genere, la sottorete e il gateway sono per la rete di gestione, a cui appartiene ${ADDRESS}.
   • Se si desidera supportare IPv6, impostare la proprietà enable_ipv6 su true, impostare la proprietà ipv6_address sull'indirizzo IPv6 e aggiungere un'altra serie di proprietà di sottorete e gateway in base alla topologia di rete (generalmente per la rete di gestione a cui appartiene l'indirizzo IPv6).

   Nota

   XClarity Administrator utilizza macvlan per configurare la rete dei contenitori. Per ulteriori informazioni, consultare la sezione Utilizzo della pagina Web delle reti macvlan

   Di seguito è riportato 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"
   
   

5. Distribuire l'immagine in docker, utilizzando il comando seguente, dove <ENV_FILENAME> è il nome del file delle variabili d'ambiente creato nel passaggio 2.

   COMPOSE_HTTP_TIMEOUT=300 docker-compose -p ${CONTAINER_NAME} ––env-file <ENV_FILENAME> up -d