OPENCERTIAC - Documentacion.programador - Plataforma de Desarrollo - Guia de Instalacion

Proyecto cofinanciado por el Ministerio de Industria, Turismo y Comercio dentro del Plan Nacional de Investigacin Cientfica, Desarrollo e Innovacin
Tecnolgica 2004-2007 en el Programa Nacional de Tecnologas de Servicios de la Sociedad de la Informacin y Convocatoria Software de Cdigo Abierto y Publicaciones en Internet. Proyecto cofinanciado por el Fondo Europeo de Desarrollo Regional (FEDER)
Proyecto cofinanciado por el Gobierno del Principado de Asturias a travs del IDEPA en su Programa de Innovacin Empresarial IN+NOVA del ao 2006.
Proyecto cofinanciado por GADD-Grupo Meana, S.A.
PROYECTO
Op e n CERT I A C
Software Abierto de Certificacin Electrnica, Registro Telemtico e Informacin y Atencin Ciudadana
GUA DE INSTALACIN
Versin 1.2 01-06-2007
Proyecto Open CERTIAC Software Abierto de Certificacin Electrnica, Registro Telemtico e Informacin y Atencin Ciudadana
GUA DE INSTALACIN PLATAFORMA c/ Villaverde, n 3 33510 Pola de Siero ASTURIAS Tel: 985 724 949 Fax: 985 724 952 gadd@gmeana.com www.gmeana.com
INDICE
1. INSTALACIN DE LA PLATAFORMA ........................................................................................................ 3 1.1. INSTALACIN DE HERRAMIENTAS DE DESARROLLO ........................................................................................ 3 1.1.1. Instalacin del SDK de desarrollo Java ................................................................................................ 3 1.1.2. Instalacin de CVS................................................................................................................................. 3 1.1.3. Instalacin de Tomcat............................................................................................................................ 6 1.1.4. Instalacin de JBoss .............................................................................................................................. 7 1.1.5. Instalacin de MySQL............................................................................................................................ 7 1.1.6. Instalacin de Eclipse .......................................................................................................................... 11
1.1.6.1. Configuracin de Tomcat con Eclipse ........................................................................................................... 12 1.1.6.2. Configuracin del Repositorio CVS con Eclipse ........................................................................................... 14
1.1.7. Configuracin de la aplicacin para ser desplegada en Tomcat......................................................... 15 1.1.8. Configuracin de HTTPS en Tomcat ................................................................................................... 17 1.1.9. Configuracin del servidor de correo.................................................................................................. 18 1.1.10. Configuracin del Certificado Digital en el Servidor........................................................................ 19 1.1.11. Arranque de la aplicacin en Tomcat ................................................................................................ 19 1.1.12. Configuracin de la aplicacin para ser desplegada en JBoss ......................................................... 19 1.1.13. Configuracin de HTTPS en JBoss.................................................................................................... 21 1.1.14. Arranque de la aplicacin en JBoss................................................................................................... 21 1.1.15. Configuracin de la aplicacin en el servidor JBoss de produccin................................................. 21 1.1.16. Instalacin de iReport........................................................................................................................ 23 2. ANEXOS ............................................................................................................................................................ 23 2.1. EJECUCIN DE TAREAS ANT ......................................................................................................................... 23 2.2. INSTALACIN DE JBOSS COMO SERVICIO WINDOWS EN EL SERVIDOR DE PRODUCCIN ................................ 23
Pg 2 de 24
1. Instalacin de la plataforma
En este documento se explicar paso a paso el proceso de instalacin de la plataforma empezando por la instalacin de las herramientas de desarrollo y terminando por la configuracin de una aplicacin en blanco sobre la que poder desarrollar. 1.1. Instalacin de herramientas de desarrollo
Las herramientas de desarrollo se instalarn a ser posible todas dentro de un mismo directorio en la unidad del disco duro que se prefiera. Para esta gua de instalacin las herramientas se instalarn en C:\desarrollo\java\install
1.1.1. Instalacin del SDK de desarrollo Java

