Prerequisites

The following recommendations and requirements apply when using OEDACLI:

• Always download and use the latest OEDA software bundle.

• If you are using a version of OEDA released in conjunction with Oracle Exadata System Software release 26.1.0 or later, ensure that any system running OEDA programs contains Java Development Kit (JDK) version 17 or later. You can download a supported JDK from https://www.oracle.com/java/technologies/downloads/.

  Before running any OEDA program, check the following to ensure that the required JDK is installed and available:

  • Ensure that the JAVA_HOME environment variable references the intended JDK.

  • Ensure that JAVA_HOME/bin/java is executable.

  • Run java --version and confirm that the output reports Java version 17 or higher.

• Many OEDACLI commands and operations require a current Exadata XML configuration file. If you cannot supply an up-to-date file, you can generate one using the OEDACLI DISCOVER ES command.

  To generate an up-to-date Exadata XML configuration file, run the DISCOVER ES command and specify:

  • The complete list of servers (KVM hosts and storage servers) in your Exadata system.

  • The directory location to store the Exadata XML configuration information.

  For example:

  oedacli> DISCOVER ES HOSTNAMES='exa01adm01,exa01adm02,exa01celadm01,exa01celadm02,exa01celadm03' LOCATION=/u01/log/exa01_discovered
  Discovering nodes [exa01adm01, exa01adm02, exa01celadm01,exa01celadm02, exa01celadm03]... 
  Getting Guest info on exa01adm02.example.com 
  Getting Guest info on exa01adm01.example.com
  ...

• OEDACLI performs actions on Exadata system servers using various OS user accounts. To do this, OEDACLI can use default user passwords or you must provide the user passwords to OEDACLI by using the genPasswordHash.sh command located in the OEDA software bundle. See also Using the OEDA genPasswordHash Utility.

Syntax

./oedacli [ -h ] [ -l ] [ -j ] [ -q ] [ -f commandfile ] [ -c configfile [ -e immediatecommand ]]

Options

• -h, --help - Display help for command-line options.

• -l, --enhanced-logging - Enable verbose logging.

• -j, --json-output - Produce LIST command output in JSON format.

• -q, --quiet-mode - For LIST commands, return only data (and no on-screen status).

• -f, --command-file commandfile - Specifies a file containing commands that you want to run. You can use this option to specify a non-interactive scripted series of commands that you want to run.

• -c, --config-file configfile - Specifies the name of the Exadata XML configuration file used by OEDACLI. If not specified, you can load the file in the command line interface using the LOAD FILE command.

• -e, --immediate-command immediatecommand - Specifies an immediate command to run, typically a single LIST command. If specified, this must be the last command option.

Usage Notes

When run without any other options, OEDACLI starts an interactive command session.