Install Java. We recommend the OpenJDK Adoptium Temurin 8 or 11.
We strongly recommend that you use the latest version of Java.
For versions before Java 1.8.0_151, you must install the JCE Unlimited Strength Jurisdiction Policy files.
Step 1 Download and Install Java
On Windows
- 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. - Click the Latest release button to download an installation package.
- Complete the installation process as directed by the package, accepting all defaults.
On Linux
These instructions assume you do not have a version of Java already installed on your server. If you do, and you need to retain the version 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 the instructions below it is stated that setting JAVA_HOME is optional, but if you have this type of set up, you are recommended to set JAVA_HOME for the users (usually just tomcat) that need to use the particular version of Java you have installed for PhixFlow. If you need further guidance, ask PhixFlow support for advice.
These instructions are based on the notes provided by Adoptium for installation, at the links below. We have suggested some settings, for example, the placement of the downloaded installation package (/tmp
) and the location for the Java installatoin (/opt/jdk
). You can select another location if you wish, provided that they meet any requirements stated in the Adoptium installation notes.
- Prepare the installation directory:
- If the directory
/opt/jdk
does not exist, create it:
- If the directory
sudo mkdir /opt/jdk sudo chmod 755 /opt/jdk
- Download Java from the Adoptium download page:
You can either:
- Download the installation package using a web browser, and transfer the installation package to the directory
/tmp
on the server - Download the installation package directly to the server. To do this, find the URL of the latest download from the link on the website, and use it in a
wget
command as below:
cd /tmp wget https://github.com/adoptium/temurin8-binaries/releases/download/jdk8u312-b07/OpenJDK8U-jdk_x64_linux_hotspot_8u312b07.tar.gz
- Extract the installation package. For example:
sudo tar xfvz /tmp/OpenJDK8U-jdk_x64_linux_hotspot_8u312b07.tar.gz --directory /opt/jdk rm /tmp/OpenJDK8U-jdk_x64_linux_hotspot_8u312b07.tar.gz
PATH or update-alternatives?
Step 2 Configure Security
Update the security settings to allow strong encryption and decryption of files.
1. Go to the JRE directory /lib/security/java.security
file.
If you have installed a JDK rather than a JRE, you will find this directory under JAVA_BASE_INSTALLATION/jre
, for example: C:\Program Files\Eclipse Adoptium\jdk-8.0.312.7-hotspot\jre
2. Set the crypto.policy to unlimited for the JRE used by PhixFlow, by deleting the #" to uncomment the line:
- from: # crypto.policy=unlimited
- to: crypto.policy=unlimited
Step 3 Optionally Set the Environment Variable
Some installation processes set the environment variable JAVA_HOME for you automatically. If not, you do not need to set it. However, if you want to set it, specify the base installation directory of Java, for example:
- On Windows:
C:\Program Files\Eclipse Adoptium\jdk-8.0.312.7-hotspot
- On Linux:
/usr/lib/jvm/adoptopenjdk-11-hotspot-amd64