إنشاء ملف GISO لترقية IOS-XR باستخدام Python 3

المقدمة

يصف هذا المستند إنشاء ISO الذهبي (GISO) للترقيات في الموجهات التي تشغل برنامج Cisco IOS^® XR في إصدارات eXR.

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• برنامج IOS XR من Cisco
• إجراءات تثبيت برنامج Cisco IOS XR وترقيته
• أوامر Linux الأساسية وتصفح سطر الأوامر

المكونات المستخدمة

لا يقتصر هذا المستند على إصدارات أجهزة معينة، وهذا المستند ينطبق على جميع الموجهات التي تشغل IOS XR 64 Bit.

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.

المنتجات ذات الصلة

يمكن أيضا إستخدام هذا المستند مع إصدارات المكونات المادية التالية:

• الموجّهات من السلسلة 9000 من Cisco
• الموجّهات من السلسلة 8000 من Cisco
• سلسلة موجهات طراز 5700 من Cisco
• سلسلة موجهات طراز 5500 من Cisco
• الموجهات NCS 540 و 560

الموقع الذهبي ISO لترقيات XR

عادة، تقوم Cisco بإصدار برنامج IOS-XR على هيئة ISO صغير/أساسي يحتوي على حزم IOS-XR إلزامية لمنصة معينة، ومجموعة من الحزم الاختيارية لتشغيل ميزات إضافية وتصحيحات برامج لأي إصلاح للأخطاء في شكل ترقية صيانة البرامج (SMU). تتم تهيئة الحزمة الاختيارية ووحدة معالجة الأعطال (SMU) بتنسيق حزم RPM.

تعمل أداة ISO الذهبية على إنشاء ISO يحتوي على المحتويات الكاملة للمعالج الصغير/الأساسي ISO بالإضافة إلى الحزم الاختيارية ووحدة معالجة النصوص (SMU) التي يختارها المستخدم. وبمجرد إنشاء ISO الذهبي، يمكن إستخدامه إما لتمهيد بروتوكول iPXE أو إستخدامه ل SU (ترقية النظام) من الإصدار الجاري تشغيله الحالي إلى إصدار جديد من IOS-XR.

ملاحظة: يلزم إستخدام تقنية ISO صغيرة/أساسية لأي عملية إنشاء ISO ذهبية

أداة بيثون جيزوبني

يمكن تشغيل هذه الأداة بطبيعتها على مضيف لينوكس. بدلا من ذلك، يمكن تشغيل الأداة أيضا على نظام Linux مع تمكين Docker والقدرة على سحب صورة 'Cisco-xr-gisobuild' المنشورة من Docker Hub، على سبيل المثال، يقترح العمل في Debian 11.8

تشتمل هذه الأداة على المتطلبات التنفيذية التالية:

• python3 >= 3.6
• rpm >= 4.14
• cpio >= 2.10
• gzip >= 1.9
• createrepo_c
• ملف
• إيزوتونا
• مكسيفوس
• مكسكيشفس
• أوبنسل
• أنسكيشفس
• 7z (إختياري - ولكن يمكن تقليل الوظائف من دون)
• قراءة أيزو (إختياري - ولكن يمكن تقليل الوظائف من دون)
• ZIP (إختياري - ولكن يمكن تقليل الوظائف من دون)
• إلغاء zip (إختياري - لكن يمكن تقليل الوظائف من دون)

ملاحظة: في نظام لينوكس الأصلي، الذي لا تتوفر فيه جميع التبعيات التي تم تلبيتها، يمكن تركيب تبعيات الأداة على التوزيعات المدعومة عن طريق تشغيل الأمر التالي (ربما عبر الإنترنت): ./setup/prep_dependency.sh

كما يتطلب الأمر وحدات Python التالية (>= 3.6):

• قواعد البيانات
• إلغاء إستخدام xml
• ديستوتيلز
• تغليف
• RPM
• يامل

للتشغيل بشكل طبيعي على مضيف لينوكس، فإن التوزيعات التالية قد تم إختبارها، خصيصا لهذا السيناريو، ديبيان.

• ألما لينكس 8
• فيدورا 34
• دبيان 11.2

تحضير

يلزم أولا تأكيد ما هي الحزم الاختيارية المطلوبة ولماذا. قد يؤدي تثبيت الحزم غير الضرورية أو الزائدة إلى حدوث مشاكل وحالات فشل في إستخدام مساحة القرص أثناء التثبيت. قم بتأكيد كل متطلبات أساسية ومتطلبات أساسية لمساحة القرص قبل إنشاء GISO.

لتنزيل البرنامج اللازم راجع موقع تنزيل البرنامج الرسمي: تنزيل برنامج Cisco

يمكن أن يساعدنا البرنامج النصي على توحيد مجموعة كبيرة من الملفات، على سبيل المثال، أيزو، إصلاحات الجسر، SMU وما إلى ذلك.

مطلوب لنسخ برنامج gisobuild.py النصي إلى موقع معين على الخادم. البرنامج النصي موجود في موقع Gisobuild Git

