Utilisation et configuration du script

Informations spécifiques à la distribution Debian

Si vous utilisez cette distribution, vous devrez activer les dépôts "debian-multimedia" comme expliqué ici : http://technique.arscenic.org/comma...

Depuis la version 0.3.1 du script, le dépôt peut être automatiquement activé à la suite d’une question.

Récupération du script

Le script d’installation peut être récupéré de deux manières différentes.

Via svn [1] en utilisant la commande pour récupérer le code source à jour :

Ou en utilisant le paquet zip mis à jour régulièrement :

Utilisation basique du script

Le script est utilisable directement en lançant la commande suivante en étant super utilisateur (root) [2] :

Ou en le rendant exécutable et en le lançant directement :

Il installera l’ensemble avec les données de configuration par défaut.

Il est possible de modifier son comportement de deux manières différentes, en surchargeant certaines options dans un fichier spécifique /etc/default/mediaspip (particulièrement pratique lors de l’utilisation en CRON) ou via le passage paramètres directement à l’appel du script.

Surcharge des options via un fichier de configuration

Beaucoup d’options sont surchargeables dans le fichier /etc/default/mediaspip. Il est inclu après la définition des variables de base, chaque variable redéfinie sera alors prise en compte.

Pour surcharger une option il faut en écrire une par ligne sous la forme :

Les options basiques sont :

• LOG : correspondant à l’emplacement du fichier de log de l’installation (/var/log/mediaspip_install.log par défaut) ;
• NO_QUESTION : "yes" permet de passer les questions préalables au script ;
• NO_OF_CPUCORES : correspond au nombre de core du ou des processeurs que les phases de compilations pourront utiliser (par défaut, on utilise l’ensemble des cores donnés dans le fichier /proc/cpuinfo) ;

Les options dédiées aux installations de logiciels :

• SRC_INSTALL : correspondant au répertoire où seront téléchargée les sources des logiciels à installér (/usr/local/src par défaut) ;
• DEP_VERSION : correspond au mode d’installation des logiciels. Elle est utilisée pour l’installation de rtmpdump, FFMpeg et FFMpeg2theora [3], les autres logiciels étant arbitrairement installé de l’une ou l’autre manière. Cette option peut avoir deux valeurs différentes :
  • dev (valeur par défaut) : correspond à une installation à jour en récupérant les sources possibles via les logiciels de gestion de version que sont svn et git ;
  • stable (ou tout autre valeur en fait différente de dev) : correspond à essayer de n’installer que des releases fixes des logiciels récupérées via une archive figée pour une version ;
• DISABLE_FFMPEG : permet de ne pas installer FFMpeg. Plusieurs installations sont affectées par cette configuration car elles dépendent de FFMpeg :
  • FFMpeg lui-même ;
  • FFMpeg2theora ;
• DISABLE_APACHE : permet d’éviter de préconfigurer le serveur Apache, l’installation de PHP5 et des classes nécessaires sera quand même réalisée ;
• DISABLE_ALTERNC : dans le cas où AlternC est détecté sur votre serveur, cela permet de ne pas prendre en compte cette détection et de ne pas créer les liens symbolique nécessaires au safe_mode ;

Les options spécifiques à la configuration d’Apache et PHP

• PHP_UPLOAD_SIZE : permet de modifier la taille maximale des fichiers envoyés (150M par défaut) ;

Les options spécifiques à SPIP et MediaSPIP

