The following steps are required only for SAS Visual Investigator 10.8 releases. If your deployment contains SAS Visual Investigator Hot Fix 1 to Hot Fix 5, you do not need to perform step #4 since the deployment ships with the updated elasticsearch-env file.

For SAS^® Visual Investigator 10.8 releases Hot Fix 6 or later, refer to SAS Note 70557, "Updating the Java Development Kit (JDK) instructions for OpenSearch 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 Elasticsearch 7. That Elasticsearch distribution is not used by other SAS^® Viya^® 3.5 products. The Java 11 requirement applies only to Elasticsearch and not to SAS Visual Investigator. 

To ensure that the Java version is supported by Elasticsearch, see the following link: https://www.elastic.co/support/matrix#matrix_jvm

2. Note the path to JDK 11 installation. You can verify the JDK 11 path by running a command similar to the following:

Note: You should perform steps #3, #4, and #5 on all the nodes in the Elasticsearch cluster.

3. Set the ES_JAVA_HOME variable to the installation directory of Java 11.

1. Do the following for a new deployment:

1. Create a file called sas-viya-svi-elasticsearch-default.service.conf within the /etc/systemd/system/sas-viya-svi-elasticsearch-default.service.d directory.
2. Populate the file with the following:

[Service]

Environment="ES_JAVA_HOME=<Path to JDK 11 installation>"

3. Run this command to apply the changes:

$ systemctl daemon-reload

2. Do the following for an existing deployment: 
   1. Back up and edit the /opt/sas/viya/config/etc/sysconfig/sas-svi-elasticsearch/default/sas-svi-elasticsearch file.
   2. Then, add the following line:

export ES_JAVA_HOME=’<Path to JDK 11 installation>’

Here is an example:
export ES_JAVA_HOME='/usr/lib/jvm/java-11-openjdk-11.0.13.0.8-1.el7_9.x86_64'

4. Note: You do not need to perform this step for SAS Visual Investigator 10.8 Hot Fix 1 and later. 

Edit the elasticsearch-env file in the /opt/sas/viya/home/libexec/elasticsearch-secure/bin directory. 

Then, add the following lines in the elasticsearch-env file, under the # now set the path to java section:

5. Restart the Elasticsearch service on all the nodes in the cluster, if applicable.

6. Check the /opt/sas/viya/config/var/log/svi-elasticsearch/sas-elasticsearch.log file for any errors. You can also verify whether the JDK 11 path is used by reviewing the sas-elasticsearch.log file, as shown in the example below:

Operating System and Release Information