Webex 클라우드에 Cisco IOS 관리 게이트웨이 등록

게이트웨이 커넥터는 게이트웨이 GuestShell에서 실행되는 작은 애플리케이션으로 Control Hub에 대한 연결을 유지하고 이벤트를 조정하며 상태 정보를 수집합니다. GuestShell에 대한 자세한 정보는 GuestShell을 참조하십시오.

게이트웨이 커넥터는 Cisco IOS XE GuestShell 컨테이너에 설치됩니다.

두 가지 유형의 커넥터가 있습니다.

• 관리 커넥터

• 원격 측정 커넥터

대화형 메뉴 기반 TCL 스크립트는 관리 커넥터의 설치 및 유지관리뿐만 아니라 GuestShell을 설정하는 데 도움이 됩니다.

관리 커넥터는 텔레메트리 커넥터의 게이트웨이 등록 및 수명 주기 관리를 관리합니다.

등록을 성공적으로 완료한 후 관리 커넥터는 최신 텔레메트리 커넥터를 다운로드하고 설치합니다.

다음 그래픽은 Webex Calling 솔루션에서 다른 구성 요소가 어떻게 연결되는지 보여줍니다.

TCL 스크립트 실행의 일부로, 다음 정보가 사용자로부터 수집됩니다.

• 외부 인터페이스

• DNS 서버 주소

• 프록시 세부 사항

• 커넥터 IP 주소

• 게이트웨이 자격 증명(사용자 이름 및 암호)

TCL 스크립트는 다음 구성을 수행합니다.

• 가상 포트 그룹—guestshell 구성에 필요합니다.

• 이메일 : sales@gmail.com

• NETCONF 양

• SNMP 트랩 구성 - Cisco IOS XE의 알림에 필요합니다.

• IP 라우트—가상 포트 그룹을 통해 커넥터 관련 트래픽을 라우트합니다.

TCL 스크립트는 다음 구성을 수행합니다.

!
interface VirtualPortGroup 0
 ip unnumbered GigabitEthernet1
 no mop enabled
 no mop sysid
!

!
app-hosting appid guestshell
 app-vnic gateway0 virtualportgroup 0 guest-interface 0
  guest-ipaddress 10.65.125.227 netmask 255.255.255.128
 app-default-gateway 10.65.125.142 guest-interface 0
 app-resource profile custom
  cpu 800
  memory 256
  persist-disk 500
 name-server0 72.163.128.140
 name-server1 8.8.8.8
!

!
netconf-yang
netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.4.1.9.9.41.2.0.1
netconf-yang cisco-ia snmp-community-string Gateway-Webex-Cloud
!

!
logging snmp-trap emergencies
logging snmp-trap alerts
logging snmp-trap critical
logging snmp-trap errors
logging snmp-trap warnings
logging snmp-trap notifications
!

!
snmp-server community Gateway-Webex-Cloud RO
snmp-server enable traps syslog
snmp-server manager
!

!
ip route 10.65.125.227 255.255.255.255 VirtualPortGroup0
!
 

설치하기 전에 커넥터 응용프로그램을 다음과 같이 사용할 수 없습니다.

• Cisco 1100 통합 서비스 라우터 플랫폼
• 고가용성(HA) 모드로 구성된 플랫폼
• SD-WAN 네트워크용 컨트롤러 모드로 구성된 플랫폼

커넥터 응용프로그램에서 사용할 라우터를 구성할 때 다음을 고려하십시오.

• IOS XE는 프록시 ARP를 사용하여 게스트 셸로 트래픽을 라우트합니다. 를 구성하여 이 기능을 비활성화하지 마십시오. IP 프록시-arp 없음...
• CUBE에 대해 구성된 플랫폼에서 NAT(Network Address Translation)를 사용하지 마십시오. 따라서 라우팅 가능한 IP 주소로 커넥터 애플리케이션을 구성합니다. 즉, 라우터 인터페이스 주소를 공유할 수 없습니다.

게이트웨이 등록을 위해 장치를 준비합니다.

• 조직 관리자로서 Control Hub에 액세스

• 구성하려는 장치의 IP 주소, 사용자 이름 및 암호입니다.

• Cisco IOS XE 버전:

  • 로컬 게이트웨이—Cisco IOS XE Bengaluru 17.6.1a 이상

  • 지속 가능 게이트웨이—Cisco IOS XE Dublin 17.12.3 이상

  권장 버전은 Cisco 소프트웨어 연구 페이지를 참조하십시오. 플랫폼을 검색하고 "추천" 릴리즈 중 하나를 선택합니다.

