Aplicación Web

Preparación de la instalación

Ingresar al servidor donde se dispone del zip de instalación BotReady_Release_VX.X.X.zip

En caso de no haberlo hecho previamente, descomprimir el zip en la carpeta D:\Botready\01_Releases\BotReady_Release_VX.X.X -de ahora en más [RELEASE_LOCATION]-.

Descomprimir el zip [RELEASE_LOCATION]\BotReadyWebSite.zip en la carpeta "D:\Botready\BotreadyWebSite" -de ahora en más [WEBSITE_LOCATION]-.

Nota: La elección del disco D y el nombre de la carpeta BotReady pueden modificarse según las características del servidor o las políticas de IT existentes.

Instalación del sitio web

Ejecutar el siguiente comando como administrador.

%systemroot%\system32\inetsrv\APPCMD add site /name:botready /bindings:"http/*:[WEBSITE_PORT]:" /physicalPath:"[WEBSITE_LOCATION]"

Nota: Ver más información acerca del comando en https://docs.microsoft.com/en-us/iis/get-started/getting-started-with-iis/create-a-web-site

Configuración del sitio

El sitio se encuentra hosteado por defecto en el puerto 80 del servidor de aplicaciones --de ahora en más [WEBSITE_PORT]-. Puede modificarse este valor en caso que el puerto se encuentre en uso.

Web.config

Dentro de la carpeta [WEBSITE_LOCATION] se ubica el archivo web.config. Este archivo de configuración posee un formato XML del cual cada sección se configura como se muestra a continuación:

EDSALoggerUtilConfig

Esta sección corresponde al módulo de auditoria y errores de la Aplicación Web. A continuación, se describe el campo a configurar:

Campo	Descripción
EDLConnectionString	Conexión encriptada a las tablas de auditoria y errores de la base de BotReady. Debe utilizarse el usuario [DATABASE_DEFAULTUSER].

Ejemplo:

<EDSALoggerUtilConfig>
    <EDLConnectionString value="VALOR ENCRIPTADO DE CONEXIÓN" />
</EDSALoggerUtilConfig>

El valor a encriptar de conexión posee el siguiente formato:

Data Source= [DATABASE_SERVER]\[DATABASE_INSTANCE];Initial Catalog [DATABASE_DBNAME];User ID= [DATABASE_DEFAULTUSER];Password= [DATABASE_DEFAULTPASS];Persist Security Info=True

EDSASecurityConfig

Esta sección corresponde al módulo de seguridad del Portal web. A continuación, se describe el campo a configurar:

Campo	Descripción
EDSConfig.connection.connection_string	Conexión encriptada a las tablas de seguridad de la base de BotReady. Debe utilizarse el usuario [DATABASE_DEFAULTUSER].

Ejemplo:

<EDSASecurityConfig>
 <EDSConfig
   dialect="NHibernate.Dialect.MsSql2005Dialect"
   connection.provider="NHibernate.Connection.DriverConnectionProvider"
   connection.driver_class="NHibernate.Driver.SqlClientDriver"
   connection.connection_string="VALOR ENCRIPTADO DE CONEXIÓN"
 />
</EDSASecurityConfig>

El valor a encriptar de conexión posee el siguiente formato:

Data Source= [DATABASE_SERVER]\[DATABASE_INSTANCE];Initial Catalog [DATABASE_DBNAME];User ID= [DATABASE_DEFAULTUSER];Password= [DATABASE_DEFAULTPASS];Persist Security Info=True

appSettings

Esta sección corresponde a las configuraciones generales del Portal web. A continuación, se describen los campos a configurar:

Campo	Descripción
EnableDomainAuthentication	Indica si el portal web permite o no ingresar con un usuario del dominio de red Windows (Active directory). Valor default False
LDAPServerName	Nombre del servidor de Active directory para el caso que el primer punto se encuentre en true
IsProductionEnvironment	Flag True/False que indica si corresponde a la instancia de Producción
EnvironmentInfoMessage	En caso que el ambiente sea de desarrollo o pruebas, escribir un mensaje para identificar el mismo durante la navegación de todas las pantallas del Portal Web. En el caso de producción dejar este mensaje vacío

Ejemplo:

<appSettings>
    <add key="EnableDomainAuthentication" value="True" />
    <add key="LDAPServerName" value="mycompany-active-directory" />
    <add key="IsProductionEnvironment" value="False" />
    <add key="EnvironmentInfoMessage" value="Testing - QA Environment" />
    ...
</appSettings>

connectionStrings

Esta sección corresponde a la conexión a la base de datos del Portal web. A continuación, se describe el campo a configurar:

Campo	Descripción
string_connection	Conexión encriptada a la base de base de datos BotReady del portal web

Ejemplo:

<connectionStrings>
    <add
        name="string_connection"
        connectionString="VALOR ENCRIPTADO DE CONEXIÓN"
        providerName="System.Data.SqlClient"
    />
</connectionStrings>

El valor a encriptar de conexión posee el siguiente formato:

Data Source= [DATABASE_SERVER]\[DATABASE_INSTANCE];Initial Catalog [DATABASE_DBNAME];User ID= [DATABASE_DEFAULTUSER];Password= [DATABASE_DEFAULTPASS];Persist Security Info=True

Configuración por base de datos

En la base de datos de BotReady existe una tabla de parámetros generales, en la cual se deben configurar los siguientes registros:

Grupo	Clave	Descripción
Ambiente	Ambiente	Nombre a definirle al ambiente. Por ejemplo: Producción, Homologación, Testing, etc.
Ambiente	MailFromSistema	Remitente que figuarará en las notificaciones vía mail de BotReady.
Notificaciones	PathTemplatesEnvio	De uso interno. Debe reemplazarse en el script la variable.
Notificaciones	PathTemplatesFormularios	De uso interno. Debe reemplazarse en el script la variable.
PortalWeb	URLWebPublica	En este campo se indica el nombre del servidor de aplicaciones y el puerto en el cual se instaló el WebSite de Botready. Debe reemplazarse en el script las variables. En caso de configurar un DNS puede optarse por utilizar este valor.

Se debe ejecutar el siguiente Script reemplazando previamente las variables por los valores establecidos en los pasos anteriores.

UPDATE ARQ_GeneralParameter 
SET [Value] = 'Producción' 
WHERE [Group] = 'Ambiente' AND [Key] = 'Ambiente'

UPDATE ARQ_GeneralParameter
SET [Value] = 'Botready <noreply@botready.net>'
WHERE [Group] = 'Ambiente' AND [Key] = 'MailFromSistema'

UPDATE ARQ_GeneralParameter 
SET [Value] = '[WEBSITE_LOCATION]\NotificacionTemplates\Envios\'
WHERE [Group] = 'Notificaciones' AND [Key] = 'PathTemplatesEnvio'

UPDATE ARQ_GeneralParameter
SET [Value] = '[WEBSITE_LOCATION]\'
WHERE [Group] = 'Notificaciones' AND [Key] = 'PathTemplatesFormularios'

UPDATE ARQ_GeneralParameter
SET [Value] = '[APPSERVER_NAME]:[WEBSITE_PORT]/'
WHERE [Group] = 'PortalWeb' AND [Key] = 'URLWebPublica'

Verificación de la instalación

Ingresar a Internet Information Services y verificar que se haya creado el sitio correctamente.

Ingresar en las opciones avanzadas del sitio

Verificar que se haya creado un Application Pool dedicado para la versión de .NET Framework 4 y de tipo Pipeline Mode Integrated. En caso de no ser así, crear el Application Pool y asociarlo al sitio.

Ingresar a sitio