المحتويات

المقدمة

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

المتطلبات

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

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

التكوين

الرسم التخطيطي للشبكة

تنزيل الصورة عبر TFTP

TFTPD-64 (Windows)

TFTPD-HPA (Linux)

تكوين وحدة التحكُّم في شبكة LAN اللاسلكية (WLC)

تنزيل الصورة عبر SFTP

خادم SFTP (Linux)

تكوين وحدة التحكُّم في شبكة LAN اللاسلكية (WLC)

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

تنزيل صورة AP

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

معلومات ذات صلة

المقدمة

يصف هذا المستند بالتفصيل عملية تنزيل صورة نقطة الوصول لشبكات EWC غير المتجانسة مع خوادم TFTP و SFTP.

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

المتطلبات

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

- جنرالات عملية الانضمام إلى الأسوشيتد برس.

- وحدات التحكم في الشبكة المحلية (LAN) اللاسلكية المضمنة على نقاط الوصول من السلسلة Catalyst 9100 Series APs.

- عمليات نقل ملفات TFTP.

- عمليات نقل ملفات SFTP

- إستخدام واجهة سطر أوامر Linux.

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

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:

- مادة حفازة مدمج 9800 WLC في مادة حفازة 9120AXI ap، cisco IOS® XE Cupertino 17.9.3.

- نقطة وصول Catalyst 9105AXI.

- TFTPD-64 الإصدار 4. 64.

- حزمة TFTPD-HPA Linux.

- حزمة SSH Linux

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

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

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

ملاحظة: لا ينطبق هذا إلا على عمليات ترقية صورة نقطة الوصول (AP) التي تقوم بتنزيل الصورة محليا من داخل الشبكة. ال APs يستطيع أيضا جلبت صورة مباشرة من الإنترنت من خلال CCO تحسين.

التكوين

الرسم التخطيطي للشبكة

الرسم التخطيطي للشبكة

تنزيل الصورة عبر TFTP

TFTPD-64 (Windows)

إن TFTPD-64 هو أداة مساعدة معروفة جيدا تعمل بنظام المصدر المفتوح (FOSS) وتتضمن إمكانات بروتوكول TFTP. ارجع إلى موقع الويب الخاص بها للتنزيل والتثبيت.

تأكد من فك ضغط صورة حزمة AP في المجلد المناسب لخادم TFTP.

ملفات غير مضغوطة في مجلد TFTP

ما إن يبدأ ال ap أن يجلب صورته من ال TFTP نادل، يظهر إطار منبثق من TFTP ويفصل الصورة نقل تقدم.

تقدم نقل الملفات TFTPD-64

TFTPD-HPA (Linux)

TFTPD-HPA هي حزمة أساسية معروفة يمكن الحصول عليها من مستودعات APT. ارجع إلى وثائق Ubuntu TFTP للحصول على مزيد من المعلومات.

تأكد من أن تكوينات TFTP تشير بشكل كاف إلى مجلد TFTP الخاص بك وأن صورة حزمة AP يتم فك ضغطها.

تكوينات TFTP والملفات غير المضغوطة في Ubuntu

يمكنك تعقب عملية نقل الصورة التي تم تسجيلها بشكل افتراضي في /var/lib/syslog في Ubuntu.

سجلات نقل ملفات TFTP على Ubuntu

تكوين وحدة التحكُّم في شبكة LAN اللاسلكية (WLC)

في واجهة المستخدم الرسومية (GUI) الخاصة بوحدة التحكم في الشبكة المحلية اللاسلكية (WLC)، انتقل إلى الإدارة > إدارة البرامج > ترقية البرامج. حدد TFTP في القائمة المنسدلة ضمن الوضع وأدخل معلومات خادم TFTP الخاص بك.

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

تكوين TFTP لترقية البرامج

CLI تشكيل:

9120-EWC(config)#wireless profile image-download default

9120-EWC(config-wireless-image-download-profile)#image-download-mode tftp

9120-EWC(config-wireless-image-download-profile)#tftp-image-server <TFTP-server>

9120-EWC(config-wireless-image-download-profile-tftp)#tftp-image-path <path>

تنزيل الصورة عبر SFTP

خادم SFTP (Linux)

بما أن SFTP يعمل عبر SSH، فيمكنك إستخدام حزمة SSH من Linux لتكوين خادم SFTP بسيط في Linux.

