Citrix Cloud

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 tiene lugar con los privilegios del usuario que inicia la instalación. 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 del Cloud Connector

Información que revisar antes de la instalación

Consideraciones y orientación sobre la instalación

  • No instale Cloud Connector en un controlador de dominio de Active Directory ni en cualquier otra máquina de importancia crítica para la infraestructura de la ubicación de recursos. Mantenimiento habitual en el Cloud Connector realiza operaciones en la máquina que provocan una interrupción de estos recursos adicionales.
  • No descargue ni instale otros productos de Citrix en las máquinas donde aloja Cloud Connector.
  • No descargue ni instale Cloud Connector en máquinas que ya pertenecen a otras implementaciones de productos de Citrix (por ejemplo, los Delivery Controllers de una implementación de Citrix Virtual Apps and Desktops).
  • No actualice la versión de un Cloud Connector ya instalado a una versión más reciente. En su lugar, desinstale el Cloud Connector antiguo e instale el nuevo.
  • El programa de instalación de Cloud Connector se descarga desde Citrix Cloud. Por lo tanto, el explorador web debe permitir la descarga de archivos ejecutables.
  • Después de la instalación, no mueva la máquina donde se encuentra Cloud Connector a un dominio diferente. Si necesita unir la máquina a otro dominio, desinstale el Cloud Connector y vuelva a instalarlo después de unir la máquina al otro dominio.
  • Después de la instalación, mantenga los Cloud Connectors siempre encendidos para una conexión permanente con Citrix Cloud.

Consideraciones acerca de las 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 con de manera fiable con las máquinas de la ubicación de recursos. Si va a alojar Cloud Connector en varias máquinas de la ubicación de recursos y quiere usar máquinas clonadas, siga estos pasos:

  1. Prepare la plantilla de máquina según los requisitos de su entorno.
  2. Aprovisione la cantidad de máquinas que vaya a usar como Cloud Connectors.
  3. Instale Cloud Connector en cada una de las máquinas, ya sea manualmente, o mediante una instalación silenciosa.

No se admite la instalación de Cloud Connector directamente en una plantilla de máquina (antes de clonar). Si clona una máquina que ya tiene Cloud Connector instalado, los servicios de Cloud Connector no se podrán ejecutar y la máquina no podrá conectarse a Citrix Cloud.

Instalación interactiva

Puede descargar e instalar Cloud Connectors a través de la interfaz gráfica del instalador. Antes de hacerlo, deberá crear una o varias ubicaciones de recursos en la consola de administración de Citrix Cloud donde implementar los Cloud Connectors. Para obtener más información sobre las ubicaciones de recursos, consulte Ubicación de los recursos.

Para crear una ubicación de recursos

  1. Inicie sesión como administrador de Windows en el equipo en el que desea instalar Citrix Cloud Connectors.
  2. Vaya a https://citrix.cloud.com e inicie sesión en su cuenta de administrador.
  3. En la consola de Citrix Cloud, vaya a Ubicaciones de recursos en el menú principal o seleccione Modificar o agregar en Ubicaciones de recursos, en la parte superior de la página.

    Ubicaciones de recursos

  4. En Ubicaciones de recursos, seleccione + Ubicación de recursos en la parte superior de la página y guárdela con un nombre representativo.

    Agregar nueva ubicación de recursos

  5. Repita esos pasos en cada máquina que quiera usar como Cloud Connector.

Descargar el software Citrix Cloud Connector

  1. Busque la ubicación de recursos que desea administrar y seleccione + Cloud Connectors.

    Nueva ubicación de recursos sin conectores

  2. Seleccione Descargar en la ventana que se abre. Guarde el archivo cwcconnector.exe en una ubicación local de la máquina usada como conector. Agregar una ventana de Cloud Connector

Instalar el software Citrix Cloud Connector

  1. Haga clic con el botón secundario en el archivo instalador cwcconnector.exe y seleccione Ejecutar como administrador. El instalador realiza una comprobación de conectividad inicial para asegurarse de que se puede conectar a Citrix Cloud.
  2. Cuando se le solicite, inicie sesión en Citrix Cloud.
  3. Para instalar y configurar el Cloud Connector, siga las instrucciones del asistente. Cuando finaliza la instalación, el instalador realiza una última comprobación de conectividad para verificar la comunicación entre el Cloud Connector y Citrix Cloud.
  4. Repita esos pasos en otras máquinas que quiera usar como Citrix Cloud Connectors. Para tener alta disponibilidad, Citrix recomienda instalar al menos dos Cloud Connectors para cada ubicación de recursos.

Citrix Cloud muestra el Cloud Connector recientemente instalado en la página Conectores de la ubicación de recursos.

Nueva ubicación de recursos con un conector

Nueva ubicación de recursos con dos conectores

Después de la instalación, Citrix Cloud registra su dominio en Administración de acceso e identidad > Dominios. Para obtener más información, consulte Administración de acceso e identidad.

Instalación con varios clientes y ubicaciones de recursos existentes

Si usted es un administrador de varias cuentas de cliente, Citrix Cloud le pedirá que seleccione la cuenta de cliente que quiere 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 quiere asociar con el Cloud Connector.

Instalación mediante línea de comandos

La instalación puede realizarse de manera silenciosa o automática. Sin embargo, no se recomienda usar el mismo instalador para instalaciones repetidas. Descargue un nuevo Cloud Connector desde la página Ubicaciones de recursos en la consola de Citrix Cloud.

Requisitos

