HMC Manual Reference Pages  - MKSYSCFG (1)

NAME
mksyscfg - create system resources

CONTENTS

Synopsis
Description
Usage In A Powervm Management Master Mode Environment
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS
mksyscfg -r {lpar | prof | sysprof} -m managed-system
[{-f configuration-file | -i "configuration-data"}]
[-o save {-p partition-name | --id partition-ID}
-n profile-name [--force]]
[--help]

DESCRIPTION
mksyscfg creates partitions, partition profiles, or system profiles for the managed-system.

mksyscfg can also be used to save the current configuration of a partition to a partition profile.

USAGE IN A POWERVM MANAGEMENT MASTER MODE ENVIRONMENT
When the managed-system is in PowerVM management master mode, the mksyscfg -r lpar command may be used to create a partition, however the following attributes are not allowed: profile_name and sync_curr_profile. The partition will be configured immediately with the specified attributes. The Hardware Management Console (HMC) must be the current PowerVM management master for the managed-system when running the mksyscfg -r lpar command.

The mksyscfg -r prof and mksyscfg -r sysprof commands are not allowed.

OPTIONS
-r The type of system resources to create. Valid values are lpar for partitions, prof for partition profiles, and sysprof for system profiles.

When a partition is created, the default profile for the partition is also created.

