Primeros pasos con License Server VPX

Descarga License Server VPX desde Citrix Licensing Version 11.16.6.0.

Distribuimos Citrix License Server VPX como un sistema de máquina virtual configurado en formato .xva.

Asegúrate de tener la última versión de License Server

Al actualizar o instalar nuevos productos Citrix, ten siempre la última versión de License Server. La nueva versión de License Server es compatible con versiones anteriores y es compatible con productos y archivos de licencia más antiguos. Sin embargo, los productos nuevos requieren la versión más reciente de License Server para obtener licencias correctamente. Puedes instalar o actualizar la última versión desde el medio del producto.

  • Si no estás seguro de si tu versión de License Server está actualizada, compárala con el número que aparece en el sitio de Descargas.

  • Para encontrar el número de versión de tu License Server en la consola de administración de licencias:

    1. Abre un navegador web y ve a https://License ServerName:secureWebPort.
    1. Haz clic en Administración y selecciona la ficha Información del sistema. Consulta la versión de lanzamiento en la lista de información.

Ubicaciones de directorios y archivos

  • Ubicación del archivo de licencia: /opt/citrix/licensing/myfiles
  • Ubicación del archivo keytab: /opt/citrix/licensing/LS/conf/ctx_http.keytab
  • Ubicación de server.crt y server.key: /opt/citrix/licensing/LS/conf/
  • Ubicaciones de los registros: /opt/citrix/licensing/LS/logs
  • Registro de informes: /opt/citrix/licensing/LS/reportlog.rl
  • Archivos de renovación del servicio de éxito del cliente: /opt/citrix/licensing/LS/

Para importar License Server VPX mediante Citrix Hypervisor

  1. Abre XenCenter, haz clic en el servidor en el que quieres importar License Server VPX y selecciona Importar.
  2. Explora la ubicación de tu paquete y elige el paquete .xva.
  3. Elige un servidor principal para tu máquina virtual. Este servidor principal es el servidor en el que la máquina virtual se inicia automáticamente. Alternativamente, puedes hacer clic en un grupo de Citrix Hypervisor™ y la máquina virtual se iniciará automáticamente en el host más adecuado de ese grupo.
  4. Elige un repositorio de almacenamiento para el disco virtual. El repositorio debe tener un mínimo de 8 GB de espacio libre.
  5. Define las interfaces de red. License Server VPX se comunica a través de una única NIC virtual. Elige una red que sea accesible para los servidores Citrix a los que quieres proporcionar servicios de licencia.

Después de importar la máquina virtual, aparecerá en tu consola de administración de XenCenter®. Puedes reiniciar el dispositivo virtual en Citrix Hypervisor haciendo clic con el botón derecho en su nombre y eligiendo Iniciar.

Configura License Server VPX para el primer uso

Después de importar License Server VPX, tendrás un Citrix License Server completamente funcional en tu grupo de Citrix Hypervisor. La primera vez que inicies License Server, se abrirá un asistente de configuración para configurar la red.

  1. Después de que se abra el asistente, crea una contraseña raíz segura para los administradores.
  2. Especifica un nombre de host para License Server VPX.

    La mayoría de los archivos de licencia de Citrix están vinculados al nombre de host de tu License Server, que distingue entre mayúsculas y minúsculas.

  3. Especifica un dominio para License Server VPX.
  4. Especifica si quieres usar DHCP como tipo de red. Elige ‘y’ para obtener la información de red automáticamente. De lo contrario, elige ‘n’ y escribe la información de red requerida.
  5. Especifica un nombre de usuario y una contraseña de la consola de administración de licencias para el servicio de licencias.
  6. Elige si quieres habilitar el Programa de mejora de la experiencia del cliente y Call Home. Para obtener más información, consulta Acerca del Programa de mejora de la experiencia del cliente (CEIP) de Citrix.
  7. Elige si quieres agregar el License Server VPX al dominio de Active Directory. Si lo haces, una vez completada la configuración, sigue las instrucciones para generar e instalar el archivo keytab.

