INSTALACIÓN INICIAL SEMANTICWEBBUILDER (SWB) EN SUN GLASSFISH VERSION 2.1 COMPONENTES ESPECIALES Instalación inicial SemanticWebBuilder en Sun Glassfish 2.1 Componentes Especiales Fondo de Información y Documentación para la Industria Av. San Fernando #37 Col. Toriello Guerra Del. Tlalpan México DF El Copyright y las Marcas registradas INFOTEC WebBuilder, SemanticWebBuilder, el personaje Semius y demás logotipos, emblemas y características distintivas, así como elementos relacionados son propiedad de INFOTEC Fondo de Información y Documentación para la Industria, Centro de Investigación CONACYT. Reservados todos los derechos. Queda estrictamente prohibido bajo las sanciones establecidas en las leyes, la reproducción parcial o total de esta obra por cualquier medio o procedimiento de alquiler o préstamos públicos de ejemplares de la misma, sin la autorización escrita de INFOTEC Fondo de Información y Documentación para la Industria, Centro de Investigación CONACYT. Instalación Inicial SemanticWebBuilder Prologo SemanticWebBuilder (SWB) es una plataforma tecnológica desarrollada en INFOTEC, un Centro de Investigación y Desarrollo Tecnológico del CONACYT, por lo que es un producto hecho en México y por mexicanos que tiene como propósito principal el brindar los elementos y utilerías necesarias para permitir una construcción rápida y simple de Sitios y Portales Web Semánticos, así como desarrollo de aplicaciones con características semánticas. La idea principal de aplicar Semántica a los Sitios y Portales Web o mejor dicho incorporarle Semántica a Internet, es permitir que la información pueda ser definida con un significado específico, de forma que conforme se le van incorporando descripciones y propiedades a cada elemento de información este pueda tener más aspectos que lo distingan de los demás y lo puedan identificar mejor, logrando con ello que pueda ser fácilmente consultado, interpretado y procesado ya sea por personas o incluso por otras aplicaciones y sistemas, es decir por maquinas. Esta característica de la semántica que hace que la información tenga un mayor significado y en consecuencia sea fácilmente consultada por personas o sistemas, implica que el intercambio e integración de información sea de forma más natural sin importar el lugar físico donde se encuentre la información o la forma en que haya sido procesada originalmente. Esto implica que podremos realizar una consulta de información y la respuesta será más completa y adecuada a nuestro criterio de búsqueda, pues la fuente de consulta podrá ser leída, interpretada e integrada a partir de la información publicada por diferentes organizaciones, a múltiples niveles técnicos y/o humanos, permitiendo con ello obtener información más completa y adecuada a los requerimientos específicos de cada usuario en la red. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. i Instalación Inicial SemanticWebBuilder Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. ii Instalación 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 Creación 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 Configuración para cargar y levantar SemanticWebBuilder en Sun Glassfish 2.1 .............. 7 Configuraciones del Pool de Conexiones de SemanticWebBuilder. ................................... 9 Levantar SemanticWebBuilder. ........................................................................................ 11 Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. iii Instalación Inicial SemanticWebBuilder Acerca de este manual Este manual fue realizado con el objetivo de explicar el conocimiento mínimo necesario de los procesos para la instalación 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 Específicos: Al finalizar el tema de Instalación inicial SemanticWebBuilder, será capaz de instalar la herramienta en SUN GLASSFISH 2.1 para así poder empezar a crear su sitio Web. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. iv Instalación Inicial SemanticWebBuilder Convenciones usadas en este manual Las siguientes convenciones son utilizadas en este manual para representar diferentes elementos de capacitación 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 operación de las utilerías. Nota – Indica Información adicional que puede ayudarle a aprovechar mejor la funcionalidad expuesta. Referencia – Indica la necesidad de consultar otro documento o dirección Web en donde se encontrara mayor información sobre el tema expuesto. Procedimiento Guiado – Indica que se comenzara la descripción paso a paso de la operación de un proceso. Ejercicio Guiado – A partir de este punto se comenzara la ejecución 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 operación o procedimiento. Diagnostico – Por características de la tecnología involucrada, se generan resultados no deseados. Aquí se indicara como resolverlo. Improcedente – Indica situaciones tecnológicas en las que no es posible realizar una operación o que requiere de algún proceso alterno para obtener el resultado deseado. Cuidado – Indica que existe alguna información restringida o con derechos reservados. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. v Instalación Inicial SemanticWebBuilder Convenciones Tipográficas Arial 26 Negrita, es utilizada como titulo de tema Calibri 14 color Azul Énfasis Negrita, es utilizada para los títulos 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 descripción de configuraciones o código 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 atención Arial 10 en color azul con recuadro azul y sombreado azul, se utiliza para denotar puntos importantes en los que el lector debe prestar atención especial Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. vi Instalación Inicial SemanticWebBuilder Comenzando a trabajar… INTALACIÓN INICIAL SEMANTICWEBBUILDER (SWB) SUN GLASSFISH 2.1 Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. vii Instalación Inicial SemanticWebBuilder Requerimientos Previos Para instalar SemanticWebBuilder (SWB) en SUN GLASSFISH 2.1 necesitará: JDK 1.6 Dicho software se obtiene de la dirección http://www.oracle.com/technetwork/java/javase/downloads/index.html seleccionando la plataforma adecuada en la que realizará la instalación. Para mayor información acerca de cómo instalar el JDK en la plataforma adecuada de su servidor diríjase a: http://www.oracle.com/technetwork/java/javase/systemconfigurations-135212.html Una Base de Datos. Consideraciones Importantes: Para este ejemplo de instalación de SemanticWebBuilder y solo para fines prácticos y explicativos utilizaremos la Base de datos MySQL. 5, sin embargo, SWB se podrá instalar en Base de Datos que se encuentren soportados en los conectores SDB y TDB (para mayor información sobre dichos conectores dirigirse a la documentación de jena http://jena.sourceforge.net/documentation.html), como por ejemplo MySQL >= 5, Oracle 10gR2, SQL Server 2005, etc. SUN GLASSFISH 2.1 Puede conseguir el archivo glassfish-installer_v_2.1.1 en la dirección web http://www.oracle.com/technetwork/middleware/glassfish/downloads/index.html. 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 Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 1 Instalación Inicial SemanticWebBuilder Creación de Base de datos para SemanticWebBuilder Para instalar SemanticWebBuilder se necesita una base de datos y en esta sección crearemos una base de datos llamada “swb”. Consideraciones importantes: Para fines explicativos se utilizará como ejemplo la creación de base de datos en MySQL; sin embargo, SWB se podrá instalar en Base de Datos que se encuentren soportados en los conectores SDB y TDB (para mayor información sobre dichos conectores dirigirse a la documentación del proyecto jena http://jena.sourceforge.net/documentation.html), como por ejemplo MySQL >= 5, 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 contraseña 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 línea “create database swb character SET utf8 COLLATE utf8_general_ci;”. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 2 Instalación 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 línea “show databases;” al darle clic debe de mostrar las base de datos existentes y también la que acaba de crear “swb”. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 3 Instalación Inicial SemanticWebBuilder Configuraciones Configuraciones de Sun Glassfish 2.1 Procedimiento para instalar Sun Glassfish 2.1 1. Abrir la consola de línea 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 instrucción: java -jar -Xmx256m glassfish-installer-v2.1-b60e.jar Resultado El archivo se encontrará desempaquetado Configuraciones de Variables de entorno Configuración 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 jdk. 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. Nota: La configuración de las variables de entorno se realiza dependiendo del sistema operativo que utilices. Resultado Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 4 Instalación Inicial SemanticWebBuilder Dichas variables servirán para el funcionamiento de SWB y Sun Glassfish ahora usted podrá continuar con el siguiente paso para la instalación de SWB. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 5 Instalación Inicial SemanticWebBuilder Levantar Sun Glassfish 2.1 1. Para levantar Sun Glassfish 2.1, dirigirse a la consola de línea de comandos del sistema operativo que estés utilizando, enseguida ir a la siguiente ruta /glassfish escribir la siguiente instrucción “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 instrucción asadmin start-domain domain1 Para mayor información sobre la instalación de GlassFish en su sistema operativo, dirigirse a la documentación correspondiente de Sun GlassFish en la versión y sistema operativo correspondiente. Resultado El aplication server Sun Glassfish 2.1 comenzara a levantar y podrá comenzar a trabajar en el. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 6 Instalación Inicial SemanticWebBuilder Configuración para cargar y levantar SemanticWebBuilder en Sun Glassfish 2.1 Procedimiento Debido a que SemanticWebBuilder usa una Interfaz de programación de aplicaciones, la cual permite accesar a servicios que controlan la autenticación y el acceso de los usuarios, es necesario hacer una configuración 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\ WEB- I NF\ c l as s es 3. Abrir el archivo web.properties Ubicar la línea que diga lo siguiente: Cambiar las líneas /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: \ domai ns \ domai n1\ c onf i g Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 7 Instalación Inicial SemanticWebBuilder 7. Abrir el archivo login.conf y después de la última llave, pegar el contenido del archivo jass.conf. 8. Guardar los cambios en el archivo Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 8 Instalación 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 líneas de hsqldb y des comentar las de mysql. Nota: Para comentar las líneas, se realiza inicializando cada línea con el símbolo “#” y para quitar el comentario de las líneas es quitar el símbolo “#”. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 9 Instalación Inicial SemanticWebBuilder Consideraciones importantes: Si la base de datos fue creada con un usuario y contraseña se debe de agregar dicha información 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 Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 10 Instalación Inicial SemanticWebBuilder Levantar SemanticWebBuilder. Procedimiento. 1. Una vez que arrancaste SUN GLASSFISH 2.1 ir a la consola de administración 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 administración de Sun GlassFish en la cual se debe indicar el usuario y contraseña. Por default GlassFish tiene como usuario admin y contraseña: adminadmin Para mayor información sobre el usuario y contraseña, favor de dirigirse a la documentación correspondiente de Sun GlassFish en la versión que esté utilizando. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 11 Instalación Inicial SemanticWebBuilder 3. Dar clic en Web Application WAR 4. Se visualizara una ventana del lado izquierdo, enseguida dar clic en el botón “deploy”. Para seleccionar el tipo de archivo dar clic en la opción “web application .war”, en la parte de “Location” se selecciona la segunda opción y se da clic en el botón “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 también seria “swb”, en “virtual server” indicar que es “server”, en “status” marcar la opción de “enabled” y ya por ultimo dar clic en el botón “ok”. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 12 Instalación Inicial SemanticWebBuilder 6. La aplicación aparecerá cargada y para entrar a la administración de SemanticWebBuilder, dar clic sobre “launch”. Resultado. 7. Sun Glassfish 2.1 habrá cargado la aplicación SemanticWebBuilder, para poder trabajar en ella dirigirse a la dirección ip del portal creado con la terminación /swb/swbadmin en un navegador de internet (por ejemplo: http://Dirección_IP:Puerto/swb/login/SWBAdmin/home, si es de forma remota, si es de forma local, entonces sería con, http://localhost:Puerto/swb/login/SWBAdmin/home), en el cual le aparecerá la página de logueo. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 13 Instalación Inicial SemanticWebBuilder Se deberá probar el usuario y contraseña 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 Menús de SemanticWebBuilder en la pantalla para empezar a trabajar. Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 14 Instalación Inicial SemanticWebBuilder Fecha de Elaboración: Agosto de 2010. Fecha de Actualización: Febrero 2011 INFOTEC CONACYT FIDEICOMISO. 15