Linux Installation

Requirements

Below are the requirements for Linux setups.

  • The current supported versions of Ubuntu are 18.04 and 20.04.

  • The machine running Ubuntu is required to have at least 2 gigabytes of memory, but it is recommended to have 4 to 8 gigabytes of memory.

  • The required browser to use FIN is Google Chrome, however for this tutorial Firefox will be used to quickly check that FIN is running.

  • The user performing the installation will require root privileges.

  • Java must already be installed and running. OpenJDK 11 is the recommended version. Versions past 8 will not work. Java 7 or 6 may work but is not recommended. Any system requirements of the chosen Java version are the only requirements that FIN will having (including OS, libraries, etc)
    NOTE: See how to install Java at the bottom of this page.

Installation with Zip File

1. Start by contacting your OEM or distributor for the latest zip installation of FIN

2. Once you have the zip, place it on the desktop of Ubuntu for easier use (this tutorial will assume the zip is on the desktop)

3. Download the FIN service file (found at the bottom of this page) and also place it on your desktop

4. Open a terminal and navigate to the /opt directory using cd /opt/

5. Then use the following command to unzip the FIN installation into the /opt folder:

sudo unzip ~/Desktop/FIN-X.X.X.XXXX.zip #X.X.X.XXXX indicates the version of FIN

6. Then we recommend to rename the unzipped FIN installation folder so that we know which version is installed by looking at the folder name. While still in /opt in the terminal, run the below command based on the version installing.

sudo mv finFramework finFramework_5.0.7.3722 //"finFramework" is the name of the unzipped FIN installation. "finFramework_5.0.7.3722" is the name we want to rename it too.

7. Then open the fin.service file with an editor and make the below modifications to it:

  • Rename “fin” (highlighted in turquoise) to renamed FIN installation folder is. In our case “finFramework_5.0.7.3722”.

  • Remove “/current” text (highlighted in yellow) if using the zip file for installation. Otherwise if using the deb file for installation, keep /current in the fin.service file. Look at instructions on how to install deb file below.

  • Then if you wish to increase the heap space of your installation then update the number (in MB, highlighted in purple) after the -Xmx.

8. The file should look like this when you are finished.

9. Save the file and close the editor.

10. Then in the terminal navigate to the Desktop directory with cd ~/Desktop

11. Enter the following commands:

sudo mv fin.service /etc/systemd/system/fin.service sudo systemctl daemon-reload sudo systemctl enable fin sudo systemctl start fin

12. Then open Firefox and navigate to the url: http://localhost:8080

13. If you see the login screen, then you have successfully installed FIN through the zip file.
Note: Credentials on a fresh install are user = su / pass = su. Will be prompted for a new password upon login.

14. You can then close the terminal. FIN will be running now as a service.

Installation with Deb File

1. Start by contacting your OEM or distributor for the latest deb installation of FIN

2. Please place it on the desktop of Ubuntu for easier use (this tutorial will assume the zip is on the desktop)

3. Download the FIN service file (found at the bottom of this page) and also place it on your desktop

4. Then open the terminal and navigate to the Desktop using cd ~/Desktop

5. Then use the following command to install the FIN deb:

6. Follow the instructions on screen

  • It is recommended to leave the Base install folder input as default to prevent changes to the service file

7. You will be asked to input the heap size for FIN, this will not work, the heap will have to be configured in the fin.service file

8. Then open the fin.service file with an editor, if you didn't change the base folder then there should be no changes to be done.

9. If you wish to increase the heap space of your installation then update the number (in MB, highlighted in purple) after the -Xmx..

10. Save the file and close the editor.

11. Then in the terminal, enter the following commands:

12. Rebooting is necessary for the service to start when the deb file installer is used

  • If you wish to postpone this step then exclude the reboot line

13. Once the machine has rebooted open Firefox and navigate to the url: http://localhost:8080

  • If you see the login screen, then you have successfully installed FIN through the deb installer.

  • Note: Credentials on a fresh install are user = su / pass = su. Will be prompted for a new password upon login.

FIN Service File

This is the service file used for both the deb installer and the zip installer.

Please download it from here.

Starting/Stopping/Restarting FIN

The basic syntax is "sudo systemctl <action> fin" with the actions being start, stop, and restart

Install Java

If you need to install Java, you may do so with this command. It will give you a prompt, you can click enter to answer yes to the prompt.