Saltar al contenido principal

Instalar Qlik DataTransfer

Qlik DataTransfer es una aplicación ligera de Windows que permite cargar datos desde fuentes de datos locales a un espacio empresarial de Qlik Sense SaaS sin tunelización del firewall. El propietario de la cuenta de servicio (SAO) o administrador del espacio empresarial genera una clave de API desde el espacio empresarial que posteriormente se utiliza para autenticar Qlik DataTransfer. Una vez realizada la autenticación, puede programar recargas de datos automáticas o cargar datos manualmente.

Nota: Qlik DataTransfer admite comunicaciones cifradas, pero no cumple con los FIPS (Estándares federales de procesamiento de información). Los usuarios de Qlik Sense Enterprise SaaS - Government (US) pueden utilizarlo en su implementación a la espera de su propia revisión de riesgos.

Qlik DataTransfer funciona con los siguientes tipos de fuentes de datos:

  • Datos de app
  • Datos de conexión
  • Carpetas

Para obtener información sobre los tipos de datos que hay disponibles con Qlik DataTransfer, consulte Cargar datos locales con Qlik DataTransfer.

Una instalación de Qlik DataTransfer solo puede estar asociada con un único espacio empresarial de Qlik Sense SaaS.

Antes de comenzar

Antes de descargar el instalador de Qlik DataTransfer y ejecutarlo, asegúrese de que se cumplan los requisitos siguientes:

  • Tiene acceso al espacio empresarial de Qlik Sense SaaS.
  • Tiene acceso de tipo Professional a su espacio empresarial inquilino.
  • Tiene asignado un rol de desarrollador en ese espacio empresarial inquilino.
  • Tiene acceso a todos los espacios en los que carga datos desde Qlik DataTransfer. Para más información, vea Administrar espacios.
  • Tiene permisos de administrador en una máquina Windows con acceso a fuentes de datos locales.
  • La máquina Windows cumple los siguientes requisitos del sistema: Requisitos del sistema para Qlik DataTransfer (solo en inglés).
  • Las claves de API están habilitadas en Management Console. Para obtener más información sobre la habilitación de claves de API, vea Administrar claves de API.
  • Debe establecerse la política SSL Configuration Settings para que solo admita cifrados en formato IANA en la máquina en la que está instalando Qlik DataTransfer.

    Si está instalando o actualizando a Qlik DataTransfer May 2021 o posterior en Windows Server 2012 R2, debe actualizar el conjunto de cifrado TLS Cipher Suite. Los cifrados predeterminados incluidos en la política de seguridad predeterminada de Windows Server 2021 R2 no son compatibles con Qlik DataTransfer May 2021 o posterior. Deben estar presentes los siguientes conjuntos de cifrado:

    • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

    • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    Para obtener instrucciones sobre cómo actualizar TLS Cipher Suite en su sistema o para deshabilitar cifrados débiles en el entorno Qlik DataTransfer, consulte el siguiente artículo: https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

  • Qlik DataTransfer requiere una cuenta de usuario de Windows. Se recomienda que utilice una cuenta de usuario dedicada para ejecutar el servicio Qlik DataTransfer. Si el usuario dedicado es un administrador, puede iniciar sesión como dicho usuario para instalar Qlik DataTransfer. Si el usuario dedicado no es un administrador local, debe usar una cuenta de administrador para instalar Qlik DataTransfer.

    Si está instalando o actualizando en un servidor Qlik DataTransfer con Qlik Sense Enterprise on Windows instalado, Qlik DataTransfer debe estar instalado con el usuario de servicios Qlik Sense utilizado en la visualización de Qlik Sense.

  • La cuenta de usuario que instale Qlik DataTransfer debe tener permiso para ejecutar scripts de PowerShell con la política de ejecución RemoteSigned.

  • Si cambia la cuenta de inicio de sesión del servicio después de configurar Qlik Data Transfer con su espacio empresarial inquilino, debe volver a configurar el espacio empresarial inquilino y las conexiones. Después, en %Datos de programa%/Qlik/DataTransfer/DataUpload/storage, elimine token.json. Reinicie el servicio Qlik DataTransfer.

  • Para la versión February 2021 SR1, se recomienda instalar Qlik DataTransfer en un servidor distinto del de Qlik Sense Enterprise on Windows o QlikView Server. Si Qlik DataTransfer está instalado en el servidor de Qlik Sense Enterprise on Windows o QlikView Server, Qlik DataTransfer se ejecuta utilizando la cuenta de usuario del sistema local. Si cambia la cuenta de usuario del servicio, se detendrá Qlik DataTransfer o Qlik Sense Service Dispatcher.

Sugerencia: El instalador de Qlik DataTransfer incluye una instancia de Qlik associative engine, conectores ODBC de Simba y el agente de Qlik DataTransfer. Cuando se ejecuta, consume recursos de memoria y de procesamiento adicionales, lo cual se debe tener en cuenta si el servidor comparte recursos con otras aplicaciones. En un entorno de producción, se recomienda instalar Qlik DataTransfer en un servidor propio.

