Auto Service Request (ASR)

For ASR version 2.7 and later Oracle Exadata Quick-Installation Guide
About ASR
Auto Service Request (ASR) is a secure, scalable, customer-installable software Resources
feature of warranty and Oracle Support Services that provides auto-case generation ● Oracle Exadata Storage Server Software User's Guide
when specific hardware faults occur. ASR is designed to enable faster problem
resolution by eliminating the need to initiate contact with Oracle Support Services for ● Oracle ASR Product Page
hardware failures, reducing both the number of phone calls needed and overall phone
time required.
● My Oracle Support
● Sun Products Qualified for ASR
ASR also simplifies support operations by utilizing electronic diagnostic data. Easily
installed and deployed, ASR is completely controlled by you, the customer, to ensure
● Sun ASR Documentation
security.

Recommended Configuration Before You Start

The recommended configuration is to install the ASR Manager, which receives
fault telemetry information from the servers in the Oracle Database Machine, on a Before installing ASR, please ensure
standalone server. This server must be a qualified Sun server and can run the following conditions are met:
Solaris or Oracle Enterprise Linux (OEL) as the operating system.

Oracle ● Make sure you have access to My Oracle Support and that
Database Machine Oracle Exadata Cells - and - your contact information is correct and current.
Oracle Exadata Database Nodes
● Create a Sun Online Account (SOA) at [Link]
Qualified Oracle ● All of your assets must have a Contact assigned. Make
Fault Sun Server Support
Telemetry Internet sure the contact is correct and current.
● Identify and designate a system to serve as ASR Manager.
● See page 2 for information on installing the ASR manager on a qualified ● Identify and verify ASR assets.
Solaris server.
● Connection to the Internet via HTTPS.
● See page 3 for information on installing the ASR manager on a qualified
OEL server. You will need root access to install the
software to set up the ASR Manager.
● Follow the instructions on page 4 to configure the fault telemetry
destinations on the Exadata storage servers and on the database servers.
Software Requirements
Note: While not recommended, you may install the ASR Manager on ● OEL OS Version: Oracle Enterprise Linux (OEL) 5.3 and later
one of the database servers in the Database Machine.
● Solaris OS Version: Solaris 10, Update 6 (10u6)
● Java Version: at least JRE/JDK 1.6.0_04
Need help? If you need assistance installing
or configuring ASR, then click the “Contact Us” ● Database Server: Exadata Software [Link].1 and higher
link on My Oracle Support to open a Service ● Exadata Storage Server: Exadata Storage Server Software
Request.
[Link].1 and higher
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Page 1
 Auto Service Request (ASR)
For ASR version 2.7 and later Oracle Exadata Quick-Installation Guide
Install ASR Manager on an Off-Rack Sun Server
Select a qualified Sun server to house the ASR Manager.

Part 1 – Install ASR Components on Qualified Sun Server

Part 2 – Register ASR Manager
Running Solaris
Install Service Tools Bundle (STB) Install SASM Package
If your system is using only a service 1. Verify you have version 1.2.1 or later. 1. As root on the ASR Manager system,
processor-based telemetry source (ILOM, or run “asr register”.
XSCF on M-Series), then STB does not
• As root, run “pkginfo -l SUNWsasm” (this
will tell you if you already have the SASM 2. Enter “1” or “2” depending on your geographic
need to be installed. If this is your
package installed). location:
configuration, then you can skip the STB
installation. • If needed, download SASM (see the • 1) [Link] (Americas or
ASR Wiki for the latest version). Asia Pacific regions)
1. Download STB (see: 2. Install the SASM package. • 2) [Link] (Europe,
[Link] Run pkgadd -d SUNWsasm.version_num.pkg Middle East, or Africa regions)
2. Untar the STB bundle and run the as root. 3. If you are using a proxy server to access the
installation script (install_stb.sh). As part of internet, then enter the proxy server information.
the installation, be sure to select: If you are not using a proxy server, then enter a
Enter I for “install” hyphen ( - ).
•
Install ASR Package
Enter Y to replace existing SNEEP 4. When prompted, enter your Sun Online Account
•
1. Download and unzip the ASR package. (Visit (SOA) username and password. ASR will validate
packages the ASR Wiki for the latest version.) the login. Once validated, the registration is
• Enter Y to replace existing Service Tags 2. As root, install the ASR package: complete. Note: Passwords are not stored.
packages Your SOA e-mail address receives output from
• Run “pkgadd -d ASR reports, notification of ASR problems, and
3. Confirm that SNEEP is installed correctly. SUNWswasr.version_num.pkg” Service Request (SR) generation.
Run “sneep -a” from a terminal window.
3. Add the asr command to the PATH (update to 5. Check the registration status.
4. Verify that Service Tags is reporting your the root's .profile, .cshrc, .kshrc. or .bashrc as
system attributes correctly. Run “asr show_reg_status”.
needed):
Run “stclient -E” from a terminal window. 6. Test the connection to ensure that ASR can send
PATH=$PATH:/opt/SUNWswasr/bin/asr information to the transport server.
• If stclient -E does not show the serial export PATH Run “asr test_connection”.
number, then run “sneep -s SERIAL-
NUMBER” to register the serial number.
Learn More About ASR
GO TO PAGE 4
Need help? If you need assistance installing Visit the Oracle ASR Product Page
or configuring ASR, then click the “Contact Us” for additional information about
link on My Oracle Support to open a Service
Oracle Auto Service Request.
Configure Trap
Request. Destinations
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Page 2
 Auto Service Request (ASR)
