3단계: Amazon DCV 세션 관리자 에이전트 설정 - Amazon DCV 세션 관리자

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

3단계: Amazon DCV 세션 관리자 에이전트 설정

에이전트는 플릿의 모든 Amazon DCV 서버 호스트에 설치되어야 합니다. 에이전트는 Windows, Linux 및 macOS 호스트 모두에 설치할 수 있습니다. 지원되는 운영 체제에 대한 자세한 내용은 Amazon DCV 세션 관리자 요구 사항 섹션을 참조하세요.

사전 조건

에이전트를 설치하기 전에 Amazon DCV 서버를 호스트에 설치해야 합니다.

Linux host
참고

세션 관리자 에이전트는 요구 사항에 나열된 Linux 배포판 및 아키텍처에서 사용할 수 있습니다.

다음은 64비트 x86 호스트에 에이전트를 설치하기 위한 안내입니다. 64비트 ARM 호스트에 에이전트를 설치하려면 x86_64를 aarch64로 바꿉니다. Ubuntu의 경우 amd64를 arm64로 바꿉니다.

Linux 호스트에 에이전트를 설치하려면 다음과 같이 하세요.

  1. 패키지는 안전한 GPG 서명으로 디지털 서명됩니다. 패키지 관리자가 패키지 서명을 확인할 수 있도록 하려면 Amazon DCV GPG 키를 가져와야 합니다. 다음 명령을 실행하여 Amazon DCV GPG 키를 가져옵니다.

    • Amazon Linux 2, RHEL, CentOS, SUSE Linux Enterprise

      $ sudo rpm --import https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY

    • Ubuntu

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY
      $ gpg --import NICE-GPG-KEY

  2. 설치 패키지를 다운로드합니다.

    • Amazon Linux 2

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.801-1.el7.x86_64.rpm

    • Amazon Linux 2023

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.amzn2023.x86_64.rpm

    • RHEL 8.x 및 Rocky Linux 8.x

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.el8.x86_64.rpm

    • CentOS 9.x, RHEL 9.x, Rocky Linux 9.x

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.el9.x86_64.rpm

    • Ubuntu 20.04

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2004.deb

    • Ubuntu 22.04

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2204.deb

    • Ubuntu 24.04

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2404.deb

    • SUSE Linux Enterprise 12

      $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.sles12.x86_64.rpm

    • SUSE Linux Enterprise 15

      $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.sles15.x86_64.rpm

  3. 패키지를 설치합니다.

    • Amazon Linux 2

      $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.el7.x86_64.rpm

    • Amazon Linux 2023

      $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.amzn2023.x86_64.rpm

    • RHEL 8.x 및 Rocky Linux 8.x

      $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.el8.x86_64.rpm

    • CentOS 9.x, RHEL 9.x, Rocky Linux 9.x

      $  sudo yum install -y ./nice-dcv-session-manager-agent-2025.0.888-1.el9.x86_64.rpm

    • Ubuntu 20.04

      $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2004.deb

    • Ubuntu 22.04

      $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2204.deb

    • Ubuntu 24.04

      $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2404.deb

    • SUSE Linux Enterprise 12

      $ sudo zypper install ./nice-dcv-session-manager-agent-2025.0.888-1.sles12.x86_64.rpm

    • SUSE Linux Enterprise 15

      $ sudo zypper install ./nice-dcv-session-manager-agent-2025.0.888-1.sles15.x86_64.rpm

  4. 브로커의 자체 서명 인증서 사본(이전 단계에서 복사한 사본)을 에이전트의 /etc/dcv-session-manager-agent/ 디렉터리에 저장합니다.

  5. 선호하는 텍스트 편집기를 사용하여 /etc/dcv-session-manager-agent/agent.conf를 열고 다음과 같이 진행합니다.

    • broker_host의 경우 브로커가 설치된 호스트의 DNS 이름을 지정합니다.

      중요

      브로커가 Amazon EC2 인스턴스에서 실행 중인 경우 broker_host에 인스턴스의 프라이빗 IPv4 주소를 지정해야 합니다.

    • (선택 사항) broker_port에 브로커와 통신하는 데 사용할 포트를 지정합니다. 기본적으로 에이전트와 브로커는 8445 포트를 통해 통신합니다. 다른 포트를 사용해야 하는 경우에만 이 값을 변경합니다. 변경할 경우 브로커가 동일한 포트를 사용하도록 구성되어 있는지 확인하세요.

    • ca_file에는 이전 단계에서 복사한 인증서 파일의 전체 경로를 지정합니다. 예: 

      ca_file = '/etc/dcv-session-manager-agent/broker_cert.pem'

      또는 TLS 확인을 비활성화하려면 tls_strict를 false로 설정합니다.

  6. 파일을 저장하고 닫습니다.

  7. 다음 명령을 실행하여 에이전트를 시작합니다.

    $ sudo systemctl start dcv-session-manager-agent