Confirmación de la política de ejecución de la cuenta de usuario de instalación

La cuenta de usuario que instale Qlik DataTransfer debe tener permiso para ejecutar scripts de PowerShell con la política de ejecución RemoteSigned . Si no tiene permiso para asignar los permisos de las cuentas de usuario, comuníquese con su administrador para otorgar estos permisos a la cuenta de usuario de instalación.

  1. Abra PowerShell en modo administrador.

  2. Ejecute Get-ExecutionPolicy. Debería ser RemoteSigned. Si es Restricted o Disabled, vaya al siguiente paso.

  3. Ejecute Set-ExecutionPolicy RemoteSigned.

  4. Seleccione Y.

Descargar y ejecutar el instalador

Nota:

Si está instalando o actualizando en un servidor Qlik DataTransfer con Qlik Sense Enterprise on Windows instalado, Qlik DataTransfer debe estar instalado con el usuario de servicios Qlik Sense utilizado en la visualización de Qlik Sense.

  1. Descargue el archivo Qlik DataTransfer.exe de cualquiera de estas ubicaciones:

    1. El sitio de Descargas de Qlik.

    2. El centro de control en la nube. Haga clic en el icono de perfil en la esquina superior derecha y en Configuración de perfil. Esta opción no está disponible en Qlik Sense Enterprise SaaS - Government (US).

  2. Ejecute el instalador y acepte el Acuerdo de licencia de usuario de Qlik. La ruta de instalación predeterminada es %Archivos de programa%\Qlik\DataTransfer. Al ingresar las credenciales del servicio, el nombre de usuario debe tener el formato dominio\nombre de usuario.

    Nota:

    Si inserta un nombre de usuario que tiene más de 20 caracteres, debe estar en formato de Nombre principal de usuario (UPN) y debe incluir el nombre de dominio completo. Por ejemplo, nombrelargodeusuario@nombre.dominio.completo.

    Nota:

    Si tiene una plataforma de Qlik Sense Desktop u otra plataforma de Qlik instaladas en el mismo servidor, debe apagarlas y detener los servicios de Qlik antes de instalar Qlik DataTransfer.

    Pantalla del instalador de Qlik DataTransfer

    Una vez instalado, reinicie los servicios de Qlik en el orden siguiente:

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

  3. En la ventana Service credentials (Credenciales del servicio), inserte el nombre de usuario y la contraseña de la cuenta que desea usar para ejecutar los servicios de Qlik DataTransfer.

El instalador crea un acceso directo en el escritorio para iniciar la aplicación Qlik DataTransfer.

Puertos

Qlik DataTransfer utiliza los puertos siguientes:

Servicio Puerto Dirección

Comunicación segura con navegador web (HTTPS)

Nota: Debe abrir este puerto en su firewall.
443 De salida
Data Upload service 5505 Interno
Engine service 5506 Interno
Connector Registry proxy 5507 Interno

Si se produce un conflicto de puertos con alguno de los puertos de servicios predeterminados, puede cambiarlo en el archivo services.conf, que se encuentra en %Archivos de programa%\Qlik\DataTransfer.

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507

Almacenamiento de registros y archivos de datos

Los archivos de registro de Qlik DataTransfer se ubican aquí: %ProgramData%\Qlik\DataTransfer\Log

Las conexiones de datos de Qlik DataTransfer se ubican aquí: %ProgramData%\Qlik\DataTransfer\DataUpload

Puede cambiar la ruta de almacenamiento predeterminada en el archivo services.conf, que se encuentra en %Program Files%\Qlik\DataTransfer.

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507
Nota: Le recomendamos que haga una copia de seguridad de los archivos de la carpeta de almacenamiento en una ubicación segura.

Generar una clave de API

Las claves de API caducan. Puede que los plazos de caducidad predeterminados no resulten adecuados para sus necesidades empresariales. Antes de generar una clave de API, considere cambiar la caducidad máxima del token en la configuración de Management Console. Si desea información, vea Habilitar las claves de API en el espacio empresarial de inquilinos.

