<?xml version="1.0" encoding="UTF-8" ?>
<?xml-stylesheet type="text/xsl" href="menus.xsl"?>

<!-- 
Filename:  exalogic.xml
Author:    merickso
Created:   03-May-2012

Decription:
Menu for Exalogic diagnostics.

Documentation:    

Change History:
03-May-12 - merickso - Creation
01-Jun-12 - fixed case on run_profile=Exalogic_Raid -failed as Exalogic_RAID
27-Jul-12 - Bug 14107774 - added Switch menu and rda_16
20-Aug-12 - Bug 14203407 - ADD HELP DETAILS FOR EXALOGIC STEP PATCH INFORMATION
27-Aug-12 - Bug 14203407 - QA - fix text alignment/wrapping issues
29-Aug-12 - Bug 14107774 - in rda_16: added Enter the switch user password

Pre-Installation:
-->

<menus>

<menu>
    <menu_name>main</menu_name>
    <menu_title>Oracle Diagnostics: Exalogic</menu_title>
    <menu_text><![CDATA[  This menu enables you to collect Exalogic diagnostic data 
  based on a specific issue. Exalogic system components have 
  been grouped into the categories below. 
    
  Select one of the following options:
    (1) Node            
    (2) Hardware
    (3) Network
    (4) Patch Information
  
    (H)elp   (E)xit  
   
   ]]></menu_text>
    <menu_help><![CDATA[  Exalogic Main Menu
     
  This menu help describes available options for troubleshooting 
  exalogic issues.
      
  Explanation of available options:
    (1) Node
 
    (2) Hardware
                  
    (3) Network
      
    (4) Patch Information
              
    ]]></menu_help>
    <menu_map>1:menu:Node</menu_map>
    <menu_map>2:menu:HW</menu_map>
    <menu_map>3:menu:Network</menu_map>
    <menu_map>4:menu:Patch</menu_map>
    <menu_map>M:menu:main</menu_map>
</menu> 

<menu>
    <menu_name>Node</menu_name>
    <menu_title>Exalogic: Node Diagnostics</menu_title>
    <menu_text><![CDATA[  This menu enables you to collect exalogic node diagnostics based
  on a specific issue. The Exalogic node components are organized
  by categories for improved diagnostic collection and analysis.

  Select one of the following options:
    (1) Failed Drives
    (2) ILOM

    (M)ain    (B)ack    (H)elp   (E)xit]]></menu_text>
    <menu_help><![CDATA[  Exalogic Node Diagnostics
    
  Explanation of available options:
    (1) Failed Drives 
        o This option executes the "Exalogic_DriveFailure" RDA profile  
          which can be used in conjunction with other profiles to collect  
          information for troubleshooting Oracle Exalogic drive failure 
          problems.
          
    (2) ILOM
        o This option executes the "Exalogic_Ilom" RDA profile which is  
          useful in troubleshooting Ilom related issues like malfunction 
          of any sensors, machine or system related details, SDR information 
          and Ilom network information.
 
    ]]></menu_help>
    <menu_map>1:command:rda_1</menu_map>
    <menu_map>2:command:rda_2</menu_map>
    <menu_map>M:menu:main</menu_map>
    <menu_map>B:menu:main</menu_map>
</menu>


<menu>
    <menu_name>HW</menu_name>
    <menu_title>Exalogic: Hardware Diagnostics</menu_title>
    <menu_text><![CDATA[  This menu enables you to collect Exalogic hardware diagnostic 
  data based on a specific issue. Exalogic system components 
  have been grouped into the categories below. 

  Select one of the following options:
    (1) Exalogic RAID Card
    (2) Failed Drives
    (3) Performance
    (4) Exalogic Rack Temperature

    (M)ain    (B)ack    (H)elp   (E)xit
]]></menu_text>
    <menu_help><![CDATA[  Exalogic Hardware Diagnostics Help
    
  Explanation of available options:
    (1) Exalogic RAID card
        o This option executes the "Exalogic_RAID" RDA profile which is 
          used to troubleshoot issues with Internal RAID cards present 
          in Exalogic machine.    
    
    (2) Failed Drives
        o This option executes the "Exalogic_DriveFailure" RDA profile  
          which canbe used in conjunction with other profiles to collect 
          information for troubleshooting Oracle Exalogic drive failure 
          problems.
          
    (3) Performance
        o This option executes the "Exalogic_HealthHwSw" RDA profile which is 
          used to determine the current Hardware/Firmware and Software version 
          information on the Exalogic machine.
          
    (4) Exalogic Temp
        o This option executes the "Exalogic_Temp" RDA profile which can be  
          used to determine the Ambient temperature information across all  
          the compute nodes in an Exalogic machine.
		
]]></menu_help>
    <menu_map>1:command:rda_3</menu_map>
    <menu_map>2:command:rda_1</menu_map>
    <menu_map>3:command:rda_4</menu_map>
    <menu_map>4:command:rda_5</menu_map>
    <menu_map>M:menu:main</menu_map>
    <menu_map>B:menu:main</menu_map>
