###### lsvm.1 ###### .. highlight:: perl **** NAME **** \ **lsvm**\ - Lists information about HMC-, DFM-, IVM-, KVM-, VMware-, and zVM-managed partitions or virtual machines. For Power 775, it lists the LPARs' I/O slots information and CEC configuration. ******** SYNOPSIS ******** \ **lsvm**\ [\ **-h**\ | \ **-**\ **-help]**\ \ **lsvm**\ [\ **-v**\ | \ **-**\ **-version**\ ] \ **lsvm**\ [\ **-V**\ | \ **-**\ **-verbose**\ ] \ *noderange*\ \ **lsvm**\ [\ **-a**\ | \ **-**\ **-all**\ ] \ *noderange*\ For PPC (using Direct FSP Management): ====================================== \ **lsvm**\ [\ **-l**\ | \ **-**\ **-long**\ ] \ **-**\ **-p775**\ \ *noderange*\ \ **lsvm**\ \ *noderange*\ For KVM and VMware ================== \ **lsvm**\ \ *noderange*\ For zVM: ======== \ **lsvm**\ \ *noderange*\ *********** DESCRIPTION *********** The \ **lsvm**\ command lists all profiles defined for the partitions or virtual machines specified in \ *noderange*\ . If \ *noderange*\ is a CEC, all the partitions associated with that CEC are displayed. For PPC (using Direct FSP Management): ====================================== For Power 775 (use option \ **-**\ **-p775**\ to specify), \ **lsvm**\ lists all partition I/O slots information for the partitions specified in \ *noderange*\ . If \ *noderange*\ is a CEC, it gets the CEC's pump mode value, octant's memory interleaving value, the all the octants configure value, and all the I/O slots information. For DFM-managed (short for Direct FSP Management mode) normal power machine, \ **lsvm**\ lists the processor, memory, physical I/O slots, hugepage and BSR info for the specified partitions or CEC. The pump mode value has the valid options: 1 - Node Pump Mode 2 - Chip Pump Mode The Memory Interleaving Mode has 3 valid options: 0 - not Applicable 1 - interleaved 2 - non-interleaved More information about this part, refer to the section Using the \*vm commands to define partitions in xCAT DFM in the doc below. XCAT_Power_775_Hardware_Management For KVM and VMware ================== If \ *noderange*\ is a hypervisor, virtual machines defined on that hypervisor will be displayed. If \ *noderange*\ is a VM, details for that VM will be displayed. Note: Only the virtual machine which is in power on state can be listed by \ **lsvm**\ command. For zVM: ======== Show the directory entry for a given virtual machine. ******* OPTIONS ******* \ **-h**\ Display usage message. \ **-v**\ Command version. \ **-V**\ Verbose output. \ **-a**\ List all the profiles for one partition \ **-**\ **-p775**\ Specify the operation is for Power 775 machines. \ **-l**\ Show lparnames for lpars. It shall work with option \ **-**\ **-p775**\ . ************ RETURN VALUE ************ 0 The command completed successfully. 1 An error has occurred. ******** EXAMPLES ******** 1. To list all partition profiles defined for HMC-managed partition lpar3, enter: .. code-block:: perl lsvm lpar3 Output is similar to: .. code-block:: perl lpar3: name=lpar3,lpar_name=lpar3,lpar_id=4,lpar_env=aixlinux,all_resources=0,min_mem=512, desired_mem=2048, max_mem=3072,min_num_huge_pages=0,desired_num_huge_pages=0,max_num_huge_pages=0,proc_mode=shared, min_proc_units=0.5,desired_proc_units=0.5,max_proc_units=0.5,min_procs=1,desired_procs=1,max_procs=1, sharing_mode=uncap,uncap_weight=128,shared_proc_pool_id=0,shared_proc_pool_name=DefaultPool,io_slots=none, lpar_io_pool_ids=none,max_virtual_slots=10, "virtual_serial_adapters=1/server/1/any//any/1,0/server/1/any//any/1", virtual_scsi_adapters=2/client/1/p6vios/4/1,virtual_eth_adapters=3/0/1//0/1,hca_adapters=none,boot_mode=norm,conn_monitoring=0,auto_start=0,power_ctrl_lpar_ids=none,work_group_id=none,redundant_err_path_reporting=0, bsr_arrays=0,lhea_logical_ports=none,lhea_capabilities=none,lpar_proc_compat_mode=default,electronic_err_reporting=null 2. To list all IVM-managed partitions associated with CEC cec01, enter: .. code-block:: perl lsvm cec01 Output is similar to: .. code-block:: perl cec01: name=10-B7D1G,lpar_name=10-B7D1G,lpar_id=1,os_type=vioserver,all_resources=0,min_mem=512, desired_mem=2048,max_mem=2048,proc_mode=shared,min_proc_units=0.10,desired_proc_units=0.40, max_proc_units=4.00,min_procs=1,desired_procs=4,max_procs=4,sharing_mode=uncap,uncap_weight=128, "io_slots=21010002/none/0,21010003/none/0,21010004/none/0,21020003/none/0,21020004/none/0,21030003/none/0,21030004/none/0,21040003/none/0,21040004/none/0",lpar_io_pool_ids=none,max_virtual_slots=48, "virtual_serial_adapters=0/server/1/any//any/1,1/server/1/any//any/1,10/client/0/2/lp2/0/0,12/client/0/3/lp3/0/0,14/client/0/4/lp4/0/0","virtual_scsi_adapters=11/server/2/lp2/2/0,13/server/3/lp3/2/0,15/server/4/lp4/2/0","virtual_eth_adapters=3/0/1//1/0,4/0/2//1/0,5/0/3//1/0,6/0/4//1/0",boot_mode=norm,conn_monitoring=0,auto_start=0,power_ctrl_lpar_ids=none name=lp2,lpar_name=lp2,lpar_id=2,os_type=aixlinux,all_resources=0,min_mem=128,desired_mem=1024,max_mem=1024,proc_mode=shared,min_proc_units=0.10,desired_proc_units=0.10,max_proc_units=4.00,min_procs=1,desired_procs=1,max_procs=4,sharing_mode=uncap,uncap_weight=128,io_slots=none,lpar_io_pool_ids=none,max_virtual_slots=6, "virtual_serial_adapters=0/server/1/any//any/1,1/server/1/any//any/1",virtual_scsi_adapters=2/client/1/10-7D1G/11/1,virtual_eth_adapters=4/0/1//0/0,boot_mode=norm,conn_monitoring=0,auto_start=0,power_ctrl_lpar_ids=none name=lp3,lpar_name=lp3,lpar_id=3,os_type=aixlinux,all_resources=0,min_mem=128,desired_mem=128,max_mem=128,proc_mode=shared,min_proc_units=0.10,desired_proc_units=0.10,max_proc_units=4.00,min_procs=1,desired_procs=1,max_procs=4,sharing_mode=uncap,uncap_weight=128,io_slots=none,lpar_io_pool_ids=none,max_virtual_slots=6, "virtual_serial_adapters=0/server/1/any//any/1,1/server/1/any//any/1",virtual_scsi_adapters=2/client/1/10-B7D1G/13/1,virtual_eth_adapters=4/0/1//0/0,boot_mode=of,conn_monitoring=0,auto_start=1, power_ctrl_lpar_ids=none 3. For Power 775, to list the I/O slot information of lpar1, enter: .. code-block:: perl lsvm lpar1 --p775 Output is similar to: .. code-block:: perl 1: 514/U78A9.001.0123456-P1-C17/0x21010202/2/1 1: 513/U78A9.001.0123456-P1-C15/0x21010201/2/1 1: 512/U78A9.001.0123456-P1-C16/0x21010200/2/1 4. To list the lparname of lpars, enter: .. code-block:: perl lsvm lpar1 -l --p775 Output is similar to: .. code-block:: perl lpar1: 1: 514/U78A9.001.0123456-P1-C17/0x21010202/2/1 lpar1: 1: 513/U78A9.001.0123456-P1-C15/0x21010201/2/1 lpar1: 1: 512/U78A9.001.0123456-P1-C16/0x21010200/2/1 5. For Power 775, to list the I/O slot information and octant configuration of cec1, enter: .. code-block:: perl lsvm cec1 --p775 Output is similar to: .. code-block:: perl 1: 514/U78A9.001.0123456-P1-C17/0x21010202/2/1 1: 513/U78A9.001.0123456-P1-C15/0x21010201/2/1 1: 512/U78A9.001.0123456-P1-C16/0x21010200/2/1 13: 537/U78A9.001.0123456-P1-C9/0x21010219/2/13 13: 536/U78A9.001.0123456-P1-C10/0x21010218/2/13 17: 545/U78A9.001.0123456-P1-C7/0x21010221/2/17 17: 544/U78A9.001.0123456-P1-C8/0x21010220/2/17 21: 553/U78A9.001.0123456-P1-C5/0x21010229/2/21 21: 552/U78A9.001.0123456-P1-C6/0x21010228/2/21 25: 569/U78A9.001.0123456-P1-C1/0x21010239/2/25 25: 561/U78A9.001.0123456-P1-C3/0x21010231/2/25 25: 560/U78A9.001.0123456-P1-C4/0x21010230/2/25 29: 568/U78A9.001.0123456-P1-C2/0x21010238/2/29 5: 521/U78A9.001.0123456-P1-C13/0x21010209/2/5 5: 520/U78A9.001.0123456-P1-C14/0x21010208/2/5 9: 529/U78A9.001.0123456-P1-C11/0x21010211/2/9 9: 528/U78A9.001.0123456-P1-C12/0x21010210/2/9 cec1: PendingPumpMode=1,CurrentPumpMode=1,OctantCount=8: OctantID=0,PendingOctCfg=5,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=1,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=2,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=3,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=4,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=5,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=6,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=7,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; 6. To list the lparname of lpars, enter: .. code-block:: perl lsvm cec1 -l --p775 Output is similar to: .. code-block:: perl lpar1: 1: 514/U78A9.001.0123456-P1-C17/0x21010202/2/1: 32: 0/3/3 lpar1: 1: 513/U78A9.001.0123456-P1-C15/0x21010201/2/1: 32: 0/3/3 lpar1: 1: 512/U78A9.001.0123456-P1-C16/0x21010200/2/1: 32: 0/3/3 lpar13: 13: 537/U78A9.001.0123456-P1-C9/0x21010219/2/13: 32: 0/3/3 lpar13: 13: 536/U78A9.001.0123456-P1-C10/0x21010218/2/13: 32: 0/3/3 lpar17: 17: 545/U78A9.001.0123456-P1-C7/0x21010221/2/17: 32: 0/0/0 lpar17: 17: 544/U78A9.001.0123456-P1-C8/0x21010220/2/17: 32: 0/0/0 lpar21: 21: 553/U78A9.001.0123456-P1-C5/0x21010229/2/21: 32: 0/0/0 lpar21: 21: 552/U78A9.001.0123456-P1-C6/0x21010228/2/21: 32: 0/0/0 lpar24: 25: 569/U78A9.001.0123456-P1-C1/0x21010239/2/25: 32: 0/0/0 lpar25: 25: 561/U78A9.001.0123456-P1-C3/0x21010231/2/25: 32: 0/0/0 lpar25: 25: 560/U78A9.001.0123456-P1-C4/0x21010230/2/25: 32: 0/0/0 lpar29: 29: 568/U78A9.001.0123456-P1-C2/0x21010238/2/29: 32: 0/0/0 lpar5: 5: 521/U78A9.001.0123456-P1-C13/0x21010209/2/5: 32: 0/3/3 lpar5: 5: 520/U78A9.001.0123456-P1-C14/0x21010208/2/5: 32: 0/3/3 lpar9: 9: 529/U78A9.001.0123456-P1-C11/0x21010211/2/9: 32: 0/3/3 lpar9: 9: 528/U78A9.001.0123456-P1-C12/0x21010210/2/9: 32: 0/3/3 cec1: PendingPumpMode=1,CurrentPumpMode=1,OctantCount=8: OctantID=0,PendingOctCfg=5,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=1,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=2,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=3,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=4,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=5,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=6,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; OctantID=7,PendingOctCfg=1,CurrentOctCfg=1,PendingMemoryInterleaveMode=2,CurrentMemoryInterleaveMode=2; Number of BSR arrays: 256,Bytes per BSR array: 4096,Available BSR array: 0; Available huge page memory(in pages): 0 Configurable huge page memory(in pages): 12 Page Size(in GB): 16 Maximum huge page memory(in pages): 24 Requested huge page memory(in pages): 15 Number of BSR arrays: 256,Bytes per BSR array: 4096,Available BSR array: 0; Available huge page memory(in pages): 0 Configurable huge page memory(in pages): 12 Page Size(in GB): 16 Maximum huge page memory(in pages): 24 Requested huge page memory(in pages): 15 7. To list the virtual machine's directory entry: .. code-block:: perl lsvm gpok3 Output is similar to: .. code-block:: perl gpok3: USER LNX3 PWD 512M 1G G gpok3: INCLUDE LNXDFLT gpok3: COMMAND SET VSWITCH VSW2 GRANT LNX3 8. For DFM-managed normal power machine, list out the detailed resource information: .. code-block:: perl lsvm cec Output is similar to: .. code-block:: perl cec: HYP Configurable Processors: 16, Avail Processors: 16. HYP Configurable Memory:32.00 GB(128 regions). HYP Available Memory: 31.25 GB(125 regions). HYP Memory Region Size: 0.25 GB(256 MB). cec: All Physical I/O info: 65535,519,U78AA.001.WZSGVU7-P1-C7,0x21010207,0xffff(Empty Slot) 65535,518,U78AA.001.WZSGVU7-P1-C6,0x21010206,0xffff(Empty Slot) 65535,517,U78AA.001.WZSGVU7-P1-C5,0x21010205,0xffff(Empty Slot) 65535,516,U78AA.001.WZSGVU7-P1-C4,0x21010204,0xffff(Empty Slot) 65535,514,U78AA.001.WZSGVU7-P1-C19,0x21010202,0xffff(Empty Slot) 65535,513,U78AA.001.WZSGVU7-P1-T7,0x21010201,0xc03(USB Controller) 65535,512,U78AA.001.WZSGVU7-P1-T9,0x21010200,0x104(RAID Controller) cec: Huge Page Memory Available huge page memory(in pages): 2 Configurable huge page memory(in pages): 2 Page Size(in GB): 16 Maximum huge page memory(in pages): 4 Requested huge page memory(in pages): 2 cec: Barrier Synchronization Register(BSR) Number of BSR arrays: 256 Bytes per BSR array: 4096 Available BSR array: 256 Note: The lines listed in "All Physical I/O info" section represent all the physical I/O resource information. The format is like "owner_lparid,slot_id,physical resource name,drc_index,slot_class_code(class description)". The 'drc index' is short for Dynamic Resource Configuration Index, it uniquely indicates a physical I/O resource in a normal power machine. 9. For DFM-managed partition on normal power machine, list out the detailed information: .. code-block:: perl lsvm lpar1 Output is similar to: .. code-block:: perl lpar1: Lpar Processor Info: Curr Processor Min: 1. Curr Processor Req: 16. Curr Processor Max: 16. lpar1: Lpar Memory Info: Curr Memory Min: 0.25 GB(1 regions). Curr Memory Req: 30.75 GB(123 regions). Curr Memory Max: 32.00 GB(128 regions). lpar1: 1,519,U78AA.001.WZSGVU7-P1-C7,0x21010207,0xffff(Empty Slot) lpar1: 1,518,U78AA.001.WZSGVU7-P1-C6,0x21010206,0xffff(Empty Slot) lpar1: 1,517,U78AA.001.WZSGVU7-P1-C5,0x21010205,0xffff(Empty Slot) lpar1: 1,516,U78AA.001.WZSGVU7-P1-C4,0x21010204,0xffff(Empty Slot) lpar1: 1,514,U78AA.001.WZSGVU7-P1-C19,0x21010202,0xffff(Empty Slot) lpar1: 1,513,U78AA.001.WZSGVU7-P1-T7,0x21010201,0xc03(USB Controller) lpar1: 1,512,U78AA.001.WZSGVU7-P1-T9,0x21010200,0x104(RAID Controller) lpar1: 1/2/2 lpar1: 256. ***** FILES ***** /opt/xcat/bin/lsvm ******** SEE ALSO ******** mkvm(1)|mkvm.1, chvm(1)|chvm.1, rmvm(1)|rmvm.1