La instalacin del SDK de desarrollo Java se realizar en el equipo del desarrollador y tambin en el servidor de produccin. Para la instalacin del SDK de desarrollo Java se necesitan los siguientes archivos: Archivo
jdk-1_5_0_09windows-i586-p.exe
Descripcin
SDK de desarrollo Java
Direccin
http://java.sun.com/javase/downloads/index.jsp
El primer paso es ejecutar el archivo jdk-1_5_0_09-windows-i586-p.exe y continuar con los pasos por defecto, instalando el SDK en C:\desarrollo\java\install\jdk1.5.0_09. A continuacin hay que generar en Panel de Control Sistema Opciones Avanzadas Variables de Entorno Variables del sistema una nueva variable de entorno JAVA_HOME con valor C:\desarrollo\java\install\jdk1.5.0_09. Tambin se cambiar la variable de entorno PATH aadindole al final ;%JAVA_HOME%\bin para poder ejecutar los programas que se incluyen con el SDK de desarrollo.
1.1.2. Instalacin de CVS La instalacin del CVS se realizar en el equipo que vaya a albergar el repositorio, normalmente este equipo ser un servidor al que tengan acceso los equipos de los desarrolladores, aunque puede ser el equipo de un desarrollador, siempre que los dems tengan acceso a ese equipo. Para la instalacin del CVS se necesitan los siguientes archivos:
Archivo
cvsnt-2.5.03.2260.msi
Descripcin
Servidor y cliente de CVS
Direccin
http://www.march-hare.com/downloads/
El primer paso es ejecutar el archivo cvsnt-2.5.03.2260.msi, seleccionar instalacin tpica y continuar con los pasos por defecto. Al ser CVS un servidor, no hace falta
Pg 3 de 24
instalar CVS en el directorio de desarrollo, dejaremos la ruta de instalacin por defecto en C:\Archivos de programa. Una vez terminada la instalacin iremos a Panel de Control configuraremos los repositorios de la siguiente forma: CVSNT Server y
teniendo el cuenta que el directorio base para el repositorio puede ser el que queramos, en este caso D:/cvs. En Server Settings configuraremos las siguientes opciones:
Pg 4 de 24
las cuales indican que para autenticacin contra el CVS usaremos el usuario del dominio Windows actualmente autenticado en el ordenador. Por ltimo configuraremos las opciones de compatibilidad:
Pg 5 de 24
En este momento ya est todo instalado y configurado para poder usar el repositorio, lo nico que hace falta es generar una carpeta base para subir ficheros al cvs, para ello generaremos en el directorio D:/cvs/cvsrepo una carpeta con el nombre de la aplicacin a desarrollar y que tendr dentro otra carpeta llamada CVS tambin vaca, de la siguiente forma:
1.1.3. Instalacin de Tomcat La instalacin de Tomcat se realizar en el equipo del desarrollador. Se necesitan los siguientes archivos:
Archivo
apache-tomcat5.5.20.zip
Descripcin
Contenedor de servlets Tomcat
Direccin
http://tomcat.apache.org/download-55.cgi
Pg 6 de 24
Para instalar tomcat hay que descomprimir el archivo apache-tomcat-5.5.20.zip en C:\desarrollo\java\install\. Ms adelante se explicar como configurar Tomcat junto con Eclipse y MySQL. 1.1.4. Instalacin de JBoss La instalacin de JBoss se realizar tanto en el equipo del desarrollador como en un servidor para generar versiones de produccin. Se necesitan los siguientes archivos:
Archivo
jboss-4.0.4.GA.zip
Descripcin
Servidor de aplicaciones JBoss
Direccin
http://labs.jboss.com/portal/jbossas/download
Para instalar JBoss hay que descomprimir el archivo jboss-4.0.4GA.zip en C:\desarrollo\java\install\. Ms adelante se explicar como configurar JBoss junto con Eclipse y MySQL. Generaremos en el escritorio dos iconos para iniciar y parar JBoss con las siguientes rutas: JBoss Start JBoss Stop C:\desarrollo\java\install\jboss-4.0.4.GA\bin\run.bat -c default C:\desarrollo\java\install\jboss-4.0.4.GA\bin\shutdown.bat S
Cambiaremos el fichero C:\desarrollo\java\install\jboss-4.0.4GA\bin\run.bat para permitir trazar el programa desde Eclipse. Para ello buscaremos la lnea que comienza por rem set JAVA_OPTS y la cambiaremos por:
set JAVA_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n %JAVA_OPTS%
Arrancaremos el servidor mediante el icono para comprobar que arranca sin problemas.
1.1.5. Instalacin de MySQL La instalacin de MySQL se realizar en un equipo que vaya a ejercer como servidor de base de datos al que tengan acceso los equipos de los desarrolladores. Para la instalacin de MySQL se necesitan los siguientes archivos:
Archivo
mysql-5.0.27win32.zip mysql-gui-tools5.0-r5-win32.msi mysql-connectorodbc-3.51.12win32.msi mysql-connectorjava-3.1.13.tar.gz
Descripcin
Base de datos MySQL MySQL GUI Tools MySQL Connector ODBC
Direccin
http://www.mysql.org/downloads/mysql/5.0.html http://www.mysql.org/downloads/gui-tools/ http://dev.mysql.com/downloads/connector/odbc/3.51.html
MySQL Connector Java
http://dev.mysql.com/downloads/connector/j/3.1.html
Pg 7 de 24
Empezaremos por descomprimir el archivo mysql-5.0.27-win32.zip, a continuacin ejecutaremos el fichero Setup.exe y seleccionaremos instalacin personalizada, cambiando el directorio de instalacin a C:\desarrollo\java\install\MySQL Server 5.0\, seguimos con todas las opciones por defecto y al terminar la instalacin marcamos la casilla Configure MySQL Server now . A continuacin se muestran varias capturas de la configuracin del servidor:
Pg 8 de 24
Pg 9 de 24
Pg 10 de 24
El resto de las pantallas que no se muestran se dejarn con las opciones por defecto. A continuacin instalaremos el ejecutable mysql-gui-tools-5.0-r5-win32.msi en C:\desarrollo\java\install\MySQL Tools for 5.0\. Una vez instalado arrancaremos la aplicacin Mysql Administrator como usuario root, crearemos un usuario admin, que ser al que usemos para acceder a la base de datos cuando desarrollemos, y por ltimo crearemos un nuevo schema para la aplicacin a desarrollar. Instalaremos tambin el siguiente programa en C:\desarrollo\java\install\: mysql-connector-odbc-3.51.12-win32.msi: conector ODBC para poder acceder a la base de datos desde otras aplicaciones Windows. Ms adelante se explicar como configurar el servidor de aplicaciones para poder acceder a la nueva base de datos creada.
1.1.6. Instalacin de Eclipse

