Atualizando o XClarity Administrator como um contêiner

Ao executar o Lenovo XClarity Administrator como um contêiner, use este procedimento de atualização para instalar o software mais recente como um novo contêiner e vincular os volumes do contêiner original ao novo contêiner.

Antes de iniciar

É possível atualizar o XClarity Administrator v4.0 ou posterior apenas em um XClarity Administrator v3.0 ou instância posterior. Se você estiver usando um XClarity Administrator que seja anterior a v3.0, você deverá fazer atualização para v3.0 ou posterior antes de atualizá-lo para v4.0.

Para gerenciar instâncias do XClarity Administratorv4.0 ou posteriores usando o Lenovo XClarity Orchestrator, o XClarity Orchestrator v2.0 ou posterior é necessário. Se você estiver atualizando o XClarity Administrator para v4.0 ou posterior, o XClarity Orchestrator já deverá estar na versão v2.0 ou posterior.

Sobre esta tarefa

O arquivo docker-compose.yml usa as variáveis de ambiente a seguir, configuradas durante a instalação do contêiner original. Essas variáveis de ambiente também são usadas pelo novo contêiner.

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)
O XClarity Administrator usa o nome do contêiner para criar os volumes do contêiner. Se você usar o mesmo nome para o novo contêiner, a nova instância do XClarity Administrator usará nos mesmos volumes e, portanto, terá acesso aos mesmos dados e configurações do sistema que a instância original do XClarity Administrator (contêiner).
Se você alterar o nome do contêiner, novos volumes serão criados para o contêiner, e a nova instância do XClarity Administrator não terá acesso aos mesmos dados e configurações do sistema que a instância original do XClarity Administrator (contêiner). Se você precisar alterar o nome do contêiner ou o endereço IP, faça backup dos dados do sistema e configurações da instância original do XClarity Administrator antes de instalar o novo contêiner e, em seguida, use esse backup para restaurar os dados do sistema e a configuração no novo contêiner.
ADDRESS. Endereço estático IPv4 ou IPv6 para o contêiner (por exemplo, ADDRESS=192.0.2.0)
Alterar o endereço IP do XClarity Administrator depois de gerenciar dispositivos pode fazer com que os dispositivos sejam colocados no estado offline no XClarity Administrator. Certifique-se de que o gerenciamento de todos os dispositivos seja cancelado antes de alterar o endereço IP.
BACKUP_MOUNT e FIRMWARE_MOUNT. (Opcional) Caminhos para os compartilhamentos remotos que podem ser usados para armazenar backups do XClarity Administrator ou usados como repositório remoto para atualizações de firmware. Os caminhos devem ser /mnt/backup_share e /mnt/fw_share, respectivamente.

Nota

O XClarity Administratornão é executado como um contêiner privilegiado.

Procedimento

Para atualizar um contêiner do XClarity Administrator, conclua as etapas a seguir.

Baixe a imagem do contêiner do XClarity Administrator do Página da Web de download do XClarity Administrator para uma estação de trabalho cliente. Faça login no Web site e, em seguida, use a tecla de acesso que foi fornecida para baixar a imagem.

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_110-3.5.0_anyos_noarch

Edite o mesmo docker-compose.yml que foi usado para o contêiner original. Atualize a propriedade da imagem no início do arquivo para apontar para a nova imagem docker na etapa 2. É possível alterar a etiqueta de imagem usando o comando docker tag.

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"

Desligue o contêiner original executando o comando a seguir.

docker-compose -p ${CONTAINER_NAME} down

Implante a nova imagem no docker executando o comando a seguir, em que <ENV_FILENAME> é o nome do arquivo de variáveis do ambiente.

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

Enviar feedback