-m The name of the managed system for which the system resources are to be created. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name.
-f 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
[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

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.
[bsr_arrays]
[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]
[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 HEA or SR-IOV
logical port, or virtual slot number
[console_slot]
IBM i only
DRC index of I/O slot, DRC index of HEA or 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
[hsl_pool_id]
IBM i only
Valid values are:
0 - HSL OptiConnect is disabled
1 - HSL OptiConnect is enabled
[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]]

The first 5 ’/’ characters must be present. The
6th ’/’ character is optional, but it must be
present if failover-priority is specified.

Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, and failover-priority.

Specify capacity as a percentage with up to 2
decimal places.

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 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. All the other virtual
NIC properties are configured with default values.
[hca_adapters]
AIX, Linux, and virtual I/O server only
Comma separated list of Host Channel
adapters (HCA), with each adapter having
the following format:

adapter-ID/GUID/capability

All 3 values must be specified for each
adapter.

Valid values for capability:
1 - low
2 - medium
3 - high
4 - dedicated

For example:
23000cff/2550000000609/3 specifies
an HCA with an adapter ID of 23000cff,
a Globally Unique ID (GUID) of
2:55:00:00:00:06:09, and a capability
setting of high.
[lhea_logical_ports]
Comma separated list of Logical Host Ethernet adapter
(LHEA) logical ports, with each logical port having
the following format:

adapter-ID/port-group/physical-port-ID/
logical-port-ID/[allowed-VLAN-IDs][/
allowed-OS-MAC-addresses]

The first 4 ’/’ characters must be present. The
last ’/’ character is optional, but it must be
present if allowed-OS-MAC-addresses is specified.
Optional values may be omitted. Optional values are
allowed-VLAN-IDs and allowed-OS-MAC-addresses.

If values are specified for allowed-VLAN-IDs, they
must be comma separated, or one of the following
values can be specified:
all - allowed to participate in all VLANs
none - not allowed to participate in any VLAN
(default value)

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

For example:
23000000/2/0/1/3 specifies logical port 1 for
physical port 0 belonging to port group 2 of the
Host Ethernet adapter (HEA) with an adapter ID of
23000000. This logical port is allowed to
participate in the VLAN with an ID of 3 only.
It also allows all OS defined MAC addresses.

23000000/2/1/5/all/fecd537a910b,fecd537a910c
specifies logical port 5 for physical port 1
belonging to port group 2 of the HEA with an adapter
ID of 23000000. This logical port is allowed to
participate in all VLANs, and it allows the OS defined
MAC addresses FE:CD:53:7A:91:0B and FE:CD:53:7A:91:0C.
[lhea_capabilities]
Comma separated list of LHEA
capabilities, with each capability
having one of the following formats:

adapter-ID/capability

or

adapter-ID/5/ieq/nieq/qp/cq/mr

where ieq (interruptible event queues),
nieq (non-interruptible event queues),
qp (queue pairs), cq (completion
queues), and mr (memory regions) each
specify the resource amount in addition
to the base minimum.

Valid values for capability:
0 - base minimum
1 - low
2 - medium
3 - high
4 - dedicated

For example:
23000000/3 sets the LHEA
capability for the HEA with an adapter ID
of 23000000 to high.
[sni_device_ids]
AIX, Linux, and virtual I/O server only
Comma separated list of Switch Network
Interface (SNI) adapter device IDs
[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
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 the
value of min_eth_capacity_granularity, the
maximum 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 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.

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.

-i This option allows you to enter configuration data on the command line, instead of using a file. Data entered on the command line must follow the same format as data in a file, and must be enclosed in double quotes.

When this option is used, only a single system resource can be created.

The -i and the -f options are mutually exclusive.

Configuration data is required to be specified with this option or the -f 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.

-o The operation to perform. The only valid value is save to save the current configuration of a partition to a partition profile.

If this option is not specified, then new system resources will be created using the configuration data specified with the -f or -i option.

-p The name of the partition whose current configuration is to be saved to a partition profile.

You can either use this option to specify the name of the partition whose current configuration is to be saved, or use the --id option to specify the partition’s ID. The -p and the --id options are mutually exclusive.

A partition is required to be specified with this option or the --id option when -o save is specified to save the current configuration of a partition to a partition profile. This option is not valid otherwise.

--id The ID of the partition whose current configuration is to be saved to a partition profile.

You can either use this option to specify the ID of the partition whose current configuration is to be saved, or use the -p option to specify the partition’s name. The --id and the -p options are mutually exclusive.

A partition is required to be specified with this option or the -p option when -o save is specified to save the current configuration of a partition to a partition profile. This option is not valid otherwise.

-n The name of the partition profile to which to save the partition configuration. If profile-name is the name of an existing partition profile, this command will fail unless the --force option is specified.

This option is required when -o save is specified to save the current configuration of a partition to a partition profile. This option is not valid otherwise.

--force When saving the current configuration of a partition to a partition profile, specify this option to overwrite an existing partition profile. Full system profiles cannot be overwritten.

This option is only valid when -o save is specified to save the current configuration of a partition to a partition profile.

--help Display the help text for this command and exit.

EXAMPLES
Create an AIX or Linux partition:

mksyscfg -r lpar -m system1 -i "name=aix_lpar2,
profile_name=prof1,lpar_env=aixlinux,min_mem=256,
desired_mem=1024,max_mem=1024,proc_mode=ded,
min_procs=1,desired_procs=1,max_procs=2,
sharing_mode=share_idle_procs,auto_start=1,
boot_mode=norm,lpar_io_pool_ids=3,
"io_slots=21010003/3/1,21030003//0""

Create an IBM i partition profile:

mksyscfg -r prof -m 9406-570*34134441 -i "name=prof2,
lpar_id=3,min_mem=512,desired_mem=512,max_mem=1024,
proc_mode=shared,min_procs=1,desired_procs=1,max_procs=2,
min_proc_units=0.1,desired_proc_units=0.5,max_proc_units=1.5,
sharing_mode=uncap,uncap_weight=128,auto_start=1,
"lpar_io_pool_ids=1,2",
"io_slots=2101001B/1/1,2103001B/2/1,2105001B//0",
load_source_slot=2101001B,console_slot=hmc,
max_virtual_slots=14,
"virtual_scsi_adapters=12/client/2//13/1,13/server////1""

Create partition profiles using the configuration data in the file /tmp/profcfg:

mksyscfg -r prof -m system1 -f /tmp/profcfg

Create a new partition profile by saving the current configuration of a partition:

mksyscfg -r prof -m system1 -o save -p p1 -n newProfile

Create a system profile:

mksyscfg -r sysprof -m system1 -i "name=sysprof1,
"lpar_names=lpar1,lpar2","profile_names=prof1,prof1""

Save the current configuration of a partition to an existing profile:

mksyscfg -r prof -m system1 -o save -p aix1 -n activeProfile --force

ENVIRONMENT
None

BUGS
None

AUTHOR
IBM Austin

SEE ALSO
chsyscfg, lssyscfg, rmsyscfg

Linux MKSYSCFG (1) "November 2016"
Generated by manServer 1.07 from mksyscfg.1 using man macros.