Pré-requis

Ce guide nécessite un serveur MySQL disposant du script mysql-tools disponible dans le guide Installer et configurer MySQL sur Debian.

Ce guide nécessite un serveur HTTP avec support du PHP disposant au choix d'un des scripts suivant :

• Le script a2tools disponible dans mon guide Installer Apache 2 sur Debian.
  
• Le script lighty-tools disponible dans mon guide Installer Lighttpd et PHP 5 sur Debian.

Paramètres

DOMAIN="sitebar.domaine-exemple.fr"

Renseignez le nom d'hôte de votre serveur MySQL (si vous ne savez pas de quoi il s'agit, ne modifiez pas cette valeur) :

MYSQL_HOST="localhost"

Si votre serveur MySQL n'est pas local, ce guide effectuera une connexion SSH pour y créer la base de données.

Installation

Installez les modules PHP nécessaires au bon fonctionnement de l'application :

command apt-get install php5-mysql mysql-client

Téléchargez les sources de l'application :

command wget "http://sitebar.org/download.php?file=tarball" \
    --output-document="/tmp/sitebar.tar.bz2"

Remarque : la version téléchargée est la 3.4 en cours de développement, car elle est stabilisée depuis maintenant 2 ans, sans release officielle. La version stable officielle (3.3.9) date de plusieurs années déjà.

Décompressez l'archive :

command tar --directory="/tmp" -xjf "/tmp/sitebar.tar.bz2"

Déplacez le dossier de l'application vers son emplacement final :

command mv "/tmp/SiteBar3_trunk" "/opt/${DOMAIN}"

Supprimez l'archive téléchargée :

command rm "/tmp/sitebar.tar.bz2"

Configuration

Créez la base de données :

if [ "${MYSQL_HOST}" = "localhost" ]; then
  MYSQL_PARAMS=$(command mysql-tools create-domain-db "${DOMAIN}")
else
  command echo "Saisissez le mot de passe de l'utilisateur root MySQL :"
  command read PASSWORD
  MYSQL_PARAMS=$(command ssh "root@${MYSQL_HOST}" "command mysql-tools create-domain-db '${DOMAIN}' '$(command cat /etc/mailname)' '${PASSWORD}'")
fi

Récupérez les paramètres de la nouvelle base de données :

MYSQL_DB="$(echo "${MYSQL_PARAMS}" | command grep -e "^MYSQL_DB" \
    | cut --delimiter="=" --fields="2-")"
MYSQL_USER="$(echo "${MYSQL_PARAMS}" | command grep -e "^MYSQL_USER" \
    | cut --delimiter="=" --fields="2-")"
MYSQL_PASSWORD="$(echo "${MYSQL_PARAMS}" | command grep -e "^MYSQL_PASSWORD" \
    | cut --delimiter="=" --fields="2-")"
echo "${MYSQL_PARAMS}"

Initialisez le contenu de la base de données :

command mysql --user="${MYSQL_USER}" --password="${MYSQL_PASSWORD}" \
    --host="${MYSQL_HOST}" "${MYSQL_DB}" \
      < "/opt/${DOMAIN}/sql/install.sql"

Renseignez le protocole que vous souhaitez utiliser pour votre SiteBar (http ou https) :

PROTOCOL="http"

Configurez la connexion à la base de données :

echo "<?php

\$SITEBAR = array
(
    'db' => array
    (   
        'host'      =>  '${MYSQL_HOST}',
        'username'  =>  '${MYSQL_USER}',
        'password'  =>  '${MYSQL_PASSWORD}',
        'name'      =>  '${MYSQL_DB}',
    )
    'baseurl' => '${PROTOCOL}://${DOMAIN}/',
    'login_as' => null,
);
" > "/opt/${DOMAIN}/inc/config.inc.php"

Créez la configuration du serveur HTTP pour votre domaine :

if [ -x "/usr/bin/a2tools" ]; then
  command a2tools add-vhost "${DOMAIN}" "/opt/${DOMAIN}/" "FileInfo"
fi
if [ -x "/usr/bin/lighty-tools" ]; then
  command lighty-tools add-vhost "${DOMAIN}" "/opt/${DOMAIN}/"
fi

Votre installation de Sitebar devrait maintenant être disponible sur votre nom de domaine. Vous pouvez alors créer l'utilisateur d'administration.

Sauvegardes

Pour sauvegarder l'application, je vous propose d'utiliser Backup Manager. Pour l'installer, vous pouvez suivre mon guide:

Installer et configurer Backup Manager sur Debian

Une fois Backup Manager installé, vous pouvez configurer la sauvegarde des fichiers de l'application avec la commande suivante:

command update-bm-folders add "/opt/${DOMAIN}"

Important: Sauvegarder les fichiers ne suffit pas ! Il faut aussi sauvegarder la base de données. La procédure pour ce faire est disponible dans mon article MySQL sur Debian.

Remerciements

• Merci aux développeurs de SiteBar.