Instalación de Cloud Connector
Puede instalar el software de Cloud Connector de forma interactiva o mediante la línea de comandos.
La instalación se realiza con los privilegios del usuario que la inicia. El 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 debe revisar antes de la instalación
Revise los requisitos del sistema antes de la instalación.
Guía posterior a la implementación
Después de la instalación, mantenga todos los Cloud Connectors encendidos continuamente para garantizar una conexión permanente a Citrix Cloud.
Actualizaciones
Las actualizaciones suelen ser administradas automáticamente por Citrix Cloud. Para realizar una actualización manual, primero desinstale el Cloud Connector antiguo antes de instalar la nueva versión. No actualice un Cloud Connector instalado previamente con una versión más reciente. No actualice los componentes individuales del Cloud Connector por separado.
Cambiar el nombre de las máquinas
Después de la instalación, no cambie el nombre de la máquina que aloja el Cloud Connector. Si necesita cambiar el nombre del servidor más adelante, realice las siguientes tareas:
- Quite la máquina de la ubicación de recursos:
- Desde el menú de Citrix Cloud, seleccione Ubicaciones de recursos.
- Busque la ubicación de recursos que quiera administrar y, a continuación, seleccione el mosaico de Cloud Connectors.
- Busque la máquina que quiera administrar y, a continuación, haga clic en el menú de puntos suspensivos. Seleccione Quitar conector.
- Desinstale el software de Cloud Connector.
- Cambie el nombre de la máquina.
- Instale la versión más reciente del software de Cloud Connector, tal como se describe en este artículo.
Mover máquinas a un dominio diferente
Después de la instalación, no mueva la máquina que aloja el Cloud Connector a un dominio diferente. Si necesita unir la máquina a un dominio diferente más adelante, realice las siguientes tareas:
- Quite la máquina de la ubicación de recursos.
- Desinstale el software de Cloud Connector.
- Desvincule la máquina de su dominio actual y vuelva a vincularla al nuevo dominio.
- Instale la versión más reciente del software de Cloud Connector, tal como se describe en este artículo.
Consideraciones para máquinas clonadas
Cada máquina que aloja el 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 su ubicación de recursos. Si tiene la intención de alojar el Cloud Connector en varias máquinas de su ubicación de recursos y desea utilizar máquinas clonadas, realice los siguientes pasos:
- Prepare la plantilla de la máquina según los requisitos de su entorno.
- Aprovisione el número de máquinas que tiene previsto utilizar como Cloud Connectors.
- Instale el Cloud Connector en cada máquina, manualmente o mediante el modo de instalación silenciosa.
No se admite la instalación del Cloud Connector en una plantilla de máquina (antes de la clonación). Si clona una máquina con el 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 utilicen.
Al implementar Cloud Connectors para Citrix DaaS, verificar 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 especifica 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, consulte Add a resource type or activate an unused domain in Citrix Cloud en la documentación del producto Citrix DaaS.
Para consideraciones adicionales para otros servicios, consulte la documentación del servicio.
Ubicaciones de recursos predeterminadas
Si no tiene ubicaciones de recursos en su cuenta de Citrix Cloud e instala Cloud Connectors en su dominio, la ubicación de recursos que crea Citrix Cloud se convierte en la ubicación de recursos predeterminada. Solo puede tener una ubicación de recursos predeterminada en su cuenta. Si es necesario, puede create additional resource locations en Citrix Cloud y, a continuación, seleccionar la que desee al instalar Cloud Connectors en otros dominios.
Alternativamente, puede crear primero las ubicaciones de recursos que necesite en la consola, antes de instalar Cloud Connectors en sus dominios. El instalador de Cloud Connector le pedirá que seleccione la ubicación de recursos que desee durante la instalación.
Instalación interactiva
Puede descargar e instalar Cloud Connectors mediante la interfaz gráfica del instalador. Antes de hacerlo, debe 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, consulte Resource locations.
Descargar el software Citrix Cloud Connector™
-
Inicie sesión como administrador de Windows en la máquina en la que tiene previsto instalar Citrix Cloud Connectors.
-
Visite https://citrix.cloud.com e inicie sesión en su cuenta de administrador.
-
En la consola de Citrix Cloud, vaya a Ubicaciones de recursos desde el menú principal.
-
Si aún no tiene una ubicación de recursos, haga clic en el icono de más (+) o seleccione Agregar una ubicación de recursos. Para obtener más información, consulte crear una ubicación de recursos.
-
Busque la ubicación de recursos que desea administrar y seleccione + Conectores en la nube.
-
Seleccione Descargar en la ventana que se abre. Guarde el archivo cwcconnector.exe en una ubicación de archivo local en su máquina de conector.
Instalar el software de Citrix Cloud Connector
Requisitos previos
-
Haga clic con el botón derecho en el archivo de instalación
cwcconnector.exey seleccione Ejecutar como administrador. El instalador realiza una comprobación de conectividad inicial para asegurarse de que puede conectarse a Citrix Cloud antes de instalar el Cloud Connector. -
Haga 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, consulte Problemas de AutoProxy en WinHTTP
-
Haga clic en Comprobación de conectividad avanzada para ejecutar una comprobación detallada y asegurarse de que se cumplen los requisitos básicos de conectividad para la instalación del conector en la máquina.
Actualización inicial y pruebas
-
Después de actualizar el servidor proxy y comprobar la comprobación de conectividad avanzada, haga clic en Instalar Cloud Connector.
-
En la página de Inicio de sesión, haga clic en Iniciar sesión e instalar
Inicio de sesión de Cloud Connector(/es-es/citrix-cloud/media/cloud-connector-login.png)
-
Aparece la ventana Prueba de conectividad de Citrix Cloud y se muestra el estado de la actualización inicial y las pruebas junto con los registros de eventos.
Pruebas iniciales en curso(/es-es/citrix-cloud/media/initial-tests-in-progress.png)
-
Haga 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 inicial y las pruebas, verá 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.
Pruebas iniciales completadas(/es-es/citrix-cloud/media/initial-tests-complete.png)
Activar dominios no utilizados
Si está creando ubicaciones de recursos e implementando Cloud Connectors para Citrix DaaS™, verificar que los dominios de AD que utiliza con Citrix DaaS están activos y no se consideran no utilizados. Si especifica 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, consulte 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
- Desde la consola de administración de Citrix Cloud, haga clic en el botón de menú y seleccione Ubicaciones de recursos.
- Haga clic en + Ubicación de recursos e introduzca un nombre significativo.
- Haga clic en Guardar. Citrix Cloud muestra un mosaico para la nueva ubicación de recursos.
- Haga clic en Cloud Connectors y, a continuación, haga clic en Descargar para obtener el software de Cloud Connector.
- En cada máquina preparada, instale el software de Cloud Connector utilizando el asistente de instalación o la instalación de línea de comandos. Citrix Cloud le pedirá que seleccione la ubicación de recursos que desea asociar con el Cloud Connector.
Instalación con varios clientes y ubicaciones de recursos existentes
Si es administrador de varias cuentas de cliente, Citrix Cloud le pedirá que seleccione la cuenta de cliente que desea asociar con el Cloud Connector.
Si su cuenta de cliente ya tiene varias ubicaciones de recursos, Citrix Cloud le pedirá que seleccione la ubicación de recursos que desea asociar con el Cloud Connector.
Instalación de línea de comandos
Se admite la instalación silenciosa o automatizada. Sin embargo, el instalador del conector se actualiza regularmente, por lo que se recomienda descargar el instalador más reciente para cada instalación. Descargue un nuevo instalador de Cloud Connector desde la página Ubicaciones de recursos en la consola de Citrix Cloud.
Requisitos
Para utilizar la instalación de línea de comandos con Citrix Cloud, debe proporcionar la siguiente información:
- El ID de cliente de la cuenta de Citrix Cloud para la que está instalando el Cloud Connector. Este ID aparece en la parte superior de la ficha Acceso a la API en Administración de identidades y accesos.
- El ID y el secreto del principal seguro que desea utilizar para instalar el Cloud Connector. Para obtener estos valores, primero debe crear un principal seguro. El principal seguro debe crearse con “Acceso completo”. Para obtener más información sobre cómo crear un principal de servicio, consulte Crear un principal de servicio. Una vez que tenga el ID y el secreto del principal seguro, puede continuar con la instalación del Cloud Connector.
- El ID de ubicación de recursos para la ubicación de recursos que desea asociar con el Cloud Connector. Para recuperar este valor, seleccione el botón ID situado debajo del nombre de la ubicación de recursos en la página Ubicaciones de recursos. Si no proporciona este valor, Citrix Cloud utiliza el ID de la ubicación de recursos predeterminada.
Parámetros admitidos
Para garantizar la seguridad del ID y el secreto del principal seguro, se debe proporcionar un archivo de configuración JSON al instalador. Este archivo debe eliminarse una vez finalizada la instalación. Los valores admitidos para el archivo de configuración son:
- customerName Requerido. El ID de cliente que se muestra en la página Acceso a la API de la consola de Citrix Cloud (dentro de Administración de identidades y accesos).
- clientId Requerido. El ID de entidad de seguridad que un administrador puede crear, ubicado en la página Acceso a la API.
- clientSecret Requerido. El secreto de entidad de seguridad que se puede descargar después de crear la entidad de seguridad. Se encuentra en la página Acceso a la API.
- resourceLocationId Recomendado. El identificador único de una ubicación de recursos existente. Seleccione 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 Requerido. 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 silenciosamente el software Cloud Connector mediante un archivo de configuración JSON:
CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->
Utilice /q para especificar una instalación silenciosa.
Utilice Start /Wait CWCConnector.exe /ParametersFilePath:value para examinar un posible código de error en caso de fallo. Puede utilizar el mecanismo estándar de ejecutar echo %ErrorLevel% una vez finalizada 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 ha implementado un equilibrador de carga delante del conector, utilice el FQDN del equilibrador de carga.
- El certificado puede estar firmado por una CA empresarial o una CA pública.
- Cualquier servidor StoreFront y de puerta de enlace que se conecte al Cloud Connector debe confiar en el certificado.
Para habilitar HTTPS:
-
Abra el complemento MMC de certificados.
-
Cree o importe un certificado adecuado en el almacén de certificados personales. Para obtener más información sobre la administración de certificados, consulte Administrar certificados.
-
Abra el certificado, vaya a la ficha Detalles y anote la Huella digital, ignorando los espacios.
-
Determine a qué dirección IP se debe vincular el certificado. Normalmente, puede usar la dirección IP de
0.0.0.0para aplicarla a todas las direcciones IPv4. Si IPv6 está habilitado, use[::]para aplicarla a todas las direcciones IPv6. Si solo quiere aplicar el cambio a un adaptador de red específico, anote la dirección IP de ese adaptador de red. -
En un símbolo del sistema con privilegios elevados, ejecute
netsh http add sslcert ipport=<IP address>:<Port number> certhash=<Certificate Hash Number> appid={Any GUID} <!--NeedCopy-->Puede usar cualquier GUID válido para 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 inhabilitar HTTP, en el Registro, vaya a
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServery cree unDWORDcon el nombreXMLServicesEnableNonSSLy el valor 0.
Pasos siguientes
- Configure 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, visite Actualizaciones de Connector.
- Si utiliza StoreFront, configúrelo 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, cree una nueva fuente de recursos. Si se trata de un conector adicional, se recomienda, por motivos de resiliencia, que agregue todos los Cloud Connectors a la lista de servidores de su fuente de recursos de DaaS existente. Para obtener más información, consulte Administrar los recursos disponibles en los almacenes.
- Si utiliza StoreFront con una puerta de enlace NetScaler, puede usar el conector para llegar a la Autoridad de tickets seguros (STA) de Citrix Cloud. Para obtener más información, consulte Configurar Citrix Gateways.
- Si este es el primer conector en un dominio de Active Directory en particular, puede conectar ese dominio a Citrix Cloud. Para obtener más información, consulte Para conectar su Active Directory a Citrix Cloud.
Solución de problemas de instalación
Esta sección detalla algunas formas de diagnosticar y solucionar problemas que pueden surgir durante la instalación. Para obtener más información sobre la solución de problemas de instalación, consulte la Guía de solución de problemas de Citrix Cloud Connector.
Registros de instalación
Puede 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 puede revisar los registros de instalación de Cloud Connector, que se encuentran en %LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup. Los registros también se añaden a %ProgramData%\Citrix\WorkspaceCloud\InstallLogs después de la instalación.
Códigos de salida
Los siguientes códigos de salida pueden devolverse en función del éxito o el fracaso del proceso de instalación:
- 1603 - Se produjo un error inesperado
- 2 - Falló una comprobación de requisitos previos
- 0 - Instalación completada correctamente
Error de instalación
Si instala el software Citrix Cloud Connector haciendo doble clic en el instalador, es posible que reciba el siguiente mensaje de error:
Can't reach this page.
Este error puede ocurrir incluso si ha iniciado sesión en la máquina como administrador para instalar Citrix Cloud Connector. Para evitar este error, ejecute el software Citrix Cloud Connector como administrador haciendo clic con el botón derecho en el instalador y seleccionando Ejecutar como administrador.
Fallos de conectividad
Para asegurarse de que el Cloud Connector pueda comunicarse con Citrix Cloud, confirme que los siguientes servicios de Citrix estén en estado 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, consulte Servicios instalados.
La herramienta Cloud Connector Advanced Connectivity Check Tool puede ayudar a verificar que el Cloud Connector puede llegar a Citrix Cloud y sus servicios relacionados.
Para obtener más información, consulte Cloud Connector Advanced Connectivity Check Tool.
Para obtener más información sobre cómo resolver un error en la comprobación de conectividad, consulte CTX224133: Error en la comprobación de conectividad de Cloud Connector.