ترقية مدير الشبكة المتطورة القابلة للبرمجة من الإصدار 5.x إلى 6.1.1

المقدمة

يوضح هذا المستند تعليمات ترقية مدير الشبكة المتطورة القابلة للبرمجة (EPNM) من الإصدار 5.x إلى الإصدار 6.1.1. 

الفصل 1: لمحة عامة

لا يستبدل هذا المستند أدلة تثبيت EPNM الرسمية ويجب إستخدامه فقط كمرجع. يجب إجراء تعديلات على هذا الإجراء لمطابقة إعداد النشر المحدد. يجب التحقق من جميع خطوات الترقية في مختبر قبل تنفيذها في بيئة إنتاج.

تتطلب الترقية من EPNM 5.x إلى الإصدار 6.1.1 خطوات وسيطة متعددة كقائمة.

1. بيانات EPNM 5.x للنسخ الاحتياطي دون اتصال.
2. تثبيت EPNM 6. 0 من البداية.
3. قم باستعادة النسخة الاحتياطية ل EPNM 5.x إلى الإصدار الجديد 6.0.
4. ترقية خادم (خوادم) EPNM 6. 0 إلى EPNM 6. 1. 1.

ترقية عمليات التحقق المسبقة

يرجى إجراء هذه التحققات المسبقة قبل بدء عملية الترقية:

• يرجى مراجعة دليل تثبيت EPNM للتأكد من استيفاء كافة المتطلبات
• لا يدعم Bare Metal في مدير Cisco EPN 6.1. الترحيل إلى المضيف المستند إلى ESXi قبل الترقية، إذا لم يكن EPNM موجودا بالفعل على الجهاز الظاهري
• يوصى بشدة باستخدام التراخيص الذكية حيث أن التراخيص التقليدية غير مدعومة بعد إصدار 6.1. لتحويل الترخيص الخاص بك، أستخدم قسم دليل تثبيت EPNM عرض التراخيص وإدارتها
• تأكد من أن جهازك الظاهري يفي بالحد الأدنى من المتطلبات المشار إليها في دليل تثبيت EPNM
• تم تنزيل ملف EPNM .iso إلى الجهاز المحلي
• ملفات تصحيح EPNM التي تم تنزيلها إلى الجهاز المحلي
• تتوفر مفاتيح مصادقة الخادم ومستخدم الهيكل وكلمات مرور المستخدم الجذر
• الأسماء والكميات والمعلومات الأخرى الخاصة بتراخيص EPNM المثبتة
• مستودع لتخزين النسخ الاحتياطي ل EPNM
• إذا كنت تستخدم "الترخيص الذكي"، احفظ رمز الترخيص الذكي ومحدد موقع معلومات طريقة التسجيل. للقيام بذلك، انتقل إلى الإدارة > إعدادات النظام > عامة > إعدادات الحساب>نقل الترخيص الذكي. قم بحفظ نسخة من "وضع النقل" و URL الذي تم تكوينه هنا.

الفصل 2: نسخ بيانات EPNM 5.x إحتياطيا دون اتصال

نظرا لأن الإصدار 6.0 من Cisco EPN Manager لا يدعم الترحيل المضمن، يجب علينا نقل أحدث عمليات النسخ الاحتياطي دون اتصال أثناء العملية. يقوم مدير Cisco EPN بإجراء النسخ الاحتياطي التلقائي للتطبيق، ويتوفر مزيد من المعلومات في قسم جدولة النسخ الاحتياطي في دليل الإدارة الرسمية.

إذا لزم الأمر، يمكنك تشغيل النسخ الاحتياطي الفوري للتطبيق يدويا من كل من واجهة المستخدم الرسومية (GUI) للويب أو واجهة سطر الأوامر (CLI) كما هو موضح:

تلميح: ترتبط مدة النسخ الاحتياطي بموارد الجهاز ومقدار البيانات المخزنة في قاعدة البيانات. يمكنك التحقق من الطوابع الزمنية في آخر ملف نسخ إحتياطي تلقائي وحساب الوقت استنادا إلى جدول مهام النسخ الاحتياطي الخاص بالخادم.

2.1 - إجراء فحص سلامة النظام قبل الترقية 

يرجى إجراء فحوصات سلامة النظام قبل بدء الترقية وتسجيل جميع الحالات للمراجع المستقبلية. تتوفر فحوصات الصحة في قسم الملحق.

2.2 - إجراء نسخ إحتياطي فوري للتطبيقات من خلال واجهة المستخدم الرسومية (GUI) عبر الويب

فيما يلي لقطة شاشة تعرض الخطوات المتوفرة:

