The following is a suggestion on how to set up InterFormNG2 on Linux. This has been tested on Ubuntu v20 and it also runs on e.g. Red Hat Linux 8, as long it is not the headless version.
Run as a service with systemd (HTTPS version)
If not already installed, install Java runtime v8 (Ubuntu example):
sudo apt install openjdk-8-jre
For optimal security, it is recommended (but not required) to create a new user that is used exclusively to run InterFormNG:
To create a new user, run these commands:
sudo useradd -m ifng
sudo passwd ifng
Enter password when prompted
sudo usermod -aG sudo ifng
Switch to the newly created user:
sudo -u ifng -s
cd ~
Alternatively, log in as an existing user.
Download the application zip file:
wget http://download.interform400.com/shares/SW/InterFormNG2_Linux.zip
Unzip to an appropriate folder, in the example /opt/InterFormNG2_Linux is used:
sudo mkdir /opt/InterFormNG2_Linux
sudo chown ifng /opt/InterFormNG2_Linux/
unzip InterFormNG2_Linux.zip -d /opt/InterFormNG2_Linux
Within the folder, move the keystore to the correct location:
cd /opt/InterFormNG2_Linux
mkdir keystore
mv interformng2.p12 keystore/
Edit the file /opt/InterFormNG2_Linux/application-default.properties and add this line:
interformng2.privateKey=<RANDOM-STRING>
Where it says <RANDOM-STRING> insert your own randomly generated string of at least 32 characters. This is used as an encryption key, so it is very important to choose a long unique value for each installation.
Note: Instead of setting this value in application-default.properties, you can also set it as an environment variable. However the use of a dot (.) in the name may cause problems.
Ensure that only the user running the application can read the files:
chmod -R 500 /opt/InterFormNG2_Linux/
Create a new file /etc/systemd/system/iformng2.service with the following content (if using a text editor, run it with sudo since this location requires root access):
[Unit]
Description=InterFormNG2
After=syslog.target
[Service]
User=ifng
Environment="INTERFORMNG2_HOME=/home/ifng/NG2Home"
WorkingDirectory=/opt/InterFormNG2_Linux
ExecStart=/bin/java -Xms256M -Xmx4096M -jar /opt/InterFormNG2_Linux/InterformNG2-1.5.1.jar
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
Finally set it to start up automatically after a system restart, and then start the service:
sudo systemctl enable iformng2
sudo service iformng2 start
In case of startup problems, view the console log:
sudo journalctl --unit=iformng2
Additional consideration
It should be considered what users need access to the INTERFORMNG2_HOME directory, and file permissions should be set accordingly for optimal security.
In the example, the ifng user's home folder is used for the InterFormNG home folder (/home/ifng/NG2Home). This may not be a good choice if other users are meant to be able to access this via the file system.
In the example, the maximum memory allocation for InterFormNG2 is set to 4GB via -Xmx4096M. This can be adjusted as needed.
Upgrading an existing installation
To upgrade the Linux installation to a newer version of InterFormNG2, without touching any configuration changes made to application-default.properties or keystores, follow this procedure (this assumes that the recommended installation procedure was followed):
Log in as the user running the application (typically user ifng).
Download the latest version of InterFormNG2:
wget http://download.interform400.com/shares/SW/InterFormNG2_Linux.zip
Unzip to a temporary folder:
unzip InterFormNG2_Linux.zip -d temp/
Stop the running service:
sudo service iformng2 stop
Make the installation folder writable:
chmod -R 700 /opt/InterFormNG2_Linux/
Delete old files (only these files, do not remove other files in the folder):
rm /opt/InterFormNG2_Linux/InterformNG2-x.y.z.jar
(replace x.y.z with the OLD InterFormNG2 version)
rm -r /opt/InterFormNG2_Linux/modules
Copy the new files from the temporary folder:
cp temp/InterformNG2-X.Y.Z.jar /opt/InterFormNG2_Linux/
(replace X.Y.Z with the NEW InterFormNG2 version)
cp -r temp/modules /opt/InterFormNG2_Linux/
Make the files read-only again:
chmod -R 500 /opt/InterFormNG2_Linux/
Edit the existing /etc/systemd/system/iformng2.service (with sudo) and change the version number on InterformNG2-x.y.z.jar to the new version number.
Start the service again:
sudo systemctl daemon-reload
sudo service iformng2 start
Setup of temporary work files on the Linux platform
On the Linux setup above you can change the recommended iformng2.service description above to include temp directory with the highlighted/bold text below:
ExecStart=/bin/java -Xms256M -Xmx4096M -Djava.io.tmpdir=/home/ifng/NG2Home/temp -jar /opt/InterFormNG2_Linux/InterformNG2-1.5.1.jar
