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

المقدمة

يصف هذا المستند الخطوات الرامية إلى تحديد مشكلة ترقية البرامج على الموجه Cisco IR1101 وتخفيفها عبر برنامج Cisco IOS® XE SD-WAN Manager.

وصف المشكلة

تكمل هذه المقالة الإشعار الميداني FN74237 الذي تم نشره لمسائل ترقية IR1101.

يمكن أن تفشل الموجهات Cisco IR1101 في الترقية بنجاح من برنامج Cisco IOS® 17.10/17.11 إلى إصدارات البرامج اللاحقة، بسبب عدم كفاية مساحة ذاكرة الفلاش. رأيت الإصدار على الأداة أثناء إجراء الترقية عبر مادة حفازة SD-WAN Manager في وضع التثبيت.

السيناريو

يتعذر على الموجهات التي تشغل إصدارات Cisco IOS XE 17.10.x/17.11.x الترقية إلى إصدارات أعلى باستخدام Catalyst SD-WAN Manager إذا كانت المساحة المتوفرة أقل من 1400 ميجابت.

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

معرف تصحيح الأخطاء من Cisco CSCwf84896

رسالة خطأ من سجلات إدارة SD-WAN

يمكن ملاحظة هذه الرسائل في سجلات مهام الترقية. 

[25-SEP-2024 13:11:03 AEST] الجهاز: جميع الإصدارات المثبتة: 17.10.01.0.1479 ;
[25-SEP-2024 13:11:06 AEST] الجهاز: تم تلقي طلب تثبيت لإصدار البرنامج (5-Tuple): 17.12.04.0.4826
[25-SEP-2024 13:11:19 EST] الجهاز: /flash يتطلب مساحة حرة تبلغ 703602 كيلوبايت، ولكن لا يتوفر سوى 536416 كيلوبايت
[25-SEP-2024 13:11:19 EST] فشل تثبيت البرنامج

الحل

قم بترقية الصورة من Cisco IOS XE الإصدار 17.10.x/ 17.11.x إلى 17.12.05 أولا كخطوة وسيطة ثم انتقل إلى الإصدار المطلوب بعد ذلك. لكي تنجح هذه الترقية، يجب أن يكون مدير Catalyst SD-WAN يشغل الإصدار 20.12 أو إصدارا أعلى.

الخطوات التحضيرية للترقية

تكوين النسخ الاحتياطي

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

التحقق من التوافق

تأكد من أن جهاز IR1101 وإعداد SD-WAN الحالي متوافقان مع إصدار البرنامج الهدف.

إذا كانت الترقية من 17.10.1a /17.11.1a إلى 17.12.05، فاستخدم بعد ذلك الإصدار 20.12 أو إصدار أعلى من SD-WAN Manager.

إذا كانت الترقية من 17.12.05 إلى 17.15.1a، فاستخدم الإصدار 20.15

الحصول على صورة

تنزيل الإصدار 17.12.05 من الصورة الوسيطة وإصدار البرنامج الهدف النهائي من software.cisco.com

فحص مساحة الجهاز وتنظيفها

1.تحقق من المساحة المتوفرة في الجهاز من خلال تنفيذ الأمر

Router#dir bootflash: | i bytes
                                                                                      
   2648363008 bytes total (1304428544 bytes free)

2. تأكد من وجود من 1225 إلى 1244 ميجابايت من المساحة الحرة في ذاكرة التمهيد المؤقتة (bootflash) قبل متابعة عملية الترقية.

3.إذا كان مساحة الجهاز أقل من 1225 ميجابايت في ذاكرة Flash (الذاكرة المؤقتة)، فيرجى إجراء تنظيف من خلال تنفيذ الأمر delete عبر SSH إلى الجهاز من خلال واجهة المستخدم الرسومية (GUI) vManage. قم بتنفيذ هذه الأوامر واحدا تلو الآخر.

delete /force /recursive bootflash:/.EXPAND*

delete /force /recursive bootflash:/admintech_trace

delete /force /recursive bootflash:/admintech

delete /force /recursive bootflash:/collated_log*