</menu>


<menu>
    <menu_name>Net</menu_name>
    <menu_title>Exalogic: Network Diagnostics</menu_title>
    <menu_text><![CDATA[  This menu enables you to collect Exalogic network diagnostic 
  data based on a specific issue. Exalogic network components 
  have been grouped into the categories below. 

  Select one of the following options:
    (1) Performance (Network Health)
    (2) Network Cabling
    (3) IB Switch
    (4) IB Traffic
    (5) General

    (M)ain    (B)ack    (H)elp   (E)xit
]]></menu_text>
    <menu_help><![CDATA[  Exalogic Network Diagnostics Help
    
  Explanation of available options:
    (1) Performance (Network Health)
        o This option executes the "Exalogic_HealthNet" RDA profile which 
          can be used to collect information about the current status of the 
          network across the entire Exalogic machine. It will print details 
          about the network topology and also any errors in the InfiniBand 
          fabric. This profile can be used to troubleshoot any 	network 
          performance issues.
    
    (2) Network Cabling
        RDA will execute for the following module:
          o Exalogic_NetworkCabling
          
    (3) IB Switch
        RDA will execute for the following module with and without root
        level data:
          o Exalogic_IbSwitch
          
    (4) IB Traffic
        o This option executes the "Exalogic_IbSwitch" RDA profile which checks 
          the availability and correct functionality of all the IB switches 
          inside Exalogic rack. This profile can be run in conjunction with 
          Network Cabling" option in the menu to collect complete on all the 
          switches in Exalogic Rack and verify the correct connectivity and 
          functionality of all the cables.
    
    (5) General
        o This option executes the "Exalogic_Network" RDA profile which checks 
          for any configuration issues in the network on any given compute node. 
          This profile collects in addition to collecting the information about 
          the network topology.
 
]]></menu_help>
    <menu_map>1:command:rda_6</menu_map>
    <menu_map>2:command:rda_7</menu_map>
    <menu_map>3:menu:Switch</menu_map>
    <menu_map>4:command:rda_9</menu_map>
    <menu_map>5:command:rda_10</menu_map>
    <menu_map>M:menu:main</menu_map>
    <menu_map>B:menu:main</menu_map>
</menu>
<menu>
    <menu_name>Patch</menu_name>
    <menu_title>Exalogic: Patch Information</menu_title>
    <menu_text><![CDATA[  This menu enables you to collect Exalogic patching information.
    
  Select one of the following options:
    (1) Patch Information

    (M)ain    (B)ack    (H)elp   (E)xit
]]></menu_text>
    <menu_help><![CDATA[  Exalogic Patch Information Help
     
  Explanation of available options:
    (1) Patch Information
        o Select this option to collect diagnostic data based on 
          the "Exalogic_Patch" RDA profile which displays information about 
          the current running Exalogic PSU/Firmware version and the version 
          upgrade history. This will also print the details of RAID card
          Firmware version.
 
]]></menu_help>
    <menu_map>1:command:rda_11</menu_map>
    <menu_map>M:menu:main</menu_map>
    <menu_map>B:menu:main</menu_map>
</menu>


