Creación nueva instancia IFactura

Paquete IFactura.

El paquete de la ultima versión certificada se puede encontrar en la ruta del FileServer Z:\VICEPRESIDENCIA DE TECNOLOGIA\Area de Desarrollo\Area de Desarrollo\IFactura\PaqueteInstanciaIFacturaVersionX.X.X este paquete contiene la siguiente estructura

DataBase: Se encontraran los scripts de la versión, numerados en orden de ejecución.
WebApi: Paquete de la WebApi.
WebSite: Paquete del WebSite.
WindowsServices: Paquete de WindowsServices para la instancia

NOTA: En caso de presentar alguna duda o problema durante la instalación contactar al área de desarrollo.

Cualquier apreciación del manual, mejora o comentario enviarla al correo nmasso@transfiriendo.com.

Base de Datos

Teniendo en cuenta que para las nuevas instancias se sacará una copia de otra base de datos se crearon 3 scripts para realizar borrado y configuración tanto de la base de datos de IFactura como la de Seguridad.

Estos se pueden encontrar en la carpeta DataBase del paquete enumerados secuencialmente para su ejecución. Y se debe tener en cuenta las siguientes indicaciones para ejecutar estos.

CLEANDATABASE.sql: este script se encarga de realizar la limpieza a la base de datos de IFactura, este debe estar en la misma versión en la que se encuentra IFactura de lo contrario puede resultar con error o borrando incorrecto o incompleto. Este se cambiara cada versión release.
ScriptConfigurarBaseDatos.sql: este script se encarga de configurar la base de datos de IFactura a partir de un NIT y Nombre suministrados, estos se pueden parametrizar en la variables @NIT y @NOMBRE dentro del script.

3. ScriptConfigurarBaseDatosSeguridad.sql: este script se encargar de limpiar y configurar la base de datos de Seguridad, al igual que el anterior es parametrizable y al ejecutarse retorna el ApplicationName para configurar los Web.config, tambien configura un Password por defecto para el usuario administrador el cual es Nutresa*2016.

El único parámetro que este requiere es el @NOMBREEMPRESA.

Configuraciones e Instalaciones

Configuración WebSite.

Una vez el WebSite ha sido creado en el IIS, dirigirse a la carpeta del sitio y abrir el archivo Web.config con editor de texto avanzado ya sea Notepad++ o SublimeText.

Configuración log4net elasticsearch

Buscar el nodo log4net en el archivo y realizar las siguiente modificaciones

Remplazar.

nombresitio: por el nombre del sitio que se esta instalando en minúscula.

ambiente: por el ambiente en el cual se esta instalando, pre, pro, etc.

Configuración applicationName, este applicationName proviene de la tabla aspnet_Applications de la base de datos de seguridad

Este se debe remplazar en los siguientes nodos en el archivo de configuración

Tener en cuenta que este se debe remplazar en 4 partes.

Configuración AppSettings.config el cual se encuentra en la carpeta Config del WebSite

Remplazar en la llave Trancenter.Procesamiento.UbicacionArchivosFirmado la ruta donde quedaron los archivos firmados para la instancia de IFactura.
Remplazar en la llave CertificatePath la ruta donde esta ubicada el certificado para firmas los archivos xml.
Remplazar en la llave CertificatePassword la contraseña del certificado para el archivo de firmado xml.

Configuración ConnectionStrings.config el cual se encuentra en la carpeta Config del WebSite

Remplazar

(IP) por la dirección IP correspondiente al servidor que aloja la base de datos de IFactura.
(BASE DE DATOS IFACTURA) por el nombre de la base de datos de IFactura.
(BASE DE DATOS SEGURIDAD) por el nombre de la base de datos de Seguridad para IFactura.
(USUARIO) por el usuario del servidor que aloja la base de datos de IFactura.
(CONTRASEÑA) por la contraseña correspondiente al usuario de la base de datos de IFactura.

IMPORTANTE mantener el directorio downloads que está en la WebApi y NUNCA BORRARLO. Este directorio downloads debe tener permisos al usuario del IIS (IIS_IUSRS)

Configuración portal adquiriente

Una vez el WebSite y la WebApi han sido configurados y desplegados correctamente dirigirse a la carpeta portaladquiriente que se encuentra en el WebSite y con un editor de texto avanzado como Notepad++ o SublimeText abrir el archivo index.html y realizar el siguiente ajuste.

