Provisioning Reference Guide › etautil Batch Utility › etautil Syntax

etautil Syntax

This is the generalized syntax of etautil. For an explanation of the syntax and use of etautil, see the Provisioning Manager help.

etautil [-n] [-d domain] [-u user [-p password]] [-y password-file] [options] control_statements

Note: Using an input file provides better performance. A single bind executes all commands in the file.

• -n

  Verifies the syntax of the command you entered, without executing the command.

• -d domain

  Specifies the name of the provisioning domain.

• -u user

  Specifies the global user name for authentication.

• -p password

  Specifies the password of the named global user for authentication.

  Cannot be specified with –y password_file option

• -y password-file

  Specifies a file name that contains a global user password. Cannot be specified with –p password option. Please see the "Important" section below for more information.

• options

  Includes any of the following:

  -f filename
  Reads the control statements in the indicated file and executes them. Use semicolons (;) to delimit multiple control statements.

  -i
  Invokes the etautil interactive mode, which lets you enter control statements at the prompt. (Use <Ctrl+D> or <Enter> to terminate the interactive mode).

  -o
  Displays operation details to stdout. See the section Obtain Operation Details.

  -h
  Displays etautil help.

• control statements

  For more information about control statements, see etautil Control Statements.

Important: Enter all DNs in the same case as stored in the provisioning directory. DNs are strings that etautil often requires in your commands. In most cases, an incorrect-case DN supplied to the Provisioning Server is processed as is. Authorization errors are common as most permission checking is done by a case-sensitive comparison of the DN of an object being operated upon with the DN specified in a privilege. Copying DN strings from logs or the JXplorer utility ensures the DN is in the correct case.

On UNIX, we strongly recommended you include the -y password-file option to specify an authentication password. For example, if "$HOME/.pwdfile" contains myglobaluser's password, then you can use etautil command as follows:

$ etautil –u myglobaluser –y "$HOME/.pwdfile" <other-options>

The command disregards any newline character if one exists at the end of the password file, but it uses the rest of the content as the authentication password.