Friday, May 8, 2020

Oracle WebLogic Server patching in Oracle EPM (Hyperion) 11.1.2.4

Hello Friends,

As part of Oracle recommendations and organization's IT security requirements, we need to keep patch levels of various Hyperion components like Essbase, Planning, HFM, etc. and also WebLogic server up to date.

In this post, we will see a detailed description of how to patch (Patch Set Update 10.3.6.0.190716) Oracle WebLogic Server in EPM (Hyperion) 11.1.2.4 for both Windows and Linux platforms.

We know that WebLogic Server 10.3.6.0 is the default version which comes with EPM (Hyperion) 11.1.2.4 package. In this article, we will see patching WebLogic Server 10.3.6.0 of Hyperion 11.1.2.4 environment with Patch Set Update 10.3.6.0.190716 (Patch 29633432).

Before proceeding further, below are some important points to note: 
  1. We need to patch all WebLogic servers (Admin server and domain servers) of a particular Hyperion environment. 
  2. If previous WebLogic PSUs were applied before, the PSUs need to be rolled back first. (In our case it is not required as we are patching the WebLogic Server base version 10.3.6.0).
  3. You need to perform this patching activity in each and every server of your Hyperion environment.
  4. This article is applicable for both Windows and Linux servers i.e. same steps will apply on both.

 Prerequisites:
************************** 
1- Download Oracle WebLogic Server Patch Set Update 10.3.6.0.190716 from Oracle Support portal link given below (This patch is for Generic platform so the same patch is applicable for both Windows and Linux operating systems): 
(Note: You need to have Oracle support login credentials in order to access the above page.)

You will see following patch download page after login on the above link:

Patching Oracle WebLogic Server in Oracle EPM (Hyperion) 11.1.2.4










2-The downloaded file name is p29633432_1036_Generic.zip. It is advisable to have this zip file placed in a common network path accessible from all the servers of your Hyperion environment for the easy movement of extracted files.

3-You, need to login on each Hyperion server with the same "USER/ACCOUNT" which was used to install & configure Hyperion 11.1.2.4 components on that server. 

4-Stop WebLogic servers (Admin server + domain servers) running on all servers of your Hyperion environment. Make sure there are no processes or services running which could be holding a lock on any jar file. If Node Manager is running, you should also stop that.

5-Stop all Hyperion services and any java processes used by EPM, running on all the servers of your Hyperion Environment.

6-In Task manager check any WebLogic or Hyperion service-related processes should not be running.

Installing Oracle WebLogic Server Patch Set Update 10.3.6.0.190716 (Patch 29633432)
**************************************************************************************
1- On the server create directory cache_dir  under E:\apps\OracleEPM\Middleware\utils\bsu\ if it does not exist (E:\apps\OracleEPM\Middleware\utils\bsu\cache_dir).

2- Unzip p29633432_1036_Generic.zip to a common network path and then copy the extracted files to E:\apps\OracleEPM\Middleware\utils\bsu\cache_dir directory of your Hyperion servers (On both Windows server as well as Linux server. Path will be almost same).

After unzip, your cache_dir directory will have the following 3 files:
  1. MXLE.jar
  2. patch-catalog_26707.xml
  3. README.txt
Patching Oracle WebLogic Server in Oracle EPM (Hyperion) 11.1.2.4


You must make sure that the target directory for unzip has required write and executable permissions for the "USER/ACCOUNT" which was used to install & configure Hyperion on that server.

3- Open E:\apps\OracleEPM\Middleware\utils\bsu folder and Do the following to prevent 'Java OutofMemory Error' during the installation of the patch:
  • Take a backup of bsu.cmd/bsu.sh.
  • Edit bsu.cmd/bsu.sh file and change MEM_ARGS settings to 4GB (4096m):
          set MEM_ARGS=-Xms4096m -Xmx4096m
  • Now save the file bsu.cmd/bsu.sh.  
Patching Oracle WebLogic Server in Oracle EPM (Hyperion) 11.1.2.4















4- Open CMD and Goto E:\apps\OracleEPM\Middleware\utils\bsu and Execute following command to install the path:

Command format:
bsu.cmd -install -patch_download_dir={MW_HOME}/utils/bsu/cache_dir -patchlist={PATCH_ID} -prod_dir={MW_HOME}/{WL_HOME}

Where WL_HOME is the path of the WebLogic home.

On Windows Server command will be:
bsu.cmd -install -patch_download_dir=E:\apps\OracleEPM\Middleware\utils\bsu\cache_dir -patchlist=MXLE -prod_dir=E:\apps\OracleEPM\Middleware\wlserver_10.3

On Linux Server command will be:
./bsu.sh -install -patch_download_dir=/apps/oracle/epm/Middleware/utils/bsu/cache_dir -patchlist=MXLE -prod_dir=/apps/oracle/epm/Middleware/wlserver_10.3

Once the command gets completed and patch is successfully applied, you will see below SUCCESS message:

On Windows Server:

Patching Oracle WebLogic Server in Oracle EPM (Hyperion) 11.1.2.4












On Linux Server:

Patching Oracle WebLogic Server in Oracle EPM (Hyperion) 11.1.2.4





We see the patch has been successfully installed. Now its time to verify the same.

5- Post-Installation verification:
****************************************
To check whether the WebLogic Server version has been updated or not do the following:

1-Goto this path:
E:\apps\OracleEPM\Middleware\wlserver_10.3\server\bin\ 

2- Run below command to set the WebLogic Environment and variables:
setWLSEnv.cmd   (On Linux server: ./setWLSEnv.cmd)

3- Now run following command to check the version:
java weblogic.version (On Linux server too same command: java weblogic.version)

In the below output, 10.3.6.0.190716 is the currently installed WebLogic Server PSU. It confirms now our WebLogic Server has been upgraded from 10.3.6.0 to version 10.3.6.0.190716 :
WebLogic Server 10.3.6.0.190716 PSU Patch for BUG29633432

Patching Oracle WebLogic Server in Oracle EPM (Hyperion) 11.1.2.4
























Do verify on each and every server of your Hyperion environment whether the WebLogic Server has been successfully upgraded or not.

6- Start WebLogic servers of your Hyperion environment.

7- Start all Hyperion services in your environment.

This completes the patching process.

No comments:

Post a Comment