<menu>
    <menu_name>HW</menu_name>
    <menu_title>Exalogic: Hardware Diagnostics</menu_title>
    <menu_text><![CDATA[  This menu enables you to collect Exalogic hardware diagnostic 
  data based on a specific issue. Exalogic system components 
  have been grouped into the categories below. 

  Select one of the following options:
    (1) Exalogic RAID Card
    (2) Failed Drives
    (3) Performance
    (4) Exalogic Rack Temperature

    (M)ain    (B)ack    (H)elp   (E)xit
]]></menu_text>
    <menu_help><![CDATA[  Exalogic Hardware Diagnostics Help
    
  Explanation of available options:
    (1) Exalogic RAID card
        o This option executes the "Exalogic_DriveFailure" RDA profile which 
          can be used in conjunction with other profiles to collect information 
          for troubleshooting Oracle Exalogic drive failure problems.
          
    (2) Failed Drives
        o This option executes the "Exalogic_DriveFailure" RDA profile which can 
          be used in conjunction with other profiles to collect information for 
          troubleshooting Oracle Exalogic drive failure problems.
          
    (3) Performance
        o This option executes the "Exalogic_HealthHwSw" RDA profile which is 
          used to determine the current Hardware/Firmware and Software version 
          information on the Exalogic machine.
          
    (4) Exalogic Temp
        o This option executes the "Exalogic_Temp" RDA profile which can be used 
          to determine the Ambient temperature information across all the 
          compute nodes in an Exalogic machine

]]></menu_help>
    <menu_map>1:command:rda_3</menu_map>
    <menu_map>2:command:rda_1</menu_map>
    <menu_map>3:command:rda_4</menu_map>
    <menu_map>4:command:rda_5</menu_map>
    <menu_map>M:menu:main</menu_map>
    <menu_map>B:menu:main</menu_map>
</menu>


<menu>
    <menu_name>Network</menu_name>
    <menu_title>Exalogic: Network Diagnostics</menu_title>
    <menu_text><![CDATA[  This menu enables you to collect Exalogic network diagnostic 
  data based on a specific issue. Exalogic network components 
  have been grouped into the categories below. 

  Select one of the following options:
    (1) Performance (Network Health)
    (2) Network Cabling
    (3) IB Switch
    (4) IB Traffic
    (5) General

    (M)ain    (B)ack    (H)elp   (E)xit
]]></menu_text>
    <menu_help><![CDATA[  Exalogic Network Diagnostics Help
    
  Explanation of available options:
    (1) Performance - Network Health
        o This option executes the "Exalogic_HealthNet" RDA profile which 
          can be used to collect information about the current status of the 
          network across the entire Exalogic machine. It will print details 
          about the network topology and also any errors in the InfiniBand 
          fabric. This profile can be used to troubleshoot any 	network 
          performance issues.
    
    (2) Network Cabling
        o This option executes the "Exalogic_Gateway" RDA profile which 
          collects information for troubleshooting Oracle Exalogic IB Gateway 
          connectivity problems. The information will be collected from all the 
          Gateways present in the Exalogic Rack and the relevant log files will 
          be gathered from the GW's. This profile can be run in conjunction with
          "IBswitch" option in the menu to collect complete details on all the 
          switches in Exalogic Rack. This is used to determine if there are any 
          issues with how the cabling is done in the network. 
          
    (3) IB Switch
        o RDA will execute the Exalogic_IbSwitch module: 
        o An additional step adds root level data to the collection. This is
          optional and requires root user credentials
          
    (4) IB Traffic
        o This option executes the "Exalogic_IbSwitch" RDA profile which checks 
          the availability and correct functionality of all the IB switches 
          inside Exalogic rack. This profile can be run in conjunction with 
          Network Cabling" option in the menu to collect complete on all the 
          switches in Exalogic Rack and verify the correct connectivity and 
          functionality of all the cables.
    
    (5) General
        o This option executes the "Exalogic_Network" RDA profile which checks 
          for any configuration issues in the network on any given compute node. 
          This profile collects in addition to collecting the information about 
          the network topology.
 
]]></menu_help>
    <menu_map>1:command:rda_6</menu_map>
    <menu_map>2:command:rda_7</menu_map>
    <menu_map>3:menu:Switch</menu_map>
    <menu_map>4:command:rda_9</menu_map>
    <menu_map>5:command:rda_10</menu_map>
    <menu_map>M:menu:main</menu_map>
    <menu_map>B:menu:main</menu_map>
</menu>

