게이트웨이 커넥터는 게이트웨이 GuestShell에서 실행되어 Control Hub와의 연결을 유지하고, 이벤트를 조정하고, 상태 정보를 수집하는 작은 애플리케이션입니다. GuestShell에 대한 자세한 내용은 GuestShell을 참조하세요.

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

커넥터에는 두 가지 유형이 있습니다.

• 관리 커넥터

• 원격 측정 커넥터

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

관리 커넥터는 게이트웨이 등록과 원격 측정 커넥터의 수명 주기 관리를 담당합니다.

등록을 성공적으로 완료하면 관리 커넥터가 최신 원격 측정 커넥터를 다운로드하여 설치합니다.

다음 그래픽은 Webex Calling 솔루션에서 다양한 구성 요소가 연결되는 방식을 보여줍니다.

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

• 외부 인터페이스

• DNS 서버 주소

• 프록시 세부 정보

• 커넥터 IP 주소

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

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

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

• 게스트셸

• 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를 사용하여 트래픽을 게스트 셸로 라우팅합니다. 이 기능을 비활성화하려면 no ip proxy-arp 명령을 구성하지 마세요.

• Cisco Unified Border Element(CUBE)에 대해 구성된 플랫폼에서는 NAT(네트워크 주소 변환)를 사용하지 마세요. 따라서 라우팅 가능한 IP 주소로 커넥터 애플리케이션을 구성하세요. 즉, 라우터 인터페이스 주소를 공유할 수 없습니다.

게이트웨이 등록을 위해 장치를 준비하세요.

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

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

• Cisco IOS XE 버전:

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

  • 생존성 게이트웨이—Cisco IOS XE Dublin 17.12.3 이상

  권장 버전은 Cisco Software Research를 참조하세요. 플랫폼을 검색하고 추천 릴리스 중 하나를 선택하세요.

• 시스템 전제 조건

  • 최소 사용 가능 메모리 - 256MB

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

    게이트웨이에 하드 디스크가 연결되어 있지 않으면 부트플래시를 사용하여 커넥터를 설치합니다. 그러면 부트플래시에는 2000MB의 여유 공간이 있어야 합니다.

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

다음 단계에 따라 바이너리 이미지를 확장하고 구성 요소에서 부팅하세요.

1. 를 사용하여 새 디렉토리를 만듭니다.mkdir bootflash:/image

2. 를 사용하여 IOS 바이너리 이미지를 확장합니다.request platform software package expand file bootflash:/.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 목록이 다음 예와 같이 구성되어 있는지 확인하세요. 이 문서에 나열된 명령만 검증되었으며 관리형 게이트웨이에서 지원됩니다. 다른 방법(예: TACACS 또는 ISE)을 포함하는 구성은 검증되지 않았으며 현재 지원되지 않습니다.

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

  네트워크 전제 조건

  • 커넥터 IP 주소는 외부 연결을 위해 선택한 것과 동일한 네트워크에 있어야 합니다. 개인 네트워크 주소일 수 있지만 HTTPS를 통해 인터넷에 액세스할 수 있어야 합니다.

    AWS(Amazon Web Services)에서 Virtual CUBE를 로컬 게이트웨이로 사용하는 경우 커넥터 사용을 위해 보조 IP 주소를 연결하는 방법에 대한 단계는 AWS에서 Virtual 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  level and they would be changed to 
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의 커넥터 상태	설명
온라인	커넥터가 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:

디스플레이 상태

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 

게스트셸 활성화

e: Enable Guestshell 메뉴 옵션을 사용하여 클라우드 커넥터를 활성화하세요. 이렇게 하면 커넥터의 상태가 INACTIVE 에서 ACTIVE로 변경됩니다.

게스트셸 비활성화

d: Disable Guestshell 메뉴 옵션을 사용하여 클라우드 커넥터를 비활성화합니다. 이렇게 하면 커넥터의 상태가 ACTIVE 에서 INACTIVE로 변경됩니다.

커넥터 제거

u: Uninstall Connector 메뉴 옵션을 사용하여 클라우드 커넥터를 제거하세요. 이렇게 하면 Guestshell 컨테이너의 모든 데이터가 삭제되고 클라우드 커넥터와 관련된 모든 구성이 제거됩니다.

로그 수집

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

Cisco TAC에 활성 지원 사례가 있는 경우 copy bootflash:/guest-share/ scp://:@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 메뉴 옵션을 사용하여 게이트웨이 사용자 이름과 비밀번호를 업데이트합니다.

외부 인터페이스 업데이트

v: View and Modify Cloud Connector Settings 메뉴 옵션을 사용하여 커넥터가 바인딩되는 인터페이스와 커넥터 IP 주소를 변경합니다.

프록시 세부 정보 업데이트

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. Control Hub에 로그인합니다.

2. 서비스로 이동하여 통화를 클릭한 다음 관리 게이트웨이를 클릭합니다.

3. 해당 게이트웨이 인스턴스의 경우 작업 열에서 … 을 클릭하고 해당 작업을 선택합니다.