4.2 Running the OEDACLI Utility

You can perform various Exadata deployment and management operations using the Oracle Exadata Deployment Assistant (OEDA) Command Line Utility (OEDACLI).

Prerequisites

The following recommendations and requirements apply when using OEDACLI:

• Always download and use the latest OEDA software bundle.

• 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
  ...

• Use the default password on the nodes in the cluster (for the root, oracle and grid users)

• OEDACLI must be able to perform actions on servers in your Exadata system using various OS user accounts.

  To meet this requirement, your system must use the default user passwords or you must specify the user passwords by using the genPasswordHash.sh command located in the OEDA software bundle.

  To specify an OS user password, run the genPasswordHash.sh command with one of the following options, then supply the password when prompted. The available options are:

  • -root - Sets the root OS user password used by OEDACLI. The same password must be used by all the servers in your Exadata system.

  • -non-root - Sets the OS user password used by OEDACLI for the grid and oracle OS users. The same password must be used by all the servers in your Exadata system.

  • -all - Sets the OS user password used by OEDACLI for all OS users (root, grid, and oracle).

  For example, to set the root password used by OEDACLI:

  # /u01/oeda/linux-x86/genPasswordHash.sh -root
  Enter root password::******
  Re-enter root password:*****

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.

• Displaying Help Output for OEDACLI
  You can display syntax help for the OEDACLI utility using the HELP command.
• Displaying Help Output for an OEDACLI Command
  This example shows the help output listing the OEDACLI ALTER DATABASE command.