Para la instalacin de Eclipse se necesitan los siguientes archivos: Archivo
wtp-all-in-one-sdk-R1.0.2-200604280245win32.zip NLpack1-eclipse-SDK3.1.1a-win32.zip NLpack1_FeatureOverlayeclipse-SDK-3.1.1.zip tomcatPluginV31.zip xmlbuddy_2.0.72.zip
Descripcin
Entorno de desarrollo Eclipse
Direccin
http://download.eclipse.org/webtools/downloads/
Traduccin al espaol de Eclipse Traduccin al espaol de Eclipse Plugin para Eclipse de Tomcat Plugin para Eclipse de edicin de archivos XML
http://download.eclipse.org/eclipse/downloads/drops/L3.1.1_Language_Packs-200510051300/index.php http://download.eclipse.org/eclipse/downloads/drops/L3.1.1_Language_Packs-200510051300/index.php http://www.sysdeo.com/eclipse/tomcatplugin http://xmlbuddy.com/2.0/download.php
El primer paso es descomprimir el fichero wtp-all-in-one-sdk-R-1.0.2-200604280245win32.zip en C:\desarrollo\java\install. A continuacin se descomprimirn los archivos de traduccin al espaol NLpack1-eclipse-SDK-3.1.1a-win32.zip y NLpack1_FeatureOverlayeclipse-SDK-3.1.1.zip en el mismo directorio y por ltimo descomprimiremos los archivos tomcatPluginV31.zip y xmlbuddy_2.0.72.zip en el directorio plugins de eclipse (C:\desarrollo\java\install\eclipse\plugins). A continuacin generaremos en el escritorio un icono para arrancar Eclipse con la siguiente ruta: C:\desarrollo\java\install\eclipse\eclipse.exe -data C:\desarrollo\java\proyectos\ De esta forma le indicamos a eclipse que los proyectos que gestionar el cvs del servidor se encuentran en C:\desarrollo\java\proyectos\ (que deberamos haber creado antes).
Pg 11 de 24
1.1.6.1. Configuracin de Tomcat con Eclipse En las siguientes pantallas se muestra la configuracin del plugin de eclipse para poder arrancar / parar / configurar Tomcat desde Eclipse.
Pg 12 de 24
Una vez configuradas las preferencias de Tomcat podemos arrancar, parar o reiniciar Tomcat desde la barra de herramientas en Eclipse.
Si arrancamos el servidor pinchando en el primer botn podremos ver en la consola de eclipse si Tomcat arranca y los mensajes que va generando.
Pg 13 de 24
1.1.6.2. Configuracin del Repositorio CVS con Eclipse

