Outils personnels
Vous êtes ici : Accueil GNU / Linux Debian Installer le DAM (Digital Asset Management) ResourceSpace sur Debian 4.0 Etch
Actions sur le document
  • Send this page to somebody
  • Print this page
  • Add Bookmarklet

Installer le DAM (Digital Asset Management) ResourceSpace sur Debian 4.0 Etch

Par Pierre-Yves Landuré - Dernière modification 12/10/2009 09:27

ResourceSpace, de la société Montala, est un outil de gestion digitale des droits. Pour faire simple, c'est un logiciel de médiathèque avec la possibilité de restreindre l'accès aux documents qu'il contient. Ce document vous guide au travers de son installation sur Debian 4.0 Etch.

Pré-requis

Serveur HTTP

En premier lieu, vous devez installer un serveur HTTP avec le support du PHP. Pour ce faire, vous pouvez suivre mon guide Installer Lighttpd et PHP 5 sur Debian 4.0 Etch et 5.0 Lenny.

Une fois le serveur web installé et le support de PHP actif, installez les extensions PHP et autres logiciels nécessaires:

/usr/bin/apt-get install php5-mysql php5-gd unzip zip \
imagemagick gs-gpl ffmpeg \
antiword xpdf-utils apg mysql-client

Nous modifions certains des paramètres par défaut de PHP:

/bin/echo '; PHP configuration for ResourceSpace.
memory_limit = 256M
post_max_size = 108M
upload_max_filesize = 100M' > /etc/php5/conf.d/resourcespace.ini

N'oubliez pas de redémarrer votre serveur HTTP pour prendre en compte les nouveaux modules PHP. Par exemple, si vous utilisez Lighttpd, exécutez:

/etc/init.d/lighttpd force-reload

Base de données MySQL

Vous devez ensuite créer une base de donnée RESOURCESPACE pour votre installation. Pour ce faire, vous pouvez suivre mon guide MySQL sur Debian 4.0 Etch et 5.0 Lenny.

Une fois la base de donnée créée, nous reprenons le court normal des choses. En premier lieu, nous plaçons une valeur par défaut pour le nom d'hôte du serveur de la base de données:

if [ -z "$MYSQL_HOST" ]; then
MYSQL_HOST=localhost
fi

Attention : Si vous avez suivi mon guide, vous pouvez passer ces lignes de commandes, sinon, remplacer les informations en gras par celles correspondant à votre base de données MySQL :

MYSQL_HOST=localhost
MYSQL_DB=RESOURCESPACE
MYSQL_USERNAME=resourcespace
MYSQL_USERPWD=resourcespace_password

ExifTool

ResourceSpace nécessite une version d'ExifTool plus récente que celle présente par défaut sur Debian 4.0 Etch. Veuillez donc créer et installer un backport du paquet libimage-exiftool-perl en vous inspirant de mon guide Backporter un packet de Debian testing (5.0 Lenny) vers Debian stable (4.0 Etch).

Installation

En premier lieu, sélectionnez la version de ResourceSpace à installer:

VERSION=2.3.1374

Et nous téléchargeons les sources:

CLEANED_VERSION=$(/bin/echo ${VERSION} | /bin/sed -e 's/\./_/g')
/usr/bin/wget http://www.montala.net/downloads/ResourceSpace_${CLEANED_VERSION}.zip \
--output-document=/tmp/ResourceSpace_${CLEANED_VERSION}.zip

Nous choisissons l'emplacement d'installation :

TARGET="/opt/resourcespace"

Ensuite, nous décompressons l'archive:

/bin/mkdir ${TARGET}
/usr/bin/unzip -d ${TARGET} /tmp/ResourceSpace_${CLEANED_VERSION}.zip

Nous modifions les permissions par défaut des fichiers:

/usr/bin/find ${TARGET} -type f | /usr/bin/xargs -IFILE /bin/chmod -x "FILE"

Nous configurons la connexion à la base de données MySQL:

/bin/echo "<?php
/**
* ResourceSpace custom settings
*/

// MySQL database settings
\$mysql_server = '${MYSQL_HOST}';
\$mysql_username = '${MYSQL_USERNAME}';
\$mysql_password = '${MYSQL_USERPWD}';
\$mysql_db = '${MYSQL_DB}';
\$mysql_charset = 'utf8';

// Spider password and scramble key.
\$spider_password = '$(/usr/bin/apg -q -a  0 -n 1 -M NCL)';
\$scramble_key = '$(/usr/bin/apg -q -a  0 -n 1 -M NCL)';

// Default language.
\$defaultlanguage = 'fr';