En la línea 1 donde se encuentra la etiqueta base remplazar en la propiedad href la cadena NombreSitio por el nombre del sitio donde quedo alojado el WebSite. Ejemplo: IFacturaNutresa, IFacturaEcopetrol.

Navegar a la carpeta asset/parameters y abrir el archivo parameters.js con un editor de texto y modificar la linea 2 por la URL donde quedo alojada la WebApi.

Para el correcto funcionamiento del portaladquiriente se debe instalar un modulo en el IIS llamado URL Rewrite el cual se puede descargar aquí.

Instalación y Configuración de WindowsService IFacturaNotificator.

Antes que todo, se recomienda usar un editor de archivos planos avanzado, por ejemplo, notepad++. Estos nos permitirán identificar los distintos tipos de archivos como lo son los .config, .xml o .bat, números de línea del archivo, abrir y cerrar nodos, etc.
Ubicar en una ruta temporal el paquete enviado ubicado dentro de la carpeta WindowsServices.
Modificar el nombre de la carpeta del paquete donde pone [Empresa] cambiarlo por el nombre de la empresa que se instalando.
Se debe verificar la ubicación del servicio. Se recomienda, bajo la estructura de los entornos: C:\IFacturaElectronica\Servicios
En esta carpeta Servicios, pegaremos el contenido del paquete. En este caso, copiaremos la carpeta Transfiriendo.IFacturaNotificator.[Empresa].WindowsService
Dentro de esta carpeta que acabamos de mover encontraremos dos ficheros (.bat) que nos ayudarán a instalar y desinstalar el servicio en el momento que queramos. Debemos abrir cada uno de ellos con un editor de texto y debemos verificar (editar si es el caso) la ubicación de nuestro archivo .exe del servicio.
Continuamos con la configuración del Windows service. Para eso debemos entrar a la carpeta Service y abrimos el archivo Transfiriendo.IFacturaNotificator.exe.config y debemos realizar los siguientes ajustes a las configuraciones.
- Configuración ConnectionString

Remplazar

(IP) por la dirección IP correspondiente al servidor que aloja la base de datos de IFactura.
(BASE DE DATOS IFACTURA) por el nombre de la base de datos de IFactura.
(USUARIO) por el usuario del servidor que aloja la base de datos de IFactura.
(CONTRASEÑA) por la contraseña correspondiente al usuario de la base de datos de IFactura.

Configuración log4net elasticsearch

Buscar el nodo log4net en el archivo y realizar las siguiente modificaciones

Remplazar

nombresitio: por el nombre del sitio que se esta instalando en minúscula.

ambiente: por el ambiente en el cual se esta instalando, pre, pro, etc.

Configuración nombre del servicio

Remplazar

Empresa: por el nombre de la empresa que se esta instalando.
Ambiente: por el ambiente en el cual se esta instalando ejemplo; PRE, PRO, etc.
En caso de que alguna vez se requiera modificar la expresion CRON la cual se encarga de planificar la rutina de procesamiento del servicio son las 2 ultimas lineas resaltadas en azul una para el servicio de Notificacion y otra para DocumentoNoNotificados. Para generar expresiones CRON puede entrar aquí

Modificar la rutas del archivo .exe en la línea 9 del archivo install.bat y unistall.bat, donde quedo ubicado el .exe del servicio, esto es necesario para poder realizar la instalación del servicio windows.
Luego de haber realizado la configuración del servicio, nos dirigimos nuevamente a los archivos .bat y ejecutamos, en modo Administrador, el archivo install.bat el cual se encargará de hacer la instalación de los servicios Windows.
Luego de la instalación, nos dirigimos a Servicios de Windows:

En la ventana que se abre, nos encontraremos con todo el listado de servicios instalados. Ubicaremos el servicio

Transfiriendo.IFacturaNotificatorService.[Empresa]

debemos verificar que todos los servicios relacionados estén detenidos y con el tipo de inicio MANUAL. Lista de servicios relacionados:

1. Transfiriendo.DocumentErrorNotification.[Empresa]

Por último, iniciamos el servicio.

Luego de la instalación e inicio de nuestro Windows service, verificamos la ejecución del mismo al analizar el Log del mismo, ubicado según el archivo de configuración en

C:\TransfiriendoLogs\nombresitio-notificator\notificator.service.log

Si el servicio inicio correctamente al fin del log se observa algo similiar a lo siguiente

Se debe desplazar la barra horizontal hacia la derecha si no es posible encontrar las líneas.

Fin de la instalación

NOTA: La demás configuraciones como lo son colores, logos, configuración de prefijos y demás son responsabilidad del área de producto.