Sun Microsystems, Inc.  Oracle System Handbook - ISO 7.0 May 2018 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-2103715.1
Update Date:2017-07-19
Keywords:

Solution Type  Technical Instruction Sure

Solution  2103715.1 :   Engineered Systems ASR Configuration Check tool (asrexacheck version 4.x)  


Related Items
  • Exalogic Elastic Cloud X3-2 Hardware
  •  
  • Exadata X4-2 Hardware
  •  
  • Exadata X3-8 Hardware
  •  
  • Exadata X5-2 Hardware
  •  
  • Exadata Database Machine V2
  •  
  • Zero Data Loss Recovery Appliance X4 Hardware
  •  
  • Big Data Appliance Hardware
  •  
  • Zero Data Loss Recovery Appliance X5 Hardware
  •  
  • Exadata X4-8 Hardware
  •  
  • Exadata X3-2 Hardware
  •  
  • Exadata X5-8 Hardware
  •  
Related Categories
  • PLA-Support>Sun Systems>x86>x86-ASR>SN-x86: ASR Configuration
  •  
  • Tools>Type>Health Check Script
  •  




In this Document
Goal
Solution
 Usage for Exadata & Oracle RA (formerly ZDLRA):
 A) asrexacheck 4.X in full rack mode (exachk –profile hardware)
 B) asrexacheck 4.X in stand-alone mode
 Usage for Exalogic
 Usage for BDA
 A) Running asrexacheck in standalone mode
 B) asrexacheck 4.X in full rack mode (exachk –profile hardware)
 Modification History
References


Applies to:

Exadata X4-2 Hardware - Version All Versions to All Versions [Release All Releases]
Zero Data Loss Recovery Appliance X4 Hardware - Version All Versions to All Versions [Release All Releases]
Exalogic Elastic Cloud X3-2 Hardware - Version X5 to X5 [Release X5]
Big Data Appliance Hardware - Version All Versions to All Versions [Release All Releases]
Exadata X5-8 Hardware - Version All Versions to All Versions [Release All Releases]
Linux x86-64

Goal

 How to install and execute asrexacheck 4.X.

 The asrexacheck script validates the ASR configuration of Engineered Systems.

 It will validate the OS and ILOM ASR configuration, it will report any concerns found and will send a set of test events which will result in an email being sent to the customer contact (setup in MOS) for each telemetry source tested.

Solution

For Exalytics and other Engineered Systems see Doc ID 1450112.1 Engineered Systems ASR Configuration Check via ASREXACHK

 

Usage for Exadata & Oracle RA (formerly ZDLRA):

A) asrexacheck 4.X in full rack mode (exachk –profile hardware)

ASRexacheck is delivered as part of the Oracle Exadata Database Machine exachk or HealthCheck (Doc ID 1070954.1) and is the preferred method for downloading and executing this utility.

Step 1: Verify the version of exachk

[root@hostdb01 exachk]# /opt/oracle.SupportTools/exachk/exachk –v

Older versions of exachk do not support –v option so instead of printing a version it executes the script. 
If this happens, you will need to use the following command to verify version.

[root@hostdb01 exachk]# grep "# Version" exachk
# Version       : 2.1.4.1

If exachk does not exist or the version is lower than 12.2.0.1.1 then get the current version of exachk. See Doc ID 1070954.1 Oracle Exadata Database Machine exachk or HealthCheck

Step 2: Run the following command to invoke the script on the first Database node:

[root@hostdb01 exachk]# /opt/oracle.SupportTools/exachk/exachk –profile hardware

Step 3: Use MOS to upload resulting zip to the SR

Be sure to upload the zip file to the SR related to your ASR issue or the Preventative Maintenance case that prompted you to launch this utility.

Step 4: Under the guidance of Domain Engineer run the following command to invoke the script on an individual node. Passing comma separated node names to run exachk only on subset of nodes.

[root@hostdb01 exachk]# /opt/oracle.SupportTools/exachk/exachk -profile hardware -clusternodes hostdb01,hostdb02,hostcell01,hostcell02,hostcell03

 

B) asrexacheck 4.X in stand-alone mode

If you need to run asrexacheck outside of the higher level exachk process on a single node, perform the following steps.

For stand-alone we suggest putting asrexacheck in /opt/oracle.SupportTools/ however, it will not be run as part of exachk from that folder.
To be run as part of exachk it will need to be placed in /opt/oracle.SupportTools/exachk/.cgrep/ directory.
It makes more sense to update exachk than to copy the latest asrexacheck version there unless you are running a specific test version or are instructed by an ASR Domain Engineer.

Step 1: Verify the version of asrexacheck

Go to /opt/oracle.SupportTools/ and verify the name of the script.

# /opt/oracle.SupportTools/asrexacheck –v

or

# /opt/oracle.SupportTools/asrexachk –v

If the version output is 4.2 then proceed to Step 3, if lower then proceed to Step 2.

Step 2: Downloading and installing the current asrexacheck

Step 2.1: Download the asrexacheck_43.zip file located at the bottom of this page in the "Attachment" section.

Step 2.2: Copy the asrexacheck_43.zip to the following directory: /opt/oracle.SupportTools/

Step 2.3: Unzip the asrexacheck utility:

# cd /opt/oracle.SupportTools/
# unzip asrexacheck_43.zip