Windows host
Windows 호스트에 에이전트를 설치하려면 다음과 같이 하세요.

  1. 에이전트 설치 프로그램을 다운로드합니다.

  2. 설치 관리자를 실행합니다. 시작 화면에서 다음을 선택합니다.

  3. EULA 화면에서 라이선스 계약을 주의 깊게 읽어보고, 약관에 동의하는 경우 약관에 동의함을 선택하고 다음을 클릭합니다.

  4. 설치를 시작하려면 설치를 클릭합니다.

  5. 브로커의 자체 서명 인증서 사본(이전 단계에서 복사한 사본)을 에이전트의 C:\Program Files\NICE\DCVSessionManagerAgent\conf\ 폴더에 저장합니다.

  6. 선호하는 텍스트 편집기를 사용하여 C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf를 열고 다음과 같이 진행합니다.

    • broker_host의 경우 브로커가 설치된 호스트의 DNS 이름을 지정합니다.

      중요

      브로커가 Amazon EC2 인스턴스에서 실행 중인 경우 broker_host에 인스턴스의 프라이빗 IPv4 주소를 지정해야 합니다.

    • (선택 사항) broker_port에 브로커와 통신하는 데 사용할 포트를 지정합니다. 기본적으로 에이전트와 브로커는 8445 포트를 통해 통신합니다. 다른 포트를 사용해야 하는 경우에만 이 값을 변경합니다. 변경할 경우 브로커가 동일한 포트를 사용하도록 구성되어 있는지 확인하세요.

    • ca_file에는 이전 단계에서 복사한 인증서 파일의 전체 경로를 지정합니다. 예: 

      ca_file = 'C:\Program Files\NICE\DCVSessionManagerAgent\conf\broker_cert.pem'

      또는 TLS 확인을 비활성화하려면 tls_strict를 false로 설정합니다.

  7. 파일을 저장하고 닫습니다.

  8. 변경 사항이 적용되도록 에이전트 서비스를 중지했다가 다시 시작합니다. 명령 프롬프트에서 다음 명령을 실행합니다.

    C:\> sc stop DcvSessionManagerAgentService
    C:\> sc start DcvSessionManagerAgentService
macOS host
macOS 호스트에 에이전트를 설치하려면

  1. 에이전트 설치 관리자를 다운로드하거나 명령줄을 사용합니다.

    $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg

  2. 패키지를 설치합니다. 명령줄 또는 에이전트 설치 관리자를 통해 다음을 사용할 수 있습니다.

    • 명령줄:

      $ sudo installer -pkg ./nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg -target /

    • 에이전트 설치 관리자: .pkg 파일을 두 번 클릭하고 설치 마법사를 따릅니다.

  3. 브로커의 자체 서명 인증서 사본(이전 단계에서 복사한 사본)을 에이전트의 /etc/dcv-session-manager-agent/ 디렉터리에 저장합니다.

  4. 선호하는 텍스트 편집기를 사용하여 /etc/dcv-session-manager-agent/agent.conf를 열고 다음과 같이 진행합니다.

    • broker_host의 경우 브로커가 설치된 호스트의 DNS 이름을 지정합니다.

      중요

      브로커가 Amazon EC2 인스턴스에서 실행 중인 경우 broker_host에 인스턴스의 프라이빗 IPv4 주소를 지정해야 합니다.

    • (선택 사항) broker_port에 브로커와 통신하는 데 사용할 포트를 지정합니다. 기본적으로 에이전트와 브로커는 8445 포트를 통해 통신합니다. 다른 포트를 사용해야 하는 경우에만 이 값을 변경합니다. 변경할 경우 브로커가 동일한 포트를 사용하도록 구성되어 있는지 확인하세요.

    • ca_file에는 이전 단계에서 복사한 인증서 파일의 전체 경로를 지정합니다. 예: 

      ca_file = '/usr/local/etc/dcv-session-manager-agent/broker_cert.pem'

      또는 TLS 확인을 비활성화하려면 tls_strict를 false로 설정합니다.

  5. 파일을 저장하고 닫습니다.

  6. 에이전트 서비스를 시작합니다.

    $ sudo launchctl load /Library/LaunchDaemons/com.amazon.dcv.session-manager.agent.plist