Modification du répertoire d’accueil du référentiel

Question / Problème

Il peut être nécessaire de modifier le répertoire d’accueil du référentiel de CRX, en particulier lors du déploiement de CRX sur un serveur d'applications tiers tel que WebSphere.

Réponse / Résolution

Par défaut, CRX sera installé dans un dossier nommé crx-quickstart situé dans le dossier racine de la JVM. Pour modifier le dossier d'installation crx-quickstart par défaut, procédez comme suit. Dans cet exemple, le dossier d'installation par défaut sera préfixé avec my_custom_path:

• Extrayez le crx-xxx-quickstart.jar par défaut avec 'java -jar crx-xxx-quickstart.jar' dans un emplacement temporaire.
• Accédez à crx-quickstart/server/webapps
• Décompressez crx-explorer_crx.war en crx-explorer_crx
• Modifiez crx-explorer_crx/WEB-INF/web.xml
  • Localisez le servlet avec le nom Repository et réglez la valeur du paramètre repository-home sur my_custom_path/crx-quickstart/repository
  • localisez le servlet JCRExplorer et réglez la valeur du paramètre explorer-home sur my_custom_path/crx-quickstart/repository
  • Localisez le servlet JCRWebdavServer et modifiez la valeur du paramètre home en my_custom_path/crx-quickstart
• Modifiez le fichier crx-explorer_crx/WEB-INF/log4j.xml
  • Adaptez le chemin des fichiers error.log et translation.log et préfixez-les avec my_custom_path
• Décompressez crx-launchpad.war en crx-launchpad
• Modifiez crx-launchpad/WEB-INF/web.xml
  • Ajustez le paramètre sling.home en my_custom_path/crx-quickstart/launchpad

Après avoir reconfiguré les chemins, il vous suffit de reconditionner les webapps précédemment décompressées et de les déployer dans le serveur d'applications de votre choix, d'abord crx-explorer_crx.war, puis crx-launchpad.war. Une fois déployé, le répertoire d’accueil du référentiel sera situé à <app_server_home>/my_custom_path.

Remarque : vous risquez de rencontrer une erreur d'autorisation de fichier io comme [1]. Assurez-vous que l'utilisateur runas de l'application dispose des droits d'écriture sur le parent de sling.home.
 
[1] java.io.FileNotFoundException: my_custom_path/../system.id (Permission refusée)

CRX1.4.2 et CRX2.x