Iniciar sessões do Amazon DCV - Amazon DCV
Iniciar manualmente sessões virtuais e de console Habilitação de sessões automáticas do console

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Iniciar sessões do Amazon DCV

Quando você usa os padrões para instalar o servidor Amazon DCV do Windows, uma sessão de console é criada automaticamente e fica ativa após a instalação do servidor. A sessão padrão do console pertence ao Administrator e tem o ID da sessão padrão do console. Você pode usar essa sessão ou fechá-la e criar uma nova sessão.

Se você optou por impedir a criação automática da sessão de console quando instalou o servidor Amazon DCV, precisará criar uma manualmente. Depois de instalar o servidor Amazon DCV, é possível habilitar ou desabilitar a criação automática da sessão de console a qualquer momento.

nota

Os servidores Amazon DCV do Linux não recebem uma sessão de console padrão após a instalação.

Suponha que você esteja usando uma licença flutuante on-premises ou servidor em nuvem alternativo e exceda o número máximo de sessões simultâneas compatível com a licença. Você pode receber um erro no licenses. Se receber esse erro, encerre a sessão não utilizada para liberar a licença e tente novamente.

O servidor Amazon DCV deve estar em execução para iniciar a sessão. Para obter mais informações, consulte Como iniciar o servidor Amazon DCV.

Iniciar manualmente sessões virtuais e de console

Você pode iniciar uma sessão do Amazon DCV a qualquer momento. Você só pode executar uma sessão do console por vez. Se você estiver usando um servidor Amazon DCV do Linux, poderá executar várias sessões virtuais ao mesmo tempo.

É uma boa prática executar dcv list-sessions antes de criar uma sessão, especialmente se você estiver usando o servidor Amazon DCV do Windows.

Para criar uma sessão virtual ou de console em um servidor Amazon DCV do Windows ou Linux, use o comando dcv create-session.

Sintaxe

A sintaxe mínima do comando para iniciar uma sessão é:

dcv create-session session_ID

A sintaxe completa com todas as opções é:

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
nota

O símbolo \ representa a sintaxe para dividir um comando em várias linhas.

Você também pode usar dcv create-session --help para exibir uma referência rápida à sintaxe.

Opções

As opções a seguir podem ser usadas com o comando dcv create-session:

--type

Esta opção é compatível apenas com servidores Amazon DCV do Linux. Ela especifica o tipo de sessão a ser criada e pode ser console ou virtual.

Tipo: String

Valores permitidos: console | virtual

Obrigatório: Não

--name

Especifica um nome para a sessão. Os nomes das sessões podem ser qualquer string de até 256 caracteres. Se a string exceder 256 caracteres, o comando falhará. Os nomes das sessões não precisam ser exclusivos nas sessões em execução.

Você pode alterar o nome de uma sessão a qualquer momento usando o comando dcv set-name. Para obter mais informações, consulte Gerenciar o nome da sessão.

Tipo: string

Obrigatório: Sim

--user

Essa opção é compatível com sessões virtuais somente em sessões da Amazon DCV do Linux. Esse valor é o usuário a ser usado para criar a sessão. Somente o usuário raiz pode representar outros usuários.

Tipo: String

Obrigatório: Não

--owner

Especifica o proprietário da sessão. O padrão é o usuário conectado no momento, se omitido.

Tipo: String

Obrigatório: Não

--permissions-file

Especifica um caminho para um arquivo de permissões personalizadas. O padrão é o servidor padrão, se omitido.

Tipo: String

Obrigatório: Não

--storage-root

Especifica o caminho para a pasta a ser usada para armazenamento de sessão.

É possível usar %home% para especificar o diretório inicial do usuário que está conectado no momento. Por exemplo, o seguinte define o diretório para armazenamento de sessão como c:\Users\username\storage\ para servidores do Windows ou como $HOME/storage/ para servidores do Linux.

--storage-root %home%/storage/
nota

Se um subdiretório especificado não existir, o armazenamento da sessão será desabilitado.

Tipo: String

Obrigatório: Não

--gl

Essa opção é compatível com sessões virtuais somente em sessões da Amazon DCV do Linux. Ela substitui o estado padrão dcv-gl e pode ser on ou off.

Tipo: String

Valores permitidos: on | off

Obrigatório: Não

--max-concurrent-clients