• 시스템 사전 요건

  • 최소 무료 메모리—256 MB

  • 최소 디스크 공간 - 커넥터 설치에 사용되는 게이트웨이에 연결된 하드 디스크(SSD)에는 2000MB 여유 공간이 있어야 합니다. 또한, bootflash에는 50MB의 여유 공간이 있어야 합니다. 로그와 RPM 파일을 저장하는 데 사용됩니다.

    하드 디스크가 게이트웨이에 연결되지 않은 경우, 부트플래시는 커넥터 설치에 사용됩니다. 그런 다음 bootflash에는 2000MB 여유 공간이 있어야합니다.

라우터의 부트플래시가 4GB이고 사용 가능한 용량(최소 용량)이 2GB 미만인 경우 현재 실행 중인 이미지를 제외한 모든 IOS 바이너리(.bin) 이미지를 삭제합니다. 파일을 삭제한 후 추가 공간을 확보합니다.

다음 단계를 사용하여 구성 요소에서 이진 이미지 및 부팅을 확장합니다.

1. 다음을 사용하여 새 디렉터리 만들기 mkdir bootflash:/image.

2. IOS 바이너리 이미지 확장 request platform software package expand file bootflash:/<image>.bin to bootflash:/image.

3. 구성 모드에서 현재 부팅 옵션을 제거합니다. no boot system.

4. 새 부팅 설명 구성: boot system bootflash:/image/packages.conf.

5. 구성 모드에서 종료하고 구성을 저장한 후 재부팅합니다.

