はじめに

このドキュメントでは、Evolved Programmable Network Manager(EPNM)がデバイスのバックアップコンフィギュレーションファイルを中央から管理する方法について説明します。

背景説明

• このドキュメントは、EPNMバージョン6.1.1に基づいて作成されています
• バージョン5.1.xを実行しているシステムでは、Cisco Bug ID CSCvz12497が適用され、ジョブダッシュボードからのデバイス設定バックアップ外部ジョブの編集が防止されます

設定バックアップファイルの取得

デバイスからのバックアップをEPNMデータベースに保存するプロセスは「構成アーカイブ」と呼ばれ、定期的に実行するように調整できます。

次のブロック図は、ネットワークデバイスからバックアップファイルを取得するようにEPNMを設定する手順と、これらのファイルをEPNMから取得する3つのオプションを示しています。

ステップ1では、EPNMによるコンフィギュレーションファイルの収集の処理方法に関する全体的なプリファレンスを定義します。たとえば、デバイスごとに保持するコンフィギュレーションファイルの数や、設定の変更時にバックアップをトリガーするかどうかを選択できます。

その後、ステップ2で、設定ファイルを取得するためにEPNMがネットワークデバイスをポーリングする頻度を設定します。

ファイルがEPNMデータベースに保存されると、次の3つのオプションを使用して取得できます。

1. EPNMからコンフィギュレーションファイルを直接ダウンロードします(ブロック図のステップ3)。
2. コンフィギュレーションファイルを外部サーバにエクスポートします。この場合は、外部サーバを設定して、EPNMでリポジトリとして設定する必要があります(ステップ4、5、6、および7)
3. REST APIを使用してコンフィギュレーションファイルを取得します(ステップ8)。この方式は、データベース形式のコンフィギュレーションファイルを使用するNCS2000デバイスでは機能しません

1. デバイスバックアップの設定

これにより、アーカイブがトリガーされたタイミング、デバイスごとに保持されるファイルの数、デバイスがネットワークに追加された直後にバックアップコンフィギュレーションファイルを自動的に作成するかどうかなど、アーカイブ収集のデフォルト動作が定義されます。

手順

2. デバイス構成ファイルの取得頻度を構成する

このステップでは、EPNMがネットワーク内のデバイスからコンフィギュレーションファイルを取得する頻度を定義します。データベースに保持されるファイルの数は、「項目1:デバイスバックアップの設定」で定義した内容によって異なります。

手順

3. EPNMからのコンフィギュレーションファイルのダウンロード

手順

4. 外部サーバのセットアップ

サポートされるリポジトリは、FTP、SSH FTP(SFTP)、およびネットワークファイルシステム(NFS)です。この例では、SFTPサーバがCentOS Linuxリリース8サーバで構築されていると仮定しています。サーバを作成する手順については、この記事では説明しません。

5. EPNMでの宛先リポジトリの設定(Cisco IOS)

このステップでは、外部サーバのパラメータがEPNMの「cars」シェルで定義されます。

手順

epnm/admin# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
epnm/admin(config)#

epnm6/admin# conf t
Enter configuration commands, one per line.  End with CNTL/Z.
epnm6/admin(config)# repository external_config_backup
epnm6/admin(config-Repository-external_config_backup)# url sftp:// 
         
           //home/sftpuser 
         
epnm6/admin(config-Repository-external_config_backup)# user sftpuser password plain xxxx
epnm6/admin(config-Repository-external_config_backup)# end
epnm6/admin# write memory 
Generating configuration...
epnm6/admin#

epnm/admin# show repository external_config_backup
% Repository is empty

6. EPNM(GUI)での宛先リポジトリの設定

この手順では、外部サーバのパラメータはEPNM GUIで定義されます。

手順

7. EPNM GUIでのエクスポートジョブのスケジュール

この手順では、コンフィギュレーションファイルを外部サーバにエクスポートするジョブがEPNM GUIで定義されます。

手順

8. REST APIを使用してコンフィギュレーションファイルを取得する

コンフィギュレーションファイル用のサービスには、複数のオプション（差分、一括エクスポート、バージョン管理など）があります。このセクションでは、ipアドレスx.x.x.xのデバイスに基づいてバックアップファイルを取得する方法の基本的な例を示します

最初に、デバイスに照会して、目的のコンフィギュレーションファイルのフィールドを取得する必要があります。これは、GET Configuration Versionsエンドポイント[2]を使用して実行できます。

GET https://
    
    
      /webacs/api/v4/data/ConfigVersions?.full=true&deviceIpAddress=x.x.x.x 
    

JSON応答から、このデバイスのスタートアップコンフィギュレーションと実行コンフィギュレーションの両方が使用可能であることがわかります。また、この場合のdiff TypeはOUT_OF_SYNCです。これは、コンフィギュレーションファイルの以前のバージョンと比べると、このバージョンが異なることを意味します。

