Amazon DCVセッションの開始 - Amazon DCV
コンソールセッションおよび仮想セッションの手動開始自動コンソールセッションの有効化

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon DCVセッションの開始

デフォルトを使用して Windows Amazon DCVサーバーをインストールすると、サーバーのインストール後にコンソールセッションが自動的に作成され、アクティブになります。デフォルトのコンソールセッションは Administrator によって所有されており、デフォルトのセッション ID は console です。このセッションを使用することも、終了して新しいセッションを作成することもできます。

Amazon DCVサーバーのインストール時にコンソールセッションの自動作成をオプトアウトする場合は、手動で作成する必要があります。Amazon DCVサーバーをインストールしたら、コンソールセッションの自動作成をいつでも有効または無効にできます。

注記

Linux Amazon DCVサーバーは、インストール後にデフォルトのコンソールセッションを取得しません。

オンプレミスまたは代替のクラウドベースサーバーでフローティングライセンスを使用していて、ライセンスでサポートされている同時セッションの最大数を超えたとします。その場合は no licenses エラーが発生する可能性があります。このエラーが発生した場合は、未使用のセッションを停止してライセンスをリリースしてから再試行してください。

セッションを開始するには、Amazon DCVサーバーが実行されている必要があります。詳細については、「Amazon DCV Server の起動」を参照してください。

コンソールセッションおよび仮想セッションの手動開始

Amazon DCVセッションはいつでも開始できます。一度に 1 つのコンソールセッションしか実行できません。Linux Amazon DCVサーバーを使用している場合は、複数の仮想セッションを同時に実行できます。

セッションを作成するdcv list-sessions前に、特に Windows Amazon DCVサーバーを使用している場合は、 を実行することをお勧めします。

Windows または Linux Amazon DCVサーバーでコンソールまたは仮想セッションを作成するには、 dcv create-session コマンドを使用します。

構文

セッションを開始するコマンドの最小限の構文は次のとおりです。

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 コマンドを使用していつでも変更できます。詳細については、「セッション名の管理」を参照してください。

型: 文字列

必須: はい

--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 パラメータ」を参照してください。

注記

Amazon DCVは自動仮想セッションをサポートしていません。

Windows Amazon DCV server
Windows Amazon DCVサーバーで自動コンソールセッションを有効にするには

  1. Windows レジストリエディタを開きます。

  2. HKEY_ USERS/S-1-5-18/Software/GSettings/com/nicesoftware/dcv/session管理キーに移動します。

  3. create-session パラメータの作成

    1. ナビゲーションペインで、セッション管理キーのコンテキスト (右クリック) メニューを開き、新規、DWORD(32 ビット) 値を選択します。

    2. [名前] に create-session と入力し、[Enter] を押します。

    3. [create-session] パラメータを開きます。[値のデータ] に 1 と入力し、[OK] を選択します。

  4. HKEY_USERS/S-1-5-18/Software/GSettings/com/nicesoftware/dcv/session-management/automatic-console-session キーに移動します。

  5. owner パラメータの作成

    1. ナビゲーションペインで、automatic-console-sessionキーのコンテキスト (右クリック) メニューを開き、新しい文字列値を選択します。

    2. [名前] に owner と入力し、[Enter] を押します。

    3. [owner] パラメータを開きます。[値のデータ] にセッションの所有者名を入力し、[OK] を選択します。

  6. [OK] を選択して Windows レジストリエディタを閉じます。

  7. Amazon Amazon DCV Server の停止DCVサーバーを停止して再起動します。

Linux Amazon DCV server
Linux Amazon DCVサーバーで自動コンソールセッションを有効にするには

  1. /etc/dcv/ に移動し、任意のテキストエディタで dcv.conf を開きます。

  2. 次の形式を使用して、create-session および owner パラメータを [session-management/automatic-console-session] セクションに追加します。

    
[session-management]
create-session = true

[session-management/automatic-console-session]
owner="session-owner"

  3. ファイルを保存して閉じます。

  4. Amazon Amazon DCV Server の停止DCVサーバーを停止して再起動します。