sakai.properties (2.x) - fichier de paramétrage de Sakai

Note : This is the french translation for the english web page "sakai.properties (2.x)"

Le fichier sakai.properties est un fichier de configuration centralisé qui est généralement stocké dans un sous-répertoire du répertoire principal de Sakai /sakai. Ce dernier se trouve dans le répertoire principal (home) de Tomcat ( défini par la variable $CATALINA_HOME). Il s'agit d'un fichier texte non XML, contenant une série de paires de clés/valeurs, qui est lue en utilisant la méthode Java de chargement avec java.util.properties. Les paramètres dans le fichier sakai.properties régissent tout dans Sakai du paramétrage du nom de votre institution à la configuration de votre base de données. Tous les paramètres dans le fichier sakai.properties sont lus au démarrage de Tomcat; les modifications apportées par la suite ne prendront effet que lorsque vous redémarrez le serveur d'applications Web (ici Tomcat).

Pour une installation à partir du code source, le fichier par défaut default.sakai.properties se trouve dans le module config:

sakai-src/config/configuration/bundles/src/bundle/org/sakaiproject/config/bundle/default.sakai.properties

Le paquet bin n'inclut pas un fichier sakai.properties. Il s'agit d'une exclusion délibérée; il élimine la possibilité d'écraser un fichier sakai.properties local si un paquet bin est ouvert sur une installation existante Sakai.

Si vous devez remplacer les paramètres par défaut, vous devez créer votre propre fichier sakai.properties à partir de zéro/rien ou à partir d'une copie de travail connue en ajoutant de nouveaux paramètres clé/valeur afin de personnaliser votre installation. Nous vous recommandons de lire le fichier default.sakai.properties inclus dans l'installation du code source ou de la branche de maintenance approprié.

Version	par défaut
10.0	`default.sakai.properties`
2.9	`default.sakai.properties`

L'emplacement par défaut de votre fichier sakai.properties local est $CATALINA_HOME/sakai. Ce dossier n'est pas créé par Maven lors du processus de construction/compilation (build) et de déploiement, de sorte que vous devrez le créer manuellement ou via un script. Vous pouvez également stocker les fichiers de configuration de Sakai en dehors de la hiérarchie de fichiers de votre serveur d'applications Web. Par exemple, dans un environnement de développement, vous pouvez vous retrouver à réinstaller fréquemment Tomcat et sauf si vous créez un script de compilation pour automatiser l'installation de Tomcat et le processus de configuration, afin de vous éviter d'avoir à recréer manuellement le répertoire $CATALINA_HOME/sakai et le fichier sakai.properties à chaque fois, a ses avantages.

Pour paramétrer la localisation de vos fichier de propriétés en dehors de l'environnement de votre serveur d'applications Web, modifier la commande de démarrage Java ou la variable d'environnement JAVA_OPTS et définissez une propriété système nommée sakai.home. Assurez-vous que votre emplacement externe est autorisé en lecture et écriture à votre serveur d'applications Web.

-Dsakai.home=/path/to/desired/sakai/home/