Importante:

Si no configuras Active Directory, la integración de Citrix Licensing Manager, Studio y Director no estará disponible.

Configura licencias desde una interfaz web, disponible en el puerto 8082

Si cometes un error de configuración, inicia sesión en el dispositivo como root con la contraseña que especificaste. Escribe el comando resetsettings.sh o reset_ceip.sh para volver a ejecutar el asistente de configuración.

Comando resetsettings.sh

resetsettings.sh ofrece la opción de conservar o eliminar archivos de datos históricos al restablecer la configuración de Licensing Server VPX. Puedes restablecer completamente la configuración eliminando todos los datos históricos recopilados hasta ese momento o restablecerla parcialmente conservando los datos históricos.

Como root, ejecuta el siguiente script y haz tus elecciones:

# resetsettings.sh

Comando reset_ceip.sh

reset_ceip.sh ofrece la opción de restablecer las opciones del Programa de mejora de la experiencia del cliente (CEIP) que elegiste durante la configuración original. Este comando restablece solo la configuración del CEIP y conserva todas las demás configuraciones. En VPX, no modifiques el archivo CITRIX.opt.

Como root, ejecuta el siguiente script y haz tu elección de CEIP [1.DIAG 2.ANON 3. NONE]

# reset_ceip.sh

Exporta la base de datos para usarla en otro License Server VPX

Usa el script migrate_historical_data.sh para migrar los datos históricos a un Licensing Server VPX más reciente. El script ofrece opciones para hacer una copia de seguridad y restaurar datos históricos.

Importante:

Ejecuta este script como root.

Este procedimiento de ejemplo migra los datos de VPX_O a VPX_N.

  1. Ejecuta el comando #migrate_historical_data.sh -b en VPX_O` para crear un archivo de copia de seguridad /tmp/historical_data.tar.
  2. Cuando VPX_N esté en ejecución, copia o mueve el archivo /tmp/ historical_data.ta a VPX_N usando cualquier protocolo de transferencia de archivos. Por ejemplo, scp.
  3. Ejecuta el comando #migrate_historical_data.sh -r /directory en VPX_N` para restaurar los datos. Donde directory es el directorio en el que reside historical_data.tar.

Generar e instalar el archivo keytab

  1. Usa la utilidad ktpass.exe desde un servidor Windows que esté conectado al mismo dominio. Escribe el comando en una sola línea sin retornos. El siguiente ejemplo muestra varias líneas debido a limitaciones de espacio.

    ktpass.exe -princ HTTP/hostFQDN:port@DOMAIN REALM -mapuser domainuser -pass password -out filepath -ptype KRB5_NT_PRINCIPAL

    Donde:

    -princ HTTP/hostFQDN:port@DOMAIN REALM especifica el nombre principal:

    hostFQDN es el nombre de dominio completo del License Server VPX.

    port es el puerto configurado para los servicios web de licencias. El valor predeterminado es 8083.

    DOMAIN REALM es el dominio de Active Directory escrito en LETRAS MAYÚSCULAS.

    -mapuser domainuser especifica un usuario en el dominio que se puede usar para enlazar con Active Directory.

    -pass password especifica la contraseña del usuario de dominio.

    -out filepath especifica la ruta donde se guarda el archivo keytab generado.

    -ptype KRB5_NT_PRINCIPAL especifica el tipo principal. KRB5_NT_PRINCIPAL es el único tipo principal admitido.

    Ejemplo:

    ktpass.exe -princ HTTP/VPXHOST.example.domain.com:8083@EXAMPLE.DOMAIN.COM –mapuser administrator -pass password –out C:\example.keytab -ptype KRB5_NT_PRINCIPAL

  2. Cambia el nombre del archivo keytab generado a ctx_http.keytab.
  3. Desde la interfaz de línea de comandos de License Server VPX, monta una ruta de red.
    1. Crea y comparte una carpeta con el archivo ctx_httpd.keytab dentro.
    2. En el VPX, crea un punto de montaje, monta la unidad compartida y copia el archivo.

      mkdir /mnt/temp

      mount //your_windows_machine/shared_folder/ cp /mnt/temp/ctx_http.keytab /opt/citrix/licensing/LS/conf

    3. Desmonta la unidad en el VPX. umount /mnt/temp
  4. Copia el archivo keytab generado usando el recurso compartido de Windows a esta ruta en el License Server VPX.

    /opt/citrix/licensing/LS/conf/ctx_http.keytab

  5. Para acceder a Citrix Licensing Manager, abre https://VPXHOST.example.domain.com:8083/
  6. Para enlazar Active Directory, inicia sesión con el usuario configurado en el comando del paso 1.
  7. Para configurar y administrar otros usuarios de dominio, inicia sesión en la Citrix License Administration Console: https://VPXHOST.example.domain.com:8082
  8. Agrega y quita usuarios de Active Directory.

