購入する または契約更新する
購入する または契約更新する
キャンセル
提案をオンにする
自動提案では、入力時に可能な一致が提案されるので検索結果を素早く絞り込むことができます。
次の結果を表示 
次の代わりに検索 
もしかして: 
cancel
新しい記事を作成する
122
閲覧回数
0
いいね！
0
コメント

[HA CVIM-MON] HA CVIM MON の 4.2.x から 4.4.x へのアップグレード方法

shanazon
Cisco Employee
Cisco Employee

‎2024-04-25 02:38 PM

はじめに

本ドキュメントでは、HA CVIM MON のバージョンを4.2.2, 4.2.3, 4.2.4 から 4.4.3, 4.4.4 へアップグレードする場合の手順をご紹介します。なお、アップグレードに関するさまざま情報はアップグレード先のバージョンの Cisco Virtualized Infrastructure Manager Documentation に記載されていますのでこちらをご参照ください。ドキュメントは下記URLからダウンロードすることができます。

https://www.cisco.com/c/en/us/support/cloud-systems-management/virtualized-infrastructure-manager/series.html

 

 

注意事項

アップグレードを実行後、以前の4.2.xのバージョンにロールバックすることはできません。またアップグレードを行う際には必ずメンテナンスウィンドウを設けて実施してください。

 

 

手順

  1. 事前準備
  2. 現在稼働中のHA CVIM MON mgmtノードの最新のバックアップを取得
  3. 取得したバックアップをHA CVIM MON mgmtノードとは別のサイトに保存
  4. 4.4.x の HA CVIM MON mgmtノードを構築
  5. 4.2.x のバックアップを 4.4.x のHA CVIM MON mgmtノードにコピー
  6. /etc/hosts に minio のエントリを追加
  7. prepare_cvimmon_upgrade コマンドを実行
  8. k8s_runner --install でKuberentesクラスタを4.4.xにアップグレード
  9. HA CVIM MONクラスタの正常性を確認
  10. commit_cvimmon_upgrade コマンドで snapshot データをレストア
  11. k8s_run --get-endpointで Grafana のエンドポイントを取得

 

事前準備

アップグレードを開始する前に、HA CVIM MONおよび稼働中のハードウェアに異常がないことを確認してください。HA CVIM MONの正常性確認には下記のアーティクルをご参照ください。

[HA CVIM-MON] HA CVIMMON の正常性の確認方法
https://community.cisco.com/t5/-/-/ta-p/4762531

またOSのログやdmesgの参照、CIMC経由でのステータス確認などを行い、稼働中のシステムに異常がないことを確認します。確認方法が不明な場合にはサポートへお問い合わせください。

アップグレード処理の中で現在のネットワークの情報が求められますので、HA CVIM MON mgmtノードの以下の情報をあらかじめ収集しておくことをおすすめします。

  • cat /etc/hosts
  • cat /etc/resolv.conf
  • ip a
  • ip route

最後にターゲットである 4.4.x のISOイメージをあらかじめダウンロードしておきます。

 

現在稼働中のHA CVIM MON mgmtノードの最新のバックアップを取得

アップグレード作業は、HA CVIM MONのManagementノードにrootアカウントでログインして作業を行います。最初に最新のバックアップデータを取得します。バックアップデータの取得方法は以下のアーティクルをご参照ください。

https://community.cisco.com/t5/-/-/ta-p/4945869
[HA CVIM-MON] HA CVIM-MON Managementノードのバックアップ方法

 

取得したバックアップをHA CVIM MON mgmtノードとは別のサイトに保存

rsyncコマンドでHA CVIM MON以外のノードにコピーします。

# rsync -e ssh -go -rtypX --numeric-ids /var/cisco/cvimmonha_autobackup/cvimmonha_autobackup_4.2.1_20240125_165130.tgz 10.70.72.130:/root/hacvimmon_bk

 

4.4.x の HA CVIM MON mgmtノードを構築

稼働中の 4.2.x の HA CVIM MON mgmtノードを停止して、バージョン4.4.xのISOイメージを使って起動してノードを新たに構築します。バージョン4.4.xのISOイメージを起動デバイスとして設定してノードを起動し、起動時のメニューの中から"4) HA CVIM-MON cluster management node"を選択して、HA CVIM MON mgmtのインストールを開始します。

インストール中に HA CVIM MON mgmtノードのネットワーク情報の入力を求められますので、事前に取得していた情報を元に設定します。インストール完了後、ノードは再起動します。再起動後にログインプロンプトが表示されるので、root でログインします。

 

4.2.x のバックアップを 4.4.x のHA CVIM MON mgmtノードにコピー

