에이전트 구성 파일

포커스 모드

에이전트 구성 파일 - Amazon DCV 세션 관리자

에이전트 구성 파일(Linux용 /etc/dcv-session-manager-agent/agent.conf, Windows용 C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf)에는 세션 관리자 기능을 사용자 지정하도록 구성할 수 있는 파라미터가 포함되어 있습니다. 원하는 텍스트 편집기를 사용하여 구성 파일을 편집할 수 있습니다.

다음 표에는 에이전트 구성 파일의 파라미터가 나열되어 있습니다.

파라미터 이름	필수	기본값	Description
`agent.broker_host`	예		브로커 호스트의 DNS 이름을 지정합니다.
`agent.broker_port`	예	`8445`	브로커와 통신할 포트를 지정합니다.
`agent.ca_file`	아니요		`tls_strict`가 `true`로 설정된 경우에만 필요합니다. TLS 인증서를 검증하는 데 필요한 인증서(.pem) 파일의 경로를 지정합니다. 브로커에서 에이전트로 자체 서명된 인증서를 복사합니다.
`agent.init_folder`	아니요	`/var/lib/dcv-session-manager-agent/init`(Linux)	Amazon DCV 서버 세션을 만들 때 초기화할 수 있는 사용자 지정 스크립트를 저장하는 데 사용되는 호스트 서버의 폴더 경로를 지정합니다. 절대 경로를 지정해야 합니다. CreateSessions API의 InitFile 요청 파라미터를 사용하는 사용자가 폴더에 접근할 수 있고 파일을 실행할 수 있어야 합니다.
`agent.tls_strict`	아니요	`true`	엄격한 TLS 검증을 사용해야 하는지 여부를 나타냅니다.
`agent.software_statement_path`	아니요		기본 소프트웨어 명령문을 사용하지 않는 경우에만 필요합니다. 소프트웨어 명령문 파일의 경로를 지정합니다. 자세한 내용은 generate-software-statement 단원을 참조하십시오.
`agent.tags_folder`	아니요	`/etc/dcv-session-manager-agent`(Linux) `C:\Program Files\NICE\DCVSessionManagerAgent\conf\tags`(Windows)	태그 파일이 있는 폴더의 경로를 지정합니다. 자세한 내용은 태그를 사용하여 Amazon DCV 서버를 대상으로 지정 단원을 참조하십시오.
`agent.autorun_folder`	아니요	`/var/lib/dcv-session-manager-agent/autorun`(Linux) `C:\ProgramData\NICE\DcvSessionManagerAgent\autorun`(Windows)	세션 시작 시 자동으로 실행되도록 허용된 스크립트와 앱을 저장하는 데 사용되는 호스트 서버의 폴더 경로를 지정합니다. 절대 경로를 지정해야 합니다. CreateSessions API의 AutorunFile 요청 파라미터를 사용하는 사용자가 폴더에 접근할 수 있고 파일을 실행할 수 있어야 합니다.
`agent.max_virtual_sessions`	아니요	-1 (제한 없음)	Amazon DCV 세션 관리자를 사용하여 Amazon DCV 서버에 생성할 수 있는 최대 가상 세션 수입니다.
`agent.max_concurrent_sessions_per_user`	아니요	1	Amazon DCV 세션 관리자를 사용하여 단일 사용자가 Amazon DCV 서버에 생성할 수 있는 최대 가상 세션 수입니다.
`agent.broker_update_interval`	아니요	30	업데이트된 데이터를 브로커에 전송하기 전에 대기할 시간(초)을 지정합니다. 전송된 데이터에는 업데이트된 세션 정보뿐만 아니라 Amazon DCV 서버 및 호스트 상태가 포함됩니다. 값이 낮을수록 세션 관리자는 에이전트가 실행되는 시스템에서 발생하는 변경 사항을 더 잘 인식하지만, 시스템 부하와 네트워크 트래픽이 증가합니다. 값이 높을수록 시스템 및 네트워크 부하가 감소하지만, 시스템 변경에 대한 세션 관리자의 응답성이 떨어지므로 `120`보다 큰 값은 사용하지 않는 것이 좋습니다.
`log.level`	아니요	`info`	로그 파일 세부 수준을 지정합니다. 다음 세부 수준을 사용할 수 있습니다. `error` - 최소 세부 정보를 제공합니다. 오류만 포함합니다. `warning` - 오류와 경고를 포함합니다. `info` - 기본 세부 수준입니다. 오류, 경고 및 정보 메시지를 포함합니다. `debug` - 최대 세부 정보를 제공합니다. 문제를 디버깅하는 데 유용한 세부 정보를 제공합니다.
`log.directory`	아니요	`/var/log/dcv-session-manager-agent/`(Linux) `C:\ProgramData\NICE\DCVSessionManagerAgent\log`(Windows)	로그 파일을 생성할 디렉터리를 지정합니다.
`log.rotation`	아니요	`daily`	로그 파일 순환을 지정합니다. 유효한 값은 다음과 같습니다. `hourly` - 로그 파일이 매시간 순환됩니다. `daily` - 로그 파일이 매일 순환됩니다.
`log.max-file-size`	아니요	`10485760`	로그 파일 크기가 지정된 크기(바이트 단위)에 도달하면 파일이 순환됩니다. 새 로그 파일이 생성되고 새 파일에 추가 로그 이벤트가 배치됩니다.
`log.rotate`	아니요	`9`	순환에서 보존되는 최대 로그 파일 수입니다. 순환이 발생하고 이 수에 도달할 때마다 가장 오래된 로그 파일이 삭제됩니다.