Information about settings in the IBM VGP XML file
This topic contains the following sections:
- Description of sections and settings
- To get the managed system ID - IBM
- To get the IBM shared processor pool name
- To get the DRC index
- To get the virtual switch name
- To get the port settings - PortGroup, PhysicalPortId, LogicalPortId
- To get the storage locations
- To get the VIOS paging partitions
Description of sections and settings
Section | Settings |
---|---|
<GeneralInfo> | <Name> and <Description> — Name and description of the Virtual Guest Package (VGP). |
<PartitionInfo> | This section is mandatory. It contains all partition information for the LPAR or VIO server |
<PartitionGeneralSettings> | This section is mandatory and represents general settings of the partition.
|
<ProcessorSettings> | <ProcessorMode> — Valid values are: |
<MemorySettings>> | <MemoryMode> — Set to either dedicated memory or shared memory, using the following values: |
<Storage> | FOR client LPARs: You can provide storage information in either of the following ways:
For VIOServer partitions — You can provide only SCSI/FC adapters. |
<PhysicalIO> | <SlotDRCIndex> — DRC Index of physical slot. For information on how to get this index, see To get the DRC index. |
<VirtualAdapters> | <MaxVirtualAdapters> — Maximum number of virtual adapters that can be assigned to the parition. Value can be a positive integer, for example: 10 |
<EthernetAdapter> | <AdapterId> — Positive integer, for example:3. Note the following restrictions: |
<FiberChannelAdapter> | <AdapterId> — Positive integer, for example:3. Note the following restrictions: |
<SCSIAdapter>> | <AdapterId> — Positive integer, for example:3. Note the following restrictions: |
<SerialAdapter> | <AdapterId> — Positive integer, for example:3. Note the following restrictions:
|
<LHEA> | <AdapterId> — Positive integer, for example: 23000000 |
To get the managed system ID - IBM
Some of the commands you use to get VGP values require you to pass in the ID of the Managed System.
To do this, use the listVirtualEntityManagers command, and pass in an EntityType of ManagedSystem:
Command | Virtualization listVirtualEntityManagers ManagedSystem |
Output format | ManagedSystemID::ManagedSystemName |
Output example | 1::MyManagedSystem |
In this example, the Managed System ID is 1.
To get the IBM shared processor pool name
- Get the Managed System ID, as described in To get the managed system ID - IBM. For the purpose of this example, assume the ID is 1.
Use the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the shared processor pool name. This command takes 2 arguments – ServerId and EntityType. You already have the ServerId (1). Because you want a shared processor pool name, you specify ManagedSystemSharedProcessorPool as EntityType:
Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 ManagedSystemSharedProcessorPoolOutput format
NameOutput example
Pool1 \\
Pool2 \\
Pool3Example: In the VGP file, you might specify:
<SharedPool>Pool3</SharedPool>
To get the DRC index
- Get the Managed System ID, as described in To get the managed system ID - IBM. For the purpose of this example, assume the ID is 1.
Use the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the shared processor pool name. This command takes 2 arguments – ServerId and EntityType. You already have the ServerId (1). Because you want a DRC index, you specify ManagedSystemPhysicalAdapters as EntityType:
Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 ManagedSystemPhysicalAdaptersOutput format
Slot::Description::DRC Index::Location Code::I/O Pool Id::Partition Name::Partition IdOutput example
C1::Empty slot::21010204::U789C.001.DQDJ634-P1-C1::none::::0
C2::4 Gigabit PCI Express Single Port Fibre Channel Adapter::21010205::U789C.001.DQDJ634-P1-C2::none::viosrdsaix03::1
C3::Empty slot::21010207::U789C.001.DQDJ634-P1-C3::none::::0
C4::Empty slot::21010202::U789C.001.DQDJ634-P1-C4::none::::0
C5::Empty slot::21010203::U789C.001.DQDJ634-P1-C5::none::::0
C9::Empty slot::21010206::U789C.001.DQDJ634-P1-C9::none::::0
T7::Universal Serial Bus UHC Spec::21010201::U789C.001.DQDJ634-P1-T7::none::Automation_pun-lpar-rds28::3
T9::RAID Controller::21010200::U789C.001.DQDJ634-P1-T9::1::viosrdsaix03::1The DRC index is the third field. For example, the DRC index for the RAID Controller in the sample output shown above is 21010200.
for example, in the VGP file you might specify the following:<SlotDRCIndex>21010200</SlotDRCIndex>
To get the virtual switch name
- Get the Managed System ID, as described in To get the managed system ID - IBM. For the purpose of this example, assume the ID is 1.
Use the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the virtual switch name. This command takes 2 arguments – ServerId and EntityType. You already have the ServerId (1). Because you want a virtual switch name, you specify ManagedSystemLPARVirtualEthernet as EntityType:
Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 ManagedSystemLPARVirtualEthernetOutput format
VIO Server::Name::Virtual Switch::VLAN ID::Additional VLAN IDs::StatusOutput example
Automation_VIO::Eth_11::ETHERNET0::1::::Unavailable
viosrdsaix03::Eth_11::ETHERNET0::1::::AvailableThe virtual switch is the third field. For example, in the sample output above, the virtual switch is ETHERNET0.
Forexample, in the VGP file you might specify the following:<VirtualSwitch>ETHERNET0</VirtualSwitch>
To get the port settings - PortGroup, PhysicalPortId, LogicalPortId
- Get the Managed System ID, as described in To get the managed system ID - IBM. For the purpose of this example, assume the ID is 1.
Use the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the port settings. This command takes 2 arguments – ServerId and EntityType. You already have the ServerId (1).
For EntityType, specify ManagedSystemHEALogicalPort.Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 ManagedSystemHEALogicalPortOutput format
Logical Port Id::Adapter Id::Port Group::Physical Port Id::VLAN Id List::Partition Id::Partition Name::StatusOutput example
1::23000000::1::0::all::1::viosrdsaix03::Available
10::23000000::1::0::none::none::::Unavailable
11::23000000::1::0::none::none::::UnavailablePortGroup: Third field
PhysicalPortId: Fourth field
LogicalPortId: First field
For example, in the VGP file you might specify the following:<PortGroup>1</PortGroup>
<PhysicalPortId>0</PhysicalPortId>
<LogicalPortId>1</LogicalPortId>
To get the storage locations
The <Storage> element requires you to provide <Location> values for the following elements:
- <VirtualDisk>
- <PhysicalVolume>
- <FiberChannelPort>
- Get the Managed System ID, as described in To get the managed system ID - IBM. For the purpose of this example, assume the ID is 1.
Use the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the location you want. This command takes 2 arguments – ServerId and EntityType. You already have the ServerId(1). Depending on which <Location> value you want, specify one of the following strings as EntityType:
<Location> value
String for EntityType
<VirtualDisk>ManagedSystemStoragePool
<PhysicalVolume>ManagedSystemAvailableDisks
<FiberChannelPort>ManagedSystemFiberChannelHBAPorts
This example continues with getting a <Location> value for <VirtualDisk>. You can use the same general procedure to get <Location> values for <PhysicalVolume> and <FiberChannelPort>.
Because you want a virtual disk storage location, you specify ManagedSystemStoragePool as EntityType:Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 ManagedSystemStoragePoolOutput format
VIO Server::Storage Location::Total Size(GB)::Available Size(GB)Output example
SSBVIO1::viosrdsaix03:client_vg::279.0::268.5
viosrdsaix03::viosrdsaix03:client_vg::279.0::268.5
SSBVIO1::viosrdsaix03:rootvg::279.0::233.5
viosrdsaix03::viosrdsaix03:rootvg::279.0::233.5
The <Location> field requires you to provide the contents of the Storage Location field, for example, viosrdsaix03:client_vg.
For example, n the VGP file, you might specify the following:<Location>viosrdsaix03:client_vg</Location>
To get the VIOS paging partitions
You can get the names of the primary and secondary VIOS paging partitions.
- Get the Managed System ID, as described in To get the managed system ID - IBM. For the purpose of this example, assume the ID is 1.
Ue the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the paging partitions. This command takes 2 arguments – ServerId and EntityType. You already have the ServerId (1). Because you want a paging partition, you specify ManagedSystemSharedMemoryPool as EntityType:
Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 ManagedSystemSharedMemoryPoolOutput format
Supported VIOServers::Maximum Pool Size(mb)::Pool Size(MB)::Available pool memory(MB)Output example
viosrdsaix03::1024::1024::634For example, in the VGP file you might specify the following:
<PrimaryPagingVIOS>viosrdsaix03</PrimaryPagingVIOS>