You are on page 1of 51

Proyecto de Licenciamiento Progress para

la Secretara de Economa.



Memoria Tcnica Servidor Atenea-Desa








Avansit

Consultor: Luis Ivn Ferreyra Mxico DF a 30 de Agosto de 2012




Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

2



Contenido
Proyecto de Licenciamiento Progress para la Secretara de Economa ........ Error! Bookmark not defined.
1 REQUISITOS DE LA INSTALACION .....................................................................................................5
1.1 Requerimientos Tcnicos antes de Instalacin Progress OpenEdge para servidores Unix/Linux, Solaris5
1.2 Requerimientos del Servidor de Aplicaciones: .......................................................................................5
1.2.1 CPUs Instalados:....................................................................................................................5
1.2.2 Tipo de CPUs Fsicos: ............................................................................................................5
1.2.3 Tipo de CPUs Fsicas y Virtuales: ...........................................................................................5
1.2.4 Plataforma (sistema operativo) ................................................................................................6
1.2.5 FileSystem de ATENEA-DESA ................................................................................................6
1.2.6 IP Virtual .................................................................................................................................6
2 PROCESO DE INSTALACION DE PROGRESS OPENEDGE ...............................................................7
2.1 Preparacin ...........................................................................................................................................7
2.2 Registro de licencias a instalar .............................................................................................................8
2.3 Opciones de Instalacin de Progress OpenEdge ................................................................................. 11
2.3.1 Habilitar OpenEdge Explorer ................................................................................................. 11
2.3.2 Tipo de Instalacin ................................................................................................................ 12
2.3.3 Ambiente de Instalacin ........................................................................................................ 13
2.3.4 Directorio de Instalacin (Destination Pathname) .................................................................. 13
2.3.5 Directorio de Trabajo (Work Directory Path) .......................................................................... 14
2.3.6 Directorio de Administracin (Management Pathname) ......................................................... 15
2.3.7 Directorio de Trabajo de Administracin (Management Work Path) ....................................... 16
2.3.8 Opciones Complementarias al Tipo y Destino de Instalacin ................................................. 17
2.3.9 SQL Server Engine ............................................................................................................... 18
2.3.10 Consideraciones: SQL Server Engine ................................................................................... 18
2.3.11 Adaptador de Enterprise Service Bus (ESB) de Sonic ........................................................... 19
2.3.12 Consideraciones del Sonic ESB ............................................................................................ 19
2.4 Opciones de Instalacin para los Componentes de WebSpeed ........................................................... 20
2.4.1 Consideraciones: Requisitos para instalacin de WebSpeed ................................................. 20
2.4.2 Seleccin del WebServer Type 1........................................................................................... 21
2.4.3 Seleccin del WebServer Type 2........................................................................................... 22
2.4.4 Seleccin del Web Server Script directory ............................................................................ 23
2.4.5 Instalacin de Scripts del WebServer .................................................................................... 24
2.5 Opciones de Instalacin para la Ejecucin Progress OpenEdge .......................................................... 25
2.5.1 Seleccin de Lenguajes de Instalacin .................................................................................. 25


Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

3


2.5.2 Seleccin de Lenguaje Default .............................................................................................. 26
2.5.3 Seleccin de Opciones Regionales ....................................................................................... 27
2.5.4 Seleccin de Formato de Fecha ............................................................................................ 28
2.5.5 Seleccin de Formato Numrico............................................................................................ 29
2.5.6 Opciones Complementarias .................................................................................................. 30
2.6 Parmetros para Adaptador de los Servicios WEB Direccin Default URL ........................................... 31
2.6.1 Autentificacin del Administrador de Servicios Web (WSA) ................................................... 32
2.7 Instalacin de Progress OpenEdge y Herramientas de Ambiente ........................................................ 33
2.8 Copia de Scripts sobre el directorio de instalacin de Progress ........................................................... 34
2.9 Fin de la Instalacin de Progress OpenEdge ....................................................................................... 35
3 ANEXO 1 - VERIFICACION DE INSTALACION DE PROGRESS OPENEDGE.................................... 36
3.1 Directorio de instalacin Progress OpenEdge ...................................................................................... 36
3.2 Versin Progress OpenEdge Instalada ................................................................................................ 36
3.3 Licencias Progress OpenEdge instaladas ............................................................................................ 36
3.4 Configuraciones Instaladas de Progress OpenEdge ............................................................................ 36
4 ANEXO 2 CONFIGURACIN DE HERRAMIENTAS DE AMBIENTE ................................................ 37
4.1 APACHE v2.2 (WebServer) - Configuracin General de WebServer (messenger)................................ 37
4.1.1 Archivo de configuracin para Interfaces y vinculacin de puertos httpd.conf ......................... 37
4.1.2 Archivo de configuracin para administracin de recursos y aplicaciones: httpd-vhosts.conf.. 38
5 ANEXO 3 - COMO CONFIGURAR EL USO DE LIBRERAS DE PERL PARA LA INTERFAZ DE
WEBSPEED .................................................................................................................................................... 39
6 ANEXO 4 CONFIGURACION DE INICIO PARA CADA APLICATIVO (brokers de ejecucin) ............ 40
6.1 Configuracin General de WebSpeed Server (messenger). ................................................................. 40
6.2 Configuraciones que deben incluirse en el archivo ubroker.properties ................................................. 40
6.3 Ejemplo de la configuracin de un broker: ........................................................................................... 40
6.3.1 Consideraciones para la configuracin de brokers ................................................................. 40
6.4 Parmetros vlidos para configurar el WebSpeed (Messenger) ........................................................... 41
7 ANEXO 5 - CONSIDERACIONES: TAGGS UTILIZADOS PARA LA CONFIGURACION DE APACHE EN
LOS ARCHIVOS HTTPD.CONF Y HTTPD-VHOSTS ....................................................................................... 42
7.1 <Directory>......................................................................................................................................... 42
7.2 <DirectoryMatch>................................................................................................................................ 42
7.3 <Files>................................................................................................................................................ 42
7.4 <FilesMatch>....................................................................................................................................... 42
7.5 <Location>.......................................................................................................................................... 42
7.6 <LocationMatch>................................................................................................................................. 42
7.7 <VirtualHost>...................................................................................................................................... 42
7.8 <Proxy>.............................................................................................................................................. 42
7.9 <ProxyMatch>..................................................................................................................................... 42
7.10 <IfDefine>......................................................................................................................................... 42


Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

4


7.11 <IfModule>....................................................................................................................................... 42
7.12 Directivas globales de configuracin ................................................................................................. 43
7.12.1 ServerRoot............................................................................................................................ 43
7.12.2 KeepAlive ............................................................................................................................. 43
7.12.3 Listen .................................................................................................................................... 43
7.12.4 LoadModule .......................................................................................................................... 43
7.13 Directivas principales ........................................................................................................................ 43
7.13.1 ServerAdmin ......................................................................................................................... 43
7.13.2 ServerName .......................................................................................................................... 44
7.13.3 DocumentRoot ...................................................................................................................... 44
7.13.4 DirectoryIndex ....................................................................................................................... 44
7.13.5 AccessFileName ................................................................................................................... 44
7.13.6 ErrorDocument ...................................................................................................................... 44
7.13.7 Alias ...................................................................................................................................... 44
7.13.8 UserDir ................................................................................................................................. 45
7.13.9 UserDir ................................................................................................................................. 45
7.14 Directivas de seccin ........................................................................................................................ 45
7.14.1 Allow ..................................................................................................................................... 45
7.14.2 Deny ..................................................................................................................................... 45
7.14.3 Order .................................................................................................................................... 45
7.14.4 Allow,deny ............................................................................................................................ 45
7.14.5 Deny, Allow ........................................................................................................................... 45
7.15 Servidores virtuales .......................................................................................................................... 45
7.15.1 Servidores virtuales por direccin IP...................................................................................... 46
7.15.2 Servidores virtuales por nombre ............................................................................................ 46
8 ANEXO 6 - COMANDOS UTILIZADOS PARA MANTENIMIENTO DE APACHE. ................................. 48
8.1 COMO PARAR APACHE DESDE UNIX .............................................................................................. 48
8.2 COMO PARAR APACHE DESDE LA CONSOLA APACHE ................................................................. 48
8.3 COMO INICIAR APACHE DESDE LA CONSOLA APACHE ................................................................ 48
9 ANEXO 7 - COMANDOS UTILIZADOS PARA MANTENIMIENTO DE BROKERS. .............................. 49
9.1 Variables de ambiente de Progress ..................................................................................................... 49
9.1.1 Comando proenv .................................................................................................................. 49
9.1.2 Comando proadsv ................................................................................................................. 49
9.1.3 Comando wtbman ................................................................................................................. 50
9.1.4 Como Levantar un broker ...................................................................................................... 51
9.1.5 Como detener un broker ....................................................................................................... 51





Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

