Etapa 6. Instalar e configurar o XClarity Administrator (Docker)

Instale e configure o contêiner do Lenovo XClarity Administrator no host do Docker que acabou de ser instalado.

Procedimento

Para instalar um contêiner do XClarity Administrator usando a composição do Docker, conclua as etapas a seguir.

1. Baixe a imagem do dispositivo virtual do XClarity Administrator, o arquivo de ambiente e o arquivo YAML do Página da Web de download do XClarity Administrator para uma estação de trabalho do cliente. Faça login no Web site e, em seguida, use a tecla de acesso que foi fornecida para baixar a imagem.
2. Importe a imagem de contêiner do XClarity Administrator para seu host do docker executando o comando a seguir.

   docker load -i lnvgy_sw_lxca_<ver>_anyos_noarch.tar.gz
   

3. Edite o arquivo docker_compose.env e atualize as variáveis de ambiente a seguir.
   • CONTAINER_NAME. Nome exclusivo do contêiner, usado para criar volumes de docker para cada instância do XClarity Administrator (por exemplo, CONTAINER_NAME=LXCA-203)
   • ADDRESS. Endereço estático IPv4 para o contêiner (por exemplo, ADDRESS=192.0.2.0)
   • BACKUP_MOUNT. (Opcional) Caminho para o compartilhamento remoto que pode ser usado para armazenar backups do XClarity Administrator. Deve ser /mnt/backup_share.
   • FIRMWARE_MOUNT. (Opcional) Caminho para o compartilhamento remoto que pode ser usado como um repositório remoto para atualizações de firmware. Deve ser /mnt/fw_share.

   Veja a seguir um exemplo de arquivo de ambiente.

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

4. Edite o docker_compose.yml e atualize as propriedades a seguir.
   • Defina a propriedade image como o nome do arquivo de imagem de instalação usado na etapa 2.
     Nota

     É possível alterar o nome do arquivo de imagem (por exemplo, para "mais recente") usando o comando docker tag.
   • Se você deseja usar compartilhamentos remotos como um repositório de firmware remoto e armazenar backups do XClarity Administrator, defina o ponto de montagem do host para cada compartilhamento remoto na propriedade volumes.
   • Defina a propriedade dns como o endereço IP dos servidores DNS.
   • O contêiner compartilha o conjunto de recursos de processador e memória que estão disponíveis para o host. Opcionalmente, defina limites de uso de recurso configurando as propriedades cpus e memória.
   • Defina a propriedade parent como o nome da interface de rede no sistema host que deve ser usada como a interface pai para a interface macvlan no contêiner. Essa interface deve ter acesso direto à sub-rede atribuída ao contêiner.
   • Defina a sub-rede e o gateway de acordo com a topologia de rede. Normalmente, a sub-rede e o gateway se destinam à rede de gerenciamento, à qual pertence o ${ADDRESS}.
   • Se você deseja dar suporte ao IPv6, defina a propriedade enable_ipv6 como true, defina a propriedade ipv6_address como o endereço IPv6 e adicione outro conjunto de propriedades de sub-rede e gateway de acordo com sua topologia de rede (geralmente para rede de gerenciamento à qual o endereço IPv6 pertence).

   Veja a seguir um arquivo YML de exemplo, com IPv6 habilitado.

   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. Implante a imagem no docker executando o comando a seguir, em que <ENV_FILENAME> é o nome do arquivo de variáveis do ambiente criado na etapa 2.

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