La commande 'mksyscfg' permet d'effectuer un certain nombre d'opérations sur les chassis ou profils de partitions.
La première utilisation peut notamment consister à effectuer une sauvegarde de la configuration courante d'une LPAR dans un profile dont le nom est passé en argument.
Exemple :
#
| # mksyscfg -r prof -m CHASSI1 -o save -p MA_LPAR -n Profil121114 --force |
La documentation officielle est donnée ci-dessous en anglais.
MKSYSCFG(1) User Manuals MKSYSCFG(1)
NAME
mksyscfg - create system resources
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 parti-
tion to a partition profile.
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 parti-
tion 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 configu-
ration 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 pre-
ceded by an escape character, which is usually a '\' 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
[remote_restart_capable]
AIX, Linux, and IBM i only
Valid values are:
0 - remote restart cannot be performed for the
partition
1 - remote restart 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
Attribute names for partition profiles (see below for attribute
names that are common to both partition profiles and parti-
tions):
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]
[min_5250_cpw_percent]
Only valid for IBM i partitions in
managed systems that support the
assignment of 5250 CPW percentages
[desired_5250_cpw_percent]
Only valid for IBM i partitions in
managed systems that support the
assignment of 5250 CPW percentages
[max_5250_cpw_percent]
Only valid for IBM i partitions in
managed systems that support the
assignment of 5250 CPW percentages
[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, required on POWER5 servers
DRC index of I/O slot or virtual slot number
[alt_restart_device_slot]
IBM i only
DRC index of I/O slot, DRC index of HEA logical
port, or virtual slot number
console_slot
IBM i only
DRC index of I/O slot, DRC index of HEA 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.
[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 com-
mand 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 parti-
tion 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 con-
figuration 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 parti-
tion 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 configu-
ration 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 par-
tition 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 parti-
tion profile, specify this option to overwrite an existing par-
tition 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