FIG 2.1 - تفاصيل مهمة نظام النسخ الاحتياطي للخادم

2.3 - إجراء نسخ إحتياطي فوري للتطبيقات من خلال واجهة سطر الأوامر

إذا كنت تفضل إستخدام واجهة سطر الأوامر (CLI) لإجراء النسخ الاحتياطي للتطبيق، فيرجى إستخدام الخطوات التالية:

epnm50-pri/admin# show repository repositoryName

epnm50-pri/admin# backup filename repository repositoryName application NCS 

فيما يلي نموذج لمخرجات الأوامر المتوفرة للمرجع:

epnm50-pri/admin# show repository defaultRepo
epnm50-pri-230111-0330__VER6.0_BKSZ18G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK3279447439.tar.gpg
epnm50-pri/admin#

epnm50pri/admin# backup epnm50 repository defaultRepo application NCS
DO NOT press ^C while the backup is in progress
Aborting backup with a ^C may terminate the backup operation or the backup file may be corrupted
To restore this backup you will have to enter this password
Password :
Password Again :
Backup Started at : 01/13/23 18:19:28
Stage 1 of 7: Database backup ...
Database size: 26G
-- completed at 01/13/23 18:21:35
Stage 2 of 7: Database copy ...
-- completed at 01/13/23 18:21:35
Stage 3 of 7: Backing up support files ...
-- completed at 01/13/23 18:21:36
Stage 4 of 7: Compressing Backup ...
-- completed at 01/13/23 18:21:54
Stage 5 of 7: Building backup file ...
-- completed at 01/13/23 18:23:07
Stage 6 of 7: Encrypting backup file ...
-- completed at 01/13/23 18:23:18
Stage 7 of 7: Transferring backup file ...
-- completed at 01/13/23 18:23:18
% Backup file created is: epnm50-pri-230112-0330__VER5.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg
Total Backup duration is: 0h:3m:53s
epnm50-pri/admin#

epnm50-pri/admin# show repository defaultRepo
epnm50-pri-230111-0330__VER6.0_BKSZ18G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK3279447439.tar.gpg
epnm50-pri-230112-0330__VER5.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg
epnm50-pri/admin#

epnm50-primary/admin# shell
ade # sudo su

ade # /opt/CSCOlumos/bin/getSCPCredentials.sh

epnm50pri/admin# shell
Enter shell access password :
ade # whoami
admin
ade # sudo su
ade # whoami
root
ade # /opt/CSCOlumos/bin/getSCPCredentials.sh
user is scpuser
password is XXXXX
Connect to your Primary/Standalone EPNM 5.x server via SCP with your preferred application and transfer the backup file from the /localdisk/defaultRepo/ directory.

# scp scpuser@epnm50-pri:/localdisk/defaultRepo/epnm50-pri-230112-0330__VER5.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg /home/user/Download
scpuser@epnm50-pri's password:
epnm50-pri-230112-0330__VER5.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg       100%     729MB

Remove the High Availability configuration through the Web GUI

epnm50-primary/admin# ncs ha status

epnm50-primary/admin# ncs ha remove

epnm50-primary/admin# ncs ha status

epnm50-primary/admin# ncs hastatus
[Role] Primary [Secondary Server] epnm50-sec(*.*.*.*) [State] Primary Active [Failover Type] Manual
epnm50-primary/admin# ncs haremove
High availability configuration will be removed
Do you wish to continue? (y/N) y
Removing primary configuration will remove all database information
Primary is attempting to remove high availability configuration from both primary and secondary
Successfully removed high availability configuration
epnm50-primary/admin# ncs hastatus
[Role] Primary [State] HA not Configured
epnm50-primary/admin#

الفصل 3: تثبيت مدير EPN 6.0 من البداية

يجب نشر تطبيق Cisco EPN Manager، الإصدار 6.0 قبل إسترداد بيانات 5.x الخاصة بك عبر ذلك التطبيق.

يجب أن يتم هذا التثبيت على جهاز VM عبر ملف OVA. خوادم Bare-Metal غير معتمدة لإصدار ما بعد 6.0.

تشمل الخطوات الواردة في هذا الفصل ما يلي:

• تنزيل وسائط التثبيت
• التحقق من وسائط التثبيت
• نشر وسائط التثبيت استنادا إلى النظام الأساسي المختار
• بدء عملية التثبيت.

تلميح: يرتبط وقت التثبيت بموارد النظام. يستغرق وقت تثبيت نموذجي مع إعادة التشغيل المطلوبة في النهاية، عادة حوالي 3 ساعات.

