English us | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1. Prerequisites1.1 Linux ServerCentOS 7 (EOL 2024-06-30), Ubuntu 16.04, 18.04, 20.04 LTS or Debian 11
We recommend using different disk for the OS (~20 GB) and the application’s data. 1.2. JavaChoose either OpenJDK or Oracle (deprecated) Java Virtual Machine implementation 1.2.1. OpenJDKCentOS 7On the command line, type:
You can check your current java installation by running the following command in a terminal :
Ubuntu DebianOn the command line, type:
1.2.2. Oracle (deprecated)Download and Install the Oracle JDK8u202 : jdk-8u202-linux-x64.tar.gz https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html In the download directory run:
1.3. DATAmaestro Java ArchiveYou will need the datamaestro-app-<version>-jar-with-dependencies.jar Java archive. 1.4. LicenseYou will need a valid license file license.licto run DATAmaestro server. 1.5. Firewall For RedirectionYou will need a firewall software with port redirection feature:. shorewall : https://shorewall.org/ Shorewall documentation firewalld : Firewalld documentation In this guide we will use shorewall. CentOS
EPEL repository must be added : https://fedoraproject.org/wiki/EPEL Ubuntu
2. Installation2.1. datamaestro set upCreate datamaestro-server user:
Move the Java archive to the user home directory:
Add symlink to the java archive:
Change owner of the Java archive:
Then abort by pressing CTRL + C, ENTER. A directory .PEPITe should be created into the home directory of datamaestro-server. Copy license.lic file to /home/datamaestro-server/.PEPITe/DATAmaestro/ Create a file named config and edit as follow :
(Change owner of license.lic and config files if they are not owned by datamaestro-server user) An in-depth configuration document is accessible for a logged in user on the following URL : http://server-hostname/api/debug/help 2.2. datamaestro serviceCreate unit file in /etc/systemd/system/datamaestro.service with the following content:
rem :
Enable and start service:
2.3. Firewall RedirectionDATAmaestro is running under a non-root user. Port < 1024 can not be used by the Java process. We need to forward http(s) requests on port 80 to port 8080 and 443 to 4443. 2.3.1. Configure REDIRECT via shorewallOn Ubuntu, copy the examples files (CentOS already provide the files):
Add theses lines to /etc/shorewall/interfaces :
(Replace eth0 by your interface name) Add theses lines to /etc/shorewall/zones :
Add theses lines to /etc/shorewall/policy :
Add theses lines to /etc/shorewall/rules :
CentOS: /etc/shorewall/shorewall.conf
Ubuntu: Edit /etc/default/shorewall and set
Enable and start service
3. Login
Login via credentials admin/admin and change the admin password in User Administration (cf. User Administration ). |
...