5


1 REQUISITOS DE LA INSTALACION
Para un buen funcionamiento de la herramienta Progress OpenEdge y para poder cubrir las necesidades
tcnicas de LA SECRETARA DE ECONOMA, es necesario tomar en cuenta los siguientes requisitos previos a
la instalacin, ya que tanto la instalacin como su correcta parametrizacin son indispensables. Estos requisitos
abarcan aspectos tcnicos tanto de hardware como de software.
1.1 Requerimientos Tcnicos antes de Instalacin Progress OpenEdge para
servidores Unix/Linux, Solaris
Para poder mantener la funcionalidad de los desarrollos en una nueva plataforma de ejecucin, es necesario
incluir las actualizaciones correspondientes para las herramientas como sigue:
J ava Console v1.4 (J dk, Sdk) o superior.
Apache v2.2 (WebServer).
Servicios de Mensajera (utileras de SENDMAIL para manejo de correo electrnico).
PERL v5.8.4 built for sun4-solaris-64int.
OEM o addendum de la compra correspondiente al software por instalarse.
Tener disponible el archivo TAR OE102B_sol 64.tar correspondiente a Progres OpenEdge.
1.2 Requerimientos del Servidor de Aplicaciones:
En lo que respecta al apartado de hardware, se hace mencin de las especificaciones tcnicas y de
configuracin recomendadas para una buena operacin de los distintos aplicativos de LA SECRETARA DE
ECONOMA y deben permanecer con la configuracin que a continuacin se muestra.

Para el ambiente de desarrollo actualmente se cuentan con los siguientes datos:
Nombre del Servidor: ATENEA-DESA
Direccin IP 172.16.2.55
Usuario: webmstr
Password: root123

NOTA: Para saber la direccin IP del servidor se utiliza el comando ifconfig
1.2.1 CPUs Instalados:
Para saber el nmero de procesadores que estn instalados en una mquina con Solaris X, se utiliza el
comando psrinfo
# psrinfo
0 on-line since 08/01/2011 22:39:25
1.2.2 Tipo de CPUs Fsicos:
Para saber el tipo de CPU que se tiene instalado, simplemente se aade la opcin v al comando psrinfo
# psrinfo v
Status of virtual processor 0 as of: 12/26/2011 11:07:04
On-line since 08/01/2011 22:39:25. The sparcv9 processor operates at 2100 MHz, and has a sparcv9 floating
point processor.
1.2.3 Tipo de CPUs Fsicas y Virtuales:
Para saber cuntas CPUs fsicas y virtuales se tiene instaladas, simplemente se aade la opcin pv al
comando psrinfo
# psrinfo -pv
The physical processor has 1 virtual processor (0) UltraSPARC-IV (portid 0 impl 0x19 ver 0x24 clock 2100
MHz)


Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

6


1.2.4 Plataforma (sistema operativo)
Para tener un resumen de toda la informacin del sistema, se utiliza el comando uname a y al ejecutarlo
muestra en orden, el tipo de kernel, el nombre del equipo, versin de kernel, arquitectura del CPU, el tipo de
procesador y tipo de sistema operativo.



En donde:
SunOS es el kernel utilizado, ATENEA-DESA es el nombre del equipo, 5.10 Generic__142909-17 es la versin
del kernel, sun4u es la arquitectura del CPU, sparc SUNW es el tipo de procesador y Sun-Fire-V490 es el tipo
de sistema operativo.
1.2.5 FileSystem de ATENEA-DESA
Para identificar el espacio utilizado en los discos del servidor, se utiliza el comando df ms la opcin -h (formato
humano) se aade para poder ver las medidas del file-system en Megas o Gigas, como se muestra en la
siguiente imagen.


1.2.6 IP Virtual
La Definicin de una o ms IP Virtuales en SO solo aplica si las necesidades y arquitectura del sistema que se
utilizar con WebSpeed as lo requieren.

Para identificar que direcciones virtuales se utilizan en el server, se debe utilizar el comando ifconfig con el
parmetro a. Debe tenerse en cuenta que solamente ROOT puede ejecutarlo.
Ejemplo:
# ifconfig -a












Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

7


2 PROCESO DE INSTALACION DE PROGRESS OPENEDGE
Una vez aplicados todos los puntos enumerados en el captulo Requisitos de la Instalacin del presente
documento se podr iniciar con la instalacin de Progress OpenEdge.
2.1 Preparacin
1. Crear la carpeta /opt/sw
2. Copiar dentro de la nueva carpeta el archivo OE102B_sol64.tar

3. Descomprimir dentro de esa misma carpeta el archivo OE102B_sol 64.tar utilizando el comando tar
#tar xvf <archivo.tar>
4. Posteriormente crear la carpeta /usr/dlc.
5. Dentro de la nueva carpeta /usr/dlc se ejecut la lnea de comando: /opt/sw/proinst


Despus de esto, el asistente de instalacin muestra esta pantalla y con esto estamos listos para comenzar la
instalacin.





Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

8


2.2 Registro de licencias a instalar
Para este paso es necesario contar con la hoja de OEM de Progress, generalmente esta hoja es de color verde
y en la cual Progress siempre hace referencia de los productos que el cliente adquiri indicando el nmero de
serie del producto y su correspondiente nmero de licenciamiento.

Para realizar el registro de las licencias a instalar el asistente de la instalacin mostrar la siguiente pantalla:



Aqu se deben especificar los siguientes datos de manera obligatoria:
1. Nombre de la compaa
2. Nmero de serie de los componentes a instalar
3. Nmero de control de cada uno de los componentes a instalar

***Nota: cada uno de los componentes posee un nmero de control independiente, para mayor
referencia ver la hoja de OEM de licenciamiento de Progress (ver captulo Requisitos de la Instalacin).

En esta pantalla los nmeros de control aparecen con la leyenda de confirmacin y aceptacin, las opciones que
aparecen en el men son:
Enter : Permite adicionar nuevos componentes (grabar los datos de algn otro componente)
CTRL-E: Valida los componentes seleccionados e inicia la instalacin.

En caso de seleccionar la opcin Enter, el asistente solicitar ingresar un nuevo nmero de serie y su
licenciamiento como nuevo componente.









Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

9


Cada vez que se ingresa un nuevo componente, el asistente mostrar la siguiente pantalla, donde se indica
cules son los componentes que hasta el momento se han ingresado y que estn listos para instalarse.



Nota: En el caso concreto de ATENEA-DESA los componentes (productos) que se ingresaron en la
instalacin fueron:
1. OE Enterprise RDBMS Sun
2. OE Application Svr Ent Sun
3. 4GL Development System Sun
4. Replication PLUS
Todos con sus respectivos Serial y Licenciamiento.














Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

10



Una vez que se ha terminado de ingresar los nmeros de control de los componentes a instalar, debe
seleccionarse CTRL-E y de manera inmediata el asistente mostrar la siguiente pantalla, donde se pide
confirmacin para el inicio de la instalacin de los productos Progress:



En caso de seleccionarse la opcin NO el asistente regresar a la pantalla anterior.

Si se selecciona la opcin YES el sistema comenzar la instalacin.

En esta opcin se seleccion YES



















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

11



2.3 Opciones de Instalacin de Progress OpenEdge
Una vez que se han ingresado y validado los componentes de Progress que han de instalarse, el asistente
mostrar las distintas opciones que componen la instalacin de Progress.

2.3.1 Habilitar OpenEdge Explorer
Las necesidades iniciales de SE e La Secretara de Economa no contemplan el uso de herramientas como el
OpenEdge Explorer, el cual es una herramienta basada en administracin tipo browser que permite la
configuracin y administracin de los recursos de OpenEdge instalados en el server.



En el caso concreto de ATENEA-DESA se indic al asistente de instalacin que NO realizara la
instalacin de esta funcionalidad ya que las necesidades de la Secretara de Economa no contemplan
su uso.

Nota: Se sugiere que solamente se contemple su utilizacin si se cuentan con conocimientos avanzados
en DBA Progress.









Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

12





2.3.2 Tipo de Instalacin
El siguiente paso es indicar al asistente el modo de instalacin: Instalacin Completa, lo cual como su nombre
indica instalar todos los componentes correspondientes a la plataforma Solaris incluidos en el paquete de
Progress adquirido por la SE.



Para el caso concreto de ATENEA-DESA se selecci on la opcin Complete Install

Se sugiere que la opcin Instalacin Personalizada solamente se contemple si se cuentan con
conocimientos avanzados en DBA Progress.
















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

13





2.3.3 Ambiente de Instalacin
Una vez seleccionado el modo de instalacin el asistente mostrar una pantalla con las opciones para la
seleccin de las carpetas de instalacin de Progress OpenEdge, esto es:
Destination Pathname se refiere al path por defecto de la instalacin de OpenEdge (/usr/dlc).
Work Directory Path se refiere al propath por defecto del directorio de Trabajo (/usr/wrk).
Management Pathname se refiere a l path de las carpetas donde se alojar la herramienta de
OpenEdge Management. (/usr/oemgmt).

2.3.4 Directorio de Instalacin (Destination Pathname)
La primera opcin que debe seleccionarse es Select Destination Pathname y se refiere a la carpeta donde
se realizar la instalacin de Progress OpenEdge.

El valor por omisin en esta opcin es: /usr/dlc.



En este caso se seleccion el path por defecto: /usr/dlc




Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

14






2.3.5 Directorio de Trabajo (Work Directory Path)
Una vez que se ha seleccionado el directorio de la instalacin para Progress OpenEdge se indica al asistente
cual ser el directorio de trabajo a utilizar por los distintos componentes de progress.

El valor por omisin en esta opcin es /usr/wrk.



En este caso se seleccion el path por defecto: /usr/wrk












Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

15





2.3.6 Directorio de Administracin (Management Pathname)
Una vez que se ha seleccionado el directorio de la instalacin para Progress OpenEdge se indica al asistente
cual ser el directorio donde se instalarn los componentes de administracin de procesos internos de Progress.

El valor por omisin en esta opcin es /usr/oemgmt.




En este caso se seleccion el path por defecto: /usr/eomgmt












Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

16





2.3.7 Directorio de Trabajo de Administracin (Management Work Path)
Una vez que se ha seleccionado el directorio de la instalacin para Progress OpenEdge se indica al asistente
cual ser el directorio de trabajo a utilizar por los componentes de administracin de procesos internos de
Progress.

El valor por omisin en esta opcin es /usr/wrk_oemgmt.




En este caso se seleccion el path por defecto: /usr/wrk_oemgmt











Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

17




2.3.8 Opciones Complementarias al Tipo y Destino de Instalacin
Posteriormente a la seleccin del modo de instalacin el usuario contar con 5 opciones:
1. Continuar con la instalacin
2. Revisar las notas de la versin
3. Cancelar los cambios realizados hasta este punto
4. Abortar la instalacin
5. Recibir ayuda sobre la instalacin



Para el caso concreto de ATENEA-DESA se selecci on la opcin Continue with Installation

Continuar con la instalacin
Al seleccionar esta opcin podr continuarse con la instalacin de Progress OpenEdge

Revisar las notas de la versin
Al seleccionar esta opcin el asistente mostrar las notas relativas a las mejoras de la versin que se instala.

Cancelar los cambios realizados hasta este punto
Al seleccionar esta opcin el usuario puede regresar a la pantalla de Seleccin de Tipo y Destino de la
Instalacin (punto 2.2)

Cancelar la instalacin
Al seleccionar esta opcin el asistente preguntar la confirmacin para cancelar la instalacin de Progress.

Recibir ayuda sobre la instalacin


Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

18


Al seleccionar esta opcin el asistente mostrar un recuadro de ayuda mostrando temas relacionados con el tipo
y el destino de la instalacin
2.3.9 SQL Server Engine
Esta herramienta es una funcionalidad estndar de Progress OpenEdge, su instalacin permite, mediante un
motor SQL, acceder a las bases de datos que sern instaladas en Progress.

La instalacin de motor aporta mayores funcionalidades y robustez a los motores de las bases de datos.



Para este caso se seleccion la instalacin de SQL Server Engine ya que este es un parmetro estndar
para todas las instalaciones de Progress, porque permite acrecentar la robustez y escalabilidad de la
base de datos

***Nota: Para mayor detalle tcnico sobre los componentes que fueron instalados para cada producto
Progress, ver el contenido del archivo installd.ini ubicado en /usr/dlc. (ej. more /usr/dlc/installd.ini )

2.3.10 Consideraciones: SQL Server Engine
Por defecto el asistente selecciona la opcin Utilizar la Herramienta SQL via Server Engine, si se desea no
utilizar SQL, se debe colocar el cursor a la lnea anterior y dar barra espaciadora para omitir la seleccin por
defecto y se borrar el smbolo * con lo que se est indicando que no se requiere de esta funcin.







Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

19





2.3.11 Adaptador de Enterprise Service Bus (ESB) de Sonic
Este componente Progress es un integrador de aplicaciones, el cual permite integrar varios sistemas construidos
en distintas plataformas bajo un sistema global y nico, manejando reglas de software tipo SOA (Service
Oriented Architecture) y ESB (Enterprise Service Bus).



Para el caso concreto de ATENEA-DESA no se incluy la instalacin de este componente ya que las
necesidades iniciales de la Secretara de Economa no contemplan su uso.

***Nota: Para mayor detalle tcnico sobre los componentes que fueron instalados para cada producto
Progress, ver el contenido del archivo installd.ini ubicado en /usr/dlc. (ej. more /usr/dlc/installd.ini )

2.3.12 Consideraciones del Sonic ESB
Se sugiere que solamente se contemple su utilizacin si se cuentan con conocimientos avanzados en DBA
Progress.










Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

20




2.4 Opciones de Instalacin para los Componentes de WebSpeed
El componente de Progress WebSpeed est compuesto por Progress WebSpeed Workshop y Progress
WebSpeed Transaccin Server.

Progress WebSpeed Workshop es un conjunto integrado de herramientas de desarrollo para construir de
manera rpida aplicaciones ITP, que ofrecen una poderosa conectividad a la base de datos.

Progress WebSpeed Transaction Server proporciona una plataforma robusta para aplicaciones ITP que
requieren de una alta escalabilidad y velocidad de respuesta rpida.

Las necesidades de la Secretara de Economa e La Secretara de Economa incluyen la utilizacin de este
motor web de Progress.



Para el caso concreto de ATENEA-DESA se selecci on YES

Nota: Las necesidades de la Secretara de Economa incluyen la utilizacin de este motor web de
Progress.

