Herramienta de captura de informacin de especies y especmenes v1.

Manual de instalacin del sistema

Preparado por: Ivette Fernndez

Febrero 2008

Taller: Instalacin y administracin de las herramientas de software desarrolladas por la SSTN. Costa Rica, febrero de 2008

Introduccin

El presente manual contiene una serie de pasos que guiarn al usuario del mismo en la instalacin y configuracin de herramientas requeridas para el funcionamiento de la herramienta de captura de informacin de especies y especmenes v1.0. El documento est dirigido a todos aquellos usuarios que deseen instalar sin complicaciones y de la manera ms simple la herramienta de captura. Pretende que la instalacin sea sencilla y satisfactoria para el usuario del mismo. El manual de instalacin contiene bsicamente cuatro secciones principales en las cuales se instalarn y configurarn respectivamente postgresql, la base de datos (por medio de la herramienta PgAdmin), el servidor de aplicaciones de Java y la configuracin del servidor de aplicaciones. Postresql es un servidor de base de datos relacional open source con mas de quince aos de activo desarrollo. Es la herramienta de cdigo abierto mas utilizada para el manejo de bases de datos en la actualidad ya que dentro de sus caractersticas esta que puede ser instalado sobre varias plataformas, est diseado para ambientes de alto volumen de datos, el cdigo fuente est disponible para todos en forma gratuita de esta forma se puede personalizar o ampliar postgresql con un mnimo de esfuerzo, adems de que sus licencias no tienen ningn costo. Para la administracin y desarrollo de las bases de datos en postgresql, se cre PgAdmin que es un ambiente grfico que nos facilita todo tipo de tarea que debamos realizar en nuestro servidor de base de datos. El servidor de aplicaciones de Java provee estndares que le permiten a un servidor de aplicaciones servir como contenedor de los componentes que conforman dichas aplicaciones. Estos componentes, escritos en lenguaje Java, usualmente se conocen como Servlets, Java Server Pages (JSPs) y Enterprise JavaBeans (EJBs) y permiten implementar diferentes capas de la aplicacin, como la interfaz de usuario, la lgica de negocio, la gestin de sesiones de usuario o el acceso a bases de datos remotas. Java EE5 es la plataforma premier de la industria para la creacin y distribucin de servicios Web empresariales y est muy bien posicionada en la comunidad como la eleccin ms popular para el desarrollo de la tecnologa Java y servicios Web.

Requerimientos
Postgresql Sistema Operativo Linux UNIX (AIX, BSD, HP-UX, SGI IRIX, Mac OS X, Solaris, Tru64) Windows Requerimientos del sistema Espacio disponible en disco: 70 MB (mnimo)

Servidor de aplicaciones de Java Sistema Operativo Solaris 10 and 9 Operating Systems (SPARC Platform Edition) Solaris 10 and 9 Operating Systems (x86 Platform Edition) 64bit Solaris 10 Operating System (on SPARC) 64bit Solaris 10 Operating System (x86) Microsoft Windows XP, 2003, 2000, 2000 Advanced Server Red Hat Enterprise Linux 3.0 and 4.0 Bases de datos soportadas Datadirect driver 3.5 (Type 4) o Oracle 10g, 9i o DB2 8.2, 8.1 o Microsoft SQL Server 2005, 2000 o Sybase ASE 15, 12.5 IBM driver (Type 2) o DB2 8.2, 8.1 MS SQL driver (Type 4) o Microsoft SQL Server 2005, 2000 Derby network client driver o Derby 10.1 MySQL connector/J driver 3.1 o MSSQL 5.0 Postgres driver o Postgres 8.1 Oracle thin driver Oracle 10g, 9i Requerimientos de sistema Memoria: 256 MB Espacio disponible en disco: 250 MB (mnimo)

ndice
Instalacin de Posgresql ................................................................................................... 5 Iniciando la instalacin .................................................................................................. 5 Escoger el idioma de instalacin de postgresql ........................................................ 5 El asistente de instalacin del postgresql nos da la bienvenida. .............................. 6 Notas de instalacin.................................................................................................. 6 Opciones de instalacin ............................................................................................ 7 Configuracin del servicio ......................................................................................... 7 Inicializar el Cluster de la base de datos................................................................... 9 Habilitar lenguajes procedimentales ......................................................................... 9 Habilitar los mdulos contrib ................................................................................... 10 Listo para instalar .................................................................................................... 10 Instalando................................................................................................................ 11 Instalacin completa ............................................................................................... 11 Creacin de la Base de datos en Postgresql .................................................................. 12 Creacin de base de datos ......................................................................................... 14 Creacin del rol ........................................................................................................... 16 Cargar el archivo de la base de datos ........................................................................ 17 Instalar el servidor de aplicaciones y Java (Java EE5 SDK) .......................................... 19 Bienvenida .................................................................................................................. 19 Acuerdo de licencia del software ................................................................................ 20 Seleccionar el directorio de instalacin....................................................................... 20 Configuraciones de administracin ............................................................................. 21 Opciones de instalacin .............................................................................................. 22 Listo para instalar........................................................................................................ 23 Instalando.................................................................................................................... 23 Instalacin completa ................................................................................................... 23 Copiar libreras............................................................................................................ 25 Configuracin del Servidor de Aplicaciones.................................................................... 26 Crear un nuevo pool a la BD....................................................................................... 27 Crear el nuevo recurso de conexin ........................................................................... 31 Cargar archivo EAR (Deploy)...................................................................................... 32

