Instalar Jitterbit App Builder en Microsoft Windows (x64)
Introducción
Para instalar App Builder En Microsoft Windows, siga estos pasos:
-
Satisfacer los [requisitos del software][ab sysreqs] tanto para el [servidor web][ab swreqs web win] y [servidor de base de datos][ab swreqs db win].
-
Obtener y desempaquetar el software.
-
(Opcional) Habilitar Crystal Reports.
-
(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:
-
Póngase en contacto con su Gerente de atención al cliente (CSM) para obtener una copia del App Builder 4.0 software.
El software se proporciona como un archivo comprimido con el nombre
vinyl-X.Y.N-win.zip
, dóndeX.Y
es el número de versión (por ejemplo,4.0
) yN
es el número de compilación (por ejemplo,45678
). -
Copie este archivo a una carpeta en el alojar donde se ejecuta IIS.
-
Según 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, a continuación, seleccione Desbloquear.
-
Haga clic derecho en el
vinyl-X.Y.N-win.zip
archivo y seleccione Extraer todo. -
Establezca 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
). -
Haz clic en el botón Extraer.
Precaución
No continúe hasta que se complete la extracción. Esto puede llevar varios minutos.
Configurar IIS
Para configurar IIS, siga estos pasos:
Agregar un grupo de aplicaciones
Para agregar un grupo de aplicaciones mediante el Administrador de IIS, siga estos pasos:
-
En el panel Conexiones, haga clic con el botón derecho en Grupos de aplicaciones y, a continuación, seleccione Agregar grupo de aplicaciones.
-
En el cuadro de diálogo Agregar grupo de aplicaciones, establezca valores para 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.
-
-
Haga clic en el botón Aceptar.
Para agregar un grupo de aplicaciones mediante la línea de comandos, ingrese estos comandos:
cd 'C:\Program Files\IIS'
.\appcmd.exe add apppool /name:"Vinyl" /managedPipelineMode:Integrated /autoStart:true /managedRuntimeVersion:"v8.0"
Varias instancias
Si desea ejecutar varias instancias App Builder instancias 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 mediante el Administrador de IIS, siga estos pasos:
-
En el panel Conexiones, expanda la carpeta Sitios, haga clic con el botón derecho en Sitio web predeterminado y luego seleccione Agregar sitio web.
-
En el cuadro de diálogo Agregar sitio web, establezca 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.
-
-
Haga clic en el botón Aceptar.
Para agregar una aplicación mediante la línea de comandos, ingrese 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:
-
En el panel Conexiones, debajo de la carpeta Sitios, seleccione la entrada Vinyl.
-
Haga doble clic en el icono Autenticación en la sección IIS.
-
Seleccione Autenticación anónima y haga clic en la acción Editar.
-
En el cuadro de diálogo Editar credenciales de autenticación anónima, seleccione Identidad del grupo de aplicaciones y, a continuación, haga clic en el botón Aceptar.
Para configurar la autenticación mediante la línea de comandos, ingrese este comando:
appcmd.exe set config -section:anonymousAuthentication /username:"" --password
Establecer permisos
Para establecer permisos mediante el Administrador de IIS, siga estos pasos:
-
En el panel Conexiones, debajo de la carpeta Sitios, haga clic derecho en Vinyl y seleccione Editar permisos.
-
Seleccione la pestaña Seguridad y luego haga clic en el botón Editar.
-
En el cuadro de diálogo Permisos para Vinyl, haga clic en el botón Agregar.
-
En el cuadro de diálogo Seleccionar usuario o grupos, en el campo Ingrese los nombres de los objetos a seleccionar, ingrese
IIS AppPool\Vinyl
, luego haga clic en el botón Verificar nombres. -
Haga clic en el botón Aceptar.
-
En el cuadro de diálogo Permisos para Vinyl, en Nombres de grupos o usuarios, seleccione el nuevo usuario Vinyl.
-
En Permisos para Vinyl, para la fila Control total, seleccione la casilla de verificación Permitir.
-
Haga clic en el botón Aceptar para cerrar el cuadro de diálogo.
-
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, a continuación, 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:
-
Copie una de las muestras en el
Sample_Connection_Files
carpeta y péguela con el nombreConnection.xml
en elVinyl
directorio raíz. El que copie dependerá del tipo de base de datos. -
Edite el
C:\inetpub\wwwroot\Vinyl\Connection.xml
archivo y establecer valores para los parámetrosDatabaseName
,UserName
, yPassword
. (ElUserName
(El usuario debe tener un rol de administrador del sistema).
Consejo
También puedes utilizar [variables de ambiente o un archivo JSON][ab config] para especificar la conexión a la base de datos.
Probar y ejecutar
Correr App Builder por primera vez, siga estos pasos:
-
Vaya a
http://localhost/Vinyl/
. -
La configuración de la base de datos por primera vez puede llevar varios minutos. Cuando aparezca la pantalla de inicio de sesión, ingrese las siguientes credenciales predeterminadas:
-
Nombre de usuario:
admin
-
Contraseña:
P@55w0rd
-
-
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 App Builder el modelo de seguridad admite varios proveedores de seguridad configurables. Si su organización desea configurar uno o más proveedores de seguridad, consulte [Proveedores][ab providers] 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 de que cualquier evento que pueda hacer que el grupo de aplicaciones se detenga reinicie la aplicación inmediatamente.
Cuando App Builder no se está ejecutando, los eventos programados no se están ejecutando.
Esto es importante ya que IIS apagará el grupo de aplicaciones cuando esté inactivo (a menudo fuera del horario laboral), lo que hará que se ignoren las rutinas programadas nocturnas.
Para tener App Builder para iniciar automáticamente después de que se recicle un grupo de aplicaciones o se reinicie un servidor, puede configurar IIS
ApplicationInitialization
componente.Nota
La inicialización de aplicaciones de IIS no es compatible con sitios que utilizan la autenticación integrada de Windows. El uso de la autenticación integrada de Windows requiere que la autenticación anónima esté deshabilitada 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 App Builder cada 5 minutos para garantizar que se vuelva a iniciar después de reciclar el grupo de aplicaciones.
- [Solución alternativa de inicio automático de HTTPS][ab autostart https workaround].
-
Instalar y configurar la inicialización de la aplicación:
Los pasos varían según la versión de IIS. Seleccione el enlace que aparece a continuación:
-
[Instrucciones de inicio automático de IIS 8.5][ab iis 85].
-
[Instrucciones de inicio automático de IIS 7.5][ab iis 75].
-
-
Prueba de comportamiento de ejecución permanente:
La siguiente guía muestra cómo probar el comportamiento de ejecución permanente:
- [Prueba de comportamiento de ejecución permanente][ab always running]
De manera predeterminada, IIS está configurado para reiniciarse cada 29 horas (de modo que el grupo de aplicaciones se reinicie en diferentes momentos todos los días). Debe configurar una hora específica del día en la que se reinicie el grupo de aplicaciones y asegurarse de que esta hora no interfiera con los trabajos en segundo plano programados.
Especifique una fecha y hora para reciclar el grupo de aplicaciones en el Administrador de IIS. Aquí, debe establecer 11:42:00 como una hora que no entre en conflicto con los trabajos en segundo plano programados.