Instalación y configuración del servidor de registros

1. Descargue la imagen del contenedor de Docker del servidor de registros desde descargas de Citrix.
2. Coloque los archivos descargados en el mismo directorio.
3. Ejecute el instalador en el directorio con el terminal (Linux) o el símbolo del sistema (Windows) y siga las instrucciones:

Nota:

• Para una implementación segura, se recomienda encarecidamente HTTPS, ya que garantiza una comunicación cifrada entre clientes y servidores. El uso de HTTP queda a discreción del cliente.
• Asegúrese de que el puerto seleccionado no esté ya en uso.
• Evite usar puertos privilegiados (0–1023), ya que requieren permisos de administrador o de nivel de sistema.
• Verifique que las reglas del firewall permitan el tráfico en el puerto elegido.
• Utilice un número de puerto dentro del rango válido (0–65535), pero evite los puertos comúnmente utilizados por los servicios del sistema para evitar conflictos.

Instalación en Linux

chmod +x ./InstallLogServer

# Install with https mode with port 8443 with default path
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443

# Install with http mode, with port 8080 with default path
./InstallLogServer --port 8080

# Command to change the config path and data path of your choice with https mode
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443 --config /Path/LogServer/Config --database /Path/LogServer/Data

# Command to change the config path and data path of your choice with http mode
./InstallLogServer --port 8080 --config /Path/LogServer/Config --database /Path/LogServer/Data
<!--NeedCopy-->

Después de la instalación, se generan algunos archivos de script útiles:

# In Linux, sh scripts will be generated

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

Utilice ./StartLogServer.sh para iniciar el servidor. Compruebe su configpath/weblogs.txt para confirmar que LogServer se inició correctamente.

Si el LogServer se inicia correctamente, verá el siguiente mensaje en el archivo weblogs. El puerto 5000 es utilizado por LogServer internamente en contenedores docker con el protocolo http o https seleccionado.

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

Si el servidor de registros se instaló en modo HTTP, los registros correctos deberían mostrar lo siguiente:

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

Nota:

• El puerto configurado en el paso de instalación (8080 o 8443 o cualquier puerto especificado) debe usarse al configurar la URL de LogServer en DDC, Storefront™, VDA, etc.
• Normalmente tarda entre 30 y 60 segundos en iniciarse en Linux.

Instalación en Windows

Paso 1: Instale Docker Desktop (puede requerirse una suscripción) para Windows en la VM del servidor de registros.

Paso 2: Ejecute los siguientes comandos para continuar con la instalación.

Nota:

La ubicación predeterminada de las carpetas de Configuración y Base de datos (Datos) se crea en C:\Users<username>\LogServer. Puede cambiarlas con los siguientes comandos:

#Install with https mode with port 8443 with default path
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443

#Install with http mode, with port 8080 with default path
InstallLogServer.exe --port 8080
#Command to change the config path and data path of your choice with https mode
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443 --config C:\LogServer\Config --database C:\LogServer\Datacmd

#Install with specific config path and data path
InstallLogServer.exe --port 8080 --config C:\LogServer\Config --database C:\LogServer\Datacmd
<!--NeedCopy-->

Después de la instalación, se generan algunos archivos de script útiles en el mismo directorio donde guardó los archivos del instalador.

Nota:

Puede mover estos archivos a una ubicación diferente. Sin embargo, recuerde la nueva ubicación, ya que serán necesarios de nuevo al configurar el servidor de registros.

#In Windows, bat scripts will be generated in the same directory where you saved the installer files.

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

Utilice StartLogServer.bat para iniciar el servidor de registros.

Compruebe su configpath\weblogs.txt para confirmar que LogServer se inició correctamente

Cuando los registros muestren lo siguiente, significa que el servidor de registros se ha iniciado correctamente.

Si LogServer se inicia correctamente, verá el siguiente mensaje en el archivo weblogs. El puerto 5000 es utilizado por LogServer internamente en contenedores Docker con el protocolo http o https seleccionado.

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

Si el servidor de registros se instaló en modo HTTP, los registros correctos deberían mostrar lo siguiente:

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

Nota:

• El puerto configurado en el paso de instalación (8080 o 8443 o cualquier puerto especificado) debe utilizarse al configurar la URL de LogServer en DDC, Storefront, VDA, etc.
• Normalmente, tarda entre 1 y 10 minutos, dependiendo del hardware en Windows.

Verificar el servidor de registros

Abra su navegador en el servidor de registros, VDA o DDC, y visite http://YourLogServerFQDN:8080/Ping En el navegador se mostrará una cadena de respuesta “Pong UTC:08/19/2025 01:03:29“.

Nota:

Cambie el puerto 8080 por el puerto configurado si no utiliza el puerto predeterminado, y cambie http a https si se instaló en modo HTTPS:

Si la verificación del servidor de registros falla, compruebe los siguientes registros: Ejecute docker logs logserver para comprobar los registros de Docker. Para Linux - $HOME/LogServer/Config/weblogs.txt (cambie $HOME/LogServer a su ruta de instalación real si no utiliza la predeterminada)

Para Windows - C:\Users\YourUserName\LogServer\Config\weblogs.txt (Cambie YourUserName por el nombre de usuario real. Cambie C:\Users\YourUserName\LogServer por su ruta de instalación real si no utiliza la predeterminada)

Configuración avanzada del servidor de registros

Ejecute docker stop logserver para detener el servidor de registros

De forma predeterminada, el servidor de registros se configura con los valores siguientes. Para realizar los cambios, edite el StartLogServer.sh o el StartLogServer.bat si está instalado en Windows.

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

Inicie el servidor de registros, usando./StartLogServer.sh en Linux Inicie el servidor de registros usando StartLogServer.bat en Windows.

Para comprobar si se han tenido en cuenta los cambios