Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

Esta documentación es para la versión 4 y posteriores de App Builder, el nuevo nombre de Vinyl. Accede a la documentación de Vinyl aquí.

Instalar Jitterbit App Builder en Microsoft Windows (x64)

Introducción

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

  1. Satisfacer los requisitos del software tanto para el servidor web y servidor de base de datos.

  2. Recoger y desempaquetar el software.

  3. Configurar IIS.

  4. (Opcional) Habilitar Crystal Reports.

  5. Crear un archivo de conexión

  6. Prueba y ejecución.

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

Nota

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

Obtenga y descomprima el software

Para obtener y descomprimir el software, siga estos pasos:

  1. Contacte con su Gerente de Éxito del Cliente (CSM) para obtener una copia del App Builder 4.0 El software se proporciona como un archivo comprimido con el nombre vinyl-X.Y.N-win.zip, dónde 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. Copie este archivo a una carpeta en el alojar donde se ejecuta IIS.

  3. Dependiendo de la configuración de seguridad de su sistema, es posible que necesite desbloquear el archivo. Para ello, haga clic derecho en el archivo y seleccione Propiedades. En el cuadro de diálogo Propiedades, seleccione la pestaña Seguridad y luego Desbloquear.

  4. Haga clic derecho en el vinyl-X.Y.N-win.zip y seleccione Extraer todo.

  5. Configure el destino de la extracción como 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úe hasta que la extracción esté completa. Puede tardar varios minutos.

Configurar IIS

Para configurar IIS, siga estos pasos:

  1. Añadir un grupo de aplicaciones.

  2. Añadir una aplicación.

  3. Configurar la autenticación.

  4. Establecer permisos.

Agregar un grupo de aplicaciones

Para agregar un grupo de aplicaciones mediante el Administrador de IIS, siga estos pasos:

  1. En el panel Conexiones, haga clic con el botón derecho en Grupos de aplicaciones y seleccione Agregar grupo de aplicaciones.

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

    • Nombre: Vinyl

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

    • Modo de canalización administrada: Integrado.

    • Iniciar grupo de aplicaciones inmediatamente: Seleccionado.

  3. Haga clic en el botón Aceptar.

Para agregar un grupo de aplicaciones mediante la línea de comandos, introduzca estos comandos:

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

Multiple instances" Consejo "Varias instancias

Si desea ejecutar varias instancias de App Builder en el mismo servidor de aplicaciones, deben aislarse en grupos de aplicaciones separados con la opción Cargar perfil de usuario habilitada.

Agregar una aplicación

Para agregar una aplicación mediante el Administrador de IIS, siga estos pasos:

  1. En el panel Conexiones, expanda la carpeta Sitios, haga clic con el botón derecho en Sitio web predeterminado y seleccione Agregar sitio web.

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

    • Nombre del sitio: Vinyl

    • Grupo de aplicaciones: Vinyl

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

    • Iniciar sitio web inmediatamente: Seleccionado.

  3. Haga clic en el botón Aceptar.

Para agregar una aplicación mediante la línea de comandos, introduzca 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 mediante el Administrador de IIS, siga estos pasos:

  1. En el panel Conexiones, debajo de la carpeta Sitios, seleccione la entrada Vinyl.

  2. Haga doble clic en el icono Autenticación en la sección IIS.

  3. Seleccione Autenticación anónima y haga clic en la acción Editar.

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

Para configurar la autenticación mediante la línea de comando, ingrese este comando:

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

Establecer permisos

Para establecer permisos mediante el Administrador de IIS, siga estos pasos:

  1. En el panel Conexiones, debajo de la carpeta Sitios, haga clic derecho en Vinyl y seleccione Editar permisos.

  2. Seleccione la pestaña Seguridad y luego haga clic en el botón Editar.

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

  4. En el cuadro de diálogo Seleccionar usuario o grupos, en el campo Ingrese los nombres de los objetos a seleccionar, escriba IIS AppPool\Vinyl, luego haga clic en el botón Verificar nombres.

  5. Haga clic en el botón Aceptar.

  6. En el cuadro de diálogo Permisos para Vinyl, en Nombres de grupos o usuarios, seleccione el nuevo usuario Vinyl.

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

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

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

(opcional) Habilitar Crystal Reports

App Builder es compatible con Crystal Reports en sistemas Windows. Crystal Reports se aloja fuera de proceso en un servidor COM. Para registrar el servidor COM de Crystal Reports, abra Windows PowerShell como administrador y ejecute 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, siga estos pasos:

  1. Copie una de las muestras en el archivo Sample_Connection_Files carpeta y péguela con el nombre Connection.xml en el Vinyl Directorio raíz. El que copie dependerá del tipo de base de datos.

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

Consejo

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

Probar y ejecutar

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

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

  2. La configuración de la base de datos por primera vez puede tardar varios minutos. Cuando aparezca la pantalla de inicio de sesión, introduzca las siguientes credenciales predeterminadas:

    • Nombre de usuario: admin

    • Contraseña: P@55w0rd

  3. Haga clic en el botón Iniciar sesión y siga las instrucciones para cambiar la contraseña y cargar un archivo de licencia.

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

  • Configurar proveedores de seguridad:

El modelo de seguridad de App Builder admite varios proveedores de seguridad configurables. Si su organización desea configurar proveedores de seguridad, consulte la sección Proveedores página.

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

    Debe asegurarse de que el grupo de aplicaciones esté siempre en ejecución y que cualquier evento que pueda provocar que el grupo de aplicaciones se detenga reinicie la aplicación inmediatamente.

    Cuando App Builder no se está ejecutando, los eventos programados no se ejecutan.

    Esto es importante ya que IIS apagará el grupo de aplicaciones cuando esté inactivo (generalmente fuera del horario laboral), lo que provocará que se ignoren las rutinas programadas nocturnas.

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

    Nota

    La inicialización de aplicaciones de IIS no es compatible con sitios que usan la autenticación integrada de Windows. Para usar la autenticación integrada de Windows, es necesario deshabilitar la autenticación anónima en IIS. El componente de inicialización de aplicaciones de IIS requiere acceso anónimo.

    Existe una solución alternativa para este escenario que implica que el Programador de Windows haga ping a App Builder cada 5 minutos para garantizar que se vuelva a iniciar después de que se recicle el grupo de aplicaciones.

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

Los pasos varían según la versión de IIS. Seleccione el enlace a continuación:

- [Instrucciones de inicio automático de IIS 8.5](/es/app-builder/documentation/installation-guide/auto-start-iis-85/).

- [Instrucciones de inicio automático de IIS 7.5](/es/app-builder/documentation/installation-guide/auto-start-iis-75/).
  • Prueba del comportamiento de ejecución continua:

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

    De forma predeterminada, IIS se reinicia cada 29 horas (para que el grupo de aplicaciones se reinicie a distintas horas cada día). Debe configurar una hora específica para el reinicio del grupo de aplicaciones y asegurarse de que esta no interfiera con las tareas programadas en segundo plano.

    Siempre en ejecución

    Especifique una fecha y hora para reciclar el grupo de aplicaciones en el Administrador de IIS. Aquí, establezca las 11:42:00 para que no entre en conflicto con las tareas programadas en segundo plano.