Instalar el agente de App Layering
El agente de App Layering permite que el dispositivo o una máquina de empaquetado ejecuten comandos de PowerShell localmente. Si proporcionas las credenciales adecuadas, el agente puede ejecutar comandos de PowerShell como un usuario específico.
Cuándo se requiere el agente
El agente de App Layering es necesario si planeas:
- Ejecutar scripts usando tus configuraciones de conector.
- Ejecutar el dispositivo de App Layering en Microsoft Hyper-V.
- Publicar imágenes en capas en Citrix Provisioning.
Instalas el agente en las siguientes ubicaciones:
- En todos los servidores Hyper-V que planeas usar para la creación de capas o la publicación de imágenes.
- En cualquier servidor de Citrix Provisioning donde planeas publicar imágenes en capas.
- En ubicaciones donde tus configuraciones de conector ejecutan scripts de PowerShell.
Registrar el agente con el dispositivo
El instalador del agente de App Layering te pide que registres el agente con un dispositivo de App Layering. Si no registras el agente durante la instalación, puedes registrarlo manualmente más tarde. Sin embargo, los scripts de PowerShell no se ejecutan hasta que el agente esté registrado con el dispositivo.
Requisitos previos
Antes de instalar el agente de App Layering, asegúrate de que el sistema donde estás instalando el agente cumple con los siguientes requisitos:
- Una cuenta con privilegios de administrador
- .NET 4.5
- PowerShell 3.0 o posterior
- PowerShell Snap-in. Antes de usar el agente de App Layering en un servidor de Citrix Provisioning Services, debes asegurarte de que el PowerShell Snap-in esté instalado. Consulta los pasos para registrar el agente manualmente con el dispositivo.
Si instalaste previamente el agente de App Layering, puedes descargar versiones actualizadas desde la página de descargas de Citrix®. El paquete de instalación del agente está incluido en la descarga ZIP de App Layering.
Para descargar el agente de App Layering
- Ve a la página de inicio de Citrix y luego haz clic en Iniciar sesión.
- Haz clic en Descargas y selecciona Citrix App Layering™ de la lista.
- En la página de Citrix App Layering, en Citrix App Layering > Software del producto, haz clic en Citrix App Layering.
- En la parte inferior de la página, haz clic en Herramientas.
- Haz clic en el Archivo de descarga del agente de Citrix App Layering. El archivo citrix_app_layering_agent_installer.exe se descarga en tu equipo.
Instalar el agente de App Layering
El instalador del agente de App Layering te pide que registres el agente con un dispositivo de App Layering. Si no registras el agente durante la instalación, puedes registrarlo manualmente más tarde. Sin embargo, ten en cuenta que el agente debe estar registrado con el dispositivo antes de que los scripts de PowerShell puedan ejecutarse.
-
Usando una cuenta con privilegios de administrador, inicia sesión en el sistema donde estás instalando el agente.
-
Copia el archivo Citrix_app_layering_agent_installer.exe a una ubicación conveniente en el servidor.
-
Ejecuta el Citrix_app_layering_agent_installer.exe como administrador, y cuando se te pida, introduce la ruta al directorio donde quieres instalar el agente de App Layering. La ubicación predeterminada es C:\Program Files (x86)\Citrix\Agent.
El instalador del agente comprueba que todos los requisitos previos están presentes. Si falta algún requisito previo, el instalador lo informa y sale sin instalar.
-
El instalador te pide un número de puerto de agente. Puedes aceptar el número de puerto predeterminado (8016) o especificar uno diferente si el puerto predeterminado ya está en uso.
-
El instalador te pide las credenciales (dirección, nombre de usuario y contraseña) para tu dispositivo de App Layering. Registra el agente de App Layering con el dispositivo introduciendo la dirección IP y las credenciales de inicio de sesión para un usuario de la consola de administración en el dispositivo con privilegios de administrador (por ejemplo, las credenciales que usas para iniciar sesión en la consola de administración).
Nota:
Si el dispositivo de App Layering no está disponible o eliges no registrarlo ahora, puedes registrarlo manualmente más tarde usando el procedimiento descrito en Registrar el agente de App Layering manualmente con el dispositivo.
-
Haz clic en Finalizar para salir del asistente.
Registrar manualmente el agente de App Layering con el dispositivo
Registra el agente de App Layering con el dispositivo.
Si el agente de App Layering no está registrado con un dispositivo de App Layering durante la instalación, puedes registrarlo más tarde usando el siguiente procedimiento.
-
Como administrador, inicia sesión en el servidor donde instalaste el agente de App Layering.
-
Abre una ventana de comandos (cmd.exe) como administrador y navega al directorio donde está instalado el agente de App Layering. La ubicación predeterminada es C:\Program Files (x86)\Citrix\Agent.
-
Ejecuta el siguiente comando de PowerShell:
Enable-PSRemoting <!--NeedCopy--> -
Verifica que el puerto 8016 está abierto ejecutando este comando:
netstat -a <!--NeedCopy--> -
Abre una ventana de comandos (cmd.exe) como administrador y navega al directorio donde está instalado el agente de App Layering. La ubicación predeterminada es:
C:\Program Files (x86)\Citrix\Agent <!--NeedCopy--> -
Ejecuta el siguiente comando, usando la dirección IP del dispositivo donde se indica:
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
Cuando se te pida, introduce la contraseña para un usuario que tenga privilegios de administrador en la consola de administración del dispositivo.
-
Cuando el proceso de registro finalice, aparecerá un mensaje informándote del resultado satisfactorio. El registro del agente de App Layering aparece en el registro de auditoría del servicio de administración.
Si el proceso no tiene éxito, examina el archivo de registro del agente en el directorio de instalación:
C:\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log
También puedes ver la Ayuda para las opciones de línea de comandos del agente de App Layering ejecutando el siguiente comando:
Citrix.AppLayering.Agent.Service.exe /? <!--NeedCopy--> -
Ejecuta el comando de PowerShell para cargar los archivos DLL apropiados en el servidor de Citrix Provisioning.
Para PVS 7.7 y posteriores:
-
Navega a:
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
Ejecuta el comando:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll <!--NeedCopy-->
Para PVS 7.1–7.6:
-
Navega a:
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
Ejecuta el comando:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll <!--NeedCopy-->
En caso de que algunos snap-ins de Citrix Provisioning y Broker no estén registrados, por ejemplo, después de una actualización importante de Windows, averigua cuáles.
-
-
Ejecuta el siguiente comando para listar los snap-ins registrados:
get-pssnapin -registered <!--NeedCopy--> -
Consulta este artículo para obtener instrucciones sobre cómo volver a registrar todos los snap-ins.