Adobe Connect 12.2 설치 안내서(고급 오디오-비디오 설정)

NCC_Onprem_12_2_Installer.zip을 모든 노드의 홈 디렉터리에 복사합니다.
예: scp  NCC_Onprem_12_2_Installer.zip -i ssh_key.pem  my-user@webrtc.corp.example.com:/home/my-user/

선택적으로 Jarsigner를 사용하여 다운로드한 서명된 zip을 확인합니다. Jarsigner는 JAVA의 일부로 설치됩니다.

1. [ java -version ] 명령을 사용하여 JAVA가 설치되어 있는지 확인합니다. Java가 설치되어 있으면 JAVA 버전을 출력으로 얻습니다.
2. 컴퓨터에 Java가 없으면 JAVA를 설치합니다.
   sudo yum install java-1.8.0-openjdk-devel 
3. 이제 터미널 창에서 아래 명령을 복사하고 Enter를 클릭합니다.
   jarsigner -verify -verbose NCC_Onprem_12_2_Installer.zip
4. 확인 출력에는 다음이 포함됩니다.
   • zip 파일 내부 목록
   • 인증을 위한 Adobe의 인증서 정보
   • 출력 성공 메시지("jar가 확인됨") 또는 실패 메시지("jar가 확인되지 않음")
5. 인증서 정보가 유효하고 확인 성공 출력 메시지가 표시되면 사용자는 zip 콘텐츠를 사용한 다음 설치를 계속할 수 있습니다. 그렇지 않은 경우 Adobe 지원에 문의해야 합니다. 

ZIP의 압축을 풉니다. 파일에 적절한 권한이 있는지 확인합니다.
다음 명령을 사용합니다. 명확하게 지정된 경우가 아니면 root/sudo 액세스 권한으로 명령을 실행하지 마십시오.

 NCC_Onprem_12_2_Installer.zip
의 압축을 풉니다 설치 관리자 상위 디렉터리로 이동합니다. 예:
cd  ~/ncc-onprem-installer/
sudo chmod +x ExternalDependencies/install.sh
sudo chmod +x MainInstall.sh
sudo chmod +x check-connectivity.sh
sudo chmod +x uninstall.sh

종속성 설치 스크립트 실행.

1. 인터넷에 액세스할 수 없거나 잠긴 환경에서 설치 프로그램을 실행하는 경우 다음 명령을 실행하여 외부 종속성을 설치합니다. 인터넷에 연결되어 있는 경우 2단계를 계속합니다.
   설치 관리자 상위 디렉터리로 이동합니다. 예를 들면 ~/ncc-onprem-installer/ 디렉터리에 있는지 확인합니다.
   bash ExternalDependencies/package-util.sh --install을 실행합니다. 그러면 상자에 필요한 모든 외부 종속성이 설치됩니다.
   
   이 작업은 노드당 한 번 필요합니다.
   
2. 설치 관리자 상위 디렉터리로 이동합니다. 예를 들면~/ncc-onprem-installer/ 디렉터리에 있는지 확인합니다.
   bash ExternalDependencies/install.sh를 실행합니다. 그러면 상자에 필요한 모든 외부 종속성이 설치됩니다.
   
   이 작업은 노드당 한 번 필요합니다.
   

호스트 파일 편집 

신호 노드에서 호스트 파일을 업데이트해야 합니다. nano 또는 vi와 같은 텍스트 편집기를 사용할 수 있습니다. 

1. nano 또는 vi 편집기를 사용하여 /etc/hosts 파일을 엽니다(예: sudo vi /etc/hosts)
   
2. 끝에 다음 줄을 추가합니다. <private-ip>를 호스트의 개인 IP로 바꿉니다. 아래 각 단어 사이에는 공백이 있습니다. 

<private-ip> cas.ncc.svc.cluster.local gw.fm.ncc.internal config.ncc.svc.cluster.local pi.ncc.svc.cluster.local auth.ncc.svc.cluster.local

192.168.1.100 cas.ncc.svc.cluster.local gw.fm.ncc.internal config.ncc.svc.cluster.local pi.ncc.svc.cluster.local auth.ncc.svc.cluster.local

구성 파일 편집

