سيناريوهات أستكشاف أخطاء Nexus 1000v (N1KV) مع VSUM وإصلاحها

المقدمة

يصف هذا المستند سيناريوهات أستكشاف أخطاء Nexus (N1KV) وإصلاحها باستخدام مدير تحديث المحول الظاهري (VSUM).

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

Cisco VSUM هو جهاز ظاهري تم تسجيله كمكون إضافي لخادم VMware vCenter. تعد واجهة المستخدم الرسومية (GUI) لبرنامج Cisco VSUM جزءا متكاملا من عميل ويب vSphere من VMware؛ ولا يمكن الوصول إليها إلا عند تسجيل الدخول إلى عميل الويب vSphere من VMware. يبسط Cisco VSUM تثبيت وتكوين Cisco Nexus 1000V والمحول الظاهري لتطبيق Cisco Application Virtual Switch (AVI).

دعنا نفعل هذا مع Cisco VSUM:

• Cisco Nexus 1000V for VMware vSphere
• تثبيت محول Nexus 1000V من Cisco
• ترحيل المحول الموزع عبر برنامج vSwitch من VMware وبرنامج vSphere من VMware (المعروف إختصارا باسم VDS) إلى برنامج Cisco Nexus 1000V
• مراقبة Cisco Nexus 1000V
• ترقية Cisco Nexus 1000V وإضافة مضيفين من إصدار أقدم إلى الإصدار الأحدث
• تثبيت ترخيص Cisco Nexus 1000V
• عرض حالة الأجهزة الظاهرية في مركز البيانات باستخدام لوحة المعلومات - Cisco Nexus 1000V
• الترقية من إصدار سابق إلى Cisco VSUM 2.0

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

اتبع الخطوات التالية لاستكشاف أخطاء الشبكة وإصلاحها:

1. اجمع المعلومات التي تحدد الأعراض المحددة
2. حدد جميع المشاكل المحتملة التي يمكن أن تسبب الأعراض
3. القضاء بشكل منهجي على كل مشكلة محتملة (من المرجح إلى الأقل) إلى أن تختفي الأعراض

ثانيا - لمحة عامة عن أفضل الممارسات

أفضل الممارسات هي الخطوات الموصى بها التي يجب عليك إتخاذها لضمان التشغيل السليم لشبكتك. يوصى بتطبيق أفضل الممارسات التالية لمعظم الشبكات:

• الحفاظ على إصدار متناسق من Cisco VSUM عبر جميع أجهزة الشبكة

• أحلت الإصدار بطاقة ل cisco VSUM إطلاق ل الأخير سمة، تحديد، وتحذير

• تمكين تسجيل دخول رسائل النظام

• تحقق من أي تغييرات تكوين جديدة واستكشاف أخطائها وإصلاحها بعد تنفيذ التغيير

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

هذه هي بعض المشاكل الأكثر شيوعا التي صادفها مركز المساعدة التقنية (TAC) من Cisco في وقت كتابة هذه المقالة.

السيناريو 1. أيقونة VSUM مفقودة في عميل ويب

بعد نشر VM من خلال Open Virtual Appliance (OVA) والتهيئة الناجحة، لا تظهر أيقونة VSUM في مخزون vCenter كما هو موضح في الصورة.

اتصال الشبكة

• أولا، تأكد من وجود اتصال الشبكة بين المكونات.
• بعد ذلك، تأكد من صحة المعلومات الأولية المتوفرة في VSUM OVA. ويتضمن ذلك عناوين vCenter IP وأرقام المنافذ. 
• أخيرا، اسمح ميناء 8443 للاتصالات الداخلية.
• تم تحديث دليل التثبيت بهذه المعلومات، تتبع الخطأ: CSCux34597)

مشاكل التثبيت الشائعة

1. تلف OVA
   • تأكيد المجموع الاختباري ل MD5 الخاص ب OVA قبل نشره
2. لا تظهر أيقونة N1kv Manager/VSUM في عميل ويب vCenter
   • على الأرجح، لا يمكن الوصول إلى الجهاز عبر IP
   • قم بالتأكيد على الاتصال عبر طبقة الأمان (SSH) وتأكد من صحة مجموعة منافذ VM وعنوان IP
   • إختبار اتصال البوابة الافتراضية من وحدة تحكم التطبيق
   • قم بتسجيل الدخول إلى الجهاز وفحص سجل التثبيت (راجع للحصول على ملف) للاطلاع على سبب الفشل. يجب أن ترى NoRouteToHostException

