Source:Installing and Managing Java: Difference between revisions

From SEPsesam
(Marked this version for translation)
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<translate><!--T:1-->
<div class="noprint"><languages />
{{Copyright SEP AG‎|en}}
{{Copyright SEP AG‎|en}}
{{draft}}
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation|documentation archive]]}}


==Overview==
<!--T:2-->
<div class="boilerplate metadata" id="Additional resources" style="background-color: #f0f0f0; color:#636f73; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b>Additional resources</b></center>
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo''/5.0.0 ''Jaglion'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation|documentation archive]]}}</div></translate><br />
 
<translate>==Overview== <!--T:3--></translate>
<div class="boilerplate metadata" id="Additional resources" style="background-color: #f0f0f0; color:#636f73; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b><translate><!--T:4--> Additional resources</translate></b></center>


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=Java_Compatibility_Matrix]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:5--> [[File:SEP_next.png|45px|link=Java_Compatibility_Matrix]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[Special:MyLanguage/Java_Compatibility_Matrix|Java Compatibility Matrix]] – [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide|SEP sesam Quick Install Guide]] – [https://www.oracle.com/technetwork/java/java-se-support-roadmap.html Oracle Java SE Support Roadmap]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:6--> See also: [[Special:MyLanguage/Java_Compatibility_Matrix|Java Compatibility Matrix]] – [[Special:MyLanguage/SEP_sesam_Quick_Install_Guide|SEP sesam Quick Install Guide]] – [[Special:MyLanguage/4_4_3_Beefalo:HiDPI_Display_Support|HiDPI Display Support]]</translate>
|}
|}


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:7--> [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Check [[Special:MyLanguage/FAQ#JAVA_version|FAQ]] to find the answers to most common questions.
<translate><!--T:8--> Check [[Special:MyLanguage/FAQ#JAVA_version|FAQ]] to find the answers to most common questions.</translate>
|}
|}


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Troubleshooting.png|45px|link=Troubleshooting_Guide#GUI]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:9--> [[File:SEP Troubleshooting.png|45px|link=Troubleshooting_Guide#GUI]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | Problems with Java or GUI? See [[Special:MyLanguage/Troubleshooting_Guide#GUI|SEP sesam Troubleshooting Guide]] or check the article [https://www.java.com/en/download/help/troubleshoot_java.xml Basic troubleshooting tips for Java issues].
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:10--> Problems with Java or GUI? See [[Special:MyLanguage/Troubleshooting_Guide#GUI|SEP sesam Troubleshooting Guide]] or check the article [https://www.java.com/en/download/help/troubleshoot_java.xml Basic troubleshooting tips for Java issues].</translate>
|}
|}
</div>
</div>
<translate><!--T:11-->
The SEP sesam graphical user interface (GUI) is used to configure and manage SEP sesam and its environment. SEP sesam GUI is platform independent – it is based on Java and requires a Java Runtime Environment. The required Java version depends on SEP sesam version. To ensure that SEP sesam is running correctly, make sure to install and configure a supported Java version. See  [[Special:MyLanguage/Java Compatibility Matrix|Java Compatibility Matrix]] for details.
The SEP sesam graphical user interface (GUI) is used to configure and manage SEP sesam and its environment. SEP sesam GUI is platform independent – it is based on Java and requires a Java Runtime Environment. The required Java version depends on SEP sesam version. To ensure that SEP sesam is running correctly, make sure to install and configure a supported Java version. See  [[Special:MyLanguage/Java Compatibility Matrix|Java Compatibility Matrix]] for details.


<!--T:12-->
Java is required on all systems that serve as [[Special:MyLanguage/SEP_sesam_Glossary#SEP_sesam_Server|SEP sesam Server]], [[Special:MyLanguage/SEP_sesam_Glossary#GUI|SEP sesam GUI client]] or [[Special:MyLanguage/SEP_sesam_Glossary#RDS|SEP sesam Remote Device Server (RDS)]] when [[Special:MyLanguage/SEP_sesam_Glossary#SEP Si3 deduplication store|Si3 deduplication]] is used. Java is not required for [[Special:MyLanguage/SEP_sesam_Glossary#SBC|SEP sesam Client]] (does not provide GUI) or for SEP sesam RDS if Si3 deduplication is not used.
Java is required on all systems that serve as [[Special:MyLanguage/SEP_sesam_Glossary#SEP_sesam_Server|SEP sesam Server]], [[Special:MyLanguage/SEP_sesam_Glossary#GUI|SEP sesam GUI client]] or [[Special:MyLanguage/SEP_sesam_Glossary#RDS|SEP sesam Remote Device Server (RDS)]] when [[Special:MyLanguage/SEP_sesam_Glossary#SEP Si3 deduplication store|Si3 deduplication]] is used. Java is not required for [[Special:MyLanguage/SEP_sesam_Glossary#SBC|SEP sesam Client]] (does not provide GUI) or for SEP sesam RDS if Si3 deduplication is not used.


The two main implementations of Java are ''OpenJDK'' and ''Oracle Java''. As the differences between them are not that significant from the SEP sesam point of view and with [https://www.oracle.com/technetwork/java/java-se-support-roadmap.html Oracle announcing] the end of free support for past versions of Java as well as the Oracle JDK binary no longer be free for use in production from JDK 11 on, SEP sesam introduced support for ''OpenJDK'' LTS (long term support) distributions that are available free of charge. Note that [[Special:MyLanguage/4_4_3_Beefalo:HiDPI_Display_Support|''HiDPI displays'']] are supported with the relevant Java version.
<!--T:13-->
The two main implementations of Java are ''OpenJDK'' and ''Oracle Java''. As the differences between them are not that significant from the SEP sesam point of view and with [https://www.oracle.com/technetwork/java/java-se-support-roadmap.html Oracle announcing] the end of free support for past versions of Java as well as the Oracle JDK binary no longer be free for use in production from JDK 11 on, SEP sesam introduced support for ''OpenJDK'' LTS (long term support) distributions that are available free of charge. Note that [[Special:MyLanguage/4_4_3_Beefalo:HiDPI_Display_Support|''HiDPI displays'']] are supported with the relevant Java version.
 
===Prerequisites=== <!--T:14--></translate>
*<translate><!--T:15--> On Windows, you may need ''Administrator'' privileges to install Java. Make sure to install Java from the provided [http://www.sepsoftware.com/java11 Java download] link before you install [[Special:MyLanguage/SEP_sesam_Quick_Install_Guide#windows|SEP sesam packages]].</translate>
*<translate><!--T:16--> On Linux, all commands have to be executed as a ''root'' user or as an administrative user with the ''sudo'' command prefixed.</translate>
*<translate><!--T:17--> It is recommended to disable your firewall before starting the installation.</translate>
*<translate><!--T:18--> Make sure that system requirements for installing Java are met.</translate>
*<translate><!--T:19-->
If you already have Java installed and you want to use multiple Java versions, make sure to configure the required version as explained in the section [[Special:MyLanguage/4_4_3_Beefalo:Installing_and_Managing_Java#Java_version|Setting preferred Java version for SEP sesam]]. If you do not need multiple Java versions, remove the Java installations not required by SEP sesam.
 
<!--T:20-->
The following procedures show how to install different Java versions on Windows and Linux. SEP sesam recommends installing the SEP sesam Java distribution as described in the following section.</translate>


===Prerequisites===
=={{anchor|sesam_java}}<translate><!--T:66--> Installing SEP sesam Java distribution</translate>==
*On Windows, you may need ''Administrator'' privileges to install Java.
*On Linux, all commands have to be executed as a ''root'' user or as an administrative user with the ''sudo'' command prefixed. Make sure to install Java before you install [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#Linux|SEP sesam packages]].
*It is recommended to disable your firewall before starting installation.
*If you already have Java installed and you want to use multiple Java versions, make sure to configure the required version as explained in the section [[4_4_3_Beefalo:Installing_and_Managing_Java#configuring|Configuring Java]]. If you do not need multiple Java versions, remove the Java installations not required by SEP sesam.


The following procedure shows how to install OpenJDK on Windows and Linux.
<translate><!--T:22-->
How you install Java depends on the operating system as well as on the version you intend to install; you can install OpenJDK or Oracle Java. After installing the required Java version, you may have to enable and configure it.


=={{anchor|install_openjdk}}Installing Java==
<!--T:23-->
How you install Java depends on the operating system as well as on the version you intend to install; you can install OpenJDK or Oracle Java. After installing the required Java version, you may have to enable and configure it. 
===Windows===
*Windows download and installation of Oracle Java is easy and pretty straightforward: Download the [http://www.sepsoftware.com/java11 Java] recommended by SEP sesam directly from the provided link, then run the installer – and you are set.
*Linux download and installation of Oracle Java depend on the type of installation packages: either it is an archive binary file (.tar.gz) or an RPM binary file (.rpm) for Linux platforms, such as Red Hat and SuSE. Ensure that your Java installation type (.tar.gz or .rpm) matches SEP sesam installation package; if the SEP sesam Server is going to be installed as an .rpm package, Java must also be installed as .rpm. 
#Download the required [https://www.oracle.com/technetwork/java/javase/downloads/index.html Oracle Java JDK rpm binary package].
#Install Java using the rpm command. Make sure you change the version number appropriately
rpm -ivh jdk-<span style="color:darkred"><version></span>.rpm
   
   
For example, to install Oracle Java JDK 11 (LTS):
Windows download and installation of ''OpenJDK'' is easy and pretty straightforward if you use the SEP sesam ''Java download'': Download the [http://www.sepsoftware.com/java11 Java] directly from the provided link, then run the installer – and you are set. Note that you need to specify the Java path during the installation of SEP sesam.
  rpm -ivh jdk-<span style="color:darkred">11.0.3_linux-x64_bin</span>.rpm
 
===Linux=== <!--T:24-->
Then exit the root shell (reboot is not required). By default, Java JDK is installed in {{path|/usr/java/}} directory. To install Oracle JDK to a custom directory, use <tt>rpm -ivh –prefix=/<path>/ rpmfile</tt> command. Once installed, you can delete the .rpm file.
 
<!--T:25-->
For SEP sesam 4.4.3 Beefalo, the Java included in the Linux distribution is used, thus no additional steps are needed. However, if you opt for another Java version download then you have to download and install Java following the instructions offered by your Java provider.</translate>
 
=={{anchor|openjdk}}<translate><!--T:67--> Installing OpenJDK</translate>==
 
<translate><!--T:27-->
If you choose not to use the OpenJDK version provided by SEP sesam, download the required version either from [http://developers.redhat.com/products/openjdk/download Red Hat] or from the [https://github.com/ojdkbuild/ojdkbuild GitHub community].
 
===OpenJDK on Windows using the zip archive=== <!--T:28-->
 
<!--T:29-->
To install OpenJDK on Windows using the zip archive, you need to download and unzip the archive.</translate>  
<ol><li><translate><!--T:30--> Sign in with the ''Administrator'' account and download the required version either from [http://developers.redhat.com/products/openjdk/download Red Hat] or from the [https://github.com/ojdkbuild/ojdkbuild GitHub community]. Then extract the zip file into a folder, typically {{path|C:\Program Files\Java\}}. A ''jdk-<no>'' folder is created (where the number depends on your installed version, for example, ''jdk-11'') where the <tt>bin</tt> folder is a direct sub-folder.</translate></li>
<li><translate><!--T:31--> Set the Java path in one of two ways:</translate>
<ol type="I"><li><translate><!--T:32--> Preferably specify the Java path during the installation of SEP sesam.</translate></li>
<li><translate><!--T:33--> Select ''Control Panel'' -> ''System'' -> click ''Advanced'' -> ''Environment Variables''. Then set ''JAVA_HOME'': Under ''System Variables'', click '''New''' and enter the variable name as JAVA_HOME. Enter the variable value as the installation path of the JDK (without the bin sub-folder). Click ''OK'' and ''Apply Changes''.</translate></li> </ol> </li> </ol>
 
<translate>===OpenJDK on Linux=== <!--T:34-->
 
<!--T:35-->
There are multiple ways of installing Java on Linux. Make sure that you select the download version according to your operating system and to execute all commands as a ''root'' user or as an administrative user with the ''sudo'' command prefixed. Verify that your downloaded Java version and your Linux version are compatible; for example, to install OpenJDK11 on Red Hat Enterprise Linux, you must be running at least Red Hat Enterprise Linux 6.
 
<!--T:36-->
Once you have downloaded your version, use the following commands to install Java. For detailed instructions, refer to the respective Linux documentation.</translate> 
;<translate><!--T:37--> Installing on RHEL:Log in with administrator access and [https://developers.redhat.com/products/openjdk/download download] the required version. Install the OpenJDK 11 package by running the command:</translate>
sudo yum install java-11-openjdk-devel
<translate><!--T:38--> For details, check the RHEL documentation and the article [https://developers.redhat.com/blog/2018/11/05/migrating-from-oracle-jdk-to-openjdk-on-red-hat-enterprise-linux-what-you-need-to-know/ Migrating from Oracle JDK to OpenJDK on Red Hat Enterprise Linux: What you need to know].</translate>
 
;<translate><!--T:39--> Installing Java JDK 11 from RPM:Make sure you change the version number to correspond to your downloaded version.</translate>
rpm -ivh jdk-<span style="color:darkred"><translate><!--T:40--> <version></translate></span>
<translate><!--T:41--> For example:</translate>
# rpm -ivh jdk<span style="color:darkred">-11.0.1_linux-x64_bin.rpm
;<translate><!--T:42--> Installing on Debian and Ubuntu:Use the below command to install OpenJDK using the package manager from the default repository. The command will install JDK and JRE; you can also choose to install only the JRE package.</translate>
sudo apt-get install openjdk-11-jre openjdk-11-jdk
 
<translate>==Installing Oracle Java== <!--T:43-->
 
===Windows=== <!--T:44-->
 
<!--T:45-->
Download the [https://www.oracle.com/technetwork/java/javase/downloads/index.html Oracle Java] directly from the provided link, then run the installer – and you are set. Note that you need to specify the Java path during the installation of SEP sesam. For detailed instruction on installing Oracle Java, see [https://docs.oracle.com/en/java/javase/11/install/installation-jdk-microsoft-windows-platforms.html#GUID-A7E27B90-A28D-4237-9383-A58B416071CA Installation of the JDK on Microsoft Windows Platforms].


Now you need to set up JAVA environment variables.
===Linux=== <!--T:46-->


===OpenJDK on Windows===
<!--T:47-->
To install OpenJDK on Windows, you need to download, unzip and modify JAVA_HOME. Alternatively, you can use the .msi installer TBD???
Linux download and installation of Oracle Java depend on the type of installation packages: either it is an archive binary file (.tar.gz) or an RPM binary file (.rpm) for Linux platforms, such as Red Hat and SuSE. Thus you must ensure that your Java installation type (.tar.gz or .rpm) matches the SEP sesam installation package; if the SEP sesam Server is going to be installed as an .rpm package, Java must also be installed as .rpm. The following example is for installing Oracle Java .rpm. For installing the JDK for Linux from .tar.gz and for more information on Oracle Java on Linux, refer to [https://docs.oracle.com/en/java/javase/11/install/installation-jdk-linux-platforms.html#GUID-ADC9C14A-5F51-4C32-802C-9639A947317F Installation of the JDK on Linux Platforms].</translate> 
#Sign in with the ''Administrator'' account and [https://developers.redhat.com/products/openjdk/download download] the required version. Then extract the zip file into a folder, typically {{path|C:\Program Files\Java\}}. A jdk-<no> folder is created (where the number depends on your installed version, for example, jdk-11 folder (where the bin folder is a direct sub-folder).  
<ol><li><translate><!--T:48--> Download the required [https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html Oracle Java JDK rpm binary package].</translate></li>
#Set a PATH:
<li><translate><!--T:49--> Install Java using the <tt>rpm</tt> command. Make sure you change the version number appropriately.</translate></li>
<ol><li>Select Control Panel -> System -> click Advanced -> Environment Variables. Then add the location of the <tt>bin</tt> folder of the JDK installation to the ''PATH variable'' in ''System Variables''.</li>
<syntaxhighlight lang="text"> rpm -ivh jdk-<translate><!--T:50--> <version></translate>.rpm </syntaxhighlight>
The PATH variable example:
<translate><!--T:51--> For example, to install Oracle Java JDK 11 (LTS):</translate>
C:\Program Files\Java\jdk-11\bin"
<syntaxhighlight lang="text"> rpm -ivh jdk-11.0.3_linux-x64_bin.rpm</syntaxhighlight>
<li>Set JAVA_HOME: Under ''System Variables'', click '''New''' and enter the variable name as JAVA_HOME. Then enter the variable value as the installation path of the JDK (without the bin sub-folder). Click OK and Apply Changes.</li></ol>
<li><translate><!--T:52--> Then exit the root shell (reboot is not required). By default, Java JDK is installed in {{path|/usr/java/}} directory. To install Oracle JDK to a custom directory, use <tt>rpm -ivh –prefix=/<path>/ rpmfile</tt> command. Once installed, you can delete the <tt>.rpm</tt> file.</translate></li>
<li><translate><!--T:53--> Now you need to set up JAVA environment variables.</translate></li></ol>


===OpenJDK on Linux===
=={{anchor|verify}}<translate><!--T:68--> Verifying Java version</translate>==
To install OpenJDK on Red Hat Enterprise Linux, you must be running Red Hat Enterprise Linux 6. Verify that your RHE and Java versions are compatible.
#Log in with administrator access and [https://developers.redhat.com/products/openjdk/download download] the required version.


===Verifying Java version===
<translate><!--T:55-->
To verify that your Java version is installed correctly, open up the Command Prompt and type
To verify that your Java version is installed correctly, open up the command prompt and enter:</translate>
  java -version
  java -version


=={{anchor|Java_version}}<translate><!--T:69--> Setting preferred Java version for SEP sesam</translate>==
<translate><!--T:57-->
In case you have installed multiple Java versions on Windows, you may have to modify the SEP sesam Server configuration file <tt><sesam_install_dir>\var\ini\sm.ini</tt> to enable SEP sesam to use the specified Java version. The SEP sesam Server can work with a Java version other than the operating system's default Java version.
<!--T:58-->
<tt>sm.ini</tt> includes a [JAVA] configuration section which specifies the path to the Java version detected during the installation of SEP sesam. You may enter another path for your selected Java version, for example, to configure SEP sesam to use a newly installed version of Java 11 instead of older Java 8.</translate>
<ol>
<li><translate><!--T:59--> Open and modify the path in <tt>java_interpreter</tt> in the configuration file as follows:</translate></li>
<pre>
[JAVA]
java_exit_on_fail=no
java_interpreter=C:\Program Files\Java\jre1.8.0_162\bin\java.exe </pre>
<translate><!--T:60--> change to:</translate>
<pre>
[JAVA]
java_exit_on_fail=no
java_interpreter=C:\Program Files\Java\jdk-11.0.2\bin\java.exe </pre>
<li>
<translate><!--T:61--> If you are changing the Java path on the SEP sesam Server or SEP sesam device server, you have to [[Special:MyLanguage/How_to_Start_and_Stop_SEP_sesam|restart the SEP sesam services]] by using the command <tt>sm_main stop</tt>:</translate> </li>
<pre> C:\Program Files\SEPsesam\bin\sesam>sm_main stop </pre>
<translate><!--T:65--> followed by the <tt>sm_main start</tt> command</translate>:
<pre> C:\Program Files\SEPsesam\bin\sesam>sm_main start</pre>
<translate><!--T:62--> and then close and reopen the SEP sesam GUI.</translate>
<br clear=all>
</ol>
<translate><!--T:63--> Alternatively, use the command <tt>sm_setup set_java_path -f "<Java_path>"</tt> to modify the <tt>sm.ini</tt> configuration. In our example, the command is:</translate>
C:\Program Files\SEPsesam\bin\sesam>sm_setup set_java_path -f "C:\Program Files\Java\jdk-11.0.2"
Set java value in 'C:\ProgramData\SEPsesam\var\ini\sm.ini'
[JAVA]
java_interpreter=C:\Program Files\Java\jdk-11.0.2\bin\java.exe
java_version=11.0.2
ignore_java_home=yes
<translate><!--T:64-->
<div class="noprint">
==See also==
==See also==
[[Special:MyLanguage/Java_Compatibility_Matrix|Java Compatibility Matrix]] – [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide|SEP sesam Quick Install Guide]]
[[Special:MyLanguage/Java_Compatibility_Matrix|Java Compatibility Matrix]] – [[Special:MyLanguage/SEP_sesam_Quick_Install_Guide|SEP sesam Quick Install Guide]] – [[Special:MyLanguage/4_4_3_Beefalo:HiDPI_Display_Support|HiDPI Display Support]] – [https://www.oracle.com/technetwork/java/java-se-support-roadmap.html Oracle Java SE Support Roadmap]</div></translate>

Revision as of 12:11, 6 December 2022

Other languages:

Copyright © SEP AG 1999-2024. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Beefalo/5.0.0 Jaglion. For previous documentation version(s), check documentation archive.


Overview

The SEP sesam graphical user interface (GUI) is used to configure and manage SEP sesam and its environment. SEP sesam GUI is platform independent – it is based on Java and requires a Java Runtime Environment. The required Java version depends on SEP sesam version. To ensure that SEP sesam is running correctly, make sure to install and configure a supported Java version. See Java Compatibility Matrix for details.

Java is required on all systems that serve as SEP sesam Server, SEP sesam GUI client or SEP sesam Remote Device Server (RDS) when Si3 deduplication is used. Java is not required for SEP sesam Client (does not provide GUI) or for SEP sesam RDS if Si3 deduplication is not used.

The two main implementations of Java are OpenJDK and Oracle Java. As the differences between them are not that significant from the SEP sesam point of view and with Oracle announcing the end of free support for past versions of Java as well as the Oracle JDK binary no longer be free for use in production from JDK 11 on, SEP sesam introduced support for OpenJDK LTS (long term support) distributions that are available free of charge. Note that HiDPI displays are supported with the relevant Java version.

Prerequisites

  • On Windows, you may need Administrator privileges to install Java. Make sure to install Java from the provided Java download link before you install SEP sesam packages.
  • On Linux, all commands have to be executed as a root user or as an administrative user with the sudo command prefixed.
  • It is recommended to disable your firewall before starting the installation.
  • Make sure that system requirements for installing Java are met.
  • If you already have Java installed and you want to use multiple Java versions, make sure to configure the required version as explained in the section Setting preferred Java version for SEP sesam. If you do not need multiple Java versions, remove the Java installations not required by SEP sesam.

The following procedures show how to install different Java versions on Windows and Linux. SEP sesam recommends installing the SEP sesam Java distribution as described in the following section.

Installing SEP sesam Java distribution

How you install Java depends on the operating system as well as on the version you intend to install; you can install OpenJDK or Oracle Java. After installing the required Java version, you may have to enable and configure it.

Windows

Windows download and installation of OpenJDK is easy and pretty straightforward if you use the SEP sesam Java download: Download the Java directly from the provided link, then run the installer – and you are set. Note that you need to specify the Java path during the installation of SEP sesam.

Linux

For SEP sesam 4.4.3 Beefalo, the Java included in the Linux distribution is used, thus no additional steps are needed. However, if you opt for another Java version download then you have to download and install Java following the instructions offered by your Java provider.

Installing OpenJDK

If you choose not to use the OpenJDK version provided by SEP sesam, download the required version either from Red Hat or from the GitHub community.

OpenJDK on Windows using the zip archive

To install OpenJDK on Windows using the zip archive, you need to download and unzip the archive.

  1. Sign in with the Administrator account and download the required version either from Red Hat or from the GitHub community. Then extract the zip file into a folder, typically C:\Program Files\Java\. A jdk-<no> folder is created (where the number depends on your installed version, for example, jdk-11) where the bin folder is a direct sub-folder.
  2. Set the Java path in one of two ways:
    1. Preferably specify the Java path during the installation of SEP sesam.
    2. Select Control Panel -> System -> click Advanced -> Environment Variables. Then set JAVA_HOME: Under System Variables, click New and enter the variable name as JAVA_HOME. Enter the variable value as the installation path of the JDK (without the bin sub-folder). Click OK and Apply Changes.

OpenJDK on Linux

There are multiple ways of installing Java on Linux. Make sure that you select the download version according to your operating system and to execute all commands as a root user or as an administrative user with the sudo command prefixed. Verify that your downloaded Java version and your Linux version are compatible; for example, to install OpenJDK11 on Red Hat Enterprise Linux, you must be running at least Red Hat Enterprise Linux 6.

Once you have downloaded your version, use the following commands to install Java. For detailed instructions, refer to the respective Linux documentation.

Installing on RHEL
Log in with administrator access and download the required version. Install the OpenJDK 11 package by running the command:
sudo yum install java-11-openjdk-devel

For details, check the RHEL documentation and the article Migrating from Oracle JDK to OpenJDK on Red Hat Enterprise Linux: What you need to know.

Installing Java JDK 11 from RPM
Make sure you change the version number to correspond to your downloaded version.
rpm -ivh jdk-<version>

For example:

# rpm -ivh jdk-11.0.1_linux-x64_bin.rpm
Installing on Debian and Ubuntu
Use the below command to install OpenJDK using the package manager from the default repository. The command will install JDK and JRE; you can also choose to install only the JRE package.
sudo apt-get install openjdk-11-jre openjdk-11-jdk

Installing Oracle Java

Windows

Download the Oracle Java directly from the provided link, then run the installer – and you are set. Note that you need to specify the Java path during the installation of SEP sesam. For detailed instruction on installing Oracle Java, see Installation of the JDK on Microsoft Windows Platforms.

Linux

Linux download and installation of Oracle Java depend on the type of installation packages: either it is an archive binary file (.tar.gz) or an RPM binary file (.rpm) for Linux platforms, such as Red Hat and SuSE. Thus you must ensure that your Java installation type (.tar.gz or .rpm) matches the SEP sesam installation package; if the SEP sesam Server is going to be installed as an .rpm package, Java must also be installed as .rpm. The following example is for installing Oracle Java .rpm. For installing the JDK for Linux from .tar.gz and for more information on Oracle Java on Linux, refer to Installation of the JDK on Linux Platforms.

  1. Download the required Oracle Java JDK rpm binary package.
  2. Install Java using the rpm command. Make sure you change the version number appropriately.
  3.  rpm -ivh jdk-<version>.rpm
    

    For example, to install Oracle Java JDK 11 (LTS):

     rpm -ivh jdk-11.0.3_linux-x64_bin.rpm
    
  4. Then exit the root shell (reboot is not required). By default, Java JDK is installed in /usr/java/ directory. To install Oracle JDK to a custom directory, use rpm -ivh –prefix=/<path>/ rpmfile command. Once installed, you can delete the .rpm file.
  5. Now you need to set up JAVA environment variables.

Verifying Java version

To verify that your Java version is installed correctly, open up the command prompt and enter:

java -version

Setting preferred Java version for SEP sesam

In case you have installed multiple Java versions on Windows, you may have to modify the SEP sesam Server configuration file <sesam_install_dir>\var\ini\sm.ini to enable SEP sesam to use the specified Java version. The SEP sesam Server can work with a Java version other than the operating system's default Java version.

sm.ini includes a [JAVA] configuration section which specifies the path to the Java version detected during the installation of SEP sesam. You may enter another path for your selected Java version, for example, to configure SEP sesam to use a newly installed version of Java 11 instead of older Java 8.

  1. Open and modify the path in java_interpreter in the configuration file as follows:
  2.  [JAVA]
     java_exit_on_fail=no
     java_interpreter=C:\Program Files\Java\jre1.8.0_162\bin\java.exe 

    change to:

     [JAVA]
     java_exit_on_fail=no
     java_interpreter=C:\Program Files\Java\jdk-11.0.2\bin\java.exe 
  3. If you are changing the Java path on the SEP sesam Server or SEP sesam device server, you have to restart the SEP sesam services by using the command sm_main stop:
  4.  C:\Program Files\SEPsesam\bin\sesam>sm_main stop 

    followed by the sm_main start command:

     C:\Program Files\SEPsesam\bin\sesam>sm_main start

    and then close and reopen the SEP sesam GUI.

Alternatively, use the command sm_setup set_java_path -f "<Java_path>" to modify the sm.ini configuration. In our example, the command is:

C:\Program Files\SEPsesam\bin\sesam>sm_setup set_java_path -f "C:\Program Files\Java\jdk-11.0.2"
Set java value in 'C:\ProgramData\SEPsesam\var\ini\sm.ini'
[JAVA]
java_interpreter=C:\Program Files\Java\jdk-11.0.2\bin\java.exe
java_version=11.0.2
ignore_java_home=yes