기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DCV 세션 시작
기본값을 사용하여 [Windows Amazon DCV 서버를 설치](setting-up-installing-wininstall.md)하면 서버가 설치된 후 [콘솔 세션](managing-sessions-intro.md#managing-sessions-intro-console)이 자동으로 생성되고 활성화됩니다. 기본 콘솔 세션은 `Administrator`가 소유하며, 기본 세션 ID는 `console`입니다. 이 세션을 사용할 수도 있고, 세션을 [종료하고](managing-sessions-lifecycle-stop.md) 새 세션을 생성할 수도 있습니다.
Amazon DCV 서버를 설치할 때 콘솔 세션이 자동으로 생성되지 않도록 선택한 경우, 콘솔 세션을 수동으로 생성해야 합니다. 또한 Amazon DCV 서버를 설치한 후 언제든지 [자동 콘솔 세션 생성](#managing-sessions-start-auto)을 활성화하거나 비활성화할 수 있습니다.
**참고**
Linux 및 macOS Amazon DCV 서버는 설치 후 기본 콘솔 세션을 가져오지 않습니다.
온프레미스 또는 대체 클라우드 기반 서버에서 부동 라이선스를 사용 중인 상황에서 라이선스가 지원하는 최대 동시 세션 수를 초과했다고 가정해 보겠습니다. 이때 `no licenses` 오류가 발생할 수 있습니다. 이 오류가 발생한 경우 사용하지 않는 세션을 중지하여 라이선스를 해제하고 다시 시도합니다.
세션을 시작하려면 Amazon DCV 서버가 실행되고 있어야 합니다. 자세한 내용은 [Amazon DCV 서버 시작](manage-start.md) 단원을 참조하십시오.
**Topics**
+ [콘솔 및 가상 세션 수동 시작](#managing-sessions-start-manual)
+ [자동 콘솔 세션 활성화](#managing-sessions-start-auto)
## 콘솔 및 가상 세션 수동 시작
언제든지 Amazon DCV 서버를 시작할 수 있습니다. 한 번에 콘솔 세션 하나만 실행할 수 있습니다. Linux Amazon DCV 서버를 사용하는 경우 여러 가상 세션을 동시에 실행할 수 있습니다.
특히 Windows Amazon DCV 서버를 사용하는 경우 세션을 생성하기 전에 `dcv list-sessions`를 실행하는 것이 좋습니다.
Windows, Linux 또는 macOS Amazon DCV 서버에서 콘솔 또는 가상 세션을 생성하려면 `dcv create-session` 명령을 사용합니다.
**Topics**
+ [구문](#managing-sessions-start-manual-syntax)
+ [옵션](#managing-sessions-start-manual-options)
+ [예제](#managing-sessions-start-manual-examples)
### 구문
세션을 시작하기 위한 명령의 최소 구문은 다음과 같습니다.
```
dcv create-session {{session_ID}}
```
모든 옵션이 포함된 전체 구문은 다음과 같습니다.
```
dcv create-session \
--type {{console|virtual}} \
--name {{session_name}} \
--user {{username}} \
--owner {{owner_name}} \
--permissions-file {{/path_to/permissions_file}} \
--storage-root {{/path_to/storage_directory}} \
--gl {{on|off}} \
--max-concurrent-clients {{number_of_clients}} \
--init {{/path_to/init_script}} \
{{session_ID}}
```
**참고**
`\` 기호는 구문에서 명령을 여러 줄로 분할하는 것을 나타냅니다.
`dcv create-session --help`를 사용하여 구문에 대한 빠른 참조를 표시할 수도 있습니다.
### 옵션
`dcv create-session` 명령과 함께 다음 옵션을 사용할 수 있습니다.
**`--type`**
이 옵션은 Linux Amazon DCV 서버에서만 지원됩니다. 이 옵션은 만들 세션 유형을 지정합니다. 세션 유형은 `console` 또는 `virtual`일 수 있습니다.
유형: 문자열
허용된 값: `console` \| `virtual`
필수 여부: 아니요
**`--name`**
세션의 이름을 지정합니다. 세션 이름은 최대 256자의 문자열로 지정할 수 있습니다. 문자열이 256자를 초과하면 명령이 실패합니다. 세션 이름은 실행 중인 세션에서 고유하지 않아도 됩니다.
언제든지 `dcv set-name` 명령을 사용하여 세션 이름을 변경할 수 있습니다. 자세한 내용은 [세션 이름 관리](managing-session-name.md) 단원을 참조하십시오.
유형: 문자열
필수 항목 여부: 예
**`--user`**
이 옵션은 Linux Amazon DCV의 가상 세션에서만 지원됩니다. 이 값은 세션을 만드는 데 사용할 사용자입니다. 루트 사용자만 다른 사용자를 가장할 수 있습니다.
유형: 문자열
필수 항목 여부: 아니요
**`--owner`**
세션 소유자를 지정합니다. 생략할 경우 현재 로그인한 사용자로 기본 설정됩니다.
유형: 문자열
필수 항목 여부: 아니요
**`--permissions-file`**
사용자 지정 권한 파일 경로를 지정합니다. 생략할 경우 서버 기본값이 기본 설정됩니다.
유형: 문자열
필수 항목 여부: 아니요
**`--storage-root`**
세션 스토리지에 사용되는 폴더 경로를 지정합니다.
`%home%`를 사용하여 현재 로그인되어 있는 사용자의 홈 디렉터리를 지정할 수 있습니다. 예를 들어, 다음은 세션 스토리지를 위한 디렉터리를 Windows 서버의 경우 `c:\Users\{{username}}\storage\`, Linux 서버의 경우 `$HOME/storage/`로 설정합니다.
```
--storage-root %home%/storage/
```
지정된 하위 디렉터리가 없으면 세션 스토리지가 비활성화됩니다.
유형: 문자열
필수 항목 여부: 아니요
**`--gl`**
이 옵션은 Linux Amazon DCV의 가상 세션에서만 지원됩니다. 기본 `dcv-gl` 상태를 재정의하며, `on` 또는 `off`일 수 있습니다.
유형: 문자열
허용된 값: `on` \| `off`
필수 여부: 아니요
**`--max-concurrent-clients`**
세션에 연결하도록 허용된 최대 Amazon DCV 클라이언트 수를 지정합니다. 생략할 경우 무제한 연결이 기본 설정됩니다.
유형: 정수
필수 항목 여부: 아니요
**`--init`**
이 옵션은 Linux Amazon DCV 서버의 가상 세션에서만 지원됩니다. 사용자 지정 `init` 스크립트 경로를 지정합니다. 스크립트를 사용하여 세션을 시작할 때 특정 데스크톱 환경을 시작하고 특정 애플리케이션을 자동으로 시작할 수 있습니다. 스크립트는 실행 가능해야 합니다. 생략할 경우 기본 데스크톱 환경을 시작하는 스크립트로 기본 설정됩니다.
유형: 문자열
필수 항목 여부: 아니요
**`{{session ID}}`**
명령 종료 시 세션의 ID를 제공합니다.
유형: 문자열
필수 항목 여부: 예
### 예제
**예제 1 - 콘솔 세션**
다음 명령은 소유자가 `dcv-user`이고 고유 세션 ID가 `my-session`이며 이름이 `my graphics session`인 세션을 생성합니다. 또한 이 명령은 `perm-file.txt`라는 권한 파일을 지정합니다.
+ Windows Amazon DCV 서버
```
C:\> dcv create-session^
--owner {{dcv-user}}^
--name "{{my graphics session}}"^
--permissions-file {{perm-file.txt}}^
{{my-session}}
```
+ Linux Amazon DCV 서버
```
$ sudo dcv create-session \
--type={{console}} \
--owner {{dcv-user}} \
--name "{{my graphics session"}} \
--permissions-file {{perm-file.txt}} \
{{my-session}}
```
**예제 2 - 가상 세션(Linux Amazon DCV 서버만 해당)**
다음 명령은 루트 사용자를 통해 가상 세션을 생성하여 의도된 세션 소유자인 `dcv-user`를 가장합니다. 루트 사용자가 생성한 세션일지라도 소유자는 `dcv-user`입니다.
```
$ sudo dcv create-session \
--owner {{dcv-user}} \
--user {{dcv-user}} \
{{my-session}}
```
**예제 3 - 가상 세션(Linux Amazon DCV 서버만 해당)**
다음 명령은 세션을 생성한 사용자가 소유하는 가상 세션을 생성합니다.
```
$ dcv create-session {{my-session}}
```
## 자동 콘솔 세션 활성화
자동 콘솔 세션을 활성화하면 Amazon DCV 서버를 시작할 때마다 콘솔 세션이 자동으로 생성됩니다. 자동 콘솔 세션은 `owner` 구성 파라미터로 지정된 Amazon DCV 사용자가 소유합니다. 세션 ID는 항상 `console`입니다.
자동 콘솔 세션에 영향을 미치는 다른 파라미터로는 `max-concurrent-clients`, `permissions-file`, 및 `storage-root`가 있습니다. 이런 파라미터에 대한 자세한 내용은 [`session-management/automatic-console-session` 파라미터](config-param-ref.md#session_management_automatic_console_session) 섹션을 참조하세요.
**참고**
Amazon DCV는 자동 가상 세션을 지원하지 않습니다.
------
#### [ Windows Amazon DCV server ]
**Windows Amazon DCV 서버에서 자동 콘솔 세션을 활성화하려면 다음과 같이 하세요.**
1. Windows 레지스트리 편집기를 엽니다.
1. **HKEY\_USERS\\S-1-5-18\\Software\\GSettings\\com\\nicesoftware\\dcv\\session-management** 키로 이동합니다.
1. `create-session` 파라미터를 생성합니다.
1. 탐색 창에서 **session-management** 키의 컨텍스트(마우스 오른쪽 클릭) 메뉴를 열고 **새로 만들기**, **DWORD(32비트) 값**을 선택합니다.
1. **이름**에 `create-session`을 입력하고 **Enter** 키를 누릅니다.
1. **create-session** 파라미터를 엽니다. **Value data(값 데이터)**에 `1`을 입력하고 **확인**을 선택합니다.
1. **HKEY\_USERS\\S-1-5-18\\Software\\GSettings\\com\\nicesoftware\\dcv\\session-management/automatic-console-session** 키로 이동합니다.
1. `owner` 파라미터를 생성합니다.
1. 탐색 창에서 **automatic-console-session** 키의 컨텍스트(마우스 오른쪽 클릭) 메뉴를 열고 **새로 만들기**, **문자열 값**을 선택합니다.
1. **이름**에 `owner`을 입력하고 **Enter** 키를 누릅니다.
1. **소유자** 파라미터를 엽니다. **Value data(값 데이터)**에 세션 소유자의 이름을 입력하고 **확인**을 선택합니다.
1. **확인**을 선택하고 Windows 레지스트리 편집기를 닫습니다.
1. Amazon DCV 서버를 [중지](manage-stop.md)하고 [다시 시작](manage-start.md)합니다.
------
#### [ Linux Amazon DCV server ]
**Linux Amazon DCV 서버에서 자동 콘솔 세션을 활성화하려면 다음과 같이 하세요.**
1. `/etc/dcv/`로 이동하고 원하는 텍스트 편집기에서 `dcv.conf`를 엽니다.
1. 다음 형식을 사용하여 `create-session` 섹션에 `owner` 및 `[session-management/automatic-console-session]` 파라미터를 추가합니다.
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="{{session-owner}}"
```
1. 파일을 저장하고 닫습니다.
1. Amazon DCV 서버를 [중지](manage-stop.md)하고 [다시 시작](manage-start.md)합니다.
------
#### [ macOS Amazon DCV server ]
**macOS Amazon DCV 서버에서 자동 콘솔 세션을 활성화하려면**
1. `/etc/dcv/`로 이동하고 원하는 텍스트 편집기에서 `dcv.conf`를 엽니다.
1. 다음 형식을 사용하여 `create-session` 섹션에 `owner` 및 `[session-management/automatic-console-session]` 파라미터를 추가합니다.
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="{{session-owner}}"
```
1. 파일을 저장하고 닫습니다.
1. Amazon DCV 서버를 [중지](manage-stop.md)하고 [다시 시작](manage-start.md)합니다.
------