تأكد من توفير التكوينات الكافية ل SFTP في ملف /etc/ssh/ssh_config. قم بإضافة أذون للمستخدمين (أو المجموعات) إلى أدلة SFTP حسب الحاجة وقم بإلغاء ضغط ملف صورة حزمة AP في المسار المرغوب.

تكوين SFTP في Ubuntu

وعلى غرار خادم TFTP في Linux، يمكنك تعقب نشاط SFTP كذلك. بشكل افتراضي، يتم تكوين السجلات ليتم تخزينها في /var/log/auth.log. تأكد من إضافة تكوينات مستوى السجل حسب الحاجة.

نشاط سجل SFTP وتكوينه في Ubuntu.

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

تكوين وحدة التحكُّم في شبكة LAN اللاسلكية (WLC)

في واجهة المستخدم الرسومية (GUI) الخاصة بوحدة التحكم في الشبكة المحلية اللاسلكية (WLC)، انتقل إلى الإدارة > إدارة البرامج > ترقية البرامج. حدد SFTP في القائمة المنسدلة تحت الوضع ووفر المعلومات وبيانات الاعتماد لخادم STFTP الخاص بك.

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

تكوين SFTP في واجهة المستخدم الرسومية (GUI)

CLI تشكيل:

9120-EWC(config)#wireless profile image-download default

9120-EWC(config-wireless-image-download-profile)#image-download-mode sftp

9120-EWC(config-wireless-image-download-profile-sftp)#sftp-image-server <SFTP-Server>

9120-EWC(config-wireless-image-download-profile-sftp)#sftp-image-path <path>

9120-EWC(config-wireless-image-download-profile-sftp)#sftp-username <user>

9120-EWC(config-wireless-image-download-profile-sftp)#sftp-password 0 <password>

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

يسجل جهاز حالة CAPWAP في تدفق APs كما تتوقع عادة لأي عملية تنزيل صورة AP أخرى.

[*01/30/2024 21:41:35.1120] CAPWAP State: Image Data

[*01/30/2024 21:41:35.1130] AP image version 17.3.3.26 backup 8.10.130.0, Controller 17.9.4.27

[*01/30/2024 21:41:35.1130] Version does not match.

[*01/30/2024 21:41:35.1130] Request to close the file..

[*01/30/2024 21:41:35.1130] wtpOpenImgFile: image file closed, dcb->fd set to -1.

[*01/30/2024 21:41:35.2040] status 'upgrade.sh: Script called with args:[PRECHECK]'

[*01/30/2024 21:41:35.3020] do PRECHECK, part2 is active part

[*01/30/2024 21:41:35.3350] status 'upgrade.sh: Cleanup tmp files ...'

[*01/30/2024 21:41:35.4620] status 'upgrade.sh: /tmp space: OK available 96064, required 50000 '

[*01/30/2024 21:41:35.4630] wtpOpenImgFile: request ap1g8, local /tmp/part.tar

[*01/30/2024 21:41:35.4630] wtpOpenImgFile: open (/tmp/part.tar) image file success

[*01/30/2024 21:41:35.4630] Using fd(37559296) for image writing to file(/tmp/part.tar)

[*01/30/2024 21:41:35.4650] Image Data Request sent to 172.16.4.26, fileName [ap1g8], replicaStatus 1

[*01/30/2024 21:41:35.4690] Image Data Response from 172.16.4.26

[*01/30/2024 21:41:35.4690] AC accepted previous sent request with result code: 0

[*01/30/2024 21:41:35.4760] <.......................................Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).

[*01/30/2024 21:41:50.6190] ...........

[*01/30/2024 21:41:54.7060] ..............................................Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).

[*01/30/2024 21:42:14.0820] ....

[*01/30/2024 21:42:15.5860] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).

[*01/30/2024 21:42:15.6430] .............................................

[*01/30/2024 21:42:34.2800] ...............................Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).

[*01/30/2024 21:42:46.0420] ...................

[*01/30/2024 21:42:53.0610] ..................................................

[*01/30/2024 21:43:11.6480] ......> 70512640 bytes, 51208 msgs, 601 last

[*01/30/2024 21:43:13.3940] Last block stored, IsPre 0, WriteTaskId 0

[*01/30/2024 21:43:13.3940] Request to close the file..

[*01/30/2024 21:43:13.3940] wtpOpenImgFile: image file closed, dcb->fd set to -1.

[*01/30/2024 21:43:13.3940] Image transfer completed from WLC, last 1

[*01/30/2024 21:43:13.3940] Request to close the file..

