Saltar al contenido

Instalar Jitterbit App Builder en Microsoft Windows (x64)

Introducción

Para instalar App Builder en Microsoft Windows, sigue estos pasos:

  1. Satisface los requisitos de software tanto para el servidor web como para el servidor de base de datos.

  2. Obtén y descomprime el software.

  3. Configura IIS.

  4. (Opcional) Habilita Crystal Reports.

  5. Crea un archivo de conexión.

  6. Prueba y ejecuta.

  7. (Opcional) Configuración posterior a la instalación.

Nota

La palabra Vinyl, utilizada en partes de las siguientes instrucciones, es el antiguo nombre de App Builder.

Obtener y descomprimir el software

Para obtener y descomprimir el software, sigue estos pasos:

  1. Contacta a tu Gerente de Éxito del Cliente (CSM) para obtener una copia del software App Builder 4.

    El software se proporciona como un archivo comprimido con el nombre vinyl-X.Y.N-win.zip, donde X.Y es el número de versión (por ejemplo, 4.0) y N es el número de compilación (por ejemplo, 45678).

  2. Copia este archivo en una carpeta en el host donde se ejecuta IIS.

  3. Dependiendo de la configuración de seguridad de tu sistema, es posible que necesites desbloquear el archivo. Para hacer esto, haz clic derecho en el archivo y selecciona Propiedades. En el cuadro de diálogo Propiedades, selecciona la pestaña Seguridad, luego selecciona Desbloquear:

    Desbloquear

  4. Haz clic derecho en el archivo vinyl-X.Y.N-win.zip y selecciona Extraer todo.

  5. Establece la ubicación de extracción en una carpeta dentro de la carpeta raíz física predeterminada de IIS (por ejemplo, C:\inetpub\wwwroot\Vinyl).

  6. Haz clic en el botón Extraer.

    Precaución

    No continúes hasta que la extracción esté completa. Esto puede tardar muchos minutos.

Configurar IIS

Para configurar IIS, sigue estos pasos:

  1. Agregar un grupo de aplicaciones.

  2. Agregar una aplicación.

  3. Configurar la autenticación.

  4. Establecer permisos.

Agregar un grupo de aplicaciones

Para agregar un grupo de aplicaciones utilizando el Administrador de IIS, sigue estos pasos:

  1. En el panel de Conexiones, haz clic derecho en Grupos de aplicaciones, luego selecciona Agregar grupo de aplicaciones.

  2. En el cuadro de diálogo Agregar grupo de aplicaciones, establece valores para los siguientes campos:

    • Nombre: Vinyl

    • Versión de .NET CLR: .NET CLR Version v4.0.30319.

    • Modo de canalización administrada: Integrado.

    • Iniciar el grupo de aplicaciones inmediatamente: Seleccionado.

  3. Haz clic en el botón Aceptar.

Para agregar un grupo de aplicaciones utilizando la línea de comandos, ingresa estos comandos:

cd 'C:\Program Files\IIS'
.\appcmd.exe add apppool /name:"Vinyl" /managedPipelineMode:Integrated /autoStart:true /managedRuntimeVersion:"v8.0"

Múltiples instancias

Si deseas ejecutar múltiples instancias de App Builder en el mismo servidor de aplicaciones, deben estar aisladas en grupos de aplicaciones separados con la opción Cargar perfil de usuario habilitada.

Agregar una aplicación

Para agregar una aplicación utilizando el Administrador de IIS, sigue estos pasos:

  1. En el panel de Conexiones, expande la carpeta Sitios, haz clic derecho en el Sitio Web Predeterminado, luego selecciona Agregar sitio web.

  2. En el cuadro de diálogo Agregar sitio web, establece valores para los siguientes campos:

    • Nombre del sitio: Vinyl

    • Grupo de aplicaciones: Vinyl

    • Ruta física: C:\inetpub\wwwroot\Vinyl

    • Iniciar sitio web inmediatamente: Seleccionado.

  3. Haz clic en el botón Aceptar.

Para agregar una aplicación utilizando la línea de comandos, ingresa estos comandos:

.\appcmd.exe add site /name:"Vinyl" /id:1 /bindings:http://*:80 /physicalPath:"C:\inetpub\wwwroot\Vinyl"
.\appcmd.exe add app /site.name:"Vinyl" /path:"/" /physicalPath:"C:\inetpub\wwwroot\Vinyl"

Configurar la autenticación

Para configurar la autenticación utilizando el Administrador de IIS, sigue estos pasos:

  1. En el panel de Conexiones, bajo la carpeta Sitios, selecciona la entrada Vinyl.

  2. Haz doble clic en el ícono de Autenticación en la sección de IIS.

  3. Selecciona Autenticación anónima y haz clic en la acción Editar.

  4. En el cuadro de diálogo Editar credenciales de autenticación anónima, selecciona Identidad del grupo de aplicaciones, luego haz clic en el botón Aceptar.

Para configurar la autenticación utilizando la línea de comandos, ingresa este comando:

appcmd.exe set config -section:anonymousAuthentication /username:"" --password

Establecer permisos