Haga lo siguiente:

  1. Inicie sesión en el espacio empresarial de Qlik Sense SaaS.
  2. Desde el centro de control en la nube, haga clic en el icono de su perfil, en la esquina superior derecha y en Configuración de perfil.
  3. Seleccione Claves de API.
  4. Seleccione Generar nueva clave.

    Menú de configuración del centro de control en la nube, generar clave API
  5. Introduzca un nombre para la clave de API y seleccione un plazo en Caduca en.
  6. Haga clic en Generar.

    Generar nueva pantalla de clave API

  7. Haga clic en Copiar y cerrar para copiar la API en el portapapeles.

    Nota: No olvide guardar la clave de API. Esta clave es necesaria para autenticar Qlik DataTransfer.
    Pantalla de resumen de la clave API

    Ahora que ya dispone de una clave de API, puede crear una conexión segura entre Qlik DataTransfer y su espacio empresarial de Qlik Sense SaaS. La clave de API se utiliza para autenticar Qlik DataTransfer al cargar datos en el espacio empresarial. Como la API tiene un período de caducidad, tendrá que crear una clave de API nueva y volver a autenticar Qlik DataTransfer cuando caduque esta clave. No es necesario volver a crear las conexiones de datos cuando la clave de API caduca.

Autenticar Qlik DataTransfer

Haga lo siguiente:

  1. Abra Qlik DataTransfer.

    La primera vez que abra Qlik DataTransfer, aparecerá la pantalla de autenticación de Configuración de Qlik DataTransfer .

    Pantalla de conexión de la clave de la API de transferencia de datos de Qlik
  2. Introduzca un nombre para la conexión.
  3. Introduzca la URL del espacio empresarial de Qlik Sense SaaS.
  4. Copie la clave de API que ha generado desde el espacio empresarial.

  5. Haga clic en Aplicar para validar el espacio empresarial.

  6. Cuando su clave API caduque, o para autenticar Qlik DataTransfer con otro espacio empresarial, haga clic en para introducir una nueva clave de API, y después haga clic en Confirmar.

Una vez que se haya autenticado Qlik DataTransfer, puede cargar sus datos locales en el espacio empresarial de Qlik Sense SaaS. Si desea información sobre cómo usar Qlik DataTransfer, vea Cargar datos locales con Qlik DataTransfer.

Nota: Si cambia la cuenta de inicio de sesión del servicio después de configurar Qlik Data Transfer con su espacio empresarial inquilino, debe volver a configurar el espacio empresarial inquilino y las conexiones a las fuentes de datos ODBC.

Actualizar Qlik DataTransfer

Qlik DataTransfer mostrará un banner de notificación cuando haya alguna versión nueva disponible. Qlik DataTransfer no se actualiza automáticamente a versiones más recientes.

Advertencia:

Si elige una ubicación diferente para almacenar los archivos de configuración o elige diferentes puertos para ejecutar Qlik DataTransfer desde el archivo de configuración Service.conf, la actualización lo anulará. Haga una copia de seguridad de su archivo Service.conf antes de la actualización y cópielo en la carpeta de configuración predeterminada después de que se complete la actualización para mantener su configuración.

Si Qlik DataTransfer está usando la cuenta del sistema local, no le pedirá las credenciales de usuario del servicio y continuará usando el sistema local.

Banner de actualización de Qlik DataTransfer

Haga lo siguiente:

  1. Descargue la nueva versión de Qlik DataTransfer desde el banner que aparece en la app o desde el sitio de Descargas de Qlik.
  2. Cierre la versión actual de Qlik DataTransfer.
  3. Ejecute el instalador de Qlik DataTransfer.

    Nota:

    Si está actualizando Qlik DataTransfer en un servidor Windows con Qlik Sense Enterprise on Windows instalado, Qlik DataTransfer debe estar actualizado con el usuario de servicios Qlik Sense utilizado en la instalación de Qlik Sense.

  4. Haga clic en Actualizar.

    Actualizar la ventana de QlikDataTransfer

Desinstalar Qlik DataTransfer

Nota: Al desinstalar Qlik DataTransfer, el instalador elimina todos los archivos y carpetas de Qlik DataTransfer. Debe guardar todos los archivos y carpetas que desee conservar en una ubicación nueva.

Haga lo siguiente:

  1. Ejecute el instalador de Qlik DataTransfer.

    Nota:

    Si tiene una plataforma de Qlik instalada en el mismo servidor, debe detener los demás servicios de Qlik antes de desinstalar Qlik DataTransfer.

  2. Haga clic en Desinstalar.
  3. Una vez desinstalado, reinicie los servicios de Qlik en el orden siguiente, si procede:

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

Limitaciones

Qlik DataTransfer tiene las siguientes limitaciones:

  • Al actualizar desde la versión October 2020 o posterior, la ubicación para almacenar los archivos de configuración y los puertos utilizados para ejecutar Qlik DataTransfer cambian a los predeterminados en el archivo de configuración Service.conf. Si no usó la ubicación predeterminada para almacenar archivos de configuración o puertos predeterminados para ejecutar Qlik DataTransfer, perderá esta configuración. Para mantener su configuración, haga una copia de seguridad de Service.conf antes de la actualización y rehaga la configuración en Service.conf desde el archivo respaldado después de que se complete la actualización.

  • Si no usó la ubicación predeterminada para almacenar archivos de configuración en Service.conf, deberá eliminar manualmente los archivos en la carpeta que seleccionó.