|
The name of the file containing the configuration data needed to create the system resources. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. These attribute name/value pairs form a configuration record. A line feed marks the end of a configuration record. The file must contain one configuration record for each resource to be created, and each configuration record must be for the same resource type.
The format of a configuration record is as follows:
attribute-name=value,attribute-name=value,...<LF>
Note that certain attributes accept a comma separated list of values, as follows:
attribute-name=value,value,... ,...<LF>
When a list of values is specified, the attribute name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a ’#146; character.
Attribute names for partitions (see below for attribute names that are common to both partitions and partition profiles):
name
name of the partition to create
[lpar_id]
profile_name
name of the default profile to create
lpar_env
Valid values are aixlinux, os400, or
vioserver
[allow_perf_collection]
Valid values are:
0 - do not allow
1 - allow
This attribute replaces the
shared_proc_pool_util_auth attribute.
Setting this attribute also sets the
shared_proc_pool_util_auth attribute
to the same value.
[shared_proc_pool_util_auth]
Valid values are:
0 - do not allow authority
1 - allow authority
This attribute has been deprecated. Use
the allow_perf_collection attribute
instead. Setting this attribute also
sets the allow_perf_collection
attribute to the same value.
[lpar_avail_priority]
Valid values are 0 - 255.
[msp]
Virtual I/O server only
Valid values are:
0 - the partition is not a mover service
partition
1 - the partition is a mover service
partition
[time_ref]
Valid values are:
0 - the partition is not a time reference
partition
1 - the partition is a time reference
partition
[suspend_capable]
AIX, Linux, and IBM i only
Valid values are:
0 - the partition cannot be suspended
1 - the partition can be suspended
[simplified_remote_restart_capable]
AIX, Linux, and IBM i only
Valid values are:
0 - remote restart without using a reserved storage
device cannot be performed for the partition
1 - remote restart without using a reserved storage
device can be performed for the partition
[remote_restart_capable]
AIX, Linux, and IBM i only
Valid values are:
0 - remote restart using a reserved storage device
cannot be performed for the partition
1 - remote restart using a reserved storage device
can be performed for the partition
[primary_rs_vios_name | primary_rs_vios_id]
Remote restart capable partitions only
[secondary_rs_vios_name | secondary_rs_vios_id]
Remote restart capable partitions only
To set no secondary reserved storage VIOS specify
none for secondary_rs_vios_id
[rs_device_name]
Remote restart capable partitions only
Name of the device on the primary reserved storage
VIOS partition
[vtpm_enabled]
AIX, Linux, and VIOS only
Valid values are:
0 - virtual Trusted Platform Module (vTPM) is not
enabled for this partition
1 - vTPM is enabled for this partition
[vtpm_version]
AIX, Linux, and VIOS only
The valid values for the managed-system are
displayed by the lssyscfg -r sys -m managed-system
-F supported_vtpm_versions command.
[vtpm_encryption]
AIX, Linux, and VIOS only
The valid values for the managed-system are
displayed by the lssyscfg -r sys -m managed-system
-F supported_vtpm_encryptions command.
[os400_restricted_io_mode]
IBM i only
Valid values are:
0 - disable IBM i restricted I/O mode
1 - enable IBM i restricted I/O mode
[sync_curr_profile]
Specifies whether this partition’s current
configuration is to be synchronized with its
current active profile. Valid values are:
0 - disable synchronization
1 - enable synchronization
2 - suspend synchronization until the next
time a profile is activated or applied
[hardware_mem_encryption]
Valid values are:
0 - disable hardware-accelerated encryption
1 - enable hardware-accelerated encryption
[hardware_mem_expansion]
Valid values are:
0 - disable hardware-accelerated Active Memory
Expansion
1 - enable hardware-accelerated Active Memory
Expansion
[powervm_mgmt_capable]
Linux only
Valid values are:
0 - do not allow this partition to provide
PowerVM management functions
1 - enable this partition to provide PowerVM
management functions
[migration_disabled]
AIX, Linux, and IBM i only
Valid values are:
0 - do not disable partition migration for this
partition
1 - disable partition migration for this
partition
[secure_boot]
AIX, Linux, and VIOS only
Valid values are:
0 - disable secure boot for this partition
1 - enable secure boot in log only mode for
this partition
2 - enable secure boot for this partition
3 - 9 - advanced settings, consult your operating
system documentation
[virtual_serial_num]
AIX, Linux, and IBM i only
Virtual serial number, or one of the following values:
auto - automatically assign a virtual serial number
none - no virtual serial number (default value)
[keystore_kbytes]
kilobytes
[description]
[keystore_signed_updates]
Valid values are:
0 - disable
1 - enable
[linux_dynamic_key_secure_boot]
Linux only
Valid values are:
0 - disable
1 - enable
[kvm_capable]
Linux only
Valid values are:
0 - do not enable Kernel-based Virtual Machine (KVM)
to be run on this partition
1 - enable KVM to be run on this partition
Attribute names for partition profiles (see below for attribute names that are common to both partition profiles and partitions):
name
name of the partition profile to create
lpar_name | lpar_id
name or ID of the partition for which
to create the profile
Attribute names for both partitions and partition profiles:
[all_resources]
Valid values are:
0 - do not use all the managed system
resources
1 - use all the managed system resources
(this option is not valid for IBM i
partitions on IBM System p5 or
eServer p5 servers)
min_mem
megabytes
desired_mem
megabytes
max_mem
megabytes
[min_num_huge_pages]
AIX and Linux only
[desired_num_huge_pages]
AIX and Linux only
[max_num_huge_pages]
AIX and Linux only
[mem_mode]
Valid values are:
ded - dedicated memory
shared - shared memory
[desired_io_entitled_mem]
Specify the number of megabytes or specify auto for
automatic I/O entitled memory management mode
[mem_weight]
[primary_paging_vios_name | primary_paging_vios_id]
[secondary_paging_vios_name | secondary_paging_vios_id]
To set no secondary paging VIOS specify none for
secondary_paging_vios_id
[mem_expansion]
Valid values are:
0 - disable Active Memory Expansion
1.00-10.00 - expansion factor
[hpt_ratio]
Ratio of hardware page table size to the maximum
memory for the partition. Valid values are displayed
by the lshwres -r mem -m managed-system
--level sys -F possible_hpt_ratios command.
[ppt_ratio]
Ratio of physical page table size to the maximum
memory for the partition. Valid values are displayed
by the lshwres -r mem -m managed-system
--level sys -F possible_ppt_ratios command.
[proc_mode]
Valid values are:
ded - dedicated processors
shared - shared processors
[min_procs]
[desired_procs]
[max_procs]
[min_proc_units]
[desired_proc_units]
[max_proc_units]
[sharing_mode]
Valid values for partitions using
dedicated processors are:
keep_idle_procs - never share
processors
share_idle_procs - share processors only
when partition is inactive
share_idle_procs_active - share
processors only when partition
is active
share_idle_procs_always - always share
processors
Valid values for partitions using shared
processors are:
cap - capped
uncap - uncapped
[uncap_weight]
Default value is 128
[shared_proc_pool_name | shared_proc_pool_id]
[affinity_group_id]
Memory and processor affinity group in which the
partition will participate. Valid values are
none and 1 - 255.
[io_slots]
Comma separated list of I/O slots, with
each I/O slot having the following
format:
slot-DRC-index/[slot-IO-pool-ID]/
is-required
Both ’/’ characters must be present, but
optional values may be omitted. Optional
values are slot-IO-pool-ID.
Valid values for is-required:
0 - no
1 - yes
For example:
21030002/3/1 specifies an I/O slot with a
DRC index of 21030002, it is assigned to
I/O pool 3, and it is a required slot.
[lpar_io_pool_ids]
comma separated
[load_source_slot]
IBM i only
DRC index of I/O slot, DRC index of SR-IOV logical
port, or virtual slot number
[alt_restart_device_slot]
IBM i only
DRC index of I/O slot, DRC index of SR-IOV logical
port, or virtual slot number
[console_slot]
IBM i only
DRC index of I/O slot, DRC index of SR-IOV logical
port, virtual slot number, or the value hmc
[alt_console_slot]
IBM i only
DRC index of I/O slot
[op_console_slot]
IBM i only
DRC index of I/O slot
[auto_start]
Valid values are:
0 - off
1 - on
[boot_mode]
AIX, Linux, and virtual I/O server only
Valid values are:
norm - normal
dd - diagnostic with default boot list
ds - diagnostic with stored boot list
of - Open Firmware OK prompt
sms - System Management Services
[power_ctrl_lpar_ids | power_ctrl_lpar_names]
comma separated
[conn_monitoring]
Valid values are:
0 - off
1 - on
[virtual_opti_pool_id]
IBM i only
Valid values are:
0 - virtual OptiConnect is disabled
1 - virtual OptiConnect is enabled
[max_virtual_slots]
[virtual_eth_adapters]
Comma separated list of virtual ethernet adapters,
with each adapter having the following format:
virtual-slot-number/is-IEEE/port-vlan-ID/
[additional-vlan-IDs]/[trunk-priority]/
is-required[/[virtual-switch][/[MAC-address]/
[allowed-OS-MAC-addresses]/[QoS-priority]]]
The first 5 ’/’ characters must be present. The 6th
’/’ character is optional, but it must be present if
virtual-switch or any of the values following
virtual-switch are specified. The last 3 ’/’
characters are optional, but all 3 must be present if
MAC-address, allowed-OS-MAC-addresses, or QoS-priority
is specified.
Optional values may be omitted. Optional values are
additional-vlan-IDs, trunk-priority, virtual-switch,
MAC-address, allowed-OS-MAC-addresses, and
QoS-priority.
Valid values for is-IEEE and is-required:
0 - no
1 - yes
If values are specified for additional-vlan-IDs, they
must be comma separated.
Valid values for trunk-priority:
0 - this adapter is not a trunk adapter (default
value)
1 - 15 - this adapter is a trunk adapter with the
specified priority
If MAC-address is not specified, a unique MAC address
will be automatically generated for the adapter. If
it is specified, it must be specified as 12
hexadecimal characters. It is highly recommended that
you do not specify MAC-address so that the MAC address
will be automatically generated.
allowed-OS-MAC-addresses can be a comma separated list
of 1 to 4 MAC addresses, where each MAC address is
specified as 12 hexadecimal characters, or it can be
one of the following values:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
Valid values for QoS-priority:
none - do not use Quality of Service (QoS) (default
value)
0 - 7 - the QoS priority level to use
For example:
13/1/5/6,7/2/1
specifies a virtual ethernet adapter with a virtual
slot number of 13, it is IEEE 802.1Q compatible, it
has a port virtual LAN ID of 5, additional virtual LAN
IDs of 6 and 7, it is a trunk adapter with a trunk
priority of 2, and it is required. It also
uses the default virtual switch, it uses an
automatically generated MAC address, it allows all OS
defined MAC addresses, and it does not use QoS.
4/1/3//0/1///fecd537a910b,fecd537a910c/2
specifies a virtual ethernet adapter with a virtual
slot number of 4, it is IEEE 802.1Q compatible, it
has a port virtual LAN ID of 3, no additional virtual
LAN IDs, it is not a trunk adapter, it is required, it
uses the default virtual switch, it uses an
automatically generated MAC address, it allows the OS
defined MAC addresses FE:CD:53:7A:91:0B and
FE:CD:53:7A:91:0C, and it uses a QoS priority level
of 2.
[virtual_eth_vsi_profiles]
Comma separated list of virtual ethernet adapter
Virtual Station Interface (VSI) profile attributes:
virtual-slot-number/VSI-manager-ID/VSI-type-ID/
VSI-type-version
All 3 ’/’ characters must be present, and all values
are required.
For example:
15/2/1193040/1
specifies a VSI profile for the virtual ethernet
adapter in slot 15. The VSI profile has a VSI
manager ID of 2, a VSI type ID of 1193040, and a
VSI type version of 1.
[virtual_fc_adapters]
Comma separated list of virtual fibre channel
adapters, with each adapter having the following
format:
virtual-slot-number/client-or-server/
[remote-lpar-ID]/[remote-lpar-name]/
remote-slot-number/[wwpns]/is-required
All 6 ’/’ characters must be present, but optional
values may be omitted. Optional values are
remote-lpar-ID or remote-lpar-name (one of those
values is required, but not both).
wwpns is optional for a client adapter, and is not
allowed for a server adapter. If wwpns is not
specified, WWPNs will be automatically generated for a
client adapter. It is highly recommended that you do
not specify wwpns so that WWPNs will be automatically
generated.
Valid values for client-or-server:
client
server
Valid values for is-required:
0 - no
1 - yes
For example:
4/client//vios_p1/16//1
specifies a virtual fibre channel client adapter
with a virtual slot number of 4, a remote (server)
partition name of vios_p1, a remote (server) slot
number of 16, and it is required. WWPNs will be
automatically generated for this client adapter.
[virtual_scsi_adapters]
Comma separated list of virtual SCSI
adapters, with each adapter having the
following format:
virtual-slot-number/client-or-server/
[remote-lpar-ID]/[remote-lpar-name]/
[remote-slot-number]/is-required
All 5 ’/’ characters must be present, but
optional values may be omitted. Optional
values for server adapters are
remote-lpar-ID, remote-lpar-name,
and remote-slot-number. Optional values
for client adapters are remote-lpar-ID or
remote-lpar-name (one of those values
is required, but not both).
Valid values for client-or-server:
client
server
Valid values for is-required:
0 - no
1 - yes
For example:
14/client/2//13/0
specifies a virtual SCSI client adapter
with a virtual slot number of 14, a
remote (server) partition ID of 2, a
remote (server) slot number of 13, and
it is not required.
[virtual_serial_adapters]
Comma separated list of virtual serial
adapters, with each adapter having the
following format:
virtual-slot-number/client-or-server/
[supports-HMC]/[remote-lpar-ID]/
[remote-lpar-name]/[remote-slot-number]/
is-required
All 6 ’/’ characters must be present, but
optional values may be omitted. Optional
values for server adapters are
supports-HMC, remote-lpar-ID,
remote-lpar-name, and remote-slot-number.
Optional values for client adapters are
remote-lpar-ID or remote-lpar-name (one
of those values is required, but not
both), and the supports-HMC value is
not allowed.
Valid values for client-or-server:
client
server
Valid values for supports-HMC:
0 - no
Valid values for is-required:
0 - no
1 - yes
For example:
14/server/0////0
specifies a virtual serial server adapter
with a virtual slot number of 14, it does
not support an HMC connection, any client
adapter is allowed to connect to it, and
it is not required.
[vnic_adapters]
AIX, Linux, and IBM i only
Comma separated list of virtual NICs, with each
virtual NIC consisting of a list of colon separated
property name/value pairs, which can be specified
in any order:
property-name=value:property-name=value:...
Property names:
slot_num
Required
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag
insertions for untagged frames (default value)
pvid_priority
Valid values:
An integer between 0 and 7, inclusive.
Default value is 0.
allowed_vlan_ids
Comma separated list of VLAN IDs, or one of the
following values:
all - all VLAN IDs are allowed (default value)
none - no VLAN IDs are allowed
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated for the virtual NIC.
It is highly recommended that you use an
automatically generated MAC address.
allowed_os_mac_addrs
Comma separated list of MAC addresses, each
specified as 12 hexadecimal characters. Other
valid values:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
is_required
Valid values:
0 - no
1 - yes (default value)
auto_priority_failover
Valid values:
0 - automatic priority failover is disabled
1 - automatic priority failover is enabled
(default value)
backing_devices
Required
Comma separated list of virtual NIC backing
devices, with each backing device having the
following format:
sriov/vios-lpar-name/vios-lpar-ID/
sriov-adapter-ID/sriov-physical-port-ID/
[capacity][/[failover-priority][/
[max-capacity]]]
The first 5 ’/’ characters must be present. The
6th ’/’ character is optional, but it must be
present if failover-priority or max-capacity
is specified. The 7th ’/’ character is optional,
but it must be present if max-capacity is
specified.
Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, failover-priority, and
max-capacity.
Specify capacity and max-capacity each as
a percentage with up to 2 decimal places.
max-capacity defaults to 100 if not specified.
Specify failover-priority as a value between 1
and 100 inclusive, with 1 being the highest
priority. It defaults to 50 if not specified.
For example:
slot_num=5:backing_devices=sriov/vios1//1/0//1,
sriov/vios2//2/0//10/50 specifies a virtual NIC with
a virtual slot number of 5 and 2 backing devices.
The first backing device is on VIOS vios1 and
physical port 0 of SR-IOV adapter 1 and has a failover
priority of 1. The second backing device is on VIOS
vios2 and physical port 0 of SR-IOV adapter 2 and
has a failover priority of 10 and a maximum capacity
of 50%. All the other virtual NIC properties are
configured with default values.
[work_group_id]
Specify none if you are not using
Enterprise Workload Manager (EWLM)
[redundant_err_path_reporting]
Valid values are:
0 - disable
1 - enable
[electronic_err_reporting]
IBM i only
Valid values are:
0 - disable
1 - enable
[lpar_proc_compat_mode]
The valid values for the managed-system are
displayed by the lssyscfg -r sys -m managed-system
-F lpar_proc_compat_modes command.
[sriov_eth_logical_ports]
Comma separated list of SR-IOV ethernet logical ports,
with each logical port consisting of a list of colon
separated property name/value pairs, which can be
specified in any order:
property-name=value:property-name=value:...
Property names:
adapter_id
Required
phys_port_id
Required
allowed_os_mac_addrs
Comma separated list of MAC addresses, each
specified as 12 hexadecimal characters. Other
valid values:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
allowed_priorities
Comma separated list of integers between 0 and
7, inclusive, or one of the following values:
all - all supported priorities are allowed
none - no priorities are allowed (default value)
allowed_vlan_ids
Comma separated list of VLAN IDs, or one of the
following values:
all - all VLAN IDs are allowed (default value)
none - no VLAN IDs are allowed
capacity
A percentage with up to 2 decimal places. Must
be a multiple of min_eth_capacity_granularity
of the physical port, which is displayed by the
lshwres -m managed-system -r sriov
--rsubtype physport --level {eth | ethc}
-F min_eth_capacity_granularity command.
The minimum value and the default value is
min_eth_capacity_granularity. The maximum
value is 100.
max_capacity
A percentage with up to 2 decimal places. The
minimum value is capacity. The maximum value
and the default value is 100.
config_id
If not specified, the management console will
assign the next available value.
diag_mode
Valid values:
0 - disable (default value)
1 - enable
Warning! If diagnostics mode is enabled, no other
logical port may be attached to the physical
port. If logical ports are already in use on the
physical port, you will have to power off
partitions or use Dynamic Logical Partitioning
(DLPAR) to remove the logical ports that are
attached to the physical port.
huge_dma_window_mode
Valid values:
0 - disable (default value)
1 - enable
logical_port_id
DRC index of an SR-IOV logical port. If not
specified, an SR-IOV logical port will be
automatically assigned.
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated for the logical port.
It is highly recommended that you use an
automatically generated MAC address.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag
insertions for untagged frames (default value)
promisc_mode
Valid values:
0 - disable (default value)
1 - enable
pvid_priority
Valid values:
An integer between 0 and 7, inclusive.
Default value is 0.
migratable
Valid values:
0 - this logical port cannot be migrated
(default value)
1 - this logical port can be migrated
backup_device_type
Backup device type for a migratable logical port
Valid values:
vnic - virtual NIC (default)
veth - virtual ethernet
backup_device_slot_num
Defaults to the next available virtual slot
number
backup_vnic_backing_device
Specify the following format:
sriov/vios-lpar-name/vios-lpar-ID/
sriov-adapter-ID/sriov-physical-port-ID/
[capacity][/[/[max-capacity]]]
The first 5 ’/’ characters must be present. The
6th and 7th ’/’ characters are optional, but they
must be present if max-capacity is specified.
Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, and max-capacity.
Specify capacity and max-capacity each as
a percentage with up to 2 decimal places.
max-capacity defaults to 100 if not specified.
When the backup device type is virtual NIC, the
management console assigns a backing device if
this attribute is not specified. Note that the
management console can only assign a backing
device on an SR-IOV physical port that has the
same port label as the physical port for this
logical port.
backup_veth_vnetwork
Required when the backup device type is virtual
ethernet
For example:
adapter_id=1:phys_port_id=0 specifies that an
unconfigured SR-IOV logical port on physical port 0
of the SR-IOV adapter with the adapter ID of 1 will
be selected and configured with default ethernet
logical port values.
[sriov_roce_logical_ports]
Comma separated list of SR-IOV RDMA over Converged
Ethernet (RoCE) logical ports, with each logical port
consisting of a list of colon separated property
name/value pairs, which can be specified in any order:
property-name=value:property-name=value:...
Property names:
adapter_id
Required
phys_port_id
Required
allowed_os_mac_addrs
Comma separated list of MAC addresses, each
specified as 12 hexadecimal characters. Other
valid values:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
allowed_priorities
Comma separated list of integers between 0 and
7, inclusive, or one of the following values:
all - all supported priorities are allowed
none - no priorities are allowed (default value)
allowed_vlan_ids
Comma separated list of VLAN IDs, or one of the
following values:
all - all VLAN IDs are allowed (default value)
none - no VLAN IDs are allowed
capacity
A percentage with up to 2 decimal places. Must
be a multiple of min_roce_capacity_granularity
of the physical port, which is displayed by the
lshwres -m managed-system -r sriov
--rsubtype physport --level roce -F
min_roce_capacity_granularity command.
The minimum value and the default value is
min_roce_capacity_granularity. The maximum
value is 100.
max_capacity
A percentage with up to 2 decimal places. The
minimum value is capacity. The maximum value
and the default value is 100.
config_id
If not specified, the management console will
assign the next available value.
diag_mode
Valid values:
0 - disable (default value)
1 - enable
Warning! If diagnostics mode is enabled, no other
logical port may be attached to the physical
port. If logical ports are already in use on the
physical port, you will have to power off
partitions or use Dynamic Logical Partitioning
(DLPAR) to remove the logical ports that are
attached to the physical port.
huge_dma_window_mode
Valid values:
0 - disable (default value)
1 - enable
logical_port_id
DRC index of an SR-IOV logical port. If not
specified, an SR-IOV logical port will be
automatically assigned.
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated for the logical port.
It is highly recommended that you use an
automatically generated MAC address.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag
insertions for untagged frames (default value)
promisc_mode
Valid values:
0 - disable (default value)
1 - enable
pvid_priority
Valid values:
An integer between 0 and 7, inclusive.
Default value is 0.
For example:
adapter_id=1:phys_port_id=0:capacity=10 specifies that
an unconfigured SR-IOV logical port on physical port 0
of the SR-IOV adapter with the adapter ID of 1 will
be selected and configured with a capacity of 10% and
with default RoCE logical port values for the other
attributes.
[kvm_reserved_mem_percent]
Linux only
A percentage with up to 2 decimal places
Attribute names for system profiles:
name
name of the system profile to create
lpar_names | lpar_ids
comma separated
profile_names
comma separated
Brackets around an attribute name indicate that the attribute is optional.
The -f and the -i options are mutually exclusive.
Configuration data is required to be specified with this option or the -i option except when -o save is specified to save the current configuration of a partition to a partition profile. This option is not valid when -o save is specified.
|