Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
- IBM Virtualization Discovery
- Overview
- Supported Versions
- Topology
- How to Discover IBM Virtualization
- IBM Virtualization by Shell Job
- IBM LPAR and VIO Server Topology by Shell Job
- IBM PureFlex Topology by Shell Job
- IBM WPAR Topology by Shell Job
- IBM Virtualization Commands
- VIO Server Side Commands
- LPAR Side Commands
- WPAR Side Commands
- Created/Changed Entities
- Troubleshooting and Limitations – IBM Virtualization Discovery
IBM Virtualization Commands
This section includes the following commands:
version= Version: 7 Release: 3.5.0 Service Pack: 0 HMC Build level 20091201.1 MH01195: Required fix for HMC V7R3.5.0 (10-16-2009) MH01197: Fix for HMC V7R3.5.0 (11-12-2009) MH01204: Fix for HMC V7R3.5.0 (12-11-2009) ","base_version=V7R3.5.0 "
The output of this command is used to fill in the attributes of the IBM HMC CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
Version |
IBM HMC |
Version_number |
Base_version |
IBM HMC |
Application_version_description |
vpd=*FC ???????? *VC 20.0 *N2 Tue Apr 27 13:05:33 CEST 2010 *FC ???????? *DS Hardware Management Console *TM eserver xSeries 335 -[XXXXCR2]- *SE XXXXXXX *MN IBM *PN Unknown *SZ 1059495936 *OS Embedded Operating Systems *NA 192.168.1.10 *FC ???????? *DS Platform Firmware *RM V7R3.5.0.0
The output of this command is used to fill in the attributes of the IBM HMC CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
SE |
IBM HMC |
HMC Serial Number |
TM |
IBM HMC |
HMC TYPE |
hostname=hmc01,domain=somedomain.com,
"ipaddr=192.168.1.10,0.0.0.0,192.168.128.1",
"networkmask=255.255.254.0,255.255.255.0,255.255.128.0",
gateway=192.168.1.1,nameserver=,domainsuffix=,
slipipaddr=192.168.1.1,slipnetmask=255.255.0.0,
"ipaddrlpar=192.168.80.1,192.168.128.1",
"networkmasklpar=255.255.254.0,255.255.128.0",
clients=,ipv6addrlpar=,ipv4addr_eth0=192.168.1.10,
ipv4netmask_eth0=255.255.254.0,ipv4dhcp_eth0=off,ipv6addr_eth0=,
ipv6auto_eth0=off,ipv6privacy_eth0=off,ipv6dhcp_eth0=off,
lparcomm_eth0=off,jumboframe_eth0=off,speed_eth0=100,
duplex_eth0=full,tso_eth0=off,ipv4addr_eth1=0.0.0.0,
ipv4netmask_eth1=255.255.255.0,ipv4dhcp_eth1=off,
ipv6addr_eth1=,ipv6auto_eth1=off,ipv6privacy_
eth1=off,ipv6dhcp_eth1=off,lparcomm_eth1=off,jumboframe_
eth1=off,speed_eth1=auto,duplex_eth1=auto,tso_
eth1=off,ipv4addr_eth2=192.168.128.1,ipv4netmask_
eth2=255.255.128.0,ipv4dhcp_eth2=off,ipv6addr_
eth2=,ipv6auto_eth2=off,ipv6privacy_eth2=off,ipv6dhcp_
eth2=off,lparcomm_eth2=off,jumboframe_eth2=off,speed_
eth2=auto,duplex_eth2=auto,tso_eth2=off
The output of this command is used to fill in the network information for a particular HMC machine. A host with HMC running on it is always reported as an incomplete host, since there is no information regarding the interface MAC addresses and the default UNIX command does not work in this environment.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
constant AIX |
Unix |
Host Operating System |
Hostname |
Unix |
Host Name |
Hostname |
Unix |
Name |
Domain |
Unix |
OS Domain Name |
Ipv4addr_eth<0..N> |
IpAddress |
Ip Address |
2,192.168.80.52,3;1,192.168.80.62,3;3,192.168.80.53,3
Each block in the output is separated by the semicolon character (;). The first value is the LPAR ID and the second value is the LPAR IP address. By matching the ID of the LPAR with output from other commands an incomplete host is created and reported with an assigned LPAR Profile CI.
name=XXXXXXX-XXXX-XXX-XXXXXXXXX-XX,type_model=XXXX-XXX, serial_num=XXXXXX,ipaddr=192.168.1,10,state=Operating,sys_time=04/27/2010 12:55:23,power_off_policy=1,active_lpar_mobility_capable=0,inactive_lpar_mobility_capable=0,active_lpar_share_idle_procs_capable=0,active_mem_sharing_capable=0,bsr_capable=0,cod_mem_capable=0,cod_proc_capable=1,electronic_err_reporting_capable=0,firmware_power_saver_capable=0,hardware_power_saver_capable=0,hardware_discovery_capable=0,addr_broadcast_perf_policy_capable=0,hca_capable=1,huge_page_mem_capable=1,lhea_capable=0,lpar_avail_priority_capable=0,lpar_proc_compat_mode_capable=0,micro_lpar_capable=1,os400_capable=0,5250_application_capable=0,redundant_err_path_reporting_capable=1,shared_eth_failover_capable=1,sni_msg_passing_capable=0,sp_failover_capable=1,vet_activation_capable=1,virtual_fc_capable=0,virtual_io_server_capable=1,virtual_switch_capable=0,assign_5250_cpw_percent=0,max_lpars=40,max_power_ctrl_lpars=1,hca_bandwidth_capabilities=null,service_lpar_id=none,curr_sys_keylock=norm,pend_sys_keylock=norm,curr_power_on_side=temp,pend_power_on_side=temp,curr_power_on_speed=fast,pend_power_on_speed=fast,curr_power_on_speed_override=none,pend_power_on_speed_override=none,power_on_type=power on,power_on_option=standby,power_on_lpar_start_policy=userinit,pend_power_on_option=standby,pend_power_on_lpar_start_policy=userinit,power_on_method=02,power_on_attr=0000,sp_boot_attr=0000,sp_boot_major_type=08,sp_boot_minor_type=01,sp_version=00030030,mfg_default_config=0,curr_mfg_default_ipl_source=a,pend_mfg_default_ipl_source=a,curr_mfg_default_boot_mode=norm,pend_mfg_default_boot_mode=norm
For each detected IBM Pseries Frame, a Hypervisor CI is created with the set name attribute IBM Hypervisor.
The output of this command is used to fill in the attributes of the IBM PSeries Frame CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
Name |
IBM PSeries Frame |
Name |
serial_number |
IBM PSeries Frame |
Host Key |
cod_proc_capable |
IBM PSeries Frame |
CPU Capacity on Demand Capable |
cod_mem_capable |
IBM PSeries Frame |
Memory Capacity on Demand Capable |
huge_page_mem_capable |
IBM PSeries Frame |
Huge Memory Page Capable |
max_lpars |
IBM PSeries Frame |
Max LPARs |
Status |
IBM PSeries Frame |
Frame State |
micro_lpar_capable |
IBM PSeries Frame |
Micro LPAR Capable |
service_lpar_id |
IBM PSeries Frame |
Service LPAR ID |
service_lpar_name |
IBM PSeries Frame |
Service LPAR Name |
configurable_sys_proc_units=4.0,curr_avail_sys_proc_units=1.4, pend_avail_sys_proc_units=1.4,installed_sys_proc_units=4.0, max_capacity_sys_proc_units=deprecated,deconfig_sys_proc_units=0, min_proc_units_per_virtual_proc=0.1,max_virtual_procs_per_lpar=64,max_procs_per_lpar=4,max_curr_virtual_procs_per_aixlinux_lpar=64,max_curr_virtual_procs_per_vios_lpar=64, max_curr_virtual_procs_per_os400_lpar=64,max_curr_procs_per_aixlinux_lpar=4, max_curr_procs_per_vios_lpar=4,max_curr_procs_per_os400_lpar=4, max_shared_proc_pools=1
The output of this command is used to fill in the attributes of the IBM PSeries Frame CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
min_proc_units_per_virtual_proc |
IBM PSeries Frame |
Min CPU Units per Virtual CPU |
curr_avail_sys_proc_units |
IBM PSeries Frame |
Current Available CPU Units |
max_shared_proc_pools |
IBM PSeries Frame |
Max Shared CPU Pools |
configurable_sys_proc_units |
IBM PSeries Frame |
Configurable CPU Units |
installed_sys_proc_units |
IBM PSeries Frame |
Installed CPU Units |
pend_avail_sys_proc_units |
IBM PSeries Frame |
Pending Available CPU Units |
max_procs_per_lpar |
IBM PSeries Frame |
Max CPUs per LPAR |
max_virtual_procs_per_lpar |
IBM PSeries Frame |
Max Virtual CPUs per LPAR |
configurable_sys_mem=32768,curr_avail_sys_mem=1344,pend_avail_sys_mem=1344, installed_sys_mem=32768,max_capacity_sys_mem=deprecated,deconfig_sys_mem=0, sys_firmware_mem=704,mem_region_size=64,configurable_num_sys_huge_pages=0, curr_avail_num_sys_huge_pages=0,pend_avail_num_sys_huge_pages=0, max_num_sys_huge_pages=1,requested_num_sys_huge_pages=0,huge_page_size=16384, max_mem_pools=0
The output of this command is used to fill in the attributes of the IBM PSeries Frame CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
configurable_sys_mem |
IBM PSeries Frame |
Configurable System Memory |
max_num_sys_huge_pages |
IBM PSeries Frame |
Max Number of Huge Pages |
huge_page_size |
IBM PSeries Frame |
Huge Page Size |
sys_firmware_mem |
IBM PSeries Frame |
Firmware Memory |
mem_region_size |
IBM PSeries Frame |
Memory Region Size |
curr_avail_sys_mem |
IBM PSeries Frame |
Current Available Memory |
installed_sys_mem |
IBM PSeries Frame |
Installed Memory |
requested_num_sys_huge_pages |
IBM PSeries Frame |
Requested Number of Huge Pages |
pend_avail_sys_mem |
IBM PSeries Frame |
Pending Available Memory |
configurable_pool_proc_units=4.0,curr_avail_pool_proc_units=1.4,pend_avail_pool_proc_units=1.4
If there are no user-defined pools, the pool_id parameter does not appear in the output (pool_id is considered by the system to be zero by default).
The output of this command is used to fill in the attributes of the IBM Processor Pool CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
curr_avail_pool_proc_units |
IBM Processor Pool |
CPU Pool Available Physical CPUs |
configurable_pool_proc_units |
IBM Processor Pool |
CPU Pool Configurable Physical CPUs |
pend_avail_pool_proc_units |
IBM Processor Pool |
CPU Pool Pending Available Physical CPUs |
pool_id |
IBM Processor Pool |
Name |
name=somelparname1,lpar_id=5,lpar_env=aixlinux,state=Running,resource_config=1,os_version=Unknown,logical_serial_num=65B922G5,default_profile=somedefaultprofilename1,curr_profile=somelparprofilename1,work_group_id=none,shared_proc_pool_util_auth=1,allow_perf_collection=1,power_ctrl_lpar_ids=none,boot_mode=sms,lpar_keylock=norm,auto_start=0,redundant_err_path_reporting=0
The output of this command is used to fill in the attributes of the IBM LPAR Profile CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
logical_serial_num |
IBM LPAR Profile |
LPAR Serial Number |
boot_mode |
IBM LPAR Profile |
LPAR Profile Boot Mode |
auto_start |
IBM LPAR Profile |
LPAR Profile Auto Start |
work_group_id |
IBM LPAR Profile |
LPAR Profile Workgroup ID |
default_profile |
IBM LPAR Profile |
LPAR default profile name |
curr_profile |
IBM LPAR Profile |
LPAR profile name |
power_ctrl_lpar_ids |
IBM LPAR Profile |
LPAR power control ids |
State |
IBM LPAR Profile |
Lpar state |
lpar_env |
IBM LPAR Profile |
Lpar type |
lpar_id |
IBM LPAR Profile |
LPAR ID |
Name |
IBM LPAR Profile |
LPAR Name |
name=name1,lpar_name=name2,lpar_id=5,lpar_env=aixlinux,
all_resources=0,min_mem=4096,desired_mem=8192,max_mem=8192,
min_num_huge_pages=0,desired_num_huge_pages=0,
max_num_huge_pages=0,proc_mode=shared,min_proc_units=0.3,
desired_proc_units=0.5,max_proc_units=1.0,min_procs=1,
desired_procs=2,max_procs=2,sharing_mode=uncap,
uncap_weight=128,io_slots=none,lpar_io_pool_ids=none,
max_virtual_slots=10,"virtual_serial_adapters=0/server/1/
any//any/1,1/server/1/any//any/1","virtual_scsi_adapters=5/
client/1/l11s12vio1/13/1,6/client/1/l11s12vio1/14/1,7/client
/1/l11s12vio1/15/1",virtual_eth_adapters=2/0/1//0/1,
hca_adapters=none,boot_mode=norm,conn_monitoring=1,auto_start=0,
power_ctrl_lpar_ids=none,work_group_id=none,redundant_err_path_reporting=0
name=name3,lpar_name=name4,lpar_id=4,lpar_env=aixlinux,all_resources=0,
min_mem=4096,desired_mem=10240,max_mem=10240,min_num_huge_pages=0,
desired_num_huge_pages=0,max_num_huge_pages=0,proc_mode=shared,
min_proc_units=0.3,desired_proc_units=0.7,max_proc_units=1.0,
min_procs=1,desired_procs=2,max_procs=2,sharing_mode=uncap,
uncap_weight=128,io_slots=none,lpar_io_pool_ids=none,
max_virtual_slots=10,"virtual_serial_adapters=0/server
/1/any//any/1,1/server/1/any//any/1",
"virtual_scsi_adapters=5/client/1/l11s12vio1/10/1,6/
client/1/l11s12vio1/11/1,7/client/1/l11s12vio1/12/1",
virtual_eth_adapters=2/0/2//0/1,hca_adapters=none,boot_mode=norm,
conn_monitoring=1,auto_start=0,power_ctrl_lpar_ids=none,
work_group_id=none,redundant_err_path_reporting=0
The output of this command is used to fill in the attributes of the IBM LPAR Profile CI:
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
sharing_mode |
IBM LPAR Profile |
LPAR Profile Sharing Mode |
proc_mode |
IBM LPAR Profile |
LPAR Profile CPU Mode |
uncap_weight |
IBM LPAR Profile |
LPAR Profile Uncapped Weight |
desired_num_huge_pages |
IBM LPAR Profile |
LPAR Profile Desired Number of Huge Memory Pages |
min_num_huge_pages |
IBM LPAR Profile |
LPAR Profile Minimum Number of Huge Memory Pages |
max_procs |
IBM LPAR Profile |
LPAR Profile Maximum Number of CPUs |
desired_procs |
IBM LPAR Profile |
LPAR Profile Desired Number of CPUs |
min_proc_units |
IBM LPAR Profile |
LPAR Profile Minimum Physical CPUs |
max_mem |
IBM LPAR Profile |
LPAR Profile Maximum memory |
conn_monitoring |
IBM LPAR Profile |
LPAR Profile Connection Monitoring Enabled |
min_mem |
IBM LPAR Profile |
LPAR Profile Minimum Memory on this LPAR |
max_virtual_slots |
IBM LPAR Profile |
LPAR Profile Maximum Number of Virtual Slots |
redundant_err_path_reporting |
IBM LPAR Profile |
LPAR Profile Redundant Error Path Reporting |
max_num_huge_pages |
IBM LPAR Profile |
LPAR Profile Maximum Number of Huge Memory Pages |
min_procs |
IBM LPAR Profile |
LPAR Profile Minimum Number of CPUs |
max_proc_units |
IBM LPAR Profile |
LPAR Profile Maximum Physical CPUs |
io_slots |
IBM LPAR Profile |
LPAR Profile IO Slots |
lpar_io_pool_ids |
IBM LPAR Profile |
LPAR Profile IO Pool IDs |
desired_proc_units |
IBM LPAR Profile |
LPAR Profile Desired Physical CPUs |
desired_mem |
IBM LPAR Profile |
LPAR Profile Memory Requested by this LPAR |
virtual_serial_adapters |
IBM LPAR Profile |
LPAR Profile Virtual Serial Adapters |
lpar_name=name1,lpar_id=1,slot_num=2,state=1,is_required=1,is_trunk=1,trunk_priority=1, ieee_virtual_eth=0,port_vlan_id=1,addl_vlan_ids=,mac_addr=765920001002 lpar_name=l11s12vio1,lpar_id=1,slot_num=3,state=1,is_required=1,is_trunk=1,trunk_priority=1, ieee_virtual_eth=0,port_vlan_id=2,addl_vlan_ids=,mac_addr=765920001003 lpar_name=name2,lpar_id=2,slot_num=2,state=1,is_required=1,is_trunk=0,ieee_virtual_eth=0, port_vlan_id=1,addl_vlan_ids=,mac_addr=765920002002 lpar_name=name3,lpar_id=3,slot_num=2,state=1,is_required=1,is_trunk=0,ieee_virtual_eth=0, port_vlan_id=1,addl_vlan_ids=,mac_addr=765920003002 lpar_name=name4,lpar_id=4,slot_num=2,state=1,is_required=1,is_trunk=0,ieee_virtual_eth=0, port_vlan_id=2,addl_vlan_ids=,mac_addr=765920004002 lpar_name=name5,lpar_id=5,slot_num=2,state=1,is_required=1,is_trunk=0,ieee_virtual_eth=0, port_vlan_id=1,addl_vlan_ids=,mac_addr=765920005002
The mac_addr attribute is represented in the Dec form without leading zeros. This value is transformed to the Hex value and left padded with missing zeros, to assure a proper representation of the MAC address in the CMDB.
Based on the MAC address, the virtual NICs are created and attached to the corresponding LPAR or VIO server, and are described by Lpar_name or Lpar_id. The Vlan CI is created based on vlan_id or addl_vlan_ids and is linked to the ports of the interfaces. The root container for the VLAN is a specific IBM PSeries Frame (Managed System).
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
port_vlan_id/addl_vlan_ids |
VLAN |
Vlan Number |
IBM PSeries Frame CMDB ID |
VLAN |
Root Container |
mac_addr (converted to Hex if needed and normalized) |
Interface |
MAC Address |
lpar_name=vioname1,lpar_id=1,slot_num=15,state=1,is_required=0,adapter_type=server,remote_lpar_id=5,remote_lpar_name=lparname1,remote_slot_num=7 lpar_name=vioname1,lpar_id=1,slot_num=14,state=1,is_required=0,adapter_type=server,remote_lpar_id=5,remote_lpar_name=lparname2,remote_slot_num=6 lpar_name=vioname1,lpar_id=1,slot_num=13,state=1,is_required=0,adapter_type=server,remote_lpar_id=5,remote_lpar_name=lparname2,remote_slot_num=5
The lpar_name and lpar_id attributes are always the name and ID of the VIO server that creates and grants the Virtual SCSI to the LPARs. The SCSI Adapter on the LPAR is identified by its slot number and the LPAR name it belongs to.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
Slot_num/remote_slot_num |
SCSI |
Slot Number |
Host ID with name <lpar_name> or <Remote LPAR Name> |
SCSI |
Root Container |
lpar_name=name1,lpar_id=5,curr_shared_proc_pool_id=0,curr_proc_mode=shared,curr_min_proc_units=0.3,curr_proc_units=0.5,curr_max_proc_units=1.0,curr_min_procs=1,curr_procs=2,curr_max_procs=2,curr_sharing_mode=uncap,curr_uncap_weight=128,pend_shared_proc_pool_id=0,pend_proc_mode=shared,pend_min_proc_units=0.3,pend_proc_units=0.5,pend_max_proc_units=1.0,pend_min_procs=1,pend_procs=2,pend_max_procs=2,pend_sharing_mode=uncap,pend_uncap_weight=128,run_proc_units=0.5,run_procs=2,run_uncap_weight=128
Using the "lpar_name"/"lpar_id" along with the "curr_shared_proc_pool_id" from the output we can create corresponding links to the particular Shared Processor Pool ("IBM Processor Pool") the LPar uses. In case of the dedicated ("ded") CPU we will create links to the spare processors.
unit_phys_loc=XXXXX.XXX.XXXXXXX,bus_id=2,phys_loc=C3,drc_index=21010002,lpar_name=name1,lpar_id=1,slot_io_pool_id=none,description=RAID Controller,feature_codes=none,pci_vendor_id=1069,pci_device_id=B166,pci_subs_vendor_id=1014,pci_subs_device_id=0278,pci_class=0104,pci_revision_id=04,bus_grouping=0,iop=0,parent_slot_drc_index=none,drc_name=XXXXX.XXX.XXXXXXX-XX-XX
The output of this command is used to create the I/O Slot CI. Using the name and ID of the LPAR, discovery creates the relationship to the particular LPAR that is using the slot.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
Description |
I/O Slot |
Name of the Slot |
bus_id |
I/O Slot |
Slot Bus ID |
phys_loc |
I/O Slot |
Slot Physical Location on Bus |
pci_revision_id |
I/O Slot |
Slot PCI Revision ID |
bus_grouping |
I/O Slot |
Slot Bus Grouping |
pci_device_id |
I/O Slot |
Slot PCI Device ID |
unit_phys_loc |
I/O Slot |
Slot Physical Location |
parent_slot_drc_index |
I/O Slot |
Slot Parent Slot DRC Index |
drc_index |
I/O Slot |
Slot DRC Index |
pci_subs_vendor_id |
I/O Slot |
Slot PCI Subslot Vendor ID |
pci_class |
I/O Slot |
Slot PCI Class |
slot_io_pool_id |
I/O Slot |
Slot IO Pool ID |
pci_vendor_id |
I/O Slot |
Slot PCI Vendor ID |
drc_name |
I/O Slot |
Slot DRC Name |
feature_codes |
I/O Slot |
Slot Feature Codes |
pci_subs_device_id |
I/O Slot |
Slot PCI Subslot Device ID |