Código: IM-09 Versión: 02

Instalación de Aplicaciones .NET Fecha:

Página: 1 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

1. OBJETO

Los pasos descritos en este documento tienen como finalidad la adecuada instalación y/o
actualización de los aplicativos desarrollados por ACTSIS LTDA con tecnología .NET, en
servidores web IIS.

2. ALCANCE

Este documento describe los procedimientos de instalación explicando los pasos que se
deben seguir y los valores específicos a proveer en los parámetros requeridos para el
correcto funcionamiento de la aplicación.

Este documento es válido para cualquiera de los aplicativos WEB desarrollados por
ACTSIS LTDA empleando tecnología .NET en servidores web IIS.

Este documento no detalla procedimientos específicos para la configuración de atributos

propios de servidor de base de datos o servidor de aplicaciones, más allá de aquellos
estrictamente necesarios para el funcionamiento de la aplicación. En estos casos el lector
debe apoyarse en el administrador de los servidores y documentación específica
relacionada.

3. CONDICIONES GENERALES

• El presente instructivo debe ser ejecutado por un Administrador de Servidores.

• Cuando se mencione el concepto de aplicación, este incluye todas las aplicaciones y
servicios web.

2. PALABRAS CLAVES

Aplicación Web, Internet Information Services (IIS), Sitio Web

3. DOCUMENTOS REFERENCIADOS
• Instructivo ID-09 Construccion_Software_WEB
• Instructivo IM-08 “Creación Archivo de Publicación_WEB .NET”
• Guía GA-03 Definiciones SGC

4. PRE-REQUISITOS

4.1 DEL SERVIDOR

A continuación se relacionan los pre-requisitos de instalación que deben estar disponibles

en el servidor de aplicaciones antes de instalar la aplicación Web:

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 2 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

Pre requisito Observaciones

Windows Server El servidor de aplicaciones debe ser Windows server 2012 R2 o
2012 o superior superior con todos los service pack de seguridad previamente
instalados.
IIS 8 o superior La característica de Internet Information Services debe estar instalada
en el servidor de aplicaciones Windows server 2012 o superior
.net Framework 4.5.2 Esta característica debe venir instalada en el servidor de aplicaciones.

Windows server 2012:

En el caso de no tener la característica en el servidor dirigirse a la
siguiente url para realizar la descarga (en Windows server 2012 R2
con los últimos parches de instalación ya viene dentro de las
características): http://www.microsoft.com/en-
ca/download/details.aspx?id=42643

Posterior a la instalación del framework es preciso realizar la

instalación de ASP.NET para que sea procesado en la versión 4.5
dentro del IIS, para esto es preciso ejecutar el siguiente comando:

%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis –i
Para mayor información ver:
https://msdn.microsoft.com/library/k6h9cz8h(v=vs.100).aspx
Oracle Client Puede ser cliente 12g o superior.

Para descargar el cliente de Oracle puede dirigirse a:

http://www.oracle.com/technetwork/indexes/downloads/index.html

El cliente debe ir correctamente configurado desde el net manager o

directamente en su archivo tnsnames.ora donde se debe definir una
nomenclatura de servicios que apunte a la base de datos del
aplicativo preferiblemente con el nombre ACTSIS en caso de usar otro
nombre, ver parámetros del servidor en el numeral 2.
SAP Crystal Reports Para la ejecución de reportes CrystalReports se requiere la
Runtime (32Bit) instalación de SAP Crystal Reports runtime engine for .NET
framework (32Bit) versión 13.0.23

http://downloads.businessobjects.com/akdlm/cr4vs2010/CRforVS_redi
st_install_32bit_13_0_23.zip?_ga=2.175750753.293304636.15386820
90-2010732280.1535033898

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 3 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

SAP Crystal Reports Para la ejecución de reportes CrystalReports se requiere la

Runtime (64Bit) instalación de SAP Crystal Reports runtime engine for .NET
framework (64Bit) versión 13.0.23

http://downloads.businessobjects.com/akdlm/cr4vs2010/CRforVS_redi
st_install_64bit_13_0_23.zip?_ga=2.204045907.293304636.15386820
90-2010732280.1535033898

5. INSTRUCCIONES

5.1 INSTALACIÓN DE LA APLICACIÓN WEB

5.1.1 IDENTIFICAR LA APLICACIÓN WEB

Dentro de la carpeta de instalación, ACTSIS envía una carpeta denominada Net, donde
se encuentran las aplicaciones web a instalar:

Las aplicaciones web son enviadas como archivo comprimidos en formato .zip,
identificados con el nombre de cada sistema de información o servicio web:

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 4 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

5.1.2 CREAR EL SITIO WEB

1. Abra la ventana Ejecutar de WINDOWS (Pulsar las teclas Windows + R)

2. Escriba el comando inetmgr y haga clic en el botón Aceptar, para abrir la

consola de consola de administración de IIS.

