Manual de Instalación de

Aplicación de Recibo en Línea

Configuración de WS y
Aplicativo
Contenido
Requisitos Previos..............................................................................................................................3
Instalación de Oracle Data Access Components for .Net...................................................................3
Configurar TNSNames........................................................................................................................9
Instalación de IIS..............................................................................................................................11
Configuración de IIS.........................................................................................................................13
Descarga de archivos del WS en la ruta adecuada.......................................................................13
Configuración de WS....................................................................................................................14
Configurar el grupo de aplicaciones (Applications Pool)..............................................................16
Configuración del Archivo de Parámetros Web.Config................................................................19
Instalación de Aplicación..................................................................................................................23
Errores de aplicación........................................................................................................................25
Actualización de Web Service..........................................................................................................27
Actualización de Aplicación de Administración................................................................................29

2
Requisitos Previos

Para la configuración del equipo que será usado como servidor, es necesario considerar los
siguientes requisitos previos:

 Tener disponible usuario y password para conectarse a la base de datos.

 Tener permiso de administrador en el equipo a configurar.
 Link de descarga: ftp-interno.priceshoes.com/Recibo Linea

Instalación de Oracle Data Access Components for .Net.

1. Ubicar y extraer el archivo “ODAC1120320_x64.zip”, dando clic derecho en el archivo y

seleccionado “Extraer Todo”.

2. Escribir un directorio de extracción cuando se solicite y dar clic en “Extraer”

3. Esperar a que termine la extracción

3
4. Dentro de la carpeta descomprimida buscar y ejecutar “Setup.exe”.

5. Cuando el sistema lo solicite permitir el uso de permisos de administrador elevados

6. En la pantalla principal dar clic en siguiente

4
7. Seleccionar la primera opción “Oracle Data Access Components for Oracle Client
11.2.0.3.20” y dar clic en “Siguiente”.

8. Dejar los parámetros por defecto que aparecen y dar clic en “Siguiente”. Tomar nota del
directorio de instalación indicado como “Ruta de Acceso”.

5
9. Dejar los componentes a instalar por defecto y dar clic “Siguiente”.

10. Confirmar la instalación dando clic en “Siguiente”.

6
11. Verificar el resumen de instalación y dar clic en “Instalar”.

12. Esperar a que la instalación termine

7
13. Para salir del instalador dar clic en “Salir”.

8
Configurar TNSNames

1. Dirigirse al directorio de instalación conocido como %oracle_home% o raíz el cual es el

mismo que el directorio de instalación del ODAC %oracle_home%=C:\app\Win7\product\
11.2.0\client_2\ Dentro del directorio raíz dirigirse a “Network\Admin” y dentro crear un
archivo sin extensión llamado “tnsnames.ora”.

2.- Abrir el archivo con bloc de notas y escribir los parámetros de conexión de acuerdo a nuestros
parámetros de conexión. Por ejemplo:

Connection_name =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = xxx.xxx.xxx.xxx)(PORT = 1521))
)
(CONNECT_DATA =
(SID = MySID)
)
)

Donde Connection_name es el nombre de la conexión, xxx.xxx.xxx.xxx es la IP en formato decimal

del servidor y MySID es el ID del servicio de Oracle.

9
10
Instalación de IIS
1. Abrir el panel de control

2. Dentro del panel de control, seleccionar el grupo programas y la opción “Desinstalar un

programa”.

3. En el panel izquierdo, seleccionar “Activar o desactivar características de Windows”.

4. En la ventana “Características de Windows”, seleccionar “Internet Information Services”. Al

abrir el árbol de opciones seleccionar:

11
 a. Herramientas de administración Web (Web Management Tools):
i. “Consola de administración de IIS (IIS Management Console)”
b. Servicios World Wide Web (World Wide Web Services):
i. Abrir opción “Características de desarrollo de aplicaciones (Application
Development Features)” y seleccionar:
1. “ASP” y “ASP.NET”. Algunas características serán marcasas
automáticamente.
Dar clic en “Aceptar” para continuar.

5. Esperar a que termine el proceso

6. Para abrir el IIS, es necesario abrir el menú de inicio y escribir IIS dentro del cuadro buscar.

Configuración de IIS

12
Descarga de archivos del WS en la ruta adecuada

Para poder realizar la correcta instalación del WS, es necesario descargar los archivos del sitio
proporcionado:

 URL:
 Carpeta a descargar y descomprimir: WS
 Ruta local destino: C:\inetpub\

13
Configuración de WS

1. Abrir IIS y dentro del árbol de sitios dar clic derecho y seleccionar “Agregar sitio web…”

2. Colocar un nombre para el nuevo sitio, por ejemplo “MyWebSite”.

3.- Seleccionar un “directorio raíz” para el sitio dando clic en “…”, seleccionar la ruta y dar clic en
“Aceptar”.

14
4. Es importante cambiar el puerto de acuerdo a la aplicación. Dar clic en “Aceptar” para crear el
sitio.

5.- Verificar que el sitio se halla creado correctamente

15
Configurar el grupo de aplicaciones (Applications Pool)

1. Del árbol de opciones, seleccionar “Grupo de aplicaciones”. Al configurar el WS, se crea un

Grupo de Aplicación con el mismo nombre que el del WS, ubicarlo y seleccionarlo.

2. Ingresar los campos solicitados de acuerdo a lo siguiente:

a. Versión de .NET CLR: .NET CLR versión v4.0.30319
b. Modo de canalización administrada: Integrada
c. Dejar seleccionado el ckeck “Iniciar grupo de aplicaciones inmediatamente”

Dar clic en Aceptar.

16
3. Con el grupo de aplicaciones seleccionado, en el panel derecho “Acciones” seleccionar
“Configuración Avanzada”.

