Manual de Instalación Grupo Sistemas Informáticos
Departamento de Inteligencia Artificial Facultad de Informática
Universidad Politécnica de Madrid
Manual de Instalación
Proyecto RELAS Coordinadora: Ana García Serrano Belén López Montes Cristina Cruz Aguado Héctor Sanjuán Martín Manuel García Rodríguez Pablo Herrero Quintero Santiago González Tortosa 2005 Sistemas Informáticos – DIA Facultad de Informática - Universidad Politécnica de Madrid Campus de Montegancedo s/n 28660 Boadilla del Monte MADRID (SPAIN)
Esta obra puede ser distribuida únicamente bajo los términos y condiciones expuestos en Creative Commons Reconocimiento-CompartirIgual 2.0 o superior (puede consultarla en http://creativecommons.org/licenses/by-sa/2.0/es/ ).
SSII
DIA – FI – UPM
Página 2
Presentación y Descripción del Sistema
Índice 1
INTRODUCCIÓN ............................................................................................................................5
2
PROGRAMAS NECESARIOS .......................................................................................................5 2.1 2.2
3
PLATAFORMA LINUX..................................................................................................................5 PLATAFORMA WINDOWS ...........................................................................................................7
INSTALACIÓN DEL WEBSITE....................................................................................................9
Página 3
DIA – FI – UPM
SSII
Manual de Instalación
SSII
DIA – FI – UPM
Página 4
Presentación y Descripción del Sistema
1 Introducción El objetivo de este manual es explicar la instalación, en cualquier servidor, de la WebSite del grupo ISYS. Sin ser el objetivo de este manual, en la primera parte se dan una serie de nociones en la instalación y configuración de todas las aplicaciones necesarias para el correcto funcionamiento de nuestra WebSite. En la segunda parte, se explicarán los pasos necesarios para instalar nuestra aplicación en cualquier servidor ya instalado correctamente. Debemos comentar que el sistema es multiplataforma, es decir, pueden ser instalado y configurado en un servidor Linux o en uno Windows (Wn32). A continuación comentamos los programas necesarios para que funcione el sistema RELAS, dividiéndolo según la plataforma.
2 Programas Necesarios 2.1 Plataforma Linux Primeramente, se muestran los enlaces donde se pueden encontrar tanto los paquetes como toda la información para la correcta instalación de todas las aplicaciones necesarias para el correcto funcionamiento de nuestro WebSite. • • • • •
Apache 1.3 / Apache 2.0 Æ www.apache.org Apache_SSL (OPCIONAL) Æ www.apache_ssl.org PHP 4.3.8 / PHP 5.0 Æ www.php.net MySQL 4.0.20 Æ www.mysql.com Ciao 1.10p5 Æ www.clip.dia.fi.upm.es
A través de los siguientes pasos, cabe destacar que se explica la instalación básica de un servidor de páginas web con base de datos MySQL, por lo que recomendamos leer los manuales de las distintas aplicaciones para obtener más detalles sobre la instalación de éstas. Para poder realizar todo el proceso de instalación has de tener acceso como root a la máquina Linux: 1. Debemos hacer un directorio de instalación, aunque lo normal sería que lo hicieramos en /usr/local, /urs/src, o bien en /opt. 2. Una vez tenemos todos los paquetes de instalación, los colocamos en el directorio /root/install y los descomprimimos cd /usr/local tar zxvf /root/install/apache-1.3.x.tar.gz tar zxvf /root/instal/mysql-3.22.x.tar.gz toot/instal/mysql-3.22.x.tar.gz tar zxvf /root/instal/php-3.0.x.tar-gz
3. Crear enlaces sencillos (blandos) a código fuente
Página 5
DIA – FI – UPM
SSII
Manual de Instalación
ln -s /usr/local/apache-1.3.x /usr/local/apache ln -s /usr/local/mysql-3.22.x /usr/local/mysql ln -s /usr/local/php-3.0.x /usr/local/php
4. Preparar las fuentes para la compilación de Apache cd /usr/loca/apache ./configure --prefix=/usr/local/apache
5. Compilar e instalar MySQL cd /usr/local/mysql ./configure --witout-debug --prefix=/usr/local/mysql make make install cp /usr/local/support-files/mysql.server /etc/rc.d/init.d/mysql chmod 755 /etc/rc.d/init.d/mysql
6. Crear la base de datos del sistema MySQL y arrancar el servidor /usr/local/mysql/bin/mysql_install_db /etc/rc.d/init.d/mysql start/etc/rc.d/init.d/mysql start
7. Asignar el paswword del administrador (root) de MySQL /usr/local/mysql/bin/mysqladmin -u root password "clave"
8. Con el paso anterior hemos acabado con MySQL, por lo que ahora compilamos PHP como módulo de Apache cd /usr/local/php ./configure --with-mysql=/usr/local/mysql \ --with-apache=/usr/local/apache \ --enable-track-vars make make install #cp php3.ini-dist /usr/local/lib/php.ini
9. Compilamos Apache cd /usr/local/apache ./configure --prefix=/usr/local/apache \ --activate-module=src/modules/php/libphp.a # si hemos compilado PHP4 utilizaremos #--activate-module=src/modules/php/libphp.a # quitar los comentarios para habilitar el módulo de Proxy #--activate-module=src/modules/proxy/libproxy.a <proxy modules> make make install
SSII
DIA – FI – UPM
Página 6
Presentación y Descripción del Sistema
10. Para definir las extensiones de los scripts PHP, hay que añadir las siguientes líneas en el fichero de configuración de Apache (httpd.conf) AddType application/x-httpd-php .php AddType application/x-httpd-php .php AddType application/x-httpd-php .phtml
11. Ahora sólo queda arrancar el servidor, pero primero realizar una copia del script de arranque en /etc/rc.d/init.d cp /usr/local/apache/bin/apachecte /etc/rc.d/init.d/apache /etc/rc.d/init.d/apache start
2.2 Plataforma Windows Para la plataforma Windows, basta con instalar únicamente dos programas: o o
Apachefriends XAMPP (Apache+PHP+MySQL) Ciao Prolog 1.10
Primeramente, se debe descargar de Intenet el programa gratuito XAMPP (http://www.apachefriends.org/de/projects.html) , actualmente la versión 1.4.13. Seguidamente, para ejecutarlo, seleccionar la opción del menú inicio llamado Xampp Basic Start.
Referido al Sistema Ciao Prolog, el sistema debe instalarse de la siguiente forma: Página 7
DIA – FI – UPM
SSII
Manual de Instalación
SSII
o
Seguir las instrucciones indicadas en el fichero INSTALL.txt
o
Ejecutar el fichero “install.bat” situado en el propio directorio raiz del programa.
o
Copiar el fichero ForEmacs.txt en C:\ y renombrar el fichero a “.emacs”
o
Copiar en el PATH del sistema (Botón derecho de Mi PC / Propiedades / Opciones Avanzadas / Variables de Entorno) el path del compilador Ciaoc (por defecto suele ser C:\ciao-1.10p5Win32\ciaoc)
DIA – FI – UPM
Página 8
Presentación y Descripción del Sistema
3 Instalación del WebSite Una vez tenemos el servidor instalado y configurado, procedemos a instalar el WebSite y para ello, seguimos los siguientes pasos: 1. Descomprimir el fichero “RELAS_v3.0_2005_XX_XX.zip” en un directorio valido para apache (o servidor web) como por ejemplo C:\apachefriends\xampp\xampp\htdocs o /home/login/public_html. Para descomprimir en Linux, basta con utilizar el comando unzip. 2. Asegurarse de que el servidor web tiene permisos de escritura en las carpetas data/xml/ vt/ y private/ (o bien con el comando chmod o bien con los permisos de carpeta de windows) 3. Creación de las bases de datos, para ello necesitamos tener un usuario para MySQL y una base de datos disponible (pasos 6 y 7 instalación del servidor) 4. Ejecutar los scripts de la carpeta db/destroy.sql, “init.sql” y “forum.sql” para limpiar e iniciar la base de datos y las tablas correspondientes. Si queremo tener datos en el sistema, debemos ejecutar el script scripts/create_data.php via web. 5. Para instalar el buscador, dependiendo de la plataforma, ejecutar, dentro del directorio relasearch el comando: o o
“relasearch.bat” en plataformas Win32 “./relasearch &” en plataformas Linux
6. Configurar la web. Para ello, modificar los siguientes datos en el fichero config.php en la carpeta scripts/. <?php /*************************************************************************\ * RELAS - Recursos Lingüísticos para el Acceso Semántico a la Web * * =============================================================== * * Sistemas Informáticos 2004/2005. (ISYS) * * * * http://calma.dia.fi.upm.es/~ssii * * ----------------------------------------------------------------------- * * Copyright (C) 2005 by SSII Group * * * * file : config.php * * author : SSII 2004/2005 Group * * begin : 07/05/2005 * * last update: 10/06/2005 * * description: Set values for some global vars. * * * * TODO * * ==== * * - Add other general config values. * * ----------------------------------------------------------------------- * * This program is free software; you can redistribute it and/or modify it * * under the terms of the GNU General Public License as published by the * * Free Software Foundation; either version 2 of the License, or (at your * * option) any later version. * \*************************************************************************/
Página 9
DIA – FI – UPM
SSII
Manual de Instalación // Set cfg values for install on your server. // Platform $cfg['platform'] = 'win32'; // You can select 'win32' or 'linux' // Initial values. $cfg['inipage'] = 'index.php'; // Initial page of website. $cfg['inilang'] = 'EN'; // Initial language. $cfg['inicss'] = 'blue-minimal.css'; // Initial CSS style. $cfg['iniico'] = 'favicon.ico'; // Initial Web ico. // Directory config options. $cfg['docsrv'] = '/var/www/html/ssii/'; // Server document root. $cfg['docscr'] = 'scripts/'; // General php scripts directory. $cfg['doccss'] = 'theme/'; // CSS styles directory. $cfg['docxml'] = 'data/'; // Data xml directory. $cfg['docxsd'] = 'xml/'; // Schema xsd directory. $cfg['docimg'] = 'img/'; // Images directory. $cfg['docdb'] = 'db/'; // Database scripts directory. // Web server config options. $cfg['wSsrv'] = 'http://localhost/ssii/'; // Web server name. $cfg['w3srv'] = 'http://localhost/ssii/'; // Web server name. // Database server config options. $cfg['dbsrv'] = 'localhost'; // MySQL server name. $cfg['dbpfx'] = 'isys'; // MySQL table prefix. $cfg['dbusr'] = 'ssii'; // MySQL user. $cfg['dbpwd'] = 'ssii'; // MySQL password. $cfg['dbnam'] = 'ssii'; // MySQL database. // Search Engine $cfg['rssrv'] = 'relasearch/'; // Directory of the Search Engine $cfg['query'] = 'consulta.txt'; // File that contains the query
o o o o o o o o o o o o o o o o o o o o o
SSII
platform: plataforma donde va a ejecutarse el sistema. Por defecto es ‘win32’, pero puede ser ‘linux’ tambien. inipage: pagina principal del website inilang: idioma a acceder al inicio de la pagina. Por defecto es en ingles (EN), aunque tambien puede ser en español (ES). inicss: fichero CSS que va a utilizar el sistema. iniico: fichero imagen que el sistema utiliza como fabicon docsrv: directorio root donde se encuentra el sistema docscr: directorio donde se encuentran los scripts doccss: directorio donde se encuentran los ficheros CSS docxml: directorio donde se encuentran los documentos XML docxsd: directorio donde se encuentran l docimg: directorio que contiene las imágenes del sistema docdb: documento que contiene los scripts para la base de datos wSsrv: nombre del servidor web seguro w3srv: nombre del servidor web dbsrv: nombre del servidor de base de datos dbpfx: nombre prefijo de la base de datos dbusr: nombre de usuario dbpwd: contraseña de usuario dbnam: nombre de la base de datos rssrv: directorio donde se encuentra el buscador query: nombre del fichero que contiene una consulta al buscador
DIA – FI – UPM
Página 10