Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Instalação e Configuração do Log Server

January 23, 2026
Contribuição de: 
C
  1. Baixe a imagem de contêiner Docker do servidor de log nos downloads da Citrix.
  2. Coloque os arquivos baixados no mesmo diretório.
  3. Execute o instalador no diretório com o terminal (Linux) ou prompt de comando (Windows) e siga as instruções:

Observação:

  • Para uma implantação segura, o HTTPS é altamente recomendado, pois garante a comunicação criptografada entre clientes e servidores. O uso de HTTP fica a critério do cliente.
  • Certifique-se de que a porta selecionada não esteja em uso.
  • Evite usar portas privilegiadas (0–1023), pois elas exigem permissões de administrador ou de nível de sistema.
  • Verifique se as regras do firewall permitem tráfego na porta escolhida.
  • Use um número de porta dentro do intervalo válido (0–65535), mas evite portas comumente usadas por serviços do sistema para evitar conflitos.

Instalação no Linux

chmod +x ./InstallLogServer

# Instalar no modo https com a porta 8443 e caminho padrão
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443

# Instalar no modo http com a porta 8080 e caminho padrão
./InstallLogServer --port 8080

# Comando para alterar o caminho de configuração e o caminho de dados de sua escolha no modo https
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443 --config /Path/LogServer/Config --database /Path/LogServer/Data

# Comando para alterar o caminho de configuração e o caminho de dados de sua escolha no modo http
./InstallLogServer --port 8080 --config /Path/LogServer/Config --database /Path/LogServer/Data
<!--NeedCopy-->

Após a instalação, alguns arquivos de script úteis são gerados:

# No Linux, scripts .sh serão gerados

DownloadLogsByTime.sh
DownloadLogsByWords.sh
GetAuthKey.sh
ListMachines.sh
StartLogServer.sh
<!--NeedCopy-->

Use ./StartLogServer.sh para iniciar o servidor. Verifique seu configpath/weblogs.txt para confirmar se o LogServer foi iniciado com sucesso.

Se o LogServer for iniciado com sucesso, você verá a mensagem abaixo no arquivo weblogs. A porta 5000 é usada pelo LogServer internamente em contêineres Docker com o protocolo http ou https selecionado.

Now listening on: https://[::]:5000
<!--NeedCopy-->

Se o servidor de log foi instalado no modo HTTP, os logs bem-sucedidos devem mostrar o seguinte:

Now listening on: http://[::]:5000
<!--NeedCopy-->

Observação:

  • A porta configurada na etapa de instalação (8080 ou 8443 ou qualquer porta especificada) deve ser usada ao configurar a URL do LogServer em DDC, Storefront™, VDA, etc.
  • Geralmente, leva de 30 a 60 segundos para iniciar no Linux.

Instalação no Windows

Etapa 1: Instale o Docker Desktop (pode ser necessária uma assinatura) para Windows na VM do servidor de log.

Etapa 2: Execute os comandos abaixo para continuar a instalação.

Observação:

O local padrão das pastas Config e Database (Dados) é criado em C:\Users\<username>\LogServer. Você pode alterá-los com os comandos abaixo:

# Instalar no modo https com a porta 8443 e caminho padrão
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443

# Instalar no modo http com a porta 8080 e caminho padrão
InstallLogServer.exe --port 8080
# Comando para alterar o caminho de configuração e o caminho de dados de sua escolha no modo https
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443 --config C:\LogServer\Config --database C:\LogServer\Datacmd

# Instalar com caminho de configuração e caminho de dados específicos
InstallLogServer.exe --port 8080 --config C:\LogServer\Config --database C:\LogServer\Datacmd
<!--NeedCopy-->

Após a instalação, alguns arquivos de script úteis são gerados no mesmo diretório onde você salvou os arquivos do instalador.

Observação:

Você pode mover esses arquivos para um local diferente. No entanto, lembre-se do novo local, pois eles serão necessários novamente ao configurar o Log Server.

# No Windows, scripts .bat serão gerados no mesmo diretório onde você salvou os arquivos do instalador.

