How to onboard ZFS ( Backup appliance) into OEM EM12c/EM13c

These  steps prepared based on Oracle documentation to enable Monitoring for Oracle ZFS Appliance in Oracle Enterprise Manager 12c Version 12.1.0.5.


OMS Version: 12.1.0.5
Plugin version : 12.1.0.6/12.1.0.7
ZFS plugin      : 2013.06.05.7.14,1-1.1/ 8.7.14

1 .  UNIX SA Task:   Preparing Oracle ZFS Storage Appliance for Oracle Enterprise Manager Monitoring

Log in to the Oracle ZFS Storage Appliance BUI as user root and go to the Maintenance/Workflows tab.

1. Run the Configure for Oracle Enterprise Manager Monitoring workflow, entering and recording the password for the oracle_agent user. You can rerun the workflow later to reset the worksheet, re-enable data sets, or recreate the user.
   
   When you receive the message that oracle_agent already exists and you get asked whether to recreate the user, please answer NO.
   
   The following occurs when the workflow is run:

•        A restricted role user named oracle_user is created for use by the monitoring agent. The restricted access role associated with the oracle_agent user is also named oracle_agent.
•        An analytics worksheet is automatically created to ensure smooth communication between the Cloud Control administrator and the storage administrator tasked with administering the target Oracle ZFS Storage Appliance.

     2. Got to Configuration/USERS and edit the user oracle_agent by clicking the pencil on the very right side of the user’s entry.
      3. Ensure that the “Kiosk user” checkbox is unchecked.
      4. Press APPLY button in case you changed the user.
      5. Enable TLS V1.0 Protocol ( Configuration => HTTPS=> Edit SSL/TSL => check TLS V1.0 Protocol )  ( this step is required only if we use OEM 12.1.0.5 + ZFS plugin
         ( 12.1.0.6/12.1.0.7 , for EM13c, we can skip this step)
      6.Communicate the oracle_agent password to the OEM  Administrator

2: OEM Admin Task :   Discover / Add ZFS Storage Appliances to OEM 12c

Task 2.1 :  Push the plugin to the target agent from OEM
    1. Login to OEM12c Enterprise Manager with an Account with OEM ADMIN privilege
    2 Select Setup → Extensibility → Plug-ins → Servers,Storage & Network → Oracle ZFS Storage Appliance
    3. Select Actions → Deploy On → Management Agent → Continue
    4. Enter the "Management Agent" ( zfsappliance.kh.com:3830) → continue → Next
    5. Once plugin installation is successful.
    6. Login to the agent host ( zfsappliance.kh.com)
    7. Create blackout & Stop agent
          . oraenv
           <AGENT/AGENT12C>
           emctl start blackout ZFS_ONBOARD -nodelevel -d 01:00
           emctl stop agent
    8. cd /data/oracle/product/agent12c/plugins/oracle.sun.oss7.agent.plugin_12.1.0.7.0/scripts/emx/sun_storage_7000
            (  <agent_home>/plugins/oracle.sun.oss7.agent.plugin_12.1.0.7.0/scripts/emx/sun_storage_7000/   )


    9. Backup current Oracle_Grid.jar as Oracle_Grid.jar.bak
         ( cp Oracle_Grid.jar Oracle_Grid.jar.bak )


    10. Download the latest Oracle_Grid.jar  [ This step is required only if we use OMS 12.1.0.5 + plugin version 12.1.0.6/12.1.0.7 + ZFS image version > 8 ( 8.1.14) ]
              ( Alternatively this jar can be downloaded from Note 2384693.1 )


   11. Install latest JDK ( take backup of the current JDK)
 this patch can be downloaded from MOS 1944044.1


           $AGENT_HOME/jdk/bin/java -version
         cd $AGENT_HOME          
          unzip p19138237_16085_Linux-x86-64.zip
    
         ./jdk-6u85-linux-x64.bin


     $AGENT_HOME/jdk/bin/java -version    


 11. start agent & remove blackout
        emctl start agent
        emctl stop blackout ZFS_ONBOARD
        
Task 2.2 : Discover the target in OEM

1. Login to OEM12c Enterprise Manager with an Account with ADD TARGET privilege
2. Select Setup -> Add Target -> Add Targets Manually
3. Select Add Targets Declaratively by Specifying Target Monitoring Properties
4. As Target Type choose Oracle ZFS Storage Appliance
5. For Monitoring Agent click the Search Button and select as

              Management Agent:zfsappliance.kh.com:3830

     
     6. Press Add Manually
   7. In the opening window enter the target details as follows:
        Target
           Target Name: zfsappliance.kh.com
           Monitoring Target Credentials
           UserName: oracle_agent
            Password / Confirm Password: <oracle_agent password>
       Properties            Management Port: 215
            Storage Server Name or IP Address: zfsappliance-netman.kh.com
      Global Properties
           Department: Standard Database Support
           Lifecycle Status: Production
           Location: Germany
           Contact : DB_GLOBAL_DATABASE
           Press OK


8.Verify that target has been added and appears as up and running.


9. Repeat steps 2) – 8) for the all the heads in zfs appliance