3. Una vez abierta la consola IIS, haga clic derecho sobre el nodo Sitios del
panel izquierdo, y seleccione la opción agregar sitio web.

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 5 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

4. Inmediatamente, se despliega la ventana Agregar sitio web, para realizar la

configuración básica del sitio WEB.

A continuación se presentan la definición de cada uno de los campos de la

ventana Agregar sitio web:

• Nombre del sitio: Nombre que identifica el sitio, se recomienda crearlo con el
nombre de la aplicación de ACTSIS a instalar. Ejemplo: “SAC”

• Grupo de aplicaciones: Los grupos de aplicaciones son espacios de la

memoria del servidor donde corren los diferentes sitios en IIS, haga clic en el
botón SELECCIONAR para asignar un grupo previamente creado. Si no se
selecciona un grupo, se creará un grupo de manera automática, con el nombre
del sitio del campo anterior.

• Ruta de acceso física: Ruta física de la carpeta en el servidor, donde se

ubicará la aplicación, tenga en cuenta que la carpeta debe haberse creado
previamente. Ejemplo: C:\ACTSIS\SAC.

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 6 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

• Tipo: Tipo de enlace en la que va a estar disponible el sitio que puede ser
HTTP o HTTPS, si es de tipo HTTPS se debe cargar el certificado SSL de
seguridad. Se sugiere siempre utilizar HTTPS.

• Dirección IP: Dirección disponible de las establecidas en el servidor, la cual

utilizara el explorador para abrir el sitio, si no se asigna una específica se
habilitará el acceso a través de todas las direcciones disponibles.

• Puerto: Puerto donde está disponible el sitio, Ejemplo: 8001.

• Iniciar Sitio web inmediatamente: Active esta casilla para que el sitio WEB se
inicie, al finalizar la configuración.

5. En el nodo Grupos de aplicaciones, haga clic derecho sobre el grupo de

aplicaciones definido para el sitio creado y luego clic en la opción
Configuración avanzada.
6. En la ventana de configuración avanzada del grupo de aplicaciones
seleccionado, ubique la opción de configuración Identidad, dentro de la
sección Modelo de Proceso, para definir el usuario o cuenta integrada sobre
la cual se ejecutaran los sitios web o aplicaciones, del grupo de aplicaciones.

Nota: Tenga en cuenta que este usuario debe tener acceso de lectura y
escritura en las carpetas y/o rutas externas a la aplicación ejemplo: ANEXOS,
LISTADOS, las cuales son definidas por cada empresa CLIENTE.
Tenga en cuenta que el uso de una cuenta integrada puede tener permisos
adicionales que pueden ser explotados de las aplicaciones web del grupo de
aplicaciones, por tal motivo no se recomienda el uso de usuarios como
NetworkService.

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 7 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

7. En la sección GRUPO DE APLICACIONES del servidor verifique que la

versión del framework sea 4.0 y el modo de canalización sea integrada, de lo
contrario ajuste la configuración.

5.2 PUBLICACIÓN DEL SITIO WEB

5.2.1 INSTALAR O ACTUALIZAR EL SITIO

1. Abra la consola de administración IIS.

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 8 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

2. Haga clic derecho en el sitio que va a publicar y seleccione la opción Explorar,

automáticamente se abre la carpeta donde se realiza la publicación.

3. Si existe un sitio previamente, elimine el contenido de esta carpeta. Se

recomienda realizar una copia de seguridad del contenido antes de ser
eliminado.
4. Extraer en esta carpeta el contenido del comprimido entregable con el sitio
enviado por ACTSIS.

5.2.2 HABILITAR PERMISOS SOBRE LAS CARPETAS DE LA APLICACIÓN

1. Asigne permisos de escritura al usuario que fue configurado en la creación del

SITIO WEB y quien inicia la aplicación, en las carpetas internas de la aplicación,
ejemplo: TEMP, REPORTES

Nota: Tenga en cuenta que los permisos se deben asignar cada vez que se
publique una nueva aplicación o se actualice.

2. Si existe una o más carpetas externas a la aplicación, ejemplo: ANEXOS,

LISTADOS, las cuales son definidas por cada empresa CLIENTE, también se
debe brindar permisos de escritura al usuario mencionado.

5.3 MODIFICACIÓN ARCHIVO DE CONFIGURACIÓN APLICACIÓN

Las aplicaciones cuentan con una serie de parámetros para su correcto funcionamiento,
registrados en el archivo de configuración Web.config, ubicado dentro de cada
aplicación. Dichos parámetros son listados a continuación:

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 9 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

