Entregable 9: Manual de Instalación

Para la instalación del wiki "Wiki 4-Proyect Andalucia" tenemos que dar los siguientes pasos que se detallan en el siguiente manual. Primero vamos a observar el diagrama de despliegue para echarle un vistazo general a los elementos y dispositivos necesarios para utilizar nuestro wiki.

Diagrama de despliegue

Diagrama de despliegue

Instalación y configuración de MySQL

Para la Base de Datos de la wiki tendremos que instalar la aplicación MySQL, la hemos empleado como sistema de gestión de bases de datos, ya que es gratuito y potente.

Para instalar y configurar nuestro SGBD, vamos a seguir los siguientes pasos:

1. En primer lugar, debemos descargarnos el programa de instalación. Para ello, vamos a la página http://www.mysql.com y entramos en la sección de descargas (Downloads). La versión que vamos a usar es plenamente funcional y completa, además de gratuita. Seleccionamos la versión MySQL Community Server.

2. Una vez descargado el archivo, comenzamos con su instalación. Al ejecutarlo, nos aparecerála siguiente pantalla:

MySQL1

Seleccionamos el tipo de instalación que queramos hacer, en nuestro caso custom "para configurar las opciones que queremos.

MySQL2

Después de configurarlo, instalamos el programa, pero en la última ventana antes de salir del asistente, nos dan la opción de que sea el propio asistente quien configure la instancia de MySQL con las opciones por defecto. En nuestro caso, desactivamos esta casilla y lo instalamos nosotros mismos.

MySQL3

3. A continuación vamos a configurar la instancia de MySQL. Nos vamos al grupo de programa creado, e iniciamos "MySQL Server Instance Config Wizard".

4. El siguiente paso es escoger entre la configuración Standard o Detailed. La primera es una configuración general, mientras que la segunda nos permite configurar el SGBD a nuestro gusto. Optamos por esta segunda opción.

MySQL5

5. A continuación se nos pregunta qué tipo de servidor vamos a tener. Entre las opciones que nos ofrece, optamos por "Developer Machine", suficiente para nuestro caso.

MySQL6

6. El siguiente punto es escoger el tipo de base de datos a usar. En este caso, vamos a optar por una base de datos Transaccional únicamente (Transactional Database only), ya que nos proporcionará la funcionalidad suficiente para nuestro proyecto.

MySQL7

7. La siguiente pantalla nos pregunta por las opciones de la red: si vamos a usar conexiones externas o únicamente conexiones internas desde nuestra máquina. En nuestro caso, optamos por conexiones externas. Seleccionamos el puerto por el que nos vamos a conectar y le indicamos que cree una excepción para el firewall. También dejamos marcado la opción. "Enable Strict Mode", que ofrece más funcionalidad que un servidor de base de datos sólamente.

MySQL8

8. A continuación le indicamos que instale el servicio del sistema MySQL, que lo inicie automáticamente
cuando encendamos la máquina, y que cree incluya en la variable PATH el directorio de ejecución del servicio para poder llamarlo desde la consola del sistema.

MySQL9

9. A continuación le indicamos que instale el servicio del sistema MySQL, que lo inicie automáticamente
cuando encendamos la máquina, y que cree incluya en la variable PATH el directorio de ejecución del servicio para poder llamarlo desde la consola del sistema.

10. A continuación tendremos que introducir una contraseña para el usuario root (En nuestro caso será "comandog", para que exista conexión entre el wiki y la base de datos a través de hibernate). Y finalmente, si todo ha ido bien, en la siguiente pantalla ejecutará todas las opciones que hemos indicado y configurará nuestro sistema.

Creación de la Base de Datos

Una vez que está instalada la aplicación MySQL, vamos a crearnos nuestra Base de Datos. Aquí se adjuntan los scripts necesarios que se utilizarán para la creación de nuestro wiki.

Primero nos tendremos que dirigir a la consola de MySQL, tendremos que introducir la contraseña que se nos pide "comandog" y crearemos nuestra Base de Datos wiki dando los siguientes pasos (el texto que aparece a continuación, se podrá copiar y pegar directamente en consola o escribirlo en ella):

1. Script para la creación de la base de datos: createdb.sql

drop database if exists wiki;
create database wiki;
use wiki;
commit;

2. Script para la creación de usuarios, páginas y etiquetas, insercción de usuario Admin: insertdb.sql