Para configurar el repositorio CVS en eclipse debemos ir a la opcin de men Ventana Abrir perspectiva Otras y seleccionar Exploracin del repositorio CVS. Aadimos una nueva ubicacin del repositorio de la siguiente forma:
Si hemos introducido correctamente todos los datos nos aparecer en Eclipse una pantalla para explorar el repositorio y traer una copia local del proyecto deseado tal como aparece en la siguiente imagen
Pg 14 de 24
Una vez reservado el proyecto se hace una copia local del contenido del proyecto seleccionado en el servidor y ya podemos trabajar sobre ella. A partir de este momento podemos copiar la aplicacin en blanco sobre el proyecto reservado (dentro de la vista Java) y trabajar sobre ella.
Un paso adicional una vez reservado el proyecto es la creacin de un directorio de trabajo para Tomcat. Para ello iremos a Ventana Abrir perspectiva Java, pincharemos en el proyecto que acabamos de reservar y seleccionaremos Tomcat Project Create JSP Work Directory.
1.1.7. Configuracin de la aplicacin para ser desplegada en Tomcat Para configurar la aplicacin a desarrollar como aplicacin Tomcat deberemos seleccionar en la perspectiva Java nuestra aplicacin y seleccionar preferencias en el men contextual del botn secundario. Debemos configurar las opciones de la siguiente forma:
Pg 15 de 24
Para poder acceder a la base de datos se debe configurar la aplicacin y el contenedor, proceso que conlleva varios pasos:
1. Instalacin del conector de la base de datos en el contenedor. Para ello debemos descomprimir el fichero mysql-connector-java-3.1.13.zip mencionado en la seccin de instalacin de MySQL y renombrar el archivo mysql-connector-java-3.1.13-bin.jar por mysql-connector.jar, copindolo al directorio C:\desarrollo\java\install\ apachetomcat-5.5.20\common\lib. 2. Definicin de un DataSource en el contenedor. Buscaremos en el fichero C:\desarrollo\java\install\apache-tomcat-5.5.20\conf\server.xml la seccin:
<Context path="/opencertiac" reloadable="true" docBase="C:\desarrollo\java\proyectos\opencertiac\webapp" workDir=" C:\desarrollo\java\proyectos\opencertiac\work" />
Y la sustituiremos por:
<Context path="/opencertiac" reloadable="true" docBase="C:\desarrollo\java\proyectos\opencertiac\webapp" workDir="C:\desarrollo\java\proyectos\opencertiac\work"> <Resource name="jdbc/MySQLDSopencertiac" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="100" maxWait="3000" username="admin" password="mipassword" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://arnor:3306/opencertiac?autoReconnect=true"/> </Context>
Pg 16 de 24
Teniendo el cuenta nuestras opciones particulares de configuracin, como nombre del schema, servidor, usuario y password. 3. Definicin de un recurso en la aplicacin. Aadiremos al fichero web.xml de nuestra aplicacin las siguientes lneas dentro de la seccin web-app:
<resource-ref> <res-ref-name>jdbc/MySQLDSopencertiac</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>
4. Configuracin de hibernate para que use el Datasource. En el fichero build.xml (tarea Ant) de nuestra aplicacin en la tarea de generacin de Hibernate debemos modificar el DataSource para que coincida con el declarado en el fichero web.xml de la siguiente forma:
<hibernatecfg version="3.0" destdir="${src.dir}" dataSource="java:comp/env/jdbc/MySQLDSopencertiac" dialect="org.hibernate.dialect.MySQLInnoDBDialect" showSql="true" transactionManagerFactory="org.hibernate.transaction.JDBCTransactionFactory" cacheProviderClass="org.hibernate.cache.HashtableCacheProvider"> <otherProperty name="current_session_context_class" value="org.hibernate.context.ThreadLocalSessionContext" /> <otherProperty name="cache.use_query_cache" value="false" /> <otherProperty name="cache.use_minimal_puts" value="false" /> <otherProperty name="max_fetch_depth" value="3" /> <otherProperty name="format_sql" value="true" /> </hibernatecfg>
Una vez cambiado el fichero ejecutaremos la tarea Ant de Hibernate xdoclet.hibernate para generar el fichero de configuracin.
1.1.8. Configuracin de HTTPS en Tomcat Para la configuracin de HTTPS en Tomcat necesitamos cambiar la ruta de instalacin de Tomcat en el fichero build.xml de la aplicacin:
<property name="tomcat.home" value="C:/desarrollo/java/install/apache-tomcat-5.5.20"/>
A continuacin ejecutaremos la tarea Ant generate.keystore.tomcat la cual nos crear el fichero keystore necesario para HTTPS en C:/desarrollo/java/install/apache-tomcat5.5.20/conf. Por ltimo cambiaremos en el fichero C:\desarrollo\java\install\apache-tomcat5.5.20\conf\server.xml las opciones necesarios para permitir HTTPS:
 <Connector port="8443" maxHttpHeaderSize="8192"