[*01/30/2024 21:43:13.3940] wtpOpenImgFile: image file closed, dcb->fd set to -1.

[*01/30/2024 21:43:13.3950] in (CAPWAP_MSGELE_IMAGE_DATA_msg_dec_cb) Enabling radCfg.is_oob_image_dnld_supported

[*01/30/2024 21:43:13.4190] wtp_delayed_event_handle_write_image_to_storage(10): fileName ap1g8, pre 0

[*01/30/2024 21:43:13.4190] wtp_delayed_event_handle_write_image_to_storage(10): fileName ap1g8, pre 0

[*01/30/2024 21:43:13.5110] status 'upgrade.sh: Script called with args:[PREDOWNLOAD]'

[*01/30/2024 21:43:13.6100] do PREDOWNLOAD, part2 is active part

[*01/30/2024 21:43:13.6420] status 'upgrade.sh: Creating before-upgrade.log'

[*01/30/2024 21:43:13.6990] status 'upgrade.sh: Start doing upgrade arg1=PREDOWNLOAD arg2= arg3= ...'

[*01/30/2024 21:43:13.8610] status 'upgrade.sh: Using image /tmp/part.tar on ax-bcm32 ...'

[*01/30/2024 21:43:20.9990] status 'Image signing verify success.'

في WLC syslog، يتم وضع علامة على تنزيل الصورة على أنه ناجح.

*Feb 1 17:05:37.108: %INSTALL-5-INSTALL_COMPLETED_INFO: Chassis 1 R0/0: install_engine: Completed install add sftp://******@172.16.5.62/Documents/sftp_files/EWC_17_9_4a/ap3g3

*Feb 1 17:07:00.720: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-POD-2-2 Mac: 2c5a.0f40.6920 Session-IP: 172.16.4.33[5248] 172.16.4.26[5246] Disjoined Image Download Success

تنزيل صورة AP

ما إن يبدأ أنت تحسين عملية، أنت يستطيع تتبعت ال AP صورة عملية التنزيل المسبق مع العرض ap صورة" أمر على ال EWC. بمجرد انتهاء جميع نقاط الوصول من تنزيل الصورة، ستتمكن من رؤية الصورة المستهدفة في صورة النسخ الاحتياطي لنقاط الوصول.

9120-EWC#show ap image

Total number of APs  : 3

Number of APs

Initiated                  : 0

Downloading                : 0

Predownloading             : 0

Completed downloading      : 0

Completed predownloading   : 3

Not Supported              : 0

Failed to Predownload      : 0

Predownload in progress    : No

AP Name                           Primary Image          Backup Image            Predownload Status   Predownload Version  Next Retry Time   Retry Count   Method

------------------------------------------------------------------------------------------------------------------------------------------------------------------

AP-POD-2-2                        17.9.4.27              17.12.1.5                  Complete              17.12.1.5             0                 0                 CAPWAP

AP6C41.0E16.E79C                  17.9.4.27              17.12.1.5                  Complete              17.12.1.5             0                 0                 CAPWAP

9105-emorenoa                     17.9.4.27              17.12.1.5                  Complete              17.12.1.5             0                 0                 CAPWAP

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

شريط تقدم ترقية EWC Web UI

أدناه، يوضح EWC حالة التنزيل المسبق لنقاط الوصول.

حالة التنزيل المسبق لصورة APs الخاصة ب EWC Web UI

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

في عملية تنزيل صورة نقطة الوصول، يمكنك أن ترى في "جهاز حالة CAPWAP" سجلات في نقطة الوصول لا يمكن بدء التنزيل.

[*07/12/2023 07:41:00.7960] CAPWAP State: Image Data

[*07/12/2023 07:41:00.7970] AP image version 17.3.3.26 backup 8.10.130.0, Controller 17.9.4.27

[*07/12/2023 07:41:00.7970] Version does not match.

[*07/12/2023 07:41:00.8580] upgrade.sh: Script called with args:[PRECHECK]

[*07/12/2023 07:41:00.9540] do PRECHECK, part2 is active part

[*07/12/2023 07:41:01.0070] upgrade.sh: /tmp space: OK available 101272, required 40000

[*07/12/2023 07:41:01.0080] wtpImgFileReadRequest: request ap1g8, local /tmp/part.tar

[*07/12/2023 07:41:01.0100] Image Data Request sent to 172.16.4.26, fileName [ap1g8], slaveStatus 0

[*07/12/2023 07:41:01.0140] Image Data Response from 172.16.4.26