2.4.1 Consideraciones: Requisitos para instalacin de WebSpeed
Antes de realizar la instalacin de WebSpeed se debe tener cubierta la instalacin de una herramienta
WebServer (Apache v2.2), la cual proveer a Progress la capacidad de ejecucin tanto de los motores de Base
de Datos como de Aplicaciones sobre un ambiente tipo WEB.


Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

21



2.4.2 Seleccin del WebServer Type 1
Una vez que se le ha indicado al asistente que si se utilizar el componente WebSpeed, se mostrar esta
pantalla, donde se seleccionar el tipo de WebServer que utilizar WebSpeed.



Nota: Para la versin OpenEdge de Progress es necesario utilizar la versin APACHE v2.2 como
WebServer (para mayor referencia ver el apartado Requerimientos Tcnicos antes de Instalacin
Progress OpenEdge para servidores Unix/Linux, Solaris del presente documento)












Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

22


2.4.3 Seleccin del WebServer Type 2
La opcin que se selecciona en este punto es CGI-Compatible ya que CGI (Common Gateway Interface) se
refiere a un trmino de estndar internacional en cuanto a intercambio de informacin mediante ambiente web.

El componente que se utiliza de manera estndar en las instalaciones de Progress como WebServer es Apache
ya que su motor CGI cumple con los estndares internacionales para el intercambio de informacin en ambientes
web.



Nota: El tipo de WebServer CGI-Compatible es el motor utilizado por Apache y se refiere a un
estndar internacional para las herramientas web




Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

23


2.4.4 Seleccin del Web Server Script directory
Es muy importante que el WebServer cuente con sus propios scripts de arranque y configuraciones, ya que
WebSpeed necesita de estos scripts para poder generar un enlace entre el administrador de bases de datos
Progress y el WebServer (Apache) y con ello poder levantar los servicios de WebSpeed y con esto se
garantiza una conexin estable entre todas las partes del sistema aplicacin-base de datos-ambiente web.



Nota: Es de suma importancia que la instalacin de WebSpeed sea dentro del mismo servidor donde
se encuentra instalada la herramienta WebServer

En este caso la instalacin del WebServer Apache v2.2 se encuentra en el directorio /opt/www/apache2

Para que pueda haber compatibilidad entre Progress y APACHE es necesario instalar libreras CGI, las cuales
permitirn a la plataforma WEB mantener una comunicacin directa con la aplicacin que administra las bases
de datos.

Nota: La carpeta seleccionada para la instalacin de los archivos CGI Progres-Apache en ATENEA-
DESA es: /opt/www/apache2/cgi-bin/



Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

24


2.4.5 Instalacin de Scripts del WebServer
En el siguiente paso de la instalacin se indica al asistente que deben copiarse los archivos de arranque y
configuracin de WebSpeed al directorio de arranque del WebServer.

Para esto se selecciona la opcin Copy the static HTML to docroot con lo cual aseguramos que las
aplicaciones del WebSpeed y el WebServer manejen un control de versiones compatible.



Para que WebSpeed pueda operar como servicio activo dentro del ambiente del WEBSERVER es
necesario instalar una serie de scripts que se generan de manera automtica en la instalacin.

Nota: La carpeta que se utiliz para la instalacin del docroot en ATENEA-DESA es:
/opt/www/apache2/htdocs.















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

25


2.5 Opciones de Instalacin para la Ejecucin Progress OpenEdge
El siguiente paso dentro de la instalacin de Progress es seleccionar las opciones de ejecucin, las cuales son:
Lenguaje de Instalacin
Opciones Regionales
Formato de Fecha
Formato Numrico

2.5.1 Seleccin de Lenguajes de Instalacin
Progress OpenEdge es un sistema multi-lenguaje, en esta parte de la instalacin se seleccionan tantos
lenguajes como se utilicen.

Seleccin del lenguaje 1 Seleccin del lenguaje 2

















Nota: La opcin seleccionada para ATENEA-DESA es: Spanish - Latin

Una vez que se han seleccionado los lenguajes a utilizar en la instalacin de Progress, se debe
seleccionar Continue with Installation






Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

26


2.5.2 Seleccin de Lenguaje Default
El siguiente paso consiste en indicar al asistente el lenguaje por omisin para la instalacin de Progress
OpenEdge.



Nota: La opcin seleccionada para ATENEA-DESA es: Spanish - Latin




















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

27


2.5.3 Seleccin de Opciones Regionales
A continuacin se indican al asistente los parmetros regionales, los que se conforman como sigue:
Lenguaje Estndar
Pas
Cdigo de Paginacin
Tipo de Configuracin



El parmetro que se utiliz en la instalaciones de Progress en ATENEA-DESA es:
Spanish, Spain, ISO-8859-1, Basic, Basic


















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

28


2.5.4 Seleccin de Formato de Fecha
A continuacin se indica al asistente el formato de la fecha, en este punto Progress cuenta con 3 opciones
diferentes:
da-mes-ao
mes-da-ao
ao-mes-da



Nota: El parmetro que se utiliz en la instalaciones de Progress en ATENEA-DESA es: dmy (Da-Mes-
Ao)



















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

29


2.5.5 Seleccin de Formato Numrico.
A continuacin se indica al asistente el formato numrico a utilizarse dentro de la instalacin de Progress
OpenEdge.

El parmetro estndar utilizado en Mxico para el formato numrico est basado en el sistema mtrico-decimal:
COMA-PUNTO.



Nota: El parmetro que se utiliz en la instalaciones de Progress en ATENEA-DESA es: COMA-
PERIOD



















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

30



2.5.6 Opciones Complementarias
Posteriormente a la seleccin del modo de instalacin el usuario contar con 5 opciones:
Continuar con la instalacin
Cancelar los cambios realizados hasta este punto
Abortar la instalacin
Recibir ayuda sobre la instalacin



Continuar con la instalacin
Al seleccionar esta opcin podr continuarse con la instalacin de Progress OpenEdge

Revisar las notas de la versin
Al seleccionar esta opcin el asistente mostrar las notas relativas a las mejoras de la versin que se instala.

Cancelar los cambios realizados hasta este punto
Al seleccionar esta opcin el usuario puede regresar a la pantalla de Seleccin de Tipo y Destino de la
Instalacin (punto 2.2)

Cancelar la instalacin
Al seleccionar esta opcin el asistente preguntar la confirmacin para cancelar la instalacin de Progress.

Recibir ayuda sobre la instalacin
Al seleccionar esta opcin el asistente mostrar un recuadro de ayuda mostrando temas relacionados con el tipo
y el destino de la instalacin



Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

31


2.6 Parmetros para Adaptador de los Servicios WEB Direccin Default URL
En el siguiente paso de la instalacin se indica al asistente la pgina de ejemplo para el adaptador de J ava que
se utilizar desde el WebServer.

Este parmetro se muestra en automtico y no debe editarse.

Se pulsa la tecla ENTER para continuar con la instalacin.























Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

32


2.6.1 Autentificacin del Administrador de Servicios Web (WSA)
En el siguiente paso de la instalacin se le indica al asistente la NO comprobacin de Usuario y contrasea para
el administrador de los servicios web.



Nota: Este parmetro solamente debe modificarse si los conocimientos del usuario tienen experiencia
como DBA.























Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

33


2.7 Instalacin de Progress OpenEdge y Herramientas de Ambiente
En el siguiente punto el asistente har una pausa antes de comenzar la copia de los archivos y se mostrar una
pantalla que contiene las distintas herramientas a instalar y el nmero de licencias disponibles, el espacio en
disco, el espacio requerido para la instalacin, el directorio de instalacin.

En este punto es necesario tener la seguridad de que todos los componentes seleccionados fueron
parametrizados de manera correcta porque al seleccionarse YES entonces el asistente proceder a realizar la
instalacin.



Nota: Al seleccionarse YES se inici la instalacin de Progress OpenEdge en ATENEA-DESA

















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

34


