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

تم التحديث:١٦ فبراير ٢٠٢٤
معرّف المستند:221705

لغة خالية من التحيز

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

حول هذه الترجمة

ترجمت Cisco هذا المستند باستخدام مجموعة من التقنيات الآلية والبشرية لتقديم محتوى دعم للمستخدمين في جميع أنحاء العالم بلغتهم الخاصة. يُرجى ملاحظة أن أفضل ترجمة آلية لن تكون دقيقة كما هو الحال مع الترجمة الاحترافية التي يقدمها مترجم محترف. تخلي Cisco Systems مسئوليتها عن دقة هذه الترجمات وتُوصي بالرجوع دائمًا إلى المستند الإنجليزي الأصلي (الرابط متوفر).

    المقدمة

    يصف هذا المستند بالتفصيل عملية تنزيل صورة نقطة الوصول لشبكات 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 واستضافة صور نقاط الوصول هناك لنقاط الوصول لتنزيلها من هناك.

    note-icon

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

    التكوين

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

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

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

    TFTPD-64 (Windows)

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

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

    Unzipped Files in the TFTP Folderملفات غير مضغوطة في مجلد TFTP

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

    TFTPD-64 File Transfer Progressتقدم نقل الملفات TFTPD-64

    TFTPD-HPA (Linux)

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

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

    TFTP Configurations and Unzipped Files in Ubuntuتكوينات TFTP والملفات غير المضغوطة في Ubuntu

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

    TFTP File Transfer Logs on Ubuntuسجلات نقل ملفات TFTP على Ubuntu

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

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

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

    TFTP Configuration for Software Upgradeتكوين 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 Configuration in Ubuntuتكوين SFTP في Ubuntu

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

    SFTP Log Activity and Configuration in Ubuntu.نشاط سجل SFTP وتكوينه في Ubuntu.

    note-icon

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

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

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

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

    SFTP Configuration in the GUIتكوين 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 Upgrade Progress Barشريط تقدم ترقية EWC Web UI

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

    EWC Web UI APs Image Predownload Statusحالة التنزيل المسبق لصورة 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
    note-icon

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

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

    محفوظات المراجعة

    المراجعة تاريخ النشر التعليقات
    1.0
    16-Feb-2024
    الإصدار الأولي
    TAC Authored

    تمت المساهمة بواسطة مهندسو Cisco

    • Execatl Moreno Avila

    هل كان هذا المستند مفيدًا؟

    Feedbackالتعليقات

    اتصل بنا

    ينطبق هذا المستند على هذه المنتجات