This section explains features and tasks specific to Oracle EXAchk on Oracle SuperCluster.
Oracle EXAchk is an invaluable aid in keeping your system up-to-date and recording changes, as well as providing baselines for support analysis in the event such data is required to resolve a Service Request.
See Also:
My Oracle Support Note 2053185.1 for the latest scope and supported platforms specific to Oracle EXAchk on Oracle SuperCluster, which is available at the following URL:
Follow these procedures to install and deploy Oracle EXAchk on Oracle SuperCluster.
Installation
Run Oracle EXAchk from the primary ldom
as root
. Oracle EXAchk discovers all Oracle RAC and database instances, compute nodes, storage servers, and InfiniBand switches in the fabric.
Run Oracle EXAchk in a database zone or virtualized environment. Oracle EXAchk collects data from one or all database instances and Oracle RAC nodes.
Notes and considerations
If you install and run Oracle EXAchk as root
, it collects connectivity data from the GZ to the storage cells and other nodes. However, Oracle EXAchk collects only collect database and Oracle RAC data if run as root
from within the nodes or zones on which the database and Oracle RAC software is installed.
By default, there should be no need to set environment variables or run as any other user than root. However, there may be exceptions when one is asked to run it in some debug or extraordinary fashion by an Oracle Support Analyst.
/opt/oracle.SupportTools/exachk
. Set the environment variable RAT_OUTPUT to change this, for example,
export RAT_OUTPUT=/opt/oracle.SupportTools/exachk/output
Merge multiple collections into one file for ease of uploading to My Oracle Support for analysis.
Note:
In zones, there is currently an issue with discovery and you must explicitly set the RAT_ORACLE_HOME and RAT_GRID_HOME environment variables in some remote cases.
Deployment
Download the latest version of Oracle EXAchk into /opt/oracle.SupportTools
directory on the primary node/LDOM
of the SuperCluster.
Backup or remove if you have already installed Oracle EXAchk.
Download the latest version of the Oracle EXAchk on SuperCluster deployment script deploy_exachk.sh
.
Refer to the My Oracle Support Note 2053185.1, which is available at the following URL:
Move the downloaded file into the /opt/oracle.SupportTools
directory.
Use the deploy_exachk.sh
script to deploy and install Oracle EXAchk into the /opt/oracle.SupportTools/exachk
directory in the primary ldom
and in each zone.
Note:
Repeat this action for each of the other LDOMs.
Example of what a zone's /opt/oracle.SupportTools
looks like when this is finished:
total 68 drwxr-xr-x 7 root root 10 Oct 14 19:27 . drwxr-xr-x 8 root sys 8 Oct 7 22:06 .. drwxr-xr-x 3 root root 21 Oct 14 19:27 Exachk.old drwxr-xr-x 3 root root 23 Oct 14 19:06 Exachk drwxr-xr-x 2 root root 7 Oct 5 20:52 em lrwxrwxrwx 1 root root 14 Oct 14 19:27 exachk -> Exachk drwxr-xr-x 2 root root 6 Oct 7 20:43 onecommand -rw-r--r-- 1 root root 40830 Oct 7 20:30 resourcecontrol
Manual or standalone installation.
Manually install Oracle EXAchk on each host or LDOM or zone as follows:
root@abc5db01:/opt/oracle.SupportTools# mv exachk Exachk.old root@abc5db01:/opt/oracle.SupportTools# mkdir exachk root@abc5db01:/opt/oracle.SupportTools# unzip exachk_121024_bundle.zip -d exachk root@abc5db01:/opt/oracle.SupportTools# unzip exachk/exachk.zip -d exachk
Check the version.
# /opt/oracle.SupportTools/exachk/exachk -v Note if root RSA keys are set up for ssh, then this is an example of an easy way to check all zones in a given LDOM: root@abc5db01:/opt/oracle.SupportTools# zoneadm list | grep -v global > zone_list root@abc5db01:/opt/oracle.SupportTools# hostname >> zone_list root@abc5db01:/opt/oracle.SupportTools# /opt/oracle.supercluster/bin/dcli -g zone_list -l root /opt/*Tools/exachk/exachk -v abc5db01z1: abc5db01z1: EXACHK VERSION: 12.1.0.2.6_20160208 abc5db01z2: abc5db01z2: EXACHK VERSION: 12.1.0.2.6_20160208 abc5db01z3: abc5db01z3: EXACHK VERSION: 12.1.0.2.6_20160208 abc5db01z4: abc5db01z4: EXACHK VERSION: 12.1.0.2.6_20160208 abc5db01: abc5db01: EXACHK VERSION: 12.1.0.2.6_20160208
Related Topics
Perform health checks from GZ / primary LDOM, or NGZ.
Performing Health Checks from GZ / Primary LDOM
root@abc5db01:/opt/oracle.SupportTools/exachk# ./exachk exachk did not find the inventory location on abc5db01 from environment.Does abc5db01 have Oracle software installed [y/n][n]?n Checking ssh user equivalency settings on all nodes in cluster Node abc5db02 is configured for ssh user equivalency for root user Node abc5db03 is configured for ssh user equivalency for root user Node abc5db04 is configured for ssh user equivalency for root user <snip>
Performing Health Checks from non-GZ local zone, aka NGZ
root@abc4db01:/opt/oracle.SupportTools/exachk# zlogin abc4db01z2 [Connected to zone 'abc4db01z2' pts/10] Oracle Corporation SunOS 5.11 11.1 April 2014 root@abc4db01z2:~# cd /opt/*Tools root@abc4db01z2:/opt/oracle.SupportTools# cd exachk root@abc4db01z2:/opt/oracle.SupportTools/exachk# ./exachk Checking ssh user equivalency settings on all nodes in cluster <snip>
curl
.Merge multiple collections into one file and upload it to an SR through curl
.
Note:
Specify the -force
option after the comma-delimited file list.
root@abc4db01:/opt/oracle.SupportTools/exachk# ./exachk -mergeexachk_abc4db01_090715_214648.zip,/zoneHome/abc4db01z1/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z1_abc4z1_090415_183027.zip,/zoneHome/abc4db01z2/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z2_abc4z2_090715_211212.zip,/zoneHome/abc4db01z3/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z3_dbm01_031015_212416.zip -force Merging following collections: exachk_abc4db01_090715_214648.zip /zoneHome/abc4db01z1/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z1_abc4z1_090415_183027.zip /zoneHome/abc4db01z2/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z2_abc4z2_090715_211212.zip /zoneHome/abc4db01z3/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z3_dbm01_031015_212416.zip Started merging exachk_orlt4db01_090715_214648.zip ........................................................................................ Started merging /zoneHome/abc4db01z1/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z1_abc4z1_090415_183027.zip ............................................................................................................................................................................................ Started merging /zoneHome/abc4db01z2/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z2_abc4z2_090715_211212.zip ............................................................................................................................................................................................ Started merging /zoneHome/abc4db01z3/root/opt/oracle.SupportTools/exachk/exachk_abc4db01z3_dbm01_031015_212416.zip ............................................................................................................................................................................................ <snip> Detailed report (html) - /opt/oracle.SupportTools/exachk/exachk_abc4db01_090715_214648_merge/exachk_abc4db01_090715_214648_merge.html UPLOAD(if required) - /opt/oracle.SupportTools/exachk/exachk_abc4db01_090715_214648_merge.zip root@abc4db01:/opt/oracle.SupportTools/exachk#
Related Topics
Follow these specific advanced setup instructions when using Oracle EXAchk on SuperCluster.
Before you schedule automated health check runs, set the following environment variables as follows:
export RAT_TIMEOUT=120 export RAT_ROOT_TIMEOUT=600 export RAT_PASSWORDCHECK_TIMEOUT=30 export RAT_OUTPUT=/opt/oracle.SupportTools/exachk/output export RAT_COPY_EM_XML_FILES=1
Note:
Create a file with these commands because they are required to be set anytime you restart the daemon.
AUTORUN_SCHEDULE * * * * :- Automatic run at specific time - - - - ¦ ¦ ¦ ¦ ¦ ¦ ¦ +----- day of week (0 - 6) (0 to 6 are ¦ ¦ ¦ Sunday to Saturday) ¦ ¦ +---------- month (1 - 12) ¦ +--------------- day of month (1 - 31) +-------------------- hour (0 - 23)
./exachk -set "AUTORUN_SCHEDULE=2 5 * *"
./exachk -get all
./exachk -initpresetup
inittab
.
./exachk -initsetup
Note:
If the preceding action produces an error, then wait for one or two minutes before running the next command to give init
time to respawn the process.
./exachk -d nextautorun
Related Topics
List of command line options specific to Oracle EXAchk on SuperCluster.
Table 3-12 Oracle SuperCluster Command Line Options
Option | Description |
---|---|
|
Pass comma-delimited list of storage server names to limit to subset of storage servers. Alternatively, set the RAT_CELLS environment variable with a space-delimited list of cells: For example: export RAT_CELLS="randomcel01 randomcel06" Or export RAT_CELLS=randomcel01 |
|
Pass comma-delimited list of InfiniBand switch names to limit to subset of InfiniBand switches. Alternatively, set the RAT_IBSWITCHES environment variable with a space-delimited list of switches: For example: export RAT_IBSWITCHES="randomsw-ib1 randomsw-ib3" Or export RAT_CELLS=randomsw-ib2 |
–unlockcells
and –lockcells
options:
./exachk -unlockcells all | -cells comma-delimited list of names or IP addresses of cells
./exachk -lockcells all | -cells comma-delimited list of names or IP addresses of cells
Troubleshoot and fix issues related to Oracle EXAchk on Oracle SuperCluster.
See Also:
My Oracle Support Note 2053185.1 for the latest known issues specific to Oracle EXAchk on Oracle SuperCluster, which is available at the following URL:
Related Topics