Step 2.4: Change the running permissions to execute

# chmod 755 /opt/oracle.SupportTools/asrexacheck

Step 3: Running asrexacheck in standalone mode

# /opt/oracle.SupportTools/asrexacheck

Zipfile will be created in /var/log/asrexacheck/

Example; /var/log/asrexacheck/asrexacheck_hostdb01_20160205T153628.zip

Step 4: Use MOS to upload resulting zip to the SR

Be sure to upload the zip file to the SR related to your ASR issue or the Preventative Maintenance case that prompted you to launch this utility.

 

Usage for Exalogic

Step 1: Verify the version of asrexacheck

Go to /opt/exalogic.tools/tools/ and verify the name of the script.

# /opt/exalogic.tools/tools/asrexacheck –v

or

# /opt/exalogic.tools/tools/asrexachk –v

If the version output is 4.2 then proceed to Step 3, if lower then proceed to Step 2.

Step 2: Downloading and installing the current asrexacheck

Step 2.1: Download the asrexacheck_43.zip file located at the bottom of this page in the "Attachment" section.

Step 2.2: Copy the asrexacheck_43.zip to the following directory: /opt/exalogic.tools/tools/

Step 2.3: Unzip the asrexacheck utility:

# cd /opt/exalogic.tools/tools/
# unzip asrexacheck_43.zip

Step 2.4: Change the running permissions to execute

# chmod 755 /opt/exalogic.tools/tools/asrexacheck

Step 3: Running asrexacheck in standalone mode

# /opt/exalogic.tools/tools/asrexacheck

Zipfile will be created in /var/log/asrexacheck/

Example; /var/log/asrexacheck/asrexacheck_hostdb01_20160205T153628.zip

Step 4: Use MOS to upload resulting zip to the SR

Be sure to upload the zip file to the SR related to your ASR issue or the Preventative Maintenance case that prompted you to launch this utility.

 

 

Usage for BDA

A) Running asrexacheck in standalone mode

Step 1: Verify the version of asrexacheck

Go to /opt/oracle.SupportTools/ and verify the name of the script.

# /opt/oracle.SupportTools/asrexacheck –v

 or

# /opt/oracle.SupportTools/asrexachk –v

 If the version output is 4.2 then proceed to Step 3, if lower then proceed to Step 2.

 Step 2: Downloading and installing the current asrexacheck

 Step 2.1: Download the asrexacheck_43.zip file located at the bottom of this page in the "Attachment" section.

 Step 2.2: Copy the asrexacheck_43.zip to the following directory: /opt/oracle.SupportTools/

 Step 2.3: Unzip the asrexacheck utility:

 

# cd /opt/oracle.SupportTools/
# unzip asrexacheck_43.zip

 

Step 2.4: Change the running permissions to execute

# chmod 755 /opt/oracle.SupportTools/asrexacheck

 

Step 2.5: Running asrexacheck in standalone mode

# /opt/oracle.SupportTools/asrexacheck

Zipfile will be created in /var/log/asrexacheck/

Example; /var/log/asrexacheck/asrexacheck_hostdb01_20160205T153628.zip

Step 3: Use MOS to upload resulting zip to the SR

Be sure to upload the zip file to the SR related to your ASR issue or the Preventative Maintenance case that prompted you to launch this utility.

B) asrexacheck 4.X in full rack mode (exachk –profile hardware)

ASRexacheck is delivered as part of the Oracle Big Data Machine exachk or HealthCheck (Doc ID 1070954.1) and is the preferred method for downloading and executing this utility.

Step 1: Verify the version of exachk

[root@hostdb01 exachk]# /opt/oracle/exachk/exachk –v

Older versions of exachk do not support –v option so instead of printing a version it executes the script.
If this happens, you will need to use the following command to verify version.

[root@hostdb01 exachk]# grep "# Version" exachk
# Version : 2.1.4.1

 

If exachk does not exist or the version is lower than 12.2.0.1.1 then get the current version of exachk. See Doc ID 1070954.1 Oracle Exadata Database Machine exachk or HealthCheck

Step 2: Run the following command to invoke the script on the first Database node:

[root@hostdb01 exachk]# /opt/oracle/exachk/exachk -profile hardware

Step 3: Use MOS to upload resulting zip to the SR

Be sure to upload the zip file to the SR related to your ASR issue or the Preventative Maintenance case that prompted you to launch this utility.

 

For Preventive Maintenance on Exadata, Exalogic, SuperCluster, or BDA systems, refer to MOS Document 1947296.1

 

Modification History

 Please contact Global Customer Support via My Oracle Support for any assistance.

Update Date Description
02-FEB-2016

Document Created for release 4.0

03-FEB-2016

Script name changed from asrexachk to asrexacheck

26-MAY-2016

Version 4.1 released - Support for Exalogic and BDA added

16-SEP-2016

Version 4.2 released - Support for Exalytics added

15-DEC-2016

Version 4.3 released

References

<NOTE:1450112.1> - Engineered Systems ASR Configuration Check via ASREXACHK
<NOTE:1070954.1> - Oracle Exadata Database Machine exachk or HealthCheck
<NOTE:1947296.1> - Gathering HW and ASR data on nodes within an ES Rack during Preventive Maintenance activity

Attachments
This solution has no attachment
  Copyright © 2018 Oracle, Inc.  All rights reserved.
 Feedback