INSTALACIN INICIAL SEMANTICWEBBUILDER (SWB) EN SUN GLASSFISH VERSION 2.

COMPONENTES ESPECIALES

Instalacin inicial SemanticWebBuilder en Sun Glassfish 2.1

Componentes Especiales

Fondo de Informacin y Documentacin para la Industria

Av. San Fernando #37 Col. Toriello Guerra Del. Tlalpan Mxico DF

El Copyright y las Marcas registradas INFOTEC WebBuilder, SemanticWebBuilder, el personaje Semius y dems logotipos, emblemas y caractersticas distintivas, as como elementos relacionados son propiedad de INFOTEC Fondo de Informacin y Documentacin para la Industria, Centro de Investigacin CONACYT. Reservados todos los derechos. Queda estrictamente prohibido bajo las sanciones establecidas en las leyes, la reproduccin parcial o total de esta obra por cualquier medio o procedimiento de alquiler o prstamos pblicos de ejemplares de la misma, sin la autorizacin escrita de INFOTEC Fondo de Informacin y Documentacin para la Industria, Centro de Investigacin CONACYT.

Instalacin Inicial SemanticWebBuilder

Prologo
SemanticWebBuilder (SWB) es una plataforma tecnolgica desarrollada en INFOTEC, un Centro de Investigacin y Desarrollo Tecnolgico del CONACYT, por lo que es un producto hecho en Mxico y por mexicanos que tiene como propsito principal el brindar los elementos y utileras necesarias para permitir una construccin rpida y simple de Sitios y Portales Web Semnticos, as como desarrollo de aplicaciones con caractersticas semnticas. La idea principal de aplicar Semntica a los Sitios y Portales Web o mejor dicho incorporarle Semntica a Internet, es permitir que la informacin pueda ser definida con un significado especfico, de forma que conforme se le van incorporando descripciones y propiedades a cada elemento de informacin este pueda tener ms aspectos que lo distingan de los dems y lo puedan identificar mejor, logrando con ello que pueda ser fcilmente consultado, interpretado y procesado ya sea por personas o incluso por otras aplicaciones y sistemas, es decir por maquinas. Esta caracterstica de la semntica que hace que la informacin tenga un mayor significado y en consecuencia sea fcilmente consultada por personas o sistemas, implica que el intercambio e integracin de informacin sea de forma ms natural sin importar el lugar fsico donde se encuentre la informacin o la forma en que haya sido procesada originalmente. Esto implica que podremos realizar una consulta de informacin y la respuesta ser ms completa y adecuada a nuestro criterio de bsqueda, pues la fuente de consulta podr ser leda, interpretada e integrada a partir de la informacin publicada por diferentes organizaciones, a mltiples niveles tcnicos y/o humanos, permitiendo con ello obtener informacin ms completa y adecuada a los requerimientos especficos de cada usuario en la red.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

ii

Instalacin Inicial SemanticWebBuilder

ndice de Contenidos

Prologo ............................................................................................................................... i ndice de Contenidos ......................................................................................................... iii Acerca de este manual ...................................................................................................... iv Objetivos............................................................................................................................ iv Convenciones usadas en este manual .............................................................................. v Comenzando a trabajar ................................................................................................. vii Requerimientos Previos ..................................................................................................... 1 Creacin de Base de datos para SemanticWebBuilder ...................................................... 2 Configuraciones ................................................................................................................. 4 Configuraciones de Sun Glassfish 2.1 ............................................................................ 4 Configuraciones de Variables de entorno ....................................................................... 4 Levantar Sun Glassfish 2.1 ................................................................................................ 6 Configuracin para cargar y levantar SemanticWebBuilder en Sun Glassfish 2.1 .............. 7 Configuraciones del Pool de Conexiones de SemanticWebBuilder. ................................... 9 Levantar SemanticWebBuilder. ........................................................................................ 11

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

iii

Instalacin Inicial SemanticWebBuilder

Acerca de este manual

Este manual fue realizado con el objetivo de explicar el conocimiento mnimo necesario de los procesos para la instalacin de SemanticWebBuilder en SUN GLASSFISH 2.1

