簡介

本文檔介紹演化的可程式設計網路管理器(EPNM)如何從其中心位置管理裝置的備份配置檔案。

背景資訊

• 本檔案是根據EPNM 6.1.1版撰寫的
• 對於運行版本5.1.x的系統，將應用思科漏洞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 shell中進行定義。

程式

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配置版本端點[2]完成：

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

請注意，從JSON響應中，此裝置既可以使用啟動配置，也可以使用運行配置。在此案例中，「差異型別」也是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" } ] } } 
       
      
    

請記住，由於格式不同(DATABASE)，此方法無法檢索NCS2000配置檔案。

配置存檔收集故障排除

逾時

相關錯誤訊息：使用https從裝置備份資料庫失敗。執行HTTP要求期間的通訊端逾時：讀取逾時

根本原因：在EPNM能夠從裝置獲取資料庫之前發生超時。

Configuration Archive（配置存檔）任務使用每個提取活動的Device CLI Timeout值。單一「組態查扣」工作需要1到5個檔案。因此，總體作業超時值是使用邏輯確定的：總體作業超時 = 檔案數*裝置CLI超時。 要配置CLI超時值，請選擇資產 > 裝置管理 > 網路裝置，點選編輯裝置圖示，選擇Telnet/SSH選項，然後在超時欄位中輸入值。

EMS在NCS2000中未啟用為「安全」

相關錯誤消息：「使用https從裝置備份資料庫失敗。無法建立到裝置的telnet連線-原因：連線被拒絕或超時。

根本原因：NCS2000中的EMS訪問引數（透過CTC工具進行訪問）設定為非安全。 需要將其設定為Secure。 

要解決此問題，請使用CTC工具訪問NCS2000，轉至Node view， Provisioning tab， Security，然後Access頁籤，並將EMS Access下的Access State更改為Secure。

找不到裝置ID

相關錯誤消息：「Device archive(s) was not be found.裝置的ID可能無效，或者可能已從系統中刪除。」

根本原因：如果NCS2000裝置已在EPNM中刪除，則其在EPNM資料庫中的裝置ID將更改。但是，Configuration Archive Collection作業仍引用舊ID，因此失敗。解決方法是刪除並重新建立相關裝置的配置存檔收集作業。

結論

本文檔詳細介紹了如何從儲存在EPNM資料庫中的網路裝置訪問配置檔案。

提供三個選項來存取檔案：直接透過EPNM、匯出至外部伺服器及透過REST API。這些方法可用於自動執行可由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