別のホストにコピーしておいて 4.2.x のバックアップデータを、構築したHA CVIM MON mgmtノードにコピーします。

# rsync -e ssh -go -rtypX --numeric-ids root@10.70.72.130:/root/hacvimmon_bk/cvimmonha_autobackup_4.2.1_20240125_165130.tgz /root/

 

/etc/hosts に minio のエントリを追加

事前準備で取得した/etc/hostsのホスト情報から minioの情報をHA CVIM MON mgmtノードに追記します。

# echo "10.70.72.146 jcvim-cmon-minio.cisco.com" >> /etc/hosts
# cat /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
10.70.72.147 jcvim-hamon-mgmt jcvim-hamon-mgmt
10.70.72.146 jcvim-cmon-minio.cisco.com
#

 

 

prepare_cvimmon_upgrade コマンドを実行

prepare_cvimmon_upgradeコマンドでアップグレードの前処理を行います。

# prepare_cvimmon_upgrade --storage_location /root/Databackup1 --backup_location /root/cvimmonha_autobackup_4.2.1_20240125_165130.tgz -st 4.2.1 -n 4.4.3 -d

 

prepare_cvimmon_upgradeコマンドの実行ではいくつかのオプションを指定する必要があります。各オプションの詳細は以下の通りです。

# prepare_cvimmon_upgrade --help
==================================================================
                CVIMMON PREPARE UPGRADE TOOL
==================================================================

usage: prepare_cvimmon_upgrade [-h] --storage_location STORAGE_LOCATION
                               --backup_location BACKUP_LOCATION
                               --startimagetag STARTIMAGETAG --endimagetag
                               ENDIMAGETAG [--download_data]

optional arguments:
  -h, --help            show this help message and exit
  --storage_location STORAGE_LOCATION, -s STORAGE_LOCATION
                        Storage location to store the snapshot data
  --backup_location BACKUP_LOCATION, -b BACKUP_LOCATION
                        Location of 3.4.x backup
  --startimagetag STARTIMAGETAG, -st STARTIMAGETAG
                        Choose the starting Image tag;
  --endimagetag ENDIMAGETAG, -n ENDIMAGETAG
                        Choose the end image tag
  --download_data, -d   minio backup data restore
#

 prepare_cvimmon_upgradeコマンドは実行内容をコンソール上に表示します。コマンド終了後、いずれの処理も正常に完了したことを確認してください。コンソール上にエラーが表示された場合は、エラー内容と、/var/log/cvimmonha に作成されるコマンドの実行ログを添えてサポートにお問い合わせください。

 

prepare_cvimmon_upgradeコマンドの完了後は念の為/var/ciscoにminioのバックアップデータがあることを確認します。

# ls -l /var/cisco/minio_data_20240228_113152/
total 0
drwxr-xr-x. 3 root root 50 Feb 28 11:31 01HMXGDNKY5TD57Q9MC14W4V96
drwxr-xr-x. 3 root root 50 Feb 28 11:31 01HMXGDQ44TC0S2GFP1V4ANFG9
drwxr-xr-x. 3 root root 50 Feb 28 11:31 01HMXGQPJG7895J3M9HF4BAKCR
drwxr-xr-x. 3 root root 50 Feb 28 11:31 01HMXGR95MBEMPWFTVHTENSKFP

 

k8s_runner --install でKuberentesクラスタを4.4.xにアップグレード

k8s_runner --install コマンドで HA CVIM MON のKuberentesクラスタを4.4.xにアップグレードします。--setupfile で setup_data.yaml ファイルを指定します。

# k8s_runner --install --setupfile /root/cvimmonha_autobackup_4.2.1_20240125_165130/root/openstack-configs/setup_data.yaml

 

アップグレード処理は、VALIDATION/BOOTSTRAP_INFRA/SETUP_ARGUS/COMMON_CVIM_MON_INFRA/KUBERNETES_PROVISIONER/HELM_INFRA の7つのSTEPが処理されます。

# k8s_runner --install --setupfile /root/cvimmonha_autobackup_4.2.1_20240125_165130/root/openstack-configs/setup_data.yaml
 
WARNING: Failed to read /root/openstack-configs/defaults.yaml
 
 
2024-02-09 13:15:20,251 INFO Runner - Executing: INSTALL (args: --install --setupfile /root/cvimmonha_autobackup_4.2.1_20240125_165130/root/openstack-configs/setup_data.yaml)
 
                        ############################
                         CVIM MON HA ORCHESTRATOR
                        ############################
 
[1/7][VALIDATION: INIT]                                                       [   |   ]    0min 3secs
 
  Management Node Validations!