Importante:

  • License Server VPX no admite grupos de Active Directory.
  • Dado que Kerberos autentica a los usuarios de Active Directory, la generación del archivo keytab es crucial.
  • Según las reglas de Kerberos, debes asignar un usuario único al nombre principal creado con ktpass.exe. Para obtener más información, consulta el artículo del comando ktpass.
  • El puerto en el nombre principal de servicio (SPN) es necesario para que Studio muestre y administre las licencias.
  • SSH/SCP está deshabilitado para el usuario root. Crea un nuevo usuario para acceder al VPX con SSH/SCP.

Deshabilitar el truncamiento del nombre de dominio en el Citrix License Server VPX

El License Server detecta las licencias de Citrix Service Provider y habilita esta funcionalidad.

  1. En la línea de comandos, ve al archivo /opt/citrix/licensing/LS/conf/ud_settings.conf.
  2. Usando el editor vi, establece CTX_UD_USERDOMAIN=1.
  3. Reinicia el License Server VPX o el demonio de Citrix Licensing.
Configuración Descripción  
CTX_UD_USERDOMAIN=1 Usa el dominio de usuario del perfil de usuario. Deshabilita el truncamiento del nombre de dominio.  
CTX_UD_USERDOMAIN=0 Usa el dominio de usuario del perfil de usuario. Deshabilita el truncamiento del nombre de dominio. No uses el dominio de usuario del perfil de usuario. (predeterminado)

Mover archivos de licencia de una versión anterior de License Server VPX

Este procedimiento solo mueve los archivos de licencia. Vuelve a configurar todos los usuarios en el nuevo License Server. Asegúrate de que los archivos de licencia que muevas tengan la propiedad y los permisos correctos.

  1. Haz una copia de seguridad de los archivos de licencia del antiguo Citrix License Server VPX en un recurso compartido de red. Todos los archivos de licencia *.lic de: /opt/citrix/licensing/myfiles excepto citrix_startup.lic
  2. Cierra el antiguo License Server.
  3. Inicia el nuevo Citrix License Server VPX con el mismo enlace que el anterior. El enlace puede ser una dirección MAC, un nombre de host o una dirección IP especificada en la línea SERVER de los archivos de licencia.
  4. Restaura los archivos de licencia de los que hiciste copia de seguridad desde el recurso compartido de red al nuevo License Server. Restaura los archivos en: /opt/citrix/licensing/myfiles con la propiedad de archivo como ctxlsuser:lmadmin (usuario:grupo) y el permiso como 644.
  5. Ejecuta este comando como ctxlsuser: /opt/citrix/licensing/LS/lmreread -c @localhost

Cambiar números de puerto

El kernel de Linux reserva los puertos del 1 al 1024. Al configurar los puertos VPX, usa puertos superiores a 1024. Cuando uses SSL, usa el puerto 8083 para Citrix Licensing Manager y el puerto 8082 para License Administration Console, que está abierto en el firewall. Si seleccionas un puerto diferente para SSL, vuelve a configurar el firewall en las iptables.