1. ncc-onprem-installer/Config/config.conf에 있는 구성 파일을 편집합니다. 파일 편집 지침이 구성 파일에 주석으로 추가됩니다. 이 파일은 각 호스트에 대해 개별적으로 편집해야 합니다.  
   
2. 이제 ncc-onprem-installer/Config/containers.conf를 편집합니다. 파일 편집 지침은 파일에 주석으로 추가됩니다. 이 파일은 각 호스트에 대해 개별적으로 편집해야 합니다. 설치할 서비스 및 배포할 컨테이너 수에 따라 다릅니다. 
   
3. 일반적인 신호 노드에 다음을 설치합니다.
   • casServer
   • configService
   • apiGateway
   • gatewayServer
   • redis
   • postgres
   • lb(선택 사항. 추가 구성 단계는 아래의 Load Balancer 섹션을 참조하십시오.)
4. 따라서 위의 모든 서비스에 대해 count=1을 설정하고 다른 모든 서비스에 대해 0을 설정합니다. 
   
5. 중요: Config.conf를 변경한 후 configService에 대해 restart=1을 설정하십시오. 
   
6. 여러 신호 노드가 필요한 설정에서, Redis 및 Postgres 데이터베이스는 첫 번째 노드에만 설치됩니다. 
   

기본 설치 관리자 스크립트 실행 .
기본 설치 관리자 디렉터리(cd ~/ncc-onprem-installer/)로 전환합니다 
기본 설치 관리자 스크립트(bash MainInstall.sh)를 실행합니다. 확인 메시지를 기다립니다.
성공 메시지: 
               2023-01-31 18:21:34,033 : INFO : Main : 55 :설치 성공. 
실패 메시지:
               2023-01-31 20:04:44,849 : ERROR : Main : 59 : 설치 실패. 자세한 내용은 installer.log를 참조하십시오. 

문제 해결 섹션을 참조하십시오.

설치 확인

• 상태 검사 API 
  노드의 상태를 확인하려면 URL: http://<private_ip>:18443/health를 찾아볼 수 있습니다. 정상 응답은 200 OK {"apigw":"ok"}이어야 합니다.  
  
  RedHat 컴퓨터에서 확인하려면 CURL 명령을 사용할 수 있습니다. 
  예: curl -v http://172.31.56.203:18443/health 
• 컨테이너 상태 확인 
  터미널 창에서 docker ps 명령을 실행합니다.
  아래와 같은 출력과 STATUS(상태)는 컨테이너에 대해 다시 시작하지 않아야 합니다.

lb 컨테이너라는 번들로 제공되는 Nginx Load Balancer 사용

이제 설치 관리자는 SSL 오프로딩을 위한 오픈 소스 Nginx 컨테이너와 함께 번들로 제공됩니다. 

이것은 실험실 또는 신호 노드 하나만 있는 작은 설정에만 사용되어야 합니다. 

신호 노드에 LB를 설치해야 합니다.

이 번들된 LB를 사용할 때 신호 노드는 공용 서브넷(또는 DMZ)에 있어야 하며 공용 IP를 할당하거나 1:1 NAT를 통해 공용 IP에 매핑되어야 합니다. 클라이언트는 포트 443의 LB URL을 통해 직접 노드에 연결합니다.

인터넷에서 Connect에 액세스할 필요가 없는 설정에서 신호는 개인 서브넷에 있어야 하지만 포트 443의 내부 네트워크에서도 계속 액세스할 수 있습니다.

요구 사항:

• 사용 사례에 따른 공용/개인 DNS 레코드
• DNS 레코드에 대한 SSL 인증서
• SSL 인증서의 개인 키

Load Balancer 사용 단계: 

1. mkdir -p ~/connect/loadbalancer/certs
2. SSL 인증서(신호 노드의 FQDN에 대해 발급됨) 및 개인 키를 certs 디렉터리에 복사합니다. 이름이 cert.crt 및 key.key인지 확인합니다.
3. config.conf 파일에서 hostnames>lb 섹션과 hostnames>fqdn 섹션에도 FQDN을 추가하여 이제 WebRTC 클러스터의 진입점이 되도록 합니다.
4. container.conf 파일에서 lb 수를 1로 업데이트합니다.
5. 이제 bash MainInstall.sh를 실행합니다.

AWS EC2 인스턴스에서 와일드카드 인증서를 사용하는 경우: 