+--------------------------------------+--------+-------+
| Rule                                 | Status | Error |
+--------------------------------------+--------+-------+
| Check Kernel Version                 |  PASS  | None  |
| Check Ansible Version                |  PASS  | None  |
| Check Docker Version                 |  PASS  | None  |
| Check Management Node Tag            |  PASS  | None  |
| Check Bond Intf. Settings            |  PASS  | None  |
| Root Password Check                  |  PASS  | None  |
| Check Boot Partition Settings        |  PASS  | None  |
| Check LV Swap Settings               |  PASS  | None  |
| Check Home Dir Partition             |  PASS  | None  |
| Check Root Dir Partition             |  PASS  | None  |
| Check /var Partition                 |  PASS  | None  |
| Check LVM partition                  |  PASS  | None  |
| Check if /mnt dir is already mounted |  PASS  | None  |
| Check Available Disk Space           |  PASS  | None  |
| Check RHEL Pkgs Install State        |  PASS  | None  |
+--------------------------------------+--------+-------+
[1/7][VALIDATION: INIT]                                                       [   -   ]    0min 16secs

 

 

HA CVIM MONクラスタの正常性を確認

k8s_runner --install コマンドが終了した後、HA CVIMMON の node と pod の状態を確認します。

# kubectl get nodes
# kubectl get pods -A -o wide

HA CVIM MONの正常性確認には下記のアーティクルをご参照ください。

[HA CVIM-MON] HA CVIMMON の正常性の確認方法
https://community.cisco.com/t5/-/-/ta-p/4762531

 

commit_cvimmon_upgrade コマンドで snapshot データをレストア

commit_cvimmon_upgrade コマンドで、prepare_cvimmon_upgradeコマンドで取得した snapshot データをコミットさせます。

# commit_cvimmon_upgrade --snapshot_location /root/Databackup1/snapshot_20240125_165130/ --restore_data /var/cisco/minio_data_20240125_165130/

 

commit_cvimmon_upgrade コマンドではいくつかのオプションを指定する必要があります。各オプションの詳細は以下の通りです。 

# commit_cvimmon_upgrade --help
==================================================================
                CVIMMON COMMIT UPGRADE TOOL
==================================================================

usage: commit_cvimmon_upgrade [-h] [--snapshot_location SNAPSHOT_LOCATION]
                              [--restore_data RESTORE_DATA]

optional arguments:
  -h, --help            show this help message and exit
  --snapshot_location SNAPSHOT_LOCATION, -s SNAPSHOT_LOCATION
                        Storage location of the sanpshot prepared by prepare
                        Tool
  --restore_data RESTORE_DATA, -r RESTORE_DATA
                        minio backup data restore path
#

 

k8s_run --get-endpointでエンドポイントを確認

最後に、k8s_run --get-endpointを実行してUIにアクセスするためのエンドポイントを確認します。ログイン情報は、/root/openstack-configs/secrets.yamlを参照してください。

# k8s_run --get-endpoint

2024-04-24 20:46:43,314 INFO Runner - Executing: GET_ENDPOINT (args: --get-endpoint)

+-----------------------------------+--------------------------------------------------+--------------+
| Endpoint                          | Endpoint FQDN                                    |     VIP      |
+-----------------------------------+--------------------------------------------------+--------------+
| prometheus-cvimmon-monitor-server | https://jcvim-cmon-cvimmon-prometheus.cisco.com  | 10.70.72.146 |
| grafana                           | https://jcvim-cmon-cvimmon-grafana.cisco.com     | 10.70.72.146 |
| prometheus-thanos-querier-ingress | https://jcvim-cmon-thanos.cisco.com              | 10.70.72.146 |
| prometheus-thanos-ruler-ingress   | https://jcvim-cmon-thanos-ruler.cisco.com        | 10.70.72.146 |
| thanos-alertmanager               | https://jcvim-cmon-thanos-alertmanager.cisco.com | 10.70.72.146 |
| prometheus-stack-1-server         | https://cvimmon-prometheus-stack-1.cisco.com     | 10.70.72.146 |
| minio                             | https://jcvim-cmon-minio.cisco.com               | 10.70.72.146 |
+-----------------------------------+--------------------------------------------------+--------------+
2024-04-24 20:46:43,468 INFO Runner - Operation GET_ENDPOINT completed successfully
#

 

以上で作業は終了です。

 

 

ラベル：
0 いいね！
Getting Started

検索バーにキーワード、フレーズ、または質問を入力し、お探しのものを見つけましょう

シスコ コミュニティをいち早く使いこなしていただけるよう役立つリンクをまとめました。みなさんのジャーニーがより良いものとなるようお手伝いします

Customers Also Viewed These Support Documents