• DISABLE_MEDIASPIP : permet de ne pas installer ni mettre à jour SPIP et les extensions / plugins / thèmes de MediaSPIP ;
• SPIP : permet de définir le répertoire d’installation final de SPIP et des éléments de MediaSPIP (/var/www/mediaspip par défaut) ;
• SPIP_SVN : permet de définir le dépot svn que l’on utilise pour le code de SPIP (svn://trac.rezo.net/spip/branches/spip-2.1 par défaut) ;
• SPIP_USER : permet de définir l’utilisateur Unix à qui vont appartenir les fichiers de MediaSPIP ;
• SPIP_GROUP : permet de définir le groupe Unix à qui vont appartenir les fichiers de MediaSPIP ;
• SPIP_TYPE : permet de définir le type d’installation que l’on souhaite, plusieurs valeurs sont possibles :
  • ferme_full : installe l’ensemble sous la forme d’une ferme (avec le plugin de mutualisation) ainsi que l’ensemble des plugins optionnels et thèmes dits compatibles (choix par défaut) ;
  • ferme : installe l’ensemble sous la forme d’une ferme (avec le plugin de mutualisation) sans les plugins optionnels ni les thèmes ;
  • full : installe une version standalone avec l’ensemble des plugins optionnels et thèmes dits compatibles ;
  • minimal : installe une version standalone sans les plugins optionnels et thèmes dits compatibles ;

Surcharge des options via paramètres du script

Les surcharges d’options en tant que paramètre du script sont plus ou moins identiques à celles réalisables via un fichier de configuration.

On peut lister le contenu de ces paramètres en appelant le script avec le paramètre --help :

Les options basiques sont :

• --help : affiche l’aide du script ;
• --version : affiche la version du script ;
• --allways-yes : permet de passer les questions préalables au script ;
• --log : correspondant à l’emplacement du fichier de log de l’installation (/var/log/mediaspip_install.log par défaut) ;
• --cpus : correspond au nombre de core du ou des processeurs que les phases de compilations pourront utiliser (par défaut, on utilise l’ensemble des cores donnés dans le fichier /proc/cpuinfo) ;

Les paramètres dédiés aux installations de logiciels :

• --src_install : correspondant au répertoire où seront téléchargée les sources des logiciels à installér (/usr/local/src par défaut) ;
• --dep_version : correspond au mode d’installation des logiciels. Elle est utilisée pour l’installation de rtmpdump, FFMpeg et FFMpeg2theora [4], les autres logiciels étant arbitrairement installé de l’une ou l’autre manière. Cette option peut avoir deux valeurs différentes :
  • dev (valeur par défaut) : correspond à une installation à jour en récupérant les sources possibles via les logiciels de gestion de version que sont svn et git ;
  • stable (ou tout autre valeur en fait différente de dev) : correspond à essayer de n’installer que des releases fixes des logiciels récupérées via une archive figée pour une version ;
• --disable-ffmpeg : permet de ne pas installer FFMpeg. Plusieurs installations sont affectées par cette configuration car elles dépendent de FFMpeg :
  • FFMpeg lui-même ;
  • FFMpeg2theora ;
• --disable-apache : permet d’éviter de préconfigurer le serveur Apache, l’installation de PHP5 et des classes nécessaires sera quand même réalisée ;
• --disable-alternc : dans le cas où AlternC est détecté sur votre serveur, cela permet de ne pas prendre en compte cette détection et de ne pas créer les liens symbolique nécessaires au safe_mode ;

Les paramètres spécifiques à SPIP et MediaSPIP

• --disable_mediaspip : permet de ne pas installer ni mettre à jour SPIP et les extensions / plugins / thèmes de MediaSPIP ;
• --spip : permet de définir le répertoire d’installation final de SPIP et des éléments de MediaSPIP (/var/www/mediaspip par défaut) ;
• --spip-svn : permet de définir le dépot svn que l’on utilise pour le code de SPIP (svn://trac.rezo.net/spip/branches/spip-2.1 par défaut) ;
• --spip-user : permet de définir l’utilisateur Unix à qui vont appartenir les fichiers de MediaSPIP ;
• --spip-group : permet de définir le groupe Unix à qui vont appartenir les fichiers de MediaSPIP ;
• --spip-type : permet de définir le type d’installation que l’on souhaite, plusieurs valeurs sont possibles :
  • ferme_full : installe l’ensemble sous la forme d’une ferme (avec le plugin de mutualisation) ainsi que l’ensemble des plugins optionnels et thèmes dits compatibles (choix par défaut) ;
  • ferme : installe l’ensemble sous la forme d’une ferme (avec le plugin de mutualisation) sans les plugins optionnels ni les thèmes ;
  • full : installe une version standalone avec l’ensemble des plugins optionnels et thèmes dits compatibles ;
  • minimal : installe une version standalone sans les plugins optionnels et thèmes dits compatibles ;

Opérations manuelles post-script

Quelques opérations doivent être effectuées manuellement après l’installation par le script.

Fichier de configuration .htaccess

Si votre site est accessible par un sous-répertoire, par exemple : http://mondomaine/mediaspip/ et non à la racine du domaine, par exemple : http://mondomaine/, il faut modifier le fichier .htaccess, en remplaçant :

par

Virtual Host Apache2

Un exemple de configuration de Virtual Host dédié à la nouvelle installation de Mediaspip est copié dans le répertoire sites-available de Apache2 (en général : /etc/apache2/sites-available). Si vous avez installé une ferme Mediaspip, alors le fichier s’appelle mediaspip_ferme_example.conf, sinon il s’appelle mediaspip_simple_example.conf. Ce fichier est un exemple de configuration, et il nécessite d’être adapté à votre situation avant de pouvoir être activé avec a2enmod.

Si vous voulez accéder à votre site depuis un sous-répertoire, par exemple : http://mondomaine/mediaspip/, il ne s’agira pas d’un Virtual Host, et vous devrez copier le contenu du fichier de configuration d’exemple vers le fichier de configuration de "mondomaine".

Options SPIP personnalisées

Dans le cas d’une installation Mediaspip simple, vous pouvez ajouter des options SPIP à votre site en créant le fichier config/mes_options.php de votre site (voir la documentation de SPIP). Par exemple, pour afficher plus de logs dans le fichier tmp/log/spip.log de votre site, créez le fichier config/mes_options.php suivant

Dans le cas d’une ferme Mediaspip, le script d’installation crée son propre fichier mes_options.php, et vous pouvez ajouter des options personnalisées en copiant et modifiant le fichier mes_options_personnalisation.php.txt de votre site