Guia de Instalación

#Pre Requisitos 

• Windows Server 2016 o superior (también funciona en Windows 10/11 Pro)
• SQL Server 2016 o superior
• Acceso de administrador al servidor

#Pasos de instalación

#Paso 1: Instalar Runtime

ASP.NET Core 9.0 Hosting Bundle - Requerido para que IIS pueda ejecutar la aplicación.

• Descarga: https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-9.0.312-windows-x64-installer
• Ejecutar el instalador del Hosting Bundle antes de instalar TAP.
• Despues de instalar el Hosting Bundle, reiniciar IIS ejecutando iisreset en una consola como administrador.

#Paso 2: Activar IIS (Internet Information Services)

Nota: Si ya tiene IIS activado en su servidor, puede saltar directamente al Paso 2

IIS es el servidor web de Microsoft necesario para ejecutar la aplicación. Si no lo tiene instalado, siga las instrucciones oficiales de Microsoft:

Para Windows Server:

Instalación de IIS 8.5 en Windows Server 2012 R2

Verificar si IIS está instalado

1. Presione `Windows + R`
2. Escriba `inetmgr` y presione Enter
3. Si se abre el Administrador de IIS, ya lo tiene instalado

#Paso 3: Ejecutar el Instalador

1. Ejecute el archivo de instalación Talenty-x.x.x.0-Relase-x64.msi como administrador

• Clic derecho sobre el archivo → "Ejecutar como administrador"

2. Siga el asistente de instalación:

• Al abrir el .msi, aparece la pantalla de bienvenida. Click en Next.
• Marque "I accept the terms" y click en Next.
• La ruta por defecto es C:\Program Files\TAP\
• Puede cambiarla con el botón Browse si lo necesita
• Click en Next

#Configuración de IIS

Cuándo marcar "Fresh Install":

• Primera vez que instala el sistema
• Si desea reconfigurar las conexiones de base de datos
• Si el sitio IIS quedó en un estado inconsistente

Cuándo NO marcar "Fresh Install":

• Al actualizar a una versión nueva (preserva la configuración actual)

Click en Next.

#Paso 3: Configuración de Base de Datos

Este paso solo aparece en instalación nueva o si marcó "Fresh Install".

Ejemplos de servidor:

• SQL Server local: localhost o .
• Instancia con nombre: localhost\SQLEXPRESS
• Servidor remoto: 192.168.1.100 o sqlserver.dominio.com

Nota: La conexión usa Integrated Security=true. El AppPool de IIS se autentica con su identidad de Windows. Si la BD está en un servidor remoto, ver sección Post-Instalación.

Click en Next.

#Paso 4: Confirmación

Revise la configuración. Click en Install. Se solicitará elevación de permisos (UAC).

#Paso 5: Finalización

Click en Finish.

#Post-Instalación

1. Verificar en IIS Manager (inetmgr) que el sitio y AppPool fueron creados.
2. Acceder a la aplicación: http://localhost:5080 (o el puerto configurado).
3. Si la BD está en un servidor remoto, configurar el AppPool con una cuenta de dominio:

• • IIS Manager → Application Pools → Click derecho en TAPAppPool → Advanced Settings
  • Process Model → Identity → Custom Account → Ingresar DOMINIO\usuario y contraseña
  • Asegurarse de que esa cuenta tenga permisos en SQL Server

#Configurar los Strings de Conexión

El instalador configura automáticamente los strings de conexión durante la instalación inicial o al marcar "Fresh Install". Los valores se guardan en el archivo:

C:\Program Files\TAP\appsettings.Production.json

#Editar los Strings de Conexión Manualmente

Si necesita modificar los strings de conexión después de la instalación (por ejemplo, cambiar de servidor, cambiar el modo de autenticación, o corregir un valor):

1. Abra el archivo C:\Program Files\TAP\appsettings.Production.json con un editor de texto como administrador (click derecho en Notepad → Ejecutar como administrador)

2. El archivo tiene la siguiente estructura:

{
  "ConnectionStrings": {
    "Talenty": "Server=SERVIDOR;Database=NOMBRE_BD;...",
    "Softland": "Server=SERVIDOR;Database=NOMBRE_BD;..."
  }
}

3. Modifique los valores según necesite, usando uno de los siguientes formatos:

Con Autenticación de Windows (Recomendado):

Server=NOMBRE_SERVIDOR;Database=NOMBRE_BD;Integrated Security=true;TrustServerCertificate=true;

Con Usuario y Contraseña SQL:

Server=NOMBRE_SERVIDOR;Database=NOMBRE_BD;User Id=USUARIO;Password=CONTRASEÑA;TrustServerCertificate=true;

4. Guarde el archivo.

5. Reinicie el AppPool para que los cambios tomen efecto:

   • Abra IIS Manager (inetmgr)
   • Vaya a Application Pools
   • Click derecho en TAPAppPool → Recycle

Importante sobre actualizaciones: Al ejecutar el instalador en modo de actualización (sin marcar "Fresh Install"), el archivo appsettings.Production.json se preserva y no se sobreescribe. Los strings de conexión configurados manualmente se mantienen entre actualizaciones.

#Configurar Permisos de Base de Datos

Si utiliza Autenticación de Windows (Integrated Security=true), la aplicación se conecta a SQL Server usando la identidad del Application Pool. Esto es más seguro porque no necesita guardar contraseñas en la configuración.

Nota: Este paso solo se realiza una vez durante la instalación inicial.

En SQL Server, otorgue permisos al usuario del AppPool:

Si la BD está en el mismo servidor (localhost):

-- El AppPool usa la identidad virtual IIS APPPOOL\TAPAppPool
CREATE LOGIN [IIS APPPOOL\TAPAppPool] FROM WINDOWS;

USE Talenty;
CREATE USER [IIS APPPOOL\TAPAppPool] FOR LOGIN [IIS APPPOOL\TAPAppPool];
ALTER ROLE db_datareader ADD MEMBER [IIS APPPOOL\TAPAppPool];
ALTER ROLE db_datawriter ADD MEMBER [IIS APPPOOL\TAPAppPool];
ALTER ROLEdb_ddladmin ADD MEMBER [IIS APPPOOL\TAPAppPool];

USE BDPortal;
CREATE USER [IIS APPPOOL\TAPAppPool] FOR LOGIN [IIS APPPOOL\TAPAppPool];
ALTER ROLE db_datareader ADD MEMBER [IIS APPPOOL\TAPAppPool];
ALTER ROLE db_datawriter ADD MEMBER [IIS APPPOOL\TAPAppPool];

#Configurar AppPool con Cuenta de Dominio

Si la BD está en un servidor remoto, la identidad virtual del AppPool no funciona. Se requiere una cuenta de dominio:

1. En IIS Manager → Application Pools → click derecho en TAPAppPool → Advanced Settings

2. En Process Model → Identity → seleccionar Custom Account → click Set...

3. Ingresar DOMINIO\usuario y contraseña → OK

4. En SQL Server (servidor remoto), otorgar permisos a esa cuenta:

CREATE LOGIN [DOMINIO\usuario] FROM WINDOWS;

USE Talenty;
CREATE USER [DOMINIO\usuario] FOR LOGIN [DOMINIO\usuario];
ALTER ROLE db_datareader ADD MEMBER [DOMINIO\usuario];
ALTER ROLE db_datawriter ADD MEMBER [DOMINIO\usuario];
ALTER ROLEdb_ddladmin ADD MEMBER [DOMINIO\usuario];

USE BDPortal;
CREATE USER [DOMINIO\usuario] FOR LOGIN [DOMINIO\usuario];
ALTER ROLE db_datareader ADD MEMBER [DOMINIO\usuario];
ALTER ROLE db_datawriter ADD MEMBER [DOMINIO\usuario];

#Actualización

Ejecute el .msi de la nueva versión sin marcar "Fresh Install". El instalador:

• Detiene el AppPool
• Actualiza los archivos
• Reinicia el AppPool
• Preserva appsettings.Production.json existente