1. Route53에서 A 레코드를 만듭니다. 예를 들어, 와일드카드 인증서가 *.example.com인 경우 A 레코드를 webrtc.example.com으로 만들고 이를 EC2 인스턴스의 Elastic IP에 매핑합니다.
2. 와일드카드 인증서 및 키를 ~/connect/loadbalancer/certs 디렉터리에 복사합니다. 이름이 cert.crt 및 key.key인지 확인합니다.
3. FQDN을 추가합니다. 예: hostnames>lb 섹션과 hostnames>fqdn의 webrtc.example.com.
4. container.conf 파일에서 lb 수를 1로 업데이트합니다.
5. 이제 bash MainInstall.sh를 실행합니다.

기본 설치 관리자 스크립트 실행.
기본 설치 관리자 디렉터리( cd ~/ncc-onprem-installer/
)로 전환합니다 기본 설치 관리자 스크립트(bash MainInstall.sh)를 실행합니다. 확인 메시지를 기다립니다.
성공 메시지
       2023-01-31 18:21:34,033 : INFO : Main : 55 : 설치 성공. 
실패 메시지:
               2023-01-31 20:04:44,849 : ERROR : Main : 59 : 설치 실패. 자세한 내용은 installer.log를 참조하십시오.    

문제 해결 섹션을 참조하십시오.

설치 확인

컨테이너 창에서 docker ps 명령을 실행하고 liveswitch-media-server 컨테이너가 실행 중인지 확인합니다. 

구성 파일 편집 

1. config.conf 파일을 편집하거나 신호 노드, ~/ ncc-onprem-installer /Config/config.conf에서 이 파일을 복사합니다. 
2. 이제  ~/ncc-onprem-installer/Config/containers.conf를 편집합니다. 파일 편집 지침은 파일에 주석으로 추가됩니다.
3. 레코딩 서버 노드에 다음을 설치합니다.
   • recordingContainer  
     
   • recordingserver  
4. 따라서, recordingContainer에 대해 count >= 1, recordingserver에 대해 1, 다른 모든 서버에 대해 0을 설정합니다.
   

기본 설치 관리자 스크립트 실행
기본 설치 관리자 디렉터리로 전환합니다. cd ~/ncc-onprem-installer/ncc-onprem-installer/
기본 설치 관리자 스크립트를 실행합니다. bash MainInstall.sh 확인 메시지를 기다립니다. 
성공 메시지
                2023-01-31 18:21:34,033 : INFO : Main : 55 : 설치 성공. 
실패 메시지:
                2023-01-31 20:04:44,849 : ERROR : Main : 59 : 설치 실패. 자세한 내용은 installer.log를 참조하십시오. 

문제 해결 섹션을 참조하십시오.

설치 확인

컨테이너 창에서 B 명령을 실행하고 hcr 및 recordingserver 컨테이너가 실행 중인지 확인합니다. 

NCC_Onprem_12_2_Installer.zip을 모든 노드의 홈 디렉터리에 복사합니다.
예: scp  NCC_Onprem_12_2_Installer.zip -i ssh_key.pem  my-user@webrtc.corp.example.com:/home/my-user/

선택적으로 Jarsigner를 사용하여 다운로드한 서명된 zip을 확인합니다. Jarsigner는 JAVA의 일부로 설치됩니다.

1. [ java -version ] 명령을 사용하여 JAVA가 설치되어 있는지 확인합니다. Java가 설치되어 있으면 JAVA 버전을 출력으로 얻습니다.
2. 컴퓨터에 Java가 없으면 JAVA를 설치합니다.
   sudo yum install java-1.8.0-openjdk-devel 
3. 이제 터미널 창에서 아래 명령을 복사하고 Enter를 클릭합니다.
   jarsigner -verify -verbose NCC_Onprem_12_2_Installer.zip
4. 확인 출력에는 다음이 포함됩니다.
   • zip 파일 내부 목록
   • 인증을 위한 Adobe의 인증서 정보
   • 출력 성공 메시지("jar가 확인됨") 또는 실패 메시지("jar가 확인되지 않음")
5. 인증서 정보가 유효하고 확인 성공 출력 메시지가 표시되면 사용자는 zip 콘텐츠를 사용한 다음 설치를 계속할 수 있습니다. 그렇지 않은 경우 Adobe 지원에 문의해야 합니다. 

