Arquivo de configuração do agente - Gerenciador de Sessões do Amazon DCV

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á.

Arquivo de configuração do agente

O arquivo de configuração do agente (/etc/dcv-session-manager-agent/agent.confpara Linux, macOS e C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf para Windows) inclui parâmetros que podem ser configurados para personalizar a funcionalidade do Gerenciador de Sessões. Você pode editar o arquivo de configuração usando o editor de texto de sua preferência.

A tabela a seguir lista os parâmetros no arquivo de configuração do atendente.

Nome do parâmetro Obrigatório Valor padrão Description
agent.broker_host Sim Especifica o nome DNS do host do agente.
agent.broker_port Sim 8445 Especifica a porta pela qual se comunicar com o agente.
agent.ca_file Não Só é necessário se tls_strict estiver definido como true. Especifica o caminho para o arquivo do certificado (.pem) necessário para validar o certificado TLS. Copie o certificado autoassinado do agente para o atendente.
agent.init_folder Não

  • /var/lib/dcv-session-manager-agent/init (Linux)

 Especifica o caminho para uma pasta no servidor host usada para armazenar scripts personalizados com permissão para inicializar sessões do servidor Amazon DCV quando eles são criados. Você deve especificar um caminho absoluto. A pasta deve estar acessível e os arquivos devem ser executáveis por usuários que usam o parâmetro de InitFilesolicitação da CreateSessionsAPI.
agent.tls_strict Não true Indica se deve ser usada a validação de TLS estrita.
agent.software_statement_path Não Só é necessário se não for usada a instrução de software padrão. Especifica o caminho para o arquivo de instruções do software. Para obter mais informações, consulte generate-software-statement.
agent.tags_folder Não

  • /etc/dcv-session-manager-agent(Linux/macOS)

  • C:\Program Files\NICE\DCVSessionManagerAgent\conf\tags (Windows)

 Especifica o caminho para a pasta na qual os arquivos de tag estão localizados. Para obter mais informações, consulte Usar tags para direcionar servidores Amazon DCV.
agent.autorun_folder Não

  • /var/lib/dcv-session-manager-agent/autorun (Linux)

  • C:\ProgramData\NICE\DcvSessionManagerAgent\autorun (Windows)

 Especifica o caminho para uma pasta no servidor host usada para armazenar scripts e aplicativos que podem ser executados automaticamente na inicialização da sessão. Você deve especificar um caminho absoluto. A pasta deve estar acessível e os arquivos devem ser executáveis por usuários que usam o parâmetro de AutorunFilesolicitação da CreateSessionsAPI.
agent.max_virtual_sessions Não -1 (sem limite) O número máximo de sessões virtuais que podem ser criadas em um servidor Amazon DCV usando o Gerenciador de Sessões do Amazon DCV.
agent.max_concurrent_sessions_per_user Não 1 O número máximo de sessões virtuais que podem ser criadas em um servidor Amazon DCV por um único usuário usando o Gerenciador de Sessões do Amazon DCV.
agent.broker_update_interval Não 30 Especifica a quantidade de segundos de espera antes de enviar dados atualizados para o agente. Os dados enviados incluem o status do servidor Amazon DCV e do host, bem como informações atualizadas da sessão. Valores mais baixos tornam o Gerenciador de Sessões mais consciente das mudanças que acontecem no sistema em que o atendente é executado, mas aumentam a carga do sistema e o tráfego da rede. Valores mais altos diminuem a carga do sistema e da rede, mas o Gerenciador de Sessões se torna menos responsivo às alterações do sistema, portanto, valores maiores do que 120 não são recomendados.
agent.enable_query_logged_in_users Não true Habilite a obtenção de usuários conectados no Windows. Quando verdadeiro, consulta o sistema em busca de usuários reais conectados. Quando falso, retorna “desconhecido”
log.level Não info Especifica o nível de verbosidade dos arquivos de log. Os seguintes níveis de detalhamento estão disponíveis:

  • error — Fornece os mínimos detalhes. Inclui apenas erros.

  • warning — Inclui erros e avisos.

  • info — O nível padrão de detalhamento. Inclui erros, avisos e mensagens informativas.

  • debug — Fornece a maioria dos detalhes. Fornece informações detalhadas que são úteis para depurar problemas.
log.directory Não

  • /var/log/dcv-session-manager-agent/(Linux/macOS)

  • C:\ProgramData\NICE\DCVSessionManagerAgent\log (Windows)

 Especifica o diretório no qual os arquivos de log devem ser criados.
log.rotation Não daily Especifica a rotação do arquivo de log. Os valores válidos são:

  • hourly — Arquivos de log são rotacionados de hora em hora.

  • daily — Arquivos de log são rotacionados diariamente.
log.max-file-size Não 10485760 Quando o tamanho de um arquivo de log atingir o tamanho especificado em bytes, ele será rotacionado. Um novo arquivo de log será criado e outros eventos de log serão colocados no novo arquivo.
log.rotate Não 9 O número máximo de arquivos de log preservados na rotação. Sempre que ocorrer uma rotação e esse número for atingido, o arquivo de log mais antigo será excluído.