Interfaces And Apis; Vm-Cli Parameters - Dell Remote Access Controller 4 Firmware Version 1.30 User Manual

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:
NOTE:
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
Command line elements are described in detail in the VM-CLI Parameters section.
Command line elements are case sensitive.