CREATE TABLE wiki.usuarios (
  login varchar(20) NOT NULL DEFAULT '',
  password varchar(20) NOT NULL,
  rol_usr varchar(2) NOT NULL,
  nombre_usr varchar(30) NOT NULL,
  apellidos_usr varchar(50) NOT NULL,
  email_usr varchar(30) NOT NULL,
  pais_usr varchar(20) DEFAULT NULL,
  ciudad_usr varchar(20) DEFAULT NULL,
  telefono_usr varchar(9) DEFAULT NULL,
  PRIMARY KEY (login)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

CREATE TABLE wiki.paginas (
  id_pagina bigint(20) NOT NULL,
  nombre_pagina varchar(20) NOT NULL,
  descripcion_pagina varchar(50) NOT NULL,
  contenido longtext,
  publicada bit(1) NOT NULL,
  PRIMARY KEY (id_pagina)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

CREATE TABLE wiki.administracion_paginas (
  login varchar(20) NOT NULL,
  id_pagina bigint(20) NOT NULL,
  PRIMARY KEY (`login`,`id_pagina`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

CREATE TABLE wiki.etiquetas (
  id_etiqueta varchar(20) NOT NULL,
  PRIMARY KEY (`id_etiqueta`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

CREATE TABLE wiki.etiquetas_pagina (
  id_pagina bigint(20) NOT NULL,
  id_etiqueta varchar(20) NOT NULL,
  PRIMARY KEY (id_pagina,id_etiqueta)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

insert into wiki.usuarios values
('Administrador','12345','AD','Administrador','Administrador','administrador@wiki.com',null,null,null);

commit;

3. Script para borrar las tablas de usuarios, páginas y etiquetas: cleandb.sql

drop table if exists wiki.usuarios;
drop table if exists wiki.paginas;
drop table if exists wiki.administracion_paginas;
drop table if exists wiki.etiquetas;
drop table if exists wiki.etiquetas_pagina;
commit;

Apache Tomcat 6.0.18

Por último necesitaremos instalar un servidor Web para poder usar nuestra aplicación para ello hemos elegido Apache Tomcat. El proceso de instalación es bastante sencillo:

Visitaremos la página http://apache.tomcat.org e iremos a la sección download versión 6.x
En nuestro caso elegiremos la versión para windows, Windows Service Installer y descargaremos el archivo.

Una vez descargado el archivo le daremos a ejecutar y comenzaremos la instalación.

Para comenzar la instalación pulsamos Next

Tomcat 1

Debermos aceptar la licencia de Tomcat

Tomcat 2

Hay que elegir el directorio donde queramos instalar Tomcat

Tomcat 3

Aquí debemos elegir el puerto por el cual queramos que funcione nuestro servidor, por defecto viene el 8080. Otro punto importante es elegir el usuario y clave para la administración de nuestro servidor Tomcat, eso queda a elección del usuario.

Tomcat 4

Por último debemos proporcionar la ruta donde se encuentra instalado la JVM dentro de nuestra máquina. En caso de no tenerla instalada, pruebe con visitar esta página http://www.java.com/es/download/manual.jsp para descargarlo.

Tomcat 5

Una vez hecho esto ya tenemos instalado apache Tomcat en nuestra máquina, el siguiente y último paso es desplegar nuestra aplicación en el servidor.

Ahora en nuestra barra de tareas que se encuentra la parte inferior derecha de windows aparecerá un icono como éste:

Tomcat 6

Esto significa que nuestro servidor aún no está funcionando, por tanto le daremos al botón derecho y le daremos a Start Service tras lo cual arrancaremos nuestro servidor web. Una vez arrancado nos dirigiremos a nuestro navegador web y escribiremos la siguiente dirección http://localhost:8080 y nos saldrá una pantalla como la siguiente:

Tomcat 7

Tras esto le daremos a Tomcat Manager en el menú de la izquierda y nos aparecerá que introduzcamos el login y el password de administración que hemos puesto en uno de los pasos anteriores para poder acceder a esta sección del sistema. Tras introducirlo nos encontramos en la siguiente página:

Tomcat 8

En este paso nos iremos a la parte inferior de esta página donde pone Seleccione el archivo WAR a cargar: y le daremos a examinar. Nos saldrá un navegador de carpetas en el cual tenemos que buscar el archivo wiki.war que será suministrado a través del sistema de ficheros <FILES> para la entrega final junto con su documento y tras esto le daremos a desplegar. Cuando el servidor termine de desplegar, ya podremos arrancar nuestra aplicación, tan solo escribiendo esta dirección http://localhost:8080/Wiki.

Tomcat 9

A wikear!!