delete /force /recursive bootflash:/license_evlog/*.log

delete /force /recursive bootflash:/sdavc/*

delete /force /recursive bootflash:/vmanage-admin/*.tar.gz

delete /force /recursive bootflash:/core/*.tar.gz

delete /force /recursive bootflash:/core/*.core.gz

delete /force /recursive bootflash:/core/*core.flat.gz

delete /force /recursive bootflash:/syslog/*

delete /force /recursive bootflash:/crashinfo_*

delete /force /recursive bootflash:/tracelogs/*

 

وبدلا من ذلك، يمكن دمج ممارسة التنظيف هذه كجزء من تكوين شبكة SD-WAN. ويمكن أتمتة هذه الميزة من خلال الاستفادة من برنامج نصي لمعالج الإدخال/الإخراج (IM) الذي يشغل العملية عند اقتراب إجراء الترقية بواسطة برنامج SD-WAN Manager. قم بإضافة البرنامج الصغير EEM إلى ملف تعريف وظيفة CLI إضافية في مجموعة تكوين SD-WAN الخاصة بك:

تجاوز تفويض EEM_CLEAR_BOOTFLASH الخاص بإدارة الأحداث

  نمط syslog للحدث "بدء التحقق قبل الترقية"

  الإجراء 0005 syslog msg تنظيف bootflash: بدأت ...

  إجراء 0010 أمر cli "enable"

  أمر cli للإجراء 0020 "delete /force /recursive bootflash:/.expand*"

  أمر cli للإجراء 0030 "delete /force /recursive bootflash:/admintech_trace"

  أمر cli للإجراء 0040 "delete /force /recursive bootflash:/admintech"

  أمر cli للإجراء 0050 "delete /force /recursive bootflash:/collated_log*"

  أمر cli للإجراء 0060 "delete /force /recursive bootflash:/license_evlog/*.log"

  أمر cli للإجراء 0070 "delete /force /recursive bootflash:/sdavc/*"

  أمر cli للإجراء 0080 "delete /force /recursive bootflash:/vmanage-admin/*.tar.gz"

  أمر cli للإجراء 0090 "delete /force /recursive bootflash:/core/*.tar.gz"

  أمر cli للإجراء 0100 "delete /force /recursive bootflash:/core/*.core.gz"

  أمر cli للإجراء 0110 "delete /force /recursive bootflash:/core/*core.flat.gz"

  أمر cli للإجراء 0120 "delete /force /recursive bootflash:/syslog/*"

  أمر cli للإجراء 0130 "delete /force /recursive bootflash:/crashinfo_*"

  أمر cli للإجراء 0140 "delete /force /recursive bootflash:/tracelogs/*"

  الإجراء 0900 syslog msg تنظيف bootflash: اكتمل.

  exit

قبل إجراء الترقية، يمكن تشغيل البرنامج النصي لإزالة جميع الملفات غير المرغوب فيها من bootflash.

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

خطوات الترقية باستخدام برنامج Cisco Catalyst SD-WAN Manager.

1. الوصول إلى مدير SD-WAN:

• قم بتسجيل الدخول إلى Cisco SD-WAN Manager باستخدام حساب المسؤول وتأكد من أنه يقوم بتشغيل الإصدارات 20.12 أو الأحدث.

2. تحميل البرنامج (17.12.05):

• انتقل إلى قسم الصيانة - مستودع البرامج.
• حدد الخيار لتحميل صورة جديدة.
• تحميل الصورة الإصدار 17.12.05 .

3. تثبيت البرامج:

• ابدأ عملية الترقية لتثبيت صورة 17.12.05.
• مراقبة عملية الترقية وضمان إعادة تمهيد الجهاز بنجاح في إصدار البرنامج الوسيط.

[30-أكتوبر-2024 16:31:08 بالتوقيت العالمي] إجراء تثبيت البرنامج المقدم للتنفيذ

[30-أكتوبر-2024 16:31:10 بالتوقيت العالمي] يتم تثبيت برنامج إجراء الجهاز

[30-أكتوبر-2024 16:31:10 بالتوقيت العالمي] تثبيت صورة البرنامج وتنشيطها

[30-أكتوبر-2024 16:31:11 بالتوقيت العالمي]التقسيم النشط الحالي: 17.10.01.0.1479

[30-أكتوبر-2024 16:31:11 بالتوقيت العالمي] الترقية مطلوبة لإصدار البرامج : 17.12.05

[30-أكتوبر-2024 16:31:14 بالتوقيت العالمي المنسق] تكوين تأكيد الترقية تأكيد المؤقت إلى 15 دقيقة

[30-أكتوبر-2024 16:31:14 بالتوقيت العالمي] صورة البرنامج IR1101-universalk9.17.12.05.bin

[30-أكتوبر-2024 16:31:14 بالتوقيت العالمي] إرسال إجراء الترقية المطلوب إلى الجهاز

[30-أكتوبر-2024 16:31:14 بالتوقيت العالمي المنسق] يمكن لتنزيل صورة البرنامج بمجرد بدئها أن يستغرق ما يصل إلى 60 دقيقة

[30-أكتوبر-2024 16:31:18 بالتوقيت العالمي] [قيد التقدم] بدأ التحقق السابق للترقية: تحققات ما قبل الترقية لسير العمل "تنزيل وترقية"

[30-أكتوبر-2024 16:32:35 بالتوقيت العالمي] [نجاح] التحقق من صحة صورة: الصورة متوافقة مع النظام الأساسي

[30-أكتوبر-2024 16:32:35 بالتوقيت العالمي] [نجاح] توافق الصورة مع وحدة التحكم: يتوافق الإصدار 20.12 من وحدة التحكم في الصور مع الإصدار 20.12 من برنامج vManage

[30-أكتوبر-2024 التحقق من مساحة القرص بنسبة 16:32:35 بالتوقيت العالمي] [نجاح]: يحتوي القرص على مساحة كافية لتثبيت الصورة الجديدة

[30-أكتوبر-2024 التحقق من مساحة جهاز تثبيت SD-WAN وفقا للمعيار 16:32:35 بالتوقيت العالمي] [النجاح]: يحتوي أداة تثبيت SD-WAN على مساحة كافية

[30-أكتوبر-2024 16:32:35 بالتوقيت العالمي] [نجاح] فحص حمل النظام: يتمتع النظام بمستويات جيدة من وحدة المعالجة المركزية (CPU)

[30-أكتوبر-2024 16:32:35 بالتوقيت العالمي] [نجاح] فحص إستخدام الذاكرة: يحتوي النظام على مستويات ذاكرة صحية

[30-أكتوبر-2024 16:32:35 بالتوقيت العالمي] [نجاح] التحقق من سجل التكوين: تم تمكين التمهيد التلقائي

[30-أكتوبر-2024 16:32:35 بالتوقيت العالمي] [نجاح] التحقق من حالة اتصال التحكم: اتصال Control ب vManage قيد التشغيل

[30-أكتوبر-2024 16:32:35 بالتوقيت العالمي] [نجاح] أنهى فحص ما قبل الترقية: متابعة سير العمل المطلوب

[30-أكتوبر-2024 16:32:38 بالتوقيت العالمي] الجهاز: تم بدء تنزيل </software/package/ir1101-universalk9.17.12.05.SPA.bin>

[30-أكتوبر-2024 16:39:57 بالتوقيت العالمي] الجهاز: جميع الإصدارات المثبتة: 17.10.01.0.1479 ;

[30-أكتوبر-2024 16:40:00 بالتوقيت العالمي] الجهاز: تم تلقي طلب تثبيت لإصدار البرنامج (5-Tuple): 17.12.05

[30-أكتوبر-2024 16:44:59 بالتوقيت العالمي] الجهاز: تم التثبيت 17.12.05

[30-أكتوبر-2024 16:45:01 بالتوقيت العالمي] الجهاز: إعادة تحميل الجهاز لتنشيط 17.12.05

[30-أكتوبر-2024 16:57:07 بالتوقيت العالمي] الجهاز: خدمة التحقق من ترقية مادة النشر بنجاح. القسم النشط الحالي هو 17.12.05

[30-أكتوبر-2024 16:57:32 بالتوقيت العالمي] الجهاز: تم تطبيق تأكيد الترقية بنجاح

[30-أكتوبر-2024 16:57:48 بالتوقيت العالمي] اكتمال تثبيت البرنامج

ملاحظة: يشير مصطلح vManage في الرسالة إلى مدير SD-WAN.

4. قم بتعيين الافتراضي على 17.12.05 وأزال 17.10.04 من الجهاز في مدير SD-WAN.

5. تحقق من الترقية:

• بعد إعادة التشغيل، قم بتسجيل الدخول مرة أخرى إلى برنامج SD-WAN Manager.
• تحقق من تشغيل الجهاز لصورة 17.12.05.

ملاحظة: إذا كانت الترقية الهدف هي 17.12.05، فستنتهي عملية الترقية هنا، وإذا كانت الترقية المستهدفة إلى 17.15.01a، فقم بالمتابعة إلى الخطوة التالية.

6. من 17.12.05 إلى 17.15.01a من يتطلب SD-WAN Manager، الإصدار 20.15:

  تحميل صورة 17.15.01a:

• مرة أخرى، انتقل إلى قسم ترقية البرامج.
• حدد الخيار لتحميل صورة جديدة.
• تحميل إصدار البرنامج 17.15.01

   تثبيت صورة 17.15.01a:

• بدء عملية الترقية لإجراء تثبيت البرنامج
• مراقبة العملية وضمان إعادة تمهيد الجهاز بنجاح في إصدار البرنامج النهائي.

[3-نوفمبر-2024 6:57:40 بالتوقيت العالمي] إجراء تثبيت البرامج المقدم للتنفيذ

[3-نوفمبر-2024 6:57:42 بالتوقيت العالمي] يتم تثبيت برنامج الإجراء الخاص بالجهاز

[3-نوفمبر-2024 6:57:42 بالتوقيت العالمي] تثبيت صورة البرنامج وتنشيطها

[3-نوفمبر-2024 6:57:46 بالتوقيت العالمي المنسق] التقسيم النشط الحالي: 17.12.05

[3-نوفمبر-2024 6:57:46 بالتوقيت العالمي] الترقية مطلوبة لإصدار البرامج : 17٫15٫01 أمبير 0٫193

[3-NOVEMBER-2024 6:57:53 بالتوقيت العالمي المنسق] تأكيد توقيت الترقية المكون هو 15 دقيقة

[3-November-2024 6:57:53 UTC] صورة البرنامج IR1101-universalk9.17.15.01a.SPA.bin

[3-نوفمبر-2024 6:57:53 بالتوقيت العالمي] إرسال إجراء الترقية المطلوب إلى الجهاز

[3-نوفمبر-2024 6:57:53 بالتوقيت العالمي] يمكن لتنزيل صورة البرنامج بمجرد بدئها أن يستغرق ما يصل إلى 60 دقيقة

[3-نوفمبر-2024 6:57:56 بالتوقيت العالمي] [قيد_تقدم] بدأ فحص ما قبل الترقية: تحققات ما قبل الترقية لسير العمل "تنزيل وترقية"

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] فحص صحة الصورة: الصورة متوافقة مع النظام الأساسي

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي المنسق] [نجاح] توافق الصورة مع وحدة التحكم: يتوافق الإصدار 20.15 من وحدة التحكم في الصور مع الإصدار 20.15 من vManage

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] التحقق من مساحة القرص: يحتوي القرص على مساحة كافية لتثبيت الصورة الجديدة

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] التحقق من مساحة مثبت SD-WAN: يحتوي أداة تثبيت SD-WAN على مساحة كافية

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] فحص حمل النظام: يتمتع النظام بمستويات جيدة من وحدة المعالجة المركزية (CPU)

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] التحقق من إستخدام الذاكرة: يحتوي النظام على مستويات ذاكرة صحية

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] التحقق من سجل التكوين: تم تمكين التمهيد التلقائي

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] التحقق من حالة اتصال التحكم: اتصال Control ب vManage قيد التشغيل

[3-نوفمبر-2024 6:58:14 بالتوقيت العالمي] [نجاح] انتهى فحص ما قبل الترقية: متابعة سير العمل المطلوب

[3-نوفمبر-2024 6:58:16 بالتوقيت العالمي] الجهاز: تم بدء التنزيل</software/package/ir1101-universalk9.17.12.05.SPA.bin>

[3-نوفمبر-2024 7:05:33 بالتوقيت العالمي] الجهاز: جميع الإصدارات المثبتة: 17.12.04.0.4826 ;

[3-نوفمبر-2024 7:05:37 بالتوقيت العالمي] الجهاز: تم تلقي طلب تثبيت لإصدار البرنامج (5-Tuple): 17٫15٫01 أمبير 0٫193

[3-نوفمبر-2024 7:11:22 بالتوقيت العالمي] الجهاز: مثبت 17.15.01a.0.193

[3-نوفمبر-2024 7:11:24 بالتوقيت العالمي المنسق] الجهاز: إعادة تحميل الجهاز لتنشيط 17.15.01a.0.193

[3-نوفمبر-2024 7:22:56 بالتوقيت العالمي] الجهاز: خدمة التحقق من ترقية مادة النشر بنجاح. القسم النشط الحالي هو 17.15.01a.0.193

[3-نوفمبر-2024 7:23:42 بالتوقيت العالمي] الجهاز: تم تطبيق تأكيد الترقية بنجاح

[3-نوفمبر-2024 7:24:00 بالتوقيت العالمي] اكتمال تثبيت البرنامج

الخطوات التالية للترقية

أزل الصورة الوسيطة 17.12.05 التي لم تعد مطلوبة لتحرير المساحة لأغراض أخرى.

1. تعيين الإصدار الافتراضي إلى 17.15.01a من الصيانة -> تحديد الجهاز -> إجراءات صورة البرنامج -> تعيين الإصدارات الافتراضية

2. قم بإزالة الإصدار الوسيط 17.12.05 من واجهة المستخدم الرسومية (GUI) من خلال الانتقال إلى الصيانة -> حدد الجهاز -> إجراءات صورة البرنامج -> حذف البرامج المتوفرة

من القائمة المنسدلة، حدد 17.12.05

النقاط الرئيسية

• إصدارات البرامج: تأكد من إستخدام إصدارات الصور المحددة المذكورة (17.12.05 كإصدار متوسط و 17.15.01a كإصدار نهائي) للترقية من 17.10.x إلى 17.15.x.
• وهذا ينطبق فقط على IR1101’s الموجودة في وضع وحدة التحكم التي تستخدم SD-WAN Manager لتنفيذ عملية الترقية.
• ونظرا لأن هذه عملية ترقية على خطوتين، فيمكن تخطيط نافذة الصيانة وفقا لذلك.
• تأكد من إزالة صورة 17.12.05 من برنامج SD-WAN Manager بعد اكتمال الترقية بنجاح.