Drupal en Ubuntu

1 Introducción

Documento de instalación de Drupal en Ubuntu.

1.1 Aclaraciones

Algunas aclaraciones:

• La documentación de Drupal es muy completa, y debería ser la primera fuente para realizar instalaciones de este software. El presente es simplemente una receta de como instalar una versión específica en un OS específico, para uso del autor.

• El método elegido para la instalación de Drupal es el método más general (que serviría para otras distribuciones GNU/Linux). En particular en Ubuntu, se puede instalar el paquete drupal5 o drupal6. Sin embargo, se eligió el método general de instalación por dos motivos:

  • Conocer varios detalles del software que se está usando, desde su instalación misma.

  • Estar más familiarizado con el software, por si surgen algunos problemas al instalarlo en un hosting externo.

1.2 Software usado

• Drupal 6.13

• Ubuntu Jaunty Jackalope (9.04)

• PHP 5.2.6

• MySQL 5.0

2 Instalación

Las siguientes tareas se realizan con el usuario root.

2.1 Requerimientos

• Instalar los siguientes paquetes (se puede hacer con aptitude, apt-get, o Synaptic): apache2, php5, php5-mysql y mysql-server-5.0.

• Bajar desde el sitio de Drupal, los archivos drupal-6.13.tar.gz (el core de Drupal) y es-6.x-1.3.tar.gz (las traducciones a español de Drupal).

2.2 Archivos

• Crear el directorio en donde va a estar instalado Drupal, dentro del directorio público HTML. El directorio creado durante esta instalación de prueba fue /var/www/drupal-6.13.

• Descomprimir el paquete de Drupal a un directorio temporal, y mover su contenido al directorio antes creado:

tar -vxzpf drupal-6.13.tar.gz
mv drupal-6.13/* drupal-6.13/.htaccess /var/www/drupal-6.13/

• Dentro del directorio sites/default (que está dentro del directorio de instalación de Drupal), copiar el archivo default.settings.php a settings.php.

• Darle permisos de escritura al archivo antes copiado para todos. Estos permisos son solamente necesarios durante la instalación:

chmod a+w settings.php

2.3 Base de datos

• Crear una DB MySQL para Drupal (el password del usuario root de MySQL fue seteado durante la instalación de la misma):

mysqladmin -u root -p create db_drupal_6_13

• Crear nuevo usuario (drupal), y darle permisos sobre la DB. Para ello, primero entrar a la consola MySQL con usuario root (mysql -u root -p), y dentro de ella ejecutar:

GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, 
ALTER ON db_drupal_6_13.* TO 'drupal'@'localhost' 
IDENTIFIED BY 'passwordNuevoUsuario';

Si todo es correcto la respuesta debería ser algo como:

Query OK, 0 rows affected (0.00 sec)

• Para activar los nuevos permisos, desde la misma consola ejecutar FLUSH PRIVILEGES;.

2.4 Apache

Configurar un nuevo sitio en Apache, para que apunte a la instalación de Drupal. Para ello:

• Antes que nada se debe definir la URL de acceso a Drupal. Esta deberá ser mapeada con la IP del host donde se está instando Drupal, ya sea por medio de un servidor DNS, o por un archivo estático de mapeo en un host cliente (como /etc/hosts en distribuciones GNU/Linux). Si no se quiere entrar en detalle en este tema, se puede correr el sitio con la URL localhost, desde el mismo host en donde se está instalando Drupal. Para el ejemplo la URL será www.sitiodrupal.com.

• Crear el archivo /etc/apache2/sites-available/drupal con el siguiente contenido:

<VirtualHost *:80>
  ServerName www.sitiodrupal.com
  DocumentRoot "/var/www/drupal-6.13"
  <Directory /var/www/drupal-6.13>
    AllowOverride All
  </Directory>
</VirtualHost>

• Habilitar el sitio recién creado con el comando a2ensite drupal.

• Recargar Apache con el comando /etc/init.d/apache2 reload.

2.5 Idioma

Antes de correr el script de instalación, se puede setear otro idioma. Por ejemplo, para setear el idioma español:

• Extraer el contenido del archivo es-6.x-1.3.tar.gz antes descargado, al directorio de instalación de Drupal:

tar -vxzpf es-6.x-1.3.tar.gz -C /var/www/drupal-6.13/

2.6 Script de instalación

El script de instalación se corre simplemente accediendo a la URL que elegimos anteriormente, mediante un browser. Este script es un wizard que nos va dando diferentes opciones para la instalación.

Antes de correrlo, y para no tener problemas luego, cambiar el dueño del directorio de instalación de Drupal, y todo su contenido recursivamente, al usuario que corre Apache (que en el caso de Ubuntu es www-data):

chown -R www-data: /var/www/drupal-6.13/

Luego ya podemos empezar a correr el script de instalación desde el browser, y:

• En la primera pantalla elegimos idioma español, si es que lo instalamos anteriormente.

• Luego (y si se verificaron todos los requerimientos correctamente), nos va a pedir los datos de la base de datos creada anteriormente.

• Después pide algunos datos más, como nombre del sitio (la URL antes usada), mails, datos de la cuenta del administrador, etc.

• Finalmente nos muestra una pantalla en donde nos dice que Drupal ha sido instalado, y nos ofrece un link para entrar al sitio.

A partir de este punto, podemos entrar a la URL del sitio y empezar a usar Drupal. Es un buen momento para configurar URLs limpias si se requiere, generar un informe del estado del sitio para corregir posibles problemas, y configurar el cron, pero estas tareas están fuera del alcance de esta guía.