Linux

Overview

You like to install or upgrade one of the products provided from Fortified ID on a Linux server. Installation is done by running a generic Bash script for all applications that uses a properties to define product and account.

Prerequisite

There are some prerequisite before continuing with install/upgrade.

  • Linux OS 64-bit.

  • Unzip installed in the Linux OS.

  • cURL installed in the Linux OS

  • Contact Fortified ID support to get the download credentials file, customer_access_credentials.json.

  • Latest version of the Bash script and property file.

  • Hardware requirement is depend on usage of the application

    • Minimum of 10 GB of drive space

    • Minimum 4 GB of RAM

    • Integrity is not CPU intensive; two virtual CPUs should work for most scenarios

Installation

In a terminal run the following commands to install the Web service.

  1. Install Azul Zulu Java 17 using the guides that you can find using this link https://docs.azul.com/core/# In the steps below we will install Java on Ubuntu.

    1. Import public key

      sudo apt install gnupg ca-certificates curl
      curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg
      echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list
    2. Run the following command to update available packages.

      sudo apt update
    3. Run the following command to

      sudo apt install zulu17-jre
    4. Verify the Java installation, run the java -version command. You should see the version of the installed Java.

      java -version
  2. Create or use an existing folder to download or copy the installation files to.

  3. Change to the folder that will be used for the installation files.

  4. Run the following command to download the installation files

    curl -X GET https://share.fortifiedid.se/index.php/s/CXGr7dW2rPJWEDi/download -o fortifiedid_online_installation.zip
  5. Run the following command to unzip the files

    unzip fortifiedid_online_installation.zip
  6. Open fortifiedid_online_installation.properties with a text editor

    1. Uncomment the lines in the Web section except for the first row. There is no support to install more than one product at a time.

    2. Change the APP_LINK with the download link for the Web installation that you have got from Fortified ID.

    3. Change INSTALLATION_PATH to the folder where you would like to install the service.

    4. Example of the changes except for the APP_LINK path

      # Install WEB
      APP_LINK=<The provided path for the product>
      INSTALLATION_PATH=/opt/fortifiedid/web
      DOWNLOADED_PRODUCT_FILENAME=web
    5. Save the file when done.

  7. Copy the customer_access_credentials.json that you should have received from Fortified ID file to the folder with the installation files

  8. Run the following command to install the Web service. Add sudo in front of the command if root privilege is need to install the service.

    ./fortifiedid_online_installation.sh
    • Type Y to continue

  9. Change to the <INSTALLATION_PATH>/customer folder

  10. Run the following command to start the Web service. Add sudo in front of the command if root privilege is need to run the service.

    ./startup.sh -c Node ../customer/config/config.json
  11. Installation is complete

  12. Now you are ready to start working with your Fortified ID product. Tip: Check out our use cases to get a head start!

Upgrade

Upgrade of an existing installation is done the same way as when you do a clean installation. Same Bash script and property file. See previous section. When uppgradering, two things to notice:

  • In the fortifiedid.properties file update the APP_LINK setting with the new link .

  • Folders, /application and /JRE, will be replaced during upgrade. Do not store any custom data there. The folder called /customer will not be replaced since it contains your customer data.

Restart

Stop the service by running ./stop.sh

Start the service again by running ./startup.sh -c Node ../customer/config/config.json