subscribe iconSubscribe to this information

Virtual I/O Server command-line interface

Use this topic to find information about the Virtual I/O Server command-line interface.

The Virtual I/O Server is configured and managed through a command-line interface. In environments where no HMC is present, some Virtual I/O Server tasks can also be performed using the Integrated Virtualization Manager. All aspects of Virtual I/O Server administration can be accomplished through the command-line interface, including the following:

In addition, in Integrated Virtualization Manager manager environments, the Virtual I/O Server command-line interface is used for partition management.

The first time you log in to the Virtual I/O Server, use the padmin user ID, which is the prime administrator user ID. You will be prompted for a new password.

Restricted shell

Upon logging in, you will be placed into a restricted Korn shell. The restricted Korn shell works in the same way as a standard Korn shell, except that you cannot do the following:

As a result of these restrictions, you will not be able to execute commands that are not accessible to your PATH variables. In addition, these restrictions prevent you from sending command output directly to a file. Instead, command output can be piped to the tee command.

After you log in, you can type help to get information about the supported commands. For example, to get help on the errlog command, type help errlog.

Execution Mode

The Virtual I/O Server command-line interface functions similarly to a standard command-line interface. Commands are issued with appropriate accompanying flags and parameters. For example, to list all adapters, type the following:

lsdev -type adapter

In addition, scripts can be run within the Virtual I/O Server command-line interface environment.

In addition to the Virtual I/O Server command-line interface commands, the following standard shell commands are provided.
Table 1. Standard shell commands and their functions
Command Function
awk Matches patterns and performs actions on them.
cat Concatenates or displays files.
chmod Changes file modes.
cp Copies files.
date Displays the date and time.
grep Searches a file for a pattern.
ls Displays the contents of a directory
mkdir Makes a directory.
man Displays manual entries for the Virtual I/O Server commands.
more Displays the contents of files one screen at a time.
rm Removes files.
sed Provides a stream editor.
stty Sets, resets, and reports workstation operating parameters.
tee Displays the output of a program and copies it to a file.
vi Edits files with full screen display.
wc Counts the number of lines, words, and bytes or characters in a file
who Identifies the users currently logged in.

As each command is executed, the user log and the global command log are updated.

The user log will contain a list of each Virtual I/O Server command, including arguments, that a user has executed. One user log for each user in the system is created. This log is located in the user's home directory and can be viewed by using either the cat or the vi commands.

The global command log (GCL) is made up of all the Virtual I/O Server command-line interface commands executed by all users, including arguments, the date and time the command was executed, and from which user ID it was executed. The GCL is viewable only by the padmin user ID, and it can be viewed by using the lsgcl command. If the global command log exceeds 1 MB, the log will be truncated to 250 KB to prevent the file system from reaching capacity.
Note: Integrated Virtualization Manager commands are audited in a separate place and are viewable either in Application Logs, or by running the following command from the command line: lssvcevents -t console --filter severities=audit

Send feedback | Rate this page

Last updated: Fri, Oct 30, 2009