Instalación y puesta en marcha

Esta guía cubre cómo dejar operativo el motor API a3ERP en un servidor: estructura de directorios, base de datos de la API, y publicación en IIS. La configuración funcional se trata en Usuarios y permisos y Configuración de endpoints.

Requisitos previos#

• Windows Server con IIS habilitado. IIS (Internet Information Services) es el servidor web que viene con Windows; es quien publica la API para que pueda llamarse desde fuera.
• .NET Framework 4.8 (instalador web).
• Un SQL Server accesible desde el servidor de IIS, donde residirá la base de datos propia de la API y las bases de datos que se vayan a exponer.

Estructura de directorios#

El motor no tiene instalador: se copian los ficheros de la última versión en una estructura bajo una raíz común, siempre C:\SIT\Services\Sit_a3ERP_Api.

C:\SIT\Services\Sit_a3ERP_Api\        ← raíz de instalación
├─ Configuracion.json                 ← conexión SQL, compartida por la API y los workers
├─ Sit.a3ERP.Api\                     ← sitio que se publica en IIS (Global.asax, Web.config, bin\)
├─ Sit.a3ERP.Api.Config\              ← pantalla de Configuración de la API
└─ Dispatchers\                       ← workers, cada uno en su subcarpeta propia

Hay un Configuracion.json en la raíz donde figura la conexión SQL. Tanto la API (desde su bin) como cada worker (desde su subcarpeta) la usan.

Crear la base de datos de la API#

La base de datos de la API y su contenido se generan desde la pantalla de Configuración de la API, no a mano.

1. Ejecuta C:\SIT\Services\Sit_a3ERP_Api\Sit.a3ERP.Api.Config\Sit.a3ERP.Api.Config.exe.
2. Indica la conexión a SQL Server y el nombre de la base de datos de la API (debe ser un nombre sin uso, recomendamos APIA3ERP).
3. Guarda la configuración. Al SALIR, el configurador genera el Configuracion.json en la raíz y crea las tablas de la base de datos de la API.

El archivo Configuracion.json#

Contiene solo los datos de conexión a SQL (cuatro campos):

{
  "SqlServer": "SERVIDOR\\INSTANCIA",
  "SqlDatabase": "APIA3ERP",
  "SqlUser": "usuario_sql",
  "SqlPassword": "********"
}

Publicar en IIS#

Una vez creada la base de datos, se publica el sitio en IIS. Es el paso menos intuitivo, así que vamos con detalle.

Abre el Administrador de IIS: pulsa Windows + R, escribe inetmgr y acepta.

1. Grupo de aplicaciones (Application Pool)#

Un grupo de aplicaciones (Application Pool) es el contenedor bajo el que IIS ejecuta la API; sus ajustes deciden, entre otras cosas, con qué versión de .NET corre y si admite programas de 32 bits. Crea uno para la API (recomendamos que se llame APIA3ERP) con:

• .NET CLR v4.0 — la versión de .NET; es la que usa la API.
• Modo Integrado — el modo de funcionamiento estándar; déjalo así.
• «Habilitar aplicaciones de 32 bits» = True.

Para llegar a esos ajustes, en Grupos de aplicaciones haz clic derecho sobre el pool y elige Configuración avanzada…:

En ese diálogo, pon «Habilitar aplicaciones de 32 bits» en True:

2. Sitio web#

En Sitios, haz clic derecho y elige Agregar sitio web…:

En el diálogo (recomendamos llamar al sitio APIA3ERP) indica:

• Ruta de acceso física — la subcarpeta del sitio: C:\SIT\Services\Sit_a3ERP_Api\Sit.a3ERP.Api.
• Grupo de aplicaciones — el que creaste en el paso anterior.
• Enlace (binding) — la combinación de protocolo y puerto por la que el sitio escucha: tipo HTTPS (conexión cifrada), su Certificado SSL y el puerto.

3. Arrancar y tomar cambios#

Tras copiar o actualizar los ficheros de la API, detén el sitio, espera unos segundos y vuelve a iniciarlo para que tome los cambios.

Comprobar que está viva#

Con un usuario ya configurado, una llamada a POST https://<servidor>/api/login debe devolver un token. Si no tienes usuarios todavía, el siguiente paso es la configuración: Usuarios y permisos y Configuración de endpoints.