Pg 17 de 24
maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" disableUploadTimeout="true" acceptCount="100" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" keystoreFile="conf\keystore" keystorePass="mipassword" />
1.1.9. Configuracin del servidor de correo

Para poder utilizar los servicios de notificaciones y de envo de correos electrnicos es necesario configurar el mail-service del servidor de aplicaciones Jboss. Se deben cumplir dos requisitos: - Asegurarse de que las libreras mail.jar y activation.jar se encuentran en el directorio lib de la carpeta del servidor donde estemos desplegando la aplicacin. - Configurar el fichero mail-service.xml que se encuentra en la carpeta deploy. En el cuadro siguiente vemos un ejemplo de configuracin:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE server>  <server>    <mbean code="org.jboss.mail.MailService" name="jboss:service=Mail"> <attribute name="JNDIName">java:/Mail</attribute> <attribute name="User">UsuarioAutentificarContraServerCorreo</attribute> <attribute name="Password">PasswdUsuario</attribute> <attribute name="Configuration">  <configuration>  <property name="mail.store.protocol" value="pop3"/> <property name="mail.transport.protocol" value="smtp"/> 
 <property name="mail.pop3.host" value="servidor.pop3.com"/>  <property name="mail.smtp.host" value="servidor.smpt.com"/>    <property name="mail.debug" value="false"/> </configuration> <depends>jboss:service=Naming</depends> </attribute> </mbean> </server>
Pg 18 de 24
1.1.10. Configuracin del Certificado Digital en el Servidor

