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
VIO Server Side Commands
This section includes the following commands:
ent0: U100C.001.DQDE777-P1-C4-T1 ent1:U100C.001.DQDE777-P1-C4-T2 ent2:U100C.001.DQDE777-P1-C4-T3 ent16: ent17: ent18: ent19: ent20:
The interface names and physical location of the particular interface are the output of this command. The output is split at the colon character (:) line by line; the first part is the interface name and the last is the physical location. A physical location is not always present, for example, it is not set for the SEA and Link Aggregation Interface. The physical location value is used to create a link from the physical NIC to the I/O slot.
Example: ioscli entstat -all 'ent16'| grep -E "ETHERNET STATISTICS|Device Type|Hardware Address
ETHERNET STATISTICS (ent16) : Device Type: Shared Ethernet Adapter Hardware Address: 00:1B:64:91:74:55 ETHERNET STATISTICS (ent14) : Device Type: EtherChannel Hardware Address: 00:1B:64:91:74:55 ETHERNET STATISTICS (ent0) : Device Type: 2-Port 10/100/1000 Base-TX PCI-X Adapter (14108902) Hardware Address: 00:1a:64:91:74:44 ETHERNET STATISTICS (ent2) : Device Type: 2-Port 10/100/1000 Base-TX PCI-X Adapter (14108902) Hardware Address: 00:1B:64:91:74:55 ETHERNET STATISTICS (ent4) : Device Type: Virtual I/O Ethernet Adapter (l-lan) Hardware Address: 46:61:fa:d4:bf:0b
UCMDB Version 8.0x: There cannot be two interfaces with the same MAC on a single machine. In this case the MAC Address attribute for the first interface only takes the value of the MAC address, while the other interfaces contain an underscore (_) and interface index. For example, for the above output interface ent0 is reported with MAC Address set to 00:1B:64:91:74:55 while interface ent2 is reported with MAC Address set to 00:1B:64:91:74:55_2.
UCMDB Version 9.0x: This limitation is not relevant so the topology is reported as is.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
ETHERNET STATISTICS line |
Interface |
Name |
Hardware Address |
Interface |
Mac Address |
Device Type |
Interface |
Description |
ETHERNET STATISTICS line when Device Type value is EtherChannel |
Interface Aggregation |
Name |
ETHERNET STATISTICS line when Device Type value is Shared Ethernet Adapter |
IBM SEA |
Name |
Example: ioscli lsdev -dev 'ent16' -attr
attribute value description user_settable adapter_names ent0,ent4 EtherChannel Adapters True alt_addr 0x000000000000 Alternate EtherChannel Address True auto_recovery yes Enable automatic recovery after failover True backup_adapter NONE Adapter used when whole channel fails True hash_mode default Determines how outgoing adapter is chosen True mode standard EtherChannel mode of operation True netaddr 0 Address to ping True noloss_failover yes Enable lossless failover after ping failure True num_retries 3 Times to retry ping before failing True retry_time 1 Wait time (in seconds) between pings True use_alt_addr no Enable Alternate EtherChannel Address True use_jumbo_frame no Enable Gigabit Ethernet Jumbo Frames True
The adapter_names attribute value is used to create links to the back-up devices.
The value of Media Speed represents both Duplex and the connection Speed.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
media_speed |
Interface Index |
Speed |
SVEA Physloc ------ -------------------------------------------- ent4 U1000.E4A.06FB0D1-V1-C11-T1 SEA ent16 Backing device ent14 Status Available Physloc SVEA Physloc ------ -------------------------------------------- ent9 U1000.E4A.06FB0D1-V1-C16-T1 SEA ent21 Backing device ent12 Status Available Physloc U1000.001.DQD3693-P1-C7-T3
This command is used to determine the relation between the interfaces and to identify their types.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
SEA |
SEA Adapter |
Name |
Backing Device |
Link Aggregation / Interface |
Name |
SVEA |
Interface (virtual) |
Name |
fcs0:U1000.001.DQDE996-P1-C1-T1:4Gb FC PCI Express Adapter (df1000fe) fcs1:U1000.001.DQDE996-P1-C1-T2:4Gb FC PCI Express Adapter (df1000fe) fcs2:U1000.001.DQDE996-P1-C2-T1:4Gb FC PCI Express Adapter (df1000fe) fcs3:U1000.001.DQDE996-P1-C2-T2:4Gb FC PCI Express Adapter (df1000fe)
The output of this command represents the Fibre Channel Host Adapters on the VIO server. This output retrieves the FC Name and FC Physical Path, which are used to create a link to the I/O slot on the PFrame, and an FC Interface Description.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
First token |
Fibre Channel HBA |
Name |
Third token |
Fibre Channel HBA |
Description |
Output
proc0 Available Processor proc2 Available Processor proc4 Available Processor proc6 Available Processor
Mapping
The output of this command shows discovered CPU indices. In this case 0, 2, 4, and 6.
Output
2-WAY PROC CUOD : 2-WAY PROC CUOD : 2-WAY PROC CUOD : 2-WAY PROC CUOD :
Mapping
The output of this command shows the number of cores discovered. The "2" in the output indicates 2 CPU cores.
Output
attribute value description user_settable frequency 1654344000 Processor Speed False smt_enabled true Processor SMT enabled False smt_threads 2 Processor SMT threads False state enable Processor state False type PowerPC_POWER5 Processor type False
Mapping
CMD Output Attribute | CI Name | CI Attribute |
---|---|---|
frequency | CPU | speed |
type | CPU | model |
NAME PVID VG STATUS hdisk0 001fb2d15d794e0d rootvg active hdisk1 001fb2d18f1f7f0c clientvg active
This command retrieves the relation between the Physical Volume and the Volume Group, then a link is created from the Volume Group to the Physical Volume.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
VG |
Physical Volume |
Name |
VG |
Fibre Channel HBA |
Name |
VOLUME GROUP: rootvg VG IDENTIFIER: 001fb2d10005d9000000011a5d795185 VG STATE: active PP SIZE: 256 megabyte(s) VG PERMISSION: read/write TOTAL PPs: 520 (133120 megabytes) MAX LVs: 256 FREE PPs: 372 (95232 megabytes) LVs: 13 USED PPs: 148 (37888 megabytes) OPEN LVs: 11 QUORUM: 2 (Enabled) TOTAL PVs: 1 VG DESCRIPTORS: 2 STALE PVs: 0 STALE PPs: 0 ACTIVE PVs: 1 AUTO ON: yes MAX PPs per VG: 32512 MAX PPs per PV: 1016 MAX PVs: 32 LTG size (Dynamic): 256 kilobyte(s) AUTO SYNC: no HOT SPARE: no BB POLICY: relocatable
This command retrieves the values for the Volume Group CI attributes.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
VOLUME GROUP |
Volume Group |
Name |
STATE |
Volume Group |
Volume Group State |
VG IDENTIFIER |
Volume Group |
Volume Group ID |
rootvg: LV NAME TYPE LPs PPs PVs LV STATE MOUNT POINT hd5 boot 1 1 1 closed/syncd N/A hd6 paging 2 2 1 open/syncd N/A paging00 paging 4 4 1 open/syncd N/A hd8 jfs2log 1 1 1 open/syncd N/A hd4 jfs2 1 1 1 open/syncd / hd2 jfs2 10 10 1 open/syncd /usr hd9var jfs2 3 3 1 open/syncd /var hd3 jfs2 10 10 1 open/syncd /tmp hd1 jfs2 40 40 1 open/syncd /home hd10opt jfs2 4 4 1 open/syncd /opt lg_dumplv sysdump 4 4 1 open/syncd N/A VMLib_LV jfs2 56 56 1 open/syncd /var/vio/VMLib Ilv jfs2 12 12 1 closed/syncd /export/lbm
This command retrieves the list of all Logical Volumes that are part of the particular Volume Group, as well as the mount points if any exist. This information enables the creation of a link from the Volume Group to the Logical Volume.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
LV Name |
Logical Volume |
Name |
Mount Point |
Disk (FS) |
Name |
Type |
Disk |
Type |
LOGICAL VOLUME: lv1 VOLUME GROUP: clientvg LV IDENTIFIER: 000fb1d10230d9000000011b8f1f8187.1 PERMISSION: read/write VG STATE: active/complete LV STATE: opened/syncd TYPE: jfs WRITE VERIFY: off MAX LPs: 32512 PP SIZE: 512 megabyte(s) COPIES: 1 SCHED POLICY: parallel LPs: 70 PPs: 70 STALE PPs: 0 BB POLICY: non-relocatable INTER-POLICY: minimum RELOCATABLE: yes INTRA-POLICY: middle UPPER BOUND: 1024 MOUNT POINT: N/A LABEL: None MIRROR WRITE CONSISTENCY: on/ACTIVE EACH LP COPY ON A SEPARATE PV ?: yes Serialize IO ?: NO DEVICESUBTYPE : DS_LVZ
This command retrieves information about the Logical Volume parameters, which are mapped to the attributes of the Logical Volume CI.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
LOGICAL VOLUME |
Logical Volume |
Name |
LV IDENTIFIER |
Logical Volume |
Logical Volume ID |
LV STATE |
Logical Volume |
Logical Volume Status |
Type |
Logical Volume |
Logical Volume File System Type |
SVSA Physloc Client Partition ID --------------- -------------------------------------------- ------------------ vhost0 U1000.E4A.06FB0D1-V1-C21 0x00000002 VTD vtopt0 Status Available LUN 0x8100000000000000 Backing device /var/vio/VMLib/bootcd_rh5 Physloc SVSA Physloc Client Partition ID --------------- -------------------------------------------- ------------------ vhost3 U1000.E4A.06FB0D1-V1-C31 0x00000002 VTD vtscsi0 Status Available LUN 0x8100000000000000 Backing device os_ lv1 Physloc VTD vtscsi1 Status Available LUN 0x8200000000000000 Backing device p01_lv1 Physloc VTD vtscsi8 Status Available LUN 0x8300000000000000 Backing device p01_lv2 Physloc
This command retrieves the relation from the vSCSI to the exact backing device, which is usually a Volume or a Volume Group.
CMD Output Attribute |
CI Name |
CI Attribute |
---|---|---|
SVSA |
SCSI |
Name |
C<Number> |
SCSI |
Slot Number |
Backing Device |
LV/PV/FS |
Name |