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. El mantenimiento periódico en el Cloud Connector incluye 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 actualice la versión de componentes individuales del Cloud Connector por separado.
  • 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 local 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.
  • Si utiliza el instalador gráfico, debe tener un explorador web instalado y el explorador web del sistema predeterminado configurado.

Guía posterior a la implementación

Después de la instalación, mantenga los Cloud Connectors siempre encendidos para una conexión permanente con Citrix Cloud.

Cambiar el nombre de las máquinas

Tras 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, haga estas tareas:

  1. Quite la máquina de la ubicación de recursos:
    1. En el menú de Citrix Cloud, seleccione Ubicaciones de recursos.
    2. Busque la ubicación de recursos que quiere administrar y seleccione el mosaico de Cloud Connectors.
    3. Busque la máquina que quiere administrar y, a continuación, haga clic en el menú de tres puntos. Seleccione Quitar conector.
  2. Desinstale el software de Cloud Connector.
  3. Cambie el nombre de la máquina.
  4. Instale la versión más reciente del software de Cloud Connector, tal y como se describe en este artículo.

Mover máquinas a otro dominio

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 más adelante, haga estas tareas:

  1. Quite la máquina de la ubicación de recursos.
  2. Desinstale el software de Cloud Connector.
  3. Separe la máquina de su dominio actual y únala de nuevo al nuevo dominio.
  4. Instale la versión más reciente del software de Cloud Connector, tal y como se describe en este artículo.

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.

Consideraciones sobre los servicios

En los pasos de instalación de este artículo se describe el proceso de implementación de Cloud Connectors, independientemente del servicio para el que se usen.

Al implementar Cloud Connectors para Citrix DaaS, verifique que los dominios de AD en los que residen los conectores estén activos y no aparezcan como “no utilizado” en la consola de Citrix Cloud. Si especifica un dominio no utilizado durante la configuración del catálogo de máquinas en Citrix DaaS, es posible que se produzca 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 de producto de Citrix DaaS.

Para obtener más información sobre 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 Citrix Cloud crea 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 crear ubicaciones de recursos adicionales en Citrix Cloud y, a continuación, seleccionar la que quiera cuando instale Cloud Connectors en otros dominios.

Como alternativa, puede crear primero las ubicaciones de recursos que necesita en la consola, antes de instalar Cloud Connectors en sus dominios. Durante la instalación, el instalador de Cloud Connector le pide que seleccione la ubicación de recursos que quiere.

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 recursos.

Para crear una ubicación de recursos

  1. Inicie sesión como administrador de Windows en el equipo en el que quiere 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

Descargar el software Citrix Cloud Connector

  1. Busque la ubicación de recursos que quiere 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. (Opcional) Si fuera necesario, haga clic en Configurar proxy para agregar un servidor proxy. Se le pedirá que agregue la información del proxy.
  3. Haga clic en Iniciar sesión e instalar para iniciar sesión en Citrix Cloud.
  4. 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.
  5. 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.

Activar dominios no utilizados

Si piensa crear ubicaciones de recursos e implementar Cloud Connectors para Citrix DaaS, verifique que los dominios de AD que utiliza con Citrix DaaS estén activos y no se consideren no utilizados. Si especifica un dominio no utilizado al configurar los catálogos de máquinas en Citrix DaaS, es posible que se produzca 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 de producto de Citrix DaaS.

Crear ubicaciones de recursos adicionales

  1. En la consola de administración de Citrix Cloud, haga clic en el botón de menú y seleccione Ubicaciones de recursos.
  2. Haga clic en + Ubicación de recursos e introduzca un nombre representativo.
  3. Haga clic en Guardar. Citrix Cloud muestra un mosaico para la nueva ubicación de recursos.
  4. Haga clic en Cloud Connectors y, a continuación, en Descargar para adquirir el software Cloud Connector.
  5. En cada máquina preparada, instale el software Cloud Connector con el asistente de instalación o a través de la línea de comandos. Citrix Cloud le pedirá que seleccione la ubicación de recursos que quiere asociar al Cloud Connector.

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 quiere 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 quiere 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.

Archivo de configuración de ejemplo

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

Comando de ejemplo

El siguiente comando instala de forma silenciosa 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.

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 Novedades de Connector
  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, vaya a 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 cómo solucionar problemas de instalación, consulte la 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 de Citrix Cloud Connector como administrador; para ello, haga clic con el botón secundario 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 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.

Si continúa experimentando fallos de conectividad, utilice la utilidad de comprobación de la conectividad de Cloud Connector disponible en Knowledge Center de Citrix Support. 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: Cloud Connector Connectivity Check Failed.

Instalación de Cloud Connector