Citrix Virtual Apps and Desktops

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

January 23, 2026

Contribuição de:

Baixe a imagem do contêiner Docker do Log Server em Downloads da Citrix.
Coloque os arquivos baixados no mesmo diretório.
Execute o instalador no diretório usando o terminal (Linux) ou o 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.

Verifique se a porta selecionada não está 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 o 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

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

# Instale 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 Log Server foi iniciado com sucesso.

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

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

Se o Log Server foi instalado no modo HTTP, os logs de sucesso 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 Log Server 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 Log Server.

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á-las com os comandos abaixo:

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

# Instale 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

# Instale 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 Log Server.

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

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

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

Se o Log Server foi instalado no modo HTTP, os logs de sucesso 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 Log Server 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 a instalação foi feita no modo HTTPS:

Se a verificação do Log Server 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 Log Server.

Por padrão, o Log Server é configurado com os valores abaixo. Para fazer as alterações, edite o StartLogServer.sh ou StartLogServer.bat se a instalação foi feita no Windows.

-e MAX_RESERVE_DAYS=7
-e MAX_DISK_USAGE_PERCENTAGE=90
-e LOCAL_DOWN_ONLY=true
-e OPENSEARCH_JAVA_OPTS="-Xms2G -Xmx2G"
<!--NeedCopy-->

Opções de Configuração do Log Server	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 “true”, apenas a máquina onde o Log Server está instalado pode acessar as APIs `/Download/`. Se “false”, 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.
			Ex.: 0~999 máquinas: 2G
			1000~1999 máquinas: 4G
			2000~2999 máquinas: 6G

Inicie o Log Server usando ./StartLogServer.sh no Linux. Inicie o Log Server usando StartLogServer.bat no Windows.

Para verificar se as alterações foram consideradas

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

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

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Isso foi útil?