メインコンテンツまでスキップ

XClarity Administratorコンテナーとしての更新

Lenovo XClarity Administrator をコンテナーとして実行する場合は、この更新手順を使用して最新のソフトウェアを新しいコンテナーとしてインストールし、元のコンテナーのボリュームを新しいコンテナーにバインドします。

始める前に

XClarity Administrator v4.0 以降は、XClarity Administrator v3.0 以降のインスタンスからのみ更新できます。v3.0 より前のバージョンの XClarity Administrator を使用している場合は、v4.0 にアップグレードする前に v3.0 以降にアップグレードする必要があります。

Lenovo XClarity Orchestrator を使用して XClarity Administratorv4.0 以降のインスタンスを管理するには、XClarity Orchestrator v2.0 以降が必要です。XClarity Administrator を v4.0 以降に更新する場合は、XClarity Orchestrator は既に v2.0 以降がインストール済みである必要があります。

このタスクについて

docker-compose.yml ファイルは、のコンテナーのインストール時に設定した以下の環境変数を使用します。これらの環境変数は、新しいコンテナーによっても使用されます。

  • CONTAINER_NAME。各 XClarity Administrator インスタンスに Docker ボリュームを作成するために使用する固有のコンテナー名 (例: CONTAINER_NAME=LXCA-203)。

    XClarity Administrator は、コンテナー名を使用してコンテナーのボリュームを作成します。新しいコンテナーに同じコンテナー名を使用すると、新しい XClarity Administrator インスタンスは同じボリュームを使用するため、元の XClarity Administrator インスタンス (コンテナー) と同じシステム・データや設定にアクセスできます。

    コンテナー名を変更すると、そのコンテナーに新しいボリュームが作成され、新しい XClarity Administrator インスタンスは元の XClarity Administrator インスタンス (コンテナー) と同じシステム・データや設定にはアクセスできなくなります。コンテナーの名前や IP アドレスを変更する必要がある場合は、新しいコンテナーをインストールする前に元の XClarity Administrator インスタンスのシステム・データと設定をバックアップし、そのバックアップを使用して新しいコンテナーにシステム・データと設定を復元します。

  • ADDRESS。コンテナーの静的 IPv4/IPv6 アドレス (例: ADDRESS=192.0.2.0)。

    デバイスの管理後に XClarity Administrator IP アドレスを変更すると、XClarity Administrator でデバイスがオフライン状態になります。IP アドレスを変更する前に、すべてのデバイスを管理対象から除外してください。

  • BACKUP_MOUNTFIRMWARE_MOUNT。(任意) XClarity Administrator のバックアップを保存するために使用するリモート共有やファームウェア更新のリモート・リポジトリーとして使用するリモート共有のパス。このパスは、それぞれ /mnt/backup_share/mnt/fw_share である必要があります。

XClarity Administrator は特権コンテナーとして実行されません

手順

XClarity Administrator コンテナーを更新するには、以下の手順を実行します。

  1. XClarity Administrator コンテナー・イメージを XClarity Administrator ダウンロード Web ページからクライアント・ワークステーションにダウンロードします。Web サイトにログオンし、付与されたアクセス・キーを使用してイメージをダウンロードします。
  2. 次のコマンドを実行して、XClarity Administrator コンテナー・イメージを Docker ホストにインポートします。
    docker load -i lnvgy_sw_lxca_110-3.5.0_anyos_noarch
  3. 元のコンテナーで使用していたのと同じ docker-compose.yml を編集します。ファイルの先頭にある image プロパティを更新して、手順 2 の新しい Docker イメージをポイントします。イメージのタグは、docker tag コマンドを使用して変更できます。

    IPv6 が有効な yml ファイルの例を次に示します。

    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. 次のコマンドを実行して、のコンテナーをシャットダウンします。
    docker-compose -p ${CONTAINER_NAME} down
  5. 次のコマンドを実行して、Docker に新しいイメージをデプロイします。<ENV_FILENAME> は、環境変数ファイルの名前です。
    <span className="ph">COMPOSE_HTTP_TIMEOUT=300</span> docker-compose -p ${CONTAINER_NAME} ––env-file <ENV_FILENAME> up -d