Para establecer permisos utilizando el Administrador de IIS, sigue estos pasos:

  1. En el panel de Conexiones, bajo la carpeta Sitios, haz clic derecho en Vinyl y selecciona Editar permisos.

  2. Selecciona la pestaña Seguridad, luego haz clic en el botón Editar.

  3. En el cuadro de diálogo Permisos para Vinyl, haz clic en el botón Agregar.

  4. En el cuadro de diálogo Seleccionar usuario o grupos, en el campo Escriba los nombres de objeto a seleccionar, ingresa IIS AppPool\Vinyl, luego haz clic en el botón Comprobar nombres.

  5. Haz clic en el botón Aceptar.

  6. En el cuadro de diálogo Permisos para Vinyl, bajo Nombres de grupo o usuario, selecciona el nuevo usuario Vinyl.

  7. Bajo Permisos para Vinyl, para la fila de Control total, selecciona la casilla de verificación Permitir.

  8. Haz clic en el botón Aceptar para cerrar el cuadro de diálogo.

  9. En el cuadro de diálogo Propiedades de Vinyl, haz clic en el botón Aceptar.

(Opcional) Habilitar Crystal Reports

App Builder admite Crystal Reports en sistemas Windows. Crystal Reports se aloja fuera de proceso en un servidor COM. Para registrar el servidor COM de Crystal Reports, abre un Windows PowerShell como administrador y luego ejecuta estos comandos:

Set-ExecutionPolicy RemoteSigned
cd C:\inetpub\wwwroot\Vinyl\Scripts
.\RegisterCrystalReports.ps1

Crear un archivo de conexión

Para crear un archivo de conexión, sigue estos pasos:

  1. Copia uno de los ejemplos en la carpeta Sample_Connection_Files y pégalo con el nombre Connection.xml en el directorio raíz de Vinyl. Cuál copies depende de tu tipo de base de datos.

  2. Edita el archivo C:\inetpub\wwwroot\Vinyl\Connection.xml y establece valores para los parámetros DatabaseName, UserName y Password. (El usuario UserName debe tener un rol de administración del sistema.)

Consejo

También puedes usar variables de entorno o un archivo JSON para especificar la conexión a la base de datos.

Prueba y ejecución

Para ejecutar App Builder por primera vez, sigue estos pasos:

  1. Ve a http://localhost/Vinyl/.

  2. Puede tardar varios minutos en configurar la base de datos por primera vez. Cuando aparezca la pantalla de inicio de sesión, ingresa las siguientes credenciales predeterminadas:

    • Nombre de usuario: admin

    • Contraseña: P@55w0rd

  3. Haz clic en el botón Iniciar sesión y sigue las instrucciones para cambiar la contraseña y subir un archivo de licencia.

(Opcional) Configuración posterior a la instalación

  • Configura los proveedores de seguridad:

    El modelo de seguridad de App Builder admite múltiples proveedores de seguridad configurables. Si tu organización está buscando configurar uno o más proveedores de seguridad, consulta la página de Proveedores.

  • Asegúrate de que los eventos programados se ejecuten después de que el grupo de aplicaciones se recicle:

    Debes asegurarte de que el grupo de aplicaciones esté siempre en ejecución y que cualquier evento que pueda causar que el grupo de aplicaciones se detenga reinicie la aplicación de inmediato.

    Cuando App Builder no está en ejecución, los eventos programados no se están ejecutando.

    Esto es importante ya que IIS apagará el grupo de aplicaciones cuando esté inactivo (a menudo durante horas fuera de servicio), lo que hará que las rutinas programadas nocturnas sean ignoradas.

    Para que App Builder se inicie automáticamente después de que un grupo de aplicaciones se recicle o se reinicie el servidor, puedes configurar el componente ApplicationInitialization de IIS.

    Nota

    ApplicationInitialization de IIS no es compatible con sitios que utilizan Autenticación Integrada de Windows. Usar Autenticación Integrada de Windows requiere que la Autenticación Anónima esté deshabilitada en IIS. El componente ApplicationInitialization de IIS requiere acceso anónimo.

    Hay una solución alternativa para este escenario que implica el Programador de Windows para hacer ping a App Builder cada 5 minutos para asegurar que se reinicie después de que el grupo de aplicaciones sea reciclado.

  • Instalar y configurar la inicialización de la aplicación:

    Los pasos varían dependiendo de la versión de IIS. Elige un enlace a continuación:

  • Probar el comportamiento de siempre en ejecución:

    La siguiente guía explica cómo probar el comportamiento de siempre en ejecución:

    Por defecto, IIS está configurado para reiniciarse cada 29 horas (para que el grupo de aplicaciones se reinicie a diferentes horas cada día). Debes configurar un momento específico del día en que el grupo de aplicaciones se reinicie, y asegurarte de que este momento no interfiera con trabajos en segundo plano programados.

    Alwaysrunning

    Especifica una fecha y hora para reciclar el grupo de aplicaciones en el Administrador de IIS. Aquí deberías establecer 11:42:00 a una hora que no entre en conflicto con trabajos en segundo plano programados.