Instalacin de Posgresql
Consideraciones iniciales: El usuario con el cual vamos a instalar el Postgresql debe tener privilegios de administrador.

Iniciando la instalacin

Escoger el idioma de instalacin de postgresql

El asistente de instalacin del postgresql nos da la bienvenida.

Es recomendable que cerremos los dems programas que estemos utilizando para continuar con la instalacin.

Notas de instalacin

En la ventana anterior se presentan notas de instalacin, es importante leerlas antes de continuar con el proceso de instalacin.

Opciones de instalacin

En esta ventana es importante mantener todas las opciones que aparecen predeterminadas. La opcin de PostGIS debe aparecer deshabilitada para la instalacin. En la parte inferior de la ventana se nos muestra la ubicacin donde se guardaran los archivos de instalacin de postgresql. Podemos buscar otra ubicacin, pero es recomendable mantener la que se nos muestra.

Configuracin del servicio

Vamos a realizar la configuracin del servicio, en esta ventana se deben ingresar datos, algunos aparecen predeterminados por lo que es recomendable mantenerlos as. Los que no aparecen llenos debemos ingresarlos, como el password. Al pulsar el botn de Next, se desplegar la siguiente ventana.

El mensaje nos indica que la cuenta que hemos digitado no existe. Adems nos pregunta si queremos crear la cuenta.

Al dar pulsar la opcin Yes se desplegara la siguiente ventana.

El mensaje nos indica que se ha introducido un password con poca seguridad. Nos presenta la opcin de crearnos un password aleatorio. Preferiblemente se debe escoger que no para mantener el password que ya habamos digitado.

Inicializar el Cluster de la base de datos

Vamos a inicializar el cluster de la base de datos. En esta ventana debemos especificar lo siguiente: Port Number: No es necesario modificar el predeterminado.} Addresses: Se debe mantener sin chequear. Locale: C Encoding: UTF-8 Super user name: Puede ser modificado pero preferiblemente mantener el superuser name postgres Password: Se debe introducir un password.

Habilitar lenguajes procedimentales

En esta ventana es necesario chequear la opcin PL/pgsql.

Habilitar los mdulos contrib

En esta ventana, se deben mantener las opciones que aparecen chequeadas predeterminadamente. No es necesario marcar ninguna otra opcin.

Listo para instalar

10

Listo para instalar, solamente debemos pulsar el botn Next y la instalacin dar inicio. Instalando

En esta pantalla se nos muestra el estado de la instalacin.

Instalacin completa

11

Felicitaciones, hemos instalado exitosamente Postgresql. Es recomendable que nos suscribamos en lnea.

Creacin de la Base de datos en Postgresql

Consideraciones iniciales En el momento de nombrar la base de datos o el rol introducir nombres completamente en minscula. preferiblemente solo

Ingresamos en el programa PgAdmin III Pulsamos el botn de Inicio y escogemos todos los programas, luego elegimos la carpeta de Postgresql y por ultimo el programa PgAdmin III.

12

Se desplegara la siguiente interfaz del programa pgAdmin. El la parte izquierda de la pantalla observamos el servidor de PosgreSQL con una equis roja que significa que esta desconectado. Para conectarlo daremos clic derecho en el nombre del servidor y seleccionaremos la opcin connect que se despliega en el men contextual.

Para acceder a la base de datos debemos digitar el password de acceso que definimos durante la instalacin (Inicializar el cluster de la base de datos)

13

Creacin de base de datos

Ya conectados con el servidor, damos clic derecho sobre ella y escogemos la opcin New Database del men contextual.

14

Se desplegara la siguiente ventana

En esta ventana, escogemos la pestaa de properties y digitamos los siguientes datos: Name: ara Owner: Escoger postgres Encoding: UTF8 Ahora nos movemos a la pestaa de privileges

En la seccin de privileges escogemos las siguientes opciones:

15

Role: public Marcamos la opcin ALL Luego se da clic en Add/Change y debe verse de igual manera que la ventana anterior. Por ultimo se da clic en el botn Ok.

Creacin del rol Se debe dar clic derecho en la opcin Login Roles y se escoge New Login Role del men contextual.

Al pulsar esta opcin se desplegara la siguiente ventana

En la pestaa Properties se ingresan datos para los siguientes campos: Role name: ara

16

Password: digitamos un password

Cargar el archivo de la base de datos Para cargar el archivo de la base de datos se debe abrir el rbol del servidor de Postgresql, siguiendo por Databases. Se debe marcar la base de datos ara.

Ahora se debe dar clic en el botn Se desplegara la siguiente ventana.

que aparece en la barra superior de opciones.

17

