Guía de instalación Fundación I+D del Software Libre Parque Tecnológico de Ciencias de la Salud BIC Granada-CEEI Avda. de la Innovación, 1 18100 Armilla (Granada) Tlf. 958750457 http://www.fidesol.org
SOBRE ESTE DOCUMENTO Título del documento Asceta Responsable Mara Jimenez Nombre del fichero FD_MA-Asceta-Guia Instalacion-v0.5.odt Número de páginas 10 REVISIÓN Versión Descripción Autor Fecha 0.1 Documento inicial: Instalación y configuración del módulo de mediawiki 0.2 Instalación y configuración de los plugins de Wordpress 0.3 Instalación y configuración del módulo Wordpress de Moodle (modwordpress) 0,4 Instalación y configuración del módulo Mediawiki de Moodle (modmediawiki) María del Mar Jiménez Torres Vicente Manuel García Huete Vicente Manuel García Huete María del Mar Jiménez Torres 0.5 Configuración de Redmine Vicente Manuel García Huete 18/05/2011 09/06/2011 30/06/2011 01/07/2011 14/12/2011 Este documento se ha escrito utilizando para su edición y almacenamiento estándares abiertos específicos para documentos ofimáticos (Open Document Format, publicado el 30 de noviembre de 2006 por las organizaciones ISO/IEC como estándar ISO/IEC 26300:2006 Open Document Format for Office Applications (OpenDocument) v1.0.). Las fuentes utilizadas en este documento están extraídas de la Open Font Library (http://openfontlibrary.org/) y cumplen con la licencia Creative Commons (inspirada en la licencia GPL) para la distribución y el uso de contenidos digitales abiertos. Para el texto se ha utilizado la fuente Puritan 2.0: http://openfontlibrary.org/files/benweiner/259 Para títulos, tablas, ilustraciones, etc. se ha utilizado la fuente Jura: http://openfontlibrary.org/files/daniel_j/98 Para el código fuente se ha usado la letra FreeMono: http://ftp.gnu.org/gnu/freefont/freefont-ttf-20100919.tar.gz Las imágenes utilizadas en este documento también cumplen con la licencia Creative Commons. Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 2
Contenido Introducción...4 Prerrequisitos...4 MediaWiki...4 Wordpress...4 Moodle...4 Instalación y configuración del módulo de MediaWiki...5 Descarga del código...5 Instalación del módulo...5 Configuración del módulo...5 Creación de las tablas para Oauth en la base de datos de mediawiki...5 Prueba...5 Instalación y configuración de los plugins de Wordpress...6 Prerrequisitos...6 Descarga del código...6 Instalación de los plugins...6 Configuración de los plugins...6 Prueba...7 Instalación y configuración del módulo Wordpress de Moodle...7 Prerrequisitos...7 Descarga del código...8 Instalación del módulo en Moodle...8 Configuración del módulo...8 Prueba...8 Instalación y configuración del módulo Mediawiki de Moodle...8 Prerrequisitos...8 Descarga del código...9 Instalación del módulo en Moodle...9 Configuración del módulo...9 Prueba...9 Configuración de Redmine...10 Configuración del servicio REST en Redmine...10 Prueba...10 Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 3
Introducción Introducción Este documento tiene como objetivo describir la instalación de los módulos creados para el proyecto Asceta. Para ello se describe el procedimiento a seguir para la instalación y configuración, en primer lugar de los módulos de los servicios externos (Wordpress y Mediawiki), y por último el módulo de PHP desarrollado para Moodle. Prerrequisitos Este manual se ha realizado sobre una máquina con el sistema Ubuntu Linux 11.04. Los servicios externos, así como Moodle deben estar previamente instalados y funcionando correctamente. MediaWiki http://www.mediawiki.org/wiki/manual:installation_guide/es Wordpress http://ayudawordpress.com/como-instalar-wordpress-paso-a-paso/ Moodle http://docs.moodle.org/es/instalaci%c3%b3n_de_moodle Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 4
Instalación y configuración del módulo de MediaWiki Instalación y configuración del módulo de MediaWiki Descarga del código La descarga del código del módulo se debe realizar mediante el repositorio subversion del proyecto, para descargarlo basta con ejecutar: svn co http://svn.fidesol.org/svn/asceta/mw-restful/ Instalación del módulo Se deberá copiar el directorio del módulo dentro del directorio /extensions de mediawiki cp -R /mw-restful /var/www/mediawiki/extensions/ Configuración del módulo Se deberá configurar el archivo mediawiki/localsettings.php, indicando el nuevo módulo añadido, se añade la siguiente línea al final del documento: require_once("$ip/extensions/mw-restful/asceta.php"); Realizados los cambios se reiniciará el servidor Apache /etc/init.d/apache2 restart Creación de las tablas para Oauth en la base de datos de mediawiki En el fichero mw-restful/lib/library/store/mysql/install.php hay un script, el cuál se usará para crear e inicializar las tablas necesarias para el protocolo de autorización segura de un API, Oauth. Prueba Para probar que el módulo está instalado, deberemos abrir el navegador y cargar el mediawiki, en el menú de la izquierda dentro de la sección Herramientas, deberá aparecer un enlace que sea Asceta. Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 5
Instalación y configuración de los plugins de Wordpress Instalación y configuración de los plugins de Wordpress Prerrequisitos Para el correcto funcionamiento de los plugins, el sistema deberá tener instalado el paquete: php5-curl Además el servidor web Apache deberá tener activados los siguientes módulos: headers rewrite Descarga del código La descarga del código del módulo se debe realizar mediante el repositorio subversion del proyecto, para descargarlo basta con ejecutar: svn co http://svn.fidesol.org/svn/asceta/wp-restful/ svn co http://svn.fidesol.org/svn/asceta/wp-restful-users/ Instalación de los plugins Se deberá copiar los directorios del módulo dentro del directorio /wp-content/plugins de wordpress cp -R /wp-restful /var/www/wordpress/wp-content/plugins/ cp -R /wp-restful-users /var/www/wordpress/wp-content/plugins/ Tras esto habrá que activar los plugins en el panel de administración de Wordpress. Primero se activará wp-restful y posteriormente wp-restful-users. Configuración de los plugins La configuración de los plugins se realizará en el menú WP-RESTful, del panel de administración de Wordpress. Se accederá al submenú Server y se establecerán las siguientes opciones: Administración WP-RESTful Server Server active: ON Allowed Return Types: XML y/o JSON Allowed Information: Todo seleccionado Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 6
Instalación y configuración de los plugins de Wordpress Tras esto se salvarán las opciones pulsando el botón Save Options. A continuación se accederá a Ajustes y al submenú Enlaces permanentes. Se seleccionará Estructura personalizada y se establecerá a: Administración Ajustes Enlaces permanentes Estructura personalizada /%postname%/ Crearemos el archivo.htaccess, en la carpeta de Wordpress, con el siguiente contenido: wordpress/.htaccess <IfModule mod_rewrite.c> RewriteEngine On RewriteBase /wordpress/ RewriteRule ^index\.php$ - [L] RewriteCond %{REQUEST_FILENAME}!-f RewriteCond %{REQUEST_FILENAME}!-d RewriteRule. /wordpress/index.php [L] </IfModule> Por último se creará una nueva página accediendo al menú Páginas y submenú Añadir nueva: Administración Páginas Añadir nueva Título: api Contenido: [REST_return] Prueba Para probar que el módulo está instalado, deberemos abrir el navegador y cargar el Wordpress, acceder como usuario en Wordpress, en el menú de la izquierda deberá aparecer un enlace que sea WP-RESTful. Instalación y configuración del módulo Wordpress de Moodle Prerrequisitos Para el correcto funcionamiento de los plugins, el sistema deberá tener instalado el paquete: php5-curl Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 7
Instalación y configuración del módulo Wordpress de Moodle Descarga del código La descarga del código del módulo se debe realizar mediante el repositorio subversion del proyecto, para descargarlo basta con ejecutar: svn co http://svn.fidesol.org/svn/asceta/modwordpress/ Instalación del módulo en Moodle Se deberá copiar los directorios del módulo dentro del directorio /mod/ de Moodle cp -R /modwordpress /var/www/moodle/mod/ Para completar la instalación se accederá en Moodle, como administrador, a la sección Site Administration Notifications Y seguiremos el proceso guiado de actualización de módulos.ers. Configuración del módulo La configuración del módulo se realiza en el apartado de aministración de plugins de actividades: Site Administration Plugins Activity Modules Wordpress Para indicaciones más detalladas sobre la configuración del módulo, consulte el apartado Configuración del plugin modwordpress, en la página 19 del Manual de Usuario de ASCETA. Prueba Para probar que el módulo está instalado comprobaremos que aparece la actividad Wordpress en el desplegable de nueva actividad en un curso. Instalación y configuración del módulo Mediawiki de Moodle Prerrequisitos Para el correcto funcionamiento de los plugins, el sistema deberá tener instalado el paquete: Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 8
Instalación y configuración del módulo Mediawiki de Moodle php5-curl Descarga del código La descarga del código del módulo se debe realizar mediante el repositorio subversion del proyecto, para descargarlo basta con ejecutar: svn co http://svn.fidesol.org/svn/asceta/modmediawiki/ Instalación del módulo en Moodle Se deberá copiar los directorios del módulo dentro del directorio /mod/ de Moodle cp -R /modmediawiki /var/www/moodle/mod/ Para completar la instalación se accederá en Moodle, como administrador, a la sección Site Administration Notifications Y seguiremos el proceso guiado de actualización de módulos.ers. Configuración del módulo La configuración del módulo se realiza en el apartado de aministración de plugins de actividades: Site Administration Plugins Activity Modules Mediawiki Para indicaciones más detalladas sobre la configuración del módulo, consulte el apartado Configuración del plugin modmediawiki, del Manual de Usuario de ASCETA. Prueba Para probar que el módulo está instalado comprobaremos que aparece la actividad Mediawiki en el desplegable de nueva actividad en un curso. Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 9
Configuración de Redmine Configuración de Redmine Configuración del servicio REST en Redmine La activación del servicio REST, en Redmine, se realiza accediendo a: Administracion Configuración Autenticación Activar servicio web REST Una vez activado el servicio REST, si también se ha activado Se requiere identificación, la API KEY de acceso a las peticiones REST, se puede obtener en: Mi cuenta Clave de acceso a la API Prueba Para probar que el servicio REST está activado correctamente, accederemos a la dirección de Redmine, añadiendo /users.xml http://{direccion_redmine}/users.xml Habrá que añadir la API KEY antes de la dirección, en caso de requerir identificación y no estarlo: http://{api_key}:@{direccion_redmine}/users.xml Obtendremos un resultado similar a este: <users type="array" total_count="1" offset="0" limit="25"> <user> <id>1</id> <login>admin</login> <firstname>redmine</firstname> <lastname>admin</lastname> <mail>admin@example.net</mail> <created_on>2011-10-03t11:17:39+02:00</created_on> <last_login_on>2011-12-19t12:41:37+01:00</last_login_on> </user> </users> Av. Innovación 1 Edificio BIC Parque Tecnológico de las Ciencias de la Salud 18100 Armilla (Granada) TLF- 958 750 457 10