Para utilizar la instalación a través 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 Cloud Connector. Este ID aparece en la parte superior de la ficha Acceso a API en Administración de acceso e identidad.
  • El ID de cliente y el secreto del cliente de API seguro que desea utilizar para instalar Cloud Connector. Para adquirir estos valores, primero debe crear un cliente seguro. El ID y el secreto de cliente garantizan que el acceso a la API de Citrix Cloud esté bien protegido. Al crear un cliente seguro, el cliente opera con el mismo nivel de permisos de administrador que usted tiene. Para instalar un Cloud Connector, debe utilizar un cliente seguro creado por un administrador con acceso total, lo que significa que el cliente seguro también tiene permisos de acceso total.
  • El ID de la ubicación de recursos que desea asociar al Cloud Connector. Para obtener 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 identificador de la ubicación de recursos predeterminada.

Crear un cliente seguro

Al crear un cliente seguro, Citrix Cloud genera un ID y un secreto de cliente únicos. Deberá proporcionar estos valores cuando invoque la API a través de la línea de comandos.

  1. Desde el menú de Citrix Cloud, seleccione Administración de acceso e identidad y, luego, Acceso a API.
  2. En la ficha Clientes seguros, introduzca un nombre para el cliente y seleccione Crear cliente. Citrix Cloud genera y muestra un ID y un secreto de cliente para el cliente seguro.
  3. Seleccione Descargar para descargar el ID y el secreto de cliente en formato CSV y almacenarlo en una ubicación segura. También puede seleccionar Copiar para adquirir manualmente cada valor. Cuando haya terminado, seleccione Cerrar para volver a la consola.

Parámetros admitidos

Para garantizar la seguridad de los detalles del cliente seguro, se debe proporcionar un archivo de configuración JSON al instalador. Este archivo deberá eliminarse una vez finalizada 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 API de la consola de Citrix Cloud (dentro de Administración de acceso e identidad).
  • clientId: Obligatorio. El ID de cliente seguro que puede crear un administrador, ubicado en la página Acceso a API.
  • clientSecret: Obligatorio. El secreto de cliente seguro que puede descargarse después de crear el cliente seguro. Se encuentra en página Acceso a API.
  • resourceLocationId Recomendado. El identificador único de una ubicación de recursos existente. Seleccione el botón de ID para obtener el ID de la 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.

Un archivo de configuración de ejemplo:

{
"customerName": "\*CustomerID\*",
"clientId": "\*ClientID\*",
"clientSecret": "\*ClientSecret\*",
"resourceLocationId": "\*ResourceLocationId\*",
"acceptTermsOfService": "true"
}
<!--NeedCopy-->

Una línea de comandos de ejemplo que instala mediante el archivo de parámetros:

CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->

Use Start /Wait CWCConnector.exe /ParametersFilePath:value para examinar posibles códigos de error en caso de fallo. Puede usar el mecanismo normal que consiste en ejecutar echo %ErrorLevel% una vez completada la instalación.

Nota:

El uso de parámetros para transmitir el ID de cliente y el secreto de cliente ya no es compatible; para instalaciones automatizadas, debe utilizarse el archivo de configuración.

Siguientes pasos

  1. Configure la programación de actualizaciones de Citrix Cloud Connector. Para obtener información sobre las actualizaciones de Citrix Cloud Connector y cómo administrar programaciones de actualizaciones, consulte Actualizaciones del conector
  2. Configure un proveedor de identidades para autenticar a los suscriptores del espacio de trabajo. Puede cambiar el proveedor de identidades predeterminado de Citrix por el de Active Directory u otros proveedores de identidades en la consola de **Administración de acceso e identidad. Para obtener más información, consulte Para conectar su Active Directory a Citrix Cloud.

Solución de problemas de instalación

En esta sección, se detallan algunas formas de diagnosticar y solucionar los problemas que podrían surgir durante la instalación. Para obtener más información sobre la solución de problemas de instalación, consulte Guía de solución de problemas de Citrix Cloud Connector.

Registros de la instalación

Puede solucionar los problemas encontrados durante la instalación consultando primero los archivos de registro disponibles.

Los eventos ocurridos 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. También se agregan registros a %ProgramData%\Citrix\WorkspaceCloud\InstallLogs después de la instalación.

Códigos de salida

Dependiendo de si el proceso de instalación funciona correctamente o falla, podrían mostrarse los siguientes códigos de salida:

  • 1603: Se ha producido un error inesperado.
  • 2: Ha fallado algún requisito previo.
  • 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 aparezca el siguiente mensaje de error:

Can't reach this page.

Este error puede producirse aunque haya iniciado sesión como administrador en la máquina donde se instalará Citrix Cloud Connector. Para evitar este error, ejecute el software Cloud Connector como administrador; para ello, haga clic con el botón derecho en el instalador y seleccione Ejecutar como administrador.

Fallos de conexión

Para garantizar que el Cloud Connector pueda comunicarse con Citrix Cloud, confirme que los siguientes servicios de Citrix se encuentran en estado Inicio:

  • 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 (Servicio de alta disponibilidad de Citrix):
  • Citrix NetScaler Cloud Gateway
  • Citrix Remote Broker Provider
  • Citrix Remote HCL Server
  • Citrix Session Manager Proxy

Para obtener más información sobre estos servicios, consulte Servicios instalados.

Si continúa experimentando fallos de conectividad, utilice la utilidad de comprobación de la conectividad de Cloud Connector disponible en Citrix Support Knowledge Center. Para obtener más información, consulte CTX260337 en el sitio web de Knowledge Center.

La herramienta se puede utilizar para realizar las siguientes tareas:

  • Probar si se puede acceder a Citrix Cloud y a los servicios relacionados.
  • Comprobar si hay parámetros mal configurados.
  • Configurar los parámetros de proxy en Citrix Cloud Connector,

Para obtener más información sobre cómo resolver una comprobación de conectividad fallida, consulte CTX224133: Error en la comprobación de conectividad de Cloud Connector.

Instalación de Cloud Connector