lsvm

Use the lsvm command to list all virtual machines that are known to IBM Spectrum Control. You can also list only the virtual machines that were discovered through hypervisors.

Syntax

Read syntax diagramSkip visual syntax diagramtpctoollsvm-user user_name -pwd password -url url -hypervisorHypervisor ID-l-fs character-header -help-qs character?-silent

Parameters and arguments

-user user_name
Specifies an IBM Spectrum Control user ID.
-pwd password
Specifies the password for the IBM Spectrum Control user ID.
-url url
Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-hypervisor hypervisor_id
Specifies that information is displayed for all virtual machines that were discovered through a specific hypervisor.
-l
Specifies that the following information is listed.
VM ID
A unique ID for the virtual machine.
VM Name
The name of the virtual machine if discovered through a hypervisor. For all other virtual machines, the name is the URL of the host server.
Hypervisor Name
The name of the hypervisor for virtual machines that were discovered through a hypervisor. For all other virtual machines, this field is non-applicable.
IP Address
The IP address of the server that is associated with the virtual machine.
OS Type
The operating system type of the server that is associated with the virtual machine.
-fs character
Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
-header
Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-help | -h | -?
Lists help information for the command.
-qs character
Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
-silent
Suppresses all output for the command. If you omit this parameter, output is included.

Example: List all virtual machines on a hypervisor

The following command generates a list of all virtual machines for a particular hypervisor.
tpctool> lsvm -l

The following output is returned:

ID Name Hypervisor Name OS Type Host Name IP Address
==========================================================================================================
==========================================================================================================
sor1+sour.storage.abc.ib.com sor1 sour.storage.abc.ib.com "Microsoft Windows Server 2016 or later (64-Bit)"
sor1.storage.abc.ib.com 192.168.111.21
sor2+sour.storage.abc.ib.com sor2 sour.storage.abc.ib.com "Red Hat Enterprise Linux 7 (64-Bit)" 
sor2.storage.abc.ib.com 192.168.111.22