The following steps are required only for SAS Visual Investigator 10.8 releases from Hot Fix 6 onwards.
For SAS Visual Investigator 10.8 releases before Hot Fix 6, refer to SAS Note 69756, "Updating the Java Development Kit (JDK) instructions for Elasticsearch with SAS® Visual Investigator 10.8.”
To update the JDK, complete the following steps:
1. For SAS Visual Investigator 10.8 only, Java 11 is a prerequisite to support OpenSearch 1.3. That OpenSearch distribution is not used by other SAS® Viya® 3.5 products. The Java 11 requirement applies only to OpenSearch and not to SAS® Visual Investigator.
To ensure that the Java version is supported by OpenSearch, see the following link: https://opensearch.org/docs/1.3/install-and-configure/install-opensearch/index/#java-compatibility.
2. Note the path to JDK 11 installation. You can verify the JDK 11 path by running a command similar to the following:
sudo update-alternatives --config java
Note: You should perform steps #3 and #4 on all the nodes in the OpenSearch cluster.
3. Set the OPENSEARCH_JAVA_HOME variable to the installation directory of Java 11.
- Do the following for a new deployment:
- Create a file called sas-viya-svi-elasticsearch-default.service.conf within the /etc/systemd/system/sas-viya-svi-elasticsearch-default.service.d directory.
- Populate the file with the following:
[Service]
Environment="OPENSEARCH_JAVA_HOME=<Path to JDK 11 installation>"
- Run this command to apply the changes:
$ systemctl daemon-reload
- Do the following for an existing deployment:
- Back up and edit the /opt/sas/viya/config/etc/sysconfig/sas-svi-elasticsearch/default/sas-svi-elasticsearch file.
- Then, add the following line:
export OPENSEARCH_JAVA_HOME=’<Path to JDK 11 installation>’
Here is an example
export OPENSEARCH_JAVA_HOME='/usr/lib/jvm/java-11-openjdk-11.0.13.0.8-1.el7_9.x86_64'
4. Restart the sas-viya-svi-elasticsearch-default service on all the nodes in the cluster, if applicable.
5. Check the /opt/sas/viya/config/var/log/svi-elasticsearch/sas-opensearch.log file for any errors. You can also verify whether the JDK 11 path is used by reviewing the sas-opensearch.log file, as shown in the example below:
[2021-12-14T11:33:26,600][INFO ][o.e.n.Node ] [hostname.com] JVM home [/usr/lib/jvm/java-11-openjdk-11.0.13.0.8-1.el7_9.x86_64], using bundled JDK [false]
Operating System and Release Information
SAS System | SAS Visual Investigator | Linux for x64 | 10.8 | | Viya | |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.