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

# 활성 Amazon DCV 세션 관리
<a name="managing-running-session"></a>

클라이언트가 로그인하여 DCV 세션을 사용하기 시작하면 해당 세션은 활성 상태로 간주됩니다. 세션이 활성 상태인 동안에도 특정 관리 작업을 수행할 수 있습니다. 이 섹션에서는 클라이언트에서 이러한 세션이 아직 사용 중인 동안, 해당 세션의 파라미터를 관리하는 데 필요한 정보를 제공합니다.

**Topics**
+ [세션 스토리지 관리](managing-session-storage.md)
+ [세션 권한 부여 관리](managing-session-perms.md)
+ [세션 표시 레이아웃 관리](managing-session-display.md)
+ [세션 이름 관리](managing-session-name.md)
+ [유휴 세션 찾기 및 중지](stop-idle-sessions.md)

# Amazon DCV 세션 스토리지 관리
<a name="managing-session-storage"></a>

세션 스토리지는 클라이언트가 Amazon DCV 세션에 연결되어 있을 때 액세스할 수 있는 Amazon DCV 서버의 디렉터리입니다.

Amazon DCV 서버에서 세션 스토리지가 활성화된 경우 `dcv set-storage-root` 명령을 사용하여 세션 스토리지에 사용할 디렉터리를 지정할 수 있습니다. Amazon DCV 서버에서 세션 스토리지를 활성화하는 방법에 대한 자세한 내용은 [세션 스토리지 활성화](manage-storage.md) 섹션을 참조하세요.

세션 스토리지 경로를 설정하려면 `dcv set-storage-root` 명령을 사용하여 세션 ID와 사용할 디렉터리의 경로를 지정합니다.