تحذير: إذا كان لديك إعداد HA، فيجب عليك إكمال هذه الخطوات على كل من الخوادم الأساسية والثانوية.

3.1 - تنزيل وسائط تثبيت EPNM 6.0

على الرغم من إمكانية تثبيت برنامج EPNM 6.0 على جهاز افتراضي (VM) أو خادم Bare Metal للترقية إلى الإصدار 6.1.1 والإصدار الأحدث، إلا أننا لا ندعم برنامج Bare Metal. ولهذا السبب، نوصي بتثبيت صور OVA المتوفرة على صفحة تنزيل EPNM 6.0 الرسمية.

الرجاء تنزيل ملف OVA لاستخدامه للخوادم الجديدة.

FIG 3.1 - ملفات تثبيت EPN Manager 6.0 OVA و ISO

تحذير: على الرغم من أنه لا يزال متاحا في الإصدار الحالي 6.0، فقد تم إهمال تركيب المعدن العاري وتم إزالته من الإصدار 6.1 وما بعده. لهذه الترقية، أستخدم ملف OVA على VMWare.

يرجى تأكيد أن الخادم (الخوادم) لديك يفي بالحد الأدنى من المتطلبات في قسم متطلبات الأجهزة والبرامج لدليل تثبيت EPNM 6.0 الرسمي.

3.2 - التحقق من حزمة OVA

# openssl dgst -sha512 -verify cert-file -signature sig-file product-file

هنا عينة إنتاج من ال يعين أمر لمرجع:

# ls -l
-rw-r--r--. 1 root root 6877839360 Jan 13 17:02 CEPNM-VA-FED-6.0-113.ova
-rw-r--r--. 1 root root 256 Jan 22 20:12 CEPNM-APL-FED-6.x.x.x-113-1-K9.iso.signature
-rw-r--r--. 1 root root 451        Jan 22 20:12 CiscoEPNM6.0.pem
# openssl dgst -sha512 -verify CiscoEPNM6.0.pem -signature CEPNM-APL-FED-6.x.x.x-113-1-K9.iso.signature CEPNM-VA-FED-6.0-113.ova
Verified OK

3.3 - نشر أداة تثبيت Cisco EPN Manager 6.0 باستخدام OVA/VM

3.5 - بدء عملية تثبيت مدير EPN 6.0

ملاحظة: يستغرق بدء التشغيل الأول 30 دقيقة تقريبا يتبعه إعادة تشغيل النظام.

مثال على تثبيت EPNM 6.0 على الخادم المستقل/الأساسي

FIG 3.2 - مخرجات تثبيت الملقمات المستقلة / الأساسية

مثال على تثبيت EPNM 6.0 على الخادم الثانوي (للإعدادات عالية التوفر فقط)

الشكل 3.3 - مخرجات تثبيت الملقم الثانوي

تأكد من أن جميع الخدمات بحالة جيدة وجاهزة باستخدام أمر حالة ncs.

epnm6pri/admin# ncs status
Health Monitor Server is running. ( [Role] Primary [State] Primary Active )
Database server is running
Distributed Cache Service is running.
Messaging Service is running.
FTP Service is running
TFTP Service is running
NMS Server is running.
LCM Monitor is running.
SAM Daemon is running ...
DA Daemon is running ...
Compliance engine is running
epnm6pri/admin#

تحقق من اكتمال التثبيت بنجاح باستخدام الأمر show version.

epnm60pri/admin# show version

Cisco Application Deployment Engine OS Release: 6.7
ADE-OS Build Version: X.X.X.XXX
ADE-OS System Architecture: x86_64

Copyright (c) 2009-2020 by Cisco Systems, Inc.
All rights reserved.
Hostname: epnm6pri

Version information of installed applications
---------------------------------------------

Cisco EPN Manager
********************************************************
Version : 6.0.0 [FIPS not Enabled]
Build : 6.x.x.x.000
epnm6pri/admin#

تحقق من الإصدار على صفحة تسجيل دخول EPNM.

تظهر صفحة تسجيل الدخول إلى FIG 3.6 الإصدار الجديد من EPNM 6.0

الفصل 4: إستعادة بيانات EPNM 5.x إلى EPNM 6.0

تابع مع الخطوة الأخيرة لنقل بيانات EPNM 5.x الخاصة بك المخزنة في النسخ الاحتياطي للتطبيق واستعادتها إلى خادم EPNM 6.0 الجديد.

4. 1 - نقل بيانات EPNM 5.x إلى الخادم الجديد.

قم بتسجيل الدخول مع المستخدم المسؤول عبر CLI إلى خادم EPNM 6.0 الجديد لديك والوصول إلى shell.