For ASR version 2.7 and later Oracle Exadata Quick-Installation Guide
Install ASR Manager on an Off-Rack OEL Server
Select a qualified OEL server to house the ASR Manager.

Part 1 – Install ASR Components on Qualified Sun Server Running Part 2 – Register ASR Manager
Oracle Enterprise Linux (OEL)
1. As root on the ASR Manager system,
Install Service Tags for OEL Install ASR Package run “asr register”.
Service Tags only need to be installed on the ASR Package only needs to be installed on 2. Enter “1” or “2” depending on your geographic
ASR Manager. the ASR Manager. location:
1. Visit the Sun Service Tag 1.1.5 page on the 1. First, download and unzip the ASR package. • 1) [Link] (Americas or
Download Center. Select “Oracle Enterprise (Visit the ASR Wiki for the latest version.) Asia Pacific regions)
Linux” from the drop-down menu and click 2. As root, install the ASR package: • 2) [Link] (Europe,
Continue. rpm -i SUNWswasr.version_num.rpm Middle East, or Africa regions)
2. Download and unzip the latest 3. Add the asr command to the PATH (update to 3. If you are using a proxy server to access the
[Link] file. the root's .profile, .cshrc, .kshrc. or .bashrc as internet, then enter the proxy server information.
3. Run the following commands to install the service needed): If you are not using a proxy server, then enter a
tags: hyphen ( - ).
PATH=$PATH:/opt/SUNWswasr/bin
rpm -i [Link] export PATH 4. When prompted, enter your Sun Online Account
rpm -i [Link] (SOA) username and password. ASR will validate
the login. Once validated, the registration is
complete. Note: Passwords are not stored.
Note: For ASR installation on Exadata, Your SOA e-mail address receives output from
Install SASM Package
only Service Tags and SASM need to be ASR reports, notification of ASR problems, and
SASM only needs to be installed on the ASR Service Request (SR) generation.
Manager. installed along with the ASR package.
5. Check the registration status.
1. Verify you have version 1.2.1 or later. Run “asr show_reg_status”.
• As root, run “rpm -q SUNWsasm” (this will 6. Test the connection to ensure that ASR can send
tell you if you already have the SASM information to the transport server.
package installed). Run “asr test_connection”.
Be sure to reference the “Configuring
• If needed, download SASM (see the Auto Service Request” in the Oracle
ASR Wiki for the latest version). Exadata Database Machine Owner's
2. Install the SASM package: Guide for additional information. GO TO PAGE 4
rpm -i SUNWsasm.version_num.rpm

Configure Trap
Destinations
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Page 3
 Auto Service Request (ASR)
For ASR version 2.7 and later Oracle Exadata Quick-Installation Guide
Configure and Activate Fault Telemetry Destinations – Oracle Exadata Storage Server and Database Server
Minimum Oracle Exadata Storage Software Version: Oracle Exadata Storage Software [Link].1

