Configuration manuelle d'un dépôt de code source

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é ou du mode multi-environnement (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é. Alternativement, vous pouvez créer un dépôt vide et exporter les données a posteriori depuis un poste client à l'aide de la commande "syncsetup <ENVIRONNEMENT> -export", puis ajouter manuellement, si nécessaire, les sources générées par l'export au gestionnaire de version de sources.

En mode normal, les sources des objets sont situées dans le sous-répertoire "src" de l'installation du dépôt. En mode multi-environnement, le répertoire des sources associé à un environnement est <NOM_ENVIRONNEMENT>\<SCHEMA_ENVIRONNEMENT> (le schéma étant SYSADEL pour une configuration par défaut).

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.

# 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

 # 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.datasource.hikari.schema=SYSADEL

adelia.language=fr
adelia.ebcdic_characters=$£à
adelia.keep_row_metadata=true

# répertoire de synchronisation à configurer
adelia.sync_folder=/data/adelia/repositories/TEST

En mode multi-environnement, le fichier application.properties ne contient pas les informations de connexion à la base de données.

# port de connexion du service - à ouvrir sur le pare-feu
server.port=9999

adelia.language=fr
adelia.ebcdic_characters=$£à
adelia.keep_row_metadata=true

# gestionnaire de base de données utilisé (Oracle = 1, DB2 = 2, SQL Server = 4, MySQL = 16, PostgreSQL = 32)
adelia.dbms=32

# répertoire de synchronisation à configurer
adelia.sync_folder=/data/adelia/repositories/TEST_SHARED

En mode multi-environnement, les informations de connexion sont spécifiées dans le fichier "datasource.ini". A noter que le service détecte automatiquement les modifications dudit fichier et charge/décharge dynamiquement les connexions quand c'est nécessaire.

[Databases]
;
; Cette section liste les bases autorisées et le serveur sur lequel elles sont installées.
; Cela sert à éviter la confusion entre deux bases de même nom mais issues de serveur différents
;
; Le nom de la base et le nom du serveur (sans suffixe DNS) doivent être indiqués en majuscules
;
BDCADEL=SERVEURADELIA
ADELIA=SERVEURADELIA

[SYSADEL/BDCADEL]
;
; Chaque environnement Adélia (SCHEMA/BASE) dispose de sa propre section imposant les paramètres de connexion. La 
; spécification du schéma dans le nom de la section est obligatoire même s'il s'agit du schéma par défaut SYSADEL.
;
; Le fichier peut être modifié "à chaud" sans redémarrer le service, pour ajouter ou retirer un environnement ou changer un mot de passe.
; Les déclarations doivent être consistantes entre la section "Databases" et les sections des environnements.
;
url=jdbc:postgresql://SERVEURADELIA:5432/BDCADEL
username=postgres
password=mwdes(xxxxxx)
[SCHEMA1/ADELIA]
url=jdbc:postgresql://SERVEURADELIA:5432/ADELIA
username=postgres
password=mwdes(xxxxxx)
[SCHEMA2/ADELIA]
url=jdbc:postgresql://SERVEURADELIA:5432/ADELIA
username=postgres
password=mwdes(xxxxxx)

Vous devez également fournir un fichier "loader.properties" référençant les jar du pilote jdbc utilisé, par exemple :

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

↑ Haut de page