Il est possible de configurer manuellement un dépôt de code source pour le démarrer sans passer par un service Windows. Cela permet par exemple d'héberger le dépôt sur un serveur Unix. Ce mode de configuration impose l'utilisation du mode d'installation partagé (la détection du mode "utilisateur" impliquant la présence d'un service Windows sur la machine locale).
Vous devez d'abord créer l'arborescence de source, y exporter les données initiales (soit à l'aide de l'outil d'import et d'export de source, soit en copiant les données d'un gestionnaire de version Git ou SVN) et connecter le gestionnaire de version souhaité.
Dans le cas de Git, les options suivantes sont suggérées :
- le répertoire ".adelia" ne devrait pas être versionné (ajout à .gitignore)
- Git doit être configuré de manière à ne pas altérer les retours chariot dans les fichiers (git config --global core.autocrlf false). En effet, cela pourrait interférer avec les calculs de signature de fichiers et rendre la comparaison des versions du dépôt et de l'environnement Adélia impossible.
Dans le cas de SVN vous devez respecter les prérequis suivants :
- sur plateforme Windows, vous devez avoir dans le path de la JVM les DLLs d'interface de JavaHL. Vous les trouverez dans le répertoire "svnapi.javahl.win32" ou "svnapi.javahl.win64" (selon le type de JVM 32bits ou 64bits) d'une installation d'Adélia.
- sur plateforme Unix, vous devez avoir une installation en ligne de commandes de SVN configurée.
Une fois l'arborescence de l'export initialisée, vous devez ensuite créer le sous-répertoire ".adelia" et y créer le fichier de configuration "application.properties" de l'application de synchronisation (voir modèle joint).
Dans le cadre de l'exemple, l'environnement TEST est partagé dans le répertoire /data/adelia/repositories/TEST, le service écoute sur le port 9999.
application.properties
# port de connexion du service - à ouvrir sur le pare-feu server.port=9999 spring.datasource.url=jdbc:postgresql://databaseserver:5432/TEST spring.datasource.username=postgres spring.datasource.password=password adelia.language=fr adelia.ebcdic_characters=$£à adelia.keep_row_metadata=true # répertoire de synchronisation à configurer adelia.sync_folder=/data/adelia/repositories/TEST # schéma de base de données (sensible à la casse) : SYSADEL par défaut, doit être modifié dans le cadre d'une base de données avec multiples schémas spring.jpa.properties.hibernate.default_schema=SYSADEL # uniquement dans le cas d'un SGBD de type PostgreSQL spring.jpa.hibernate.naming.physical-strategy=com.hardis.adelia.repository.naming.PostgresNamingStrategy
Vous devez également fournir un fichier "loader.properties" référençant les jar du pilote jdbc utilisé, par exemple :
loader.properties
loader.path=/path/to/drivers/postgresql-42.2.5.jar
Le fichier "adelsyncserver.jar" doit être présent sur le serveur, Java doit être installé et configuré (jdk8 minimum, jdk11 conseillé).
Pour démarrer le service, positionnez-vous dans le répertoire ".adelia" et lancez la commande Java :
# cd /data/adelia/repositories/TEST/.adelia # java -Dfile.encoding=UTF-8 -jar /path/to/adelsyncserver.jar
Remarque : en cas d'utilisation du jdk8, les paramètres additionnels suivants sont recommandés pour la commande Java : -Xms128m -Xmx384m -XX:+UseG1GC