Especifica o número máximo de clientes Amazon DCV que têm permissão para se conectar à sessão. O padrão é um número ilimitado de conexões, se omitido.

Tipo: inteiro

Obrigatório: não

--init

Essa opção é compatível com sessões virtuais somente em servidores Amazon DCV do Linux. Ela especifica o caminho para um script init personalizado. O script pode ser usado para iniciar um ambiente de desktop específico e iniciar aplicativos específicos automaticamente quando a sessão é iniciada. O script deve ser executável. O padrão é um script que inicia o ambiente de desktop padrão, se omitido.

Tipo: String

Obrigatório: Não

session ID

Fornece um ID para sua sessão no final do comando.

Tipo: string

Obrigatório: Sim

Exemplos

Exemplo 1 - Sessão do console

O comando a seguir cria uma sessão de console pertencente a dcv-user com um ID exclusivo de sessão my-session e um nome de sessão my graphics session. Ele também especifica um arquivo de permissões chamado perm-file.txt.

  • Servidor Amazon DCV do Windows

    C:\> dcv create-session^
    --owner dcv-user^
    --name "my graphics session"^
    --permissions-file perm-file.txt^
    my-session

  • Servidor Amazon DCV do Linux

    $ sudo dcv create-session \
    --type=console \
    --owner dcv-user \
    --name "my graphics session" \
    --permissions-file perm-file.txt \
    my-session
Exemplo 2: sessão virtual (somente servidores Amazon DCV do Linux)

O comando a seguir cria uma sessão virtual usando o usuário raiz para representar o proprietário da sessão pretendida, dcv-user. A sessão pertence a dcv-user, embora ela tenho sido criada pelo usuário raiz.

$ sudo dcv create-session \
    --owner dcv-user \
    --user dcv-user \
    my-session
Exemplo 3: sessão virtual (somente servidores Amazon DCV do Linux)

O comando a seguir cria uma sessão virtual que pertence ao usuário que a criou:

$ dcv create-session my-session

Habilitação de sessões automáticas do console

Habilitar uma sessão de console automática garante que uma sessão de console seja criada automaticamente toda vez que o servidor Amazon DCV iniciar. A sessão de console automática pertence ao usuário do Amazon DCV especificado pelo parâmetro de configuração owner. Seu ID de sessão é sempre console.

Outros parâmetros que afetam as sessões do console automática são max-concurrent-clients, permissions-file e storage-root. Para mais informações sobre esses parâmetros, consulte Parâmetros do session-management/automatic-console-session.

nota

O Amazon DCV não é compatível com sessões virtuais automáticas.

Windows Amazon DCV server
Para habilitar uma sessão automática do console em um servidor Amazon DCV do Windows

  1. Abrir o Editor do Registro do Windows.

  2. Navegue até a chave HKEY_USERS\ S-1-5-18\ Software\\ com\nicesoftware\ GSettings dcv\ session-management.

  3. Crie um parâmetro create-session:

    1. No painel de navegação, abra o menu de contexto (clique com o botão direito do mouse) da chave session-management e escolha Novo, Valor de DWORD (32 bits).

    2. Em Nome, insira create-session e pressione Enter.

    3. Abra o parâmetro create-session. Em Dados de valor, digite 1 e escolha OK.

  4. Navegue até a chave HKEY_USERS\ S-1-5-18\ Software\\ com\nicesoftware\ dcvGSettings\ session-management/. automatic-console-session

  5. Crie um parâmetro owner:

    1. No painel de navegação, abra o menu de contexto (clique com o botão direito do mouse) da automatic-console-sessionchave e escolha Novo, Valor da sequência de caracteres.

    2. Em Nome, insira owner e pressione Enter.

    3. Abra o parâmetro owner. Em Valor de dados, insira o nome do proprietário da sessão e escolha OK.

  6. Escolha OK e feche o Editor do Registro do Windows.

  7. Interrompa e reinicie o servidor Amazon DCV.

Linux Amazon DCV server
Para habilitar uma sessão de console automática em um servidor Amazon DCV do Linux

  1. Navegue até /etc/dcv/ e abra o dcv.conf com seu editor de texto escolhido.

  2. Adicione os parâmetros create-session e owner à seção [session-management/automatic-console-session] usando o seguinte formato:

    
[session-management]
create-session = true

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

  3. Salve e feche o arquivo.

  4. Interrompa e reinicie o servidor Amazon DCV.