6. 라우터가 다시 시작되면 show version 라우터가 부팅되었는지 확인하기 위해 bootflash:/image/packages.conf. 그렇다면:

   1. 다음 항목을 확인합니다. bootflash:/sysboot 디렉터리가 비어 있습니다.

   2. 나머지 IOS 바이너리 이미지를 삭제합니다.

   3. 핵심 이미지 삭제 delete /f /r bootflash:/core/*.

   4. 추적 로그 파일을 사용하여 삭제 delete /f /r bootflash:/tracelogs/*.

   5. 여전히 디스크 공간이 부족한 경우 bootflash에서 나머지 파일을 검토하십시오. 그리고 로그 및 CDR과 같은 다른 비필수 파일을 삭제합니다.

• 인터넷에 대한 경로가 있는 네트워크에 연결된 지원되는 Cisco 라우터. 기본 구성에는 다음 항목이 있어야 합니다.

  • DNS 서버는 퍼블릭 도메인 이름을 확인하도록 구성됩니다.

  • DNS 서버를 구성하려면 다음 명령을 사용합니다.

    • ip 이름 서버 <IP address="">

  • 프록시를 통해 인터넷에 연결하려면 HTTP 프록시 서버입니다.

  • 게이트웨이 자격 증명: 커넥터가 NETCONF 인터페이스를 통해 게이트웨이에 액세스하는 데 사용할 수 있는 권한 수준 15 액세스가 있는 자격 증명(사용자 이름 및 암호).

    NETCONF 액세스를 인증하고 인증하려면 예제에 설명된 대로 기본 aaa 목록이 구성되었는지 확인하십시오. 기본 목록에서 모든 메서드 옵션을 사용할 수 있습니다. 명명된 aaa 목록을 사용하여 NETCONF 액세스를 제어할 수 없습니다. 기본 목록이 올바르게 구성되지 않은 경우 시스템 로그에 "잘못된 메서드 목록" 오류 메시지가 표시될 수 있습니다.

    aaa new-model
    aaa authentication login default radius local
    aaa authorization exec default radius local if-authenticated
    username test privilege 15 secret <password>
    

  네트워크 사전 요건

  • 커넥터 IP 주소는 외부 연결에 대해 선택한 주소와 동일한 네트워크에 있어야 합니다. 개인 네트워크 주소일 수 있지만, 인터넷에 대한 HTTPS 액세스가 있어야 합니다.

    Amazon Web Services(AWS)에서 가상 CUBE를 로컬 게이트웨이로 사용하는 경우, 커넥터 사용에 대한 보조 IP 주소를 연결하는 방법에 대한 단계는 AWS에서 가상 CUBE에 대한 보조 IP 주소 연결을 참조하십시오.

  • 등록 프로세스를 완료하려면 Control Hub 및 온-프레미스 장치에 연결되어야 합니다.

  • Webex 서비스에 대한 URL:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • 전송 프로토콜: 전송 레이어 보안(TLS) 버전 1.2

  • IOS 공용 인증 기관 번들을 가져옵니다. 게이트웨이 신뢰 풀에 추가된 인증서는 Webex 서버에 대한 액세스를 확인하는 데 사용됩니다. 다음 구성 명령을 사용하여 번들을 가져옵니다.

    crypto pki trustpool import url https://www.cisco.com/security/pki/trs/ios.p7b

 ===============================================================
             Webex Gateway Connector Installation
 ===============================================================


 Choose the external-interface from the below list of available interfaces:
 ===============================================================
   Number          Interface          IP-Address        Status
 ===============================================================
     1          GigabitEthernet1      10.65.125.142       up    
 ===============================================================

 Enter a number to choose the external interface: 1

These DNS settings were detected in the gateway configuration:
 72.163.128.140 
Do you want to use these settings for the connector? [Y/n]: 

These DNS settings were detected in the gateway configuration:
72.163.128.140
Do you want to use these settings for the connector? [Y/n]: n

These proxy settings were detected in the gateway configuration:
 Proxy Server : proxy-wsa.esl.cisco.com
 Proxy Port   : 80
Do you want to use these settings for the connector? [Y/n]: 

SNMP Traps for syslog messages are
configured at <alerts> level and they would be changed to <notifications>
level in order to push notifications to the Webex Cloud.
Please confirm if it is ok to proceed?:  [Y/n]: 

 Enter Connector IP address: 10.65.125.227

Enter Gateway username: lab
Enter Gateway password: ***
Confirm Gateway password: ***

===============================================================
                 Webex Managed Gateway Connector
===============================================================

  *** Cloud connector is installed successfully. ***
-------------------------------------------------------
         *** Interface Status ***
-------------------------------------------------------
   Interface               IP-Address          Status
-------------------------------------------------------
   GigabitEthernet1        10.65.125.142       up    
   VirtualPortGroup0       10.65.125.142       up    
   Connector               10.65.125.188       up
   
-------------------------------------------------------

          *** App Status ***
-------------------------------------------------------
 Service                 Status
-------------------------------------------------------
 Guestshell              RUNNING
 Management Connector    RUNNING
-------------------------------------------------------

===============================================================
 Select option h for home menu or q to quit: 

Control Hub에 표시되는 커넥터의 전체 상태는 관리되는 게이트웨이의 텔레메트리 상태 및 관리 커넥터에 따라 달라집니다.

Control Hub에 커넥터 상태	설명
온라인	커넥터가 Cisco Webex 클라우드에 연결되었음을 나타냅니다.
오프라인	커넥터가 Cisco Webex 클라우드에 연결되지 않았음을 나타냅니다.
일시 정지됨	커넥터가 연결되었지만 일시적으로 일시 정지되었음을 나타냅니다.

관리 커넥터의 로컬 관리

커넥터를 성공적으로 설치한 후 게이트웨이에서 Webex Calling을 사용할 수 있습니다. 필요한 경우 스크립트 메뉴에서 사용할 수 있는 옵션을 사용하여 다수의 커넥터 설정을 업데이트할 수 있습니다.

다음 명령을 사용하여 언제든지 스크립트를 다시 시작할 수 있습니다. tclsh bootflash:/gateway_connector/gateway_onboarding.tcl.

===============================================================
Webex Managed Gateway Connector
===============================================================
Options
s : Display Status Page
v : View and Modify Cloud Connector Settings
e : Enable Guestshell
d : Disable Guestshell
l : Collect Logs
r : Clear Logs
u : Uninstall Connector
q : Quit
===============================================================
Select an option from the menu:

표시 상태

Webex s: Display Status Page 메뉴 옵션. 시스템은 다른 커넥터 모듈의 상태를 표시합니다.

===============================================================
                 Webex Managed Gateway Connector
===============================================================
     -------------------------------------------------------
                     *** Interface Status ***
     -------------------------------------------------------
       Interface               IP-Address          Status
     -------------------------------------------------------
       GigabitEthernet1        10.123.221.224        up    
       Connector               10.123.221.223        up
     -------------------------------------------------------
                       *** App Status ***
     -------------------------------------------------------
		Service                   Status
     -------------------------------------------------------
            Guestshell                  RUNNING
            Management Connector        RUNNING
     -------------------------------------------------------
===============================================================
          Select option h for home menu or q to quit: q 

Guestshell 활성화

클라우드 커넥터 활성화 e: Enable Guestshell 메뉴 옵션. 이는 커넥터의 상태를 INACTIVE 종료 날짜 ACTIVE.

Guestshell 비활성화

클라우드 커넥터를 사용하여 비활성화 d: Disable Guestshell 메뉴 옵션. 이는 커넥터의 상태를 ACTIVE 종료 날짜 INACTIVE.

커넥터 제거

다음을 사용하여 클라우드 커넥터 제거 u: Uninstall Connector 메뉴 옵션. 이는 Guestshell 컨테이너의 모든 데이터를 삭제하고 클라우드 커넥터와 관련된 모든 구성을 제거합니다.

로그 수집

다음을 사용하여 로그 수집 l: Collect Logs 메뉴 옵션. 시스템은 로그를 수집한 후 이러한 로그가 저장되는 위치를 표시합니다.

Cisco TAC에서 활동 중인 지원 사례가 있는 경우, 명령을 사용하여 서비스 요청에 직접 로그를 첨부할 수 있습니다. copy bootflash:/guest-share/<log-filename> scp://<case-number>:<cxd-token>@cxd.cisco.com .

다음은 샘플 명령어입니다.

vcubeprod#copy bootflash:/guest-share/gateway_webex_cloud_logs_2022114090628.tar.gz scp://123456789:a1b2c3d4e5@cxd.cisco.com

로그 지우기

다음 항목을 사용하여 장치에서 모든 로그 파일 지우기 r: Clear Logs 메뉴 옵션. 이는 Tcl 스크립트 및 커넥터의 최신 로그를 제외한 모든 기존 로그를 삭제합니다.

클라우드 커넥터 설정 보기 및 수정

클라우드 커넥터의 기존 설정에 다음 변경 사항을 적용합니다. v: View and Modify Cloud Connector Settings 메뉴 옵션.

===============================================================
                Webex Managed Gateway Connector
===============================================================
		Script Version         : 2.0.2
		Hostname/IP Addr       : 10.65.125.188
		DNS Server(s)          : 10.64.86.70
		Gateway Username       : lab
		External Interface     : GigabitEthernet1
		Proxy Hostname/IP Addr : proxy-wsa.esl.cisco.com:80
===============================================================
             Options
               c :  Update Gateway Credentials
               e :  Update External Interface
               p :  Update Proxy Details
               n :  Update DNS Server
               k :  Update Connector Package Verification Key
               l :  Modify log level for Cloud Connector
               h :  Go to home menu
               q :  Quit

===============================================================
                        Select an option from the menu: c

게이트웨이 자격 증명 업데이트

게이트웨이 사용자 이름 및 비밀번호를 c: Update Gateway Credentials 메뉴 옵션.

외부 인터페이스 업데이트

커넥터가 바인딩된 인터페이스 및 커넥터 IP 주소를 v: View and Modify Cloud Connector Settings 메뉴 옵션.

프록시 세부 사항 업데이트

다음 작업을 수행할 수 있습니다. p: Update Proxy Details 메뉴 옵션:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

커넥터 패키지 확인 키 업데이트

기술적인 문제가 있고 지원 엔지니어가 패키지 확인 키를 교체하도록 요청하는 경우, 새 버전을 업로드하십시오. gateway-webex-connectors.gpg 파일을 bootflash:/gateway_connector/ 를 사용하여 k: Update Connector Package Verification Key 확인하려면 메뉴 옵션.

관리 커넥터에 대한 로그 수준 수정

다음을 사용하여 커넥터에 대한 로깅 수준 변경 l: Modify log level for Cloud Connector 메뉴 옵션을 선택한 다음 다음 옵션 중 하나를 선택합니다.

===============================================
		  Number      Log Level 
===============================================
		    1           DEBUG 
		    2           INFO 
		    3           WARNING 
		    4           ERROR 
		    5           CRITICAL 
===============================================

게이트웨이 인스턴스를 관리하려면:

1. 서비스 아래에서 통화를 클릭한 다음 관리되는 게이트웨이 탭을 클릭합니다.

2. 해당 게이트웨이 인스턴스의 경우, 작업 열에서 인접한 점(…)을 클릭하고 해당 작업을 선택합니다.