2.8 Copia de Scripts sobre el directorio de instalacin de Progress
El siguiente paso dentro de la instalacin es importante, se indica al asistente que realice la copia de Scripts de
ambiente y control de Progress sobre el directorio /usr/bin.



Nota: La copia de Scripts fue aceptada seleccionando (YES) para la instalacin de Progress OpenEdge
en ATENEA-DESA






















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

35


2.9 Fin de la Instalacin de Progress OpenEdge
Al final de la instalacin el asistente mostrar dos pantallas, la primera hace alusin a los pasos que debe seguir
el usuario para la personalizacin de WebSpeed



En esta opcin se seleccion OK

La segunda pantalla muestra un cuadro de dialogo en el que ser posible invocar las notas relativas a la versin
que se instal o en su defecto terminar con el proceso de instalacin.



En esta opcin se seleccion End The OpenEdge Installation






Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

36


3 ANEXO 1 - VERIFICACION DE INSTALACION DE PROGRESS
OPENEDGE
Nota: Para mayor detalle tcnico sobre los componentes que fueron instalados para cada producto
Progress, ver el contenido del archivo installd.ini ubicado en /usr/dlc. (ej. more /usr/dlc/installd.ini )

La informacin que a continuacin se muestra es un extracto de dicho archivo de configuracin.
3.1 Directorio de instalacin Progress OpenEdge
/usr/dlc
3.2 Versin Progress OpenEdge Instalada
OpenEdge Release as of Tue Sep 6 14:17:10 EDT 2011
3.3 Licencias Progress OpenEdge instaladas
OE Enterprise RDBMSSun 60 Users
OE Application Svr EntSun 60 Users
4GL Development SystemSun 1 Users
OE Replication Plus SystemSun -60 Users
3.4 Configuraciones Instaladas de Progress OpenEdge
***NOTA: es importante mantener un respaldo actualizado y respetar la integridad de los archivos que
a continuacin se indican, ya que el funcionamiento de PROGRESS depende de los parmetros que en
ellos se establezcan.
/usr/dlc/Install.ini
/usr/dlc/progress.cfg
/usr/dlc/startup.pf
/usr/dlc/fathom.init.params
/usr/dlc/proword.def
/usr/dlc/tagmap.dat
/usr/dlc/ade.pf
/usr/dlc/properties/webtools.ini
/usr/dlc/properties/wt_wsbroker1.ini
/usr/dlc/properties/wt_wsiso.ini
/usr/dlc/properties/wt_wssed10.ini

















Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

37


4 ANEXO 2 CONFIGURACIN DE HERRAMIENTAS DE AMBIENTE
4.1 APACHE v2.2 (WebServer) - Configuracin General de WebServer (messenger)
El Servidor Apache es un servidor Web de tecnologa Open Source slido y para uso comercial desarrollado por
la Apache Software Foundation.
Apache es un administrador de ambiente y para el caso especfico de ATENEA-DESA existen 2 archivos de
configuracin que contiene las directrices que afectan la operacin general del Servidor Apache como por ejemplo
el nmero de peticiones que puede manejar al mismo tiempo y las ubicaciones de varios archivos que usa, las
direcciones IP virtuales y Homologadas para cada aplicativo, el puerto que se va a utilizar para las tareas
WEB, etc. Estos archivos son httpd.conf y httpd-vhosts.conf
4.1.1 Archivo de configuracin para Interfaces y vinculacin de puertos httpd.conf
El archivo de configuracin de Apache est ubicado en /opt/www/apache2/conf

Para Apache v2.2 ya no existen las directrices BindAddress y Port; porque quedan recogidas en la directriz
listen.

En el archivo de configuracin de Apache v1.3 se tena configurado el Puerto 80 y en el archivo de la versin 2.0
se cambi por el parmetro listen 80.

A continuacin se muestran segmentos del archivo y se describen las lneas que se incluyeron en el archivo
httpd.conf para configurar correctamente el server ATENEA-DESA.



Listen 80 ESTA LINEA INDICA AL WEBSERVER EL PUERTO QUE ESTARA ACTIVO PARA LAS
TAREAS WEB



ServerRoot /opt/www/apache2 ESTA LINEA INDICA LA RUTA DONDE ESTA INSTALADO APACHE



DocumentRoot "/opt/www/apache2/htdocs" ESTA LINEA ESPECIFICA LA RUTA DEFAULT DE
DOCUMENTOS HTML





Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

38




ScriptAlias /cgi-bin/ " /opt/www/apache2/cgi-bin/" ESTA LINEA ESPECIFICA LA RUTA DEFAULT DE
ACRHIVOS .SH



Include conf/extra/httpd-vhosts.conf ESTA LINEA ESPECIFICA LA DIRECTIVA QUE HACE
REFERENCIA AL ARCHIVO DE CONFIGURACION DE IP VIRTUALES
Archivo de configuracin para administracin de recursos y aplicaciones: httpd-vhosts.conf
Este archivo de configuracin de Apache est ubicado en /opt/www/apache2/conf/extra

Dentro de este archivo httpd-vhosts.conf se incluye el mdulo para manejo de imgenes y las configuraciones
para el manejo de las mquinas virtuales y las IPs homologadas para cada uno de los aplicativos.

Configuracin del Enlace de Aplicativos con el WebServer (Apache v2.2)
A continuacin se describen las lneas del archivo httpd-vhosts.conf que son necesarias para configurar una
direccin virtual.

Ejemplo de para la configuracin de aplicativos dentro del archivo httpd-vhosts.conf
<VirtualHost 172.16.2.159> Inicia definicin del Host Virtual 172.16.2.159
DocumentRoot /opt/www/virtual/sed2005 Se refiere a la ruta absoluta del DocumentRoot
ServerName 200.77.231.118 Se refiere a la IP fsica del server (IP Publica)
ErrorLog "logs/sed2005-error_log" Se refiere a la ruta absoluta del archivo de logs del sistema
CustomLog "logs/sed2005-access_log" common Se refiere a la ruta absoluta del archivo
de logs del sistema y common se refiere a los
permisos de acceso para dicho archivo.
Alias /images /opt/www/virtual/sed2005/images Se refiere a la ruta absoluta de la carpeta de imgenes.
<Directory "/opt/www/virtual/sed2005/images"> Inicia la definicin de permisos para el directorio de
imgenes.
AllowOverride all Se refiere a los permisos otorgados a los archivos contenidos en el directorio
de imgenes
Options Indexes MultiViews Se refiere a los permisos otorgados a los archivos contenidos en el
Directorio de imgenes
</Directory> Termina la definicin de permisos para el directorio de imgenes.
<Directory /opt/www/virtual/sed2005> Inicia definicin de permisos para el directorio del sistema,
Options FollowSymLinks Includes ExecCGI Indica al sistema la ejecucin de libreras CGI
AllowOverride All Indica al sistema los permisos de lectura-escritura para los archivos dentro
del directorio del aplicativo
order allow,deny Indica al sistema los permisos de lectura-escritura para los archivos dentro
del directorio del aplicativo
allow from all Indica al sistema los permisos de lectura-escritura para los grupos de usuario
dentro del directorio del aplicativo
<Files ~"\.(w|p|i)$"> Inicia parmetro de ejecucin de apache TAG OBLIGATORIO
Order allow,deny Parmetro de ejecucin de apache TAG OBLIGATORIO
Deny from all Parmetro de ejecucin de apache TAG OBLIGATORIO
</Files> Termina parmetro de ejecucin de apache TAG OBLIGATORIO
</Directory> Termina la definicin de permisos para el directorio del sistema.
</VirtualHost> Termina definicin del host virtual.


Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

39


5 ANEXO 3 - COMO CONFIGURAR EL USO DE LIBRERAS DE PERL
PARA LA INTERFAZ DE WEBSPEED
Para que los archivos CGI que utilizan los aplicativos funcionen correctamente con la versin 2.2 de Apache es
necesario que la primera lnea de cada librera sea como sigue:

#!/usr/perl5/5.8.4/bin/perl

Todas las libreras CGI que utilizan los aplicativos estn ubicadas dentro de las carpetas de instalacin de cada
aplicativo, es fcil identificarlas ya que su extensin es CGI













































Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

40


6 ANEXO 4 CONFIGURACION DE INICIO PARA CADA APLICATIVO
(brokers de ej ecucin)
6.1 Configuracin General de WebSpeed Server (messenger).
Para configurar cualquier tipo de Broker WebServer a utilizar, se deber accesar la carpeta del instalador de
OpenEdge nombrada PROPERTIES (ubicada en /usr/dlc/properties) y seleccionar el archivo de texto llamado
Ubrokbroker.properties, ste archivo contiene las propiedades generales para configurar los diferentes tipos de
brokers.
6.2 Configuraciones que deben incluirse en el archivo ubroker.properties
Este archivo llamado ubroker.properties es una librera de configuracin y funciona para los servicios de
Progress y WebSpeed est ubicado en /usr/dlc/properties.
6.3 Ejemplo de la configuracin de un broker:

A continuacin se describen las lneas que se incluyeron en el archivo ubroker.properties para
configurar correctamente el server ATENEA-DESA

[UBroker.WS.wsiso] Nombre del broker, en este caso WS.wsiso
appserviceNameList=wsiso Nombre del servicio asignado a la base de datos, en este caso wsiso
brokerLogFile=/opt/www/virtual/iso9000/wsiso.broker.log Ruta absoluta donde se ubicar el log del
broker,,en este caso /opt/www/virtual/iso9000/wsiso.broker.log
controllingNameServer=NS1 Tipo de servicio Progress OBLIGATORIO
description=A sample WebSpeed Transaction Server Descripcin de servicio Progress OBLIGATORIO
environment=wsiso Nombre del ambiente creado por el broker, en este caso wsiso
groupName= asignacin de permisos de ejecucin VACIO para todos OBLIGATORIO
portNumber=2080 Nombre del puerto asignado al broker, en este caso 2080
srvrLogFile=/opt/www/virtual/iso9000/wsiso.server.log Ruta absoluta donde se ubicar el log del
servicio,,en este caso /opt/www/virtual/iso9000/wsiso.server.log
srvrStartupParam=-p web/objects/web-disp.p -weblogerror -db /opt/www/virtual/iso9000/db/iso9000 -H ATENEA-
DESA -S 2561 Parmetros de servicio para la base de datos donde:
-db se refiere a la ruta absoluta de la base de datos, en este caso
/opt/www/virtual/iso9000/db/iso9000
-H se refiere al host, en este caso ATENEA-DESA
S se refiere al puerto/servicio asignado a la base de datos, en este caso 2561
workDir=/opt/www/virtual/iso9000 Se refiere al directorio de trabajo, en este caso
/opt/www/virtual/iso9000
userName= asignacin de permisos de ejecucin VACIO para todos OBLIGATORIO
uuid=932.99.000.ZZZ:1ee77e:cf3bbe04fd:-8000 ID del broker
6.3.1 Consideraciones para la configuracin de brokers
PortNumber
Se refiere al puerto por defecto para un determinado protocolo o servicio y debe aplicarse manualmente de la
siguiente manera:
Dentro del archivo ubroker.properties se toma el valor PortNumber ms alto que est asignado y se le
suman 10, esto es: si se est definiendo un broker nuevo debe buscarse dentro del archivo
ubroker.properties el tag PortNumber que tenga definido el nmero ms alto, por ejemplo 250 y a este
valor se le suman 10 y al final ese resultado se debe asignar al nuevo PortNumber (260).





Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

41


Uuid
El UUID es un identificador de espacio-y-tiempo nico, designado por Progress para un servicio, sistema
aplicacin especfico. Debe cumplir con las normas internacionales Open Systems Foundation (OSF).
Para cada broker definido dentro del archivo ubroker.properties es necesario asignar un UUID, para lo cual se
ingresa a la carpeta /usr/bin y se ejecuta el comando gennuid.



Ejemplo de la creacin de un UUID
6.4 Parmetros vlidos para configurar el WebSpeed (Messenger)
Estos se utilizan para crear la relacin entre las aplicaciones y los servicios de Server WebSpeed y estn
especificados en el archivo /usr/bin/wspd_cgi.sh































Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

42


7 ANEXO 5 - CONSIDERACIONES: TAGGS UTILIZADOS PARA LA
CONFIGURACION DE APACHE EN LOS ARCHIVOS HTTPD.CONF Y
HTTPD-VHOSTS
7.1 <Directory>
Indica a Apache que los parmetros que se encuentran dentro de la seccin Directory slo se aplican al
directorio indicado despus de este tagg y sus subdirectorios.
7.2 <DirectoryMatch>
Funciona igual que Directory, aunque acepta expresiones regulares en el nombre del directorio.
7.3 <Files>
Indica los parmetros de configuracin que facilitan control de acceso a los ficheros mediante su nombre.
7.4 <FilesMatch>
Funciona igual que Files, pero acepta en el nombre del fichero expresiones regulares.
7.5 <Location>
Proporciona control de acceso a los ficheros mediante la URL.
7.6 <LocationMatch>
Igual que Location, pero acepta en el nombre del fichero el uso de expresiones regulares.
7.7 <VirtualHost>
Los parmetros slo se aplican a aquellas peticiones dirigidas a este host (nombre de servidor, direccin IP o
puerto TCP).
7.8 <Proxy>
Slo se aplican estos parmetros a aquellas peticiones de proxy (requiere que est instalado "mod proxy")
coincidentes con la especificacin de URL.
7.9 <ProxyMatch>
Igual que proxy, pero acepta en la URL indicada el uso de expresiones regulares.
7.10 <IfDefine>
slo se aplica si al arrancar el servidor existe un parmetro concreto definido en la lnea de comandos, mediante
la opcin -D.
7.11 <IfModule>
Se aplican los parmetros si el mdulo especificado se encuentra cargado (mediante LoadModule) en el
momento de arrancar el servidor.




Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

43


En caso de que exista conflicto entre diferentes especificaciones de parmetros, el orden de precedencia es:
<Directory> .htaccess
<DirectoryMatch> y <Directory>
<Files> y <FilesMatch>
<Location> y <LocationMatch>

En cuanto a <VirtualHost>, estas directivas siempre se aplican siempre despus de las directivas generales. De
este modo, un VirtualHost puede modificar la configuracin por defecto.

