JDK 1.8.0_331以降への構成後のJavaのアップグレード

次の回避策は、Essbaseのパッチまたはアップグレードを実行する際に、Javaをアップグレードするために役立ちます。

この回避策は、次のすべてに該当する場合に適用されます。
  • Essbaseのリリースが21.3以前です
  • Essbaseがセキュア接続モードで構成されています
  • インストールがJDK 1.8.0_291バージョン以降で実行されていて、JDKを1.8.0_331バージョン以降にアップグレードします
  • TLSモードが使用されています

Javaシステム・プロパティを追加するためのEssbaseドメイン・マシンでのサーバー起動スクリプトの編集

  1. Essbaseサービスを停止します(サーバーの停止、起動および確認を参照)。
  2. Essbaseがデプロイされているマシンで、<DOMAIN_HOME>/binに移動します。
  3. setStartupEnv.sh (Linuxインストールを使用している場合)またはsetStartupEnv.cmd (Windowsを使用している場合)のバックアップ・コピーを作成します。
  4. 該当するStartupEnvスクリプト(LinuxまたはWindowsインストール用)を編集用に開きます。
  5. ESSBASE-MAN-SVRに関連するセクションを見つけます。このセクションは、Startup parameters for STARTUP_GROUP ESSBASE-MAN-SVRというコメントで始まっています。
  6. 次の内容が含まれた行をSERVER_SYSTEM_PROPERTIESに追加します。
    -Dcom.sun.jndi.ldapURLParsing=LEGACY
    Linuxファイル<DOMAIN_HOME>/bin/setStartupEnv.shの例を次に示します。追加した行を太字で示します。
    # 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"
    Windowsファイル<DOMAIN_HOME>\bin\setStartupEnv.cmdの例を次に示します。次の太字のように変数をSERVER_SYSTEM_PROPERTIESに追加します。
    @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
  7. setStartupEnv.shまたはsetStartupEnv.cmdを保存します。
  8. Essbaseサービスを再起動します。サーバーの停止、開始および確認を参照してください。
  9. Essbase Webインタフェースにログインし、インスタンスにアクセスできることを確認します。