إنشاء جيسو

فيما يلي ملخص للوسيطات التي يمكننا إستخدامها لاستخدام هذا البرنامج النصي:

usage: gisobuild.py [-h] [--iso ISO] [--repo REPO [REPO ...]]
                    [--bridging-fixes BRIDGE_FIXES [BRIDGE_FIXES ...]]
                    [--xrconfig XRCONFIG] [--ztp-ini ZTP_INI] [--label LABEL]
                    [--no-label] [--out-directory OUT_DIRECTORY]
                    [--create-checksum] [--yamlfile CLI_YAML] [--clean]
                    [--pkglist PKGLIST [PKGLIST ...]] [--script SCRIPT]
                    [--docker] [--x86-only] [--migration] [--optimize]
                    [--full-iso]
                    [--remove-packages REMOVE_PACKAGES [REMOVE_PACKAGES ...]]
                    [--skip-usb-image] [--copy-dir COPY_DIRECTORY]
                    [--clear-bridging-fixes] [--verbose-dep-check] [--debug]
                    [--isoinfo ISOINFO] [--image-script IMAGE_SCRIPT]
                    [--version]

على سبيل المثال، يتم إنشاء ESA ل ASR 9901، ويتم إستخدام حزم ISIS و OSPF للإيجاز، كما يتم إستخدام مصغر لإصدار 7.9.21 وملف التكوين الذي تتم إضافته أيضا إلى GISO.

كما هو مرئي في الأمر التالي، يتم نسخ ملفات الحزم والصغر والتكوين في دليل /src، وذلك لإنشاء إصدار ممسوح من الأمر script run.

root@debian:/gisobuild-master/src# ls
asr9k-9000v-nV-x64-1.0.0.0-r7921.x86_64.rpm   
asr9k-mcast-x64-1.0.0.0-r7921.x86_64.rpm          
asr9k-bng-ipoe-x64-1.0.0.0-r7921.x86_64.rpm   
asr9k-mgbl-x64-1.0.0.0-r7921.x86_64.rpm          
asr9k-bng-pppoe-x64-1.0.0.0-r7921.x86_64.rpm  
asr9k-mini-x64-7.9.21.iso                  
asr9k-bng-supp-x64-1.0.0.0-r7921.x86_64.rpm   
asr9k-mpls-te-rsvp-x64-1.0.0.0-r7921.x86_64.rpm  
asr9k-bng-x64-1.0.0.0-r7921.x86_64.rpm          
asr9k-mpls-x64-1.0.0.0-r7921.x86_64.rpm           
asr9k-optic-x64-1.0.0.0-r7921.x86_64.rpm          
asr9k-eigrp-x64-1.0.0.0-r7921.x86_64.rpm      
asr9k-ospf-x64-1.0.0.0-r7921.x86_64.rpm          
asr9k-isis-x64-1.0.0.0-r7921.x86_64.rpm       
asr9k-services-x64-1.0.0.0-r7921.x86_64.rpm     
asr9k-li-x64-1.0.0.0-r7921.x86_64.rpm         
asr9k-m2m-x64-1.0.0.0-r7921.x86_64.rpm         
lnt
lntmod
output_gisobuild
utils
validate
wrappers
exrmod
running-config-ASR9K
gisobuild.py

--------GISO CREATION--------
root@debian:/gisobuild-master/src# ./gisobuild.py --iso asr9k-mini-x64-7.9.21.iso --pkglist asr9k-isis-x64-1.0.0.0-r7921.x86_64.rpm asr9k-ospf-x64-1.0.0.0-r7921.x86_64.rpm --xrconfig running-config-ASR9K --label firstGiso --skip-usb-image --clean
System requirements check [PASS]

Platform: asr9k Version: 7.9.21

XR-Config file (/gisobuild-master/src/running-config-ASR9K) will be encapsulated in Golden ISO.
Warning: No RPMS or Optional Matching 7.9.21 packages found in repository

Building Golden ISO...
Summary .....

XR Config file:
    router.cfg

    ...Golden ISO creation SUCCESS.

Golden ISO Image Location: /gisobuild-master/src/output_gisobuild/asr9k-golden-x64-7.9.21-firstGiso.iso
Creating USB Boot zip...
Skipping USB Boot Zip creation: Not supported for platform: asr9k
USB BOOT ZIP NEEDED?: Contact asr9k team to add support.
root@debian:/gisobuild-master/src#

فيما يلي وصف موجز للمعلمات المستخدمة لإنشاء GISO هذا:

التحقق من الصحة

بينما تشير سجلات التثبيت إلى أنه يمكننا تأكيد إنشاء GISO من خلال مراجعة الموقع، على سبيل المثال. موقع الصورة الذهبي ISO: /gisobuild-master/src/output_gisobuild/asr9k-gold-x64-7.9.21-firstGiso.iso

طبقا للصورة التالية، initrd.img تحتوي سعة 1.7 جيجابايت على حزم التثبيت التي قمنا بتضمينها.

غيسو في دبيان