Cuando un usuario realiza una tramitacin de forma telemtica, esta debe ser firmada por la administracin. Para realizar esta accin, se debe configurar un certificado digital que realice esta accin. Para ello realizaremos las siguientes tareas: Definiremos en BBDD la ruta del almacn de certificados, por ejemplo:
update parametrosconfiguracionsiac p set p.value = '\\\\ARNOR\\CertificadoDigital\\cert_usuario_siac_demo.pfx' where p.key = 'RUTA_CERTIFICADO_DIGITAL_AYTO'
Introduciremos en el fichero de properties (ruta

WEB-INF\classes\es\gadd\opensiac\xmldsig\XMLDigitalSignatureUtils.properties)
los
valores adecuados del certificado:

storePass=Contrasea del almacn de certificados keyPass=Contrasea del certificado alias=En caso de que el almacn contenga ms de un certificado, se indicar aqu. Si no se indica el alias, el programa coger el primero que encuentre. Si el almacn solo dispone de un certificado, no ser necesario introducirlo.
1.1.11. Arranque de la aplicacin en Tomcat Una vez configurada la base de datos y HTTPS podemos arrancar Tomcat y comprobar si la aplicacin se despliega bien.
Para ello arrancamos el servidor pinchando en el primer botn, podremos ver en la consola de eclipse si Tomcat arranca y los mensajes que va generando, una vez que el servidor se inicia iremos a la direccin http://localhost:8080/nuestraaplicacion/ Y comprobaremos que efectivamente la aplicacin arranca correctamente. 1.1.12. Configuracin de la aplicacin para ser desplegada en JBoss Para configurar la aplicacin a desarrollar como desplegable en JBoss necesitamos realizar los siguientes pasos:
3. Instalacin del conector de la base de datos en el contenedor. Para ello debemos descomprimir el fichero mysql-connector-java-3.1.13.zip mencionado en la seccin de
Pg 19 de 24
instalacin de MySQL y renombrar el archivo mysql-connector-java-3.1.13-bin.jar por mysql-connector.jar, copindolo al directorio C:\desarrollo\java\install\jboss4.0.4GA\server\all\lib. 4. Definicin de un DataSource en el contenedor. Para ello crearemos en C:\desarrollo\java\install\jboss-4.0.4GA\server\all\deploy un fichero mysql-ds.xml con el siguiente contenido:
<datasources> <local-tx-datasource> <jndi-name>MySQLDSopencertiac</jndi-name> <connection-url>jdbc:mysql://arnor:3306/opencertiac</connection-url> <driver-class>com.mysql.jdbc.Driver</driver-class> <user-name>admin</user-name> <password>mipassword</password> <min-pool-size>5</min-pool-size> <max-pool-size>20</max-pool-size> <idle-timeout-minutes>5</idle-timeout-minutes> <exception-sorter-classname>com.mysql.jdbc.integration.jboss.ExtendedMysqlExceptionSorter</exception-sorter-classname> <valid-connection-checker-classname>com.mysql.jdbc.integration.jboss.MysqlValidConnectionChecker</valid-connection-checkerclass-name> </local-tx-datasource> </datasources>
Teniendo el cuenta nuestras opciones particulares de configuracin, como nombre del schema, servidor, usuario y password. 5. Definicin de un recurso en la aplicacin. Aadiremos el fichero jboss-web.xml de nuestra aplicacin las siguientes lneas dentro de la seccin jboss-web:
<resource-ref> <res-ref-name>jdbc/MySQLDSopencertiac</res-ref-name> <res-type>javax.sql.DataSource</res-type> <jndi-name>java:MySQLDSopencertiac</jndi-name> </resource-ref>
6. Configuracin de hibernate para que use el Datasource. En el fichero build.xml (tarea Ant) de nuestra aplicacin en la tarea de generacin de Hibernate debemos modificar el DataSource para que coincida con el declarado en el fichero jboss-web.xml y web.xml de la siguiente forma:
<hibernatecfg version="3.0" destdir="${src.dir}" dataSource="java:comp/env/jdbc/MySQLDSopencertiac" dialect="org.hibernate.dialect.MySQLInnoDBDialect" showSql="true" transactionManagerFactory="org.hibernate.transaction.JDBCTransactionFactory" cacheProviderClass="org.hibernate.cache.HashtableCacheProvider"> <otherProperty name="current_session_context_class" value="org.hibernate.context.ThreadLocalSessionContext" /> <otherProperty name="cache.use_query_cache" value="false" /> <otherProperty name="cache.use_minimal_puts" value="false" /> <otherProperty name="max_fetch_depth" value="3" /> <otherProperty name="format_sql" value="true" /> </hibernatecfg>
Pg 20 de 24
Una vez cambiado el fichero ejecutaremos la tarea Ant de Hibernate xdoclet.hibernate para generar el fichero de configuracin.
1.1.13. Configuracin de HTTPS en JBoss Para la configuracin de HTTPS en JBoss necesitamos cambiar la ruta de instalacin del JBoss en el fichero build.xml de la aplicacin:
<property name="jboss.home" value="C:/desarrollo/java/install/jboss-4.0.4GA/server/all"/>
A continuacin ejecutaremos la tarea Ant generate.keystore.jboss la cual nos crear el fichero keystore necesario para HTTPS en C:/desarrollo/java/install/jboss4.0.4GA/server/all/conf. Por ltimo cambiaremos en el fichero C:\desarrollo\java\install\jboss4.0.4GA\server\all\deploy\jbossweb-tomcat55.sar\server.xml las opciones necesarias para permitir HTTPS:
 <Connector port="8443" address="${jboss.bind.address}" maxThreads="100" strategy="ms" maxHttpHeaderSize="8192" emptySessionPath="true" scheme="https" secure="true" clientAuth="false" keystoreFile="${jboss.server.home.dir}/conf/keystore" keystorePass="mipassword" sslProtocol = "TLS" />