Objetivos
General: Al finalizar el manual conocer la forma adecuada de instalar SemanticWebBuilder en SUN GLASSFISH 2.1 Especficos: Al finalizar el tema de Instalacin inicial SemanticWebBuilder, ser capaz de instalar la herramienta en SUN GLASSFISH 2.1 para as poder empezar a crear su sitio Web.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

iv

Instalacin Inicial SemanticWebBuilder

Convenciones usadas en este manual

Las siguientes convenciones son utilizadas en este manual para representar diferentes elementos de capacitacin y recursos alternativos de aprendizaje: Iconos Sabias Que Indica comentarios al margen en los que se extender el tema expuesto mediante recomendaciones o tips que mejoren el aprovechamiento de la herramienta Consideraciones Importantes Exponen puntos importantes que deben tenerse en cuenta para la correcta operacin de las utileras. Nota Indica Informacin adicional que puede ayudarle a aprovechar mejor la funcionalidad expuesta. Referencia Indica la necesidad de consultar otro documento o direccin Web en donde se encontrara mayor informacin sobre el tema expuesto. Procedimiento Guiado Indica que se comenzara la descripcin paso a paso de la operacin de un proceso. Ejercicio Guiado A partir de este punto se comenzara la ejecucin de un ejercicio que deber realizar el usuario de manera guiada paso a paso con el manual. Resultado Expone el efecto final correcto de una operacin o procedimiento. Diagnostico Por caractersticas de la tecnologa involucrada, se generan resultados no deseados. Aqu se indicara como resolverlo. Improcedente Indica situaciones tecnolgicas en las que no es posible realizar una operacin o que requiere de algn proceso alterno para obtener el resultado deseado. Cuidado Indica que existe alguna informacin restringida o con derechos reservados.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Convenciones Tipogrficas

Arial 26 Negrita, es utilizada como titulo de tema

Calibri 14 color Azul nfasis Negrita, es utilizada para los ttulos de tema
Calibri 12 color Azul nfasis 1 negrita, es utilizada para destacar subtemas Arial 11, es utilizada como fuente principal para el cuerpo del texto <Times New Roman 11> es utilizada para descripcin de configuraciones o cdigo

Arial 10 negrita color azul con recuadro y sombreado azul indica temas a resaltar y/o puntos importante en los que el lector debe prestar especial atencin Arial 10 en color azul con recuadro azul y sombreado azul, se utiliza para denotar puntos importantes en los que el lector debe prestar atencin especial

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

vi

Instalacin Inicial SemanticWebBuilder

Comenzando a trabajar

INTALACIN INICIAL SEMANTICWEBBUILDER (SWB) SUN GLASSFISH 2.1

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

vii

Instalacin Inicial SemanticWebBuilder

Requerimientos Previos Para instalar SemanticWebBuilder (SWB) en SUN GLASSFISH 2.1 necesitar:
JDK 1.6

Dicho software se obtiene de la direccin http://java.sun.com/javase/downloads/index.jsp seleccionando la plataforma adecuada en la que realizar la instalacin. Para mayor informacin acerca de cmo instalar el JDK en la plataforma adecuada de su servidor dirjase a: http://java.sun.com/javase/6/webnotes/install/systemconfigurations.html

Una Base de Datos. Consideraciones Importantes: Para este ejemplo de instalacin de SemanticWebBuilder y solo para fines prcticos y explicativos utilizaremos la Base de datos MySQL. 5, sin embargo, SWB se podr instalar en Base de Datos que soporten conexiones de tipo DBC y TDB, como por ejemplo, Oracle 10gR2, SQL Server 2005, etc.

SUN GLASSFISH 2.1 Puede conseguir el archivo glassfish-installer_v_2.1.1 en la direccin web https://glassfish.dev.java.net/public/downloadsindex.html#top. El archivo obtenido se transfiere a la ruta y/o carpeta donde se descomprimir dicho archivo.

SWB Descargar el archivo de http://www.semanticwebbuilder.org.mx, el archivo obtenido es swb.war.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Creacin de Base de datos para SemanticWebBuilder

Para instalar SemanticWebBuilder se necesita una base de datos y en esta seccin crearemos una base de datos llamada swb.

