Instalación de Dokeos en un servidor remoto

Dokeos es un paquete de software LMS (Learning Management System), es decir, un gestor de contenidos cuya finalidad específica es el aprendizaje on-line. Se distribuye gratuitamente bajo licencia opensource y puede obtenerse fácilmente descargando el paquete completo desde su web.

En este post relataré la experiencia de instalar el gestor Dokeos 1.8.5, también conocido con el nombre de Valparaiso, en un servidor de alojamiento gratuito, los problemas que encontré y las maniobras que tuve que hacer hasta que la instalación tuvo éxito.

.

a. Requisitos previos

Dokeos necesita para funcionar, como casi todos los gestores de contenidos, un servidor web Apache, un gestor de bases de datos MySQL y un intérprete de lenguaje PhP. Aunque Dokeos puede instalarse y funcionar correctamente en cualquier sistema operativo, los autores recomiendan utilizar un servidor Linux.

Lo primero que vamos a necesitar, por tanto, es un servicio de alojamiento web que nos ofrezca todos estos servicios. He abierto una cuenta de alojamiento gratuito en byethost, que me ofrece (en abril de 2009) los siguientes servicios: Sistema operativo Linux, servidor web Apache versión 2.2.11 (para Unix), intérprete PHP versión 5.2.9, gestor de bases de datos MySQL versión 5.0.67 y un panel de control VistaPanel Versión 2.4.0 RC1 para manejar todos los parámetros de mi cuenta.

Abrir la cuenta de alojamiento ha sido realmente sencillo, contando con una cuenta de correo en Gmail. Al terminar el proceso de registro, su sistema me envía un mensaje con los datos principales de la cuenta. Estos datos, que utilizaré en la explicación del proceso que sigue en este post, tienen un aspecto parecido a este:

• Cpanel URL : http://panel.byethost.com
• Cpanel Username (FTP/SQL): b08_1234567
• Cpanel Password (FTP/SQL): 12341234
• MySQL Hostname: sql111.byethost08.com
• MySQL Username (FTP/SQL): b08_1234567
• MySQL Password (FTP/SQL): 12341234
• FTP Server: ftp.byethost08.com
• FTP Username (FTP/SQL): b08_1234567
• FTP Password (FTP/SQL): 12341234
• Website URL: http://blanco.byethost08.com

Una vez creado el alojamiento, es preciso crear una base de datos en la que Dokeos creará y moficará registros para gestionar los cursos, los alumnos y los datos de la aplicación. Para crear esta base de datos utilizaremos el panel de control que nos ofrece el servicio de hosting:

1. Accedemos con el navegador al Panel de Control (en nuestro ejemplo, acudiendo a la página ) e iniciamos sesión con nuestro nombre de usuario (en nuestro ejemplo b08_1234567) y contraseña (en el ejemplo 12341234). Se abre el panel de control y accedemos a la opción Bases de Datos > MySQL Databases.

1. En la ventana Make a new database escribimos el nombre que queremos dar a nuestra base de datos. Supongamos que le damos el nombre nombrebase, por ejemplo, y aceptamos.
2. Así es como hemos creado una base de datos que se llama, en nuestro ejemplo, b08_1234567_nombrebase.

.

b. Obtener y descomprimir el paquete Dokeos

En el sitio de descargas de Dokeos obtengo un archivo comprimido de 22 Mbytes aproximadamente, llamado dokeos-1.8.5.zip que, después de ser descomprimido, se despliega en un conjunto de carpetas y archivos que lo componen.  Todos los componentes del paquete se encuentran agrupados en una carpeta llamada dokeos-1.8.5.

Cualquier aplicación de descompresión de archivos es adecuada para conseguir esto, pero a mi me gusta utilizar 7-zip, un gestor de archivos libre y de código abierto.

.

c. Subir Dokeos al servidor

El siguiente paso consiste en subir todos los componentes del paquete Dokeos al servidor, mediante una sesión de FTP. Yo suelo utilizar el cliente de FTP Filezilla, un extraordinario programa libre y de código abierto que puede obtenerse gratuitamente desde su sitio web.

Para establecer una conexión con nuestro servidor, vamos a necesitar tres de los datos que nos ha proporcionado nuestro servicio de hosting: el nombre del servidor de ftp, nuestro nombre de usuario y la contraseña. En nuestro ejemplo, estos datos ya se han mencionado al principio de este post y son los siguientes:

• FTP Server:  ftp.byethost08.com
• FTP Username (FTP/SQL): b08_1234567
• FTP Password (FTP/SQL): 12341234

Rellenamos con estos datos los campos correspondientes en el cliente ftp y pulsamos el botón de Conexión rápida:

Una vez establecida la conexión, el cliente de FTP nos ofrece una interface para explorar nuestro disco local (a la izqiuerda) y el disco remoto del servidor (a la derecha):

Nuestros archivos deben ser subidos al directorio público en el servidor que nos ofrece alojamiento. El nombre de este directorio público suele ser htdocs (una denominación característica del servidor web Apache) como en el alojamiento byethost de nuestro ejemplo o public.html en otros servicios de alojamiento. En ningún caso debemos alojar archivos fuera de la carpeta que constituye nuestro directorio público en la Red.

