المقدمة

يوضح هذا المستند الكيفية التي يمكن بها لإدارة الشبكة المتطورة القابلة للبرمجة (EPNM) إدارة ملفات تكوين النسخ الاحتياطي للأجهزة من موقعها المركزي.

معلومات أساسية

• تمت كتابة هذا المستند استنادا إلى الإصدار 6.1.1 من EPNM
• بالنسبة للأنظمة التي تشغل الإصدار 5.1.x، يطبق معرف تصحيح الأخطاء من Cisco CSCvz12497 ويمنع تحرير مهمة النسخ الاحتياطي-الخارجي لتكوين الجهاز من لوحة معلومات المهمة

الحصول على ملفات النسخ الاحتياطي للتكوين

تسمى عملية تخزين النسخ الاحتياطية من الأجهزة الموجودة في قاعدة بيانات EPNM "أرشيف التكوين" ويمكن تعديلها لتشغيلها بشكل دوري.

يوضح الرسم التخطيطي للكتلة خطوات تكوين EPNM للحصول على ملفات النسخ الاحتياطي من أجهزة الشبكة والخيارات الثلاثة لاسترداد هذه الملفات من EPNM.

في الخطوة 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.

الإجراء

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)

في هذه الخطوة، يتم تحديد معلمات الخادم الخارجي في واجهة المستخدم الرسومية (GUI) ل EPNM.

الإجراء

7 - جدولة مهمة التصدير في واجهة المستخدم الرسومية (GUI) الخاصة بشركة EPNM

في هذه الخطوة، يتم تحديد مهمة تصدير ملفات التكوين إلى الخادم الخارجي في واجهة المستخدم الرسومية (GUI) ل EPNM.

الإجراء

8. أستخدم REST API للحصول على ملفات التكوين

تتوفر العديد من خيارات الخدمات لملفات التكوين (على سبيل المثال، عمليات التصميم والتصدير المجمع وعمليات الإصدار). في هذا القسم، يتم عرض مثال أساسي على كيفية إسترداد ملفات النسخ الاحتياطي استنادا إلى الجهاز المزود بعنوان IP x.x.x.x

أولا، يلزمك الاستعلام عن الجهاز للحصول على الحقل الخاص بملف التكوين المطلوب. ويمكن القيام بذلك باستخدام نقطة نهاية الحصول على إصدارات التكوين [2]:

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

لاحظ من إستجابة JSON أن كلا من startup-configuration و running-configuration متاحان لهذا الجهاز. كذلك يكون نوع الاختلاف في هذه الحالة 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 } } ] } } 
       
      
    

ثم يمكنك تنزيل ملف التكوين باستخدام معرف الملف من الخطوة السابقة. إذا كنت تريد تنزيل running config، فيمكنك إستخدام نقطة النهاية:

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 بواسطة هذا الأسلوب نظرا لتكوينها المختلف (قاعدة البيانات).

أستكشاف أخطاء مجموعة أرشيف التكوين وإصلاحها

انتهاء المهلة

رسالة الخطأ ذات الصلة: فشل نسخ قاعدة البيانات إحتياطيا من الجهاز الذي يستخدم https. مهلة مأخذ التوصيل أثناء تنفيذ طلب HTTP: انتهت مهلة القراءة

السبب الجذري: تحدث المهلة قبل أن يتمكن EPNM من الحصول على قاعدة البيانات من الجهاز.

تستخدم مهمة أرشيف التكوين قيمة مهلة واجهة سطر الأوامر (CLI) للجهاز لكل نشاط جلب. تتضمن مهمة أرشيف التكوين الواحد من ملف إلى خمسة ملفات. ونتيجة لذلك، يتم تحديد قيمة انتهاء مهلة المهمة الإجمالية باستخدام المنطق: مهلة المهمة الإجمالية = عدد الملفات*مهلة واجهة سطر الأوامر (CLI) الخاصة بالجهاز. لتكوين قيمة انتهاء مهلة واجهة سطر الأوامر (CLI)، أختر المخزون >إدارة الأجهزة>أجهزة الشبكة، انقر فوق أيقونة تحرير الجهاز، وحدد خيار Telnet/SSH، ثم أدخل قيمة في حقل المهلة.

لم يتم تمكين EMS ك "آمن" في NCS2000

رسالة الخطأ ذات الصلة: فشل نسخ قاعدة البيانات إحتياطيا من الجهاز الذي يستخدم https. فشل إنشاء اتصال برنامج Telnet بالجهاز- سبب رفض الاتصال أو انقضت مهلته.

السبب الجذري:تم تعيين معلمة الوصول إلى EMS في NCS2000 (يتم الوصول إليها عبر أداة CTC) على غير آمن. من الضروري إعداده على أنه آمن. 

ومن أجل إصلاحها، يمكنك الوصول إلى NCS2000 باستخدام أداة CTC، انتقل إلى طريقة عرض العقدة، وعلامة تبويب الإمداد، والأمان، ثم علامة التبويب "الوصول"، ثم قم بتغيير حالة الوصول ضمن EMS Access إلى Secure.

لم يتم العثور على معرف الجهاز

رسالة الخطأ ذات الصلة: "تعذر العثور على أرشيف (أرشيفات) الأجهزة. قد يحتوي الجهاز (الأجهزة) على معرف غير صالح أو قد يكون تم حذفه من النظام.

السبب الجذري: إذا تم حذف جهاز NCS2000 في EPNM، يتغير معرف الجهاز الخاص به في قاعدة بيانات EPNM. ومع ذلك، لا تزال مهمة مجموعة أرشيف التكوين تشير إلى المعرف القديم، وبالتالي فإنها تفشل. ال workaround أن يمحو وينشئ التشكيل أرشيف مجموعة مهمة للجهاز المرتبط.

القرار

يصف هذا المستند ببعض التفاصيل كيفية الوصول إلى ملفات التكوين من أجهزة الشبكة المخزنة في قاعدة بيانات 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 Address>/webacs/API/v1/index؟_docs