Upgrade Java after Configuration to JDK 1.8.0

Upgrade Java after Configuration to JDK 1.8.0_331 or Higher

The following workaround assists you with upgrading Java, while performing an Essbase patch or upgrade.

This workaround applies when all of the following are true:

Essbase release is 21.3 or earlier
Essbase is configured in Secure Connection Mode
Installation was performed on JDK 1.8.0_291 version or later, and JDK will be upgraded to 1.8.0_331 version or later
TLS mode is used

Edit server startup script on Essbase domain machine to add Java system property

Stop Essbase services (see Stop, Start, and Check Servers).
On the machine in which Essbase is deployed, navigate to <DOMAIN_HOME>/bin.
Make a backup copy of setStartupEnv.sh (if you're using a Linux installation) or setStartupEnv.cmd (if using Windows).
Open the relevant StartupEnv script (for Linux or Windows installations) for editing.
Find the section associated with ESSBASE-MAN-SVR. The section begins with comment: Startup parameters for STARTUP_GROUP ESSBASE-MAN-SVR.

Append the line, which includes the following, to SERVER_SYSTEM_PROPERTIES:

-Dcom.sun.jndi.ldapURLParsing=LEGACY

Example of Linux file <DOMAIN_HOME>/bin/setStartupEnv.sh is shown below. The added line is shown in bold:

# Startup parameters for STARTUP_GROUP ESSBASE-MAN-SVR
if [ "${STARTUP_GROUP}" = "ESSBASE-MAN-SVR" ] ; then
# Java system properties. 
      SERVER_SYSTEM_PROPERTIES="-Dopss.version=12.2.1.3 -Digf.arisidbeans.carmlloc=${ORACLE_DOMAIN_CONFIG_DIR}/carml -Digf.arisidstack.home=${ORACLE_DOMAIN_CONFIG_DIR}/arisidprovider -Doracle.security.jps.config={DOMAIN_HOME}/config/fmwconfig/jps-config.xml -Doracle.deployed.app.dir=${DOMAIN_HOME}/servers/${SERVER_NAME}/tmp/_WL_user -Doracle.deployed.app.ext=/- -Dweblogic.alternateTypesDirectory=${COMMON_COMPONENTS_HOME}/modules/oracle.ossoiap,{COMMON_COMPONENTS_HOME}/modules/oracle.oamprovider,${COMMON_COMPONENTS_HOME}/modules/oracle.jps -Doracle.mds.filestore.preferred=${ORACLE_FORCE_MDS_FILESTORE} -Dadf.version=12.2.1.3.0 -Dweblogic.jdbc.remoteEnabled=true -common.components.home=${COMMON_COMPONENTS_HOME} -Djrf.version=12.2.2 -Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.Jdk14Logger -Ddomain.home=${DOMAIN_HOME} -Doracle.server.config.dir={ORACLE_DOMAIN_CONFIG_DIR}/servers/${SERVER_NAME} -Doracle.domain.config.dir=${ORACLE_DOMAIN_CONFIG_DIR} -Dessbase.oracle.home=${ESSBASE_PRODUCT_HOME} -DESS_ES_HOME=${DOMAIN_HOME}/servers/${SERVER_NAME}/aps -Daps.property.file={DOMAIN_HOME}/config/fmwconfig/essconfig/aps/essbase.properties -DESSCS_12C=true -Doracle.bi.12c=true -DESSBASEPATH=${ESSBASE_PRODUCT_HOME}/products/Essbase/EssbaseServer -DARBORPATH=${ARBORPATH} -DESSBASE_CONFIG_PATH={ESSBASE_CONFIG_PATH} -DODBCINI=${DOMAIN_HOME}/config/fmwconfig/essconfig/core/odbc.ini -DODBCINST=${DOMAIN_HOME}/config/fmwconfig/essconfig/core/odbcinst.ini -Dweblogic.security.SSL.minimumProtocolVersion=TLSv1 -weblogic.security.SSL.hostnameVerifier=weblogic.security.utils.SSLWLSWildcardHostnameVerifier -DBI_ORACLE_HOME=${ESSBASE_PRODUCT_HOME} -Dessbase.datasource=essbase_datasource -Djava.awt.headless=true -Dcom.sun.jndi.ldapURLParsing=LEGACY -Dhttp.keepAliveCache.socketHealthCheckTimeout=1 -Dweblogic.security.SSL.ignoreHostnameVerification=true -DODBC_URL='OCI;SERVICE=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=myserver.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.myserver.example.com)))' -DDISCOVERY_URL=https://myserver.example.com:9001/essbase/agent " 
 export SERVER_SYSTEM_PROPERTIES="$SERVER_SYSTEM_PROPERTIES -Dcom.sun.jndi.ldapURLParsing=LEGACY"

Example of Windows file <DOMAIN_HOME>\bin\setStartupEnv.cmd is shown below. Add a variable to SERVER_SYSTEM_PROPERTIES as below in bold:

@REM Startup parameters for STARTUP_GROUP ESSBASE-MAN-SVR
if %STARTUP_GROUP%==ESSBASE-MAN-SVR (
          @REM Java system properties.
set SERVER_SYSTEM_PROPERTIES=-Dopss.version=12.2.1.3 -Digf.arisidbeans.carmlloc=%{ORACLE_DOMAIN_CONFIG_DIR}/carml -Digf.arisidstack.home=%{ORACLE_DOMAIN_CONFIG_DIR}/arisidprovider -Doracle.security.jps.config={DOMAIN_HOME}/config/fmwconfig/jps-config.xml -Doracle.deployed.app.dir=%{DOMAIN_HOME}/servers/%{SERVER_NAME}/tmp/_WL_user -Doracle.deployed.app.ext=/- -Dweblogic.alternateTypesDirectory=%{COMMON_COMPONENTS_HOME}/modules/oracle.ossoiap,{COMMON_COMPONENTS_HOME}/modules/oracle.oamprovider,%{COMMON_COMPONENTS_HOME}/modules/oracle.jps -Doracle.mds.filestore.preferred=%{ORACLE_FORCE_MDS_FILESTORE} -Dadf.version=12.2.1.3.0 -Dweblogic.jdbc.remoteEnabled=true -common.components.home=%{COMMON_COMPONENTS_HOME} -Djrf.version=12.2.2 -Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.Jdk14Logger -Ddomain.home=%{DOMAIN_HOME} -Doracle.server.config.dir={ORACLE_DOMAIN_CONFIG_DIR}/servers/%{SERVER_NAME} -Doracle.domain.config.dir=%{ORACLE_DOMAIN_CONFIG_DIR} -Dessbase.oracle.home=%{ESSBASE_PRODUCT_HOME} -DESS_ES_HOME=%{DOMAIN_HOME}/servers/%{SERVER_NAME}/aps -Daps.property.file={DOMAIN_HOME}/config/fmwconfig/essconfig/aps/essbase.properties -DESSCS_12C=true -Doracle.bi.12c=true -DESSBASEPATH=%{ESSBASE_PRODUCT_HOME}/products/Essbase/EssbaseServer -DARBORPATH=%{ARBORPATH} -DESSBASE_CONFIG_PATH={ESSBASE_CONFIG_PATH} -DODBCINI=%{DOMAIN_HOME}/config/fmwconfig/essconfig/core/odbc.ini -DODBCINST=%{DOMAIN_HOME}/config/fmwconfig/essconfig/core/odbcinst.ini -Dweblogic.security.SSL.minimumProtocolVersion=TLSv1 -weblogic.security.SSL.hostnameVerifier=weblogic.security.utils.SSLWLSWildcardHostnameVerifier -DBI_ORACLE_HOME=%{ESSBASE_PRODUCT_HOME} -Dessbase.datasource=essbase_datasource -Djava.awt.headless=true -Dcom.sun.jndi.ldapURLParsing=LEGACY -Dhttp.keepAliveCache.socketHealthCheckTimeout=1 -Dweblogic.security.SSL.ignoreHostnameVerification=true -DODBC_URL='OCI;SERVICE=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=myserver.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.myserver.example.com)))' -DDISCOVERY_URL=https://myserver.example.com:9001/essbase/agent 
-Dcom.sun.jndi.ldapURLParsing=LEGACY
@REM Java protocol handlers.
set JAVA_OPTIONS=%JAVA_OPTIONS% -Djava.protocol.handler.pkgs=oracle.mds.net.protocol

Save setStartupEnv.sh or setStartupEnv.cmd.
Restart Essbase services. See Stop, Start, and Check Servers.
Log in to Essbase web interface to ensure you can access the instance.