Sun ZFS Storage 7420
 
Exalogic Elastic Cloud X4-2 Eighth Rack
 
Oracle ZFS Storage ZS4-4
 
Oracle ZFS Storage ZS5-4
 
Oracle ZFS Storage ZS3-4
 

PLA-Support>Sun Systems>DISK>ZFS Storage>SN-DK: ZS
 

Applies to:

Symptoms

Inability to monitor ZFS Storage Appliances in Enterprises Manager Cloud Control 12c with Plugin version 12.1.0.7.0 or earlier.

With OS 8.7.10 or later the oracle_zfs_plugin log shows the following message --

Apr 10, 2018 8:44:19 PM com.sun.s7000.client.PrecheckRestAvailable checkVersion
WARNING: Parsing AK hits exception

Changes

Occurs when ZFS Storage Appliance is upgraded to OS 8.7.4 or later.

Cause

There is a change in the way XML-RPC Workflows are authenticated, which is causing all the Enterprise Manager Plugins from version 12.1.0.7.0 and before to fail to show the status of the ZFS Storage Appliance.

Additionally the plugins are not able to parse the AK firmware version strings starting with 8.7.10 and later when pre-checking the availability of the REST service on the appliance.

Solution

The latest versions of plugin do not use XML-RPC workflows and use REST-API calls instead. They also can correctly parse AK firmware version strings.

The ultimate solution is to Upgrade Oracle Manager Cloud Control and the Plugin to latest versions.

Latest Enterprise Manager (EM) version : 13c Release 2.
Latest Plugin version : 13.2.4.0.0 (v3.0.1).

For EM 12c, only the 12.1.0.6.0 (2.1) plugin is supported.
For EM 13c R1, only the 12.1.0.7.0 (2.1.3) plugin is supported.
For EM 13c R2, 13.2.1.0.0 (2.2), 13.2.2.0.0 (2.2.1), 13.2.3.0.0 (3.0) and 13.2.4.0.0 (3.0.1) are supported.

As a workaround till the upgrade to latest versions cannot be done, please follow the instructions below.

Notes: 

1) If you are using EM 12c with Plugin 12.1.0.5.0 we recommend to upgrade to 12.1.0.6.0 only [do not upgrade to 12.1.0.7.0] and then apply the patch fix as mentioned below.
2) If you are using EM 12c with plugin 12.1.0.6.0 then stage the recommended jar file as mentioned below. 
  *  If you are using EM 12c with plugin 12.1.0.7.0 then stage the recommended jar file as mentioned below (this is not a recommended nor supported deployment combination). (Customers should do this only temporarily, prior to upgrade)
3) If you are using EM 13 R1 with plugin 12.1.0.7.0 then stage the recommended jar file as mentioned below.
4) If you are using EM 12c, plan to upgrade EM to EM 13c R2, it is the latest version of Enterprise Manager (Skip EM 13c R1 and skip Plugin 12.1.0.7.0).

Steps to be followed for Plugin version 12.1.0.6.0 or 12.1.0.7.0 -

1)  Choose and download the Oracle_Grid.jar from this MOS Note which corresponds to the version of the ZFS Storage Appliance Enterprise Manager Plugin installed on your system 12.1.0.6.0 / 12.1.0.7.0.

2)  Locate the Oracle_Grid.jar in your agent(s). 
        Usually, it is found here: 
        a) For 12.1.0.7.0 :  <agent_home>/plugins/oracle.sun.oss7.agent.plugin_12.1.0.7.0/scripts/emx/sun_storage_7000/
        b) For 12.1.0.6.0 :  <agent_home>/plugins/oracle.sun.oss7.agent.plugin_12.1.0.6.0/scripts/emx/sun_storage_7000/

3)  Stop the agent(s).
        Using EMCTL commands or using the Enterprise Manager UI.
        E.g. Go to <AGENT_HOME>/bin and run command:  ./emctl stop agent

4)  Backup your Oracle_Grid.jar as Oracle.Grid.jar.bak

5)  Replace / Swap the Oracle_Grid.jar, in ALL your agents (that monitor the ZFS-SA), with the one provided in this MOS Note. Reminder, you need to swap the jar file in all the agents.

6)  Start the agent(s). 
        E.g. Go to <AGENT_HOME>/bin and run command: ./emctl start agent

Now you should be able to see the status of and monitor the ZFS Storage Appliance Targets the same way as earlier. 

IMPORTANT NOTES:

1) If you have been using Health Check Metric Extension or plan to, it will not work along with this patch jar. To use Health Check Metric Extension please upgrade Enterprise Manager and Plugin to the latest versions.

2) This patch will not fix the Provisioning failures, which have been occurring since before this patch is applied. To use Provisioning please upgrade Enterprise Manager and Plugin to the latest versions.

3) After the jar replacement, the Enterprise Manager Plugins Target's home page might display blank or home page charts might generate errors about metaVersion 12.2X, in that case, you will need to restart the OMS. Follow the steps below -
      a)  Go to <AGENT_HOME>/bin and run command :  ./emctl stop agent
      b)  Go to <OMS_HOME>/bin and run command  :    ./emctl stop oms
      c)  Go to <OMS_HOME>/bin and run command  :    ./emctl start oms
      d)  Go to <AGENT_HOME>/bin and run command : ./emctl start agent

4) Another link to reach Enterprise Manager Could Control 12c Documentation - https://docs.oracle.com/cd/E24628_01/index.htm.

5) Link to Oracle Enterprise Manager Plug-in for Oracle ZFS Storage Appliance - https://www.oracle.com/technetwork/oem/grid-control/downloads/zfs-storage-plugin-487867.html

References

This solution has no attachment