Consideraciones importantes: Para este ejemplo de instalacin de SemanticWebBuilder y solo para fines prcticos y explicativos utilizaremos la Base de datos MySQL. 5, sin embargo, SWB se podr instalar en Base de Datos que soporten conexiones de tipo DBC y TDB, como por ejemplo, Oracle 10gR2, SQL Server 2005, etc.

Procedimiento para crear una base de datos dentro de MySQL

1. Conectarse a MySQL por medio de la consola del sistema operativo que est usando, no olvide teclear la contrasea que se configur al instalar MySQL (solo en el caso de que se haya configurado una) y presionar enter:

2. Crear una base de datos llamada swb con la lnea create database swb character SET utf8 COLLATE utf8_general_ci;.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Resultado
Al darle clic le saldr la leyenda Query OK, 1 row affected <0,00 sec> esto nos indicar que la base de datos ha sido creada. Para confirmar que la base de datos fue creada ejecutamos la lnea show databases; al darle clic debe de mostrar las base de datos existentes y tambin la que acaba de crear swb.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Configuraciones

Configuraciones de Sun Glassfish 2.1

Procedimiento para instalar Sun Glassfish 2.1

1. Abrir la consola de lnea de comandos del sistema operativo 2. Dirigirse a la ruta donde desea descargar el Sun Glassfish 2.1 3. Copiar el archivo glassfish-installer-v2.1-b60e.jar 4. Desempaquetar el archivo con la siguiente instruccin: java -jar -Xmx256m glassfish-installer-v2.1-b60e.jar

Nota: El comando java jar para fines prcticos de este manual se utiliza solo en sistema operativo Windows, por tal motivo deber usar el comando equivalente al Sistema operativo que se esta usando.

Resultado
El archivo se encontrar desempaquetado

Configuraciones de Variables de entorno

Configuracin de las variables de ambiente.

1. Configurar la variable JAVA_HOME, en el valor de dicha variable debemos agregar la ruta completa donde se instalo java. 2. Configurar la variable ANT_HOME en el valor de dicha variable se debe de poner el directorio donde se desempaqueto Sun Glassfish seguido de la siguiente ruta \glassfish\lib\ant.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Nota: La configuracin de las variables de entorno se realiza dependiendo del sistema operativo que utilices.

Resultado
Dichas variables servirn para el funcionamiento de SWB y Sun Glassfish ahora usted podr continuar con el siguiente paso para la instalacin de SWB.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Levantar Sun Glassfish 2.1

1. Para levantar Sun Glassfish 2.1, dirigirse a la consola de lnea de comandos del sistema operativo que ests utilizando, enseguida ir a la siguiente ruta /glassfish escribir la siguiente instruccin lib/ant/bin/ant -f setup.xml

Nota. El paso uno solo se realizar la primera vez que instalas Glassfish 2.1 en caso de que no sea as solo realiza el paso 2.

2. Situarse en la ruta /glassfish/bin y posterior a esto poner la siguiente instruccin asadmin start-domain domain1

Para mayor informacin sobre la instalacin de GlassFish en su sistema operativo, dirigirse a la documentacin correspondiente de Sun GlassFish en la versin y sistema operativo correspondiente.

Resultado
El aplication server Sun Glassfish 2.1 comenzara a levantar y podr comenzar a trabajar en el.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Configuracin para cargar y levantar SemanticWebBuilder en Sun Glassfish 2.1

Procedimiento
Debido a que SemanticWebBuilder usa una Interfaz de programacin de aplicaciones, la cual permite accesar a servicios que controlan la autenticacin y el acceso de los usuarios, es necesario hacer una configuracin especial para que en el momento de autenticarse en la consola de Sun Glassfish, no existan problemas de acceso. 1. Se deber desempaquetar el contenido del archivo swb.war en una carpeta llamada swb. 2. Una vez realizado el paso anterior situarse dentro de la siguiente ruta:
\ s wb\ W I NF\ c l as s es EB-

3. Abrir el archivo web.properties

Ubicar la lnea que diga lo siguiente:

Cambiar las lneas /jass.conf por ignore como se muestra en la siguiente imagen:

4. Guardar los cambios realizados en el archivo 5. En la misma ruta, abrir el archivo jass.conf y copiar todo el contenido del archivo. 6. Situarse en el directorio donde se encuentre instalado Sun Glassfish y entrar a la siguiente ruta:
\ dom ns \ dom n1\ c onf i g ai ai

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

7. Abrir el archivo login.conf y despus de la ltima llave, pegar el contenido del archivo jass.conf. 8. Guardar los cambios en el archivo

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Configuraciones del Pool de Conexiones de SemanticWebBuilder.

Procedimiento.
1. Colocarse en el directorio donde se encuentra la carpeta de SWB.
\ s wb

2. Cambiarse al directorio binario classes que se encuentra dentro de swb/WEBINF/classes. 3. Abrir el archivo db.properties. 4. Configurar el archivo db.properties para que apunte a la base de datos creada. En este caso la base de datos tiene como nombre swb; por lo que se debe de comentar las lneas de hsqldb y des comentar las de mysql.

Nota: Para comentar las lneas, se realiza inicializando cada lnea con el smbolo # y para quitar el comentario de las lneas es quitar el smbolo #.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

Instalacin Inicial SemanticWebBuilder

Consideraciones importantes: Si la base de datos fue creada con un usuario y contrasea se debe de agregar dicha informacin en este archivo (en las lineas wb.user=xxx, wb.password=xxx, de la base de datos correspondiente, en este caso MySQL).

5. Guardar el archivo.

Resultado.
El archivo db.properties guardar los cambios hechos y el portal responder con la base de datos MySQL.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

10

Instalacin Inicial SemanticWebBuilder

Levantar SemanticWebBuilder.

Procedimiento.
1. Una vez que arrancaste SUN GLASSFISH 2.1 ir a la consola de administracin poniendo en cualquier browser http://localhost:4848.

Nota: El puerto por default en el cual se levanta SUN GLASSFISH es el 4848, por tal motivo es necesario verificar que no est ocupado o en su caso configurar el puerto que se requiere. 2. Observara la consola de administracin de Sun GlassFish en la cual se debe indicar el usuario y contrasea. Por default GlassFish tiene como usuario admin y contrasea: adminadmin Para mayor informacin sobre el usuario y contrasea, favor de dirigirse a la documentacin correspondiente de Sun GlassFish en la versin que est utilizando.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

11

Instalacin Inicial SemanticWebBuilder

3. Dar clic en Web Application WAR

4. Se visualizara una ventana del lado izquierdo, enseguida dar clic en el botn deploy. Para seleccionar el tipo de archivo dar clic en la opcin web application .war, en la parte de Location se selecciona la segunda opcin y se da clic en el botn Browse Files en la cual se indica la ruta donde se tiene la carpeta de SWB.

5. En el apartado de name application se escribe swb, seguido del context root el cual tambin seria swb, en virtual server indicar que es server, en status marcar la opcin de enabled y ya por ultimo dar clic en el botn ok.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

12

Instalacin Inicial SemanticWebBuilder

6. La aplicacin aparecer cargada y para entrar a la administracin de SemanticWebBuilder, dar clic sobre launch.

Resultado.
7. Sun Glassfish 2.1 habr cargado la aplicacin SemanticWebBuilder, para poder trabajar en ella dirigirse a la direccin ip del portal creado con la terminacin /swb/swbadmin en un navegador de internet (por ejemplo: http://Direccin_IP:Puerto/swb/login/SWBAdmin/home, si es de forma remota, si es de forma local, entonces sera con, http://localhost:8080/swb/login/SWBAdmin/home), en el cual le aparecer la pgina de logueo.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

13

Instalacin Inicial SemanticWebBuilder

Se deber probar el usuario y contrasea de default (admin / webbuilder) y seleccionar entrar.

8. Por ltimo se deber esperar a que aparezca los Acordeones de Estructura, la Zona de Trabajo y la Barra de Mens de SemanticWebBuilder en la pantalla para empezar a trabajar.

Fecha de Elaboracin: Marzo de 2009. INFOTEC CONACYT FIDEICOMISO.

14