{
    "queryResponse": {
        "@last": 0,
        "@first": 0,
        "@count": 1,
        "@type": "ConfigVersions",
        "@domain": "ROOT-DOMAIN",
        "@requestUrl": "https://
    
    
      /webacs/api/v4/data/ConfigVersions?.full=true&deviceIpAddress=x.x.x.x", "@responseType": "listEntityInstances", "@rootUrl": "https:// 
     
       /webacs/api/v4/data", "entity": [ { "@dtoType": "configVersionsDTO", "@type": "ConfigVersions", "@url": "https:// 
      
        /webacs/api/v4/data/ConfigVersions/5029722742", "configVersionsDTO": { "@displayName": "5029722742", "@id": 5029722742, "comments": "Archived By Job Name: Job_Configuration_Archive_Collection_10_10_00_021_AM_8_28_2024, Run Id: 6333919609", "createdAt": "2024-08-28T13:10:07.112Z", "createdBy": "root", "deviceIpAddress": "x.x.x.x", "deviceName": "CBR8", "diffType": "OUT_OF_SYNC", "fileInfos": { "fileInfo": [ { "fileId": 5029723744, "fileState": "STARTUPCONFIG", "fileType": "TEXT" }, { "fileId": 5029723743, "fileState": "RUNNINGCONFIG", "fileType": "TEXT" } ] }, "isFirst": true, "isLast": true, "outOfBand": true } } ] } } 
       
      
    

次に、前の手順で取得したファイルIDを使用してコンフィギュレーションファイルをダウンロードします。実行コンフィギュレーションをダウンロードする場合は、次のエンドポイントを使用できます。

GET https://
    
    
      /webacs/api/v4/op/configArchiveService/extractUnsanitizedFile?fileId=5029723743 
    

応答には、実行コンフィギュレーションがテキスト形式で含まれています。

{
    "mgmtResponse": {
        "@domain": "ROOT-DOMAIN",
        "@requestUrl": "https://
    
    
      /webacs/api/v4/op/configArchiveService/extractUnsanitizedFile?fileId=5029723743", "@responseType": "operation", "@rootUrl": "https:// 
     
       /webacs/api/v4/op", "extractFileResult": [ { "fileData":"!\n! Last configuration change at 18:12:00 EDT Sun Aug 25 2024 by rtp1\n!\nno issu config-sync policy bulk prc\nversion 16.12\nservice timestamps debug datetime msec\nservice timestamps log datetime localtime show-timezone\nservice password-encryption\nservice internal\nservice udp-small-servers\nservice sequence- 
      
        tcp\nnetconf-yang\nnetconf-yang cisco-ia snmp-community-string testing-mib-yang\nnetconf-yang ssh port 57000\nrestconf\nend" } ] } } 
       
      
    

NCS2000の設定ファイルは、形式(DATABASE)が異なるため、この方式では取得できないことに注意してください。

設定アーカイブ収集のトラブルシューティング

[タイムアウト（Timeout）]

関連エラーメッセージ：Backup Database from device using https failed.HTTP要求の実行中にソケットがタイムアウトしました：読み取りがタイムアウトしました

根本原因：タイムアウトは、EPNMがデバイスからデータベースを取得する前に発生します。

構成アーカイブ・タスクでは、各フェッチ・アクティビティに対してデバイスCLIタイムアウト値が使用されます。1つの構成アーカイブ作業には、1 ～ 5個のファイルが必要です。その結果、全体的なジョブタイムアウト値は、全体的なジョブタイムアウト =ファイル数*デバイスのCLIタイムアウトというロジックを使用して決定されます。 CLIのタイムアウト値を設定するには、Inventory > Device Management > Network Devicesの順に選択し、デバイスの編集アイコンをクリックし、Telnet/SSHオプションを選択して、Timeoutフィールドに値を入力します。

NCS2000でEMSが「セキュア」として有効化されていない

関連エラーメッセージ：「Backup Database from device using https failed.Failed to establish telnet connection to device- Cause : Connection refused or timed-out.」というエラーメッセージが表示されます。

根本原因：NCS2000のEMSアクセスパラメータ（CTCツールを介してアクセスが実行される）が非セキュアに設定されています。 セキュアとして設定する必要があります。 

これを修正するには、CTCツールを使用してNCS2000にアクセスし、Node view、Provisioningタブ、Security、Accessタブの順に移動し、EMS Accessの下のAccess StateをSecureに変更します。

デバイスIDがありません

関連エラーメッセージ：「Device archive(s) could not be found.デバイスのIDが無効であるか、システムから削除されている可能性があります。

根本原因：NCS2000デバイスがEPNMで削除されている場合、EPNMデータベース内のそのデバイスIDが変更されます。ただし、設定アーカイブ収集ジョブは引き続き古いIDを参照しているため、失敗します。回避策は、関連デバイスの設定アーカイブ収集ジョブを削除し、再作成することです。

結論

このドキュメントでは、EPNMデータベースに保存されているネットワークデバイスからコンフィギュレーションファイルにアクセスする方法について詳しく説明しました。

ファイルへのアクセスには、EPNMを介した直接アクセス、外部サーバへのエクスポート、およびREST APIを介したエクスポートの3つのオプションが与えられました。これらの方法を使用して、EPNMのノースバウンドインターフェイスに接続されたシステムで実行できるタスクを自動化できます。デバイスからコンフィギュレーションファイルを取得するためのトラブルシューティングのヒントも提供されています。

参考資料

[1] EPNM構成ガイド

https://www.cisco.com/c/en/us/td/docs/net_mgmt/epn_manager/5_1_3/user/guide/bk-cisco-evolved-programmable-network-manager-5-1-3-user-and-administrator-guide1/bk_CiscoEPNManager_4_0_UserAndAdministratorGuide_chapter_011.html#task_1237296

[2] EPNM REST APIオンラインリファレンス
https://<EPNM IPアドレス>/webacs/api/v1/index?_docs