[*07/12/2023 07:41:01.0140] AC accepted join request with result code: 0

[*07/12/2023 07:41:09.5930] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).

[*07/12/2023 07:41:28.7700] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).

[*07/12/2023 07:41:29.7500]

[*07/12/2023 07:41:29.7500] Going to restart CAPWAP (reason : image download cannot start)...

[*07/12/2023 07:41:29.7500]

[*07/12/2023 07:41:29.7570] Restarting CAPWAP State Machine.

[*07/12/2023 07:41:29.7600] Image Data Request sent to 172.16.4.26, fileName [ap1g8], slaveStatus 1

[*07/12/2023 07:41:29.7970]

[*07/12/2023 07:41:29.7970] CAPWAP State: DTLS Teardown

[*07/12/2023 07:41:29.8330] Aborting image download(0x0): Dtls cleanup, ap1g8

[*07/12/2023 07:41:29.9560] upgrade.sh: Script called with args:[ABORT]

[*07/12/2023 07:41:30.0570] do ABORT, part2 is active part

[*07/12/2023 07:41:30.1050] upgrade.sh: Cleanup tmp files ...

[*07/12/2023 07:41:30.1590] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: DTLS Teardown(4).

لفهم لماذا ال ap يعجز أن يجلب الصورة، أنت يستطيع فحصت ال syslog في ال EWC. من الشائع رؤية تنزيلات الصور الفاشلة بسبب المسارات المحددة الخاطئة إلى خوادم TFTP و SFTP، والتي تنعكس بشكل صحيح في السجلات:

ل SFTP:

*Feb 1 20:29:14.108: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-9117 Mac: 0cd0.f897.ade0 Session-IP: 172.16.4.34[5248] 172.16.4.26[5246] Disjoined Image Download Failed

*Feb 1 20:29:17.325: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R0/0: install_engine: Started install add sftp://******@172.16.5.62/Documents/Wrong-Path/ap1g6

*Feb 1 20:29:25.730: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package sftp://******@172.16.5.62/Documents/Wrong-Path/ap1g6, Error: Failed to download file sftp://******@172.16.5.62/Documents/Wrong-Path/ap1g6: No such file or directory

ل TFTP:

*Feb 1 20:52:08.742: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-9117 Mac: 0cd0.f897.ade0 Session-IP: 172.16.4.34[5248] 172.16.4.26[5246] Disjoined Image Download Failed

*Feb 1 20:52:11.894: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R0/0: install_engine: Started install add tftp://172.16.5.27/Wrong-Path/ap1g6

*Feb 1 20:52:13.977: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package tftp://172.16.5.27/Wrong-Path/ap1g6, Error: Failed to download file tftp://172.16.5.27/Wrong-Path/ap1g6: No such file or directory

تأكد من أن خادم TFTP أو SFTP الخاص بك يمكن الوصول إليه بواسطة نقاط الوصول (APs) وخادم EWC. وإلا، يمكن رؤية سجل انتهاء المهلة في syslog ل EWC.

*Feb 1 20:55:03.359: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-9117 Mac: 0cd0.f897.ade0 Session-IP: 172.16.4.34[5248] 172.16.4.26[5246] Disjoined Image Download Failed

*Feb 1 20:55:06.512: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R0/0: install_engine: Started install add tftp://172.16.5.199/EWC/17_9_4a/ap1g6

*Feb 1 20:55:46.579: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package tftp://172.16.5.199/EWC/17_9_4a/ap1g6, Error: Failed to download file tftp://172.16.5.199/EWC/17_9_4a/ap1g6: Timed out

ملاحظة: تأكد من أن منفذ UDP 69 ل TFTP وTCP ميناء 22 ل SFTP لم يتم حظره بين نقاط الوصول و EWC وخادم TFTP أو SFTP.

معلومات ذات صلة

- التقرير الرسمي لوحدة التحكم اللاسلكية المضمنة من Cisco على نقاط وصول Catalyst (EWC)

- ورقة بيانات وحدة التحكم اللاسلكية المضمنة من Cisco على نقاط وصول Catalyst

- وحدة التحكم اللاسلكية المضمنة من Cisco على الأسئلة المتداولة حول نقاط وصول Catalyst

- فهمت ال ap ربط عملية مع المادة حفازة 9800 WLC

- ملاحظات الإصدار لوحدة التحكم في الشبكة المحلية اللاسلكية Cisco Catalyst 9800 Series، Cisco IOS XE