لتغيير عنوان IP، انتقل إلى /etc/cisco/app_install
تشغيل cp app.cfg.template app.cfg
قم بتشغيل vi app.cfg وتحديث المعلومات. فيما يلي مثال:

 IpV4Address="10.28.28.121"
                IpV4Netmask="255.255.255.0"
                IpV4Gateway="10.28.28.1"
                DnsServer1="10.28.28.115"
                DnsServer2=""
                VcenterIPV4Address="10.28.28.120”
                VcenterUsernameFormat="hex"
                VcenterUsername="726f6f74"
                VcenterPasswordFormat="hex"
                VcenterPassword="<Password Encoded As Stated>"
                VcenterHttpPort="80"
                VcenterHttpsPort="443"

احفظ هذا الملف وقم بتشغيله:

./config_apps.sh –n in order to update network information

./config_apps.sh –r in order to register the VM to vCenter web client

• تأكد من أنه يمكنك التنقل إلى حشود المتفرعين [https://<vcenter-IP>/mob] > Content > ExtensionManager
• الوصول إلى قائمة الملحقات ل VSUM (مثال: extensionList["com.cisco.n1kv"])
• انتقل إلى العميل
• هنا، أنت يستطيع رأيت URL (مثال: https://<vCenter-IP>:8443/n1kv/static/client/cisco-n1kv-mgr.zip)
• أكد أن أنت يستطيع جلبت هذا مبرد، هذا أيضا يضمن أن ميناء 8443 مفتوح

3. بيانات اعتماد/IP الخاصة ب vCenter غير صحيحة

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

4. .com.cisco.n1kv موجود بالفعل على vCenter

• تحقق من وجود مكون إضافي N1KV قديم في vCenter (انتقل إلى عميل الويب > المحولات الظاهرية الموزعة > [أي محول N1KV] > المراقبة)
• تصفح للوصول إلى https://<vCenter IP>/Mob
• انتقل إلى المحتوى >إدارة الملحقات
• البحث عن مفتاح الملحق باستخدام n1kv
• إلغاء تسجيل الملحق
• القيام بما يلي:
  • في vCA:
    • تشغيل RM -rf /var/lib/vmware/vsphere-client/vc-packages/vsphere-client-serenity/com.cisco.n1kv-0.9.1
    • إعادة تشغيل خدمة عميل ويب مع إعادة تشغيل /etc/init.d/vsphere-client
  •  على خادم Windows vCenter:
    • احذف Cisco.n1kv-0.9.1 من C:\ProgramData\VMware\vSphere Web Client\vc-packages\vsphere-client-serenity
    • قم بإعادة تشغيل عميل الويب بالانتقال إلى:ابدأ > تشغيل > الخدمات.msc. انقر بزر الماوس الأيمن: إيقاف برنامج vSphere Web Client من VMware> وبدء تشغيله
• قم بإعادة نشر الجهاز الظاهري لتسجيل هذا الجهاز بنجاح

أخطاء التثبيت الشائعة

• "عنوان IP قيد الاستخدام"

إذا كان IP قيد الاستخدام بالفعل، فسوف تتم إعادة التثبيت.

• "لم يتم العثور على مضيف مناسب"

يظهر هذا خطأ عندما يتم إستخدام مجموعة منفذ CTL من مضيف واحد وإدارة مجموعة منفذ من مضيف آخر. تأكد من توفر مجموعات منافذ Ctrl و Mgmt. vlan على المضيف نفسه.

• "فشل تشغيل طاقة VSM"

المضيف المحدد على شاشة التثبيت لا يحتوي على موارد كافية (وحدة المعالجة المركزية (CPU) والذاكرة) لتشغيل VSM.

• "تكرار اسم الجهاز الظاهري"

اسم المحول الذي تم إدخاله موجود بالفعل على المضيف. ترجع عملية النشر إلى هذه المرحلة.

• "لا توجد مساحة على القرص"

لا توجد مساحة قرص كافية على المضيف لنشر VSM.

سجلات تثبيت أخرى

بعض الأخطاء الأخرى التي يمكن أن ترى بين VSUM و vCenter تسجل كإستثناءات Ajax Java. ويمكن الاطلاع عليها تحت /etc/cisco/app_install/logs/n1kv-manager_install.log. مثال: 

1784 [main] ERROR com.cisco.vcenter.extension.register.ExtensionRegister - An extension with this key is already registered. Will not attempt to register. It must be unregistered manually first, before attempting to register again.
Exception in thread "main" java.lang.IllegalArgumentException
       at com.cisco.vcenter.extension.register.ExtensionRegister.unregisterPrevExt(ExtensionRegister.java:590)
       at com.cisco.vcenter.extension.register.ExtensionRegister.register(ExtensionRegister.java:629)
       at com.cisco.vcenter.extension.register.ExtensionRegister.doWork(ExtensionRegister.java:679)
       at com.cisco.vcenter.extension.register.PluginUtil.dispatchWork(PluginUtil.java:72)
       at com.cisco.vcenter.extension.register.PluginUtil.main(PluginUtil.java:116)

تتمثل إحدى الممارسات الجيدة في مراجعة سجل الوصول، لمعرفة الإجراء الأخير الذي تم إتخاذه عند فشل الأمر. يمكنك البحث عنه في سجل /usr/local/tomcat/log/ciscoExt، للعثور على معلومات تصحيح الأخطاء التفصيلية. يمكنك النظر إلى معلومات أخرى مسجلة مباشرة تحت /usr/local/tomcat/log/.

السيناريو 2. تم سرد إصدار البرنامج الثابت الحالي فقط

يعجز أن يحسن VSMs من إطلاق x أن إطلاق y، بما أن أنت لا ترى أي صورة يعدد آخر من الحالي أن يركض كما هو موضح في الصورة.

تجميع سجلات VSUM:

الخطوة 1	أستخدم SSH للاتصال بمعرف فئة المورد (VSUM) من Cisco. التقصير username جذر وكلمة cisco.
الخطوة 2	انتقل إلى /etc/cisco/app_install وشغل الأمر ./bundleLogs.sh.
الخطوة 3	في الدليل الجذر، استرجع المجلد ajaxLog، ضاغط المجلد، وأرسله إلى Cisco TAC.

الإجراء المتخذ:

فحص TAC سجلات VSUM (ajaxLogs\tomcatAllLogs\usr\local\tomcat\logs\ciscoExt.log).

تم العثور على فرق بين معرف حزمة VSM و DVS.

<vsm-bundle-id>VEM500-201411171101-BG</vsm-bundle-id>
<dvs-bundle-id>VEM410-201301152101-BG</dvs-bundle-id>

وقد تم تصحيح هذا الإجراء المذكور هنا:

الوحدة النمطية VSM-01#show

1  5.2(1)SV3(1.2) 0.0
2  5.2(1)SV3(1.2) 0.0
3  5.2(1)SV3(1.2) VMware ESXi 5.5.0 Releasebuild-2456374 (3.2)
4  5.2(1)SV3(1.2) VMware ESXi 5.5.0 Releasebuild-2456374 (3.2)
5  5.2(1)SV3(1.2) VMware ESXi 5.5.0 Releasebuild-2456374 (3.2)

VSM-01#show system vm feature level

Current feature level: 4.2(1)SV2(1.1)

VSM-01# تحديث النظام على مستوى ميزة VM

Feature Version
Level String
--------------------
1 4.2(1)SV2(2.1)
2 4.2(1)SV2(2.2)
3 4.2(1)SV2(2.3)
4 5.2(1)SV3(1.1)
5 5.2(1)SV3(1.2)

VSM-01 # تحديث النظام مستوى ميزة VM؟

<CR>
<1-50> Version number index from the list above

VSM-01# تحديث النظام في المستوى 5 <</5 فقط لهذا المستوى لأن الإصدار N1k هو SV3(1.2) حاليا

VSM-01 # show system vm feature level

Current feature level: 5.2(1)SV3(1.2)

ملاحظة: عند ترقية مستوى الميزة على وحدة الإيثرنت الظاهرية (VEM)، لا يتطلب ذلك أي وقت توقف عن العمل.

VSM-01# عرض حالة ترقية VMware VMware

Upgrade VIBs: System VEM Image
Upgrade Status:
Upgrade Notification Sent Time:
Upgrade Status Time(vCenter):
Upgrade Start Time:
Upgrade End Time(vCenter):
Upgrade Error:
Upgrade Bundle ID:
VSM: VEM500-201411171101-BG
DVS: VEM410-201301152101-BG    <<< same info as we noted in VSUM logs

VSM-01# يتم إعلام ترقية VMware VMware، كما هو موضح في الصور.

التنسيق مع مسؤول الخادم وإعلامه بعملية ترقية VEM.

VSM-01# متابعة ترقية VMware

ملاحظة: إذا تم تمكين برنامج VUM في بيئة برنامج vCenter، فعليك تعطيله قبل تشغيل الأمر vmWare vem upgrade proceed لمنع دفع مجموعات VIB الجديدة إلى جميع الأجهزة المضيفة.

ملاحظة: قم بتشغيل الأمر vmWare vem upgrade proceed حتى يتم تحديث معرف حزمة Cisco Nexus 1000V على خادم vCenter. إن VUM يكون مكنت ولا أنت تحدث الحزمة id، vib صيغة غير صحيح دفعت إلى ال VM عندما أنت تالي تضيف ال ESXi إلى ال VSM.

ملاحظة: في حالة عدم تثبيت VUM، يظهر الخطأ "تعذر العثور على الكائن أو العنصر المشار إليه" في شريط مهام خادم vCenter. يمكنك تجاهل رسالة الخطأ هذه.

اكتمال ترقية VSM-01 # VMware VMware VMware VM

يجب أن تكون قادرا الآن على عرض إصدارات N1kv الأخرى في عميل ويب vCenter، كما هو موضح في الصورة.  

السيناريو 3. تظهر الأجهزة المضيفة ضمن 'لا حاجة إلى ترقية الأجهزة المضيفة'

تظهر كل البيئات المضيفة (VEM) تحت قسم لا توجد ترقية للمضيفين المطلوبين، كما هو موضح في الصورة.

تجميع سجلات VSUM:

الخطوة 1	أستخدم SSH للاتصال ب Cisco VSUM. التقصير username جذر وكلمة cisco.
الخطوة 2	انتقل إلى /etc/cisco/app_install وشغل الأمر ./bundleLogs.sh.
الخطوة 3	في الدليل الجذر، استرجع المجلد ajaxLog، ضاغط المجلد، وأرسله إلى Cisco TAC.

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

• مسح محفوظات المستعرض والذاكرة المخزنة مؤقتا
• قم بتسجيل الخروج من عميل ويب vCenter ثم قم بتسجيل الدخول مرة أخرى
• تحقق من ظهور المضيف في القائمة المنسدلة للمضيفين المؤهلين
• حدد المضيف وتابع عملية الترقية

يمكن العثور على هذه الخطوات في الدليل:

عند ترقية Cisco N1000v، يجب أن تظهر الأجهزة المضيفة التي تتم ترقيتها في القائمة المنسدلة الأجهزة المضيفة المؤهلة

إذا لم تساعد هذه الخطوات، فقد تواجه عيبا CSCuz11671 كما هو موضح في الصورة.

شوهد هذا السلوك مع VSUM 1.5.3 وسيتم إصلاحه في VSUM 2.1 (وبالتالي يمكن أن يتأثر أي إصدار أقل من 2.1).

السيناريو 4. غير قادر على ترقية VSM

يتعذر ترقية VSM من SV3 (1.10) إلى SV3 (1.15).

في إعدادات ما قبل الترقية، تحاول ترقية VSM باستخدام VSUM كما هو موضح في الصورة.

بعد أن تدخل في التكوين وبيانات الاعتماد الخاصة بهم، يتم عرض هذا الخطأ كما هو موضح في الصورة.

تجميع سجلات VSUM:

الخطوة 1	أستخدم SSH من أجل الاتصال ب VSUM. التقصير username جذر وكلمة cisco.
الخطوة 2.	انتقل إلى /etc/cisco/app_install وشغل الأمر ./bundleLogs.sh.
الخطوة 3	في الدليل الجذر، استرجع المجلد ajaxLog، ضاغط المجلد، وأرسله إلى Cisco TAC.

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

هذا إصدار لأن VSUM استلم معلومات غير صحيحة ل ال PSNC و VSG صيغة، أي سبب هو أن توقف التحسين.

يمكنك التأكيد باستخدام الأوامر التالية:

N1kv # show vmware vem upgrade status | xml

<show>

<vmware>
<vem>
<upgrade>
<status>
….
<vsm-bundle-id>VEM500-201512250101-BG</vsm-bundle-id>
<dvs-bundle-id>VEM500-201510210101-BG</dvs-bundle-id> <-- these two IDs do not match
…..
</status>
</upgrade>
</vem>
</vmware>
</show>

 

يشير خطأ داخلي إلى خطأ يكون إستثناء في رمز VSUM.

يجب أن تتطابق هاتان القيمتان للسماح للترقية بالمتابعة.

فيما يلي الإجراء الخاص بتصحيح هذا السلوك:

قم بتشغيل هذا الأمر لضمان أن كلا من معرفات الحزم متساوون على المحول Nexus 1000V switch:

vmware vem upgrade proceed

الأمر أعلاه يجعل كلا من الحزمة id نفسه، إن لا يعمل هذا، يركض هذا أمر:

vmware vem upgrade notify

vmware vem upgrade proceed

يحتاج مسؤول vCenter إلى قبول تطبيق مطالبة الترقية في vCenter. بمجرد القيام بذلك، قم بتشغيل ترقية VMware VMware VEM Upgrade.

التوثيق:

http://www.cisco.com/c/en/us/td/docs/switches/datacenter/nexus1000/sw/5_2_1_s_v_3_1_5a/install_upgrade/guide/b_Cisco_N1KV_VMware_Install_and_Upgrade_Guide_521SV315a/b_Cisco_N1KV_VMware_Install_and_Upgrade_Guide_521SV314a_chapter_010.html#d8382e2398a1635

في القسم: مدير تحديث VMware من الإصدار 4.2(1) SV2 (1.1x)

تم إنشاء عيب لتعقب هذه المشكلة: 

السيناريو 5. خطأ "fault.com.cisco.n1kv.internalerror.summary"

عندما تحاول ترقية VSM من الإصدار X إلى Y، تتلقى رسالة خطأ في مهام vCenter ترجع بحالة "fault.com.cisco.n1kv.internalerror.summary".

ومع ذلك، يعرض هذا الخطأ فقط في واجهة المستخدم الرسومية التقليدية ولا يعرض هذا الخطأ في عميل ويب vCenter كما هو موضح في الصورة.

تجميع سجلات VSUM:

الخطوة 1.	أستخدم SSH للاتصال ب Cisco VSUM. التقصير username جذر وكلمة cisco.
الخطوة 2.	انتقل إلى /etc/cisco/app_install وشغل الأمر ./bundleLogs.sh.
الخطوة 3.	في الدليل الجذر، استرد AjaxLog مجلد، اضغط المجلد، وأرسله إلى ال cisco TAC.

الإجراء المتخذ:

راجع usr/tomcat/logs/ciscoEXT.log. البحث عن SCP

يمكنك العثور على إدخالات مماثلة لهذا:

257266658 DEBUG 2016-07-15 06:26:18,855 [pool-2-thread-5] com.cisco.n1kv.vsm.SSHAgent - Raw output is copy scp://scpuser@10.10.100.10///etc/cisco/data/n1kvbins/VSM-v-j3-n1-u15-l-b-v/upgrade/vsm/n1000v-dk9-kickstart.5.2.1.SV3.1.15.bin bootflash:

From the VSM execute: scp://scpuser@10.10.100.10///etc/cisco/data/n1kvbins/VSM-v-j3-n1-u15-l-b-v/upgrade/vsm/n1000v-dk9-kickstart.5.2.1.SV3.1.15.bin bootflash:

If the connection is successful, you will receive a prompt for credentials.

If the command fails, this indicates that there is a communication problem between VSUM and the VSM.

The likely cause is a firewall between VSUM and the VSM.

Verify that there is a bi-direction firewall rule in place for port 22 between VSUM and VSM.

If there is no rule in place, please create the rule and attempt the upgrade process again.