ZIP의 압축을 풉니다. 파일에 적절한 권한이 있는지 확인합니다.
다음 명령을 사용합니다. 명확하게 지정된 경우가 아니면 root/sudo 액세스 권한으로 명령을 실행하지 마십시오.

NCC_Onprem_12_2_Installer.zip
의 압축을 풉니다 설치 관리자 상위 디렉터리로 이동합니다. 예:
cd  ~/ncc-onprem-installer/
sudo chmod +x ExternalDependencies/install.sh
sudo chmod +x MainInstall.sh
sudo chmod +x check-connectivity.sh
sudo chmod +x uninstall.sh

종속성 설치 스크립트 실행.

설치 관리자 상위 디렉터리로 이동합니다. 예를 들면
~/ncc-onprem-installer/디렉터리에 있는지 확인합니다.
bashExternalDependencies/install.sh를 실행합니다. 그러면 상자에 필요한 모든 외부 종속성이 설치됩니다. 

이 작업은 노드당 한 번 필요합니다.

구성 파일 편집

1. ncc-onprem-installer/Config/config.conf에 있는 구성 파일을 편집합니다. 파일 편집 지침이 구성 파일에 주석으로 추가됩니다. 이 파일은 각 호스트에 대해 개별적으로 편집해야 합니다. 이전 설치의 config.conf 파일을 참조로 사용할 수 있습니다. 새 파일을 이전 파일로 대체하지 마십시오. 최신 버전에는 중요한 업데이트가 있습니다. 
2. 이제  ncc-onprem-installer/Config/containers.conf를 편집합니다. 파일 편집 지침은 파일에 주석으로 추가됩니다. 이 파일은 각 호스트에 대해 개별적으로 편집해야 합니다.  
3. 신호 노드를 업그레이드할 때 일반적으로 다음을 설치합니다. 
   • casServer
   • configService
   • apiGateway
   • gatewayServer
4. 이전 설치의 파일을 참조하여 설치될 서비스와 배포될 컨테이너 수를 확인하십시오. 이전에 설치된 모든 서비스에 대해 count=1을 설정하고 다른 모든 서비스에 대해서는 0을 설정합니다. 
   
5. 중요: Config.conf 파일을 변경한 후 또는 최신 설치 관리자 버전을 사용하여 업그레이드할 때 configService에 대해 restart=1을 설정하십시오. 
   
6. 중요: 업그레이드할 때 배송된 Redis 및 Postgres 데이터베이스는 설치되지 않으므로, containers.conf 파일에서 해당 카운트를 0으로 유지하십시오. 
   

설치 확인 

• 상태 검사 API 
  노드의 상태를 확인하려면 URL http://<private_ip>:18443/health를 찾아볼 수 있습니다. 정상 응답은 200 OK {"apigw":"ok"}이어야 합니다. RedHat 컴퓨터에서 확인하려면 CURL 명령을 사용할 수 있습니다.
  예: curl -v http://172.31.56.203:18443/health

• 컨테이너 상태 확인
  터미널 창에서 docker ps 명령을 실행합니다.
  아래와 같은 출력과 STATUS(상태)는 컨테이너에 대해 다시 시작하지 않아야 합니다.

구성 파일 편집.

기본 설치 관리자 스크립트(
)를 실행합니다  기본 설치 관리자 디렉터리(cd ~/ncc-onprem-installer/
)로 전환합니다  기본 설치 관리자 스크립트(bash MainInstall.sh)를 실행합니다. 설치 관리자는 서비스를 최신 버전으로 자동 업그레이드합니다. 확인 메시지를 기다립니다.
성공 메시지:
                2023-01-31 18:21:34,033 : INFO : Main : 55 : 설치 성공. 
실패 메시지:
               2023-01-31 20:04:44,849 : ERROR : Main : 59 : 설치 실패. 자세한 내용은 installer.log를 참조하십시오. 

문제 해결 섹션을 참조하십시오.

설치 확인

터미널 창에서 docker ps 명령을 실행하고 liveswitch-media-server 및 liveswitch-sip-connector(선택적 설치) 컨테이너가 실행 중인지 확인합니다.

구성 파일 편집 