// Third party tools paths.
\$imagemagick_path = '/usr/bin';
\$ghostscript_path = '/usr/bin';
\$ffmpeg_path = '/usr/bin';
\$exiftool_path = '/usr/bin';
\$antiword_path = '/usr/bin';
\$pdftotext_path = '/usr/bin';
" > "${TARGET}/include/config.php"

Si vous le souhaitez, vous pouvez appliquer quelques modifications dans le comportement par défaut de ResourceSpace:

/bin/echo "
// Set basic search as default search :
\$basic_simple_search = true;
" >> "${TARGET}/include/config.php"

Si votre langue principale est le français (on ne sait jamais), vous pouvez configurer ResourceSpace pour ignorer les mots les plus courants de la langue française:

/bin/echo "
// Discard french language common words from search :
\$noadd = array_merge(\$noadd, array('le', 'la', 'les', 'de', 'du', 'des', 'et', 'ou', 'a', 'est', 'un', 'une', 'pour', 'par', 'ce', 'cette', 'avec', 'dans'));
" >> "${TARGET}/include/config.php"

De même, vous pouvez choisir de modifier les caractères utilisé pour l'auto détection de l'encodage :

/bin/echo "
// Set ITPC encoding auto detect expected chars :
\$iptc_expectedchars = 'éèêëàîïôöûùüç最ÉÈÊËÀÎÏÔÖÛÙÜÇ';
" >> "${TARGET}/include/config.php"

Nous allons maintenant renseigner les adresses e-mails utilisées pour l'envoi de mails et la réception de notifications liées à ResourceSpace, ainsi que l'URL d'accès au site :

EMAIL_FROM=no-reply@domain.com
EMAIL_NOTIFY=votre-email@domain.com
BASE_URL=http://localhost/resourcespace

Appliquez maintenant les paramètres ainsi définis :

/bin/echo "
// ResourceSpace base URL :
\$baseurl = '${BASE_URL}';

// From address for email sent by ResourceSpace :
\$email_from = '${EMAIL_FROM}';

// Email notified of the requests created by users.
\$email_notify = '${EMAIL_NOTIFY}';
" >> "${TARGET}/include/config.php"

Nous récupérons le nom de notre installation :

INSTALL_NAME=$(/usr/bin/basename "${TARGET}")

Enfin, nous déplaçons les dossiers de données de ResourceSpace vers un emplacement plus approprié:

/bin/mkdir --parent "/var/lib/resourcespace/${INSTALL_NAME}"
/bin/mv "${TARGET}/filestore" "/var/lib/resourcespace/${INSTALL_NAME}/filestore"
/bin/mkdir --parent "${TARGET}/upload"
/bin/mv "${TARGET}/upload" "/var/lib/resourcespace/${INSTALL_NAME}/upload"
/bin/ln -s "/var/lib/resourcespace/${INSTALL_NAME}/filestore" "${TARGET}/filestore"
/bin/ln -s "/var/lib/resourcespace/${INSTALL_NAME}/upload" "${TARGET}/upload"
/bin/chown -R www-data:www-data "/var/lib/resourcespace/${INSTALL_NAME}"

Une fois la configuration terminée, nous créons un lien symbolique de ResourceSpace vers un emplacement accessible à l'aide du serveur HTTP :

/bin/ln -s "${TARGET}" "/var/www/resourcespace/${INSTALL_NAME}"

Remarque : vous pouvez aussi configurer Resourspace sur un domaine dédié. (voir pour cela mes guides Apache et Lighttpd).

Vous devriez maintenant pouvoir vous connecter à ResourceSpace via l'URL:

http://localhost/resourcespace

Le login de l'administrateur est:

  • Identifiant: admin
  • Mot de passe: admin

La première chose à faire est de modifier le mot de passe.

Pour aller plus loin

Comment fonctionne l'ajout de documents

ResourceSpace propose plusieurs méthodes pour le téléversement de documents.

  • Ajouter un document : Cette page permet d'ajouter les documents un par un, à la manière classique des formulaires web. Cette méthode est très fastidieuse lorsque vous avez plusieurs fichiers à ajouter.
  • Ajouter un ensemble de documents - depuis le navigateur : Cette méthode utilise l'outil SWFUpload pour permettre l'ajouter de plusieurs fichiers à la fois. Cela simplifie grandement l'ajout d'ensembles de documents.... lorsque SWFUpload fonctionne. En effet, SWFUpload ne fonctionne pas si vous utilisez GNU/Linux ou une version trop ancienne du plugins Flash. De plus, son fonctionnement est au mieux aléatoire. Personnellement, je n'ai jamais réussi à faire fonctionner cette méthode correctement.
  • Ajouter un ensemble de documents - FTP : ResourceSpace donne deux possibilité via cette page.
    • Votre première option est de déposer vos images sur un serveur FTP tiers, et demander à ResourceSpace de les télécharger depuis cet emplacement.
    • La seconde posibilité est de déposer via FTP / SFTP les images à ajouter à ResourceSpace dans le dossier /opt/resourcespace/upload de votre installation ResourceSpace, et ensuite cocher la case "Utilisez un dossier local au lieu d'un serveur FTP distant". Vous vous verrez alors présenter la liste des fichiers présents à la racine de ce dossier upload, et vous pourrez choisir ceux à ajouter à ResourceSpace.

