Oracle® Auto Service Request
Quick Installation Guide for Oracle Exadata Database Machine
Release 5.7
E97669-03
February 2019
This document describes how to install and configure Oracle Auto Service Request (ASR) for Oracle Exadata Database Machine.
Topics:
- About Oracle ASR
Oracle Auto Service Request (ASR) is a secure, scalable, customer-installable software feature of warranty and Oracle Support Services. Oracle ASR provides auto-case generation for common hardware component faults. - Recommended Configuration for Oracle ASR
This section describes the Oracle ASR configuration. - Prerequisites for Oracle ASR
This section describes the prerequisites for Oracle Auto Service Request (ASR). - Configure Fault Notification Destinations
Use the following procedures to configure fault telemetry destinations on Oracle Exadata Storage Server and Oracle Exadata Database Server. - Enabling Automatic DiagPack Upload for Oracle ASR
You can upload diagnostic packages to ASR automatically. - Activating Nodes on Oracle ASR Manager
Use this procedure to activate nodes on Oracle ASR Manager. - Upgrading to Oracle ASR SNMP v3
Simple Network Management Protocol (SNMP) v3 is supported on Oracle Exadata Storage Servers and Oracle Exadata Database Servers starting with Oracle Exadata System Software release 12.1.2.1.0. - Validating SNMP Trap Configurations on Oracle Exadata Database Machine
Run the following commands to validate SNMP trap configurations. - Configuring and Activating Switches for Oracle ASR
This topic describes how to configure and activate switches for Oracle ASR. - Additional Resources for Oracle Auto Service Request (ASR)
Refer to these sections for additional resources to configure and run Oracle ASR. - Third-Party Licenses for Oracle ASR
Oracle Auto Service Request (ASR) includes third-party products. - Documentation Accessibility
About Oracle ASR
Oracle Auto Service Request (ASR) is a secure, scalable, customer-installable software feature of warranty and Oracle Support Services. Oracle ASR provides auto-case generation for common hardware component faults.
Oracle ASR simplifies support operations by automatically generating support records for common component faults. Oracle ASR auto-case generation also accelerates problem resolution by eliminating the need for you to contact Oracle Support Services for common failures. Auto-case generation reduces both the number of phone calls that you make to obtain support and the phone time required for problem resolution. Oracle ASR does not provide system management or monitoring. Oracle ASR is designed to generate Oracle service requests automatically when certain types of faults are detected on Oracle products that are qualified for Oracle ASR.
Oracle ASR works only for specific component faults. Most of the common components, such as disks, fans, and power supplies, are covered. However, some components are not covered. For example, Oracle ASR does not cover InfiniBand events; there are specific images and specific InfiniBand switch firmware that you must use. You cannot upgrade these components independently.
Oracle ASR is easy to install and deploy. To ensure security, you have complete control over Oracle ASR.
Note:
Oracle recommends that you implement a system management and monitoring solution in addition to Oracle ASR, such as Oracle Enterprise Manager Cloud Control or Oracle Enterprise Manager Ops Center.
Caution:
The commands in this document are provided for your convenience. However, the copy and paste functionality can paste different content than what is published in the guide. To ensure that the command text that you paste is identical to the text that you copy, confirm that your console session is set to receive data as UTF-8.
Recommended Configuration for Oracle ASR
This section describes the Oracle ASR configuration.
Note:
While not recommended, you can install Oracle ASR Manageron one of the Oracle Exadata Database Machine servers.Prerequisites for Oracle ASR
This section describes the prerequisites for Oracle Auto Service Request (ASR).
Topics:
- Server and Network Requirements for Oracle ASR
Ensure that the following conditions are met before installing Oracle Auto Service Request (ASR). - Oracle Auto Service Request (ASR) Software Requirements
You needroot
access to install the software and to configure Oracle ASR Manager. - Qualified Exadata Products
Oracle Exadata Database Machine is qualified for Oracle Auto Service Request (ASR).
Server and Network Requirements for Oracle ASR
Ensure that the following conditions are met before installing Oracle Auto Service Request (ASR).
-
Ensure that you have access to My Oracle Support. Also ensure that your contact information is current and correct.
-
Ensure that all of your assets have an assigned contact and that the contact information is current and correct.
-
Identify and designate a system to serve as the Oracle ASR Manager.
-
Identify and verify all of your Oracle ASR assets.
-
Ensure connectivity to the Internet using HTTPS.
-
Ensure the network connectivity of the operating system to the designated Oracle ASR Manager. Network connectivity is required for Oracle Exadata assets, ILOM, and
eth0
. -
For
IPv6
, enable the Oracle ASR Manager server for dual stackIPv6
andIPv4
. Oracle ASR Manager supports usingIPv6
connections to and from assets that are configured for Oracle ASR. The traffic that is outbound from the Oracle ASR Manager totransport.oracle.com
currently only supportsIPv4
traffic. -
If you are using SNMP V3, you must be using Oracle ASR release 4.3 or higher.
Related Topics
Parent topic: Prerequisites for Oracle ASR
Oracle Auto Service Request (ASR) Software Requirements
You need root
access to install the software and to configure Oracle ASR Manager.
-
Oracle ASR Manager: To install Oracle ASR Manager on a standalone server that is running either Linux or Solaris, refer to "Installing and Registering Oracle ASR Manager Software" in Oracle Auto Service Request (ASR) Manager User's Guide.
-
Database Server: Oracle Exadata System Software release 11.2.1.3.1 or later.
-
Oracle Exadata System Software:
-
Release 12.1.2.1.1 and later
-
Release 11.2.1.3.1 and later
-
-
To configure trap destinations, use one of the following options:
-
Oracle Exadata Deployment Assistant (OEDA): OEDA prompts you for information used to configure Oracle ASR. OEDA configures the traps and activates the Oracle ASR assets.
-
dcli
Utility: Refer to thedcli
utility chapter in Oracle Exadata System Software User's Guide for instructions about enabling SSH for thedcli
utility.
-
-
Port 162 Availability: Port 162 is the SNMP port. Use the SNMP port to configure fault telemetry destinations. You can assign this port to a different port address based on your network requirements. In a managed environment, you may need to must the port from the default port assignment for Oracle ASR to work correctly.
-
The
dcli
Utility: While not required for Oracle ASR, thedcli
utility enables you to simultaneously configure all of the servers. You can also usedcli
to configure the storage servers at the same time.
Refer to the topic "Setting User Equivalence" in Oracle Exadata Database Machine Extending and Multi-Rack Cabling Guide for instructions about enabling SSH for the dcli
utility. Depending on your environment restrictions, it is possible that the dcli
utility is not configured. See Oracle Exadata System Software User's Guide for more information about the dcli
utility.
The dcli
utility commands in this document run commands that require equivalency with the root
or celladmin
user, depending on the command. Ensure that the user account that runs the dcli
utility command is configured with the correct equivalency.
Qualified Exadata Products
Oracle Exadata Database Machine is qualified for Oracle Auto Service Request (ASR).
The following additional Oracle Exadata Database Machine products are qualified for Oracle ASR:
-
Oracle Exadata Storage Expansion Rack X2-2, X2-8, X2-2
-
Oracle Exadata Storage Expansion Rack X3-2, X3-8, X3-2
-
Oracle Exadata Storage Expansion Rack X4-2, X4-8, X4-2, Oracle Zero Data Loss Recovery Appliance X4
-
Oracle Exadata Storage Expansion Rack X5-2, X5-8, X5-2, Oracle Zero Data Loss Recovery Appliance X5
-
All newer versions of Oracle Exadata Database Machine, Oracle Exadata Storage Expansion Rack, and Oracle Zero Data Loss Recovery Appliance
InfiniBand switches are supported for the following Oracle Exadata System Software releases:
-
11.2.3.3.0 or later
-
12.1.1.1.0 or later
Parent topic: Prerequisites for Oracle ASR
Configure Fault Notification Destinations
Use the following procedures to configure fault telemetry destinations on Oracle Exadata Storage Server and Oracle Exadata Database Server.
Topics:
- Fault Telemetry Options
You can configure the fault notification destinations using various methods. - Adding SNMP Trap Destinations Using OEDA
You can add SNMP trap destinations using Oracle Exadata Deployment Assistant (OEDA). - Configuring the SNMP Subscriber for Fault Notification on Release 12.x or Later
Use theALTER CELL
orALTER DBSERVER
commands to configure SNMP trap destinations for servers running Oracle Exadata System Software release 12.x or later. - Configuring the SNMP Subscriber on Release 11.x
Use thedcli
utility to configure SNMP trap destinations for servers running Oracle Exadata System Software release 11.x.
Fault Telemetry Options
You can configure the fault notification destinations using various methods.
Adding SNMP trap destinations using Oracle Exadata Deployment Assistant (OEDA) is the recommended method for new installations. After the initial configuration with OEDA, you can modify or add new fault notification destinations using the command line utilities, such as DBMCLI, CellCLI, dcli
, or exadcli
.
To configure fault notification destinations, modify the SNMP subscriber attribute on the database or storage servers. The information you provide defines the SNMP trap destination.
Note:
Oracle ASR can only use the management network. Ensure that the management network is configured to enable Oracle ASR to run on eithereth0
on the interfaces, or net0
on the rear of the server.
SNMP Subscriber Options
When configuring the SNMP subscriber, you set some or all of the following options:
- host=[ASR Manager host name or IP] is the Oracle ASR Manager host name or IP address. The Oracle ASR Manager host name can be used when DNS is enabled for the site. If DNS is not running, then the IP address is preferred. However, you can use the Oracle ASR Manager host name if the entry is added to the
/etc/hosts
file. - type=asr represents the Oracle ASR Manager being a special type of SNMP subscriber.
- community=public is the required value of the community string. This value varies for each implementation because you can modify it to be a different string based on your network requirements.
- port=162 is the SNMP port. This port value is customer-dependent. You can configure it as a different port based on your network requirements. Or, you may need to change the port value in order for Oracle ASR to work correctly in a managed environment.
- asrmPort is an optional element that supports automatic diagnostic package uploads for Service Requests (SR). The default value is 16161. If you plan to use HTTP for upload, then the value should match the HTTP port configured on Oracle ASR Manager. If you plan to use HTTPs for upload, then the value should match the HTTPs port configured on Oracle ASR Manager. The value should be set to the same value as displayed for "HTTP Port" or "HTTPS/SSL Port" in the output of the command
asr show_http_receiver
on the Oracle ASR Manager host. -
fromIP enables you to specify an IP address from which the trap is sent. If this field is not specified, then it defaults to the IP address associated with
eth0
. To support automatic diagnostic package uploads, you must setfromIP
on the database nodes to the value of the IP address of theeth0
network interface. Otherwise, use this field if the default IP address is not registered with Oracle ASR Manager. Oracle ASR Manager only processes SNMP traps that are sent from IP addresses that Oracle ASR Manager recognizes.The fromIP field is allowed only for
snmpSubscribers
whose type is eitherASR
orv3ASR
.
Adding SNMP Trap Destinations Using OEDA
You can add SNMP trap destinations using Oracle Exadata Deployment Assistant (OEDA).
If this is your initial deployment of Oracle Exadata Database Machine, then OEDA automatically configures SNMP settings when you run the latest version of OEDA.
To
Related Topics
Parent topic: Configure Fault Notification Destinations
Configuring the SNMP Subscriber for Fault Notification on Release 12.x or Later
Use the ALTER CELL
or ALTER DBSERVER
commands to configure SNMP trap destinations for servers running Oracle Exadata System Software release 12.x or later.
- Configure the SNMP subscriber on each database server.
- Configure the SNMP subscriber on each Oracle Exadata Storage Server.
Alternatively, you can use the exadcli
utility to run the command on a specified group of servers. If you have not used exadcli
before, see Using exadcli for the First Time.
For example, you might use the following exadcli
commands to query or update all database servers with a single command:
# exadcli -c dbnode01,dbnode02 -l dbnodeadmin list dbserver attributes snmpsubscriber
# exadcli -c dbnode01,dbnode02 -l dbnodeadmin alter dbserver snmpSubscriber=
((host='asrm2.example.com',port=162,community=public,type=asr,
fromIP=10.1.1.1,asrmPort=16161),(host='asrm1.example.com',port=162,
community=public,type=asr,fromIP=10.1.1.1,asrmPort=16161))
# exadcli -c cell01,cell02,cell03 -l celladmin list cell attributes snmpsubscriber
# exadcli -c cell01,cell02,cell03 -l celladmin alter cell snmpSubscriber=
((host='asrm1.example.com',port=162,community=public,type=asr,
fromIP=10.1.1.1,asrmPort=16161),(host='asrm2.example.com',port=162,
community=public,type=asr,fromIP=10.1.1.1,asrmPort=16161))
Parent topic: Configure Fault Notification Destinations
Configuring the SNMP Subscriber on Release 11.x
Use the dcli
utility to configure SNMP trap destinations for servers running Oracle Exadata System Software release 11.x.
Related Topics
Parent topic: Configure Fault Notification Destinations
Enabling Automatic DiagPack Upload for Oracle ASR
You can upload diagnostic packages to ASR automatically.
In Oracle Exadata System Software release 12.2.1.1.0, Management Server (MS) communicates with Oracle ASR Manager to upload a diagnostic package containing information relevant to the Oracle ASR automatically. MS provides support to automatically upload diagpacks over HTTPS starting with Oracle Exadata System Software release 19.1.0.
For Oracle ASR Manager release 5.7 or later, the http_receiver
is enabled by default, but the HTTPS/SSL configuration might not be. If you want to use HTTP to upload the diagnostic packages, then verify that HTTP Port
has the same value as asrmPort
on database and storage servers. If you want to use HTTPS to upload the diagnostic packages, then verify that HTTPS/SSL configuration is enabled and that HTTPS/SSL Port
has the same value as asrmPort
on database and storage servers. If you are using a release earlier than Oracle ASR Manager release 5.7, then you must upgrade to release 5.7 or later to use the Automatic DiagPack Upload feature.
- Enable HTTP Access on Oracle ASR Manager
You can send Oracle Auto Service Request (ASR) fault events and telemetry to Oracle Support Services using XML over HTTP to the Oracle ASR Manager. - Enabling HTTPS/SSL on Oracle ASR Manager
You can use either a root-signed certificate or a self-signed certificate to enable HTTPS/SSL on Oracle ASR Manager.
Related Topics
Enable HTTP Access on Oracle ASR Manager
You can send Oracle Auto Service Request (ASR) fault events and telemetry to Oracle Support Services using XML over HTTP to the Oracle ASR Manager.
Select a port for the HTTP receiver that is appropriate for your network environment and does not conflict with other network services.
Parent topic: Enabling Automatic DiagPack Upload for Oracle ASR
Enabling HTTPS/SSL on Oracle ASR Manager
You can use either a root-signed certificate or a self-signed certificate to enable HTTPS/SSL on Oracle ASR Manager.
Generate and install the SSL Certificate into the Key Store specific to the Java/JDK used by Oracle ASR Manager.
Parent topic: Enabling Automatic DiagPack Upload for Oracle ASR
Activating Nodes on Oracle ASR Manager
Use this procedure to activate nodes on Oracle ASR Manager.
Note:
-
Run the commands listed in this section only on Oracle ASR Manager hosts, not on Oracle Exadata Database Machine hosts.
-
Repeat these commands for each Oracle Exadata Database Machine that you attach to Oracle ASR.
Related Topics
Upgrading to Oracle ASR SNMP v3
Simple Network Management Protocol (SNMP) v3 is supported on Oracle Exadata Storage Servers and Oracle Exadata Database Servers starting with Oracle Exadata System Software release 12.1.2.1.0.
See Also:
-
The ALTER CELL command of CellCLI in Oracle Exadata System Software User's Guide
-
The ALTER DBSERVER command of DBMCLI in Oracle Exadata Database Machine Maintenance Guide
-
Oracle Auto Service Request ASR Manager User's Guide for Linux and Solaris
Validating SNMP Trap Configurations on Oracle Exadata Database Machine
Run the following commands to validate SNMP trap configurations.
Example - Database node configuration validation
-
To verify your node configuration using the
dcli
utility, run the following command on an Oracle Exadata Database Server host. Run this command from an account that has equivalency with theroot
user on the database nodes:-
Oracle Exadata System Software release 12.1.2.x or later:
# dcli -g dbs_group -l root -n "dbmcli -e list dbserver attributes snmpSubscriber"
-
Oracle Exadata System Software release earlier than 12.1.2.x:
# dcli -g dbs_group -l root –n "/opt/oracle.cellos/compmon/exadata_mon_hw_asr.pl -get_snmp_subscribers -type asr"
-
-
To verify the configuration when the
dcli
utility is not available, run the following command on each Oracle Exadata Database Server host:-
If your Oracle Exadata System Software is release 12.1.2.x or later:
# dbmcli -e list dbserver attributes snmpSubscriber
-
If your Oracle Exadata System Software release is earlier than 12.1.2.x:
# /opt/oracle.cellos/compmon/exadata_mon_hw_asr.pl -get_snmp_subscribers -type asr
-
Example - Storage node configuration validation
-
To validate your node configuration using the
dcli
utility, run the following command on the first Oracle Exadata Database Machine host. Run this command from an account that has equivalency with thecelladmin
user on the cells):# dcli -g cell_group -l celladmin "cellcli -e list cell attributes snmpsubscriber"
-
To validate your node configuration when the
dcli
utility is not available, log on ascelladmin
and run the following command on each Oracle Exadata Storage Server host:# cellcli -e "list cell attributes snmpsubscriber"
Example - Database node SNMP validation
-
For a system with Oracle Exadata System Software release 12.1.2.x or later:
# dbmcli -e alter dbserver validate snmp type=asr
With Oracle Exadata System Software release 12.2.1.1.0, when
dbmcli
validates the SNMP trap configurations, it also validates whether ansnmpSubscriber
supports automatic diagnostic package uploads or not. A new message is displayed when the previous command is run if ansnmpSubscriber
is not accessible or doesn't support automatic diagnostic package uploads. The message is similar to the following:ASR Manager(s) on Host01 are not accessible or do not support automatic diagnostic package upload. Diagnostic packages will not be automatically uploaded for Service Requests. DBServer db01 successfully altered
-
For a system with Oracle Exadata System Software that is earlier than 12.1.2.x:
-
To validate your node configuration using the
dcli
utility, run the following command on an Oracle Exadata Database Server host:# dcli -g dbs_group -l root "/opt/oracle.cellos/compmon/exadata_mon_hw_asr.pl -validate_snmp_subscriber -type asr"
-
To validate your node configuration when the
dcli
utility is not available, run the following command on each Oracle Exadata Database Server host:# /opt/oracle.cellos/compmon/exadata_mon_hw_asr.pl -validate_snmp_subscriber -type asr
-
Example - Storage node SNMP validation
-
To validate your storage node SNMP using the
dcli
utility, run the following command on each Oracle Exadata Storage Server host:dcli -g cell_group -l celladmin "cellcli -e alter cell validate snmp type=asr"
-
To validate your storage node SNMP when the
dcli
utility is not available, run the following command on each Oracle Exadata Storage Server host:# cellcli -e "alter cell validate snmp type=asr"
After validation, Oracle sends e-mail notifications from each of the nodes to:
-
The Oracle ASR Manager registration user specified in the Oracle ASR Manager
asr register
command. -
The asset contact that is assigned in My Oracle Support.
-
The distribution e-mail list that is assigned in My Oracle Support (optional).
When deploying Oracle ASR, you must run the asrexachck
script as described in My Oracle Support Document 2103715.1 to verify the Oracle ASR deployment.
A Service Request (SR) must be filed with Oracle Support Services to validate that the Oracle ASR installation is correct from end-to-end. Include the output of the asrexachck
script when you file the SR.
Related Topics
Configuring and Activating Switches for Oracle ASR
This topic describes how to configure and activate switches for Oracle ASR.
To configure Datacenter InfiniBand Switch 36 and QDR InfiniBand Gateway Switches for Oracle ASR, follow the instructions outlined in My Oracle Support Document 1902710.1.
Additional Resources for Oracle Auto Service Request (ASR)
Refer to these sections for additional resources to configure and run Oracle ASR.
Oracle ASR
-
Oracle ASR product page:
-
Oracle Exadata products qualified for Oracle ASR:
-
Oracle ASR user documentation:
See the Oracle ASR documentation at
http://docs.oracle.com/cd/E37710_01/nav/products.htm
-
Download Oracle ASR software (My Oracle Support login required): Oracle Auto Service Request (ASR) [My Oracle Support Note 1185493.1]
-
How To Manage and Approve Pending ASR Assets In My Oracle Support [My Oracle Support Note 1329200.1]
Oracle Exadata Database Machine Documentation
-
CellCLI command reference:Oracle Exadata System Software User's Guide
-
dcli command reference:Oracle Exadata System Software User's Guide
-
DBMCLI command reference: Oracle Exadata Database Machine Maintenance Guide
My Oracle Support
Third-Party Licenses for Oracle ASR
Oracle Auto Service Request (ASR) includes third-party products.
For a complete list of the licensed third-party products, refer to Appendix C, "Third-Party Licenses" in Oracle Auto Service Request (ASR) Manager User's Guide.
Related Topics
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Access to Oracle Support
Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Oracle Auto Service Request Quick Installation Guide for Oracle Exadata Database Machine, Release 5.7
E97669-03
Copyright © 2015, 2019, Oracle and/or its affiliates. All rights reserved.
Primary Author: Janet Stern
Contributing Authors: Mark Bauer, Thom Chumley, Vira Goorah, Ryan Zhang
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.