Cisco Crosswork 4.0 から 4.1 へのアップグレードワークフロー
このセクションでは、Cisco Crosswork をリリース 4.0 からリリース 4.1 にアップグレードするための高度なワークフローを示します。このワークフローには、単一のメンテナンスウィンドウ内での Cisco Crosswork クラスタ、Cisco Crosswork Data Gateway、および Crosswork アプリケーションの リリース 4.1 へのアップグレード作業が含まれます。
このアップグレードワークフローの各段階は、順番に実行する必要があります。詳細については、この章の後のセクションで説明します。ポリシーの段階は次のとおりです。
-
Cisco Crosswork 4.1 クラスタのインストール
(注)
クラスタのインストール中に、NSO をバージョン 5.5.2.9 にアップグレードする必要があります。NSO をアップグレードするプロセスについては、このドキュメントでは扱われません。詳細については、Cisco NSO 5.5.2.9 のマニュアルを参照してください。また、Cisco Optimization Engine を単独で使用したり、Cisco Network Controller ソリューションの一部として使用したりする場合は、『Crosswork Network Controller Release Notes』に記載されているとおり、SR-PCE をサポート対象バージョンにアップグレードしてください。
アップグレードの最終的な所要時間は、展開プロファイルのサイズとハードウェアのパフォーマンス特性によって異なることがあります。
警告 |
Cisco Crosswork の 4.0 から 4.1 への移行には、次の制限があります。
|
Crosswork アプリケーションは、マイナーアップデートまたはパッチリリースの場合、Cisco Crosswork UIから個別に更新できます。詳細については、Crosswork アプリケーションの更新(スタンドアロン アクティビティ)を参照してください。
Cisco Crosswork Data Gateway 2.0 VM のシャットダウン
これはアップグレードワークフローの最初の段階です。
(注) |
Crosswork Data Gateway VM がシャットダウンされると、データがデータ送信先に転送されなくなります。アプリケーションプロバイダに問い合わせて、アラームやその他の問題を回避するための操作が必要かどうかを確認します。 |
始める前に
[Data Gateway Management] ページのすべてのタブのスクリーンショットを撮り、Crosswork Data Gateway のリストと、Cisco Crosswork 4.0 UI の [Attached Device Count] を記録します。[Pools] タブで、リストに表示されているプールごとに、プール内のアクティブ、スペア、および未割り当ての VM をメモします。この情報は Cisco Crosswork Data Gateway 3.0 へのアップグレード の際に役立ちます。
手順
ステップ 1 |
すべての VM が正常であり、クラスタ内で実行されていることを確認します。 |
ステップ 2 |
Cisco Crosswork Data Gateway 2.0 VM をシャットダウンします。 |
Cisco Crosswork 4.0 のバックアップ作成とシャットダウン
これはアップグレードワークフローの第 2 段階です。Cisco Crosswork を新しいソフトウェアバージョンにアップグレードする場合は、バックアップの作成が前提条件となります。
(注) |
バックアップは、スケジュールされたアップグレード期間中にのみ作成することを推奨します。バックアップ操作の実行中は、Cisco Crosswork へのアクセスを試みないでください。 |
始める前に
バックアップを作成する場合は、次のガイドラインに従ってください。
-
Cisco Crosswork は、SCP を使用して、システムの設定を外部サーバーにバックアップします。開始する前に、次の設定を行い、SCP サーバーに関する情報を用意しておく必要があります。
-
セキュアな SCP サーバーのホスト名または IP アドレスおよびポート番号。
-
バックアップが保存される SCP サーバーの事前設定されたパス。
-
ディレクトリに対するファイルの読み取りおよび書き込み権限のあるユーザーのログイン情報。
-
SCP サーバーのストレージ要件は若干異なりますが、少なくとも 25 GB のストレージが必要です。
-
-
バックアップファイルを保存する宛先 SCP サーバーが設定されていることを確認します。この設定は 1 回限りのアクティビティです。
-
Cisco Crosswork クラスタと SCP サーバーの両方が同じ IP 環境内に存在する必要があります。たとえば、Cisco Crosswork が IPv6 で通信している場合は、バックアップサーバーも IPv6 で通信している必要があります。
-
現在のバージョンの Cisco Crosswork にインストールした Crosswork アプリケーションのリストを記録しておきます。これらのアプリケーションは、新しいバージョンの Cisco Crosswork に移行した後でなければインストールできません。
-
Cisco Crosswork 4.0 でカスタム MIB パッケージを導入準備した場合は、パッケージのコピーをシステムにダウンロードします。Cisco Crosswork 4.1 への移行が完了したら、パッケージをアップロードする必要があります。詳細については、アップグレード後のチェックリスト を参照してください。
-
サードパーティ製デバイスタイプを含めるように Cisco Crosswork 4.0 を変更した場合は、サードパーティ製デバイスのコンフィギュレーション ファイルをダウンロードし、Cisco Crosswork 4.1 に再適用する必要があります。デバイスのコンフィギュレーション ファイルは、クラスタノード(/mnt/cw_lusterfs/bricks/brick3/sys-oids.yaml)とポッド(/mnt/backup/sys-oids.yaml)にあります。
-
Cisco Crosswork 最適化エンジン に有効にされた機能パック(Local Congestion Mitigation(LCM)、Bandwidth Optimization(BWOpt)、および Bandwidth on Demand(BWoD))がある場合は、先に進む前に無効にする必要があります。また、使用可能な場合は、LCM または BWOpt によって管理されるインターフェイスの現在のリストをエクスポートする必要があります([Traffic Engineering] > [Local Congestion Mitigation] または [Bandwidth Optimization] > [Link Management] > [Export] アイコン)。最新の『Cisco Crosswork Optimization Engine Release Notes』の「Upgrade Crosswork Optimization Engine Feature Packs」に記載されている手順に従います。
手順
ステップ 1 |
すべての VM が正常であり、クラスタ内で実行されていることを確認します。 |
ステップ 2 |
SCP バックアップサーバを設定します。
|
ステップ 3 |
バックアップを作成します。 |
ステップ 4 |
バックアップが正常に完了したら、各ノードをホストする VM の電源をオフにして(ハイブリッド VM から開始)、Cisco Crosswork クラスタをシャットダウンします。
|
ステップ 5 |
アップグレード中に Cisco NSO に対して意図しない更新が実行されないように、Cisco NSO を読み取り専用モードにします。
|
Cisco Crosswork 4.1 クラスタのインストール
これはアップグレードワークフローの第 3 段階です。Cisco Crosswork 4.0 のバックアップが正常に完了した後、Cisco Crosswork 4.1 クラスタのインストールに進みます。
(注) |
Cisco Crosswork 4.0 のノード数以上のノードが Cisco Crosswork 4.1 にインストールされる必要があります。 |
始める前に
-
環境が Cisco Crosswork インフラストラクチャの要件 で指定されているすべての要件を満たしていることを確認します。
手順
ステップ 1 |
Crosswork クラスタのインストール に記載されているいずれかのインストール方法を使用して、Cisco Crosswork 4.1 クラスタをインストールします。
|
||
ステップ 2 |
インストールが完了したら、Cisco Crosswork UI にログインし、クラスタ内のすべてのノードが稼働しているかどうかを確認します。
|
Cisco Crosswork 4.1 アプリケーションのインストール
これはアップグレードワークフローの第 4 段階です。Cisco Crosswork 4.1 クラスタのインストールが正常に完了した後、Cisco Crosswork 4.1 アプリケーションのインストールに進みます。
(注) |
インストールできるのは、Cisco Crosswork 4.0 のバックアップ作成とシャットダウン でバックアップされた Cisco Crosswork アプリケーションのバージョン 4.1 のみです。 |
手順
ステップ 1 |
Crosswork アプリケーションのインストール の手順に従って Cisco Crosswork 4.1 アプリケーションをインストールします。 |
ステップ 2 |
アプリケーションが正常にインストールされたら、Cisco Crosswork 4.1 クラスタの正常性を確認します。
|
Cisco Crosswork 4.0 バックアップの Cisco Crosswork 4.1 への移行
これはアップグレードワークフローの第 5 段階です。Cisco Crosswork 4.1 アプリケーションが正常にインストールされたら、Cisco Crosswork 4.1 クラスタに Cisco Crosswork 4.0 のバックアップを移行します。
始める前に
作業を開始する前に、次を確認してください。
-
セキュアな SCP サーバーのホスト名または IP アドレスおよびポート番号。
-
Cisco Crosswork 4.0 のバックアップ作成とシャットダウン で作成したバックアップファイルの名前とパス。
-
ディレクトリに対するファイルの読み取りおよび書き込み権限のあるユーザーのログイン情報。
手順
ステップ 1 |
SCP バックアップサーバーを設定します。 |
ステップ 2 |
Cisco Crosswork 4.1 クラスタに Cisco Crosswork 4.0 バックアップを移行します。 |
ステップ 3 |
データの移行が正常に完了したら、Cisco Crosswork 4.1 クラスタの正常性を確認します。
|
Cisco Crosswork Data Gateway 3.0 へのアップグレード
これは Crosswork 4.0 から Crosswork 4.1 へのアップグレードワークフローの最終段階です。この段階に進む前に、アップグレードワークフローの前述した段階の手順がすべて完了していることを確認します。
(注) |
これは Cisco Crosswork Data Gateway Base VM のアップグレードのみに必要な手順です。コレクタなど、他のコンポーネントのアップグレードは、Cisco Crosswork によって実行されます。 |
Cisco Crosswork Data Gateway は、ネットワーク内のパッシブデバイスとして機能します。Crosswork Data Gateway のアップグレードプロセスは、Crosswork Data Gateway 2.0 VM のシャットダウンと Crosswork Data Gateway 3.0 VM との置き換えによって構成されます。
プールとデバイスマッピング情報は、移行ユーティリティ API の実行により 3.0 VM に移行されます。
https://<VIP>:30603/crosswork/inventory/v1/dg/vdg/migrate
DLM の移行ユーティリティ API は累積的な API です。複数回安全に実行できます。
手順
ステップ 1 |
新しい Cisco Crosswork Data Gateway 3.0 VM を、Crosswork Data Gateway 2.0 VM と同じ数、同じ情報(管理インターフェイスが重要)を使用してインストールします。Cisco Crosswork Data Gateway のインストールワークフローの手順を実行します。 |
||
ステップ 2 |
新しい Cisco Crosswork Data Gateway VM が Cisco Crosswork に登録されており、管理状態が [Up] で、動作状態が [Not Ready] になっていることを確認します。「Cisco Crosswork Data Gateway の認証と登録」を参照してください。 |
||
ステップ 3 |
Cisco NSO のメンテナンスモードまたは読み取り専用モードを終了します。詳細については、5.5.2.9 の関連資料を参照してください。
|
||
ステップ 4 |
(任意)Cisco Crosswork 4.0 でカスタム MIB パッケージを導入準備した場合は、ダウンロードしたカスタム MIB パッケージをアップロードします(Cisco Crosswork 4.0 のバックアップ作成とシャットダウン の説明を参照)。この操作を実行する方法については、『Cisco Crosswork Infrastructure 4.1 Applications and Administration Guide』の「Add a Custom Software Package」のセクションを参照してください。カスタム MIB パッケージをアップロードした後、次のチェックを実行します。
|
||
ステップ 5 |
JWT トークンを取得して、移行ユーティリティ API を実行します。
|
||
ステップ 6 |
移行ユーティリティ API を実行して、Crosswork Data Gateway プールを作成します。 https://<VIP>:30603/crosswork/inventory/v1/dg/vdg/migrate
|
||
ステップ 7 |
すべての Crosswork Data Gateway プールが作成されていることを確認します。 |
||
ステップ 8 |
移行ユーティリティ API を使用したデバイスの Crosswork Data Gateways 3.0 への接続 移行ユーティリティ API を実行して、Crosswork Data Gateways 2.0 から、Cisco Crosswork 4.1 で新しく作成した Crosswork Data Gateways 3.0 にデバイスをマッピングします(ステップ 5 の説明を参照)。 ここで移行ユーティリティ API を実行すると、Crosswork Data Gateway が検証され、Cisco Crosswork 4.0 から対応する Crosswork Data Gateway にすべてのデバイスが接続されます。 |
||
ステップ 9 |
Cisco Crosswork 4.1 UI で、デバイスが Crosswork Data Gateways 3.0 に接続されていることを確認します。 |
Crosswork Data Gateway アップグレードに関連した問題のトラブルシューティング
次の表に、Crosswork Data Gateway のアップグレード時に発生する可能性のある一般的な問題を列挙し、問題の原因を特定して解決するためのアプローチを示します。
問題 | 症状 | 推奨処置 |
---|---|---|
1. 1 つ以上の Crosswork Data Gateway 3.0 VM がまだ登録されていません。 |
いずれかの Crosswork Data Gateway プールが作成されていません。 |
欠落している Crosswork Data Gateway を登録し、Cisco Crosswork Data Gateway 3.0 へのアップグレード セクションのステップ 5 以降のデータ移行手順を繰り返します。 |
2 移行手順の実行時に、一部の Crosswork Data Gateway VM が [Error] または [Degraded] 状態になりました。 |
いずれかの Crosswork Data Gateway プールが作成されていません。 |
Crosswork Data Gateway VM の状態が [Up] または [Not Ready] になるまで待ちます。必要に応じて、VM の状態を [Not Ready] にするためのアクションを実行します。Cisco Crosswork Data Gateway 3.0 へのアップグレード セクション(ステップ 5 以降)の説明に従って、Crosswork Data Gateway のデータ移行手順を繰り返します。 |
3. Crosswork Data Gateway プールが正しい VM を使用して作成されていますが、Cisco Crosswork 4.0 環境でアクティブだったものとは異なる VM がアクティブな VM として選択されています。 |
異なる VM が Crosswork Data Gateway プールでアクティブな VM として選択されています。 |
|
4. VDG 移行ユーティリティを複数回実行した後も、Crosswork Data Gateway に接続されているデバイスがありません。 |
Crosswork Data Gateway に接続されているデバイスがありません。 |
|
アップグレード後のチェックリスト
Cisco Crosswork 4.1 へのアップグレードが完了したら、新しいクラスタの正常性を確認します。クラスタが正常であれば、次のアクティビティを実行します。
-
Cisco Crosswork 4.1 UI の [Administration] > [Collection Jobs] に移動し、重複するシステムジョブを削除します。
-
[Administration] > [Collection Jobs] ページで、Crosswork Data Gateway 3.0 VM で収集ジョブが実行されていることを確認します。この時点で、2.0 VM を削除できます。
-
デフォルトのログイン情報を使用してログインして、復元した AAA データを確認し、Cisco Crosswork 4.1 でのカスタムユーザーロール(読み取り/書き込み、または読み取り)を設定します。
-
(任意)ネットワーク要件に基づいて、関連するマップファイルを cisco.com からダウンロードし、Cisco Crosswork 4.1 に再アップロードします。
-
(任意)Cisco Crosswork 4.0 で NSO デバイス導入準備ポリシーが設定されている場合は、NSO で新しいネットワーク要素ドライバ(NED)を使用してポリシーを更新する必要があります。
-
(任意)(Cisco Crosswork 4.0 で使用されていた)サードパーティ製デバイスの設定を Cisco Crosswork 4.1 に再適用します。
-
Crosswork 最適化エンジン を使用している場合は、次のアクションを実行します。
-
『Cisco Crosswork Optimization Engine Release Notes』に記載されているサポート対象 Cisco IOS XE/XR バージョンに従って、デバイスのソフトウェアバージョンをアップグレードします。
-
最新の『Cisco Crosswork Optimization Engine Release Notes』の「Upgrade Crosswork Optimization Engine Feature Packs」の手順に従って、機能パック(ローカル輻輳緩和(LCM)、帯域幅最適化(BWOpt)、オンデマンド帯域幅(BWoD))を確認します。
-
上記のアクティビティのいずれかでエラーが発生した場合は、シスコ カスタマー エクスペリエンス チームにお問い合わせください。