Part 3 – Upgrade Database Servers (If Needed) 4. Shut down the Oracle stack including the grid infrastructure, Oracle
ASM, and Oracle Database.
1. On the database servers, check for the existence of: 5. Log in as the root user on each database server.
/opt/[Link]/common/exadata_mon_hw_asr.pl
If the script is there, then proceed to Part 4. 6. Unzip the db_11.2.n.n.n_patch.zip file to the
db_patch_11.2.n.n.n directory.
2. If the script is missing, refer to MOS note 888828.1 for instructions on
downloading the current patch. 7. Change to the db_patch_11.2.n.n.n directory.
3. Copy the db_11.2.n.n.n_patch.zip file to the database servers. 8. Run the [Link] script.

Part 4 – Configure Trap Destinations Element Definitions:

(Repeat for each Exadata machine being monitored) ● host=[hostname] is the ASR Manager IP or hostname ● port=162 is the SNMP port
● type=ASR represents the ASR Manager being a ● community=public is the required value
Login to the Firs t DB Node As : of the community string
special type of SNMP subscriber
Root for the Database Server ● dbs_group is the list of database nodes such as ● cell_group is the list of Exadata Cells
dm01db01, dm01db02 such as dm01cel01, dm01cel02
celladm in for the Exadata Storage Server

To Add Trap De s tinations :

For the Database Serve r

dcli -g dbs_group -l root "/opt/[Link]/compmon/exadata_mon_hw_asr.pl -set_snmp_subscribers \"\(type=asr,host=[hostname],

port=162,community=public\)\""
Note : This command w ill also configure the ASR Manager for the respective ILOM on all database nodes. The dbs_group is a file that contains a list of all the db nodes.

For the Exadata Storage Server

dcli -g cell_group -l celladmin "cellcli -e alter cell snmpsubscriber=\(\(host='[hostname]', port=162, community=public, type=ASR\)\)"

Note : This command w ill also configure the ASR Manager for the respective ILOM on all Exadata Cells. The cell_group is a file that contains a list of all the cells.

To Ve rify SNMP ASR Subs cribers : (Note: Please verify that the ASR snmpsubscriber setting is correct.)

For the Database Serve r

dcli -g dbs_group -l root "/opt/[Link]/compmon/exadata_mon_hw_asr.pl -get_snmp_subscribers –type asr"

For the Exadata Storage Server

dcli -g cell_group -l celladmin "cellcli -e list cell attributes snmpsubscriber"

Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Page 4
 Auto Service Request (ASR)
For ASR version 2.7 and later Oracle Exadata Quick-Installation Guide
Configure and Activate Fault Telemetry Destinations – Oracle Exadata Storage Server and Database Server
Minimum Oracle Exadata Storage Software Version: Oracle Exadata Storage Software [Link].1

Part 5 – Activate ASR Assets (Run from the ASR Manager) Learn More About ASR
Visit the Oracle ASR Product Page
1. Activate the ASR Manager host: for additional information about
• asr activate_asset -i host IP address Oracle Auto Service Request.
2. Activate Exadata Cell and database node ILOM:
• asr activate_asset -i ILOM IP address
3. Activate each Exadata Cell and each database node host:
• asr activate_exadata -i server IP address -h server hostname -n ILOM hostname for server
(where server is an Exadata Cell or database node)
4. To verify that ASR is activated: asr list_asset -i IP address
5. To confirm end-to-end ASR functionality and to show all activation statuses, run “asr report” to receive a report in your e-mail.
If an asset cannot be activated because of a missing Primary Contact, then please contact Oracle Support Services.
6. To test and validate the end-to-end ASR flow, from one database node, run:
● To test and validate the database group:
dcli -g dbs_group -l root -n "/opt/[Link]/compmon/exadata_mon_hw_asr.pl –validate_snmp_subscriber –type asr"
● To test and validate the cell group:
dcli -g cell_group -l celladmin -n "cellcli -e alter cell validate snmp type=ASR"
An e-mail will be sent to the SOA e-mail account to notify that the backend received this test message. No Service Request would be opened.

Be sure to reference the “Configuring

Need help? If you need assistance installing
or configuring ASR, then click the “Contact Us” Auto Service Request” in the Oracle
link on My Oracle Support to open a Service Exadata Database Machine Owner's
Request. Guide for additional information.

Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Page 5