4. En la configuración avanzada, actualizar los siguientes parámetros:

a. “Habilitar aplicaciones de 32 bits:” Si el equipo tiene un sistema operativo a 32
bits, deberá asignar el valor True en esta opción. De no ser así, asegurar que la
opción seleccionada, sea False.
b. “Identidad:” Asignar valor con el botón

17
5. Dentro de la ventana “Identidad del grupo de aplicaciones”, seleccionar “Cuenta
personalizad” y dar clic en “Establecer”.

Nota: es recomendable crear un usuario de Windows específico para el sitio, el cual tenga
los permisos adecuados.

6. Escribimos el usuario y contraseña y presionamos “Aceptar”.

7. Dar clic en “Aceptar” para terminar la configuración.

18
Configuración del Archivo de Parámetros Web.Config.

1. Localizar el archivo Web.config, ubicado en la carpeta donde se colocó el WS.

2. El archivo Web.Config contiene dos secciones principales para la operación del Web
Service:
 “appSettings”: parámetros que ocupa el servidor SMTP para el envío de correos.
 “connectionStrings”. Línea de conexión con la base de datos del programa.

Es necesario actualizar estos valores de acuerdo a la información de cada tienda.

3. Los parámetros por defecto son los siguientes:

<appSettings>
<add key="smtp" value="172.20.1.5"/>
<add key="port" value="587"/>
<add key="ssl-req" value="false"/>
<add key="user" value="inventarios@priceshoes.mx"/>
<add key="pwd" value="123"/>
<add key="for" value="framirez@priceshoes.com,vepitacio@tdtpsion.com.mx"/>
</appSettings>

19
 <connectionStrings>
<add name="PriceShoes" connectionString="DATA SOURCE=VALLEJO;USER
ID=provtdt;PASSWORD=externovjo;" providerName="Oracle.DataAccess" />
</connectionStrings>

4. El significado de los parámetros de appSettings es el siguiente:

Parámetro Valor Comentario

Smtp IP o nombre del servidor SMTP IP o nombre del servidor SMTP para envió de
correos
Port 587 Es el número de puerto del servidor SMTP por
defecto es 587.
ssl-req True/false Indica si el servidor SMTP requiere utilizar SSL
User Nombre de la cuenta de email Cuenta para autenticar en el servidor SMTP, es
la misma que el remitente de los correos que
saldrán del sistema.
Pwd Contraseña de la cuenta de Contraseña para autenticar en el servidor SMTP
correo
For Correo de destino Lista de correos de destinatarios, si es más de
uno serán separados por comas ‘,’.

5. Verificar que el sitio esté funcionando

6. En caso de error ejecutar el comando de reinstalación de ASP.NET

20
7. Abrir una línea de comandos en modo administrador y ejecutar “C:\Windows\
Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i”.

21
Instalación de Aplicación

1. Descargar del link proporcionado la carpeta PC, a una ubicación local en el equipo.
2. Desde la ubicación local, buscar el archivo PS_REL_ADMIN.exe

3. Abrir el archivo PS_REL_ADMIN.exe en un Bloc de Notas y actualizar la cadena de conexión

de acuerdo a los datos proporcionados. Modificar parámetros DATA SOURCE (Nombre de
la base de Datos), USER ID (Usuario de Conexión) y PASSWORD (Password de Conexión).

4. Desde la ubicación local, buscar el archivo: PS_REL_ADMIN

22
5. Ejecutar dando doble clic el archivo PS_REL_ADMIN
6. Al ejecutar el archivo, se mostrará la siguiente pantalla:

7. El sistema está listo para ser operado. Se sugiere realizar una prueba con un usuario
Responsable del área de recibo.

23
Errores de aplicación.

Si al momento de ejecutar la aplicación de Administración, se obtiene el error mostrado a

continuación, es necesario asegurar que se haya realizado la instalación del Oracle y si se realizó,
verificar que se haya realizado correctamente.

Si al momento de ejecutar el WS, se obtiene el error que sea similar al mostrado a continuación, es
necesario asegurar que se haya realizado la instalación del Oracle y si se realizó, verificar que se
haya realizado correctamente.

24
Otro de los errores posibles que puede presentarse al realizar la validación del WS, es el siguiente:

Este error hace referencia a la configuración del Grupo de Aplicaciones. Para solucionarlo, es
necesario validar, la configuración avanzada:

1. En la configuración avanzada, validar los siguientes parámetros:

a. “Habilitar aplicaciones de 32 bits:” Si el equipo tiene un sistema operativo a 32
bits, deberá asignar el valor True en esta opción. De no ser así, asegurar que la
opción seleccionada, sea False.
2. Guardar la información e intentar de nuevo

25
Actualización de Web Service

Si es necesario realizar alguna actualización al Web Service, es necesario seguir los siguientes
pasos:

1. Solicitar el paro de operación para poder realizar la actualización.

2. Buscar en el link, la carpeta WS y descargar la carpeta BIN y el archivo PSREL.asmx
3. Sustituir en la carpeta donde quedo instalado el Web Service.
4. Verificar la versión al invocar el método Prueba desde la dirección
http://localhost:5050. La versión se indicará al momento de solicitar la actualización.

26
27
Actualización de Aplicación de Administración

Si es necesario realizar alguna actualización a la aplicación de Administración, es necesario seguir

los siguientes pasos:

1. Solicitar el paro de operación para poder realizar la actualización.

2. Buscar en el link, la carpeta PC y descargar el archivo PS_REL_ADMIN

3. Sustituir en la carpeta donde quedo instalado la aplicación.

4. Verificar la versión ejecutando la aplicación. La versión se indicará al momento de
solicitar la actualización.

28