Installer Revive Adserver sur Debian

Ce guide est testé sur:

• Debian 7.0 Wheezy

Prérequis

Ce guide nécessite :

• a2tools, l'outil d'administration simplifiée d'Apache 2.
• un serveur HTTP avec support du PHP, comme décrit par Installer PHP-FPM sur Debian.
• php-tools, l'outil de configuration simplifiée de PHP.
• un serveur MySQL, comme décrit par Installer et configurer MySQL sur Debian.
• mysql-tools, l'outil d'administration simplifiée de MySQL sur l'hôte local (et l'hôte du serveur MySQL, si différent).

Paramètres

Renseignez le nom de domaine où sera disponible l'application:

DOMAIN="rads.domain.com"

Renseignez le nom d'hôte du serveur MySQL:

MYSQL_HOST="localhost"

Si le serveur MySQL n'est pas local, l'outil mysql-tools essaiera de s'y connecter avec le client MySQL, ou, en cas d'échec de connexion, via une connexion SSH.

Renseignez le nom du certificat SSL à utiliser pour chiffrer l'application avec HTTPS (créé via la procédure Créer un certificat SSL / TLS sur Debian) (optionnel, recommandé):

SSL_KEY_NAME="${DOMAIN}"

Installation

Déterminez le chemin d'installation:

INSTALL_PATH="/var/lib/revive-adserver/${DOMAIN}"

Préparation de l'environnement

Installez les extensions PHP et logiciels nécessaires :

command apt-get install php5-mysql php5-gd php5-cli php5-geoip

Adaptez la configuration PHP aux besoins de l'outil:

command php-tools --for="revive-adserver" --set "memory_limit" "128M"
command php-tools --for="revive-adserver" --fix "magic_quotes_gpc" "0"

Rechargez la configuration de PHP:

test -e '/etc/init.d/php5-fpm' && command service 'php5-fpm' 'restart'
test -e '/etc/init.d/apache2' && command service 'apache2' 'force-reload'

Mise en place de l'application

Téléchargez la dernière version de l'application à l'aide de sf-downloader:

command wget 'https://raw.github.com/biapy/howto.biapy.com/master/various/sf-downloader' \
    --quiet --no-check-certificate --output-document='/tmp/sf-downloader'
SOURCE="$(command bash '/tmp/sf-downloader' --tgz --strip-components=1 \
    --output-directory="${INSTALL_PATH}" \
    --generic='http://www.revive-adserver.com/download/' \
    'revive-adserver' 'revive-adserver-VERSION.tar.gz')"

Ajustez les permissions:

WRITABLE_PATHS="var
plugins
www/images
www/admin/plugins"
for WRITABLE_PATH in ${WRITABLE_PATHS}; do
  command chown -R www-data:www-data "${INSTALL_PATH}/${WRITABLE_PATH}"
done

Créez la configuration du serveur HTTP:

if [ -n "${SSL_KEY_NAME}" -a -e "/etc/ssl/private/${SSL_KEY_NAME}.key" ]; then
  command a2tools --ssl="${SSL_KEY_NAME}" "${DOMAIN}" "${INSTALL_PATH}/www"
fi
command a2tools "${DOMAIN}" "${INSTALL_PATH}/www"

L'outil est maintenant disponible sur le domaine spécifié en HTTP et HTTPS si possible.

Création de la base de données

Créez la base de données:

command mysql-tools --server="${MYSQL_HOST}" --with-ssh \
        --auto-hosts --db-prefix="revive-adserver" --create "${DOMAIN}"

Notez les informations de connexion fournies.

Configuration initiale

Accédez à la configuration initiale de l'outil en utilisant l'URL affichée par:

echo "http://${DOMAIN}/"

Configurez l'outil pour utilisez la base de données crée précédemment.

Sauvegardes

Sauvegardez l'installation avec Backup Manager (voir Installer et configurer Backup Manager sur Debian):

command backup-manager-tools add "${INSTALL_PATH}"

N'oubliez pas de sauvegarder la base de données (voir Installer et configurer MySQL sur Debian).

Mise à jour

Renseignez le domaine de l'installation obsolète:

DOMAIN="rads.domain.com"

Déterminez le chemin d'installation:

INSTALL_PATH="/var/lib/revive-adserver/${DOMAIN}"

Nettoyez le chemin:

INSTALL_PATH="$(echo "${INSTALL_PATH}" | sed -e 's|/$||g')"

Créez une copie de sauvegarde de l'installation actuelle:

command test -d "${INSTALL_PATH}.old" && command rm "${INSTALL_PATH}.old"
command cp -a "${INSTALL_PATH}" "${INSTALL_PATH}.old"

Téléchargez la dernière version de l'application à l'aide de sf-downloader:

command wget 'https://raw.github.com/biapy/howto.biapy.com/master/various/sf-downloader' \
    --quiet --no-check-certificate --output-document='/tmp/sf-downloader'
SOURCE="$(command bash '/tmp/sf-downloader' --tgz --strip-components=1 \
    --output-directory="${INSTALL_PATH}" \
    --generic='http://www.revive-adserver.com/download/' \
    'revive-adserver' 'revive-adserver-VERSION.tar.gz')"

Ajustez les permissions:

WRITABLE_PATHS="var
plugins
www/images
www/admin/plugins"
for WRITABLE_PATH in ${WRITABLE_PATHS}; do
  command chown -R www-data:www-data "${INSTALL_PATH}/${WRITABLE_PATH}"
done

Signalez qu'il s'agit d'une mise à jour:

command touch "${INSTALL_PATH}/var/UPGRADE"
command chown www-data:www-data "${INSTALL_PATH}/var/UPGRADE"

Lancez la mise à jour de l'outil en utilisant l'URL affichée par:

echo "http://${DOMAIN}/"

Si tout s'est bien passé, supprimez la sauvegarde:

command rm -r "${INSTALL_PATH}.old"

Remerciements

• Merci aux développeurs de Revive Adserver.