**Topics**
+ [구문](#managing-session-storage-syntax)
+ [옵션](#managing-session-storage-options)
+ [예제](#session-storage-example)

## 구문
<a name="managing-session-storage-syntax"></a>

```
dcv set-storage-root --session session_id /path_to/directory
```

디렉터리 경로의 경우 `%home%`을 사용하여 현재 로그인되어 있는 사용자의 홈 디렉터리를 지정할 수 있습니다. 예를 들어, `%home%/storage/` 경로는 Windows 서버에서 `c:\Users\username\storage\`로 확인됩니다. Linux 서버에서는 `$HOME/storage/`로 확인됩니다.

**참고**  
`storage-root` 값은 macOS의 절대 경로여야 합니다.

## 옵션
<a name="managing-session-storage-options"></a>

`dcv set-storage-root` 명령과 함께 다음 옵션을 사용할 수 있습니다.

**`--session`**  
스토리지 디렉터리를 지정하는 데 사용할 세션 ID입니다.  
유형: 문자열  
필수 항목 여부: 예

## 예제
<a name="session-storage-example"></a>

**Windows Amazon DCV 서버 예제**  
다음 예제에서는 세션 ID가 `my-session`인 세션의 스토리지 경로로 `c:\session-storage`를 설정합니다.

```
C:\> dcv set-storage-root --session my-session c:\session-storage
```

**Linux Amazon DCV 서버 예제**  
다음 예제에서는 세션 ID가 `my-session`인 세션에 대해 스토리지 경로를 현재 사용자의 홈 디렉터리의 `session-storage`라는 디렉터리로 설정합니다.

```
$ dcv set-storage-root --session my-session %home%/session-storage/
```

# Amazon DCV 세션의 권한 부여 관리
<a name="managing-session-perms"></a>

권한 부여는 Amazon DCV 클라이언트에 특정 Amazon DCV 기능에 대한 권한을 부여하거나 거부하는 데 사용됩니다. 권한 부여는 일반적으로 Amazon DCV 세션이 시작될 때 구성됩니다. 그러나 실행 중인 세션에 대한 권한을 편집할 수 있습니다. Amazon DCV 권한 부여에 대한 자세한 내용은 [Amazon DCV 권한 부여 구성](security-authorization.md) 섹션을 참조하세요.

실행 중인 세션에 대한 권한을 수정하려면 `dcv set-permissions` 명령을 사용하세요.

**Topics**
+ [구문](#managing-session-perms-syntax)
+ [옵션](#managing-session-perms-options)
+ [예제](#session-perms-example)

## 구문
<a name="managing-session-perms-syntax"></a>

```
dcv set-permissions --session session-id --none | --reset-builtin | --file /path_to/permissions_file
```

`--none`, `--reset-builtin` 또는 `--file`을 지정해야 합니다.

## 옵션
<a name="managing-session-perms-options"></a>

`dcv set-permissions` 명령과 함께 다음 옵션을 사용할 수 있습니다.

**--session**  
권한을 설정할 세션의 ID를 지정합니다.

**--reset-builtin**  
세션의 권한을 기본 세션 권한으로 재설정합니다. 기본 권한은 세션 소유자에게만 모든 기능에 대한 전체 액세스 권한을 부여합니다.

**--none**  
세션에 대한 모든 권한을 취소합니다.

**--file**  
사용자 지정 권한 파일 경로를 지정합니다. 지정한 파일이 비어 있으면 모든 권한이 취소됩니다. 사용자 지정 권한 파일 작성에 대한 자세한 내용은 [권한 파일 이해](security-authorization-file-create.md) 단원을 참조하십시오.

## 예제
<a name="session-perms-example"></a>

**예제 1 - 모든 권한 취소**  
다음 예제에서는 ID가 `my-session`인 세션에 대한 모든 클라이언트 권한을 취소합니다.

```
C:\> dcv set-permissions --session my-session --none
```

**예제 2 - 사용자 지정 권한 지정**  
다음 예제에서는 ID가 `my-session`인 세션에 대해 `perm-file.txt`라는 사용자 지정 권한 파일을 지정합니다. 이 파일은 `c:\dcv\` 디렉터리에 위치합니다.

```
C:\> dcv set-permissions --session my-session --file c:\dcv\perm-file.txt
```

**예제 3 - 권한 재설정**  
다음 예제에서는 ID가 `my-session`인 세션의 권한을 기본값으로 재설정합니다.

```
C:\> dcv set-permissions --session my-session --reset-builtin
```

# Amazon DCV 세션 표시 레이아웃 관리
<a name="managing-session-display"></a>

Amazon DCV 세션 실행에 대한 표시 레이아웃을 설정할 수 있습니다. 표시 레이아웃은 클라이언트가 세션에 연결할 때 사용되는 기본 구성을 지정합니다. 그러나 클라이언트는 Amazon DCV 클라이언트 설정 또는 기본 운영 체제 표시 설정을 사용하여 레이아웃을 수동으로 재정의할 수 있습니다.

호스트 서버의 하드웨어 및 소프트웨어 구성이 지정된 해상도 또는 화면 수를 지원하지 않는 경우 Amazon DCV 서버는 지정된 표시 레이아웃을 적용하지 않습니다.

Amazon DCV는 설정 및 서버 시스템 구성에 따라 해상도를 구성할 수 있습니다.
+ 웹 클라이언트 해상도는 기본적으로 (Web-client-max-head-resolution 서버 설정에서) 1,920x1,080으로 제한됩니다.
+ 네이티브 클라이언트는 기본적으로 (max-head-resolution에서) 4,096x2,160으로 제한됩니다.

사용 가능한 해상도와 모니터 수는 서버 구성에 따라 다르므로, 시스템 환경과 드라이버를 최적의 성능을 위해 올바르게 설정하려면 [사전 조건 가이드](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing.html)를 따르세요.

**참고**  
네이티브 클라이언트의 경우는 최대 4개의 모니터를 사용할 수 있습니다.  
웹 클라이언트의 경우는 최대 2개의 모니터를 사용할 수 있습니다.  
해상도가 더 높거나 모니터가 최댓값을 초과하는 경우, 어떤 구성에서도 지원되지 않습니다.

**Topics**
+ [표시 레이아웃에 액세스](#display-restrict)
+ [표시 레이아웃 설정](#dislay-set)
+ [표시 레이아웃 보기](#dislay-view)

## 표시 레이아웃에 액세스
<a name="display-restrict"></a>

클라이언트가 지정된 범위를 벗어나는 표시 레이아웃을 요청하지 않도록 Amazon DCV 서버를 구성할 수 있습니다. 표시 레이아웃 변경을 제한하려면 다음 Amazon DCV 서버 파라미터를 구성합니다.
+ [`enable-client-resize`](config-param-ref.md#paramref.display.enable-client-resize) - 클라이언트가 표시 레이아웃을 변경하지 못하도록 하려면 이 파라미터를 `false`로 설정합니다.
+ [`min-head-resolution`](config-param-ref.md#paramref.display.min-head-resolution) 및 [`max-head-resolution`](config-param-ref.md#paramref.display.max-head-resolution) - 허용되는 최소 해상도와 최대 해상도를 각각 지정합니다.
+ [`web-client-max-head-resolution`](config-param-ref.md#paramref.display.web-client-max-head-resolution) - 웹 브라우저 클라이언트에 허용되는 최대 해상도를 지정합니다. `max-head-resolution` 제한은 `web-client-max-head-resolution` 제한에 추가로 적용됩니다. 기본적으로 웹 브라우저 클라이언트의 최대 해상도는 1,920x1,080입니다. 더 높은 해상도를 지정하면 웹 브라우저와 클라이언트 컴퓨터의 사양에 따라 성능 문제가 발생할 수 있습니다.
+ [`max-num-heads`](config-param-ref.md#paramref.display.max-num-heads) - 최대 디스플레이 수를 지정합니다.
+ `max-layout-area` - 화면 영역에 허용되는 최대 픽셀 수를 지정합니다. 픽셀 단위로 표현된 총 화면 영역이 지정된 값을 초과하는 요청은 무시됩니다.

이러한 파라미터에 대한 자세한 내용은 파라미터 참조의 [`display` 파라미터](config-param-ref.md#display) 단원을 참고하십시오.

## 표시 레이아웃 설정
<a name="dislay-set"></a>

**실행 중인 Amazon DCV 세션의 표시 레이아웃을 구성하려면 다음과 같이 하세요.**  
`dcv set-display-layout` 명령을 사용하여 표시 레이아웃 및 표시 레이아웃 설명자를 설정할 세션을 지정합니다.

```
dcv set-display-layout --session session-id display-layout-descriptor
```

표시 레이아웃 설명자는 디스플레이의 수와 각 디스플레이의 해상도 및 위치 오프셋을 지정합니다. 설명은 다음 형식으로 지정해야 합니다.

```
widthxheight+|-x-position-offset+|-y-position-offset
```

화면을 두 개 이상 지정하는 경우 화면 설명자를 쉼표로 구분합니다. 화면 위치 오프셋은 화면 1을 기준으로 화면의 왼쪽 위 모서리의 위치를 지정합니다. 스크린에 대한 위치 오프셋을 지정하지 않으면 기본값은 x=0, y=0입니다.

**중요**  
둘 이상의 스크린을 지정하는 경우 화면 겹침이 발생하지 않도록 각 스크린의 위치 오프셋을 올바르게 설정해야 합니다.

예를 들어, 다음 표시 레이아웃 설명자는 두 개의 스크린을 지정합니다.
+ 화면 1: 1,920x1,080 해상도 오프셋을 x=0, y=0으로 설정합니다.
+ 화면 2: 화면 1의 오른쪽에 나타나도록 800x600 해상도 오프셋을 x=1920, y=0으로 설정합니다.

![\[두 개의 화면이 있는 화면 레이아웃\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/adminguide/images/eg2.png)


```
1920x1080+0+0,800x600+1920+0
```

다음 표시 레이아웃 기술자는 세 개의 화면을 지정합니다.
+ 화면 1: 1,920x1,080 해상도 오프셋을 x=0, y=0으로 설정합니다.
+ 화면 2: 화면 1의 오른쪽에 나타나도록 1,920x1,080 해상도 오프셋을 x=1920, y=0으로 설정합니다.
+ 화면 3: 화면 1의 왼쪽에 나타나도록 1024x768 해상도 오프셋을 x=-1024, y=0으로 설정합니다.

![\[세 개의 화면이 있는 화면 레이아웃\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/adminguide/images/eg1.png)


```
1920x1080+0+0,1920x1080+1920+0,1024x768-1024+0
```

## 표시 레이아웃 보기
<a name="dislay-view"></a>

**세션에 대한 표시 레이아웃을 보려면**  
`dcv describe-session` 명령을 사용하여 출력의 `display layout` 요소를 검토합니다. 자세한 내용은 [Amazon DCV 세션 보기](managing-sessions-lifecycle-view.md) 단원을 참조하십시오.

# 세션 이름 관리
<a name="managing-session-name"></a>

실행 중인 세션의 이름은 언제든지 변경이 가능합니다. 세션의 특정 이름을 사용하여 해당 이름을 기반으로 세션을 빠르게 식별할 수 있습니다. 세션 이름은 실행 중인 세션에서 고유하지 않아도 됩니다.

실행 중인 세션의 이름을 변경하려면 `dcv set-name` 명령을 사용합니다.

**Topics**
+ [구문](#managing-session-name-syntax)
+ [옵션](#managing-session-name-options)
+ [예제](#example)

## 구문
<a name="managing-session-name-syntax"></a>

```
$ dcv set-name --session session_id --none |--name "session-name"
```

`--name` 또는 `--none`를 지정해야 합니다.

## 옵션
<a name="managing-session-name-options"></a>

`dset-name` 명령과 함께 다음 옵션을 사용할 수 있습니다.

**`--session`**  
이름을 설정할 세션의 ID입니다.  
유형: 문자열  
필수 항목 여부: 예

**`--name`**  
세션에 할당할 이름입니다. 세션에 이름을 할당하려는 경우에만 이 옵션을 지정하세요. 이름을 제거하려면 이 파라미터를 생략하세요. 이름은 최대 256자까지 지정할 수 있습니다. 이름에는 문자, 숫자 및 특수 문자를 포함할 수 있습니다. 지정된 문자열이 256자를 초과하면 명령이 실패합니다.  
유형: 문자열  
필수 항목 여부: 아니요

**`--none`**  
세션에서 기존 이름을 제거하려면 이 파라미터를 지정하세요. 세션 이름을 제거하지 않으려면 이 옵션을 생략합니다.  
필수 여부: 아니요

## 예제
<a name="example"></a>

**예제 1 - 세션 이름 변경**  
다음 예제에서는 ID가 `my-session`인 세션의 이름을 `my graphics session`으로 설정합니다.

```
$ dcv set-name --session my-session --name "my graphics sessions"
```

**예제 2 - 세션 이름 제거**  
다음 예제에서는 ID가 `my-session`인 세션의 이름을 제거합니다.

```
$ dcv set-name --session my-session --none
```

# 유휴 세션 찾기 및 중지
<a name="stop-idle-sessions"></a>

`-j` 명령 옵션과 함께 `dcv describe-sessions` CLI 명령을 사용하여 유휴 Amazon DCV 세션을 식별할 수 있습니다. `-j` 옵션을 지정하면 명령이 JSON 형식으로 출력을 반환하도록 구성되며, 세션에 대한 추가 세부 정보를 제공합니다.

예를 들어 다음 명령은 `my-session`이라는 세션에 대한 정보를 반환합니다.

```
$ dcv describe-session my-session -j
```

출력:

```
{
    "id" : "my-session",
    "owner" : "dcvuser",
    "x11-display" : ":1",
    "x11-authority" : "/run/user/1009/dcv/test3.xauth",
    "num-of-connections" : 1,
    "creation-time" : "2019-05-13T13:21:19.262883Z",
    "last-disconnection-time" : "2019-05-14T12:32:14.357567Z",
    "licensing-mode" : "DEMO",
    "licenses" : [
        {
            "product" : "dcv",
            "status" : "LICENSED",
            "check-timestamp" : "2019-05-14T12:35:40Z",
            "expiration-date" : "2019-05-29T00:00:00Z"
        },
        {
            "product" : "dcv-gl",
            "status" : "LICENSED",
            "check-timestamp" : "2019-05-14T12:35:40Z",
            "expiration-date" : "2019-05-29T00:00:00Z"
        }
    ]
}
```

명령 출력에서 `num-of-connections` 파라미터는 활성 클라이언트 연결 수를 나타냅니다. `0` 값은 활성 클라이언트 연결이 없고 세션이 현재 유휴 상태임을 나타냅니다. `last-disconnection-time` 파라미터를 사용하여 세션에 마지막으로 활성 클라이언트 연결이 있었던 시점을 확인할 수도 있습니다.

이 정보를 사용하여 유휴 세션을 식별하는 스크립트 또는 cron 작업을 만들 수 있습니다. 그런 다음 [`dcv close-session`](managing-sessions-lifecycle-stop.md) 명령을 사용하여 사용을 중지할 수 있습니다.

**참고**  
세션을 중지하면 세션에서 실행 중인 모든 애플리케이션이 닫힙니다.