Instalación de Cloud Connector
Puedes instalar el software de Cloud Connector de forma interactiva o usando la línea de comandos.
-
La instalación se realiza con los privilegios del usuario que la inicia. Cloud Connector requiere acceso a la nube para:
- Autenticar al usuario que realiza la instalación
- Validar los permisos del instalador
-
Descargar y configurar los servicios de Cloud Connector
-
Información que revisar antes de la instalación
- Requisitos del sistema: Para preparar las máquinas que alojarán Cloud Connector.
- Sección Exclusiones de antivirus del artículo de Tech Zone Prácticas recomendadas de seguridad de puntos finales y antivirus: Ofrece directrices para ayudarte a determinar el equilibrio adecuado entre seguridad y rendimiento para los Cloud Connectors de tu entorno. Citrix recomienda encarecidamente revisar estas directrices con los equipos de seguridad y antivirus de tu organización y realizar pruebas rigurosas en laboratorio antes de aplicarlas a un entorno de producción.
- Requisitos del sistema y de conectividad: Para asegurar que todas las máquinas que alojan Cloud Connector puedan comunicarse con Citrix Cloud.
- Configuración de proxy y firewall de Cloud Connector: Si instalas Cloud Connector en un entorno que tiene un proxy web o reglas de firewall estrictas.
-
Consideraciones de escala y tamaño para Cloud Connectors: Proporciona detalles de las capacidades máximas probadas y recomendaciones de prácticas recomendadas para configurar máquinas que alojen Cloud Connector.
-
Consideraciones y orientación para la instalación
- No instales Cloud Connector en un controlador de dominio de Active Directory ni en ninguna otra máquina crítica para la infraestructura de tu ubicación de recursos. El mantenimiento regular de Cloud Connector realiza operaciones de máquina que provocan una interrupción de estos recursos adicionales.
- No descargues ni instales otros productos de Citrix® en las máquinas que alojan Cloud Connector.
- No actualices los componentes individuales de Cloud Connector por separado.
- No descargues ni instales Cloud Connector en máquinas que pertenezcan a otras implementaciones de productos de Citrix (por ejemplo, Delivery Controllers en una implementación local de Citrix Virtual Apps and Desktops™).
- No actualices un Cloud Connector instalado previamente con una versión más reciente. En su lugar, desinstala el Cloud Connector antiguo y luego instala el nuevo.
- El instalador de Cloud Connector se descarga desde Citrix Cloud. Por lo tanto, tu navegador debe permitir la descarga de archivos ejecutables.
- Si usas el instalador gráfico, debes tener un navegador instalado y el navegador predeterminado del sistema configurado.
Orientación posterior a la implementación
Después de la instalación, mantén todos los Cloud Connectors encendidos continuamente para asegurar una conexión siempre activa a Citrix Cloud.
Cambiar el nombre de las máquinas
Después de la instalación, no cambies el nombre de la máquina que aloja Cloud Connector. Si necesitas cambiar el nombre del servidor más adelante, realiza las siguientes tareas:
- Quita la máquina de la ubicación de recursos:
- En el menú de Citrix Cloud, selecciona Ubicaciones de recursos.
- Busca la ubicación de recursos que quieres administrar y, a continuación, selecciona el mosaico Cloud Connectors.
- Busca la máquina que quieres administrar y, a continuación, haz clic en el menú de puntos suspensivos. Selecciona Quitar conector.
- Desinstala el software de Cloud Connector.
- Cambia el nombre de la máquina.
- Instala la versión más reciente del software de Cloud Connector, como se describe en este artículo.
Mover máquinas a un dominio diferente
Después de la instalación, no muevas la máquina que aloja Cloud Connector a un dominio diferente. Si necesitas unir la máquina a un dominio diferente más adelante, realiza las siguientes tareas:
- Quita la máquina de la ubicación de recursos.
- Desinstala el software de Cloud Connector.
- Desvincula la máquina de su dominio actual y vuelve a unirla al nuevo dominio.
- Instala la versión más reciente del software de Cloud Connector, como se describe en este artículo.
Consideraciones para máquinas clonadas
Cada máquina que aloja Cloud Connector debe tener un SID y un ID de conector únicos para que Citrix Cloud pueda comunicarse de forma fiable con las máquinas de tu ubicación de recursos. Si tienes la intención de alojar Cloud Connector en varias máquinas de tu ubicación de recursos y quieres usar máquinas clonadas, realiza los siguientes pasos:
- Prepara la plantilla de máquina según los requisitos de tu entorno.
- Aprovisiona el número de máquinas que tienes la intención de usar como Cloud Connectors.
- Instala Cloud Connector en cada máquina, ya sea manualmente o usando el modo de instalación silenciosa.
No se admite la instalación de Cloud Connector en una plantilla de máquina (antes de la clonación). Si clonas una máquina con Cloud Connector instalado, los servicios de Cloud Connector no se ejecutarán y la máquina no podrá conectarse a Citrix Cloud.
Consideraciones para los servicios
Los pasos de instalación de este artículo describen el proceso para implementar Cloud Connectors, independientemente del servicio para el que se usen.
Al implementar Cloud Connectors para Citrix DaaS, verifica que los dominios de AD donde residen los conectores estén activos y no aparezcan como “sin usar” en la consola de Citrix Cloud. Si especificas un dominio sin usar durante la configuración del catálogo de máquinas en Citrix DaaS, podría producirse un error. Para obtener más información, consulta Agregar un tipo de recurso o activar un dominio sin usar en Citrix Cloud en la documentación del producto Citrix DaaS.
Para consideraciones adicionales sobre otros servicios, consulta la documentación del servicio.
Ubicaciones de recursos predeterminadas
Si no tienes ubicaciones de recursos en tu cuenta de Citrix Cloud e instalas Cloud Connectors en tu dominio, la ubicación de recursos que Citrix Cloud crea se convierte en la ubicación de recursos predeterminada. Solo puedes tener una ubicación de recursos predeterminada en tu cuenta. Si es necesario, puedes crear ubicaciones de recursos adicionales en Citrix Cloud y, a continuación, seleccionar la que quieras al instalar Cloud Connectors en otros dominios.
Alternativamente, puedes crear primero las ubicaciones de recursos que necesites en la consola, antes de instalar Cloud Connectors en tus dominios. El instalador de Cloud Connector te pide que selecciones la ubicación de recursos que quieras durante la instalación.
Instalación interactiva
Puedes descargar e instalar Cloud Connectors usando la interfaz gráfica del instalador. Antes de hacerlo, debes crear una o varias ubicaciones de recursos en la consola de administración de Citrix Cloud para implementar Cloud Connectors. Para obtener más información sobre las ubicaciones de recursos, consulta Ubicaciones de recursos.
Descargar el software Citrix Cloud Connector™
-
Inicia sesión como administrador de Windows en la máquina donde quieras instalar los Citrix Cloud Connectors.
-
Visita https://citrix.cloud.com e inicia sesión en tu cuenta de administrador.
-
En la consola de Citrix Cloud, ve a Ubicaciones de recursos desde el menú principal.
-
Si aún no tienes una ubicación de recursos, haz clic en el icono más (+) o selecciona Agregar una ubicación de recursos. Para obtener más información, consulta crear una ubicación de recursos.
-
Busca la ubicación de recursos que quieras administrar y selecciona + Cloud Connectors.
-
Selecciona Descargar en la ventana que se abre. Guarda el archivo cwcconnector.exe en una ubicación de archivo local en tu máquina de conector.
Instalar el software Citrix Cloud Connector
-
Requisitos previos
-
- Haz clic con el botón derecho en el archivo de instalación
cwcconnector.exey selecciona Ejecutar como administrador. El instalador realiza una comprobación de conectividad inicial para asegurarse de que puedes conectarte a Citrix Cloud antes de instalar el Cloud Connector.
- Haz clic con el botón derecho en el archivo de instalación
-
- Haz clic en Administrar para actualizar el servidor proxy.
Nota:
Solo se admite un servidor proxy debido a una limitación en Microsoft WinHTTP. Para obtener más información, consulta Problemas de AutoProxy en WinHTTP
-
Haz clic en Comprobación de conectividad avanzada para ejecutar una comprobación detallada y asegurarte de que se cumplen los requisitos básicos de conectividad para la instalación del conector en la máquina.
Actualización y pruebas iniciales
-
Después de actualizar el servidor proxy y comprobar la Comprobación de conectividad avanzada, haz clic en Instalar Cloud Connector.
-
En la página de Inicio de sesión, haz clic en Iniciar sesión e instalar
-
- Aparece la ventana Prueba de conectividad de Citrix Cloud y se muestra el estado de la actualización y las pruebas iniciales junto con los registros de eventos.
-
Haz clic en Ver registros para abrir el directorio
(C:\ProgramData\Citrix\WorkspaceCloud\InstallLogs)que incluye todos los registros de depuración de la comprobación de conectividad. -
Una vez completadas la actualización y las pruebas iniciales, verás que la Prueba de conectividad de Citrix Cloud es Correcta, como se muestra en la siguiente imagen. Los resultados de la comprobación de conectividad se muestran en el cuadro de registro de eventos después de la primera actualización.
Activar dominios no utilizados
Si estás creando ubicaciones de recursos e implementando Cloud Connectors para Citrix DaaS™, verifica que los dominios de AD que estás usando con Citrix DaaS estén activos y no se consideren no utilizados. Si especificas un dominio no utilizado al configurar catálogos de máquinas en Citrix DaaS, podría producirse un error.
Para obtener más información, consulta Agregar un tipo de recurso o activar un dominio no utilizado en Citrix Cloud en la documentación del producto Citrix DaaS.
Crear ubicaciones de recursos adicionales
- En la consola de administración de Citrix Cloud, haz clic en el botón de menú y selecciona Resource Locations (Ubicaciones de recursos).
- Haz clic en + Resource Location (+ Ubicación de recursos) e introduce un nombre significativo.
- Haz clic en Save (Guardar). Citrix Cloud muestra un mosaico para la nueva ubicación de recursos.
- Haz clic en Cloud Connectors y, a continuación, haz clic en Download (Descargar) para obtener el software de Cloud Connector.
- En cada máquina preparada, instala el software de Cloud Connector mediante el asistente de instalación o la instalación por línea de comandos. Citrix Cloud te pedirá que selecciones la ubicación de recursos que quieres asociar con el Cloud Connector.
Instalación con varios clientes y ubicaciones de recursos existentes
Si eres administrador de varias cuentas de cliente, Citrix Cloud te pedirá que selecciones la cuenta de cliente que quieres asociar con el Cloud Connector.
Si tu cuenta de cliente ya tiene varias ubicaciones de recursos, Citrix Cloud te pedirá que selecciones la ubicación de recursos que quieres asociar con el Cloud Connector.
Instalación por línea de comandos
Se admite la instalación silenciosa o automatizada. Sin embargo, el instalador del conector se actualiza periódicamente, por lo que se recomienda descargar el instalador más reciente para cada instalación. Descarga un nuevo instalador de Cloud Connector desde la página Resource Locations (Ubicaciones de recursos) en la consola de Citrix Cloud.
Para usar la instalación por línea de comandos con Citrix Cloud, debes proporcionar la siguiente información:
- El ID de cliente de la cuenta de Citrix Cloud para la que estás instalando el Cloud Connector. Este ID aparece en la parte superior de la ficha API Access (Acceso a la API) en Identity and Access Management (Administración de identidades y accesos).
- El ID y el secreto de la entidad de seguridad que quieres usar para instalar el Cloud Connector. Para obtener estos valores, primero debes crear una entidad de seguridad. La entidad de seguridad debe crearse con “Full Access” (Acceso total). Para obtener más información sobre cómo crear una entidad de seguridad, consulta Create a Service Principal. Una vez que tengas el ID y el secreto de la entidad de seguridad, puedes continuar con la instalación del Cloud Connector.
-
El ID de ubicación de recursos para la ubicación de recursos que quieres asociar con el Cloud Connector. Para recuperar este valor, selecciona el botón ID situado debajo del nombre de la ubicación de recursos en la página Resource Locations (Ubicaciones de recursos). Si no proporcionas este valor, Citrix Cloud usa el ID de la ubicación de recursos predeterminada.
-
Parámetros admitidos
-
Para garantizar la seguridad del ID y el secreto de la entidad de seguridad, se debe proporcionar un archivo de configuración JSON al instalador. Este archivo debe eliminarse una vez completada la instalación. Los valores admitidos para el archivo de configuración son:
- customerName Obligatorio. El ID de cliente que se muestra en la página Acceso a la API en la consola de Citrix Cloud (dentro de Administración de identidades y accesos).
- clientId Obligatorio. El ID de entidad de seguridad que un administrador puede crear, ubicado en la página Acceso a la API.
- clientSecret Obligatorio. El secreto de la entidad de seguridad que se puede descargar después de crear la entidad de seguridad. Ubicado en la página Acceso a la API.
- resourceLocationId Recomendado. El identificador único de una ubicación de recursos existente. Selecciona el botón ID para recuperar el ID de ubicación de recursos en la página Ubicaciones de recursos de la consola de Citrix Cloud. Si no se especifica ningún valor, Citrix Cloud utiliza el ID de la primera ubicación de recursos de la cuenta.
-
acceptTermsOfService Obligatorio. Debe establecerse en true.
-
Archivo de configuración de ejemplo
{
"customerName": "CustomerID",
"clientId": "SecurePrincipalID",
"clientSecret": "ClientSecret",
"resourceLocationId": "ResourceLocationId",
"acceptTermsOfService": "true"
}
<!--NeedCopy-->
Comando de ejemplo
El siguiente comando instala de forma silenciosa el software de Cloud Connector mediante un archivo de configuración JSON:
CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->
Usa /q para especificar una instalación silenciosa.
Usa Start /Wait CWCConnector.exe /ParametersFilePath:value para examinar un posible código de error en caso de fallo. Puedes usar el mecanismo estándar de ejecutar echo %ErrorLevel% una vez completada la instalación.
Configuración HTTPS
Para permitir que los dispositivos StoreFront™ y NetScaler Gateway se conecten de forma segura al Cloud Connector y cifren todos los datos, se recomienda encarecidamente habilitar HTTPS. Esto requiere un certificado SSL.
- El certificado debe incluir el FQDN utilizado para llegar al conector como Nombre común o Nombre alternativo del sujeto. Si has implementado un equilibrador de carga delante del conector, usa el FQDN del equilibrador de carga.
- El certificado puede estar firmado por una CA empresarial o una CA pública.
- Cualquier servidor StoreFront y Gateway que se conecte al Cloud Connector debe confiar en el certificado.
Para habilitar HTTPS:
-
Abre el complemento MMC de certificados.
-
Crea o importa un certificado adecuado en el almacén de certificados personales. Para obtener más información sobre la administración de certificados, consulta Administrar certificados.
-
Abre el certificado, ve a la ficha Details (Detalles) y anota la Thumbprint (Huella digital), ignorando los espacios.
-
Determina a qué dirección IP vincular el certificado. Normalmente, puedes usar la dirección IP
0.0.0.0para aplicarla a todas las direcciones IPv4. Si IPv6 está habilitado, usa[::]para aplicarla a todas las direcciones IPv6. Si solo quieres aplicar el cambio a un adaptador de red específico, anota la dirección IP del adaptador de red. -
En un símbolo del sistema con privilegios elevados, ejecuta
netsh http add sslcert ipport=<IP address>:<Port number> certhash=<Certificate Hash Number> appid={Any GUID} <!--NeedCopy-->Puedes usar cualquier GUID válido para el AppId. Su propósito es registrar qué aplicación agregó el enlace. Sin embargo, el enlace se aplica a todas las aplicaciones que usan ese puerto.
Por ejemplo:
C:\> netsh http add sslcert ipport=0.0.0.0:443 certhash=BC96F958848639FD101A793B87915D5F2829B0B6 appid={6DE9BEFD-F4CB-4D63-8681-E88012D6F5F1} SSL Certificate successfully added <!--NeedCopy--> -
Para deshabilitar HTTP, en el registro, ve a
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServery crea unDWORDcon el nombreXMLServicesEnableNonSSLy el valor 0.
Pasos siguientes
- Configura la programación de actualizaciones de Citrix Cloud Connector. Para obtener información sobre las actualizaciones de Citrix Cloud Connector y la administración de las programaciones de actualizaciones, visita Actualizaciones del conector.
- Si usas StoreFront, configura StoreFront para que pueda usar el conector para llegar a DaaS y enumerar e iniciar recursos. Si este es el primer conector en una nueva implementación de DaaS, entonces crea una nueva fuente de recursos. Si este es un conector adicional, se recomienda, para mayor resiliencia, que agregues todos los Cloud Connectors a la lista de servidores de tu fuente de recursos de DaaS existente. Para obtener más información, consulta Administrar los recursos disponibles en los almacenes.
- Si usas StoreFront con una puerta de enlace de NetScaler, puedes usar el conector para llegar a la Autoridad de Tickets Seguros (STA) de Citrix Cloud. Para obtener más información, consulta Configurar Citrix Gateways.
- Si este es el primer conector en un dominio de Active Directory en particular, entonces puedes conectar ese dominio a Citrix Cloud. Para obtener más información, consulta Para conectar tu Active Directory a Citrix Cloud.
Solución de problemas de instalación
Esta sección detalla algunas formas de diagnosticar y solucionar problemas que puedes encontrar durante la instalación. Para obtener más orientación sobre la solución de problemas de instalación, consulta la Guía de solución de problemas de Citrix Cloud Connector.
Registros de instalación
Puedes solucionar los problemas encontrados durante la instalación consultando primero los archivos de registro disponibles.
Los eventos que ocurrieron durante la instalación están disponibles en el Visor de eventos de Windows. También puedes revisar los registros de instalación de Cloud Connector, que se encuentran en %LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup. Los registros también se agregan a %ProgramData%\Citrix\WorkspaceCloud\InstallLogs después de la instalación.
Códigos de salida
Los siguientes códigos de salida pueden devolverse dependiendo del éxito o fracaso del proceso de instalación:
- 1603 - Se produjo un error inesperado
- 2 - Falló una comprobación de requisitos previos
- 0 - La instalación se completó correctamente
Error de instalación
Si instalas el software Citrix Cloud Connector haciendo doble clic en el instalador, es posible que recibas el siguiente mensaje de error:
No se puede acceder a esta página.
Este error puede ocurrir incluso si has iniciado sesión en la máquina como administrador para instalar Citrix Cloud Connector. Para evitar este error, ejecuta el software Citrix Cloud Connector como administrador haciendo clic con el botón derecho en el instalador y seleccionando Ejecutar como administrador.
Errores de conectividad
Para asegurarte de que Cloud Connector pueda comunicarse con Citrix Cloud, confirma que los siguientes servicios de Citrix estén en estado de Iniciado:
- Citrix Cloud AD Provider
- Citrix Cloud Agent Logger
- Citrix Cloud Agent System
- Citrix Cloud Agent Watchdog
- Citrix Cloud Credential Provider
- Citrix Config Synchronizer Service
- Citrix High Availability Service
- Citrix NetScaler® CloudGateway
- Citrix Remote Broker Provider
- Citrix Remote HCL Server
- Citrix Session Manager Proxy
Para obtener más información sobre estos servicios, consulta Servicios instalados.
La herramienta de comprobación de conectividad avanzada de Cloud Connector puede ayudarte a verificar que Cloud Connector pueda llegar a Citrix Cloud y sus servicios relacionados.
Para obtener más información, consulta Herramienta de comprobación de conectividad avanzada de Cloud Connector.
Para obtener más información sobre cómo resolver una comprobación de conectividad fallida, consulta CTX224133: Falló la comprobación de conectividad de Cloud Connector.