Como ya sabéis, trabajar en CLI (command Line Interface) proporciona muchas ventajas, entre ellas, la tan querida automatización de tareas que nos proporciona el scripting y la ejecución de tareas desde CLI.
Dicho esto, vamos a ver como realizar una instalación de Citrix XenDesktop, así como el agente VDA, completamente, desde linea de comandos.
XenDesktopServerSetup.exe
Cuando lanzamos el asistente para la instalación de XenDesktop en formato GUI, una vez seleccionados los módulos que instalaremos, este hace una llamada al ejecutable XenDesktopServerSetup.exe con una serie de parámetros. En este artículo, vamos a ver como podemos realizar este proceso de forma manual desde CLI y que opciones tenemos disponibles.
XenDesktopServerSetup.exe se encuentra en la ISO de XD en la ruta \x64\XenDesktop Setup\ y nos permite tanto instalar componentes, como eliminar-los utilizando una serie de opciones disponibles (que de otro modo, son llamados de forma automática al realizar la instalación desde el wizzard de XD. Pero me diréis que no mola mas, ejecutar-lo desde CLI…). Soltado el rollo, vamos por faena y por la parte interesante.
Veamos que opciones tenemos con la ejecución de XenDesktpServerSetup.exe:
/h -> Nos muestra el fichero de ayuda/quiet -> instalación silenciosa, no aparece interfaz de usuario. En este modo, solo tendremos evidencias de que esta siendo ejecutada la instalación mediante el uso del taskmanager de windows.
/logpath [ruta] -> guardamos logs del proceso de instalación en la ruta indicada.
NOTA: El directorio utilizado debe estar creado con anterioridad. Durante el proceso no es capaz de crear dicho directorio de logs.
/noreboot -> Evita el reinicio de la máquina tras el proceso de instalación.
/remove -> Debe ir acompañado del parámetro
/component. Realiza la des-instalación del componente indicado.
/removeall -> Desinstala XenDesktop al completo.
/configurefirewall -> Configura y habilita las reglas de firewall necesarias. Ver CTX101810.
/components -> /components [componente] nos permite elegir que componentes instalar durante el proceso. Los componentes disponibles son:
- CONTROLLER – Controller
- DESKTOPDIRECTOR – Director
- DESKTOPSTUDIO – Studio
- LICENSESERVER – Citrix Licensing
- STOREFRONT – StoreFront
Este parámetro es mandatorio en el proceso de instalación.
/installdir [ruta] -> Modificamos la ruta por defecto donde será instalado XenDesktop.
/tempdir [ruta] -> Cambiamos el directorio utilizado como temporal para la instalación de XenDesktop. Por defecto, windows/temp.
/nosql -> Evita la instalación de SQL express durante el proceso de instalación.
/enableremoteassitance -> Habilita la característica de Windows Remote Asistance de Microsoft.
Con este resumen, ya podemos hacer cualquier tipo de instalación desde CLI. Así con…
XenDesktpServerSetup.exe /quiet /logpath c:\logs\xdLogs\ /components controller,desktopstudio,desktopdirector,licenseserver,storefront /noreboot /configurefirewall /enableremoteassistance
Realizaremos una instalación de XenDesktop POC, que almacenerá el log de instalación en c:\logs\xdlogs\. La instalación se realizará en modo silencioso, por lo que no veremos nada durante el proceso (recordad que podemos ver el avance a través del task manager). Adicionalmente, abrimos los puertos del firewall de forma automática, habilitamos el RemoteAssistance de Microsoft y le indicamos que tras finalizar no reinicie el servidor (cuyo reinicio será ejecutado por nosotros de forma manual).
XenDesktpServerSetup.exe /quiet /logpath c:\logs\xdLogs\ /components controller,desktopstudio /noreboot /nosql /configurefirewall /enableremoteassistance
En este caso, estamos realizando la instalación del Delivery únicamente, junto a Studio. Como estamos realizando una instalación por componentes, no incluimos SQLexpress en el proceso. Nuevamente, almacenamos los logs en C:\logs\xdlogs y habilitamos remote assistance a la vez que abrimos los puertos del firewall necesarios durante el propio proceso de instalación.
XenDesktopVdaSetup.exe
Instalar XD desde CLI mola, pero la instalación del cliente VDA, mola mas 😉 Es obvio. La instalación de XD se puede realizar sin problemas desde CLI, pero la automatización de la misma, será una ventaja en escasos entornos. En cambio, el deploy del agente VDA en forma de script customizado, da mucho mas juego, ademas de la cantidad de opciones que tenemos disponibles. Veamos-lo.
/h -> Nos muestra el fichero de ayuda/quiet -> instalación silenciosa, no aparece interfaz de usuario. En este modo, solo tendremos evidencias de que esta siendo ejecutada la instalación mediante el uso del taskmanager de windows./logpath [ruta] -> guardamos logs del proceso de instalación en la ruta indicada. NOTA: El directorio utilizado debe estar creado con anterioridad. Durante el proceso no es capaz de crear dicho directorio de logs./noreboot -> Evita el reinicio de la máquina tras el proceso de instalación./remove -> Debe ir acompañado del parametro /component. Realiza la desinstalación del componente indicado./removeall -> Desinstala XenDesktop al completo.
/reconfig -> Nos permite reconfigurar opciones del VDA ya instalado, tales como /controllers; /portnumber port ; /enable_hdx_ports
/portnumber -> Nos permite establecer el puerto utilizado custom en lugar del puerto por defecto utilizado por el agente VDA (80).
/components -> Realiza la instalación de los componentes indicados, pudiendo ser estos:
VDA – instala el agnete VDA
PLUGINS – Instala Citrix Receiver for Windows (CitrixReceiver.exe)
/installdir [ruta] -> Modificamos la ruta por defecto donde será instalado el VDA./tempdir [ruta] -> Cambiamos el directorio utilizado como temporal para la instalación dek VDA. Por defecto, windows/temp.
/site_guid guid -> Si disponemos el GUID de un SITE ya creado, podemos asociar de forma automática el VDA con el SITE especifico.
/Controllers -> Indica los controladores utilizados por el VDA. Utilizar FQDN.
/xa_server_location url -> URL del servidor de aplicaciones XenApp.
/enable_remote_assistance -> Habilita la caracteristica Microsoft Remote Assistance.
/enable_hdx_ports -> Habilita los puertos de hdx en el firewall de windows.
/optimize -> Habilita la optimizacion de los VDA virtuales, tal como se documenta en http://support.citrix.com/article/ctx125874.
/baseimage -> Solo valido en Windows Desktop en entorno virtual. Habilita el uso de personal vDsik en la imagen master.
/enable_hdx_3d_pro -> Instala VDA for HDX 3d Pro.
/enable_real_time_transport -> Habilita y des-habilita la comunicación UDP para audio (real time transport for audio). Habilitando esta opción, podemos mejorar el rendimiento del uso de audio. Con la opción /enable_hdx_ports, adicionalmente, abrimos los puertos necesarios en el firewall de windows.
/masterimage -> Especifica la VM actual, como imagen Master.
/virtualmachine -> Forzamos a indicar que se trata de una VM. Es utilizado cuando la información de bios pasada al hypervisor indica que se trata de una maquina física cuando no es así.
/nodesktopexperience -> Solo en Windows Server OS, previene el uso de Desktop Experience .
/nocitrixwddm -> Solo para Win7 que no incluye wddm. Des-habilita la instalación del driver Citrix wddm.
/servervdi -> Instala el agente VDA para Desktops en un Servidor.
/installwithsecurebootenabled -> Permite la instalación del VDA cuando Secure Boot esta habilitado.
Y esto es todo. Como sabeis, si necessitais mas información, podeis encontrar-la en la documentación en line que Citrix pone a nuestra disposición: http://support.citrix.com/proddocs/topic/infocenter/ic-how-to-use.html
Leave a Reply