Saltar al contenido

Instalar App Builder en Microsoft Windows (x64)

Introducción

Para instalar App Builder en Microsoft Windows, cumpla con los requisitos del sistema para cada servidor, siga los pasos de estas secciones:

  1. Obtener y descomprimir el software.

  2. Configurar IIS.

  3. (Opcional) Habilitar Crystal Reports.

  4. Crear un archivo de conexión.

  5. Probar y ejecutar.

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

Obtenga y Descomprima el Software

Para obtener el App Builder software, siga estos pasos:

  1. Comuníquese con su Gerente de éxito del cliente (CSM) para obtener una copia del App Builder 4.0 software.

  2. El App Builder el software se proporciona como un archivo comprimido con el nombre AppBuilder-VER.zip, dónde VER es el número de versión. Cópielo o muévalo al alojar donde se ejecuta IIS.

    Consejo

    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.

  3. En la carpeta raíz física predeterminada de IIS (normalmente C:\inetpub\wwwroot\), crea una subcarpeta para App Builder. (Por ejemplo, C:\inetpub\wwwroot\AppBuilder.)

  4. Descomprima el contenido del archivo descargado .zip archivo en esta carpeta.

Configurar IIS

Debe configurar su servidor IIS realizando las siguientes tareas:

  1. Agregar un grupo de aplicaciones.

  2. Agregar una aplicación.

  3. Configurar 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, a continuación, seleccione Agregar grupo de aplicaciones.
  2. En el cuadro de diálogo Agregar grupo de aplicaciones, establezca valores para los siguientes campos:
    • Nombre: App Builder
    • 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, ingrese estos comandos:

cd 'C:\Program Files\IIS'
.\appcmd.exe add apppool /name:"AppBuilder" /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:

  1. En el panel Conexiones, haga clic con el botón derecho en Sitios y seleccione Agregar sitio web.
  2. En el cuadro de diálogo Agregar sitio web, establezca valores para los siguientes campos:
    • Nombre del sitio: App Builder
    • Grupo de aplicaciones: App Builder
    • Ruta física: Ruta donde se descomprimió el software (por ejemplo, C:\inetpub\wwwroot\AppBuilder).
    • Iniciar sitio web inmediatamente: Seleccionado.
  3. 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:"AppBuilder" /id:1 /bindings:http://*:80 /physicalPath:"C:\inetpub\wwwroot\AppBuilder"
.\appcmd.exe add app /site.name:"AppBuilder" /path:"/" /physicalPath:"C:\inetpub\wwwroot\AppBuilder"

Configurar la Autenticación

Para configurar la autenticación mediante el Administrador de IIS, siga estos pasos:

  1. En el panel Conexiones, en la carpeta Sitios, seleccione la App Builder entrada.
  2. Haga doble clic en el icono Autenticación.
  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, a continuación, haga clic en el botón Aceptar:

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

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

Establecer Permisos

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

  1. En el panel Conexiones, en la carpeta Sitios, haga clic con el botón derecho en App Builder y seleccione Editar permisos.
  2. Seleccione la pestaña Seguridad y luego haga clic en el botón Editar.
  3. En los Permisos para App Builder, 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, ingrese IIS AppPool\AppBuilder, luego haga clic en el botón Verificar nombres.
  5. Haga clic en el botón Aceptar.
  6. En la sección Permisos para AppBuilder diálogo, en Nombres de grupos o usuarios, seleccione el nuevo App Builder usuario.
  7. En Permisos para App Builder, 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 la fila App Builder en el cuadro de diálogo Propiedades, 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\AppBuilder\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 Sample_Connection_Files carpeta y péguela con el nombre Connection.xml en el App Builder directorio raíz. El que copie dependerá del tipo de base de datos.
  2. Edite el C:\inetpub\wwwroot\AppBuilder\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 utilizar variables de ambiente o un archivo JSON para especificar la conexión a la base de datos.

Probar y Ejecutar

Correr App Builder por primera vez, siga estos pasos:

  1. Vaya a http://localhost/AppBuilder/.

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

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

  • 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:

  • Prueba del comportamiento de ejecución permanente

    La siguiente guía muestra cómo probar el comportamiento de ejecución permanente:

    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.

    Siempre en ejecución

    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