<menu>
   <menu_name>Switch</menu_name>
   <menu_title>IB Switch</menu_title>   
   <menu_text><![CDATA[          
  Your IB Switch is about to be diagnosed.

  Select one of the following options:
    (1) Run A New Collection
    (2) Add Root Level Data To The Collection

    (M)ain    (B)ack    (H)elp    (E)xit  
   ]]></menu_text>
   <menu_help>
  Network: IB Switch

  Explanation of available options:
    (1) Run A New Collection
        RDA will execute for the Exalogic_IbSwitch module:

    (2) Add Root Level Data To The Collection
        RDA will add root level data to the following module:
          o Exalogic_IbSwitch
              - root access data must be provided
              - root data can only be added to an existing collection
              - option 1 must be run before at least once before this option

   </menu_help>
   <menu_map>1:command:rda_8</menu_map>
   <menu_map>2:command:rda_16</menu_map>
   <menu_map>M:menu:main</menu_map>  
   <menu_map>B:menu:Net</menu_map>
   
</menu> 
<commands>

  <command>
  <command_menu>rda_1</command_menu>
  <command_title>Exalogic Failed Drives</command_title>
  <command_descr><![CDATA[
  Command Summary
    
  This command executes the "Exalogic_DriveFailure" RDA profile/module 
  which can be used in conjunction with other profiles to collect 
  information for troubleshooting Oracle Exalogic drive failure problems. 
      
  Input Requirements
    o root user credentials 
    
  Ouput Details
    o PCI Devices Configuration
    o IPMI Information
    o Product Serial Number
        
    ]]></command_descr>
  <command_type>Rda</command_type>
  <command_args><![CDATA[run_profile=Exalogic_DriveFailure]]></command_args>
  </command>
  <command>
    <command_menu>rda_2</command_menu>
     <command_title>Exalogic ILOM</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_Ilom" RDA profile/module which is 
  useful in troubleshooting Ilom related issues like malfunction of any 
  sensors, machine or system related details, SDR information and Ilom 
  network information.
      
  Input Requirements
    o root user credentials 
    
  Ouput Details
    o ILOM related Events, sensors, Network Information and SDR information
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_Ilom</command_args>
  </command>
    <command>
    <command_menu>rda_3</command_menu>
     <command_title>Exalogic RAID</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_RAID" RDA profile/module which is used 
  to troubleshoot issues with Internal RAID cards present in Exalogic Machine.
      
  Input Requirements
    o root user credentials 
    
  Ouput Details
    o MegaRAID events
    o SSD Disk Information
    o MegaRAID Battery information
    o RAID hardware configuration/status 
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_Raid</command_args>
  </command>
    <command>
    <command_menu>rda_4</command_menu>
  <command_title>Exalogic Harware/Software Health</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_HealthHwSw" RDA profile/module which  
  is usedto determine the current Hardware/Firmware and Software version 
  information on the Exalogic machine.
      
  Input Requirements
    o root user credentials
    
  Ouput Details
    o CheckHWnFWProfile
    o CheckSWProfile
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_HealthHwSw</command_args>
  </command>
    <command>
  <command_menu>rda_5</command_menu>
  <command_title>Exalogic Temp</command_title>
  <command_descr>
  Command Summary
    
  This command executes the "Exalogic_Temp" RDA profile/module which 
  can be used to determine the Ambient temperature information across 
  all the compute nodes in an Exalogic machine.
      
  Input Requirements
    o Root user credentials
    
  Ouput Details
    o Inlet Ambient Temperature across all nodes
    
  </command_descr>
  <command_type>Rda</command_type>
  <command_args><![CDATA[run_profile=Exalogic_Temp]]></command_args>
  </command>
    <command>
    <command_menu>rda_6</command_menu>
     <command_title>Exalogic Network Health</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_HealthNet" RDA profile/module which
  can be used to collect information about the current status of the
  network across the entire Exalogic machine. It will print details about
  the network topology and also any errors in the InfiniBand fabric. This
  profile can be used to troubleshoot any network performance issues.
      
  Input Requirements
    o Root user credentials
    
  Ouput Details
    o InfiniBand diagnostic commands, including ibnetdiscover and verify-topology 
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_HealthNet</command_args>
  </command>
    <command>
    <command_menu>rda_7</command_menu>
     <command_title>Exalogic Gateway</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_Gateway" RDA profile/module which 
  collects information for troubleshooting Oracle Exalogic  IB Gateway 
  connectivity problems. The information will be collected from all the 
  Gateways present in the Exalogic Rack and the relevant log files will 
  be gathered from the GW's. This profile can be run in conjunction with 
  IBswitch" option in the menu to collect complete details on all the 
  switches in Exalogic Rack .This is used to determine if there are any 
  issues with how the cabling is done in the network.
      
  Input Requirements
    o Root user credentials
    
  Ouput Details
    o NM2 Gateways inside the Exalogic RACK including Gateway version  
      details, errors or faults and Subnet manager 
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_Gateway</command_args>
  </command>
    <command>
    <command_menu>rda_8</command_menu>
     <command_title>Exalogic IB Switch</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_IbSwitch" RDA profile/module which 
  checks the availability and correct functionality of all the IB 
  switches inside Exalogic rack. This profile can be run in conjunction 
  with Network Cabling" option in the menu to collect complete on all 
  the switches in Exalogic Rack and verify the correct connectivity and 
  functionality of all the cables.
      
  Input Requirements
    o Root user credentials
    
  Ouput Details
    o Infiniband Switches inside the Exalogic RACK, which includes 
      leaf switches and spine switches (version details and errors 
      or faults in the InfiniBand switches, and Subnet manager 
      information).
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_IbSwitch</command_args>
  </command>
    <command>
    <command_menu>rda_9</command_menu>
     <command_title>Exalogic IB Fabric</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_IbFabric" RDA profile/module which 
  checks the functionality of the Infiniband fabric , verifies the 
  correct topology as determined by the factory configuration and collects 
  IB diagnostic information. This is useful for determining any issues with 
  the Infiniband traffic inside Exalogic Rack.
      
  Input Requirements
    o Root user credentials
    
  Ouput Details
    o Infiniband errors
    o Infiniband Ports link status
    o IB topology information
    o Diagnostic logs
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_IbFabric</command_args>
  </command>
    <command>
    <command_menu>rda_10</command_menu>
     <command_title>Exalogic Network</command_title>
    <command_descr>
  Command Summary
    
  This command executes the "Exalogic_Network" RDA profile/module which 
  checks for any configuration issues in the network on any given compute 
  node. This profile collects in addition to collecting the 
  information about the network topology.
      
  Input Requirements
    o Root user credentials
    
  Ouput Details
    o network topology information
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile=Exalogic_Network</command_args>
  </command>
    <command>
  <command_menu>rda_11</command_menu>
  <command_title>Exalogic Patch</command_title>
  <command_descr>
  Command Summary

  This command executes the "Exalogic_Patch" RDA profile/module which 
  displays information about the current running Exalogic PSU/Firmware 
  version and the version upgrade history. This will also print the 
  details of RAID card Firmware version.

  Input Requirements
    o Root user credentials
    
  Ouput Details
    o Exalogic PSU/Firmware version 
    o version upgrade history details 
        
  </command_descr>
  <command_type>Rda</command_type>
  <command_args>run_profile=Exalogic_Patch</command_args>
  </command>
  
      <command>
    <command_menu>rda_16</command_menu>
    <command_title>Exalogic Ib Switch Root</command_title>
    <command_descr>
  Command Summary
    
  Runs Exalogic_IbSwitch profile at the root level to collect additional 
  information for the Exalogic_IbSwitch collection. You must have run the
  Exalogic_IbSwitch profile in normal (non-root) mode prior to this and  
  have an existing "Exalogic_IbSwitch" subdirectory under the Diagnostic 
  Assistant output directory to store this additional information.
      
  Input Requirements
    o Enter the root user password
    o Enter the switch user password
    
  Ouput Details
    o Shows a summary of the collection process
    o Generates a collection of files in the "Exalogic_IbSwitch" 
      subdirectory under the Diagnostic Assistant output directory that 
      contain detailed switch data
        
    </command_descr>    
    <command_type>Rda</command_type>
    <command_args>run_profile_root=Exalogic_IbSwitch</command_args>
  </command>

</commands>    

</menus>
