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 サーバーの起動」を参照してください。

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

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

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

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-management キーに移動します。

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

    1. ナビゲーションペインで、[session-management] キーのコンテキスト (右クリック) メニューを開き、[New] (新規)、[DWORD (32-bit) Value] (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 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 DCV サーバーを停止して再起動します。