9 Installing Auto Service Request (ASR) Software

This chapter describes how to install Auto Service Request (ASR) for Exalytics machines.

Note:

Starting with the Oracle Exalytics Release 1 Patchset 1 (1.0.0.1), the Auto Service Request (ASR) feature is supported. For more information, see the chapter "New Features for Exalytics Machine" in the Oracle Fusion Middleware Installation and Administration Guide for Oracle Exalytics In-Memory Machine.

It contains the following topics:

9.1 About Oracle Auto Service Request (ASR)

Auto Service Request (ASR) is a secure, scalable, customer-installable software feature of warranty and Oracle Support Services that provides auto-case generation when common hardware component faults occur. ASR is designed to enable faster problem resolution by eliminating the need to initiate contact with Oracle Support Services for common hardware component failures, reducing both the number of phone calls needed and overall phone time required. ASR also simplifies support operations by using electronic diagnostic data. Easily installed and deployed, ASR is completely controlled by you, the customer, to ensure security. ASR is applicable only for component faults. Not all component failures are covered, though the most common components (such as disk, fan, and power supplies) are covered.

Note:

ASR is not a replacement for other monitoring mechanisms, such as SMTP and SNMP alerts, within your data center. It is a complementary mechanism that expedites and simplifies the delivery of replacement hardware. ASR should not be used for downtime events in high-priority systems. For high-priority events, contact Oracle Support Services directly.

9.2 Recommended Configuration

The recommended configuration is to install the ASR Manager on a machine outside of Exalytics, on a Management only network away from the Data network. The supported operating systems are Oracle Linux 5.3 and above, and Solaris 10 Update 5 and above.

Note:

ASR Manager should not to be on the same subnet as the Bonded Data network interfaces.

ETH0 must be on a separate subnet that does not overlap the Bonded Data network.

9.3 Before You Begin