أصبح المستخدم الجذري.

epnm60/admin# shell
Enter shell access password :
ade # whoami
admin

ade # sudo su
ade # whoami
root

قم بتنفيذ البرنامج النصي للحصول على اسم مستخدم وكلمة مرور SCP اللذين يمكن إستخدامهما لنقل الملف إلى خادم EPNM 6.0 الجديد.

ade # /opt/CSCOlumos/bin/getSCPCredentials.sh
user is scpuser
password is <snip>

قم بالاتصال بخادم EPNM 6.0 الجديد لديك عبر SCP باستخدام التطبيق المفضل لديك ونقل ملف النسخ الاحتياطي EPNM 5.x إلى الدليل /localdisk/defaultRepo/.

# scp epnm50-230113-0330__VER5.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg scpuser@epnm60-primary:/localdisk/defaultRepo
scpuser@epnm60-primary's password:
epnm50-230113-0330__VER5.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg         100% 

4. 2 - إستعادة النسخ الاحتياطي لتطبيق EPNM 5.x إلى خادم EPNM 6. 0 الجديد لديك

ملاحظة: يعتمد الوقت المقدر لاستعادة التطبيق على حجم ملف النسخ الاحتياطي والموارد المخصصة للخادم الجديد.

تأكد من وجود الملف في المستودع.

epnm60-primary/admin# show repository defaultRepo
epnm50-230113-0330__VER5.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg

ابدأ إستعادة ملف النسخ الاحتياطي للتطبيق في خادم EPNM 6.0 الجديد.

epnm60-primary/admin# restore epnm50-230113-0330__VER6.0_BKSZ21G_CPU16_MEM6G_RAM31G_SWAP15G_APP_CK4068034237.tar.gpg repository defaultRepo application NCS

FIG 4.1 - اكتمال إستعادة النسخ الاحتياطي ل EPNM 5.x في خادم EPNM 6.0 الجديد

4. 3 - مزامنة أجهزتك لتحديث البيانات في نظام EPNM 6. 0 الجديد

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

4. 4 - أخذ لقطة للجهاز الظاهري (VM)

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

يمكنك الرجوع إلى مقالة قاعدة Node من VMWare حول كيفية إنشاء لقطات الأجهزة الافتراضية وإدارتها.

الفصل 5: الترقية من EPNM 6.0.x إلى EPNM 6.1.1

لقد حان الوقت الآن لتثبيت ملف الترقية النهائي وملفات التصحيح عبر إعداد EPNM 6.0 الجديد للانتقال إلى أحدث إصدار EPNM 6.1.1. في هذه المرحلة، من المتوقع أن يكون كل من الخادم المستقل / الأساسي والخادم الثانوي (إن وجد) على الإصدار 6.0.

يرجى إستخدام الخطوات لتثبيت الملفات المطلوبة

5.1 - تنزيل الملف المطلوب EPNM 6.1.1

يتوفر ملف تصحيح EPNM 6.1.1 في صفحة تنزيل EPNM 6.1.1 الرسمية. من هذه الصفحة، قم بتنزيل الملف المسمى option6.1-dpp1-build690.ubf

ملف تصحيح FIG 5.2 - EPNM 6.1.1

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

يشير الشكل 5.14 إلى عمليات إعادة تشغيل النظام

5.2 - تثبيت ملف تصحيح EPNM 6.1.1 

بعد ذلك، نقوم بمراجعة الخطوات المطلوبة لتثبيت حزمة تصحيح "مدير EPN 6.1.1" على الخادم المستقل أو الأساسي.

ويتم التثبيت من خلال واجهة المستخدم الرسومية (GUI) عبر الويب الخاصة ب EPNM.

ملاحظة: يتطلب تثبيت EPNM 6.1.1 إعادة تمهيد الخادم تلقائيا ويمكن أن يستغرق إتمامه ما يصل إلى 4 ساعات استنادا إلى تكوين الأجهزة لديك.

تلميح: توصي Cisco بشدة بأن تأخذ لقطة VM قبل تثبيت تصحيح EPNM 6.1.1، حتى يمكنك إستخدام هذه اللقطة في حالة إحتياجك إلى التراجع.

مثال على تثبيت ملف تصحيح EPNM 6.1.1 على الخادم المستقل / الأساسي

فيما يلي لقطات الشاشة للخطوات المقدمة:

FIG 5. 15 - EPNM 6. 1 مستقل / صفحة تسجيل الدخول إلى الخادم الأساسيالشكل 5.16 - انقر فوق الارتباط التشعبي للتحميلFIG 5. 17 - تصفح وحدد ملف الترقية 6. 1. 1 خيار 6. 1-dpp1-build690. ubfFig 5.18 - انقر زر التثبيت الأزرقالشكل 5.19 - انقر على "نعم" لبدء عملية التثبيت

يشير الشكل 5.20 إلى إعادة تشغيل النظام قريبا

مثال على تثبيت ملف تصحيح EPNM 6.1.1 على الخادم الثانوي (إختياري)

فيما يلي لقطات الشاشة للخطوات المدرجة:

FIG 5.21 - صفحة تحديث برنامج الخادم الثانوي EPNM 6.1الشكل 5.22 - انقر فوق الارتباط التشعبي للتحميلFIG 5.23 - تصفح وحدد ملف الترقية 6.1.1 upNM6.1-dpp1-build690.ubfFig 5.24 - انقر زر التثبيت الأزرقالشكل 5.25 - انقر على "نعم" لبدء عملية التثبيت

الشكل 5.26 تشير الرسالة إلى إعادة تشغيل النظام قريبا

5. 3 - إعادة تكوين التوافر العالي (مطلوب فقط للإعداد عالي التوافر)

فيما يلي لقطات الشاشة للخطوات المدرجة:

الشكل 5.27 - صفحة تسجيل الدخول الأساسية / المستقلةالشكل 5.28 - لا يوجد تكوين HAالشكل 5-29 - قيد التسجيل في HAالشكل 5-30 - اكتمال تسجيل HA

تحقق من تسجيل HA بنجاح باستخدام حالة NCS HA على واجهة سطر أوامر EPNM.

5.4 - إعادة تكوين إعدادات الترخيص الذكي

إذا كان لديك "ترخيص ذكي"، فاستخدم هذه الخطوات لتكوينه مرة أخرى.

تأكد من ضبط وضع النقل وعنوان الربط URL الذي قمت بحفظه كجزء من قسم التحققات المسبقة في هذا المستند.

هنا لقطات شاشة للصفحات المدرجة:

Fig 5.31 - تكوين وضع النقل وعنوان URL.

الشكل 5.32 - لصق تفاصيل رمز التسجيل المميز.

الشكل 5.32 - تأكيد حالة تسجيل الترخيص الذكي.

ملاحظة: في نهاية الترقية، قم بإجراء فحص سلامة النظام لضمان توفر كل شيء كما هو متوقع. تتوفر فحوصات الصحة في قسم الملحق.

الملحق

فحوصات سلامة النظام

نقاط التحقق التي يمكن تنفيذها للتحقق من صحة النظام من خلال واجهة المستخدم الرسومية (GUI) عبر الويب

1: تحقق من إضافة كافة الأجهزة ومن أنها متزامنة:

المخزون > أجهزة الشبكة

2: تحقق من إعدادات النظام لتأكيد كل شيء كما هو متوقع:

الإدارة > إعدادات النظام

3: تأكد من تعريف جميع المستخدمين بشكل صحيح:

الإدارة > المستخدمون والأدوار و AAA > المستخدمون

4: التحقق من الاحتفاظ بإصدارات أرشيف التكوين في خادم EPNM:

المخزون > أرشيف التكوين > تحديد الجهاز

5: التأكد من وجود كافة قوالب التقارير (إن أمكن):

التقارير > قوالب التقارير المحفوظة

6: التحقق من صحة إستهلاك الترخيص/الرمز المميز كما هو متوقع:

الإدارة > التراخيص وتحديثات البرامج > التراخيص

7: التحقق من صحة خادم EPNM:

الإدارة > لوحات المعلومات > لوحة معلومات مراقبة النظام

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

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

/opt/ciscoLumos/logs/ dbadmin_Stdout.log

/var/log/ade/ADE.log

فيما يلي السجلات التي يمكن الاطلاع عليها لاستكشاف المشاكل التي تمت مصادفتها أثناء خطوات التثبيت 6.0 وإصلاحها

/opt/ciscoLumos/log/ installPackage.log

/opt/ciscoLumos/logs/ LumosInstall.log

 /opt/ciscoLumos/log/ postinstall.log

/opt/ciscoLumos/logs/ LumosCarsPostInstall.log

/opt/CSCOlumos/logs/ncsadmin-0-0.log.lck

/opt/CSCOlumos/logs/sqlUpgrade.log

/opt/CSCOlumos/logs/db_migration.log

/opt/CSCOlumos/logs/dbadmin-0-0.log

/opt/CSCOlumos/logs/dbadmin_Stdout.log

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

/opt/CSCOlumos/logs/updates.log