Oracle® Big Data Appliance Owner's Guide Release 1 (1.0.3) Part Number E25960-03 |
|
|
PDF · Mobi · ePub |
This chapter explains how to install and configure Auto Service Request for Oracle Big Data Appliance. It contains these topics:
Auto Service Request (ASR) is designed to automatically open service requests when specific Oracle Big Data Appliance hardware faults occur. To enable this feature, the Oracle Big Data Appliance components must be configured to send hardware fault telemetry to the ASR Manager software. This service covers components in Sun Fire Servers. ASR Manager must be installed on a server that has connectivity to Oracle Big Data Appliance and an outbound Internet connection using HTTPS or an HTTPS proxy.
Note:
Set up ASR Manager before configuring Oracle Big Data Appliance. Ensure that Auto Service Request is selected in the Oracle Big Data Appliance Configuration Worksheets, so that ASR components are installed and configured on the appliance. See "Software Configuration".When a hardware problem is detected, ASR Manager submits a service request to Oracle Support Services. In many cases, Oracle Support Services can begin work on resolving the issue before the database administrator is even aware the problem exists.
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.
ASR is not a replacement for other monitoring mechanisms, such as SMTP and SNMP alerts, within the customer 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.
Before using Auto Service Request, set up the following:
Oracle Premier Support for Systems or Oracle Premier Support for Operating Systems
Technical contact responsible for Oracle Big Data Appliance
Valid shipping address for Oracle Big Data Appliance parts
An email message is sent to both the My Oracle Support email account and the technical contact for Oracle Big Data Appliance to notify them of the creation of the service request.
A service request may not be filed automatically on some occasions. This can happen because of the unreliable nature of the SNMP protocol or a loss of connectivity to ASR Manager. Oracle recommends that customers continue to monitor their systems for faults and call Oracle Support Services if they do not receive notice that a service request has been filed automatically.
See Also:
Oracle Auto Service Request web page at
http://www.oracle.com/technetwork/server-storage/asr/overview/index.html
Oracle Auto Service Request User Documentation at
http://www.oracle.com/technetwork/server-storage/asr/documentation/index.html
Before installing ASR, complete these prerequisites:
Create a My Oracle Support (MOS) account at http://support.oracle.com
.
Ensure the following are correctly set up:
Oracle Premier Support for Systems or Oracle Limited Warranty
Technical contact responsible for the Big Data Appliance
Valid shipping address for Big Data Appliance repair parts
Identify and designate a system to serve as ASR Manager.
ASR Manager must be installed on a server that has connectivity to Oracle Big Data Appliance and an outbound Internet connection using HTTPS or an HTTPS proxy. To submit a service request (SR), the server must be able to access the Internet.
Ensure that the designated system conforms to the "Hardware and Network Configuration Recommendations for ASR." See the Oracle ASR website:
http://www.oracle.com/technetwork/server-storage/asr/overview/hardware-recommendations-330108.html
Confirm that JDK 6 (1.6.0_04 or later) is running on the designated ASR Manager system:
java -version
If necessary, download and install the latest version on JDK from the Java SE Downloads website:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
Obtain root
access to the designated ASR Manager system.
Identify and verify connectivity to Oracle Big Data Appliance.
Ensure connectivity to the Internet using HTTPS.
This section contains these topics:
ASR Manager requires installation of these components:
ASR Manager Version 3.6 or higher
Oracle Service Tags
For links to the ASR software, go to the Oracle Auto Service Request Downloads website:
http://www.oracle.com/technetwork/server-storage/asr/downloads/index.html
Refer to My Oracle Support note 1185493.1 for the most recent software releases.
To download the Oracle Service Tags bundle, go to this site:
Connect to the ASR Manager system.
Check whether ASM version 1.3.1 or later is already installed:
rpm -q SUNWsasm
If it is not installed, then download the latest version as described in "Downloading the Software".
As the root user, install the ASM package:
rpm -i SUNWsasm.version_number.rpm
Verify the installation:
rpm -Vv SUNWsasm-version_number
To install the SUNWswasr package:
Connect to the ASR Manager system.
Download and unzip the SUNWswasr
package.
As the root
user, install the package:
rpm -i SUNWswasr.version_number.rpm
Update the root login file, such as .profile
or .bashrc
, to add the asr
software to the PATH
variable. These commands are for the bash shell:
PATH=$PATH:/opt/SUNWawasr/bin/asr EXPORT PATH
Verify the installation:
rpm -Vv SUNWswasr
If the installation failed, then remove it, restart the system, and reinstall the package.
Ensure ASM is running for issuing any other ASR commands:
/opt/SUNWsasm/bin/sasm status
As the root
user on the ASR Manager server, issue this command:
asr register
Enter 1
or 2
, depending on your location:
Americas or Asia Pacific regions: 1
for transport.oracle.com
Europe, Middle East, or Africa regions: 2
for transport.oracle.co.uk
If you are using a proxy server to access the Internet, then enter the proxy server information. If you are not using a proxy server, then enter a hyphen (-).
Enter your My Oracle Support (MOS) user name and password when prompted. ASR validates the login. After validation, the registration is complete. Passwords are not stored.
Your MOS email address receives output from ASR reports, notification of ASR problems, and service request (SR) generation.
Perform these checks on ASR Manager to ensure it is installed properly:
As the root user, verify that the ASR installer created three CRON jobs:
crontab -l
The following are the recommended settings:
asr report
: Set once a month on Sunday
asr heartbeat
: Set twice daily or at least once daily
asr update_rules.sh
: Set once daily by default
Verify that ASR Manager 3.5 or later is running:
asr show_rules_version
Check the registration status:
asr show_reg_status
Test the connection by sending a test message to the transport server.
asr test_connection
The Oracle Big Data Appliance Mammoth Utility configures the servers automatically. See "Mammoth Utility Steps".
On ASR Manager, verify ASR is activated:
asr list_asset -i asset_ip
In the preceding command, asset_ip is the IP address of a Sun Fire Server host or an ILOM. To list all assets, issue this command:
asr list_asset
The following is an example of the output. You should see a host name and an ILOM name for each of the 18 servers, for a total of 36 activations. If you see fewer than 36, identify the missing ones and activate them. An example of a host name is bda1node15 and an ILOM name is bda1node15-c.
ADDRESS HOST_NAME SERIAL_NUMBER ASR PRODUCT_NAME ------------- ------------- ----------- -------- -------------------------- 203.0.114.44 bda1node15 1143FMM023 Enabled SUN FIRE X4270 M2 SERVER... 203.0.115.139 bda1node15-c 1143FMM073 Enabled SUN FIRE X4270 M2 SERVER 203.0.114.45 bda1node16 1143FMM021 Enabled SUN FIRE X4270 M2 SERVER... 203.0.115.140 bda1node16-c 1143FMM063 Enabled SUN FIRE X4270 M2 SERVER 203.0.114.46 bda1node17 1143FMM021 Enabled SUN FIRE X4270 M2 SERVER... 203.0.115.141 bda1node17-c 1143FMM46B Enabled SUN FIRE X4270 M2 SERVER
If no assets are listed, verify that all steps of the Mammoth Utility have run successfully. See Chapter 13, "Installing the Oracle Big Data Appliance Software."
Confirm end-to-end ASR functionality:
asr report
This is an example of the output:
Successfully submitted request for activation status report. Activation status report will be sent to email address associated with MOS Account:bdaadmin@example.com
The report is sent to My Oracle Support.
Activate the assets in My Oracle Support. Only a Customer User Administrator can perform this step.
Log in to My Oracle Support.
Click the More tab.
Select Settings.
Click Pending ASR Activations.
Select the asset to activate, and review the information in the ASR Activation - Asset window. Update any information as needed.
Click Approve to complete activation. The assets should be Active
.
Confirm that the assets are listed as Active
in My Oracle Support:
Note:
If an IP address or host name changes, then you must deactivate and reactivate the asset.If no assets are discovered, take these steps:
Log in to the first server.
(Optional) Activate the ASR Manager host using the following command:
asr activate_asset -i host_ip
Where host_ip is the host IP address. If the server is qualified for ASR and entitled to service, then it can be activated.
Activate the Integrated Lights Out Managers (ILOMs):
asr activate_asset -i ilom_ip
In the preceding command, ilom_ip is the ILOM IP address.
Activate the Sun Fire Servers:
asr activate_asset –i host_eth0_ip
Where host_eth0_ip is the IP address of the first Sun Fire Server on the administrative network.
Repeat these activate_asset
commands on each Sun Fire Server.
To validate the ASR installation, you must generate test events.
To set up a test event on an ILOM:
Log in to the ILOM of any server in Oracle Big Data Appliance.
Change to the following directory:
cd /SP/alertmgmt/rules/3
show
The following information is displayed:
/SP/alertmgmt/rules/3 Targets: Properties: type = snmptrap level = minor destination = 10.10.10.255 (Use the IP of your own ASR manager!) destination_port = 162 community_or_username = public snmp_version = 2c testrule = (Cannot show property) Commands: cd set show
Ensure the properties have valid values as shown in step 3, not blank or set to zeros. Use the appropriate IP address and port for your site.
Set the test trap:
set testrule=true
You should receive an email about the event. Verify that an email was also sent to the address listed in your Customer Service Identifier (CSI) for Oracle Big Data Appliance.
To set up a test in the operating system environment:
Issue this command to validate the operating system. The sample output shows 10.10.10.123:162 as the ASR Manager address.
# /opt/oracle/bda/compmon**/bda_mon_hw_asr.pl -validate_snmp_subscribers -type asr Sending test trap to destination - 10.10.10.123:162
Verify that an email about the event was send to you and to the address listed in your Customer Service Identifier (CSI) for Oracle Big Data Appliance.
This test event does not open a case, but makes a verifiable entry in the ASR back end.
You received the emails from both tests, then your validation is complete. If not, then proceed to "Troubleshooting ASR".
If the emails state that there are contract issues, contact your installation coordinator for further assistance.
For troubleshooting procedures for the ASR software, see Section 5 of the Oracle ASR Installation and Operations Guide at:
http://www.oracle.com/technetwork/server-storage/asr/documentation/index.html
If you continue to have issues, contact ASR support. See My Oracle Support Note 1352349.1)