Manual Instalacion Despliegue v4

E-Fcil
Documentoinstalacin
Avanza Local Soluciones
Plan Avanza Local Soluciones e-fcil Copyright 2011 inisterio !e "n!ustria# $uris%o y
Co%ercio&
La presente pu'licaci(n pertenece al Ministerio de Industria, Turismo y Comercio (Mityc) y est
'a)o una licencia *econoci%iento-+o co%ercial 2&, -spa.a !e Creative Co%%ons# y por ello esta
per%iti!o copiar# !istri'uir y co%unicar p/'lica%ente esta o'ra 'a)o las con!iciones siguientes0
*econoci%iento 0 -l conteni!o !e este infor%e se pue!e repro!ucir total o parcial%ente por
terceros# citan!o su proce!encia y hacien!o referencia e1presa tanto a ityc co%o a su sitio 2e'0
333&%ityc&es& 4icho reconoci%iento no po!r en ning/n caso sugerir 5ue ityc presta apoyo a !icho
tercero o apoya el uso 5ue hace !e su o'ra&
6so +o Co%ercial 0 -l %aterial original y los tra'a)os !eriva!os pue!en ser !istri'ui!os# copia!os
y e1hi'i!os %ientras su uso no tenga fines co%erciales&
Al reutilizar o !istri'uir la o'ra# tiene 5ue !e)ar 'ien claro los t7r%inos !e la licencia !e esta o'ra&
Alguna !e estas con!iciones pue!e no aplicarse si se o'tiene el per%iso !e ityc co%o titular !e
los !erechos !e autor& +a!a en esta licencia %enosca'a o restringe los !erechos %orales !e
ityc& http088creativeco%%ons&org8licenses8'y-nc82&,8es8
NDICE
Introduccin.......................................................................................................................................... 6
Conceptos generales.............................................................................................................................. 7
Componentes..................................................................................................................................... 7
Plataformas soportadas....................................................................................................................8
Mquinas virtuales........................................................................................................................... 9
OpenSuSE 11.3 -Tomcat 6.0.29 - PostgreSQL 8.4.........................................................................9
Usuaros !e "a #$..............................................................................................................9
%&oss................................................................................................................................... 9
Postgres ..............................................................................................................................9
Instalacin de infraestructura............................................................................................................11
Plataforma Windows......................................................................................................................11
Sstema operat'o.........................................................................................................................11
%a'a............................................................................................................................................... 11
PostgreSQL.................................................................................................................................. 14
(otas a!cona"es...................................................................................................................... 20
Orac"e........................................................................................................................................... 22
(otas a!cona"es...................................................................................................................... 24
)*2.............................................................................................................................................. 2+
SQL Ser'er................................................................................................................................... 33
Tomcat.......................................................................................................................................... 48
(otas a!cona"es...................................................................................................................... +2
%*oss............................................................................................................................................. +3
(otas a!cona"es...................................................................................................................... +,
-e&Sp.ere................................................................................................................................... +9
(otas a!cona"es...................................................................................................................... 62
/pac.e.......................................................................................................................................... ,+
Plataforma Linux............................................................................................................................79
Sstema operat'o.........................................................................................................................,9
%a'a............................................................................................................................................... 80
Manual InstalacionDespliegue Documento instalacin 3
PostgreSQL.................................................................................................................................. 80
(otas a!cona"es...................................................................................................................... 80
Orac"e........................................................................................................................................... 82
Tomcat.......................................................................................................................................... 82
%*oss............................................................................................................................................. 82
/pac.e.......................................................................................................................................... 83
Instalacin nueva de aplicaciones e-fcil...........................................................................................84
El prorama instalador..................................................................................................................8!
La carpeta 0!ep"o12!r3...............................................................................................................86
4reac5n !e "a carpeta 0!ep"o12!r3............................................................................................8,
6enerac5n !e "os !esp"ega&"es....................................................................................................89
Preparac5n !e" nsta"a!or.............................................................................................................90
"nstala#i$n de plataformas Linux..................................................................................................9%
6enerac5n.................................................................................................................................... 90
Se"ecc5n !e par7metros &7scos...............................................................................................91
#a"!ac5n !e prope!a!es !e "a nsta"ac5n.............................................................................93
)esp"egues.................................................................................................................................. 96
)esp"egue !e "a &ase !e !atos..................................................................................................96
)esp"egue !e "as ap"cacones..................................................................................................98
)esp"egue !e "a con8gurac5n !e /pac.e...............................................................................99
"nstala#i$n en Windows............................................................................................................... 1%&
6enerac5n.................................................................................................................................. 10+
Se"ecc5n !e par7metros &7scos.............................................................................................106
#a"!ac5n !e prope!a!es !e "a nsta"ac5n...........................................................................109
)esp"egues................................................................................................................................. 111
)esp"egue !e "a &ase !e !atos................................................................................................112
)esp"egue !e "as ap"cacones................................................................................................118
)esp"egue !e "a con8gurac5n !e /pac.e.............................................................................118
'otas adi#ionales a la "nstala#i$n de We()p*ere......................................................................1++
4on8gurac5n !e /pac.e...................................................................................................122
)e8nc5n !e "a 8uente !e !atos 9)ataSources:..................................................................12+
)esp"egue !e "as ap"cacones en e" ser'!or ;e&..............................................................130
Registro en el sistema de Recoleccin de Estadsticas de las aplicaciones !"#$ %EC&'................1(6
Confiura#i$n............................................................................................................................... 1,7
"ctuali)acin de la versin v.1.1 a v.1.*...........................................................................................1(+
Li(rer-as a#tuali.adas en esta versi$n.........................................................................................1,9
/r#*ivos a#tuali.ados en esta versi$n.........................................................................................1!1
Modelo de datos............................................................................................................................ 1!0
Wars a#tuali.ados en esta versi$n...............................................................................................1!0
"ctuali)acin de la versin v.1.* a v.1.(...........................................................................................147
/##eso a la #onsola de administra#i$n de 12MC/1.................................................................1!7
3ersiones de /P/C4E5 12MC/15 et#......................................................................................1!7
Proteiendo #oo6ies de sesi$n......................................................................................................1!7
"p,ndice 1 - #i-reras a descargar ..................................................................................................148
"p,ndice * - Relacin entre aplicaciones........................................................................................1.*
Introduccin
El presente documento constituye la gua de instalacin de las aplicaciones e-fcil en las
distintas plataformas soportadas.
En la distribucin se incluye una utilidad de instalacin, para la cual este documento tambin
hace las veces de manual de uso.
As mismo, se encuentra disponible una mquina virtual que puede servir de referencia
sobre la configuracin de uno de los entornos soportados. En este documento se
proporciona informacin sobre esta mquina virtual y la forma de usarla.
Conceptosgenerales
Componentes
El sistema e-fcil est compuesto por un conjunto de aplicaciones web. Los nombres de
contexto de las mismas son:
- portalinterno
- carpetaempresariov1
- admcomun
- admineFactura
- admtramites
- circeLicenciasWS
- circelocal
- CtkGF12WS
- EFacilConformacionWS
- eFacilDC
- EFacilERPServices
- EFacilJnlp
- eFactura
- genforms
- services
- sso
- tramitafacil
Las aplicaciones utilizan un nico esquema de base de datos, que denominaremos EFACIL.
Adems de los recursos web incluidos en los ficheros WARs de las aplicaciones, existen
dos bloques adicionales de recursos, servidos de forma esttica (es decir, por el servidor
http, no por el servidor de aplicaciones), que son los siguientes:
- efacilcss
- generated_forms
El acceso a las aplicaciones se realiza tanto por nombre de ususario y password como por
certificado electrnico personal. En ambos casos es necesario establecer conexiones https,
por lo cual tambin tendremos que tener en consideracin los elementos a configurar en el
servidor para soportar estas conexiones.
Plataformas soportadas
El sistema e-fcil est preparado para ser desplegado en plataformas con las siguientes
caractersticas:
- Sistemas operativos: Linux (chequeados OpenSuSE 11.3 y CentOS 5.5), Windows
(chequeado Windows Server 2003 Standard Edition).
- Bases de datos: PostgreSQL(chequeado PostgreSQL 8.4.4), SQL Server (chequeado
SQL Server Express 2008), Oracle (chequeado Oracle Express 10.2.0.1), DB2
(chequeado DB2 Express 9.7.2).
- Servidores de aplicaciones: JBoss (chequeado JBoss 5.1.0), Tomcat (chequeado
Tomcat 6.0.29), WebSphere(chequeado WAS Express 7.0).
- Servidores http: Apache(chequeado Apache 2.2.3 en CentOS, 2.2.15 en OpenSuSE
y 2.2.17 en Windows).
Este documento no se debe usar como manual de instalacin de estos componentes de
infraestructura (para ello se debe consultar la documentacin propia de los mismos), aunque
s se incluyen apartados especficos para cada uno de ellos, en los que se proporcionan
valores recomendados y se indican los parmetros de instalacin que afectan al despliegue
de las aplicaciones.
En las mquinas virtuales se incluyen los instaladores de las versiones usadas para
chequeo, que son las que estn instaladas en las propias mquinas virtuales, de todos estos
componentes de plataforma. En la mquina virtual disponible para descarga, las versiones
descargadas se incluyen nicamente como referencia; el usuario que vaya a utilizarlas en
otras instalaciones debera descargarlas por s mismo, ya que el propietario de los derechos
puede exigir un registro y/o la aceptacin de una serie de clusulas antes de permitir la
descarga. En las mquinas windows, los instaladores se encuentran en el directorio
c:\efacil.install. En las mquinas linux, en /root/efacil.install.
Mquinas virtuales
Se ha verificado la aplicacin utilizando un conjunto de mquinas virtuales que pueden servir
de prueba y demostracin para algunos de los entornos soportados. Los entornos testeados
son los siguientes:
- Centos 5.5, JBoss 5.1.0, Oracle Express 10.2
- OpenSuSE 11.3, Tomcat 6.0.29, PostgreSQL 8.4
- Windows Server 2003, JBoss 5.1.0, SQL Server Express 2008
- Windows Server 2003, WebSphere 7.0, DB2 Express 9.7.2
No todos estos entornos testeados estn disponibles para descarga por parte de los
usuarios. Se ha puesto a disposicin de los usuarios una mquina virtual con el siguiente
entorno instalado:
- OpenSuSE 11.3, Tomcat 6.0.29, PostgreSQL 8.4
Algunos datos importantes para el uso de la mquina virtual son los siguientes:
OpenSuSE11.3 -Tomcat6.0.29- PostgreSQL8.4
Usuariosde la VM
root / rootroot
Jboss
- /usr/local/apache-tomcat-6.0.29
Arranque/Parada: /etc/init.d/tomcat (start/stop)
Postgres
- Paquete de la propia distribucin
Usuario: postgres
Arranque/Parada: /etc/init.d/postgresql (start/stop)
Configuracin
EN LA MQUINA VIRTUAL
- Poner la maquina virtual por DHCP empleando yast2. Como root ejecutar yast2 ir a
Network Device/Network Setting y cambiar la configuracin de la tarjeta de red
- Editar el fichero /etc/hosts y poner una nueva linea de la siguiente forma
<IP DADA POR EL DHCP a la maquina virtual> vmefacil.fi2net.com
- Reiniciar el servidor
EN EL PC CLIENTE
- Editar el fichero c:\windows\system32\driver\etc\hosts del PC cliente para las pruebas y
poner una nueva linea de la siguiente forma
<IP DADA POR EL DHCP a la maquina virtual> vmefacil.fi2net.com
Para conocer la IP concedida por el servidor DHCP a la mquina virtual se puede ejecutar,
en una consola de sta, ifconfig a.
Instalacinde infraestructura
Este documento no se debe usar como manual de instalacin de los componentes de
plataforma (para ello se debe consultar la documentacin propia de los mismos), aunque en
los siguientes apartados se proporcionan guas bsicas de los pasos a dar, indicando
valores recomendados y los parmetros de instalacin que afectarn al despliegue de las
aplicaciones.
Plataforma Windows
Sistemaoperativo
Instalar el sistema operativo Windows de la forma habitual. Una vez instalado, se
recomienda acceder al sistema como administrador y utilizar Windows Update para
descargar e instalar las actualizaciones crticas y las opcionales, especialmente las
relacionadas con .Net Framework y con Windows Installer. Puede haber algunas de estas
actualizaciones que sean necesarias para instalar SQL Server, dependiendo de las
versiones de Windows y de SQL Server que se utilicen. Por ejemplo, para poder instalar
SQL Server 2008 sobre Windows Server 2003 es necesaria la ltima versin de ambos
paquetes. Por el modo de funcionamiento de Windows Update, ser necesario entrar varias
veces para descargar e instalar sucesivas actualizaciones.
Tanto la instalacin de las actualizaciones como la del resto de componentes de la
plataforma deberan hacerse como usuario administrador. En las mquinas virtuales de
referencia se han instalado las actualizaciones disponibles en la fecha de su creacin.
Tambin se recomienda crear un directorio donde se dejen almacenados, como referencia,
todos los programas y paquetes que se utilicen para la instalacin del entorno, detallados en
los apartados que siguen. En las mquinas virtuales de referencia se ha usado para esto el
directorio c:\efacil.install.
Java
El primer paso, tras disponer del sistema operativo, debera ser la instalacin del JDK de
Java. El JDK para Windows es distribuido de forma gratuita por Sun/Oracle, en forma de un
ejecutable instalador. En las mquinas virtuales se ha instalado el JDK 6u21 (jdk-6u21-
windows-i586.exe).
Para instalar Java hay que descargar y ejecutar el programa instalador (recomendamos
descargarlo en el directorio c:\efacil.install\java y ejecutarlo desde ah, dejndolo
almacenado para futuras referencias). Basta con seguir las instrucciones en pantalla. Se
recomienda usar las opciones por defecto. Al final, el instalador suele abrir un navegador
contra una pgina de registro que se puede omitir.
Es muy recomendable establecer la variable de entorno JAVA_HOME apuntando al path donde
se ha instalado Java. Tambin es recomendable aadir el subdirectorio bin de Java al PATH
de Windows. Esto es necesario para que los scripts que lanzan el instalador (ms cmodos
de usar que directamente el instalador) funcionen sin que tengan que ser editados. Para
actualizar estas variables de entorno hay que actuar como sigue:
Click en botn Inicio --> click derecho sobre Mi PC, click en Propiedades --> pestaa
Opciones avanzadas:
Botn Variables de entorno --> Botn Nueva de la seccin Variables del sistema --> teclear
JAVA_HOME como Nombre de variable y el path a la instalacin del JDK como Valor de variable:
Botn Aceptar --> Buscar en la lista de Variables del sistema la variable Path, seleccionarla
y pulsar el botn Modificar --> Aadir %JAVA_HOME%\bin; al principio del Valor de la variable (o
bien aadir ;%JAVA_HOME%\bin al final):
Botn Aceptar en las tres ventanas de dilogo, hasta cerrar Propiedades del sistema.
Se puede comprobar que la operacin se ha realizado correctamente abriendo una consola
(ventana ms-dos, ejecutando cmd.exe) y tecleando java -version:
C:\Documents and Settings\Administrador>java -version
java version "1.6.0_21"
Java(TM) SE Runtime Environment (build 1.6.0_21-b07)
Java HotSpot(TM) Client VM (build 17.0-b17, mixed mode, sharing)
PostgreSQL
Despus de Java, se recomienda instalar el servidor de base de datos que se vaya a usar.
PostgreSQL es distribuido para Windows en forma de un ejecutable instalador. En las
mquinas virtuales se ha instalado la versin 8.4.4 (postgresql-8.4.4-1-windows.exe).
Para instalar Postgre hay que descargar y ejecutar el programa instalador (recomendamos
descargarlo en el directorio c:\efacil.install\postgre y ejecutarlo desde ah, dejndolo
almacenado para futuras referencias). En general, basta con seguir las instrucciones en
pantalla.
Se elige el lugar de instalacin y el directorio de almacenamiento de datos. Salvo que se
desee otra cosa, los directorios por defecto son vlidos. A continuacin pide la contrasea
para la cuenta de usuario de Windows con la que va a correr el servicio. En las mquinas
virtuales se ha utilizado como password el propio nombre de la cuenta: postgres.
A continuacin pide el nmero de puerto en el que va a escuchar el servidor. Salvo
circunstancias especiales, dejar el por defecto: 5432.
En configuracin regional, seleccionamos Spanish, Spain.
Se realiza la instalacin.
En la ventana final, desmarcar la opcin de Stack Builder antes de pulsar Terminar.
Es muy recomendable establecer la variable de entorno PSQL_HOME apuntando al path donde
se ha instalado PostgreSQL. Tambin es recomendable aadir el subdirectorio bin al PATH de
Windows. Esto es necesario para que los scripts que lanzan el instalador no tengan que ser
editados. El procedimiento es idntico al caso de Java:
Click en botn Inicio --> click derecho sobre Mi PC, click en Propiedades --> pestaa
Opciones avanzadas:
Botn Variables de entorno --> Botn Nueva de la seccin Variables del sistema --> teclear
PSQL_HOME como Nombre de variable y el path a la instalacin de PostgreSQL como Valor de
variable:
Botn Aceptar --> Buscar en la lista de Variables del sistema la variable Path, seleccionarla
y pulsar el botn Modificar --> Aadir %PSQL_HOME%\bin; al principio del Valor de la variable (o
bien aadir ;%PSQL_HOME%\bin al final):
Botn Aceptar en las tres ventanas de dilogo, hasta cerrar Propiedades del sistema.
Se puede comprobar que la operacin se ha realizado correctamente abriendo una consola
(ventana ms-dos, ejecutando cmd.exe) y tecleando psql --version:
C:\Documents and Settings\Administrador> psql --version
psql (PostgreSQL) 8.4.4
Opcionalmente, se puede instalar a continuacin la utilidad pgAdmin III, que incluye una
serie de herramientas de usuario para el manejo de la base de datos.
Tras completar la instalacin, se puede comprobar que PostgreSQL aparece como un nuevo
servicio de Windows.
Notasadicionales
Los directorios importantes usados por PostgreSQL tras la instalacin por defecto son:
- Directorio de PostgreSQL: c:\Archivos de programa\PostgreSQL\8.4
- Directorio de datos: c:\Archivos de programa\PostgreSQL\8.4\data
Con la instalacin por defecto se tiene acceso al gestor de bbdd solamente de forma local
(adecuado para el caso en que las aplicaciones y el gestor de bbdd van a correr en la misma
mquina). Para tener acceso remoto a la base de datos, si ello fuera necesario, habra que
realizar dos operaciones:
- Si la mquina est usando un firewall, como el propio firewall de Windows, ser
necesario abrir el puerto de escucha del gestor (por defecto el 5432) para permitir el
acceso desde las mquinas que se determine, en concreto desde la que vayan a correr
las aplicaciones.
- Habr que editar el fichero pg_hba.conf, en el directorio de datos de Postgre, y aadir
una entrada que permita la conexin desde el rango de direcciones deseado. En el
propio fichero aparecen ejemplos para ello. La lnea que define la entrada de
configuracin habilitando el acceso remoto ser similar a sta:
Host all all 192.168.48.0/24 md5
En ella se debern especificar los valores adecuados al entorno de sistemas en el
que se est realizando la instalacin. El ejemplo mostrado habilita el acceso tipo host
(remoto via tcp/ip), a cualquier database, por parte de cualquier usuario, desde el
rango de direcciones definido por la subred 192.168.48.0/24, y con el mtodo de
acceso md5.
Alternativamente, esta configuracin se puede realizar desde la utilidad PgAdmin,
corriendo en local (en el propio servidor de base de datos, ya que todava no se ha
habilitado acceso remoto), en el men Herramientas -> Configuracin del servidor ->
pg_hba.conf.
El acceso remoto permite, por ejemplo, desplegar el esquema de datos de e-fcil en remoto,
desde un puesto de trabajo. Para ejecutar los scripts SQL en remoto, desde un puesto
Windows, hay que tener instalado en ese puesto al menos el PgAdmin (no es necesario
instalar el servidor Postgre), y poner su home en el PATH, para que se pueda localizar el
comando psql.
El comando psql es el intrprete de comandos de PostgreSQL, utilizado por los scripts de
despliegue del esquema de datos de e-fcil. A diferencia de los intrpretes de otras bases
de datos, psql no admite el paso del parmetro password en su invocacin. El mecanismo
recomendado en los puestos de administracin de la base de datos, y en las mquinas que
deban ejecutar scripts automticos, es almacenar las passwords con la proteccin propia de
la cuenta del sistema operativo, en un fichero denominado pgpass.conf. En Windows, este
fichero se localiza en %APPDATA%/postgresql/pgpass.conf. Si no se desea este procedimiento,
entonces es necesario ejecutar los scripts manualmente y teclear la password cuando el
intrprete la requiere.
El script de despliegue del esquema de datos e-fcil, deploy_database, que es generado por el
instalador de aplicaciones e-fcil, funciona automticamente gracias a que almacena la
password de conexin en una entrada del fichero pgpass.conf, antes de invocar el
intrprete. El script instalador deploy_database hace un backup de este fichero pgpass.conf
antes de almacenar nada en l, y lo restaura cuando completa los scripts SQL y DDL, de
forma que en circunstancias normales no quedan cacheadas las passwords en el puesto
desde el que se realiza el despliegue. Dado que puede haber fallos de todo tipo en un
puesto de trabajo normal, y que el comando de deploy puede cancelarse prematuramente
de forma voluntaria, es recomendable vigilar el contenido de dicho fichero si queremos estar
seguros de que no quedan rastros de las passwords en ese puesto. Si no se desea que bajo
ningn concepto exista ese riesgo, entonces se recomienda usar el instalador para generar
los scripts SQL y DDL y a continuacin usar directamente psql o pgAdmin para lanzarlos
manualmente sobre el gestor de bbdd.
Otro aspecto al que prestar atencin es el encoding usado por la base de datos, para que los
caracteres extendidos como acentos o letras sean almacenados correctamente. En
Windows, Postgre deja fijado el encoding a UTF-8. El instalador de aplicaciones e-fcil tiene
en cuenta este hecho, generando los scripts de carga de datos iniciales en ese encoding. Se
recomienda no editar manualmente dichos scripts SQL, porque muchos editores, incluido el
bloc de notas de Windows, introducen caracteres de control cuando graban ficheros
codificados en UTF-8, y esos caracteres pueden hacer fallar los scripts.
Oracle
Oracle Express, u Oracle XE, se distribuye para Windows como un ejecutable instalador. En
las mquinas virtuales se ha instalado la versin 10.2.0.1 (OracleXEUniv.exe).
Para instalar Oracle hay que descargar y ejecutar el programa instalador (recomendamos
descargarlo en el directorio c:\efacil.install\oracle y ejecutarlo desde ah, dejndolo
pantalla.
En la pantalla siguiente, elegimos la contrasea para la cuenta SYSTEM (esa misma
contrasea se usar para la cuenta SYS). En las mquinas virtuales se ha usado la password
oracle.
En la pantalla de resumen vemos los valores configurados. Es de inters el puerto del
Listener (1521), ya que habr que usarlo en la configuracin de las aplicaciones.
Al pulsar Instalar comienza la instalacin.
Antes de pulsar Terminar, desmarcar la opcin de Iniciar la pgina inicial ...
Notasadicionales
- Oracle XE no permite gran configuracin. Podemos elegir el directorio de instalacin,
pero el por defecto (c:/oraclexe) es tan bueno como cualquier otro, salvo que queramos
una instalacin ms profesional, en cuyo caso el producto adecuado no sera la versin
XE. El directorio de instalacin es importante porque lo usaremos para crear el
tablespace (el espacio de almacenamiento) del usuario eFcil.
- Oracle XE levanta un servidor en el puerto 8080. En Windows no se puede cambiar
desde el instalador, aunque se puede parar el servicio. Esto es problemtico porque es
el puerto por defecto de los servidores de aplicaciones Java.
DB2
DB2 Express se distribuye para Windows como un ejecutable autoextrable que primero se
descomprime y a continuacin se ejecuta. En las mquinas virtuales se ha instalado la
versin 9.7.2 (db2exc_972_WIN_x86.exe).
Para instalar DB2 hay que descargar y ejecutar el programa autoextrable (recomendamos
descargarlo en el directorio c:\efacil.install\db2 y ejecutarlo desde ah, dejndolo
pantalla.
Pulsar en Instalar un producto y a continuacin en el botn Instalar nuevo:
Escogemos instalacin Tpica, y continuacin elegimos que nos guarde el fichero de
respuestas en el lugar propuesto (el fichero de respuestas contiene informacin de los
valores elegidos que puede ser til posteriormente):
Como lugar de instalacin podemos dejar el por defecto:
Elegimos cuenta y password para el servidor de administracin. En las mquinas virtuales
se ha escogido db2admin / db2admin:
Al configurar la instancia, vamos a dejar los valores por defecto, pero es interesante pulsar
en Configurar para ver dichos valores:
Por ltimo pulsamos Finalizar y comienza la instalacin:
Al terminar se abre la ventana de DB2 Primeros pasos, que podemos cerrar sin ms.
A continuacin, de forma opcional, se puede instalar la utilidad Data Studio, que incluye
herramientas para facilitar la administracin y el manejo de la base de datos (ejecutar
Install.exe en el subdirectorio nt32).
SQLServer
SQL Server Express se distribuye para Windows como un ejecutable autoextrable que
primero se descomprime y a continuacin se ejecuta. En las mquinas virtuales se ha
instalado la versin SQL Server 2008 de 32 bits (SQLEXPR32_x86_ESN.exe).
Para instalar SQL Server hay que descargar y ejecutar el programa autoextrable
(recomendamos descargarlo en el directorio c:\efacil.install\sqlserver y ejecutarlo desde
ah, dejndolo almacenado para futuras referencias). En general, basta con seguir las
instrucciones en pantalla.
Existe un primer requisito que es posible que no cumpla nuestro servidor, y es la
disponibilidad de Windows Installer 4.5. Si no lo tenemos instalado, al ejecutar el ejecutable
autoextrable obtenemos el siguiente error:
Windows Installer 4.5 se puede descargar del site de Microsoft:
En las mquinas virtuales que tienen SQL Server instalado, el paquete descargable se ha
dejado en el directorio c:\efacil.install\sqlserver.
Una vez instalada la versin 4.5 de Windows Installer, volvemos a lanzar el ejecutable
autoextrable, esta vez sin errores:
Se pulsa en Instalacin, en el panel izquierdo, y a continuacin en Nueva instalacin
independiente de SQL Server o agregar caractersticas a una instalacin existente:
Tras comprobar que se cumplen los requisitos, el instalador presenta la clave de producto,
que en el caso de la versin Express es fija y no permite edicin:
Tras aceptar la licencia y sus trminos, pulsamos Instalacin, y se vuelve a realizar un
chequeo:
Observamos una advertencia con el Firewall de Windows. Si pulsamos en ella, vemos que
se refiere a la apertura del puerto en el que escuchar SQL Server: si no abrimos el puerto,
no se podr conectar en remoto al motor. Esta advertencia aplica no solo a SQL Server sino
a todos los servidores de BBDD. Como en nuestro caso vamos a acceder desde la propia
mquina, no es necesaria ninguna actuacin.
En la seleccin de caractersticas a instalar, seleccionamos todo:
Y en la siguiente pantalla aceptamos el nombre y el directorio por defecto:
Tras comprobar el espacio disponible en disco, nos va a pedir la cuenta de usuario bajo la
que correr el servidor de BBDD:
Siguiendo las recomendaciones, creamos un usuario local (si es que no lo tenemos ya), de
nombre efacil, y con password efacil, y lo seleccionamos para ejecutar SQL Server:
Como administradores del motor de base de datos seleccionamos el usuario actual
(Administrador), as como el propio usuario efacil:
No enviamos informes de error ni datos de uso:
Se vuelven a comprobar las reglas de instalacin, y a continuacin se presenta el resumen
de la configuracin que se va a usar. Se puede guardar una copia del fichero de resumen
para futura referencia, si se considera necesario.
Finalmente se procede a la instalacin:
A continuacin, de forma opcional, podemos instalar SQL Management Studio, que
proporciona herramientas tiles para la administracin de la base de datos. El instalador se
encuentra en c:\efacil.install\sqlserver\SQLManagementStudio_x86_ESN.exe:
Debemos elegir la misma opcin que para la instalacin del motor, es decir, Nueva
instalacin independiente de SQL Server o agregar caractersticas a una instalacin
existente:
La instalacin sigue pasos muy parecidos al caso del motor:
En el tipo de instalacin, contrariamente a lo que parecera lgico, hay que elegir Realizar
una nueva instalacin de SQL Server 2008:
En la seleccin de caractersticas, marcamos Herramientas de administracin Bsica:
Tras comprobar el espacio en disco y presentar el resumen de datos, se procede con la
instalacin:
Tomcat
Despus de la base de datos, es el momento del servidor de aplicaciones. Tomcat es
distribuido para Windows en forma de un ejecutable instalador. En las mquinas virtuales se
ha instalado la versin 6.0.29 (apache-tomcat-6.0.29.exe).
Para instalar Tomcat hay que descargar y ejecutar el programa instalador (recomendamos
descargarlo en el directorio c:\efacil.install\tomcat y ejecutarlo desde ah, dejndolo
pantalla.
Normalmente, desearemos que Tomcat se instale como servicio de Windows, as que en la
segunda pantalla marcamos el componente Service (por defecto est desmarcado):
Es muy recomendable que el directorio en el que se instale Tomcat (la TOMCAT_HOME) tenga un
nombre sin espacios en blanco, como c:\tomcat. Para conseguir esto, en la pgina siguiente
pulsamos Browse , creamos el directorio y lo seleccionamos:
Si al pulsar Aceptar y volver a la pantalla anterior, vemos que el directorio seleccionado no
es c:\tomcat, sino algo similar a c:\tomcat\Tomcat 6.0, lo editamos para dejarlo al valor
correcto:
En la siguiente pantalla podemos elegir un usuario de administracin de Tomcat (este es un
usuario para el Manager de Tomcat, no un usuario de Windows), esto es opcional. En las
mquinas virtuales se ha configurado usuario tomcat y password tomcat:
Como mquina virtual Java debera detectar la que instalamos anteriormente:
Al pulsar Install, se realiza la instalacin.
Una vez concluida la instalacin, podemos observar que tenemos un nuevo servicio, y que
en la barra de estado aparece un icono que nos permite arrancar y parar Tomcat.
Es muy aconsejable dejar el servicio parado hasta que se haya terminado la instalacin de
las aplicaciones.
Notasadicionales
Para que Tomcat soporte todas las aplicaciones activas, es necesario configurar el arranque
de la mquina virtual Java con la suficiente capacidad de memoria. Se recomienda
proporcionar un mnimo de 1.5GB, a ser posible 2GB.
JBoss
JBoss es distribuido para Windows en forma de un archivo empaquetado ZIP, sin instalador.
En las mquinas virtuales se ha utilizado la versin 5.1.0.GA (jboss-5.1.0.GA.zip).
Para instalar JBoss hay que descargar y descomprimir el archivo ZIP (recomendamos
descargarlo en el directorio c:\efacil.install\jboss y descomprimirlo desde ah, dejndolo
almacenado para futuras referencias).
As pues, abrimos un explorador de archivos de Windows, navegamos al directorio
c:\efacil.install\jboss, y hacemos doble click en el archivo ZIP. Windows abre una nueva
ventana con el contenido del ZIP. En ella usamos la opcin Extraer todo del men
Archivo:
Seleccionamos como destino el raz de C:, para que as el directorio en el que queda
instalado JBoss sea C:\jboss.5.1.0.GA:
Para instalar JBoss como servicio de Windows hay que abrir una ventana de comandos,
moverse hasta el directorio de instalacin de JBoss (la JBOSS_HOME, C:\jboss.5.1.0.GA), entrar
en el subdirectorio bin, y ejecutar service install.
Accediendo a Servicios, a travs del Panel de Control, se puede comprobar que JBoss
Application Server aparece como un nuevo servicio:
Haciendo doble click se accede a la configuracin del servicio. Es muy aconsejable dejar el
servicio con Tipo de inicio a Manual, y Estado del servicio a Detenido, hasta que se haya
terminado la instalacin de las aplicaciones.
Una vez que se haya completado la instalacin y configuracin de las aplicaciones y de sus
fuentes de datos, el servicio podr configurarse para arranque automtico en ese mismo
dilogo de control:
Notasadicionales
Para que JBoss soporte todas las aplicaciones activas, es necesario configurar el arranque
de la mquina virtual Java con la suficiente capacidad de memoria. Se recomienda
proporcionar un mnimo de 1.5GB, a ser posible 2GB.
Para configurar el arranque de JBoss, estando el servicio detenido, se edita el fichero
run.conf, en el subdirectorio bin de la instalacin de JBoss:
Este paso es conveniente seguirlo despus de haber ejecutado el programa instalador de
aplicaciones e-fcil, porque as dispondremos de un fichero run.conf de ejemplo en la
carpeta jboss del directorio de despliegue deploy.dir (ver apartado de Instalacin de
aplicaciones e-fcil).
El valor a configurar en run.conf es el de JAVA_OPTS. Se recomienda comentar la lnea original
de JAVA_OPTS, antes de introducir una nueva:
JAVA_OPTS="-server -Xms1480m -Xmx1480m -XX:MaxPermSize=1480m -XX:+UseParNewGC
-Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.server.gcInterval=3600000"
Otro posible valor a configurar es el de JAVA_HOME. Esto solamente ser necesario si no se ha
establecido el valor como variable de entorno durante la instalacin de Java.
WebSphere
WebSphere es distribuido para Windows en forma de un archivo empaquetado ZIP, que hay
que descomprimir manualmente antes de usar el ejecutable instalador contenido en l. En
las mquinas virtuales se ha instalado la versin 7.0, usando el archivo descargable
was.cd.7009.trial.base.opt.windows.ia32.zip, cuyo contenido se ha dejado ya descomprimido
en c:\efacil.install\was.
Navegamos al directorio c:\efacil.install\was\was.cd.7009.trial.base.opt.windows.ia32 donde
hemos descomprimido el ZIP, y ejecutamos launchpad.exe.
Al pulsar en Iniciar el asistente de instalacin de WebSphere Application Server Trial, nos
aparece la seleccin del directorio de instalacin. Es muy recomendable usar un path que
tengamos identificado y cuyo nombre no contenga espacios. Elegimos c:\was:
A continuacin seleccionamos el entorno Servidor de aplicaciones:
E introducimos un usuario para las herramientas administrativas. En las mquinas virtuales
se ha elegido usuario was, password was:
Despus se presenta un resumen y comienza la instalacin:
Durante la instalacin puede aparecer uno o ms mensajes de seguridad de Windows,
alertando sobre la ejecucin de un programa que intenta escuchar como servidor en un
puerto local. Pulsar Desbloquear si surgen estos avisos:
Desmarcar el inicio de la consola de primeros pasos, o cerrarla si llega a abrirse.
Notasadicionales
1. Instalacin del proveedor de JDBC
En primer lugar definimos la variable con el directorio donde se almacenar el
archivo .jar con el driver del proveedor (por ejemplo postgresql-8.3-603.jdbc3.jar).
Esta variable se define en Entorno > Variables de Websphere.
Al final esta variable se guardar en el siguiente fichero:
${WAS_HOME}\profiles\${PROFILE}\config\cells\${CELL}\nodes\${NODE}\variables.xml
Para la variable anterior habra que aadir la siguiente entrada:
<entries
xmi:id="VariableSubstitutionEntry_1289560993314"
symbolicName="POSTGRESQL_JDBC_DRIVER_PATH"
value="${DRIVER_PATH}/postgresql/lib"
description="Ruta al directorio con el driver de postgresql"/>
A continuacin hay que definir el proveedor de JDBC en Recursos > JDBC >
Proveedores de JDBC
El proveedor al final se define en el siguiente fichero de configuracin:
${WAS_HOME}\profiles\${PROFILE}\config\cells\${CELL}\nodes\${NODE}\servers\$
{SERVER}\resources.xml
Para el proveedor anterior habra que definir la siguiente entrada:
<resources.jdbc:JDBCProvider
xmi:id="JDBCProvider_1289561155978"
name="PostgreSQL JDBC Provider"
description="PostgreSQL JDBC2.0-compliant Provider configuration."
providerType="User-defined JDBC Provider"
isolatedClassLoader="false"
implementationClassName="org.postgresql.ds.PGConnectionPoolDataSource"
xa="false">
<classpath>
${POSTGRESQL_JDBC_DRIVER_PATH}/postgresql-8.3-603.jdbc3.jar
</classpath>
<factories
xmi:type="resources.jdbc:DataSource"
xmi:id="DataSource_1289562466352"
name="EFacilDatasource2"
jndiName="jdbc/EFacilDatasource2"
description="New JDBC Datasource"
providerType="User-defined JDBC Provider"
authMechanismPreference="BASIC_PASSWORD"
authDataAlias=""
manageCachedHandles="false"
logMissingTransactionContext="true"
diagnoseConnectionUsage="false"
relationalResourceAdapter="builtin_rra"
statementCacheSize="10"
datasourceHelperClassname="com.ibm.websphere.rsadapter.GenericDataStoreHelper">
<propertySet xmi:id="J2EEResourcePropertySet_1289562466392">
. <resourceProperties
xmi:id="J2EEResourceProperty_1289563185506"
name="serverName"
type="java.lang.String"
value="192.168.3.20" required="false"/>
<resourceProperties
name="portNumber"
type="java.lang.Integer"
value="5432"
required="false"/>
<resourceProperties
name="user"
value="postgres"
required="false"/>
<resourceProperties
name="password"
value="{xor}LDAsLzM6LA=="
required="false"/>
<resourceProperties
name="databaseName"
value="EFACILV1"
required="false"/>
</propertySet>
<connectionPool
xmi:id="ConnectionPool_1289562466392"
connectionTimeout="180"
maxConnections="10"
minConnections="1"
reapTime="180"
unusedTimeout="1800"
agedTimeout="0"
purgePolicy="EntirePool"
numberOfSharedPoolPartitions="0"
numberOfUnsharedPoolPartitions="0"
numberOfFreePoolPartitions="0"
freePoolDistributionTableSize="0"
surgeThreshold="-1"
surgeCreationInterval="0"
testConnection="false"
testConnectionInterval="0"
stuckTimerTime="0"
stuckTime="0"
stuckThreshold="0"/>
</factories>
</resources.jdbc:JDBCProvider>
2. JAAS
Para la configuracin de Java Authentication and Authorization es necesario ir a
Seguridad > Seguridad global:
Y dentro de esta JAAS (Java Authentication and Authorization Service) > Inicios de
sesin de la aplicacin:
Dentro de esta habra que definir el siguiente mdulo:
Estos datos se almacenarn en el fichero
${WAS_HOME}\profiles\${PROFILE}\config\cells\${CELL}\nodes\${NODE}\variables.xml
con los siguientes datos:
<entries
xmi:id="JAASConfigurationEntry_1290068007617"
alias="CirceCasLoginModule">
<loginModules
xmi:id="JAASLoginModule_1290068034836"
moduleClassName="com.fi2net.efacil.circe.login.spi.CirceCasLoginModule"
authenticationStrategy="REQUIRED">
<options
xmi:id="Property_1290068043458"
name="com.fi2net.security.auth.spi.CALLBACK"
value="com.fi2net.efacil.circe.login.spi.CirceCasCallback"/>
</loginModules>
</entries>
3. JVM
Las propiedades de arranque de la mquina de virtual se definen en Servidores > Tipos
de servidor > Servidores de aplicaciones de WebSphere:
Una vez seleccionado el servidor del que configurar sus variables de la JVM es
necesario ir al apartado Infraestructura del servidor > Java y gestin de procesos >
Definicin de proceso:
Y dentro de la definicin de proceso Propiedades adicionales > Mquina virtual Java:
Dentro de Argumentos de JVM genricos habra que definir dos variables:
- ctk.appconfdir: Directorio donde se almacenarn los ficheros de configuracin de
CTK.
${WAS_HOME}\profiles\${PROFILE}\config
- ctk.applogdir: Directorio donde se almacenarn los ficheros de log de CTK.
${WAS_HOME}\profiles\${PROFILE}\logs
Todo esto se almacenar en el siguiente fichero:
${WAS_HOME}\profiles\${PROFILE}\config\cells\${CELL}\nodes\${NODE}\servers\$
{SERVER}\server.xml
En el ejemplo se han utilizado los siguientes valores:
<jvmEntries
xmi:id="JavaVirtualMachine_1183122130078" verboseModeClass="false"
verboseModeGarbageCollection="false"
verboseModeJNI="false"
runHProf="false"
hprofArguments=""
debugMode="true"
debugArgs="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=7777"
genericJvmArguments=
"-Dctk.appconfdir=C:\was\was.cd.70011.trial.base.opt.windows.ia32\profiles\AppSrv01\config
-Dctk.applogdir=C:\was\was.cd.70011.trial.base.opt.windows.ia32\profiles\AppSrv01\logs"
executableJarFileName=""
disableJIT="false">
<systemProperties
xmi:id="Property_1"
name="com.ibm.security.jgss.debug"
value="off"
required="false"/>
<systemProperties
xmi:id="Property_2"
name="com.ibm.security.krb5.Krb5Debug"
value="off"
required="false"/>
</jvmEntries>
4. Endorsed
Las libreras globales para todas las aplicaciones que tienen que ir al endorsed es
necesario depositarlas en la carpeta:
${WAS_HOME}\java\jre\lib\endorsed
5. IntegracinconApache
Para la integracin con Apache, el servidor Websphere no utiliza ni AJP ni mod_jk sino
que tiene su propio plugin personalizado que hay que instalar previamente. En el
ejemplo el fichero descargado con el plugin es el siguiente:
trial_plugins_7000_windows.ia32.zip
El proceso de instalacin es el siguiente:
Aceptar el acuerdo de licencia:
Seleccin del plugin de Apache HTTP Server 2.2:
Seleccin de la configuracin del entorno:
I. Remota: Servidor Apache y Websphere en mquinas distintas.
II. Local: Servidor Apache y Websphere en la misma mquina.
Directorio de instalacin del plugin:
Seleccin del directorio de instalacin de Websphere:
Seleccin de la localizacin del fichero de configuracin del apache y el puerto HTTP
asociado.
De todos los cambios que realiza el instalador la parte interesante es la siguiente:
${PLUGIN_HOME}\config\${WAS_SERVER}. Es el directorio que contiene la configuracin del
servidor web.
plugin-cfg.xml: Contiene la configuracin de la instancia (puertos de escucha de
Websphere, aplicaciones desplegadas, ).
httpd.conf: Se actualiza con el nuevo mdulo de Apache que es capaz de leer el fichero
xml anterior:
LoadModule was_ap22_module
"C:\Archivos de programa\IBM\WebSphere\Plugins\bin\mod_was_ap22_http.dll"
WebSpherePluginConfig
"C:\Archivos de programa\IBM\WebSphere\Plugins\config\was7\plugin-cfg.xml"
Los valores del fichero de configuracin XML se pueden actualizar automticamente
mediante Websphere cuando se instalen nuevas aplicaciones en Entorno > Actualizar
configuracin global de plug-in de servidor Web.
Apache
Apache es distribuido para Windows en forma de un paquete de instalacin. En las
mquinas virtuales se ha instalado la versin 2.2.17 (httpd-2.2.17-win32-x86-openssl-
0.9.8o.msi).
Para instalar Apache hay que descargar y ejecutar el instalador (recomendamos descargarlo
en el directorio c:\efacil.install\apache y ejecutarlo desde ah, dejndolo almacenado para
futuras referencias). En general, basta con seguir las instrucciones en pantalla.
En la segunda ventana, el instalador solicita el nombre del dominio y el nombre pblico del
servidor web, junto con la cuenta de correo del administrador. En las mquinas virtuales se
ha utilizado vmefacil.fi2net.com como nombre del servidor. Estos valores se almacenan en
uno de los ficheros de configuracin de apache, que puede ser editado manualmente si es
necesario cambiarlo tras la instalacin.
Se recomienda que Apache sea instalado en un directorio cuyo nombre no contenga
espacios, como c:\apache. Para hacerlo, en la siguiente pantalla hay que elegir instalacin
Custom, y a continuacin elegir la opcin Change
Nos aparece una pantalla para introducir el path de destino c:\apache:
Al pulsar OK volvemos a la pantalla anterior, con c:\apache como directorio de instalacin. Si
en esa pantalla observamos que el directorio que aparece no es ese sino algo parecido a
c:\apache\Apache2.2, entonces volvemos a pulsar Change para editarlo y seleccionarlo
correctamente.
Al pulsar Next la instalacin comienza.
Tras concluir, podemos observar que tenemos instalado un nuevo servicio, y que en la barra
de estado nos aparece un icono de Apache para arrancarlo y pararlo:
Plataforma Linux
Sistemaoperativo
Instalar la distribucin de Linux elegida, de la forma habitual. Se recomienda usar
configuraciones de servidor, con un conjunto mnimo de paquetes, para optimizar el
rendimiento y el uso de disco.
Tambin se recomienda instalar el servidor Apache junto con el sistema operativo, ya que
as nos ahorramos posteriormente tener que instalarlo. El servidor Apache se incluye como
paquete estndar en todas las distribuciones de Linux.
Igualmente, si la base de datos que se desea usar es PostgreSQL, se recomienda
seleccionar el paquete correspondiente e instalarlo junto con el operativo. PostgreSQL
tambin suele estar incluido como paquete estndar en las distribuciones de Linux (tanto
CentOS como OpenSuSE lo incluyen).
Por el contrario, se recomienda encarecidamente no instalar los paquetes Java (JDK),
Tomcat, JBoss, que puedan venir incluidos en las distribuciones de Linux, sino omitirlos e
instalarlos manualmente con posterioridad, descargndolos del fabricante original. Sobre
todo en el caso de Java, las distintas distribuciones Linux utilizan distintos criterios de
ubicacin, y el administrador del sistema pierde el control de dnde est instalado qu.
Adems, usar el Java de la distribucin de Linux suele complicar la resolucin de
necesidades posteriores como la actualizacin a una nueva versin, o la instalacin en la
misma mquina de varias JVM de distintas versiones (necesidad que es habitual cuando en
la misma mquina se instalan diversas aplicaciones).
Tambin se recomienda crear un directorio donde se dejen almacenados, como referencia,
todos los programas y paquetes que se utilicen para la instalacin del entorno, detallados en
los apartados que siguen. En las mquinas virtuales de referencia se ha usado para esto el
directorio /root/efacil.install.
Java
El JDK para Linux es distribuido de forma gratuita por Sun/Oracle, en forma de un ejecutable
instalador. En las mquinas virtuales se ha instalado el JDK 6u21 (jdk-6u21-linux-x64.bin).
Para instalar Java hay que descargar y ejecutar el programa instalador (recomendamos
descargarlo en el directorio /root/efacil.install/java y ejecutarlo desde ah, dejndolo
almacenado para futuras referencias). Basta con seguir las instrucciones en pantalla. Se
recomienda usar /usr/local/jdk1.6.0_21 como directorio de instalacin, y crear un enlace
/usr/local/java apuntando a ese directorio mediante el comando
ln -s /usr/local/jdk1.6.0_21 /usr/local/java
Es muy recomendable establecer la variable de entorno JAVA_HOME apuntando al path donde
se ha instalado Java. Tambin es recomendable aadir el subdirectorio bin de Java al PATH.
PostgreSQL
Instalarlo como paquete de la distribucin de Linux utilizada.
Notasadicionales
El directorio de datos usado por PostgreSQL en la mayora de las distribuciones de Linux es
/var/lib/pgsql/data.
Con la instalacin por defecto se tiene acceso al gestor de bbdd solamente de forma local
(adecuado para el caso en que las aplicaciones y el gestor de bbdd van a correr en la misma
mquina). Para tener acceso remoto a la base de datos, si ello fuera necesario, habra que
editar el fichero pg_hba.conf, en el directorio de datos de Postgre, y aadir una entrada que
permita la conexin desde el rango de direcciones deseado. En el propio fichero aparecen
ejemplos para ello. La lnea que define la entrada de configuracin habilitando el acceso
remoto ser similar a sta:
host all all 192.168.48.0/24 md5
En ella se debern especificar los valores adecuados al entorno de sistemas en el que se
est realizando la instalacin. El ejemplo mostrado habilita el acceso tipo host (remoto va
tcp/ip), a cualquier database, por parte de cualquier usuario, desde el rango de direcciones
definido por la subred 192.168.48.0/24, y con el mtodo de acceso md5.
El acceso remoto permite, por ejemplo, desplegar el esquema de datos de e-fcil en remoto,
desde un puesto de trabajo. Para ejecutar los scripts SQL en remoto, desde un puesto
Linux, hay que tener instalado en ese puesto el paquete de PSQL de la distribucin.
El comando psql es el intrprete de comandos de PostgreSQL, utilizado por los scripts de
despliegue del esquema de datos de e-fcil. A diferencia de los intrpretes de otras bases
de datos, psql no admite el paso del parmetro password en su invocacin. El mecanismo
recomendado en los puestos de administracin de la base de datos, y en las mquinas que
deban ejecutar scripts automticos, es almacenar las passwords con la proteccin propia de
la cuenta del sistema operativo, en un fichero denominado .pgpass, localizado en la home
del usuario. Si no se desea este procedimiento, entonces es necesario ejecutar los scripts
manualmente y teclear la password cuando el intrprete la requiere.
El script de despliegue del esquema de datos e-fcil, deploy_database, que es generado por el
instalador de aplicaciones e-fcil, funciona automticamente gracias a que almacena la
password de conexin en una entrada del fichero .pgpass, antes de invocar el intrprete. El
script instalador deploy_database hace un backup de este fichero .pgpass antes de almacenar
nada en l, y lo restaura cuando completa los scripts SQL y DDL, de forma que en
circunstancias normales no quedan cacheadas las passwords en el puesto desde el que se
realiza el despliegue. Dado que puede haber fallos de todo tipo en un puesto de trabajo
normal, y que el comando de deploy puede cancelarse prematuramente de forma voluntaria,
es recomendable vigilar el contenido de dicho fichero si queremos estar seguros de que no
quedan rastros de las passwords en ese puesto. Si no se desea que bajo ningn concepto
exista ese riesgo, entonces se recomienda usar el instalador para generar los scripts SQL y
DDL y a continuacin usar directamente psql para lanzarlos manualmente sobre el gestor de
bbdd.
Otro aspecto al que prestar atencin es el encoding usado por la base de datos, para que los
caracteres extendidos como acentos o letras sean almacenados correctamente. En Linux,
Postgre permite modificar el encoding, en el proceso de creacin de la instancia mediante
initdb. El instalador de aplicaciones e-fcil genera los scripts de carga de datos iniciales en
ISO-8859-1. Se recomienda no editar manualmente dichos scripts SQL. Si la instancia de
Postgre se crea en ISO-8859-1, o su equivalente Latin1, los scripts no necesitarn
conversin. Los usuarios avanzados que desearan utilizar otro encoding podran editar los
ficheros Ant usados por el instalador, ubicados en <deploy.dir>/ant, y modificar el encoding
en el que son generados los scripts SQL.
Oracle
Oracle XE para Linux se distribuye como paquete RPM (oracle-xe-univ-10.2.0.1-
1.0.i386.rpm).
Para instalar Oracle hay que descargar el paquete RPM (recomendamos descargarlo en el
directorio /root/efacil.install/oracle e instalarlo desde ah, dejndolo almacenado para
futuras referencias). Para instalar el paquete basta con ejecutar
rpm -i oracle-xe-univ-10.2.0.1-1.0.i386.rpm
Tomcat
JBoss es distribuido para Linux en forma de un archivo empaquetado tar.gz, sin instalador.
En las mquinas virtuales se ha utilizado la versin 6.0.29 (apache-tomcat-6.0.29.tar.gz).
Para instalar Tomcat hay que descargar y descomprimir el archivo tar.gz (recomendamos
descargarlo en el directorio /root/efacil.install/tomcat y descomprimirlo desde ah,
dejndolo almacenado para futuras referencias).
Como directorio de instalacin se recomienda usar /usr/local/tomcat. Para ello, basta con
ejecutar:
cd /usr/local
tar zxvf /root/efacil.install/tomcat/apache-tomcat-6.0.29.tar.gz
ln -s /usr/local/apache-tomcat-6.0.29.tar.gz ./tomcat
JBoss
JBoss es distribuido para Linux en forma de un archivo empaquetado ZIP, sin instalador. En
las mquinas virtuales se ha utilizado la versin 5.1.0.GA (jboss-5.1.0.GA.zip).
Para instalar JBoss hay que descargar y descomprimir el archivo ZIP (recomendamos
descargarlo en el directorio /root/efacil.install/jboss y descomprimirlo desde ah, dejndolo
almacenado para futuras referencias).
Como directorio de instalacin se recomienda usar /usr/local/jboss-5.1.0.GA. Por tanto,
basta con ejecutar:
cd /usr/local
unzip /root/efacil.install/jboss/jboss-5.1.0.GA.zip
Apache
Instalarlo como paquete de la distribucin de Linux utilizada.
Instalacinnuevade aplicacionese-fcil
El programa instalador
La distribucin de e-fcil incluye una utilidad de instalacin que es el procedimiento
recomendado para instalar y configurar las aplicaciones que componen el sistema.
El instalador es una aplicacin Java por lnea de comandos que utiliza Velocity y Ant, sobre
un contexto de Spring, para generar los desplegables, ficheros de configuracin y scriptera
adecuados al entorno elegido. El instalador es offline e independiente de la plataforma de
destino, es decir, se puede ejecutar en un puesto totalmente aislado. Tambin se pueden
generar distintos desplegables, para distintas plataformas, en el mismo puesto; cada
ejecucin del instalador genera todo el contenido sobre una carpeta seleccionable mediante
parmetro; se puede elegir una carpeta distinta para cada plataforma destino, target, que
nos interese, y tener centralizadas todas ellas en un mismo puesto. Si no se le proporciona
ningn parmetro, el instalador utiliza la carpeta deploy, dentro del directorio del instalador.
En genrico, nos referiremos a esta carpeta, para una ejecucin concreta del instalador,
como <deploy_dir>.
El programa instalador acepta un conjunto de opciones accesorias, que le comandan a
realizar operaciones de despliegue posteriores a la generacin de la carpeta <deploy_dir>.
Estas operaciones estn pensadas para ser usadas solamente en el propio servidor, salvo el
caso de la base de datos, que puede crearse y desplegarse en remoto si habilitamos el
servidor para ello.
El texto de usage del programa instalador es:
FORMAS DE USO:
(1) install [deploy_dir]
Ejecuta el instalador, generando todos los ficheros de despliegue en el
directorio indicado por deploy_dir.
deploy_dir (por defecto 'deploy') es el nombre del directorio en el
que se generarn todos los elementos necesarios para el despliegue.
La instalacin se puede completar en una o en dos ejecuciones de este
comando, segn el nivel de personalizacin necesario (ver manual de
instalacin).
Utilizando nombres distintos para deploy_dir se pueden realizar
distintas instalaciones para distintas plataformas, en esta misma
mquina (ver manual de usuario).
(2) install -clean [deploy_dir]
Es idntico a (1), pero realiza una instalacin limpia. Equivale
a borrar el directorio deploy_dir y a continuacin ejecutar (1).
Es til cuando, en una instalacin en dos pasos, hemos ejecutado ya el.
primer paso y deseamos empezar de nuevo desde cero (ver manual de
instalacin).
(3) install -db [deploy_dir]
Ejecuta el script de creacin del esquema de base de datos y los
scripts de carga de datos iniciales en dicho esquema.
Estos scripts se generan mediante (1) o (2) en el directorio
'<deploy_dir>/database'.
(4) install -web [deploy_dir]
Despliega las aplicaciones eFcil sobre el servidor de aplicaciones
configurado, en formato exploded (war descomprimido).
Las aplicaciones se configuran mediante (1) o (2), quedando preparadas
para su despliegue en '<deploy_dir>/exploded'.
(5) install -war [deploy_dir]
Despliega las aplicaciones eFcil sobre el servidor de aplicaciones
configurado, en formato war.
Las aplicaciones se configuran mediante (1) o (2), quedando preparadas
para su despliegue en '<deploy_dir>/war'
(6) install -http [deploy_dir]
Despliega los ficheros de configuracin de Apache generados
durante la ejecucin de (1) o (2).
Estos scripts se encuentran en '<deploy_dir>/apache'.
Al instalador le acompaan un conjunto de scripts instaladores que hacen poco ms que
invocarle con cada una de estas diferentes opciones. El script bsico es install (.bat o .sh),
que invoca al instalador sin opciones.
La carpeta<deploy_dir>
Cada carpeta <deploy_dir> representa una plataforma eFcil completa, personalizada con los
valores configurados durante la ejecucin del instalador.
Su elemento esencial es el fichero <deploy_dir>/install.properties, que contiene los
parmetros de configuracin que describen la plataforma.
El resto de su contenido est organizado en carpetas, cada una de ellas correspondiente a
un componente de la plataforma:
- ant
Directorio que contiene las definiciones de las tareas de Ant que el instalador ejecuta
para generar los desplegables y para lanzarlos contra el servidor.
- apache
Directorio con los ficheros de configuracin de Apache adecuados a la plataforma, junto
con un fichero README con notas de instalacin. Estos ficheros pueden ser utilizados
por un administrador para configurar personalmente el servidor Apache, o bien pueden
ser desplegados automticamente mediante el comando install -http. En las
plataformas Linux se obtienen dos subdirectorios, llamados centosy suse, para tener por
separado las peculiaridades de cada una de estas distribuciones. Otras distribuciones
Linux deberan ser muy similares a alguna de estas dos, quiz con ligeras
modificaciones.
- conf
Ficheros de configuracin de las aplicaciones eFcil, ya personalizados con los
parmetros de la plataforma que se hayan configurado en el instalador. Estos ficheros
son desplegados sobre el directorio correspondiente del servidor de aplicaciones, como
parte de las tareas realizadas por los comandos install -web o install -war.
- database
Scripts SQL y DDL para creacin y carga inicial del esquema de datos usado por las
aplicaciones eFcil. Tambin incluye scripts de sistema operativo (.bat y .sh) que lanzan
el cliente de bbdd para ejecutar esos scripts SQL. El instalador ejecuta estos scripts a
travs de tareas de Ant, en respuesta al comando install -db.
- datasource
Este directorio solamente est presente en los casos en los que el servidor de
aplicaciones necesita algn fichero de configuracin especfico para definir el
DataSource de las aplicaciones. En otros casos, la definicin est incluida en el
directorio META-INF de las aplicaciones, y no es necesario un fichero especfico, as que
en esos casos este directorio no existir o estar vaco.
- exploded
Contiene las aplicaciones eFcil en formato desempaquetado, ya personalizadas para
los parmetros de la plataforma que se hayan configurado en el instalador. Estos
ficheros son desplegados sobre el directorio correspondiente del servidor de
aplicaciones, como parte de las tareas realizadas por el comando install -web.
- war
Contiene los empaquetados de las aplicaciones eFcil, en formato war. El contenido de
los empaquetados es exactamente el mismo que el de exploded. Los ficheros war son
desplegados sobre el directorio correspondiente del servidor de aplicaciones, como parte
de las tareas realizadas por el comando install -war.
- web
Contiene los recursos estticos servidos directamente por Apache. Estos recursos
(imgenes, hojas de estilo, ) son desplegados en el directorio configurado por el
instalador, como parte de las tareas realizadas por los comandos install -web o install -
war.
Creacinde la carpeta<deploy_dir>
Cuando ejecutamos por primera vez el instalador, o cuando le indicamos una carpeta
inexistente, nos muestra un conjunto bsico de parmetros de configuracin, con unos
valores iniciales por defecto. Hay dos juegos de valores por defecto: para plataformas
Windows y para plataformas Linux. El juego propuesto es el correspondiente al sistema
operativo del servidor o del puesto de trabajo donde ejecutamos el instalador. No obstante,
todos los valores son editables, por lo que siempre podremos generar una plataforma u otra
con independencia del sistema operativo en el que corra el instalador.
Los parmetros bsicos son:
- efacil.host.name: Nombre del host en el que va a residir EFcil. Es el nombre de
servidor que se va a usar en las URL que darn acceso al sistema, a travs de internet o
intranet.
- efacil.system: Sistema operativo utilizado en el servidor. Se utiliza para establecer
rutas por defecto a directorios de instalacin, directorios temporales y otros aspectos.
Debe utilizarse uno de los valores siguientes: linux, suse, centos, windows. Los valores
linux, suse y centos son prcticamente equivalentes, salvo algunos matices en el
despliegue de las configuraciones de Apache.
- efacil.app.server: Servidor de aplicaciones utilizado. Debe utilizarse uno de los valores
siguientes: jboss, tomcat, was.
- efacil.apache.path: Directorio de instalacin del servidor web Apache. Algunos
ejemplos de valores tpicos son los siguientes: /etc/apache2, /etc/httpd, c:/apache.
- efacil.app.server.path: Directorio de instalacin del servidor de aplicaciones. Algunos
ejemplos de valores tpicos son los siguientes: /usr/local/jboss-5.1.0.GA, c:/tomcat.
- efacil.database.manager: Gestor de base de datos utilizado. Debe utilizarse uno de los
valores siguientes: sqlserver, postgre, oracle, db2.
- efacil.database.host: Nombre o IP del servidor de base de datos usado por Efcil (visto
desde el servidor de aplicaciones). Se debera utilizar 'localhost' si el gestor de base de
datos reside en la misma mquina que el servidor de aplicaciones.
- efacil.database.port: Puerto en el que escucha el servidor de base de datos usado por
EFacil.
- efacil.database.name: Nombre de la base de datos usada por EFcil. Es el valor elegido
al crear la base de datos. Puede ser uno escogido expresamente para EFcil (p.e.
EFACIL) o uno ya existente con anterioridad.
- efacil.database.user: Nombre del usuario que usarn las aplicaciones para conectarse
a la base de datos.
- efacil.database.password: Password que usarn las aplicaciones para conectarse a la
base de datos.
Los parmetros bsicos se pueden editar uno a uno, de forma interactiva, sin salir del
instalador.
Una vez que aceptamos los parmetros bsicos, el instalador crea la carpeta y construye
con ellos el fichero install.properties.
A continuacin, nos muestra, de forma paginada, el contenido de dicho fichero,
sometindolo a nuestra aceptacin. En una instalacin tpica, los valores propuestos sern
correctos y podremos proseguir con la generacin del desplegable.
Si nuestra instalacin tiene alguna peculiaridad que se separa de los valores propuestos,
podemos cancelar en ese momento, respondiendo N a cualquiera de las preguntas de
aceptacin. Si hacemos esto, el instalador termina, dejndonos el fichero install.properties
para que lo editemos y ajustemos los valores deseados. Cuando estamos listos para
continuar, volvemos a ejecutar el instalador, que detectar la existencia de install.properties
y se saltar la edicin de parmetros bsicos, pasando directamente a requerir (de nuevo)
aceptacin de los valores (tericamente corregidos).
Los valores almacenados en install.properties son un superconjunto de los parmetros
bsicos. Se incluyen stos, valores secundarios derivados a partir de los bsicos (que muy
raramente habr que tocar) y otros valores de detalle que normalmente no habr que
modificar, salvo casos muy especiales.
Generacinde los desplegables
Cuando finalmente aceptamos los valores de install.properties, el instalador procede a
generar todos los desplegables en los subdirectorios de <deploy_dir>. La carpeta de
despliegue queda as preparada para el uso que se le quiera dar, desde desplegar
manualmente sobre el servidor, hasta utilizar los scripts (.bat o .sh) de despliegue,
denominados deploy_xxxx, que nos facilitan las cosas.
Ver apndice de libreras en este documento.
Preparacindel instalador
El instalador se distribuye en forma de un fichero comprimido (zip o tar.gz) que hay que
descomprimir, generando as un nuevo entorno de trabajo de instalacin.
El fichero de distribucin del instalador se denomina efacil-install-distribution-x.x-all.zip
.Se recomienda descomprimir el fichero en un directorio donde se dejen almacenados, como
referencia, todos los programas y paquetes que se utilicen para la instalacin de la
plataforma. En las mquinas virtuales de referencia se ha usado para esto el directorio
/root/efacil.install, en Linux, o c:/efacil.install, en Windows.
Aunque el procedimiento es muy similar, y el instalador es el mismo en ambos casos,
describiremos por separado los casos de Linux y Windows.
Instalacin de plataformas Linux
Para comenzar con el proceso de instalacin abrimos una consola o un terminal, como
usuario administrador (root) y nos movemos al directorio donde hemos descomprimido el
instalador eFcil, que si hemos utilizado los paths propuestos en este documento ser
/root/efacil.install/efacil-install-distribution-x.x.
Generacin
Podemos generar una o ms plataformas desplegables, en uno o ms subdirectorios, de
distintos tipos (no solamente Linux), para distintas bases de datos y servidores de
aplicaciones. Para generar estas plataformas, mediante el comando install.sh, no es
necesario arrancar ni parar ningn servicio, ni la mquina en la que nos encontremos se ve
afectada de ninguna forma (de hecho, no tiene por qu ser la mquina servidora, aunque es
ms cmodo hacerlo en ella). El nico requisito es tener instalado Java, y tener configurada
la variable de entorno $JAVA_HOME (o que el path sea /usr/local/java).
En Linux disponemos de dos scripts para generar las carpetas de instalacin: install.sh e
install_clean.sh. Ambos son muy similares, la nica diferencia entre ellos es que
install_clean utiliza el parmetro -clean, que borra la carpeta <deploy.dir> antes de proceder
a la instalacin. Ambos comandos aceptan el parmetro adicional:
- El nombre de la carpeta en la que deseamos generar el desplegable, es decir, el
<deploy.dir> que queremos utilizar. Si lo omitimos se asume el valor deploy.
Para generar una plataforma Linux con el nombre por defecto, utilizamos simplemente:
# ./install.sh
Esto nos crear un desplegable en el directorio
/root/efacil.install/efacil-install-distribution-x.x/deploy
Si queremos generar otro desplegable, en la carpeta mi.deploy, usaremos:
# ./install.sh mi.deploy
Que crear el desplegable en el directorio
/root/efacil.install/efacil-install-distribution-x.x/mi.deploy
Seleccinde parmetrosbsicos
Tras alguna pregunta de confirmacin inicial, el instalador nos muestra una pantalla de este
tipo:
Bienvenido al instalador de eFcil.
------------------------------------------------------------------------------
Este comando prepara una nueva instalacin en el directorio
/root/efacil.install/efacil-install-distribution-x.x/deploy.
------------------------------------------------------------------------------
En dicho directorio se generarn los elementos desplegables para
instalar eFcil en la plataforma de destino, que no tiene por qu ser
la misma mquina en la que se est ejecutando este instalador.
------------------------------------------------------------------------------
Desea continuar? (S/N)
Si indicamos que queremos continuar, introducimos S. Nos va mostrando los distintos
parmetros de configuracin que podemos modificar. Para cambiar un valor, tecleamos su
nmero y pulsamos enter. Por ejemplo, supongamos que queremos utilizar centos en vez de
windows. Tecleamos 1:
------------------------------------------------------------------------------
Seleccione el sistema operativo de destino
------------------------------------------------------------------------------
Las opciones disponibles son:
1. centos
2. windows
3. suse
4. linux
------------------------------------------------------------------------------
Introduzca el nmero de su eleccin [2: windows] 1
Actualmente seleccionado: centos
A continuacin el instalador nos va mostrando las distintas opciones que podemos elegir de:
base de datos, servidor de aplicaciones, configuracin de Apache
------------------------------------------------------------------------------
Seleccione la base de datos de destino
------------------------------------------------------------------------------
1. db2
2. oracle
3. postgre
------------------------------------------------------------------------------
Introduzca el nmero de su eleccin [3: postgre] 3
Actualmente seleccionados: centos - postgre
------------------------------------------------------------------------------
Seleccione el servidor de aplicaciones de destino
------------------------------------------------------------------------------
1. tomcat
2. jboss
3. was
------------------------------------------------------------------------------
Introduzca el nmero de su eleccin [2: jboss] 2
Propiedades de configuracin de Apache
Seleccione una propiedad a modificar o pulse ENTER para aceptar los valores actuales
------------------------------------------------------------------------------
Los valores actuales de las propiedades de este bloque son:
1. efacil.host.name = vmefacil.fi2net.com
2. efacil.apache.path = /etc/httpd
3. ssl.crt.cert.file = /etc/pki/tls/certs/vmefacil.fi2net.com.crt
4. ssl.key.cert.file = /etc/pki/tls/private/vmefacil.fi2net.com.key
5. ssl.ca.chain.file = /etc/pki/tls/certs/vmefacil.fi2net.com-ca.crt
------------------------------------------------------------------------------
Introduzca el nmero de la propiedad a editar (o ENTER para continuar):
Propiedades de configuracin del servidor de aplicaciones
------------------------------------------------------------------------------
1. efacil.app.server.path = /usr/local/jboss-5.1.0.GA
2. efacil.static.resources.path = /usr/local/jboss-5.1.0.GA/efacilcss
3. efacil.generated.forms.path = /usr/local/jboss-5.1.0.GA/generated_forms
4. efacil.erp.temp.path = /usr/local/jboss-5.1.0.GA/temporal
5. efacil.ajp.path = localhost:8009
6. efacil.conf.path = /usr/local/jboss-5.1.0.GA/server/web/conf
7. efacil.webapps.path = /usr/local/jboss-5.1.0.GA/server/web/deploy
------------------------------------------------------------------------------
Propiedades de configuracin de la base de datos
------------------------------------------------------------------------------
1. efacil.database.host = localhost
2. efacil.database.port = 5432
3. efacil.database.name = efacil
4. efacil.database.user = efacil
5. efacil.database.password = efacil
6. datasource.conection.url = jdbc:postgresql://localhost:5432/efacil
------------------------------------------------------------------------------
Otras propiedades de configuracin
------------------------------------------------------------------------------
1. ds.jndi.name = EFacilDatasource2
2. ds.gf.jndi.name = jdbc/CtkGF12DataSource
3. ds.gfws.jndi.name = jdbc/CtkGF12WSDataSource
4. ds.erp.jndi.name = jdbc/EFacilERPServicesDataSource
------------------------------------------------------------------------------
Validacinde propiedadesde la instalacin
Una vez que estamos de acuerdo con los valores de los parmetros bsicos, pulsamos
enter, y el instalador genera la distribucin, se nos muestra la siguiente informacin (en
pginas sucesivas):
Generando ficheros personalizados ... terminado.
Generando la distribucin (puede tardar unos minutos) ... hecho.
Empaquetando las aplicaciones ...
--> admcomun ...
--> admineFactura ...
--> admtramites ...
--> carpetaempresariov1 ...
--> circeLicenciasWS ...
--> circelocal ...
--> CtkGF12WS ...
--> EFacilConformacionWS ...
--> eFacilDC ...
--> EFacilERPServices ...
--> EFacilJnlp ...
--> eFactura ...
--> genforms ...
--> services ...
--> sso ...
--> tramitafacil ...
--> portalinterno ...
--> EFacilFacturaService ...
--> EFacilTramitesWS ... Terminado.
Generando sumario de la instalacin ... hecho.
ADVERTENCIA!:
Para tener una distribucin funcional de la aplicacin es necesario
incluir las libreras:
- Metro 2.0,
- Mojarra 1.2.14,
- Toplink Essentials 2.0,
- AspectJ 1.6.7,
- Saxpath,
- JavaMail 1.4.1,
- Bouncy Castle 1.37, 1.40 y 1.43
Consulte el manual de instalacin: apndice 1 (Manual_Instalacion_Despliegue).
Adems, si ha elegido como servidor de aplicaciones WAS, consulte el manual de
instalacin, el apartado: Notas adicionales a la instalacin de WebSphere .
Presione una tecla para continuar . . .
Estos valores son el contenido del fichero install.properties que en este momento tenemos
generado en la carpeta <deploy.dir>. Si observamos algn valor que no es correcto,
debemos teclear n o N a cualquiera de las preguntas, y el instalador terminar en ese
momento. Imaginemos que no queremos que el directorio de trabajo con los ERPs sea
/usr/local/tomcat/temporal, sino algn otro como por ejemplo /var/erp. Tecleamos N y
pulsamos enter:
Son correctos estos valores? (S/N) N
------------------------------------------------------------------------------
INSTALACION CANCELADA
------------------------------------------------------------------------------
Edite el fichero de configuracin: /root/efacil.install/efacil-install-distribution-
x.x/deploy/install.properties
Una vez que los valores sean correctos, vuelva a ejecutar esta utilidad.
Si prefiere partir desde cero, utilice el comando 'install -clean'
------------------------------------------------------------------------------
**** INSTALACION CANCELADA
Como nos dice el texto en pantalla, la instalacin ha quedado suspendida, a la espera de
que asignemos el valor correcto a los parmetros. En <deploy.dir> tenemos solamente el
fichero install.properties, que es el que debemos editar para ajustar esos valores. Abrimos
un editor y cambiamos la propiedad
# Directorio de trabajo para interface con ERP's
erp.tmp.directory.path = /usr/local/tomcat/temporal
para que tome el valor correcto:
erp.tmp.directory.path = /var/erp
A continuacin volvemos a ejecutar el instalador:
# ./install.sh
==============================================================================
El sistema se instalar usando los parmetros que se detallan a continuacin.
Si observa algo incorrecto pulse N cuando se le pida aceptacin,
y la instalacin ser cancelada.
==============================================================================
Pulse ENTER para comenzar ...
El instalador detecta que existe el fichero install.properties, as que no nos lleva a editar los
parmetros bsicos, sino que directamente entra en la fase de confirmacin de la
configuracin. Tras revisar de nuevo todos los valores, comienza la generacin del
desplegable:
Son correctos estos valores? (S/N) s
Generando (puede tardar uno o dos minutos) ... terminado.
El instalador termina, dejndonos generado el desplegable en <deploy.dir> (en nuestro caso,
la carpeta deploy, ya que no hemos indicado otra cosa).
Despliegues
Una vez que tenemos generado el desplegable para la plataforma que deseamos, podemos
proceder a desplegarla. A diferencia de la fase de generacin, que se puede realizar en
cualquier puesto de trabajo, la fase de despliegue tiene que hacerse en el servidor, con la
excepcin de la creacin de la base de datos, que puede realizarse en remoto, desde un
puesto que tenga conectividad (y siempre que hayamos abierto el acceso remoto al servidor,
al puerto usado por el gestor de bbdd).
La secuencia de despliegue recomendada es: base de datos, aplicaciones y por ltimo
configuracin de Apache.
Desplieguede la basede datos
Tras haber ejecutado install o install -clean, se habr generado una carpeta, denominada
database, en el directorio elegido como <deploy.dir> (por defecto `deploy').
Dentro del directorio <deploy.dir>/database, el instalador habr generado tres scripts SQL:
efacil_admin.sql, efacil_drop.sql y efacil_user.sql.
El script efacil_admin.sql contiene los comandos para crear el usuario y la base de datos que
van a ser utilizados por las aplicaciones eFcil. Se trata de un script pensado para ser
ejecutado por el administrador del gestor de base de datos. El script efacil_drop.sql contiene
comandos de borrado del usuario y de la base de datos, de forma que se puede utilizar para
regenerar la base de datos desde cero, en caso que se haya errado la instalacin y se est
reintentando. Si se trata de una instalacin limpia, los comandos de efacil_drop.sql fallarn,
pero esto no es preocupante, y es lo esperable en este caso, ya que no existe ni el usuario
ni la base de datos.
El script efacil_user.sql contiene los comandos para la creacin del esquema de datos de
las aplicaciones e-fcil, as como para la carga de datos inicial. Est pensado para ser
ejecutado por el usuario de base de datos que se haya asignado a las aplicaciones eFcil
(normalmente efacil).
Si el operador que realiza la instalacin es un usuario avanzado, normalmente tomar estos
dos scripts (o quiz solamente el de creacin del esquema) y los ejecutar manualmente en
su consola de administracin habitual, vigilando la salida de errores y verificando que el
esquema se ha creado correctamente.
Para el resto de casos, el programa instalador ofrece la opcin -db, que es capaz de ejecutar
estos scripts.
Para ms detalles acerca de la ejecucin de los scripts SQL, revisar este mismo apartado,
pero en la seccin de Instalacin en Windows.
Desplieguede las aplicaciones
Para desplegar las aplicaciones en el servidor de aplicaciones de destino se pueden seguir
dos estrategias.
La primera es realizar el upload del fichero WAR de cada una de las aplicaciones, utilizando
la consola de gestin del servidor de aplicaciones. Desde ese momento, las aplicaciones
pueden ser arrancadas y paradas utilizando dicha consola. Se recomienda utilizar esta
estrategia para el despliegue en WebSphere. Previamente se debern haber creado las
fuentes de datos (DataSource) utilizadas por las aplicaciones. Para el detalle de los pasos a
utilizar en WebSphere, consultar el apartado de Notas adicionales a la Instalacin de
WebSphere.
Para la utilizacin de esta primera estrategia, el instalador genera los ficheros WAR de cada
una de las aplicaciones, configurados para el entorno seleccionado, en el directorio
<deploy.dir>/war.
La segunda estrategia es copiar directamente cada uno de los ficheros WAR del directorio
<deploy.dir>/war sobre el directorio de aplicaciones usado por el servidor, que en el caso de
Tomcat es /usr/local/tomcat/webapps,
y en el de JBoss es /usr/local/jboss-5.1.0.GA/server/web/deploy.
Alternativamente, se pueden desplegar las aplicaciones ya desempaquetadas, en vez de los
ficheros WAR. El instalador deposita las versiones desempaquetadas en el directorio
<deploy.dir>/exploded.
Adicionalmente, es necesario, en las instalaciones limpias, asegurarse de que los directorios
de libreras compartidas contienen las necesarias para las aplicaciones. El instalador
deposita estas libreras en <deploy.dir>/lib.
Los ficheros de configuracin de las aplicaciones son depositados por el instalador en
<deploy.dir>/conf.
Desplieguede la configuracinde Apache
La integracin de las aplicaciones con Apache se realiza mediante el mdulo de Apache
denominado proxy_ajp, en el caso de Tomcat y de JBoss, y mediante un plugin de WAS en el
caso de WebSphere. Para la configuracin en este segundo caso, consulte el el apartado
de Notas adicionales a la Instalacin de WebSphere. En Tomcat y JBoss, la integracin con
Apache requiere la edicin de una serie de ficheros de configuracin de ste, tarea que se
recomienda sea realizada por un operador de sistemas con los conocimientos adecuados.
El instalador deposita en el directorio <deploy.dir>/apache una coleccin de ficheros de
configuracin que pueden servir de gran ayuda en esta tarea. Tambin deposita un fichero
README que conviene consultar para detalles del proceso de integracin.
Segn la distribucin de Linux de que se trate, la configuracin de Apache se localiza en
distintos directorios, y con distinta estructura. La mayora de casos se engloban dentro de
dos alternativas:
- La utilizada por SuSE y otras, en la que los ficheros de configuracin de Apache se
localizan en el directorio /etc/apache2.
- La utilizada por CentOS, RedHat y otras, en la que los ficheros de configuracin de
Apache se localizan en el directorio /etc/httpd.
Los ficheros de configuracin generados por el instalador contemplan ambas variantes, en
dos subdirectorios denominados centos y suse. Cada uno de ellos posee un README que
puede ser de bastante ayuda.
El contenido de dicho fichero, en el caso de SuSE, es el siguiente:
Resumen de los pasos a seguir para configurar Apache
en una instalacin de e-fcil sobre linux SuSE 11.3
-----------------------------------------------------------------------------------
1. Tener instalado Apache 2.2 en la versin correspondiente a la distribucin
de SuSE utilizada. Cuidar que resulten instalados los mdulos mod_proxy_ajp
y mod_ssl.
En la distribucin SuSE 11.3 testeada la versin de Apache que instala es
Apache 2.2.15. En esta versin tanto mod_ssl como mod_proxy_ajp resultan
instalados por defecto.
La forma habitual de instalar Apache 2.2 en SuSE es utilizar el
comando:
zypper in apache2
2. Obtener el certificado de servidor que se va a usar para el https.
En las instalaciones de prueba, se puede utilizar OpenSSL para generar
un certificado. La siguiente herramienta puede resultar til:
http://www.openssl.org/contrib/ssl.ca-0.1.tar.gz
3. Asegurar que, en la configuracin de Apache que tenemos desplegada en este
momento, se cargan los mdulos AJP y SSL. Esto significa que en alguno de los
ficheros .conf utilizados deben existir directivas LoadModule similares a las
siguientes:
LoadModule ssl_module /usr/lib64/apache2-itk/mod_ssl.so
LoadModule proxy_module /usr/lib64/apache2-itk/mod_proxy.so
LoadModule proxy_ajp_module /usr/lib64/apache2-itk/mod_proxy_ajp.so
Esto se puede conseguir de varias formas en el Apache distribudo por SuSE.
La forma recomendada por SuSE para cargar mdulos de Apache es incluir sus nombres
en el parmetro APACHE_MODULES del fichero /etc/sysconfig/apache2.

Durante el arranque de Apache, ese parmetro es usado para generar automticamente
el fichero /etc/apache2/sysconfig.d/loadmodule.conf, conteniendo las directivas
LoadModule correspondientes a los mdulos en l indicados.
El fichero de configuracin principal de apache, /etc/apache2/httpd.conf, debera
contener una directiva Include para cargar loadmodule.conf, similar a esta:
# generated from APACHE_MODULES in /etc/sysconfig/apache2
Include /etc/apache2/sysconfig.d/loadmodule.conf
As pues, si editamos /etc/sysconfig/apache2 e incluimos los nombres de los
mdulos deseados ('ssl', 'proxy' y 'proxy_ajp') en dicho parmetro APACHE_MODULES,
cuando arranque Apache y genere el fichero
/etc/apache2/sysconfig.d/loadmodule.conf
ese fichero contendr las directivas LoadModule deseadas.
4. Comprobar el resto de la configuracin de Apache que tenemos desplegada. En concreto
se debe comprobar lo siguiente:
4.1 Que escucha en el puerto 443 (https), mediante la directiva Listen. En SuSE, esta
directiva se encuentra en el fichero /etc/apache2/listen.conf:
Listen 80
<IfDefine SSL>
<IfDefine !NOSSL>
<IfModule mod_ssl.c>
Listen 443
</IfModule>
</IfDefine>
</IfDefine>
que es includo desde el fichero principal:
# IP addresses / ports to listen on
Include /etc/apache2/listen.conf
4.2 Que se carga la configuracin global de SSL. En SuSE, esta configuracin se encuentra
en el fichero /etc/apache2/ssl-global.conf, que es incluido desde el fichero
principal:
# global (server-wide) SSL configuration, that is not specific to
# any virtual host
Include /etc/apache2/ssl-global.conf
4.3 Que el fichero principal carga los ficheros de configuracin de los virtual hosts
definidos, que se encuentran en el directorio /etc/apache2/vhosts.d:
Include /etc/apache2/vhosts.d/*.conf
5. Al ejecutar el instalador de eFcil, se habr generado el directorio 'apache', con
dos subdirectorios: 'centos' (para instalaciones en sistemas de tipo RedHat y CentOS) y
'suse' (para instalaciones en sistemas tipo SuSE). El subdirectorio 'suse', adems de este
fichero de README, contendr el fichero 'efacil-vhost.conf'.

El fichero 'efacil-vhost.conf' contiene la definicin del virtual host para eFcil. Este
fichero debe ser copiado en el directorio '/etc/apache2/vhosts.d' para que sea cargado
durante el arranque de apache.
6. Para que los cambios en la configuracin tengan efecto, deber reiniciar el demonio de
Apache, normalmente mediante el comando
/etc/init.d/apache2 restart
El contenido del fichero README, en el caso de CentOS, es el siguiente:
en una instalacin de e-fcil sobre linux CentOS 5.5
-----------------------------------------------------------------------------------
1. Tener instalado Apache 2.2 en la versin correspondiente a la distribucin
de CentOS utilizada. Cuidar que resulten instalados los mdulos mod_proxy_ajp
y mod_ssl.
En la distribucin CentOS 5.5 testeada la versin de Apache que instala es
Apache 2.2.3. En esta versin mod_proxy_ajp resulta instalado por defecto.
La forma habitual de instalar Apache 2.2 en CentOS es utilizar los
comandos ( en la versin testeada):
yum install httpd
yum install mod_ssl
siguientes:
LoadModule ssl_module modules/mod_ssl.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
En la versin de CentOS testeada, el mdulo mod_proxy es cargado desde el fichero
de configuracin principal, /etc/httpd/conf/httpd.conf. El mdulo mod_proxy_ajp
es cargado desde el fichero /etc/httpd/conf.d/proxy_ajp.conf.
Al instalar el mod_ssl mediante 'yum install mod_ssl' se genera un fichero
/etc/httpd/conf.d/ssl.conf que contiene el LoadModule del mod_ssl.
En general, cada vez que en CentOS se instala un mdulo adicional de Apache, se
genera en /etc/httpd/conf.d/ con el nombre "<nombre del mdulo>.conf". Estos
ficheros, depositados en /etc/httpd/conf.d/, son incluidos automticamente en la
configuracin debido a una directiva Include presente en el fichero principal:
Include conf.d/*.conf
4.1 Que escucha en el puerto 443 (https), mediante la directiva Listen. En CentOS, esta
directiva se encuentra en el fichero /etc/httpd/conf.d/ssl.conf que se ha generado
tras hacer 'yum install mod_ssl':
Listen 443
4.2 Que se carga la configuracin global de SSL. En CentOS, esta configuracin se
encuentra tambin en el fichero /etc/httpd/conf.d/ssl.conf.
4.3 Si el fichero /etc/httpd/conf.d/ssl.conf que tenemos desplegado es el generado por
defecto al instalar mod_ssl, entonces contendr una configuracin para el virtual host
'_default_' que NO ES VALIDA (es una configuracin por defecto a los efecto de
demostrar el uso de las directivas SSL). Este virtual host debe ser eliminado de la
configuracin, y ser sustituido por el de eFcil (generado por el instalador, ver
punto siguiente).
En cambio, si partimos de una instalacin de Apache que ya estaba en servicio,
Entonces la actual configuracin de apache ser vlida, y lo nico que deberemos hacer
es aadir a ella, mediante un Include, el virtual host generado por el instalador de
eFcil (ver punto siguiente).
Adems del fichero con la configuracin del virtual host de eFcil, el instalador nos
proporciona un fichero 'ssl.conf' correcto, que podemos usar para sustituir al
original de mod_ssl. As pues, si la instalacin de Apache es limpia, entonces lo ms
sencillo es renombrar el fichero 'ssl.conf' existente con el nombre
'ssl.conf.original', por ejemplo, y utilizar el 'ssl.conf' generado por el instalador
de eFcil. A partir de ah bastar con desplegar el fichero del virtual host (ver
punto siguiente).
5. Al ejecutar el instalador de eFcil, se habr generado el directorio 'apache', con
dos subdirectorios: 'centos' (para instalaciones en sistemas de tipo RedHat y CentOS) y
'suse' (para instalaciones en sistemas tipo SuSE). El subdirectorio 'centos', adems de
este fichero de README, contendr un fichero 'ssl.conf' y un subdirectorio 'ssl-vhosts'
dentro del cual se encuentra el fichero 'efacil-vhost.conf'.
El fichero 'ssl.conf' est pensado para sustituir al 'ssl.conf' por defecto obtenido tras
instalar mod_ssl. Contiene las directivas globales de SSL, pero no define ningn virtual
host. En vez de eso utiliza un Include para cargar todos los ficheros del subdirectorio
'ssl-vhosts':
Include conf.d/ssl-vhosts/*.conf
fichero debe ser copiado en el directorio '/etc/httpd/conf.d/ssl-vhosts', para que sea
cargado por la idrectiva Include durante el arranque de apache.
En definitiva, si estamos ante una instalacin limpia de Apache, bastar copiar el
'ssl.conf' y el directorio 'ssl-vhosts', ambos generados por el instalador, en el
Directorio '/etc/httpd/conf.d' (el 'ssl.conf' generado sustituir al por defecto).
En cambio, si estamos ante una instalacin de Apache que ya estaba configurada y en
servicio, entonces tendremos que copiar el fichero 'efacil-vhost.conf' a un lugar en el
que resulte incluido durante el arranque. No es recomendable que este fichero se copie
directamente en /etc/httpd/conf.d, porque como la inclusin de los ficheros ah presentes
se realiza mediante un '*.conf', no tenemos garantas acerca del orden en el que son
includos. Por eso es mejor colocar 'efacil-vhost.conf' (y cualquier otra definicin de
virtual host que tuviramos previamente) en un directorio especfico para ese fin (por
ejemplo el propuesto, 'ssl-vhosts'), y cargar los ficheros de ese directorio, con un
Include, desde 'ssl.conf'.
6. Para que los cambios en la configuracin tengan efecto, deber reiniciar el demonio de
Apache, normalmente mediante el comando
/etc/init.d/httpd restart
Instalacin en Windows
Para comenzar con el proceso de instalacin se debe abrir una ventana de comandos
(cmd.exe), como usuario administrador, y desplazarse al directorio donde previamente se ha
descomprimido el instalador eFcil, que con los paths propuestos en este documento ser
c:\efacil.install\efacil-install-distribution-x.x.
Generacin
Se pueden generar una o ms plataformas desplegables, en uno o ms subdirectorios, de
distintos tipos (no solamente Windows), para distintas bases de datos y servidores de
aplicaciones. Para generar estas plataformas, mediante el comando install.bat, no es
necesario arrancar ni parar ningn servicio, ni la mquina en la que nos encontremos se ve
afectada de ninguna forma (de hecho, no tiene por qu ser la mquina servidora, aunque es
ms cmodo hacerlo en ella). El nico requisito es tener instalado Java, tener configurada la
variable de entorno JAVA_HOME y que el directorio %JAVA_HOME%/bin se encuentre registrado en la
variable PATH.
En Windows disponemos de dos scripts bsicos para generar las carpetas de instalacin:
install.bat e install_clean.bat. Ambos son muy similares, la nica diferencia entre ellos es
que install_clean utiliza el parmetro -clean, que borra la carpeta <deploy.dir> antes de
proceder a la instalacin. Ambos comandos aceptan dos parmetros adicionales:
- Un selector de tipo de plataforma, que puede tomar los valores
-windows, -suse, -centos o -linux. Si lo omitimos, el instalador adopta -windows.
- El nombre de la carpeta en la que deseamos generar el desplegable, es decir, el
<deploy.dir> que queremos utilizar. Si lo omitimos se asume el valor deploy.
Para generar una plataforma Windows con el nombre por defecto, utilizamos simplemente:
C:\efacil.install\efacil-install-distribution-x.x>install.bat
Esto nos crear un desplegable en el directorio
c:\efacil.install\efacil-install-distribution-x.x\deploy
Si queremos generar otro desplegable, en la carpeta mi.deploy, usaremos:
C:\efacil.install\efacil-install-distribution-x.x>install.bat mi.deploy
Que crear el desplegable en el directorio
c:\efacil.install\efacil-install-distribution-x.x\mi.deploy
Si queremos generar un desplegable que est ajustado a una distribucin de tipo
OpenSuSE, usaremos:
C:\efacil.install\efacil-install-distribution-x.x>install.bat -suse
O para una distribucin de tipo CentOS:
C:\efacil.install\efacil-install-distribution-x.x>install.bat -centos
O para un linux genrico:
C:\efacil.install\efacil-install-distribution-x.x>install.bat -linux
Seleccinde parmetrosbsicos
Tras alguna pregunta de confirmacin inicial, el instalador nos muestra una pantalla de este
tipo:
Bienvenido al instalador de eFcil.
------------------------------------------------------------------------------
Este comando prepara una nueva instalacin en el directorio
/root/efacil.install/efacil-install-distribution-x.x/deploy.
------------------------------------------------------------------------------
En dicho directorio se generarn los elementos desplegables para
instalar eFcil en la plataforma de destino, que no tiene por qu ser
la misma mquina en la que se est ejecutando este instalador.
------------------------------------------------------------------------------
Desea continuar? (S/N)
Si indicamos que queremos continuar, introducimos S. Nos va mostrando los distintos
parmetros de configuracin que podemos modificar. Para cambiar un valor, tecleamos su
nmero y pulsamos enter. Por ejemplo, supongamos que queremos utilizar centos en vez de
windows. Tecleamos 1:
------------------------------------------------------------------------------
Seleccione el sistema operativo de destino
------------------------------------------------------------------------------
1. centos
2. windows
3. suse
4. linux
------------------------------------------------------------------------------
Introduzca el nmero de su eleccin [2: windows] 1
Actualmente seleccionado: centos
A continuacin el instalador nos va mostrando las distintas opciones que podemos elegir de:
base de datos, servidor de aplicaciones, configuracin de Apache
------------------------------------------------------------------------------
Seleccione la base de datos de destino
------------------------------------------------------------------------------
1. db2
2. oracle
3. postgre
------------------------------------------------------------------------------
Introduzca el nmero de su eleccin [3: postgre] 3
Actualmente seleccionados: centos - postgre
------------------------------------------------------------------------------
Seleccione el servidor de aplicaciones de destino
------------------------------------------------------------------------------
1. tomcat
2. jboss
3. was
------------------------------------------------------------------------------
Introduzca el nmero de su eleccin [2: jboss] 2
Propiedades de configuracin de Apache
------------------------------------------------------------------------------
1. efacil.host.name = vmefacil.fi2net.com
2. efacil.apache.path = /etc/httpd
3. ssl.crt.cert.file = /etc/pki/tls/certs/vmefacil.fi2net.com.crt
4. ssl.key.cert.file = /etc/pki/tls/private/vmefacil.fi2net.com.key
5. ssl.ca.chain.file = /etc/pki/tls/certs/vmefacil.fi2net.com-ca.crt
------------------------------------------------------------------------------
Propiedades de configuracin del servidor de aplicaciones
------------------------------------------------------------------------------
1. efacil.app.server.path = /usr/local/jboss-5.1.0.GA
2. efacil.static.resources.path = /usr/local/jboss-5.1.0.GA/efacilcss
3. efacil.generated.forms.path = /usr/local/jboss-5.1.0.GA/generated_forms
4. efacil.erp.temp.path = /usr/local/jboss-5.1.0.GA/temporal
5. efacil.ajp.path = localhost:8009
6. efacil.conf.path = /usr/local/jboss-5.1.0.GA/server/web/conf
7. efacil.webapps.path = /usr/local/jboss-5.1.0.GA/server/web/deploy
------------------------------------------------------------------------------
Propiedades de configuracin de la base de datos
------------------------------------------------------------------------------
1. efacil.database.host = localhost
2. efacil.database.port = 5432
3. efacil.database.name = efacil
4. efacil.database.user = efacil
5. efacil.database.password = efacil
6. datasource.conection.url = jdbc:postgresql://localhost:5432/efacil
------------------------------------------------------------------------------
Otras propiedades de configuracin
------------------------------------------------------------------------------
1. ds.jndi.name = EFacilDatasource2
2. ds.gf.jndi.name = jdbc/CtkGF12DataSource
3. ds.gfws.jndi.name = jdbc/CtkGF12WSDataSource
4. ds.erp.jndi.name = jdbc/EFacilERPServicesDataSource
------------------------------------------------------------------------------
Validacinde propiedadesde la instalacin
Una vez que estamos de acuerdo con los valores de los parmetros bsicos, pulsamos
enter, y el instalador genera la distribucin, se nos muestra la siguiente informacin (en
pginas sucesivas):
Generando ficheros personalizados ... terminado.
Generando la distribucin (puede tardar unos minutos) ... hecho.
Empaquetando las aplicaciones ...
--> admcomun ...
--> admineFactura ...
--> admtramites ...
--> carpetaempresariov1 ...
--> circeLicenciasWS ...
--> circelocal ...
--> CtkGF12WS ...
--> EFacilConformacionWS ...
--> eFacilDC ...
--> EFacilERPServices ...
--> EFacilJnlp ...
--> eFactura ...
--> genforms ...
--> services ...
--> sso ...
--> tramitafacil ...
--> portalinterno ...
--> EFacilFacturaService ...
--> EFacilTramitesWS ... Terminado.
Generando sumario de la instalacin ... hecho.
ADVERTENCIA!:
Para tener una distribucin funcional de la aplicacin es necesario
incluir las libreras:
- Metro 2.0,
- Mojarra 1.2.14,
- Toplink Essentials 2.0,
- AspectJ 1.6.7,
- Saxpath,
- JavaMail 1.4.1,
- Bouncy Castle 1.37, 1.40 y 1.43
Consulte el manual de instalacin: apndice 1 (Manual_Instalacion_Despliegue).
Adems, si ha elegido como servidor de aplicaciones WAS, consulte el manual de
instalacin, el apartado: Notas adicionales a la instalacin de WebSphere .
Estos valores son el contenido del fichero install.properties que en este momento tenemos
generado en la carpeta <deploy.dir>. Si observamos algn valor que no es correcto,
debemos teclear n o N a cualquiera de las preguntas, y el instalador terminar en ese
momento. Imaginemos que no queremos que el directorio de trabajo con los ERPs sea
/usr/local/tomcat/temporal, sino algn otro como por ejemplo /var/erp. Tecleamos N y
pulsamos enter:
Son correctos estos valores? (S/N) N
------------------------------------------------------------------------------
INSTALACION CANCELADA
------------------------------------------------------------------------------
Edite el fichero de configuracin: /root/efacil.install/efacil-install-distribution-
x.x/deploy/install.properties
Una vez que los valores sean correctos, vuelva a ejecutar esta utilidad.
Si prefiere partir desde cero, utilice el comando 'install -clean'
------------------------------------------------------------------------------
**** INSTALACION CANCELADA
Como nos dice el texto en pantalla, la instalacin ha quedado suspendida, a la espera de
que asignemos el valor correcto a los parmetros. En <deploy.dir> tenemos solamente el
fichero install.properties, que es el que debemos editar para ajustar esos valores. Abrimos
un editor y cambiamos la propiedad
erp.tmp.directory.path = /usr/local/tomcat/temporal
para que tome el valor correcto:
erp.tmp.directory.path = /var/erp
A continuacin volvemos a ejecutar el instalador:
# ./install.sh
==============================================================================
El sistema se instalar usando los parmetros que se detallan a continuacin.
Si observa algo incorrecto pulse N cuando se le pida aceptacin,
y la instalacin ser cancelada.
==============================================================================
Pulse ENTER para comenzar ...
El instalador detecta que existe el fichero install.properties, as que no nos lleva a editar los
parmetros bsicos, sino que directamente entra en la fase de confirmacin de la
configuracin. Tras revisar de nuevo todos los valores, comienza la generacin del
desplegable:
Son correctos estos valores? (S/N) s
Generando (puede tardar uno o dos minutos) ... terminado.
El instalador termina, dejndonos generado el desplegable en <deploy.dir> (en nuestro caso,
la carpeta deploy, ya que no hemos indicado otra cosa).
Despliegues
Una vez que se ha generado el desplegable para la plataforma destino deseada, se puede
proceder a desplegarla. A diferencia de la fase de generacin, que se puede realizar en
cualquier puesto de trabajo, la fase de despliegue tiene que hacerse en el servidor, con la
excepcin de la creacin de la base de datos, que puede realizarse en remoto, desde un
puesto que tenga conectividad (y siempre que se encuentre abierto el acceso remoto al
servidor, al puerto usado por el gestor de bbdd).
La secuencia de despliegue recomendada es: base de datos, aplicaciones y por ltimo
configuracin de Apache.
Desplieguede la basede datos
Tras haber ejecutado install o install -clean, se habr generado una carpeta, denominada
database, en el directorio elegido como <deploy.dir> (por defecto `deploy').
Dentro del directorio <deploy.dir>/database, el instalador habr generado tres scripts SQL:
efacil_admin.sql, efacil_drop.sql y efacil_user.sql.
El script efacil_admin.sql contiene los comandos para crear el usuario y la base de datos que
van a ser utilizados por las aplicaciones eFcil. Se trata de un script pensado para ser
ejecutado por el administrador del gestor de base de datos. El script efacil_drop.sql contiene
comandos de borrado del usuario y de la base de datos, de forma que se puede utilizar para
regenerar la base de datos desde cero, en caso que se haya errado la instalacin y se est
reintentando. Si se trata de una instalacin limpia, los comandos de efacil_drop.sql fallarn,
pero esto no es preocupante, y es lo esperable en este caso, ya que no existe ni el usuario
ni la base de datos.
El script efacil_user.sql contiene los comandos para la creacin del esquema de datos de
las aplicaciones e-fcil, as como para la carga de datos inicial. Est pensado para ser
ejecutado por el usuario de base de datos que se haya asignado a las aplicaciones eFcil
(normalmente efacil).
Si el operador que realiza la instalacin es un usuario avanzado, normalmente tomar estos
dos scripts (o quiz solamente el de creacin del esquema) y los ejecutar manualmente en
su consola de administracin habitual, vigilando la salida de errores y verificando que el
esquema se ha creado correctamente.
Para el resto de casos, el programa instalador ofrece la opcin -db, que es capaz de ejecutar
estos scripts. Se puede lanzar el instalador con la opcin -db mediante el script de lnea de
comandos deploy_database.bat, disponible en la raz de la carpeta de instalacin de la
distribucin e-fcil.
El instalador, al ser invocado con la opcin -db, presenta una serie de mensajes que ms
abajo se revisan, pero lo que conviene saber en este punto es lo que hace en ltimo
trmino, que es una o ambas de las dos operaciones siguientes:
- Creacin de la base de datos y del usuario e-fcil. Consiste en ejecutar el script SQL
efacil_admin.sql. Esta operacin se realiza si interactivamente se le indica que deseamos
hacerlo. Para ello, el instalador pide el nombre del host en que reside el servidor
(localhost si estamos en una consola o terminal del propio servidor), el nombre del
usuario administrador y la password del mismo. Con estos valores, el instalador genera
un fichero create_database.bat, en el directorio <deploy.dir>/database, y a continuacin lo
ejecuta. El fichero create_database.bat se genera a partir de una plantilla, que se puede
examinar e incluso retocar, si es necesario, denominada create_database.bat.template, en
ese mismo directorio. Bsicamente, este comando invoca al cliente de bbdd adecuado al
servidor, pasndole una serie de parmetros para que la operacin sea lo ms
automtica posible. Se puede decir que hace lo mismo que hara un usuario que hubiera
elegido ejecutar manualmente los scripts SQL. Si tenemos problemas en la ejecucin del
script, se puede editar la plantilla para ajustar valores de los paths o de los parmetros
que se pasan al cliente de base de datos (aunque probablemente si es necesario hacer
esto entonces resulte ms sencillo directamente ejecutar el script SQL).
- Creacindel esquemade datoseFcil. Consiste en ejecutar el script SQL efacil_user.sql.
Esta operacin se realiza si interactivamente se le indica que deseamos hacerlo. Para
ello, pedir el nombre del host en que reside el servidor (localhost si estamos en una
consola o terminal del propio servidor), el nombre del usuario eFcil y la password del
mismo (como el usuario y la password normalmente son los mismos que usan las
aplicaciones, y el instalador dispone de ellos en el fichero install.properties, si
aceptamos el usuario por defecto ni siquiera nos pide la password). Con estos valores, el
instalador genera un fichero deploy_database.bat, en el directorio <deploy.dir>/database, y a
continuacin lo ejecuta. El fichero deploy_database.bat se genera a partir de una plantilla,
que se puede examinar e incluso retocar, si es necesario, denominada
deploy_database.bat.template, en ese mismo directorio. Bsicamente, este comando
invoca al cliente de bbdd adecuado al servidor, pasndole una serie de parmetros para
que la operacin sea lo ms automtica posible. Se puede decir que hace lo mismo que
hara un usuario que hubiera elegido ejecutar manualmente los scripts SQL. Si tenemos
problemas en la ejecucin del script, se puede editar la plantilla para ajustar valores de
los paths o de los parmetros que se pasan al cliente de base de datos (aunque
probablemente si es necesario hacer esto entonces resulte ms sencillo directamente
ejecutar el script SQL).
Al ejecutar deploy_database.bat se obtiene la siguiente secuencia de mensajes y preguntas:
--------------------------------------------------------------------------------
Este comando crea el esquema de datos usado por las aplicaciones eFcil,
en la base de datos identificada por 'efacil'.
Para ello, ejecuta el script '<deploy_dir>/database/efacil_user.sql',
conectando con el usuario 'efacil'.
Previamente, deberan haberse creado la base de datos y el usuario, usando la
cuenta de administrador del gestor de bbdd. Si estas operaciones ya estn
completadas responda 'N' a la siguiente pregunta, y se omitir la creacin
de la base de datos.
Si no es as, responda 'S', y se crearn la base de datos y el usuario.
Si no est seguro, responda 'N', y observe si el proceso falla.
Asegrese de que el gestor de bbdd est arrancado antes de continuar.
--------------------------------------------------------------------------------
Desea crear primero la base de datos y el usuario? (S/N)
En primer lugar se pregunta por la creacin de la base de datos y del usuario. Esta pregunta
se refiere a si se desea ejecutar el script efacil_admin.sql. Normalmente la respuesta ser
S, salvo que ambos se hayan creado manualmente por otros medios. En el caso de una
instalacin limpia es necesario responder S. Tambin es necesario responder S en una
reinstalacin, para que el usuario sea borrado y creado de nuevo.
Desea crear primero la base de datos y el usuario? (S/N) s
--------------------------------------------------------------------------------
Antes de crear el esquema de datos para las aplicaciones, deberan haberse
creado la base de datos y el usuario para eFcil, usando la cuenta de
administrador del gestor de bbdd. El instalador ha generado un script adecuado
a su gestor en '<deploy_dir>/database/efacil_admin.sql'. Puede utilizar este
script desde su cliente de base de datos, conectndose como administrador.
Este comando puede ejecutar ese script, pero necesita que se le proporcione
el nombre de la cuenta de administrador y la clave de acceso a la misma. En
algunos clientes de bbdd, las passwords de acceso se almacenan en un fichero
de cach en la mquina local; en esos casos, este comando intenta hacer una
copia de dicho fichero y restaurarlo tras terminar, pero debera vigilarlo
para asegurarse de que no quedan rastros de la password de administrador.
Consulte el manual de instalacin para ms informacin.
A continuacin se le pedirn los datos de conexin. Para aceptar el valor
propuesto, simplemente pulse ENTER. En cuanto al nombre del host, el valor
propuesto es localhost, lo cual es correcto si el gestor de base de datos
est ejecutndose en esta mquina; si no es as, indique el nombre completo
del servidor que lo aloja, o su direccin IP.
--------------------------------------------------------------------------------
Desea que se ejecute el script de creacin de la base de datos? (S/N)
El instalador avisa de que se va a ejecutar el script, y de que va a pedir una serie de datos
de conexin al servidor. Tambin alerta del posible cacheado de passwords que realizan
algunos clientes de bbdd, como psql en el caso de Postgre (ver Notas adicionales en el
apartado de instalacin de PostgreSQL). Se debe pulsar S.
Tras introducir los datos de conexin, el instalador pregunta si se desea borrar el usuario y
la base de datos existentes (para volver a crearlos a continuacin). La respuesta debe ser
de nuevo S, salvo en el caso de una instalacin limpia, en el que debera responderse N:
Desea que se ejecute el script de creacin de la base de datos? (S/N) s
Introduzca nombre del host [localhost]:
Introduzca puerto [5432]:
Introduzca nombre del usuario administrador [postgres]:
Introduzca password del usuario administrador: postgres
--------------------------------------------------------------------------------
Se van a crear la base de datos y el usuario de bbdd para eFcil.
Si alguno de ellos ya existe, el comando fallar.
Si lo desea, el instalador puede ejecutar un comando de borrado previo a la
creacin. Esto destruir la base de datos de eFcil y todo su contenido.
--------------------------------------------------------------------------------
Desea que se ejecute el script de borrado de la base de datos? (S/N) s
[echo] Ejecutando script de borrado ...
[echo] Completado
[echo] Ejecutando script de creacin de la base de datos ...
[echo] Completado
Los datos de conexin mostrados corresponden al caso PostgreSQL, con la configuracin
usada por defecto si se han seguido las directrices de este manual. Estos datos de conexin
con la configuracin por defecto son:
- PostgreSQL:
Usuario administrador: postgres
Password: postgres
Puerto: 5432
- Oracle:
Usuario administrador: system
Password: oracle
Puerto: 1521
- DB2:
Usuario administrador: db2
Password: db2
Puerto: 50000
- SQLServer:
Usuario administrador: sa
Password: sqlserver
Puerto: 1433
En este punto, la base de datos y el usuario estarn creados, pero todava no se ha creado
el esquema ni se han cargado los datos iniciales. Este es el ltimo paso, que se ejecuta
respondiendo S a la ltima pregunta:
--------------------------------------------------------------------------------
Ahora se proceder a crear el esquema de datos para las aplicaciones eFcil,
en la base de datos identificada por 'efacil'.
Para ello, se ejecutar el script '<deploy_dir>/database/efacil_user.sql',
conectando con el usuario 'efacil' u otro que usted elija.
A continuacin se le pedirn los datos de conexin. Para aceptar el valor
propuesto, simplemente pulse ENTER.
--------------------------------------------------------------------------------
Desea continuar con la creacin del esquema? (S/N) s
Introduzca nombre del usuario [efacil]:
[echo] Ejecutando script de creacin del esquema ...
[echo] Completado
Se puede observar que el esquema se construye, por defecto, con el usuario que se acaba
de crear, efacil, no con el usuario administrador de la bbdd. Dado que este usuario es el
usado por las aplicaciones, y su password se encuentra registrada en install.properties, el
instalador no solicita su introduccin. Si elegimos otro usuario, el instalador nos solicitar la
password del mismo.
En caso de que se produzca un error en la ejecucin de cualquiera de los scripts, el
instalador avisar del hecho, y se remitir a los ficheros de log del despliegue. El despliegue
de la base de datos genera hasta tres logs:
- drop.log
Resultado de ejecutar el script efacil_drop.sql.
- create.log
Resultado de ejecutar el script efacil_admin.sql.
- deploy.log
Resultado de ejecutar el script efacil_user.sql.
Cada uno de estos tres ficheros tiene asociado un fichero de error asociado. Los tres
ficheros de error son, respectivamente: drop.error.log, create.error.log y deploy.error.log.
Los ficheros de error son el resultado de filtrar los ficheros de log, eliminando los mensajes
informativos y dejando solamente los errores. En un despliegue correcto, los tres ficheros de
error deberan estar vacos. En caso de que el instalador genere un aviso de posible error,
se puede consultar el fichero de log completo (.log) o bien su versin filtrada (.error.log).
Tras el despliegue exitoso de la base de datos, sta queda preparada para su uso por parte
de las aplicaciones.
Desplieguede las aplicaciones
Para desplegar las aplicaciones en el servidor de aplicaciones de destino se pueden seguir
dos estrategias.
La primera es realizar el upload del fichero WAR de cada una de las aplicaciones, utilizando
la consola de gestin del servidor de aplicaciones. Desde ese momento, las aplicaciones
pueden ser arrancadas y paradas utilizando dicha consola. Se recomienda utilizar esta
estrategia para el despliegue en WebSphere. Previamente se debern haber creado las
fuentes de datos (DataSource) utilizadas por las aplicaciones. Para el detalle de los pasos a
utilizar en WebSphere, consultar el apartado de Notas adicionales a la Instalacin de
WebSphere.
Para la utilizacin de esta primera estrategia, el instalador genera los ficheros WAR de cada
una de las aplicaciones, configurados para el entorno seleccionado, en el directorio
<deploy.dir>/war.
La segunda estrategia es copiar directamente cada uno de los ficheros WAR del directorio
<deploy.dir>/war sobre el directorio de aplicaciones usado por el servidor, que en el caso de
Tomcat es c:/tomcat/webapps, y en el de JBoss es c:/jboss-5.1.0.GA/server/web/deploy.
Alternativamente, se pueden desplegar las aplicaciones ya desempaquetadas, en vez de los
ficheros WAR. El instalador deposita las versiones desempaquetadas en el directorio
<deploy.dir>/exploded.
Adicionalmente, es necesario, en las instalaciones limpias, asegurarse de que los directorios
de libreras compartidas contienen las necesarias para las aplicaciones. El instalador
deposita estas libreras en <deploy.dir>/lib.
Los ficheros de configuracin de las aplicaciones son depositados por el instalador en
<deploy.dir>/conf.
Desplieguede la configuracinde Apache
La integracin de las aplicaciones con Apache se realiza mediante el mdulo de Apache
denominado proxy_ajp, en el caso de Tomcat y de JBoss, y mediante un plugin de WAS en el
caso de WebSphere. Para la configuracin en este segundo caso, consulte el apartado de
Notas adicionales a la Instalacin de WebSphere. En Tomcat y JBoss, la integracin con
Apache requiere la edicin de una serie de ficheros de configuracin de ste, tarea que se
recomienda sea realizada por un operador de sistemas con los conocimientos adecuados.
El instalador deposita en el directorio <deploy.dir>/apache una coleccin de ficheros de
configuracin que pueden servir de gran ayuda en esta tarea. Tambin deposita un fichero
README que conviene consultar para detalles del proceso de integracin. El contenido de
dicho fichero, en el caso de Windows, es el siguiente:
en una instalacin de e-fcil sobre Windows
-----------------------------------------------------------------------------------
1. Tener instalado Apache 2.2. Cuidar que resulten instalados los mdulos mod_proxy_ajp
y mod_ssl. Ambos mdulos resultan instalados en la versin testeada.
La forma habitual de instalar Apache 2.2 en Windows es utilizar el
instalador que se puede descargar de www.apache.org.
siguientes:
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
En la versin testeada, estas tres directivas se encuentran en el fichero
de configuracin principal, c:/apache/conf/httpd.conf. No obstante, en su
versin por defecto (la que resulta de una instalacin limpia de Apache),
las tres directivas estn comentadas:
#LoadModule ssl_module modules/mod_ssl.so
#LoadModule proxy_module modules/mod_proxy.so
#LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
Por ello si partimos de una instalacin limpia es necesario descomentar esas tres lneas.
4.1 Que escucha en el puerto 443 (https), mediante la directiva Listen. En Windows, esta
directiva se encuentra en el fichero c:/apache/conf/extra/httpd-ssl.conf por defecto:
Listen 443
Sin embargo, en su versin por defecto (instalacin limpia), c:/apache/conf/httpd.conf
tiene comentada la linea:
# Secure (SSL/TLS) connections
#Include conf/extra/httpd-ssl.conf
En una instalacin limpia es necesario descomentar este Include.
4.2 Que se carga la configuracin global de SSL. En Windows, esta configuracin se
Encuentra tambin en el fichero c:/apache/conf/extra/httpd-ssl.conf (cuyo Include
Debemos haber ya descomentado en el paso anterior).
4.3 Si el fichero c:/apache/conf/extra/httpd-ssl.conf que tenemos desplegado es el
generado al instalar Apache, entonces contendr una configuracin para el virtual host
'_default_' que NO ES VALIDA (es una configuracin por defecto a los efectos de
demostrar el uso de las directivas SSL). Este virtual host debe ser eliminado de la
configuracin, y sustituido por el de eFcil (generado por el instalador, ver punto
siguiente).
En cambio, si partimos de una instalacin de Apache que ya estaba en servicio,
Entonces la actual configuracin de apache ser vlida, y lo nico que deberemos hacer
Es aadir a ella, mediante un Include, el virtual host generado por el instalador de
eFcil (ver punto siguiente).
Adems del fichero con la configuracin del virtual host de eFcil, el instalador nos
proporciona un fichero 'httpd-ssl.conf' correcto, que podemos usar para sustituir al
original. As pues, si la instalacin de Apache es limpia, entonces lo ms
sencillo es renombrar el fichero 'httpd-ssl.conf' existente con el nombre
'httpd-ssl.conf.original', por ejemplo, y utilizar el 'httpd-ssl.conf' generado por el
instalador de eFcil. A partir de ah bastar con desplegar el fichero del virtual
host de eFcil (ver punto siguiente).
5. Al ejecutar el instalador de eFcil, se habr generado el directorio 'apache', que
contendr, adems de este fichero de README, un fichero 'httpd-ssl.conf' y un
subdirectorio 'ssl-vhosts' dentro del cual se encuentra el fichero 'efacil-vhost.conf'.
El fichero 'httpd-ssl.conf' est pensado para sustituir al 'httpd-ssl.conf' por defecto
obtenido tras instalar Apache. Contiene las directivas globales de SSL, pero no define
ningn virtual host. En vez de eso utiliza un Include para cargar todos los ficheros del
subdirectorio 'ssl-vhosts':
Include conf/extra/ssl-vhosts/*.conf
fichero debe ser copiado en el directorio c:/apache/conf/extra/ssl-vhosts para que sea
cargado durante el arranque de apache.
En definitiva, si estamos ante una instalacin limpia de Apache, bastar copiar el fichero
'httpd-ssl.conf' y el directorio 'ssl-vhosts', generados por el instalador, en
c:/apache/conf/extra (httpd-ssl.conf sustituir al por defecto).
En cambio, si estamos ante una instalacin de Apache que ya estaba configurada y en
servicio, entonces tendremos que copiar el fichero 'efacil-vhost.conf' a un lugar en el
que resulte incluido durante el arranque. La instalacin por defecto para Windows solo
contiene directivas Include de ficheros unitarios. Si ese es nuestro caso, quiz tengamos
que editar alguno de los ficheros de configuracin existentes para aadir ese Include. En
cualquier caso es una buena prctica colocar 'efacil-vhost.conf' (y cualquier otra
definicin de virtual host que tuviramos previamente) en un directorio especfico donde
se ubiquen las definiciones de los virtual hosts (por ejemplo el propuesto, 'ssl-vhosts'),
y cargar los ficheros de ese directorio, con un include, desde 'httpd-ssl.conf'.
6. Por ltimo, se deber desplegar el certificado de servidor utilizado para el https. Para
ello hay que copiar dos ficheros (posiblemente tres) en los directorios de configuracin
de Apache:
- El certificado pblico, denominado por convencin '<hostname>.crt' (donde '<hostname>'
es el nombre completo del host, p.e. 'vmefacil.fi2net.com.crt'), hay que copiarlo en el
directorio 'conf/certs'.
- El fichero que contiene la clave privada asociada al certificado, denominado por
convencin'<hostname>.key' (p.e. 'vmefacil.fi2net.com.key'), hay que copiarlo en el
directorio 'conf/private'.
- Opcionalmente, si el certificado .crt no contiene la cadena de certificacin, entonces
habr que copiar el fichero .crt conteniendo dicha cadena, denominado por convencin
'<hostname>-ca.crt' (p.e. 'vmefacil.fi2net.com-ca.crt'), hay que copiarlo en el
Directorio 'conf/certs'.
Si este tercer fichero es necesario, porque el certificado .crt no contenga la cadena de
certificacin, entonces no solamente habr que copiarlo a 'conf/certs', sino que adems
ser necesario descomentar la directiva SSLCertificateChainFile en 'efacil-vhost.conf'.
#SSLCertificateChainFile "c:/apache/conf/certs/vmefacil.fi2net.com-ca.crt"
Alternativamente, estos dos o tres ficheros pueden copiarse en el directorio del
instalador, en los subdirectorios 'apache/certs' y 'apache/private'. La ventaja de esta
alternativa es que el instalador detectar la existencia de dichos ficheros y generar un
'efacil-vhost.conf' ya con la directiva descomentada, si es el caso.
7. Para que los cambios en la configuracin tengan efecto, deber reiniciar el servicio de
Apache.
Notas adicionales a la Instalacin de WebSphere
La instalacin de las aplicaciones en un servidor de aplicaciones WebSphere se debe
realizar de forma manual siguiendo los siguientes pasos:
1. Configuracin de Apache.
2. Definicin de la fuente de datos (DataSources).
3. Despliegue de las aplicaciones en el servidor web.
Configuracin de Apache
La configuracin de Apache ha de ser realizada de formar manual. La instalacin del plugin
de IBM para la conexin con Apache crear las siguientes entradas en el archivo de
configuracin de Apache (httpd.conf):
LoadModule was_ap22_module
"C:\Archivos de programa\IBM\WebSphere\Plugins\bin\mod_was_ap22_http.dll"
WebSpherePluginConfig
"C:\Archivos de programa\IBM\WebSphere\Plugins\config\was7\plugin-cfg.xml"
Estas dos entradas no se debern borrar y habr que aadir el siguiente contenido a la
configuracin (las variables dependientes del despliegue han sido resaltadas):
# Mdulos para el proxy en el caso de HTTPS con certificado de cliente y servidor
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_http_module modules/mod_proxy_http.so
# Mdulo para HTTPS
#################################################################################
# Directorios estticos
#################################################################################
Alias /circetramitesv1/generated_forms ${PATH_GENERATED_FORMS}
<Directory "${PATH_GENERATED_FORMS}">
Options Indexes MultiViews FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /efacilcss ${PATH_CSS}
<Directory "${PATH_CSS}">
Options Indexes MultiViews FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /EFacilApps/afirma ${PATH_EFACIL_APPS}/afirma
<Directory "${PATH_EFACIL_APPS}/afirma">
RedirectMatch (.*)\.jnlp$ /EFacilJnlp/$1.jnlp
Options -Indexes MultiViews FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /EFacilApps/envioDesatendido ${PATH_EFACIL_APPS}/envioDesatendido
<Directory "${PATH_EFACIL_APPS}/envioDesatendido">
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /EFacilApps/lib ${PATH_EFACIL_APPS}/lib
<Directory "${PATH_EFACIL_APPS}/lib">
AllowOverride None
Order allow,deny
Allow from all
</Directory>
#################################################################################
# CONFIGURACIN HTTPS
#################################################################################
Listen 443
AddType application/x-x509-ca-cert .crt
AddType application/x-pkcs7-crl .crl
SSLPassPhraseDialog builtin
SSLSessionCache "shmcb:${PATH_APACHE}/logs/ssl_scache(512000)"
SSLSessionCacheTimeout 300
SSLMutex default
<VirtualHost _default_:443>
DocumentRoot "${PATH_APACHE}/htdocs"
ServerName ${SERVER_NAME}
ServerAdmin ${SERVER_ADMIN}
ErrorLog "${PATH_APACHE}/logs/error.log"
TransferLog "${PATH_APACHE}/logs/access.log"
SSLEngine on
SSLProxyEngine on
SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL
SSLCertificateFile "${PATH_SSL_CERTIFICATE}"
SSLCertificateKeyFile "${PATH_SSL_CERTIFICATE_KEY}"
SSLCACertificateFile "${PATH_SSL_CA_CERTIFICATE}"
BrowserMatch ".*MSIE.*" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
CustomLog "${PATH_APACHE}/logs/ssl_request.log" \
"%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
<Location "/certsso">
ProxyPass https://localhost:9443/sso
ProxyPassReverse https://localhost:9443/sso
SSLVerifyClient require
SSLVerifyDepth 5
SSLOptions +StdEnvVars +ExportCertData +OptRenegotiate
RequestHeader set X-SSL-Client-Cert %{SSL_CLIENT_CERT}e
Options Indexes FollowSymLinks MultiViews
Order allow,deny
Allow from all
</Location>
</VirtualHost>
La descripcin de las distintas variables es la siguiente:
PATH_GENERATED_FORMS: Directorio donde se generan los formularios. En la
mquina virtual de ejemplo: c:/was/generated_forms/
PATH_CSS: Directorio donde se almacenan las css de las aplicaciones. En la
mquina virtual de ejemplo: c:/was/efacilcss/
PATH_EFACIL_APPS: Directorio donde se encuentra la carpeta EFacilApps con los
procesos batch. En la mquina virtual de ejemplo: c:/was/EFacilApps/
PATH_APACHE: Directorio del apache. En la mquina virtual de ejemplo: c:/apache
SERVER_NAME: Nombre del servidor.
SERVER_ADMIN: Correo electrnico del administrador.
PATH_SSL_CERTIFICATE: Ruta al certificado para las conexiones HTTPS.
PATH_SSL_CERTIFICATE_KEY: Ruta a la clave privada para las conexiones
HTTPS.
PATH_SSL_CA_CERTIFICATE: Ruta del almacn con los certificados de las
autoridades de certificacin admitidas para las conexiones HTTPS.
Definicin de la fuente de datos (DataSources)
En el caso del Websphere se definir una nica fuente de datos que se asociar a todas las
aplicaciones. Su definicin se realiza mediante la consola administrativa de WebSphere. Un
requisito inicial es la creacin del proveedor de datos (Oracle, PostgreSQL, DB2,
SQLServer,) como se ha comentado en el apartado WebSphere.
La definicin de la fuente de datos se realiza en el apartado Recursos > JDBC > Orgenes
de datos:
Una vez dentro se pulsar en el botn Nuevo que aparece en la parte superior de la tabla.
En primer lugar se indica el nombr de la fuente y el nombre JNDI con el que se
correlacionarn las aplicaciones, se usarn los siguientes valores:
Nombre: EFacilDatasource2
Nombre JNDI: jdbc/EFacilDatasource2
En la siguiente pantalla es necesario proporcionar el proveedor de JDBC a utilizar por la
fuente de datos (dicho proveedor tiene que haberse definido previamente), en el ejemplo se
usa un proveedor para DB2:
A continuacin se definirn las propiedades personalizadas que son dependientes del
proveedor especfico (Oracle, PostgreSQL, DB2, SQLServer,). En el caso de una base de
datos DB2 habra que definir:
Nombre de la base de datos. El valor de este campo es EFACIL.
Nombre de servidor. Direccin del servidor de la base de datos.
Nombre de puerto. Puerto en que escucha el servidor de la base de datos.
En las siguientes pantallas se dejarn los datos por defecto y se proceder a la creacin de
la fuente de datos.
Una vez creada ser necesario indicar el usuario y contrasea que sern los que se hayan
definido en el instalador. Para ello hay que acceder al apartado Propiedades personalizadas
de la fuente de datos y definir las propiedades:
Los nombres sern dependientes del proveedor especfico de base de datos (Oracle,
PostgreSQL, DB2, SQLServer,). En el caso de DB2 estas propiedades son user y
password:
Si se desea comprobar que la fuente de datos es correcta se puede hacer click sobre el
botn Conexin de prueba que mostrar un mensaje correcto si se puede acceder a la
fuente de datos.
Despliegue de las aplicaciones en el servidor web.
El despliegue de las aplicaciones se realizar mediante la consola administrativa en el
apartado Aplicaciones > Aplicacin nueva > Nueva aplicacin de empresa:
En el primer paso de la instalacin hay que indicar la ruta del fichero .war con el contenido
de la aplicacin, estos ficheros tpicamente se encontrarn en el directorio C:\efacil-install-
distribution-x.x\deploy\war
En el siguiente apartado se seleccionar Va de acceso rpida para definir nicamente la
informacin requerida:
En la pantalla de seleccin de opciones de instalacin se dejarn las opciones por defecto:
A continuacin se seleccionarn los servidores en los que desplegar la aplicacin, en este
caso hay que desplegarlo tanto en el WebSphere (server1) como en el apache
(webserver1). Se seleccionar ambos servidores en la lista, se marcar el checkbox de la
aplicacin y se pulsar sobre aplicar para que se despliegue en ambos:
En la siguiente pantalla es necesario relacionar las referencias a fuentes de datos de la
aplicacin con las fuentes que han sido creadas en el apartado anterior, en este caso
haremos referencia a la fuente de datos creada previamente con el nombre
EFacilDatasource2.
En la siguiente pantalla se dejarn las opciones por defecto:
Y por ltimo es necesario indicar el contexto bajo el que se servirn las distintas
aplicaciones, este contexto coincide con el nombre del fichero .war sin la extensin (p.e.:
para carpetaemrpesariov1.war sera carpetaempresariov1):
Tras instalar la aplicacin configuramos el cargador de clases como padre ltimo:
Por ltimo ser necesario arrancar la aplicacin. En la pantalla con el listado de las
aplicaciones se seleccionar el checkbox de la aplicacin oportuna y se pulsar sobre el
botn de Iniciar:
En ltimo lugar, una vez instaladas todas las aplicaciones, se actualizar el fichero de
configuracin del plugin de conexin con apache.
La actualizacin del plugin se realiza en el apartado Entorno > Actualizar configuracin
global de plug-in de servidor web.
La actualizacin se realiza en dos pasos:
1. En primer lugar hay que hacer click en el botn Aceptar lo que actualizar la
configuracin del plugin.
2. En segundo lugar se puede descargar el XML mediante el enlace Ver o bajar el
archivo de configuracin del plug-in del servidor Web actual y sustituir el fichero actual
que se encuentra en el directorio de instalacin del plugin, en el ejemplo C:\Archivos de
programa\IBM\WebSphere\Plugins\config\webserver1\plugin-cfg.xml
Registro en el sistema de Recoleccin de Estadsticas de las
aplicacionesPALS(ECO)
Tras la instalacin de la aplicacin, el instalador deber realizar un primer acceso a la
misma.
La pgina de inicio de la aplicacin presentar un logotipo genrico desde el que se accede
al formulario de registro.
Al pulsar sobre el logotipo genrico, de forma previa a la presentacin del formulario de
registro, aparecer una pgina de solicitud de credenciales: usuario y contrasea. Los
credenciales a introducir sern:
Usuario = instalador
Contrase a = instalador
En esta pgina, adems, se mostrar un telfono y un enlace al formulario web de consultas
del CRM de la S. G. De Fomento De La Sociedad De La Informacin. A travs de este
telfono / formulario podrn solicitarse estas credenciales en caso de no aparecer en el
manual por algn motivo.
Una vez establecidas las credenciales correctas, se acceder al formulario de registro. En
este formulario se introducirn datos relevantes de la instalacin: nombre de entidad, tipo,
pas
Tras introducir la informacin solicitada, el instalador aceptar y enviar el formulario de
registro. Como resultado recibir una clave necesaria para realizar posteriores cambios en la
informacin de registro.
Por ltimo, el instalador podr realizar un nuevo acceso a la aplicacin para comprobar que
sta retorna la imagen correspondiente a la aplicacin y versin instaladas.
Desde el formulario de registro, el instalador tambin podr optar por rellenar la informacin
de registro ms tarde. En tal caso se informar de la URL de acceso al formulario de registro
para que introduzca la informacin ms adelante. En este caso, la pgina de inicio de la
aplicacin continuar mostrando la imagen genrica.
Configuracin
Se deber configurar en el archivo de propiedades srepals.properties (efacil-install-
distribution-1.2\templates\conf) los siguientes parmetros:
# Protocolo para la llamada: http/https.
srepals.logger.protocol=http
# Host donde se sirve la imagen.
srepals.logger.host=localhost
(La url en produccin ser: sedeaplicaciones2.minetur.gob.es)
# Puerto donde se sirve la imagen.
srepals.logger.port=8888
# Servlet que devuelve el logo
srepals.logger.servlet=SREPALSLogger/logoServlet
# Nombre de la aplicacin
application.name=EFACIL
# Versin de la aplicacin
application.version=1.0
# Width del logo
logo.width=150
# height del logo
l ogo.height=34
# Width del iframe
iframe.width=150
# height del iframe
iframe.height=34
Actualizacinde la versinv.1.1 a v.1.2
Las libreras y archivos que se mencionan a continuacin, se encuentran en el zip efacil-
install-distribution-1.2-all.zip, en el directorio: efacil-install-distribution-
1.2\distribution\exploded.
Libreras actualizadas en esta versin
efacil-install-distribution-1.2\distribution\exploded:
- efactura.jar
o admineFactura\WEB-INF\lib
o eFactura\WEB-INF\lib
- efactura.common.jar
o admineFactura\WEB-INF\lib
o eFactura\WEB-INF\lib
o eFacilDC\WEB-INF\lib
- fi2.circe.entities.jar
o admcomun\WEB-INF\lib
o admtramites\WEB-INF\lib
o carpetaempresariov1\WEB-INF\lib
o circelocal\WEB-INF\lib
o portalinterno\WEB-INF\lib
o tramitafacil\WEB-INF\lib
o EfacilTramitesWS\WEB-INF\lib
o CirceLicenciasWS\WEB-INF\lib
o EfacilJnlp\WEB-INF\lib
o Services\WEB-INF\lib
- eFacil-EPR-WebServicesEntities.jar
o EFacilERPServices\WEB-INF\lib
- fi2.circe.entities.efactura.jar
o admcomun\WEB-INF\lib
o carpetaempresariov1\WEB-INF\lib
o circelocal\WEB-INF\lib
o tramitafacil\WEB-INF\lib
- efacturadc.jar
o eFacilDC\WEB-INF\lib
- ImageBean.class
o portalinterno\WEB-
INF\classes\com\fi2net\efacil\circe\java\srepals\ImageBean.class
o carpetaempresariov1\WEB-
INF\classes\com\fi2net\efacil\circe\java\srepals\ImageBean.class
- SrepalsBean.class
o portalinterno\WEB-
INF\classes\com\fi2net\efacil\circe\java\srepals\SrepalsBean.class
o carpetaempresariov1\WEB-
INF\classes\com\fi2net\efacil\circe\java\srepals\SrepalsBean.class
Archivos actualizados en esta versin
- formCompletDC.xsl
o eFacilDC\staticContent\Skin1\xsl\formCompletDC.xsl
- GridJS.xsl
o eFacilDC\staticContent\Skin1\xsl\GridJS.xsl
- principal.xsl
o eFacilDC\staticContent\Skin1\xsl\principal.xsl
- bottom.xsl
o eFacilDC\StaticContent\Skin1\xsl\bottom.xsl
o eFactura\StaticContent\Skin1\xsl\bottom.xsl
o admineFactura\StaticContent\Skin1\xsl\bottom.xsl
- formCompletDC.xsl
o eFacilDC\StaticContent\Skin1\xsl\ formCompletDC.xsl
- detalleCC.xsl
o eFacilDC\StaticContent\Skin1\xsl\ detalleCC.xsl
- mostrarCCFiltros.xsl
o eFacilDC\StaticContent\Skin1\xsl\ mostrarCCFiltros.xsl
- generaCC.xsl
o eFacilDC\StaticContent\Skin1\xsl\ generaCC.xsl
- editFactDigitalizadas.xsl
o eFacilDC\StaticContent\Skin1\xsl\ editFactDigitalizadas.xsl
- cierreContable.xsl
o eFacilDC\StaticContent\Skin1\xsl\ cierreContable.xsl
- appletSelectionBlock.xsl
o eFacilDC\StaticContent\Skin1\xsl \appletSelectionBlock.xsl
- menu.xsl
o eFacilDC\StaticContent\Skin1\xsl \ menu.xsl
- envioPDFs.xsl
o eFactura\StaticContent\Skin1\xsl \ envioPDFs.xsl
- Archivos de propiedades, en las aplicaciones: admcomun, portalinterno, tramitafacil,
admtramites, circelocal:
WEB-INF\classes\com/fi2net/efacil/circe/bundle/globalesText.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/globalesText_gl.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/globalesText_eu.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/globalesText_en.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/globalesText_ca.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/entityText.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/entityText_gl.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/entityText_eu.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/entityText_en.properties
WEB-INF\classes\com/fi2net/efacil/circe/bundle/entityText_ca.properties
- efactura_estilo.css
o ROOT\efacilcss\css\efactura_estilo.css
- efactura_layout.css
o ROOT.war\efacilcss\css\efactura_layout.css
- efacturadc_layout.css
o ROOT.war\efacilcss\css\efacturadc_layout.css
- faces-config-beans.xml
o carpetaempresariov1.war\ WEB-INF\faces-config-beans.xml
o portalinterno.war\ WEB-INF\faces-config-beans.xml
- spring-context.xml
o carpetaempresariov1.war\ WEB-INF\ spring-context.xml
o portalinterno.war\ WEB-INF\ spring-context.xml
- login2.jspx
o portalinterno.war\login2.jspx
o carpetaempresariov1.war\login2.jspx
- srepals.properties
el archivo srepals.properties pasa al directorio de configuracin del
servidor junto con el resto de 'properties' de eFacil
- eFactura
com/TSystems/eFacil/grid/GridUtilities.java
com/TSystems/eFacil/Pegasus/FontEnd/Blocks/Grid_DHTML.java
com/TSystems/Pegasus/Security/FacturaEValidation.java
com/TSystems/eFacil/Pegasus/Facturae/FacturaEPublication.java
com/TSystems/eFacil/Security/FacturaEValidation.java
com/TSystems/Pegasus/servlets/MainApp.java
com/TSystems/Pegasus/servlets/request/InvoicePdfSendData.java
com/TSystems/sql/ExecuteeFacilLogInsert.java
com/eFacil/login/ExternalUserLoginImpl.java
com/eFacil/login/UserLoginImpl.java
com/TSystems/Pegasus/FrontEnd/Blocks/Common.java
com/TSystems/eFacil/graphics/Graphics.java
com/TSystems/Pegasus/FrontEnd/Blocks/Grid_DHTML.java
com/TSystems/Pegasus/PublicaManager.java
com/TSystems/Pegasus/servlets/MainApp.java
- entities.1.0
com/fi2net/efacil/circe/entities/Empresa.java
com/fi2net/efacil/circe/entities/EmpresaEntidad.java
com/fi2net/efacil/circe/entities/EmpresaUsuarioExt.java
com/fi2net/efacil/circe/entities/EmpresaWS.java
com/fi2net/efacil/circe/entities/EntidadCliente.java
com/fi2net/efacil/circe/entities/EntidadInstancia.java
com/fi2net/efacil/circe/entities/pk/EmpresaEntidadPK.java
com/fi2net/efacil/circe/entities/pk/EmpresaUsuarioExtPK.java
com/fi2net/efacil/circe/entities/Tedicli.java
com/fi2net/efacil/circe/entities/CirceLicSol.java
com/fi2net/efacil/circe/entities/CirceLicSolPtes.java
com/fi2net/efacil/circe/entities/SolicitudLicencia.java
com/fi2net/efacil/circe/entities/SolicitudLicenciaPendiente.java
- entities de eFacil-ERP
com/fi2net/mityc/efacil/erp/entities/EfacilComunEmpEnt.java
com/fi2net/mityc/efacil/erp/entities/EfacilComunEmpresa.java
com/fi2net/mityc/efacil/erp/entities/EfacilComunEmpUsu.java
com/fi2net/mityc/efacil/erp/entities/EfacilComunEntidadIns.java
- entities.efactura.1.0
com/fi2net/efacil/efactura/entities/EUser.java
com/fi2net/efacil/efactura/entities/EEntidadCliente.java
- eFacilDC
com/TSystems/Pegasus/servlets/MainAppDC.java
com/TSystems/Pegasus/FrontEnd/Blocks/CierresContables.java
com/TSystems/eFacil/grid/CierreContableUtilities.java
com/TSystems/Pegasus/FrontEnd/Blocks/AppletExecution.java
com/TSystems/Pegasus/FrontEnd/Blocks/CierresContables.java
com/TSystems/eFacil/grid/CierreContableUtilities.java
com/TSystems/Pegasus/PublicaManager.java
- formCompletDC.xsl
o eFacilDC\WebContent/staticContent/Skin1/xsl/formCompletDC.xsl
- web.common.1.0
com/fi2net/efacil/circe/java/srepals/ImageBean.java
com/fi2net/efacil/circe/java/srepals/SrepalsBean.java
bundle/srepals.properties
- carpeta.empresario.1.0
WEB-INF/faces-config-beans.xml
WEB-INF/spring-context.xml
- portal.interno.1.0
WEB-INF/faces-config-beans.xml
WEB-INF/spring-context.xml
Modelo de datos
Se debern pasar los scripts (6.ISI-Implantacion-del-Sistema-de-Informacion\
scripts_actualizacion_v1.2).
- conv.timestamp.sql : actualiza el campo fecha de la tabla efacil_comun_log.
- updates.efacil.sql: actualiza descripciones de varios atributos de plataformas tipo
ERP y camino de migas de Facturacin electrnica
- diferencial.efacil.sql: actualiza registros de la tabla pattern y textinter.
Wars actualizados en esta versin
- admcomun.war
- admineFactura.war
- admtramites.war
- carpetaempresariov1.war
- circelocal.war
- EFacilERPServices.war
- EfacilFacturaService.war
- EfacilJnlp.war
- EFactura.war
- EFacilDC.war
- genforms.war
- portalinterno.war
- tramitafacil.war
Actualizacinde la versinv.1.2 a v.1.3
A continuacin se dan una serie de recomendaciones como resultado de algunas incdencias
registradas.
Acceso a la consola de administracin de TOMCAT
Si se desea utilizar la consola de administracin de TOMCAT, es recomendable, en
cualquier caso:
- Proteger el acceso mediante firewall
- Utilizar un gestor de acceso con contraseas encriptadas y una poltica de calidad de
contraseas
Versiones de APACHE, TOMCAT, etc.
Las versiones de Apache, Tomcat, etc. Usadas en las mquinas virtuales y como
configuraciones tipo para el instalador, deberan mantenerse actualizadas con los parches
de seguridad correspondientes.
Asmismo, deberan configurarse adecuadamente en Produccin, bajando los niveles de
logs y quitando la posibilidad de depuracin.
Protegiendo cookies de sesin
Es recomendable configurar el servidor de aplicaciones para que use cookies de sesin
marcadas como httponly.
En Tomcat y en Jboss esto se consigue en el fichero context.xml mediante la directiva
useHttpOnly:
<Contet useHttp!nl"#$true$%
...
<&Contet%
Para ms informacion ver:
http://tomcat.apache.org/tomcat-6.0-doc/config/context.html
Apndice1 - Librerasa descargar
Las siguientes libreras que no se incluyen en la distribucin, son necesarias para la
ejecucin de los mdulos de eFacil.
Indicamos el enlace donde se pueden descargar:
Nombre Enlace
Metro 2.0
http://olex.openlogic.com/packages/metro/2.0.1
Mojarra 1.2.14
http://javaserverfaces.java.net/download.html
Toplink essentials 2.0
http://ebr.springsorce.com/repositor!/app/librar!/version/detail"
name#oracle.toplink.essentials$version#2.0.0.b%1&beta2
AspectJ 1.6.7
http://www.eclipse.org/downloads/download.php"
file#/tools/aspectj/aspectj&1.'.(.jar
Saxpath
http://sorceforge.net/projects/saxpath/
Javamail 1.4.1
http://www.oracle.com/technetwork/java/index&1)*'%).html
Bouncy castle 1.40
(para jdk 1.5)
http://repo2.maven.org/maven2/org/bonc!castle/
Bouncy castle 1.43
(para jdk 1.5)
http://repo2.maven.org/maven2/org/bonc!castle/
Estas libreras una vez descargadas se deben desplegar en los siguientes directorios:
Mojarra1.2.14
admcomun.war/WEB-INF/lib
admtramites.war/WEB-INF/lib
circeLicenciasWS.war/WEB-INF/lib
circelocal.war/WEB-INF/lib
genforms.war/WEB-INF/lib
portalinterno.war/WEB-INF/lib
carpetaempresariov1.war/WEB-INF/lib
EFacilJnlp.war/WEB-INF/lib
tramitafacil.war/WEB-INF/lib
Toplinkessentials2.0
circeLicenciasWS.war/WEB-INF/lib
ctkGF12WS.war/WEB-INF/lib
EFacilConformacionWS.war/WEB-INF/lib
EFacilERPServices.war/WEB-INF/lib
EFacilFacturaService.war/WEB-INF/lib
EFacilTramitesWS.war/WEB-INF/lib
genforms.war/WEB-INF/lib
portalinterno.war/WEB-INF/lib
services.war/WEB-INF/lib
EFacilJnlp.war/ WEB-INF/lib
AspectJ1.6.7
sso.war/WEB-INF/lib
Saxpath
admineFactura.war/WEB-INF/lib
eFacilDC.war/WEB-INF/lib
eFactura.war/WEB-INF/lib
Javamail1.4.1
circelocal.war/ WEB-INF/lib
Bouncycastle1.40
sso.war/WEB-INF/lib
Bouncycastle1.43
tramitafacil.war/WEB-INF/lib
Metro2.0
Los archivos de Metro 2.0 se despliegan en los directorios de endorsed o
lib de los servidores de aplicaciones:
- Jboss
En el endorsed van: jsr173_api.jar y webservices-api.jar
En el lib de la instancia que est corriendo: webservices-extra-api.jar,
webservices-extra.jar, webservices-rt.jar
- Tomcat
En el lib del servidor: webservices-extra-api.jar,
- Was
En el lib del servidor: webservices-extra-api.jar,
Los archivos de Metro 2.0 tambin van en la aplicacion eFacilDC.war
(eFacilDC/staticContent/lib).
Apndice2 - Relacinentre aplicaciones
De mbito interno (para las entidades):
admcomun.war: corresponde con la administracin comn de la parte de CIRCELocal y
facturacin electrnica.
admineFactura.war: corresponde con la administracin y gestin de la parte de facturacin
electrnica (eFactura.war).
admtramites.war: corresponde con la administracin y gestin de los trmites de empresas
(relacionada con tramitafacil.war, circelocal.war, ctkGF12WS.war y genforms.war).
ctkGF12WS.war: corresponde con el servicio web del generador de formularios. (Relacionada
con admtramites.war y genforms.war).
eFacilConformacionWS.war: corresponde con el servicio web de conformacin de facturas.
(Relacionada con eFactura.war, admineFactura.war).
eFacilDC.war: corresponde con la aplicacin de digitalizacin. (Relacionada con
admineFactura.war y eFactura.war).
eFacilFacturaService.war: corresponde con el servicio web que devuelve los datos de las
facturas digitalizadas y adjuntadas a eFacil en formato pdf. (Relacionada con
admineFactura.war y eFacilDC.war).
genforms.war: corresponde con la aplicacin de generacin de formularios. (Relacionada con
ctkGF12WS.war, tramitafacil.war, admtramites.war).
portalinterno.war: corresponde con la entrada a las aplicaciones internas de administracin y
gestin. (Relacionada con admcomun.war, admineFactura.war, admtramites.war,
eFacilDC.war y genforms.war)
sso.war: corresponde con la aplicacin para el acceso comn a todas las aplicaciones.
(Relacionada con portalinterno.war, admcomun.war, admineFactura.war, eFacilDC.war,
genforms.war, carpetaempresariov1.war, circelocal.war, tramitafacil.war y eFactura.war).
services.war: corresponde con el bus de servicios. (Relacionada con portalinterno.war,
admcomun.war, admtramites.war, admineFactura.war, carpetaempresariov1.war,
tramitafacil.war y eFactura.war).
eFacilJnlp.war: corresponde con la aplicacin web capaz de generar los jnlp de @firma y
envo desatendido al vuelo, utilizando para ello parmetros de configuracin de bases de
datos. (Relacionada con tramitafacil.war, carpetaempresariov1.war y admcomun.war).
eFacilTramitesWS.war: corresponde con el servicio web que actualiza el estado de un
determinado trmite. (Relacionada con tramitafacil.war y admtramites.war).
eFacilERPServices.war: corresponde con el servicio web de conexin con los ERP de las
entidades locales. (Relacionada con admineFactura.war, eFactura.war).
De mbito externo (acceso a los empresarios/emprendedores):
carpetaempresariov1.war: corresponde con la aplicacin que sirve de entrada a las
aplicaciones pblicas, que son: circelocal.war, tramitafacil.war y eFactura.war.
circelocal.war:aplicacin de constitucin de empresas.
eFactura.war: corresponde con la aplicacin de facturacin electrnica para los proveedores.
(Relacionada con admineFactura.war)
sso.war: corresponde con la aplicacin para el acceso comn a todas las aplicaciones.
(Relacionada con portalinterno.war, admcomun.war, admineFactura.war, eFacilDC.war,
genforms.war, carpetaempresariov1.war, circelocal.war, tramitafacil.war y eFactura.war).
tramitafacil.war: corresponde con la aplicacin para solicitar trmites para empresas.
(Relacionada con carpetaempresariov1.war, admtramites.war, genforms.war y
ctkGF12WS.war).
services.war: corresponde con el bus de servicios. (Relacionada con portalinterno.war,
admcomun.war, admtramites.war, admineFactura.war, carpetaempresariov1.war,
tramitafacil.war y eFactura.war).
eFacilJnlp.war: corresponde con la aplicacin web capaz de generar los jnlp de @firma y
envo desatendido al vuelo, utilizando para ello parmetros de configuracin de bases de
datos. (Relacionada con tramitafacil.war, carpetaempresariov1.war y admcomun.war).
circeLicenciasWS.war: corresponde con el servicio web que inserta licencias que son enviadas
desde la aplicacin CIRCE del MITYC (relacionada con circelocal.war y tramitafacil.war).
eFacilERPServices.war: corresponde con el servicio web de conexin con los ERP de las
entidades locales. (Relacionada con admineFactura.war, eFactura.war).
Este es un resumen del texto legal de la licencia completa. Podr obtener el texto
completo en la siguiente direccin de Internet:
http://creativecommons.org/licenses/by-sa/3.0/es/legalcode.es

Manual Instalacion Despliegue v4

Cargado por

Copyright:

Formatos disponibles

Manual Instalacion Despliegue v4

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual Instalacion Despliegue v4

Cargado por

Copyright:

Formatos disponibles

E-Fcil

También podría gustarte