Most command-line options apply to both Oracle ORAchk and Oracle EXAchk.
$ ./orachk options [-h] [-a] [-b] [-v] [-p] [-m] [-u] [-f] [-o] [-clusternodes clusternames] [-failedchecks previous_result] [-nordbms] [-output path] [-dbnames dbnames] [-localonly] [-debug] [-dbnone | -dball] [-c] [-upgrade | -noupgrade] [-syslog] [-skip_usr_def_checks] [-checkfaileduploads] [-uploadfailed all | comma-delimited list of collections] [-fileattr [start | check | remove ] [-includedir path ] [-excludediscovery] [-baseline path [-fileattronly] [-testemail all | "NOTIFICATION_EMAIL=comma-delimited list of email addresses"] [-setdbupload all | db upload variable, for example, RAT_UPLOAD_CONNECT_STRING, RAT_UPLOAD_PASSWORD] [-unsetdbupload all | db upload variable, for example, RAT_UPLOAD_CONNECT_STRING, RAT_UPLOAD_PASSWORD] [-checkdbupload] [-getdbupload] [-cmupgrade] [-sendemail "NOTIFICATION_EMAIL=comma-delimited list of email addresses"] [-nopass] [-noscore] [-showpass] [-show_critical] [-diff Old Report New Report [-outfile Output HTML] [-force]] [-merge report 1 report 2 [-force]] [-tag tagname] [-nodaemon] [-profile asm | clusterware | corroborate | dba | ebs | emagent | emoms | em | goldengate | hardware | maa | oam | oim | oud | ovn | peoplesoft | preinstall | prepatch | security | siebel | solaris_cluster | storage | switch | sysadmin | timesten | user_defined_checks | zfs ] [-excludeprofile asm | clusterware | corroborate | dba | ebs | emagent | emoms | em | goldengate | hardware | maa | oam | oim | oud | ovn | peoplesoft | preinstall | prepatch | security | siebel | solaris_cluster | storage | switch | sysadmin | timesten | user_defined_checks | zfs ] [-acchk -javahome path to jdk8 -asmhome path to asm-all-5.0.3.jar -appjar directory where jar files are present for concrete class -apptrc directory where trace files are present for coverage class] [-check check ids | -excludecheck check ids] [-zfsnodes nodes] [-zfssa appliance names] [-dbserial | -dbparallel [n] | -dbparallelmax] [-idmpreinstall | -idmpostinstall | -idmruntime] [-topology topology.xml | -credconfig credconfig] | -idmdbpreinstall | -idmdbpostinstall | -idmdbruntime] [-idm_config IDMCONFIG] [-idmdiscargs IDMDISCARGS] [-idmhcargs IDMHCARGS | -h]
$ ./exachk options [-h] [-a] [-b] [-v] [-p] [-m] [-u] [-f] [-o] [-clusternodes clusternames] [-failedchecks previous_result] [-nordbms] [-output path] [-dbnames dbnames] [-localonly] [-debug] [-dbnone | -dball] [-c] [-upgrade | -noupgrade] [-syslog] [-skip_usr_def_checks] [-checkfaileduploads] [-uploadfailed all | comma-delimited list of collections] [-fileattr start | check | remove [-includedir path [-excludediscovery] [-baseline path[-fileattronly] [-testemail all | "NOTIFICATION_EMAIL=comma-delimited list of email addresses"] [-setdbupload all | db upload variable, for example, RAT_UPLOAD_CONNECT_STRING, RAT_UPLOAD_PASSWORD] [-unsetdbupload all | db upload variable, for example, RAT_UPLOAD_CONNECT_STRING, RAT_UPLOAD_PASSWORD] [-checkdbupload] [-getdbupload] [-cmupgrade] [-sendemail "NOTIFICATION_EMAIL=comma-delimited list of email addresses"] [-nopass] [-noscore] [-showpass] [-show_critical] [-diff Old Report New Report [-outfile Output HTML] [-force]] [-merge report 1 report 2 [-force]] [-tag tagname] [-auto_restart -initsetup | -initdebugsetup | -initrmsetup | -initcheck | -h] [-d start|start -debug|stop|status|info|stop_client|nextautorun|-h] [-nodaemon] [-unlockcells all | -cells comma-delimited list of names or IPs of cells] [-lockcells all | -cells comma-delimited list of names or IPs of cells] [-usecompute] [-exadiff Exalogic collection1 Exalogic collection2] [-vmguest ] [-hybrid [-phy nodes]] [-profile asm | bi_middleware | clusterware | compute_node | exatier1 | control_VM | corroborate | dba | ebs | el_extensive | el_lite | el_rackcompare | emagent | emoms | em | goldengate | hardware | maa | nimbula | obiee | ovn | peoplesoft | platinum | preinstall | prepatch | security | siebel | solaris_cluster | storage | switch | sysadmin | timesten | user_defined_checks | virtual_infra] [-excludeprofile asm | bi_middleware | clusterware | compute_node | exatier1 | control_VM | corroborate | dba | ebs | el_extensive | el_lite | el_rackcompare | emagent | emoms | em | goldengate | hardware | maa | nimbula | obiee | ovn | peoplesoft | platinum | preinstall | prepatch | security | siebel | solaris_cluster | storage | switch | sysadmin | timesten | user_defined_checks | virtual_infra] [-check check ids | -excludecheck check ids] [-cells cells] [-ibswitches switches] [-torswitches] [-extzfsnodes nodes] [-dbserial | -dbparallel [n] | -dbparallelmax | -allserial] [-allserial | -dbnodeserial |-cellserial | -switchserial]
zip
files.List of command options common to Oracle ORAchk and Oracle EXAchk.
Syntax
[-a] [-v] [-debug] [-nodaemon] [-f] [-upgrade] [-noupgrade] [-testemail all | "NOTIFICATION_EMAIL=comma-delimited list of email addresses"] [-sendemail “NOTIFICATION_EMAIL=comma-delimited list of email addresses"] [-dbserial] [-dbparallel [n]] [-dbparallelmax]
Parameters
Table 1-7 Generic Commands
Option | Description |
---|---|
|
Runs all checks, including the best practice checks and the recommended patch check. If you do not specify any options, then the tools run all checks by default. |
|
Shows the version of Oracle ORAchk and Oracle EXAchk tools. |
|
Runs in debug mode. The generated |
|
Does not send commands to the daemon, usage is interactive. |
|
Runs Offline. The tools perform health checks on the data already collected from the system. |
|
Forces an upgrade of the version of the tools being run. |
|
Does not prompt for an upgrade if a later version is available under the location specified in the |
|
Sends a test email to validate email configuration. |
|
Specify a comma-delimited list of email addresses. Emails the generated HTML report on completion to the specified email addresses. |
|
Runs the |
|
Runs the Default is 25% of CPUs. |
|
Runs the |
Parent topic: Oracle ORAchk and Oracle EXAchk Command-Line Options
Use the list of commands in this section to control the scope of checks.
Syntax
[-b] [-p] [-m] [-u –o pre] [-u –o post] [-clusternodes nodes] [-failedchecks previous_result] [-nordbms] [-dbnames db_names] [-dbnone] [-dball] [-localonly] [-cells cells] [-ibswitches switches] [-profile profile] [-excludeprofile profile] [-check check_id] [-excludecheck check_id] [-skip_usr_def_checks]
Parameters
Table 1-8 Scope of Checks
Command | Description |
---|---|
|
Runs only the best practice checks. Does not run the recommended patch checks. |
|
Runs only the patch checks. |
|
Excludes the checks for Maximum Availability Architecture (MAA) scorecards. |
|
Runs the pre-upgrade checks for Oracle Clusterware and database. |
|
Runs the post-upgrade checks for Oracle Clusterware and database. |
|
Specify a comma-delimited list of node names to run only on a subset of nodes. |
|
Runs only checks from the presious_result, which had failed. |
|
Runs Oracle Grid Infrastructure checks only in environments with no Oracle Database checks performed. |
|
Specify a comma-delimited list of database names to run only on a subset of databases. |
|
Does not prompt for database selection and skips all the database checks. |
|
Does not prompt for database selection and runs the database checks on all databases discovered on the system. |
|
Runs only on the local node. |
|
Specify a comma-delimited list of storage server names to run the checks only on a subset of storage servers. |
|
Specify a comma-delimited list of InfiniBand switch names to run the checks only on a subset of InfiniBand switches. |
|
Specify a comma-delimited list of profiles to run only the checks in the specified profiles. |
|
Specify a comma-delimited list of profiles to exclude the checks in the specified profiles. |
|
Specify a comma-delimited list of check IDs to run only the checks specified in the list check IDs. |
|
Specify a comma-delimited list of check IDs to exclude the checks specified in the list of check IDs. |
|
Does not run the checks specified in the user-defined |
Related Topics
Parent topic: Oracle ORAchk and Oracle EXAchk Command-Line Options
Use the list of commands in this section to manage the report output.
Syntax
[-syslog] [-tag tagname] [-o] [-nopass] [-noscore] [-diff old_report new_report [-outfile output_HTML]] [-merge [-force] collections]
Parameters
Table 1-9 Managing Output
Option | Description |
---|---|
|
Writes JSON results to syslog. |
|
Appends the The |
|
Argument to an option. If If the |
|
Does not show passed checks in the generated output. |
|
Does not print health score in the HTML report. |
|
Reports the difference between the two HTML reports. Specify a directory name or a ZIP file or an HTML report file as |
|
Merges a comma-delimited list of collections and prepares a single report. |
Use the list of commands in this section to upload results to the database.
Syntax
[-setdbupload all|list of variable names] [-unsetdbupload all|list of variable names] [-checkdbupload] [-getdbupload] [-checkfaileduploads] [-uploadfailed all|list of failed collections]
Parameters
Table 1-10 Uploading Results to Database
Option | Description |
---|---|
|
Sets the values in the wallet to upload health check run results to the database.
variable_names: Specify a comma-delimited list of variables to set. |
|
Unsets the values in the wallet to upload health check run results to the database.
variable_names: Specify a comma-delimited list of variables to unset. |
|
Checks if the variables are set correctly for uploading the health check run results to the database. |
|
Prints the variables with their values from wallet for uploading the health check run result to the database. |
|
Reports any failed collection uploads. |
|
Reattempts to upload one or more failed collection uploads.
list of failed collections: Specify a comma-delimited list of collections to upload. |
Related Topics
Parent topic: Oracle ORAchk and Oracle EXAchk Command-Line Options
Use the list of commands in this section to control the behavior of the daemon.
Syntax
[-id id] –set daemon_option [-id id] -unset daemon_option | all [-id id] -get parameter | all [-d start] [-d start -debug] [-d stop] [-d stop_client] [-d status] [-d info] [-id id] -d nextautorun [-initsetup] [-initrmsetup] [-initcheck]
Parameters
Table 1-11 Daemon Options
Option | Description |
---|---|
|
Optionally use |
|
Unsets the parameter. Use with |
|
Displays the value of the specified parameter or all the parameters. Use with |
|
Starts the daemon. |
|
Starts the daemon in debug mode. |
|
Stops the daemon. |
|
Forces a running daemon client to stop. |
|
Checks the current status of the daemon. |
|
Displays details about the daemon. The details include installation and when the daemon was started. |
|
Displays details about when the next scheduled automatic run occurs. |
|
Sets the daemon auto restart function that starts the daemon when the node starts. |
|
Removes the automatic restart functionality. |
|
Checks if the automatic restart functionality is set up. |
Use the list of commands in this section to find file attribute differences.
Parameters
Table 1-12 File Attribute Differences
Option | Description |
---|---|
|
Takes file attributes snapshot of discovered directories and stores the snapshot in the output directory. By default, the tool takes snapshot of Oracle Grid Infrastructure home and all the installed database homes. If the user doesn't own a particular directory, then the tool does not take snapshot of the directory. |
|
Takes a recent snapshot of discovered directories and compares with the previous snapshot |
|
Removes the file attribute snapshots and related files. |
|
Includes the directories specified at the command-line to check file attributes. For example:
./orachk -fileattr start -includedir "/root/home,/etc" ./orachk -fileattr check -includedir "/root/home,/etc" |
|
Excludes the discovered directories. ./orachk -fileattr start -includedir "/root/home,/etc" -excludediscovery |
|
For example: ./orachk -fileattr check -baseline "/tmp/Snapshot" |
|
Performs file attributes check and exits ORAchk. ./orachk -fileattr check -fileattronly |
Parent topic: Oracle ORAchk and Oracle EXAchk Command-Line Options
List of commands to manage Oracle Health Check Collections Manager.
Table 1-13 Oracle Health Check Collections Manager Commands
Command | Description |
---|---|
Or
|
Upgrades Oracle Health Check Collections Manager from Oracle ORAchk or Oracle EXAchk. Oracle Health Check Collections Manager upgrades to the latest version of whichever application your database supports. You get the new theme interface only if you have APEX 5. |
Parent topic: Oracle ORAchk and Oracle EXAchk Command-Line Options
Use the list of commands in this section to encrypt and decrypt diagnostic collection zip
files.
Table 1-14 Encrypt and Decrypt Diagnostic Collection zip Files
Option | Description |
---|---|
|
Starts the daemon with The daemon prompts for a password when it starts. The daemon then encrypts the subsequent on-demand and scheduled runs collections with that password. Note: When |
|
Encrypts the run result. Prompts for the password, and encrypts the collections created at the end of the run with that password. You can use For example:
./orachk -profile profile-name -encryptzip ./orachk -profile sysadmin -encryptzip ./orachk -check check-id -encryptzip ./orachk -check D47661C55B1A291AE0431EC0E50A5C53 -encryptzip Note: When |
|
Encrypts the already generated collection. Prompts for the password, encrypts the zip file specified with that password, and then renames the collections as, for example, Note: When |
|
Decrypts the encrypted collection. Prompts for the password, decrypts the |
Parent topic: Oracle ORAchk and Oracle EXAchk Command-Line Options