Se debe dar clic en el men File, la opcin Open. A continuacin se desplegar la siguiente ventana.

Se debe buscar el archivo sql (script) que contiene la configuracin de la base de datos. Una vez marcado el archivo damos clic en Open.

Al realizar esta accin la pantalla debe verse as:

En este momento se procede a ejecutar el archivo sql, as que se debe dar clic en el botn ubicado en el men de opciones de la parte superior de la ventana.

18

Al pulsar este botn, se esta ejecutando el archivo sql de la base de datos. Este paso tomara varios segundos. En la parte inferior de la ventana se mostrara el proceso de la ejecucin del archivo sql.

Cuando el proceso este finalizado, se mostrara un mensaje que indique que hemos concluido satisfactoriamente. Si no de igual manera se mostraran mensajes que nos indiquen algn error.

Instalar el servidor de aplicaciones y Java (Java EE5 SDK)

Damos doble clic en el icono del instalador de Java EE5 JDK

Bienvenida

19

El asistente de bienvenida nos da la bienvenida. Acuerdo de licencia del software

En esta ventana se recomienda leer el acuerdo de licencia del software. Si estamos de acuerdo marcamos Yes.

Seleccionar el directorio de instalacin

20

Se debe elegir la ubicacin de la carpeta de instalacin. Es preferible mantener la carpeta que aparece predeterminada.

Se pregunta si queremos crear el directorio donde se va a instalar ya que el seleccionado no existe. Se debe seleccionar Create Directory.

Configuraciones de administracin

21

Para realizar las configuraciones de administracin, debemos digitar algunas opciones. Por ejemplo admin user name, el password, adems de marcar la opcin Prompt for admin user name and password. Adems de las siguientes opciones: Admin port: 4848 Http port: 8080 Https: 8081 Opciones de instalacin

Se deben marcar las siguientes opciones Register Application Server Add bin directory to Path

22

Create Windows Service

Listo para instalar

Listo para instalar. En esta ventana se resume las opciones que hemos seleccionado para instalar. Para continuar pulsamos el botn Install Now Instalando

Esta ventana nos muestra el estado del proceso de la instalacin. Instalacin completa

23

La instalacin fue exitosa. Podemos hacer una primera prueba levantando el servidor, Para esto se debe dar clic en el botn Start Server.

Se mostrara la siguiente ventana:

Ya levantado el servidor ingresamos en un explorador la siguiente direccin http://localhost:4848

Se desplegara la siguiente ventana:

24

Para ingresar digitamos el usuario y password que se haba ingresado en la pantalla de Configuraciones de administracin.

Copiar libreras Para copiar las libreras primero se debe bajar el servidor. Para esto buscamos en Inicio, programas, Sun Microsistems Para subir el servicio:

Para bajar el servicio

25

El siguiente paso (ya con se servicio abajo) es copiar las libreras que se adjuntaron en el material en la siguiente ubicacin: Luego de copiar estas libreras, se sube nuevamente el servidor.

Configuracin del Servidor de Aplicaciones

26

Acceder nuevamente en el sitio de administracin (http://localhost:4848)

Crear un nuevo pool a la BD Ingresamos a Resourses

Ingresamos a JDBC

En JDBC se ingresa a Connection Pools, y se debe dar clic en New.

27

Al dar clic en Next, se desplegara la siguiente pantalla

Se deben digitar los siguientes datos en los respectivos campos: - Name: PostgresPool - Resource Type: javax.sql.DataSource Luego de haber digitado, damos clic en Next donde aparecer la siguiente ventana.

28

29

Se deben digitar los siguientes datos: General Settings DataSourseClass name: org.postgresql.ds.PGPoolingDataSource

Propierties databaseName: ara serverName: localhost port: 5432 user: ara password: se debe digitar el password que configuramos cuando se cre el rol ara (durante la configuracin en PgAdmin)

30

Crear el nuevo recurso de conexin

Para crear un nuevo recurso de conexin se debe ingresar a JDBC Resources y seguidamente dar clic en New

Al dar clic en New, aparecer la siguiente pantalla

Se deben digitar los siguientes datos: - JNDI Name: jdbc/_Ara - PoolName: PostgresPool

31

Cargar archivo EAR (Deploy)

Para cargar el archivo .ear debemos movilizamos hasta la opcin de Aplications e ingresar a Enterprise Aplications.

Damos clic en la opcin Deploy, seguidamente aparecer la siguiente pantalla:

Debemos marcar la primer opcin (Package to be uploaded to the aplication server) y buscamos la ubicacin del archivo .ear proporcionado en los materiales de instalacin.

32

Ya cargado el archivo damos clic en el botn Next

Cambiamos el nombre de la aplicacin, por ara. Por ltimo damos clic en Finish y cerramos la sesin actual.

Ahora podemos probar que la instalacin haya sido satisfactoria ingresando la siguiente direccin en un explorador: http://localhost:8080/AraWeb/

33

El resultado debe verse as

Si logra visualizar la pantalla anterior, la instalacin del sistema Ara ha sido satisfactoria.

34