DownloadLogsByTime.bat
DownloadLogsByWords.bat
GetAuthKey.bat
ListMachines.bat
StartLogServer.bat
<!--NeedCopy-->

Use StartLogServer.bat para iniciar o servidor de log.

Verifique seu configpath\weblogs.txt para confirmar se o LogServer foi iniciado com sucesso.

Quando os logs mostrarem o abaixo, significa que o Log Server foi iniciado com sucesso.

Se o LogServer for iniciado com sucesso, você verá a mensagem abaixo no arquivo weblogs. A porta 5000 é usada pelo LogServer internamente em contêineres Docker com o protocolo http ou https selecionado.

Now listening on: https://[::]:5000
<!--NeedCopy-->

Se o servidor de log foi instalado no modo HTTP, os logs bem-sucedidos devem mostrar o seguinte:

Now listening on: http://[::]:5000
<!--NeedCopy-->

Observação:

  • A porta configurada na etapa de instalação (8080 ou 8443 ou qualquer porta especificada) deve ser usada ao configurar a URL do LogServer em DDC, Storefront, VDA, etc.
  • Geralmente, leva de 1 a 10 minutos, dependendo do hardware no Windows.

Verifique o Log Server

Abra seu navegador no Log Server, VDA ou DDC e acesse http://YourLogServerFQDN:8080/Ping Uma string de resposta “Pong UTC:08/19/2025 01:03:29“ será exibida no navegador.

Observação:

Altere a porta 8080 para a porta configurada, se não estiver usando a porta padrão, e altere http para https se instalado no modo HTTPS:

Se a verificação do servidor de log falhar, verifique os seguintes logs: Execute docker logs logserver para verificar os logs do Docker. Para Linux - $HOME/LogServer/Config/weblogs.txt (altere $HOME/LogServer para o seu caminho de instalação real, se não estiver usando o padrão)

Para Windows - C:\Users\YourUserName\LogServer\Config\weblogs.txt (Altere YourUserName para o nome de usuário real. Altere C:\Users\YourUserName\LogServer para o seu caminho de instalação real, se não estiver usando o padrão)

Configuração Avançada do Log Server

Execute docker stop logserver para parar o servidor de log.

Por padrão, o servidor de log é configurado com os valores abaixo. Para fazer as alterações, edite o StartLogServer.sh ou StartLogServer.bat se instalado no Windows.

-e MAX_RESERVE_DAYS=7 -e MAX_DISK_USAGE_PERCENTAGE=90 -e LOCAL_DOWN_ONLY=true -e OPENSEARCH_JAVA_OPTS=”-Xms2G -Xmx2G”

Opções de Configuração do LogServer Valor Padrão Intervalo de Valores Descrição
MAX_RESERVE_DAYS 7 1~30 O Log Server armazena entradas de log por um número máximo de dias com base no campo TimeStamp. Logs inseridos há 7 dias serão excluídos. Verificação a cada 10 minutos.
MAX_DISK_USAGE_PERCENTAGE 90 10~90 O Log Server monitora a porcentagem de uso do armazenamento de dados. Se a porcentagem de uso for superior a 90%, o Log Server excluirá logs antigos dia a dia até que a porcentagem de uso seja inferior a 90%. Verificação a cada 10 minutos.
LOCAL_DOWN_ONLY true true/false Se verdadeiro, apenas a máquina onde o Log Server está instalado pode acessar as APIs /Download/*. Se falso, outras máquinas com AuthKey podem acessar as APIs /Download/*.
OPENSEARCH_JAVA_OPTS “-Xms2G -Xmx2G” 2G ~ MaxMem/2 Configurações de memória do Opensearch. Forneça mais memória se houver muitas máquinas que enviariam logs para o Log Server.

Inicie o servidor de log, usando ./StartLogServer.sh no Linux. Inicie o servidor de log usando StartLogServer.bat no Windows.

Para verificar se as alterações foram consideradas

Instalação e Configuração do Log Server
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.