Ajouter des plugins à votre installation ResourceSpace

Les fonctionnalités de ResourceSpace peuvent être étendues par divers plugiciels. Pour en savoir plus sur les plugins disponibles, visitez la liste des plugins de ResourceSpace.

Installation du plugin RSS

Pour installer le plugin RSS, commencez par télécahrger le plugin:

/usr/bin/wget http://rswiki.montala.net/images/1/1c/Rss.zip \
--output-document=/tmp/Rss.zip

Et décompressez le à l'emplacement adéquat:

/usr/bin/unzip -o /tmp/Rss.zip -d "${TARGET}/plugins/"

Vous pouvez maintenant activer le plugin:

/bin/echo "
// Enable the RSS plugin :
\$plugins[] = 'rss';
" >> ${TARGET}/include/config.php

Et supprimer le fichier téléchargé:

/bin/rm /tmp/Rss.zip

Installation du plugin Loader

Pour installer le plugin Loader, commencez par télécahrger le plugin:

/usr/bin/wget http://rswiki.montala.net/images/b/b8/Loader.zip \
--output-document=/tmp/Loader.zip

Et décompressez le à l'emplacement adéquat:

/usr/bin/unzip -o /tmp/Loader.zip -d "${TARGET}/plugins/"

Vous pouvez maintenant activer le plugin:

/bin/echo "
// Enable the Loader plugin :
\$plugins[] = 'loader';
" >> ${TARGET}/include/config.php

Et supprimer le fichier téléchargé:

/bin/rm /tmp/Loader.zip

Administrer l'animation des images en page d'accueil

ResourceSpace présente sur sa page d'accueil un slideshow d'images. Les images de ce slideshow sont par défaut dans le dossier /opt/resourcespace/gfx/homeanim/gfx. La procédure suivante va vous permettre de remplacer les images de ce slideshow, ou d'en ajouter de nouvelles.

En premier lieu, nous allons créer un nouveau dossier destiné à contenir les images du slideshow:

/bin/mkdir /var/lib/resourcespace/${INSTALL_NAME}/homeanim-gfx

Optionnel : Si vous souhaitez continuer à utiliser les images par défaut de ResourceSpace, vous pouvez les copier dans le nouveau dossier :