Un ejemplo de configuracin:
<Directory /home/*/public_html>
Options Indexes
</Directory>
<FilesMatch \.(?i:gif jpe?g png)$>
Order allow,deny
Deny from all
</FilesMatch>.
7.12 Directivas globales de configuracin
Algunas directivas de configuracin nunca se aplican a las secciones antes mencionadas (directorios, etc.), sino
que afectan al conjunto del servidor web. Las ms destacables son:
7.12.1 ServerRoot
Especifica la localizacin del directorio raz en el que se encuentra instalado el servidor web. Partiendo de este
directorio, se encuentran los ficheros de configuracin, etc. Si la instalacin del servidor es correcta, no debera
modificarse nunca.
7.12.2 KeepAlive
Especifica si se deben utilizar conexiones persistentes para atender las peticiones de un mismo usuario
mediante la misma conexin TCP.
7.12.3 Listen
Especifica el puerto en que se atendern las peticiones. Por defecto el servidor "escucha" en el puerto 80 de
TCP. Permite especificar las direcciones IP que se utilizarn (en caso de que el servidor tuviese ms de una).
Por defecto se utilizarn todas las disponibles.
7.12.4 LoadModule
Permite cargar en el servidor los mdulos adicionales de Apache. La sintaxis es:
LoadModule <modulo>fichero mdulo.
7.13 Directivas principales
Hay algunas directivas que, generalmente, no suelen aparecer en las secciones anteriormente mencionadas
(algunas de ellas no deben estar en ninguna seccin, y es obligatorio que aparezcan en la seccin principal),
sino que se encuentran en la seccin principal. Estas directivas son:
7.13.1 ServerAdmin
Especifica la direccin de correo electrnico del administrador. Esta direccin puede mostrarse en los mensajes
de error a modo de direccin de contacto para que los usuarios notifiquen el error al administrador. No debe
estar dentro de ninguna seccin.





Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

44


7.13.2 ServerName
Sirve para especificar el nombre y el puerto TCP que el Apache utiliza para identificarse. Se puede determinar de
forma automtica, pero se recomienda especificarlo. Si el servidor no tuviera un nombre DNS, es recomendable
incluir su direccin IP. No debe incluirse dentro de ninguna seccin.
Su sintaxis es: ServerName nombre de la direccin: puerto
ejemplos
ServerName www.uoc.edu:80
ServerName 192.168.1.1:80
7.13.3 DocumentRoot
Es el directorio raz desde el cual se servirn los documentos. Por defecto es "htdocs", dentro de la carpeta de
instalacin de Apache. No debe aparecer dentro de ninguna seccin, a excepcin de la seccin VirtualHost. Le
corresponde una seccin <Directory>en la cual se marcan los parmetros de configuracin de este directorio.
7.13.4 DirectoryIndex
Especifica el fichero que Apache servir por defecto para cada directorio en caso de que no se especifique
ningn fichero concreto en la URL de la peticin. Por defecto es "index.html". Es decir, si se solicita en la barra
de direcciones de navegador: www.cibernetia.com el servidor enviar por defecto.

www.cibernetia.com/index.html

Es posible especificar ms de un fichero y el orden con que se especifican los ficheros determinar la prioridad
para determinar cul se debe servir. Es posible encontrar la directiva fuera de cualquier seccin o dentro de
alguna de ellas.
7.13.5 AccessFileName
Determina el fichero de configuracin en caso de que ste no sea .htaccess. Para que esta configuracin cumpla
su cometido, la directiva AllowOverride debe tener un valor adecuado. No puede estar incluida en ninguna
seccin. El fichero por defecto es .htaccess.
7.13.6 ErrorDocument
Esta directiva establece el comportamiento de Apache en caso de error. Existen 4 configuraciones distintas:
1. Mostrar algn texto de error.
2. Redireccin hacia un fichero en el mismo directorio.
3. Redireccin hacia un fichero en nuestro servidor.
4. Redireccin hacia un fichero fuera de nuestro servidor.

La sintaxis es: ErrorDocument cdigo error accin.

Es posible encontrar esta directiva tanto dentro de una seccin, como en la configuracin global, por ejemplo:
ErrorDocument 404 /noencont.html.

En caso de que Apache no encuentre un fichero, se mostrar el fichero noencont.html.
7.13.7 Alias
Las directivas Alias y AliasMatch permiten la definicin de accesos a directorios que estn fuera del
DocumentRoot.
Su sintaxis es: Alias url directorio.

Por ejemplo:
Alias /docs/home/documentos har que una peticin a http://www.uoc.edu/docs/manual se sirva
desde/home/documentos/manual.





Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

45


7.13.8 UserDir
Permite indicar a Apache que un subdirectorio dentro del directorio de trabajo de los diferentes usuarios del
sistema sirva para que estos almacenen su pgina personal.
7.13.9 UserDir
Har que la pgina almacenada en el directorio del usuario "test", dentro del subdirectorio "pblico", sea
accesible como:

http://www.uoc.edu/test/indice.html
7.14 Directivas de seccin
Casi todas las secciones de localizacin (Directory, Location, etc.) incluyen una serie de directivas en su
configuracin que permiten controlar el acceso al contenido. El mdulo mod_access facilita estas directivas.
7.14.1 Allow
Permite especificar quin tiene autorizacin para acceder a un recurso. Se pueden especificar direcciones IP,
nombres de mquina, fragmentos del nombre o de la direccin o variables de la peticin. Existe la palabra clave
"all" que indica "todos los clientes".
7.14.2 Deny
Permite especificar a quin no permitimos el acceso a un recurso. Cuenta con las mismas opciones que Allow.
7.14.3 Order
Permite afinar el funcionamiento de las anteriores directivas: Allow y Deny. Existen 2 opciones:
7.14.4 Allow,deny
Por defecto se deniega el acceso y slo podrn acceder aquellos clientes que cumplan las especificaciones de
Allow y en cambio no cumplan las especificaciones de Deny.
7.14.5 Deny, Allow
Por defecto se permite el acceso y slo podrn entrar los clientes que no cumplan las especificaciones de Deny
o s cumplan las especificaciones de Allow.
7.15 Servidores virtuales
Apache permite servir varios sitios web con un nico servidor. Para ello permite la creacin de dominios virtuales
en funcin de diferentes direcciones IP o diferentes nombres por IP. Apache fue de los primeros servidores que
soport servidores virtuales sin necesidad de distinguir por IP, sino en funcin de nombre. Esta capacidad
simplifica enormemente la administracin de los servidores, y supone un ahorro de direcciones IP, que
normalmente son escasas. Los servidores virtuales que distinguen en funcin del nombre son perfectamente
transparentes para el cliente, con la posible excepcin de aquellos navegadores muy antiguos que no enven la
cabecera "Host:" con cada peticin.













Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

46


7.15.1 Servidores virtuales por direccin IP
Para atender a varios servidores virtuales, cada uno de ellos con una direccin IP diferente, se utiliza la seccin
de configuracin VirtualHost. Con esta seccin se define una configuracin y direccin IP para cada uno de los
servidores. Este punto se encuentra descrito en el capitulo 4.1.2.1 Configuracin del Enlace de Aplicativos con
el WebServer (Apache v2.2)
Un ejemplo sera el siguiente:

<VirtualHost 192.168.1.1> ServerAdmin webmaster@uoc.edu
DocumentRoot /web/uoc
ServerName www.uoc.edu
ErrorLog /web/logs/uoc_error_log
TransferLog /web/logs/uoc_access_log
</VirtualHost>
<VirtualHost 192.168.254.254>
ServerAdmin webmaster@asociados.uoc.edu
DocumentRoot /web/asociados
ServerName asociados.uoc.edu
ErrorLog /web/logs/asociados_error_log
TransferLog /web/logs/asociados_access_log
</VirtualHost>

En este ejemplo se definen 2 servidores web, cada uno de ellos con una IP y un nombre diferentes. Ambos
tienen su propio DocumentRoot, etc.

Para hacer uso de servidores virtuales por IP, se necesita que el sistema servidor tenga configuradas en su
sistema operativo las diferentes direcciones IP que debe servir (para mejor referencia ver capitulo 1.2.6 del
presente documento).
7.15.2 Servidores virtuales por nombre
Para atender a varios servidores, utilizando una misma direccin IP para todos ellos, se utiliza la seccin
VirtualHost, que permite definir los parmetros de cada uno de los servidores. Este punto se encuentra descrito
en el capitulo 4.1.2.1 Configuracin del Enlace de Aplicativos con el WebServer (Apache v2.2)
Sirva como ejemplo la siguiente configuracin:
Se pueden usar ejemplos con lo que se hizo en ATENEA-DESA
NameVirtualHost *:80
<VirtualHost *:80>
ServerAdmin webmaster@uoc.edu
ServerName www.uoc.edu
DocumentRoot /web/uoc
ErrorLog /web/logs/uoc_error_log
TransferLog /web/logs/uoc_access_log
</VirtualHost>
<VirtualHost *:80>
ServerAdmin webmaster@uoc.edu
ServerName asociados.uoc.edu
DocumentRoot /web/asociados
ErrorLog /web/logs/asociados_error_log
TransferLog /web/logs/asociados_access_log
</VirtualHost>.

Se puede utilizar una direccin IP concreta en lugar de *, lo cual permite asignar, por ejemplo, un grupo de
servidores virtuales por nombre a esta IP y otro grupo a otra IP. Este punto se encuentra descrito en el capitulo
4.1.2.1 Configuracin del Enlace de Aplicativos con el WebServer (Apache v2.2)




Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

47


Cuando nuestro servidor tiene 2 direcciones IP, pero hemos asignado a las 2 el mismo nombre, se necesita un
uso especial de las directivas de servidores por nombre. Por ejemplo, cuando se dispone una conexin de red en
la intranet y otra conexin diferente en Internet con el mismo nombre, caso en el cual podemos servir el mismo
contenido de la misma forma de a cuerdo al siguiente ejemplo:

NameVirtualHost 192.168.1.1
NameVirtualHost 172.40.30.40
<VirtualHost 192.168.1.1 172.40.30.40>
DocumentRoot /www/servidor1
ServerName servidor.uoc.edu
ServerAlias servidor
</VirtualHost>

Con esta configuracin se puede servir la misma web hacia la intranet y hacia la Internet. Es conveniente sealar
el uso de un alias para el servidor, lo cual permite no tener que usar dominios en la intranet. Disponemos de una
especificacin de servidor virtual por defecto "_default_" que permite atender las peticiones que no sirve ningn
otro servidor virtual.

<VirtualHost _default_>
DocumentRoot /www/defecto
</VirtualHost>

Podemos usar la etiqueta "_default_" indicando un nmero de puerto para especificar servidores por defecto que
sean diferentes para cada puerto. Apache permite tambin configuraciones ms complejas de servidores
virtuales, muy tiles en casos de, por ejemplo, servidores masivos. Una excelente gua de referencia se
encuentra en la web del proyecto Apache, con consejos tiles para configurar el servidor. Existen muchos
servidores HTTP de cdigo libre, pero la mayora de ellos han quedado eclipsados por Apache. Algunos de estos
servidores tienen caractersticas que les hacen especialmente interesantes.


























Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

48


8 ANEXO 6 - COMANDOS UTILIZADOS PARA MANTENIMIENTO DE
APACHE.
Este capitulo del presente documento explica como iniciar y parar el servidor Apache en sistemas tipo Unix. Para
parar y reiniciar Apache, hay que enviar la seal apropiada al proceso padre httpd que se est ejecutando. Hay
dos maneras de enviar estas seales. En primer lugar, puede usar el comando de Unix kill que enva seales
directamente a los procesos.
8.1 COMO PARAR APACHE DESDE UNIX
Para enviar una seal de trmino desde UNIX al proceso padre se debe ejecutar con el usuario ROOT y debe
escribir el comando como se muestra en el ejemplo siguiente:

Sintaxis: #kill -TERM cat /usr/local/apache2/logs/httpd.pid

La segunda manera de enviar seales a los procesos de Apache es usando las opciones de lnea de comandos:
stop, start
8.2 COMO PARAR APACHE DESDE LA CONSOLA APACHE
Sintaxis: #./apachectl stop



NOTA: El usuario debe posicionarse sobre la carpeta /opt/www/apache2/bin para poder ejecutar este
comando

Este comando enviar las seales TERM o stop al proceso padre hace que se intenten eliminar todos los
procesos hijo inmediatamente. Esto puede tardar algunos minutos y cualquier peticin en proceso terminar
inmediatamente, y ninguna peticin posterior realizada a Apache ser atendida a menos que se restablezca el
servicio.
8.3 COMO INICIAR APACHE DESDE LA CONSOLA APACHE
Sintaxis: #./apachectl restart

El envo de las seales HUP o start al proceso padre hace que los procesos hijo comiencen sus servicios como
se muestra en el siguiente ejemplo:



NOTA: El usuario debe posicionarse sobre la carpeta /opt/www/apache2/bin para poder ejecutar este
comando



Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

49


9 ANEXO 7 - COMANDOS UTILIZADOS PARA MANTENIMIENTO DE
BROKERS.
Este capitulo describe puntualmente como iniciar y detener los servicios necesarios para los brokers de
Progress.

Primeramente, el usuario que se utiliza debe contar con los permisos de ejecucin y privilegios de grupo
suficientes para poder iniciar y detener procesos desde la consola de sistema operativo.
9.1 Variables de ambiente de Progress
El inicializar las variables de ambiente permite al usuario invocar los comandos y utileras de Progress desde
cualquier carpeta donde se encuentre posicionado, adems de permitir que Progress mantenga la vigencia de
sus aplicaciones y servicios durante el tiempo que transcurre la operacin de los mismos.
9.1.1 Comando proenv
Se refiere a las variables de ejecucin de ambiente de Progress (Progress Environment) y se ejecuta desde la
carpeta /usr/dlc/bin tal como se muestra en la siguiente imagen:



Sintaxis: #proenv

NOTA: El usuario debe contar con los privilegios de ejecucin suficientes para invocar este comando
9.1.2 Comando proadsv
Se refiere a la utilera de progress necesaria para inicializar las variables de ambiente que se utilizaran para
servir los brokers, sin su utilizacin dentro del ambiente los brokers no funcionaran, por lo que se vuelve
indispensable su ejecucin.

Cuenta con dos parmetros bsicos: -start y -stop

Sintaxis:
1. #proadsv start
2. #proadsv stop





Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

50


Ejemplo de la ejecucin del comando proadsv utilizando el parmetro start



Ejemplo de la ejecucin del comando proadsv utilizando el parmetro stop



NOTA: Este comando (proadsv) puede ejecutarse desde cualquier carpeta donde se encuentre
posicionado el usuario siempre y cuando se haya invocado previamente el comando proenv.
9.1.3 Comando wtbman
Este comando se utiliza para levantar los servicios de los brokers de Progress y cuenta con tres parmetros
bsicos: -name start stop
-name Se refiere al nombre del broker que se manipular
-stop Detiene los servicios del broker
-start Inicializa los servicios del broker
Sintaxis:
1. #wtbman name ejemplo start
2. #wtbman name ejemplo stop
9.1.3.1 Consideraciones: Lista de Brokers para ATENEA-DESA
Estos brokers se encuentran definidos dentro del archivo ubroker.properties dentro de la carpeta
/usr/dlc/properties (ver capitulo 6 ANEXO 4 CONFIGURACION DE INICIO PARA CADA APLICATIVO
(brokers de ejecucin) para mejor referencia)

BROKER APLICATIVO
wssicex SICEX
wssicmo SICEXMON
wsiso ISO9000
wssicor SICORC
wsrnie RNIE
wsrepie REPIE
wssed5 SED2005
wssed6 SED2006
wssed7 SED2007
wssed8 SED2008
wssed9 SED2009
wssed10 SED2010
wssed11 SED2011


Memoria Tcnica Proyecto de Licenciamiento Progress
para La Secretara de Economa

51


9.1.4 Como Levantar un broker
Para levantar un broker se utiliza el comando wtbman utilizando el parmetro name seguido del nombre del
broker a levantar y despus de esto el parmetro start para indicar al sistema que la operacin que debe
realizar es levantar el servicio



NOTA: Este comando (wtbman) puede ejecutarse desde cualquier carpeta donde se encuentre
posicionado el usuario siempre y cuando se haya invocado previamente los siguientes comandos en
este orden especfico:
1. proenv
2. proadsv.
9.1.5 Como detener un broker
Para levantar un broker se utiliza el comando wtbman utilizando el parmetro name seguido del nombre del
broker a detener y despus de esto el parmetro stop para indicar al sistema que la operacin que debe
realizar es detener el servicio



NOTA: Este comando (wtbman) puede ejecutarse desde cualquier carpeta donde se encuentre
posicionado el usuario siempre y cuando se haya invocado previamente los siguientes comandos en
este orden especfico:
3. proenv
4. proadsv.

You might also like