La sesión de FTP durará varios minutos, dependiendo de la velocidad de conexión a la Red. Algunos archivos del paquete Dokeos tienen un tamaño cercano a 1 MB y tardan más en subir. ¡¡ Paciencia !!.
.

d.    Modificar los permisos

Las instrucciones de instalación de Dokeos especifican que deben ajustarse los permisos de lectura y escritura de algunas de sus carpetas y archivos. Las siguientes carpetas deben ser totalmente accesibles para que todo el mundo pueda leer, escribir y ejecutar su contenido:

• htdocs/main/inc/conf/
• htdocs/main/garbage/
• htdocs/main/upload/users/
• htdocs/main/default_course_document/
• htdocs/archive/
• htdocs/courses/
• htdocs/home/

En estas rutas htdocs/ es el directorio público del servidor en el que hemos instalado el software. Si en otro servicio de alojamiento la carpeta pública se llamase public.html, por ejemplo, la ruta de la primera carpeta sería public.html/main/inc/conf/ y el mismo criterio deberíamos aplicar en los demás casos de la lista anterior.

En los sistemas operativos Linux, Mac OS X y BSD el permiso para que cualquiera pueda leer, escribir y ejecutar un archivo se establece utilizando el comando CHMOD 777 . Afortunadamente, nuestro servicio de alojamiento gratuito en byethost nos ofrece el panel de control desde el que podemos hacer este cambio cómodamente:

1. En el panel de control elegimos la opción Control del Sitio > Manejar Archivos:



2. Abrimos la carpeta htdocs y buscamos las carpetas a las que hay que modificar los permisos. Voy a seguir el ejemplo de la carpeta garbage, que se encuentra en htdocs/main/garbage/. La selecciono haciendo clic en la casilla izquierda:
   
3. Escribo en la ventana correspondiente (Chmod value) el valor 777, que corresponde a conceder permiso universal para leer, escribir y ejecutar y pulso en el icono de confirmación
   
4. El resultado de esta operación está ya a la vista. La lista de permisos dice ahora rwxrwxrwx:
   

Las instrucciones de instalación nos indican, asimismo, que el navegador web debe tener permiso para leer y escribir (no para ejecutar) los siguientes archivos:

• htdocs/main/inc/conf/configuration.php (si ha sido instalado)
• htdocs/home/*.html (es decir, todos los archivos de la carpeta home con extensión .html con excepción de los que empiezan por home_)

Este nivel de permiso se establece, en los sistemas operativos Linux, Mac OS X y BSD con el comando CHMOD 666.

En nuestro caso, localizaremos estos archivos utilizando el panel de control y modificaremos sus permisos siguiendo el mismo procedimiento que he explicado hasta aquí.

Una vez modificados los permisos de lectura y escritura iniciamos la instalación del software en el servidor

.

e.    Instalación

Dokeos se instala desde el navegador. Escribimos la dirección de nuestro sitio web, la que nos ha proporcionado nuestro servicio de alojamiento que, en nuestro ejemplo, es http://blanco.byethost08.com

1. La primera pantalla nos ofrece una lista desplegable para elegir el idioma y un botón para lanzar el proceso de instalación:
2. En segundo lugar, el programa de instalación verifica que el servicio de alojamiento cumple todos los requisitos que necesita el software Dokeos para funcionar correctamente. En nuestro caso, el servicio de alojamiento elegido (byethost) cumple todos los requisitos:
3. La tercera pantalla nos pide que leamos y aceptemos los términos de la licencia (GPL versión 2) por la que se rige el uso de Dokeos:
4. La cuarta pantalla es muy importante. Hay que introducir en ella los datos de acceso a nuestra base de datos para que Dokeos pueda crear y manejar las bases de datos que necesita:
   1. Es importante borrar el prefijo MySQL, que durante el proceso de instalación aparece por defecto con el valor dokeos_. Si no lo hacemos así la instalación fracasa, con un mensaje de error dice que “Dokeos no ha podido gestionar la base de datos dokeos_bo8_1234567_nombrebase“.
   2. Podemos comprobar que son correctos los datos que permiten a Dokeos acceder y manejar la base de datos que hemos creado en el servidor pulsando el botón “Comprobar la conexión con la base de datos”.
5. En quinto lugar aparece la ventana de diálogo para introducir los parámetros de administración del sitio. Lo más importante es prestar atención al nombre y la contraseña del administrador de la plataforma que se está instalando ahora.
6. Finalmente, aparece una pantalla con el resumen de todos los parámetros que hemos introducido durante la instalación:
7. Y eso es todo. Si todo ha salido bien, aparecerá un mensaje de éxito y, al visitar ce nuevo la URL del sitio web nos encontraremos con la pantalla inicial de nuestro sitio:

.

f.    Proteger la instalación

Una vez terminada la instalación, es necesario proteger los archivos que contienen la configuración de nuestro recién creado sitio web. Se trata de los archivos siguientes:

• main/inc/conf/configuration.php
• main/install/index.php

Estos dos archivos deben tener únicamente permiso de lectura, lo que se consigue utilizando el comando CHMOD 444 desde una consola del sistema operativo o, del mismo modo que hemos hecho antes, utilizando el panel de control de nuestro alojamiento web.

¡¡Buena suerte!!