1.1.14. Arranque de la aplicacin en JBoss Una vez configurada la base de datos y HTTPS debemos desplegar la aplicacin en JBoss. Para ello son necesarios los siguientes pasos: 1. Desplegar la aplicacin en el servidor. Ejecutaremos la tarea Ant deploy.localhost.jboss que se encargar de generar un war y desplegarlo en el servidor local JBoss si no hay ningn error en la compilacin de los ficheros. 2. Iniciar el servidor mediante el icono creado en el escritorio. 3. Una vez que el servidor se inicia iremos a la direccin http://localhost:8080/nuestraaplicacion/ Y comprobaremos que efectivamente la aplicacin arranca correctamente. 1.1.15. Configuracin de la aplicacin en el servidor JBoss de produccin
Pg 21 de 24
Para configurar la aplicacin a desarrollar como desplegable en el servidor de produccin JBoss necesitamos realizar los siguientes pasos:
1. Cambiar en el build.xml de la aplicacin la propiedad property name="jboss.desa.home" para que indique el directorio del JBoss instalado en el directorio de produccin:
<property name="jboss.desa.home" value="S:\java\install\JBoss_4.0.4.GA\server\all"/>
2. Ejecutar la tarea Ant deploy.desa
Pg 22 de 24
1.1.16. Instalacin de iReport Para la generacin de informes PDF se utiliza la herramienta iReport. Se necesitan los siguientes archivos:
Archivo
iReport-1.2.7.zip
Descripcin
Herramienta de diseo / generacin de informes
Direccin
http://jasperforge.org/sf/projects/ireport
La nica accin a realizar es descomprimir el fichero iReport-1.2.7.zip en C:\desarrollo\java\install\iReport-1.2.7. Para ejecutarlo una vez descomprimido ejecutaremos el archivo C:\desarrollo\java\install\iReport-1.2.7\iReport.bat.
2. Anexos
2.1. Ejecucin de tareas Ant Para la ejecucin de las tareas Ant generadas para la aplicacin es necesario realizar las siguientes pasos: 1. Seleccionar la vista Ant en Eclipse. Para ello vamos a Ventana Mostrar Vista Ant.
2. Agregar a la vista Ant un archivo build.xml mediante el icono +. En este caso el fichero se encuentra en webapp/WEB-INF/src/java.
3. Seleccionar la tarea que se quiere ejecutar y ejecutarla haciendo doble clic con el ratn.
2.2. Instalacin de JBoss como servicio Windows en el servidor de produccin Para la instalacin de JBoss como servicio Windows en el servidor de produccin se necesitan los siguientes archivos:
Archivo Descripcin Direccin
http://javaservice.objectweb.org/ JavaService-2.0.10.zip Herramienta de diseo / generacin de informes
1. Descomprimir el fichero JavaService-2.0.10.zip en un directorio. 2. En el fichero InstallJBoss.bat Cambiar la lnea:

"%jbossexe%" -install JBoss "%jvmdll%" -Djava.class.path="%jbossjar%;%toolsjar%" -Xms64M Xmx128M -start org.jboss.Main -stop org.jboss.Main -method systemExit -out "%JBOSS_HOME%\bin\out.log" -err "%JBOSS_HOME%\bin\err.log" -current "%JBOSS_HOME%\bin" %dependopt% %svcmode% -overwrite -startup 6
por:
Pg 23 de 24
"%jbossexe%" -install JBoss "%jvmdll%" -Djava.class.path="%jbossjar%;%toolsjar%" -Xms256M Xmx1028M XX:maxPermSize=256m -Xdebug Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n -start org.jboss.Main -params "cdefault" -stop org.jboss.Main -method systemExit -out "%JBOSS_HOME%\bin\out.log" -err "%JBOSS_HOME%\bin\err.log" -current "%JBOSS_HOME%\bin" %dependopt% %svcmode% -overwrite startup 6
Se puede cambiar la memoria que usar jBoss as como pasarle parmetros a la mquina virtual de Java como por ejemplo -Xdebug Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n para permitir depurar la aplicacin remtamente. 3. Ejecutar el fichero InstallJBoss.bat. de la siguiente forma: InstallJBoss [depends_on] [-auto / -manual] depends_on sera el servicio del que depende JBoss, podra ser por ejemplo MySQL5, aunque ste parmetro no es obligatorio. -auto / -manual indica si el servicio debe de ser arrancado automticamente o manualmente. ste parmetro es obligatorio. 4. Desde Panel de Control Herramientas Administrativas Servicios podemos comprobar que efectivamente est instalado el servicio JBoss. El servicio se arrancar automticamente la prxima vez que se inicie el sistema, para arrancarlo en este momento pulsaremos el botn Iniciar Servicio.
Pg 24 de 24

OPENCERTIAC - Documentacion.programador - Plataforma de Desarrollo - Guia de Instalacion

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

OPENCERTIAC - Documentacion.programador - Plataforma de Desarrollo - Guia de Instalacion

Enviado por

Direitos autorais:

Formatos disponíveis

Proyecto cofinanciado por el Ministerio de Industria, Turismo y Comercio dentro del Plan Nacional de Investigacin Cientfica, Desarrollo e Innovacin

Proyecto cofinanciado por GADD-Grupo Meana, S.A.

1.1.1. Instalacin del SDK de desarrollo Java

MySQL Connector Java

1.1.6. Instalacin de Eclipse

http://download.eclipse.org/eclipse/downloads/drops/L3.1.1_Language_Packs-200510051300/index.php http://download.eclipse.org/eclipse/downloads/drops/L3.1.1_Language_Packs-200510051300/index.php http://www.sysdeo.com/eclipse/tomcatplugin http://xmlbuddy.com/2.0/download.php

1.1.6.2. Configuracin del Repositorio CVS con Eclipse

1.1.9. Configuracin del servidor de correo

1.1.10. Configuracin del Certificado Digital en el Servidor

Introduciremos en el fichero de properties (ruta

valores adecuados del certificado:

2. Ejecutar la tarea Ant deploy.desa

1. Descomprimir el fichero JavaService-2.0.10.zip en un directorio. 2. En el fichero InstallJBoss.bat Cambiar la lnea:

Você também pode gostar