Dell Remote Access Controller 4 Firmware Version 1.30 Interfaces and APIs, VM-CLI Parameters

w w w . d e l l . c o m s u p p o r t . d e l l . c o m

Administrator level access (or VM-CLI group membership) is required to successfully run the VM-CLI utility where the operating system defines and supports it. The client system’s administrator specifies the name of the VM-CLI group required for nonadministrator access to the utility. The client system’s administrator can create this group specifically for VM-CLI access, or it can be the name of an existing user group. The client system’s administrator also controls user membership within the specified group:

•For Windows systems, all users of the VM-CLI utility must have Power User privileges.

•For Linux systems, the recommended means for allowing nonadministrator access to the VM-CLI utility is through the sudo command. This command provides a centralized means of providing nonadministrator access and keeps a log of all commands issued by users.

To add/edit users in the VM-CLI group, the administrator uses the visudo command. When added, nonadministrator users can add the sudo verb as a prefix to the VM-CLI command line (or to the script that uses VM-CLI) to obtain permission to run the utility.

Interfaces and APIs

This section details the supported command line options for the VM-CLI utility. The CLI interface is the same, regardless of the client system’s operating system. The options used by the VM-CLI utility are consistent with the racadm utility options. For example, an option to specify the DRAC IP address requires the same format for both racadm and VM-CLI.

The format of a VM-CLI command is as follows:

racvmcli [parameters] [OS-shell options]

NOTE: Command line elements are described in detail in the VM-CLI Parameters section.

NOTE: Command line elements are case sensitive.

If the command line parameters are accepted, and the DRAC 4 authorizes the connection, the command continues to run until either of the following occurs:

•The DRAC 4 terminates the connection (DRAC 4 boot once option) Or

•The command/process is manually terminated, using features of the operating system/shell. For example, in Windows, you can use the Task Manager to terminate the process.

VM-CLI Parameters

DRAC 4 IP Address

-r<RAC-IP-address>[:<RAC-SSL-port>]

This parameter is used to provide the DRAC 4 IP address and SSL port. The VM-CLI utility needs this information to establish a Virtual Media connection with the specified DRAC 4.

If <RAC-SSL-port>is omitted, the default port (443) is used. Unless the DRAC 4’s default SSL port was changed, the optional SSL port is not required.

118

Configuring and Using Virtual Media