/bin/cp ${TARGET}/gfx/homeanim/gfx/* /var/lib/resourcespace/${INSTALL_NAME}/homeanim-gfx

Nous configurons maintenant ResourceSpace pour obtenir les images. En premier lieu, il est nécessaire de créer un lien vers le dossier de notre slideshow personnalisé dans le dossier de ResourceSpace, afin que nos images soit disponibles via le serveur HTTP :

/bin/ln -s /var/lib/resourcespace/${INSTALL_NAME}/homeanim-gfx ${TARGET}/gfx/homeanim/my-gfx/

Nous pouvons mettre à jour la configuration de ResourceSpace pour utiliser ce nouveau dossier :

/bin/echo "
// Personnal slideshow folder :
\$homeanim_folder='gfx/homeanim/my-gfx';
" >> ${TARGET}/include/config.php

Il vous suffit de placer des images JPEG numérotées de 1 à N dans le dossier /var/lib/resourcespace/homeanim-gfx pour ajouter de nouvelles images à votre animation de page d'accueil. Par exemple:

  • 1.jpg
  • 2.jpg
  • 3.jpg
  • etc.

Ces images doivent être de taille fixe 517x350px et peser moins de 100ko pour que les temps de chargement ne soient pas trop longs.

Attention: Ce dossier doit contenir au moins 2 images sinon l'animation bogue. Les images peuvent être les même.

Remarque : Si vous le souhaitez, vous pouvez lier l'animation de la page d'accueil à un thème personnalisé. Il suffit pour ce faire d'ajouter un dossier "homeanim" au contenu de votre thème et de mettre à jour la configuration de ResourceSpace en conséquence:

/bin/echo "
// theme associated slideshow folder :
\$homeanim_folder='gfx/my-theme/homeanim';
" >> ${TARGET}/include/config.php

Créer ou changer de thème

Il est possible de créer un thème de couleur pour votre instance de ResourceSpace.

Les thèmes de ResourceSpace sont divisés en deux éléments. Pour l'exemple, nous nous baserons sur le thème greyblu:

  • Un fichier css : /opt/resourcespace/css/Col-greyblu.css
  • Un dossier d'images: /opt/resourcespace/gfx/greyblu

Par défaut, ResourceSpace est fourni avec deux thèmes:

  • greyblu (le thème par défaut)
  • whitegry

Pour ajouter un nouveau thème, vous pouvez vous inspirer des composants de ces thèmes.

Il vous suffit de copier les éléments présents, et de les adapter pour votre thème. Par exemple, pour créer un thème basé sur whitegry, commencez par renseigner le nom du thème (sans espaces):

THEME=mytheme

Une fois ceci fait, copiez le thème existant pour créer votre nouveau thème:

/bin/cp ${TARGET}/css/Col-whitegry.css ${TARGET}/css/Col-${THEME}.css
/bin/cp -r ${TARGET}/gfx/whitegry /opt/resourcespace/gfx/${THEME}
/bin/sed -i -e "s/whitegry/${THEME}/g" ${TARGET}/css/Col-${THEME}.css

Vous pouvez maintenant appliquer votre thème comme étant le seul thème disponible pour l'application:

/bin/echo "
// Personnal theme :
\$userfixedtheme='${THEME}';
" >> ${TARGET}/include/config.php

Sauvegardes

Pour sauvegarder votre installation ResourceSpace, en premier, prévoyez un espace disque important !. On parle ici de plusieurs centaines de giga de données dans le pire des cas. Je vous conseille d'utiliser Backup Manager. Pour l'installer, vous pouvez suivre mon guide:

Installer et configurer Backup Manager sur Debian 4.0 Etch

Une fois Backup Manager installé, vous pouvez configurer la sauvegarde des fichiers de ResourceSpace avec les commandes suivantes:

/usr/bin/update-bm-folders add ${TARGET}
/usr/bin/update-bm-folders add /var/lib/resourcespace

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 4.0 Etch.

Mise à jour

Sélectionnez la nouvelle version de ResourceSpace vers laquelle vous souhaitez migrer:

VERSION=2.3.1374

Et nous téléchargeons les sources:

CLEANED_VERSION=$(/bin/echo ${VERSION} | /bin/sed -e 's/\./_/g')
/usr/bin/wget http://www.montala.net/downloads/ResourceSpace_${CLEANED_VERSION}.zip \
--output-document=/tmp/ResourceSpace_${CLEANED_VERSION}.zip

Ensuite, nous décompressons l'archive:

/bin/mkdir /tmp/resourcespace
/usr/bin/unzip -d /tmp/resourcespace /tmp/ResourceSpace_${CLEANED_VERSION}.zip

Nous modifions les permissions par défaut des fichiers:

/usr/bin/find /tmp/resourcespace -type f | /usr/bin/xargs -iFILE /bin/chmod -x "FILE"

Nous supprimons les dossiers contenant les données "locales" de ResourceSpace:

/bin/rm -r /tmp/resourcespace/filestore

Récupérez le fichier de configuration de votre instance de ResourceSpace :

/bin/cp /opt/resourcespace/include/config.php /tmp/resourcespace/include/config.php

Remarque: Si cette ligne de commande vous renvoie des erreurs, vous devrez corriger à la main le fichier de configuration /tmp/resourcespace/include/config.php à partir des informations contenues dans /tmp/resourcespace/include/config.php.rej.

Une fois le fichier de configuration mis à jour, et si tout s'est déroulé correctement, vous pouvez sauvegarder l'installation existante, et mettre en place la nouvelle version:

if [ -d /opt/resourcespace.old ]; then
/bin/rm -r /opt/resourcespace.old
fi
/bin/cp -a /opt/resourcespace /opt/resourcespace.old
/bin/cp -a /tmp/resourcespace/* /opt/resourcespace

Vous devriez maintenant pouvoir vous connecter à ResourceSpace via l'URL:

http://localhost/resourcespace

Remerciements

Attachements

Accès aux assets

Posté par Sibalou le 10/03/2009 10:53
Bonjour,

Merci pour ce tutoriel d'instalation de Montala.
Je voulais savoir si on pouvais accéder aux différents assets d'une collection sans login.
Par exemple : créer une collection accessible à tous pour de la VOD.

Merci

oui, je crois que l'on peut

Posté par lwolf le 11/03/2009 07:24
je ne connais pas bien les dessous de resourcespace, mais je crois que l'on peut rendre les collections publiques.

BlogBang
Navigation
 

Réalisé avec Plone

Ce site respecte les normes suivantes :

Wikio