Before installing ASR, ensure that the following conditions are met:

  • Ensure that you have access to My Oracle Support (http://support.oracle.com) and confirm your contact information is correct and current.

  • Make sure that all of your Exalytics machine assets have a contact assigned and that the contact is correct and current.

  • Identify and designate a system, outside of Exalytics, to serve as ASR Manager.

  • Retrieve the IP address of your ASR Manager.

  • Identify and verify ASR assets.

  • Ensure connectivity to the Internet using HTTPS.

  • Download and install the Oracle Exalytics Configuration Utility patch and ASR utility, on the Exalytics host machine.

    Note:

    Starting with Oracle Exalytics Release 1 Patchset 3 (1.0.0.3), the Oracle Exalytics Configuration Utility patch and the ASR utility are included in the base image.

    Steps 1 through 4 are not applicable for users using Oracle Exalytics Release 1 Patchset 3 (1.0.0.3) or higher version.

    If you are using Oracle Exalytics Release 1 Patchset 3 (1.0.0.3) or higher version, you must start at step 5.

    To download and install the Oracle Exalytics Configuration utility patch and ASR utility, perform the following actions:

    1. Download and install the Oracle Exalytics Configuration Utility patch (1.0.0.4) and ASR utility for Oracle Exalytics Release 1, Patchset 1 (ex_x2-4_config_utils_linux_x86_64.zip file) from the Oracle Software Delivery Cloud Web site at the following link:

      http://edelivery.oracle.com

    2. Unzip the file into a temporary directory.

      The zip file contains the files that are listed in Table 9-1.

      Table 9-1 Files in the Oracle Exalytics Configuration Utility Zip File

      File Name Notes

      exalytics_configure_network.sh

      Oracle Exalytics network configuration script

      SUN-HW-TRAP-MIB.mib

      ASR (Auto Service Request) on Oracle Exalytics

      bda_mon_hw_asr.pl

      ASR mail script on Oracle Exalytics

      common_subs.pm

      ASR on Oracle Exalytics

      setup_asr_ilom.pl

      ASR on Oracle Exalytics


    3. Create the following directories:

      • mkdir -p /opt/exalytics

      • mkdir -p /opt/exalytics/asr

    4. Copy the file exalytics_configure_network.sh to /opt/exalytics/bin. Copy the following files to the /opt/exalytics/asr directory:

      • bda_mon_hw_asr.pl

      • setup_asr_ilom.pl

      • common_subs.pm

      • SUN-HW-TRAP-MIB.mib

      Note:

      Before copying the file, ensure that you back up the existing file as exalytics_configure_network.sh_V1 first.

    5. Execute the Oracle Exalytics network configuration script to configure the network interfaces.

      #cd /opt/exalytics

      #./exalytics_configure_network.sh

  • Complete the following steps to configure ASR:

    1. Go to the /opt/exalytics/asr directory, and run the following commands to add executive permissions on the two Perl files:

      chmod +x bda_mon_hw_asr.pl

      chmod +x setup_asr_ilom.pl

    2. Add the following line to the /etc/inittab file:

      emh1:345:respawn:/opt/exalytics/asr/bda_mon_hw_asr.pl -server

    3. At the command line, execute the init q command to initialize and start the bda_mon server.

9.4 Installing ASR Manager on a Standalone System

You must install ASR Manager on a standalone system (a machine outside of Exalytics running Oracle Linux, as described in the section "Install Software" in the Oracle Auto Service Request Installation and Operations Guide.

9.5 Activating Exalytics Assets Manually

If you need to activate HOST and ILOM for Exalytics manually, complete the following steps in the ASR Manager:

  1. Login as the root user in your ASR Manager. Start the ASR menu by running the following command:

    #cd /opt/SUNWswasr/bin
    #./asr
    
  2. Activate ASR on Exalytics host machine by running the following command:

    asr> activate_asset -i IP_address_of_exalytics_host_machine

    or

    asr> activate_asset -h host_name_exalytics_machine

  3. Activate ILOM for Exalytics individually by running the following command:

    asr> activate_asset -i ILOM_IP_address_of_compute_node

    or

    asr> activate_asset -h ILOM_host_name_of_exalytics_machine

9.6 Viewing and Verifying ASR Assets ASR Manager

View and verify ASR Asset (Exalytics machine components whose ASR is active) by running the following command from the ASR Manager system:

asr> list_asset - lists all assets associated with this ASR Manager

For example:

xx.xxx.xxx.xx exalytics 1234567890 Enabled SNMP FMA SUN FIRE X4470 M2 SERVER x86/x64 System

xx.xxx.xxx.xxx exalytics-sp 1234567890 Enabled SNMP ILOM SUN FIRE X4470 M2 SERVER

9.7 Configuring Telemetry Sources

You must configure telemetry sources for ILOM and Exalytics host machine to forward their telemetry to the ASR Manager. Scripts are provided to configure both ILOM and the Host. The scripts are found in /opt/exalytics/asr. These scripts should be executed on the Exalytics host machine.

Complete the following steps:

  1. Login to the Exalytics Host as the root user.

  2. Configure ILOM telemetry by running the following command:

    #cd /opt/exalytics/asr
    #./setup_asr_ilom.pl -i <IP Address Of ASR Manager>
    
  3. Configure Exalytics host machine telemetry by running the following command:

    #cd /opt/exalytics/asr
    #./bda_mon_hw_asr.pl -set_snmp_subscribers type=asr,host=<IP Address Of ASR Manager>,fromip=<IP Address of Exalytics Host>
    

9.8 Enabling Exalytics Machine Assets in My Oracle Support

Complete the following steps to enable Exalytics machine assets:

  1. Log in to My Oracle Support (https://support.oracle.com).

  2. In the My Oracle Support Dashboard, click the More... tab. Then select Settings from the menu.

  3. In the Settings pane on the left of the window, select Assets (located under the Administrative submenu). For your Support Identifier, select ASR Status from the sort filter, then select Pending from the All Statuses drop-down menu.

  4. You can approve a Pending asset in two ways:

    • Activate via Asset Toolbar

      Click the asset's serial number to display a toolbar with following options:

      • Assign Contact - select this option to assign a contact to the asset. Only users associated with the support identifier can be a contact.

      • Change Address - select this option to update the asset's physical location.

      • Approve - for assets that are Pending, click Approve to enable ASR for the asset.

      • Other Actions - you can also perform other actions such as Activate (for an inactive asset), Deactivate (for an active asset), or Deny (for a pending request).

    • Activate via Asset Details

      At the bottom of the Asset pane, there is a "Show Asset Details" option. Click an asset's serial number and then the Show Asset Details to update information about the asset. Required fields for ASR asset activation are indicated by an asterisk (*).

For more information, see the Knowledge Management article ID 1329200.1 on My Oracle Support. To obtain this article on My Oracle Support, complete the following steps:

  1. Log in to My Oracle Support (https://support.oracle.com).

  2. Click the Knowledge tab.

  3. In the Knowledge Base section, click the Search & Browse tab.

  4. In the Enter search terms option, enter 1329200.1 and click Search. The article "How to activate ASR within My Oracle Support" is displayed.

9.9 Sending Test Alerts

To send test alerts, complete the following:

  1. Login to the Exalytics Host as the root user.

  2. Send Test Alerts for ILOM telemetry by running the following command:

    #ipmitool sunoem cli "set /SP/alertmgmt/rules/1 testrule=true"

  3. Send Test Alerts for Exalytics host machine by running the following command:

    #./opt/exalytics/asr/bda_mon_hw_asr.pl -validate_snmp_subscriber -type asr 
    

You will receive an e-mail notification for the test alerts.

Note:

Oracle highly recommends to send test alerts from the ILOM, and the Exalytics host machine.

9.10 Fault Coverage

For more information, see Oracle ASR ILOM Fault Coverage.