Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Install Java. We recommend the OpenJDK Adoptium Temurin 8 or 11. This is the build of Open JDK that we test with across linux and windows.

...

  1. From the Adoptium home page https://adoptium.net, select Termurin 8 or 11.
    This download is equivalent to the Adopt Open JDK HotSpot build of Java for 64 bit architectures.
  2. Click the Latest release button to download an installation package.
  3. Complete the installation process as directed by the package, accepting all defaults.

Optionally Set the Environment Variable

You can set a system envrionment variable JAVA_HOME if you wish. This can be useful if you have other applications that use Java. However, for the operation of PhixFlow itself, this is not needed, and most operators choose not to add this. Even if you do not set JAVA_HOME, Java programs that need to operate PhixFlow will be added to your path. I.e. you can call them from the command line by using the program name alone.

If you decide to set JAVA_HOME as a system envrionment variable, specify the base installation directory of Java, for example:

  • C:\Program Files\Eclipse Adoptium\jdk-8.0.312.7-hotspot

Configure Security

Update the security settings to allow strong encryption and decryption of files.

...

Note

Setting JAVA_HOME

These instructions assume you do not have a version of Java already installed on your server. If you doThe steps below will set JAVA_HOME as an environment variable for each user on the server.

If you have other programs running on your server, and you need to retain the version have two different versions of Java you currently have, but this is not compatible with PhixFlow, you may need to set up different users to use different versions of Java. Typically this is done by setting the PATH environment variable for certain users. In these instructions JAVA_HOME is set for all users, but this is only a recommended option, and is not mandatory for the operation of PhixFlow.Where a java program is needed for PhixFlow, the documentation will either suggest that you supply the full path, or will refer to JAVA_HOME. If you do not set JAVA_HOME in this way, simply add the full path of the Java installation used by PhixFlowinstalled, you can take a different approach to setting JAVA_HOME for each user. Strictly, PhixFlow does not need JAVA_HOME to be set up as an environment variable to operate. The only places where PhixFlow needs to reference JAVA_HOME are:

  • In the invocation process for Tomcat (in the recommended installation below, this is in a SystemD service script).
  • Where Java programs are used in administrative steps for installing or upgrading PhixFlow. In PhixFlow's documentation, where we refer to JAVA_HOME, simply supply the home path of the installed Java that PhixFlow is using, whether through an environment variable, or by putting it in full on the command line.
  • Prepare the installation directory:
    • If the directory /opt/jdk does not exist, create it:

...

2. Set the crypto.policy to unlimited for the JRE used by PhixFlow, by deleting the #" to uncomment the line:
    - from: # crypto #crypto.policy=unlimited
    - to:       crypto.policy=unlimited