Parámetro Descripción
Propiedad que indica el nombre del técnico del
VA_SISTEMA sistema es usado en el flujo de las pantallas
entregadas
Propiedad que indica el nombre descriptivo del
VA_SISTEMA_NOM
sistema en el flujo de las pantallas entregadas
Propiedad que indica a la cadena de conexión
VA_STRING_MODELO
necesaria para que la aplicación se conecte a la
base de datos
Propiedad que indica el nombre del servidor donde
VA_HOST_BD
el aplicativo debe realizar la conexión
Propiedad que indica el número del puerto por
VA_PORT_BD
donde debe el aplicativo realizar la conexión
Propiedad que indica la nomenclatura de servicios
VA_SERVICE_NAME_BD
configurada en el tnsnames del servidor de
aplicaciones para acceder a la base de datos
desde los servicios de generación de reportes
Propiedad que indica el nombre del usuario del
VA_USER_ID_BD
base datos que realizar la conexión
Propiedad que indica la clave del usuario del base
VA_PASSWORD_BD
datos que realizar la conexión

ACTSIS dentro de los entregables relaciona en un archivo de hoja de cálculo, ejemplo:

SAC_webconfig, con los parámetros predefinidos por ACTSIS para ser actualizados con
los parámetros establecidos por el cliente.

5.3.1 CIFRADO DE PARAMETROS DE APLICACIÓN

Los parámetros de aplicación, registrados en el archivo de configuración web.config,

pueden ser cifrados a partir de los siguientes pasos:

1. Ejecute la línea de comandos de Windows como usuario administrador.

2. En el símbolo del sistema, escriba el siguiente comando para cambiar al
directorio de .NET Framework 2.0 y pulse la tecla ENTER.
cd %systemroot%\Microsoft.NET\Framework\v2.0.*

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 10 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

3. En el símbolo del sistema, ejecute aspnet_regiis.exe con las siguientes

opciones y pulse la tecla ENTER:
• La opción -pef y la cadena "appSettings" para cifrar el elemento del archivo
appSettings Web.config de la aplicación.
• Espacio y entre comillas la ruta de la carpeta donde está la aplicación
publicada “B:\ACTSIS\SAC\SAC_FACTURACION”.
aspnet_regiis -pef "appSettings" "B:\ACTSIS\SAC\SAC_FACTURACION"

4. Cuando termina la ejecución del comando, se puede ver el contenido del archivo
web.config cifrado.

NOTA: Se debe realizar este proceso cada vez que se realice la publicación.

5.4 IMPRESIÓN DE REPORTES CRYSTAL CON CODIGOS DE BARRA

Estos pasos son opcionales en caso de requerirse la generación e impresión de reportes

Crystal Reports con códigos de barra.

5.4.1 INSTALACIÓN DE FUENTES

Para la correcta generación de los reportes Crystal con códigos de barra, se requiere la
instalación en el servidor de las fuentes IDAutomationC128S y IDAutomationC128M, las
cuales son entregadas por parte de ACTSIS.

1. Haga doble clic sobre el archivo de fuente.

2. Haga clic en el botón Instalar, para instalar la fuente en el servidor.
3. Repita los pasos para cada fuente.

5.4.2 FORZAR TAMAÑO DE FUENTES

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 11 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

Durante la generación de los reportes Crystal con códigos de barra, se presenta

modificación del tamaño de las fuentes, para corregir el tamaño es necesario forzar al
motor de Crystal a mantener el tamaño de las fuentes de la siguiente manera:

1. Escriba regedit.exe en el cuadro de diálogo Ejecutar de Windows para abrir el

Editor de Registro.

2. Ubique las claves de registro de Crystal Reports usando las siguientes rutas:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SAP BusinessObjects\
Crystal Reports for .NET Framework 4.0\Crystal Reports

HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for

.NET Framework 4.0\Crystal Reports

3. Agregue una clave llamada Export y dentro de esta una nueva clave llamada Pdf.
La estructura final se verá así en ambos casos:

4. En la clave Pdf agregue un nuevo valor DWORD (32-bit) con el nombre

ForceLargerFonts.

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 12 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

5. En el valor creado (ForceLargerFonts), haga clic derecho y cambie el valor del

dato de 0 a 1 y guarde el valor.

Una vez completado estos pasos, el nuevo valor debe verse de la siguiente
manera.

DOCUMENTO EN VALIDACIÓN
 Código: IM-09 Versión: 02
Instalación de Aplicaciones .NET Fecha:
Página: 13 de 13
Validación
Elaboró: Ing. Wilmer E Peña Pabón Aprobó: Iván Darío Sarmiento León Controlado: SI

6. PRUEBA DE PUBLICACIÓN

6. Abra la consola de administración del IIS

7. Seleccione la aplicación publicada.
8. En el panel ACCIONES, ubicado en la parte izquierda de la pantalla, haga clic en
la opción “Examinar aplicación”, y verifique que se despliega la aplicación en el
explorador WEB.

7. REGISTRO HISTORICO DEL DOCUMENTO

Versión Fecha Cambio realizado

01 18/04/2018 Creación del documento.
Modificación del document por requisitos y ajustes necesarios al
02 Validación
ambiente. FA-05_570

DOCUMENTO EN VALIDACIÓN