1. config.conf 파일을 편집하거나 신호 노드, ~/ ncc-onprem-installer /Config/config.conf에서 이 파일을 복사합니다. 이전 설치의 config.conf 파일을 참조로 사용할 수 있습니다. 새 파일을 이전 파일로 대체하지 마십시오. 최신 버전에는 중요한 업데이트가 있습니다. 
   
2. 이제  ~/ncc-onprem-installer/Config/containers.conf를 편집합니다. 파일 편집 지침은 파일에 주석으로 추가됩니다. 
   
3. 레코딩 서버 노드에 다음을 업그레이드합니다. 
   
   • recordingContainer
4. 이전 설치 디렉터리의 containers.conf를 참조하고 recordingContainer에 대한 카운트에 동일한 값을 설정하고 다른 모든 서비스에는 0을 설정하십시오. 
   

기본 설치 관리자 스크립트 실행.
기본 설치 관리자 디렉터리(cd ~/ncc-onprem-installer/ncc-onprem-installer/ 
)로 전환합니다 기본 설치 관리자 스크립트(bash MainInstall.sh)를 실행합니다. 설치 관리자는 서비스를 최신 버전으로 자동 업그레이드합니다. 확인 메시지를 기다립니다. 
성공 메시지:
               2023-01-31 18:21:34,033 : INFO : Main : 55 : 설치 성공. 
실패 메시지:
            2023-01-31 20:04:44,849 : ERROR : Main : 59 : 설치 실패. 자세한 내용은 installer.log를 참조하십시오.

문제 해결 섹션을 참조하십시오.

설치 확인

터미널 창에서 docker ps 명령을 실행하고 hcr 컨테이너가 실행 중인지 확인합니다.

네트워크 연결 확인

연결 테스트 워크플로를 실행하여 다른 노드 간의 네트워크 연결을 확인합니다. 

1. 신호 노드에 로그인합니다.
2. 설치 관리자 상위 디렉터리로 이동합니다. 예:
   cd ~/ncc-onprem-installer/ncc-onprem-installer/
3. bash check-connectivity.sh
   명령을 실행합니다.
4. 연결 도구는 Config.conf 파일에서 제공된 값을 사용하여 다음과 같은 기본 네트워크 테스트를 실행합니다. 
   
   • 서로 다른 서비스 간의 HTTP 요청 
   • 필수 TCP 및 UDP 포트에 대한 네트워크 연결 테스트
   • 이름 확인
   • 데이터베이스 연결
5. 이 테스트는 노드와 서비스 간의 필수 연결을 확인하고 결과를 공유하여 네트워크 연결 문제를 진단하는 데 도움을 줍니다.
   

고급 오디오-비디오로 Adobe Connect 회의 테스트 

1. 새 회의를 만들고 고급 오디오/비디오 옵션이 선택되어 있는지 확인합니다.
2. 회의실에 참여하고 마이크와 카메라를 켭니다.
3. 가능한 경우 다른 PC 또는 모바일 장치에서도 회의실에 참여하고 오디오-비디오 교환을 확인합니다.
4. 화면 공유를 시도합니다.    
5. 레코딩을 시작합니다. 30초 동안 기다렸다가 중지합니다. 이제 레코딩에 액세스할 수 있는지 확인합니다.
   

주 메뉴에서 배포로 이동하고 SIP 구성을 편집합니다. 

 http://<your-load-balancer-address>:9090/admin으로 이동하여 config.conf에 구성된 사용자 이름과 암호로 로그인합니다. Load Balancer를 사용하지 않으면 http://<Signalling_Node-address>:9090/admin을 찾아봅니다.

인증서로 이동합니다. 

파일 인증서에서 + 기호를 선택하고 사용 중인 도메인 인증서를 업로드합니다. 

배포로 이동한 다음, 기본값을 선택합니다. 

고급 구성 섹션으로 스크롤합니다.

이전에 업로드한 인증서로 TURNS 바인딩 을 구성합니다.

설치 관리자 루트 디렉터리(루트 디렉터리에 uninstall.sh 포함)로 변경합니다.  cd ~/ncc_onprem_installer

bash uninstall.sh를 실행합니다.

신호 노드에서 Postgres 및 Redis 데이터베이스 데이터 디렉터리를 제거하려면 아래 명령을 실행하십시오.

sudo rm -rf ~/connect