A source code repository can be manually configured to start without using a Windows service. This enables the repository to be hosted on a Unix server for example. This configuration mode requires the shared installation mode (detecting the "user" mode requires the presence of a Windows service on the local machine).
You need to start by creating the source tree view and exporting the initial data into it (either using the source import and export tool or by copying the data from a Git or SVN source control manager) and connecting the required source control manager.
For Git, the following options are suggested:
- the ".adelia" directory should not be versioned (add to .gitignore)
- Git must be configured to not alter carriage returns in the files (git config --global core.autocrlf false). This could interfere with the file signature calculations and make it impossible to compare repository and Adelia environment versions.
For SVN, you need to fulfil the following prerequisites:
- on the Windows platform, you need to have the JavaHL interface DLLs in the JVM path. They can be found in the "svnapi.javahl.win32" or "svnapi.javahl.win64" directory (depending on whether 32-bit or 64-bit JVM) of an Adelia installation.
- on a Unix platform, the SVN command line tool needs to be installed and configured.
Once the export tree view has been initialised, you need to create the ".adelia" sub-directory and the "application.properties" configuration file of the synchronization application (see attached template).
As an example, the TEST environment is shared in the /data/adelia/repositories/TEST directory, the service listens on port 9999.
application.properties
# service connection port - To be opened on the firewall server.port=9999 spring.datasource.url=jdbc:postgresql://databaseserver:5432/TEST spring.datasource.username=postgres spring.datasource.password=password adelia.language=en adelia.ebcdic_characters=#$@ adelia.keep_row_metadata=true # synchronization directory to be configured adelia.sync_folder=/data/adelia/repositories/TEST # (case-sensitive) database schema: SYSADEL by default; it must be modified within the scope of a database with multiple schemas spring.jpa.properties.hibernate.default_schema=SYSADEL # only in the case of a PostgreSQL-type DBMS spring.jpa.hibernate.naming.physical-strategy=com.hardis.adelia.repository.naming.PostgresNamingStrategy
You also need to provide a "loader.properties" file referencing the jars of the jdbc driver used, for example:
loader.properties
loader.path=/path/to/drivers/postgresql-42.2.5.jar
The "adelsyncserver.jar" file must be present on the server, Java must be installed and configured (jdk8 at least, jdk11 recommended).
To start the service, go to the ".adelia" directory and run the Java command:
# cd /data/adelia/repositories/TEST/.adelia # java -Dfile.encoding=UTF-8 -jar /path/to/adelsyncserver.jar
NB: when using jdk8, the following additional parameters are recommended for the Java command: -Xms128m -Xmx384m -XX:+UseG1GC