HMC Manual Reference Pages  - CHSYSCFG (1)

NAME
chsyscfg - change system resources

CONTENTS

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

SYNOPSIS
To change attributes:
chsyscfg -r {lpar | prof | sys | sysprof | frame}
{-m managed-system | -e managed-frame}
{-f configuration-file | -i "configuration-data"}
[--force]
[--help]

To change partition attributes by applying a partition profile:
chsyscfg -r lpar -m managed-system
-o apply {-p partition-name | --id partition-ID}
[-n profile-name]
[--help]

DESCRIPTION
chsyscfg changes the attributes of partitions, partition profiles, or system profiles for the managed-system. It can also change the attributes of the managed-system.

chsyscfg can also change the attributes of the managed-frame.

USAGE IN A POWERVM MANAGEMENT MASTER MODE ENVIRONMENT
When the managed-system is in PowerVM management master mode, both the chsyscfg -r lpar and the chsyscfg -r prof commands may be used to change the current configuration of a partition. The following attributes are not allowed with the chsyscfg -r lpar command: profile_name and sync_curr_profile. The following attributes are not allowed with the chsyscfg -r prof command: name and new_name. The partition will be configured immediately with the specified attributes.

When running chsyscfg -r lpar -o apply the -n option is not allowed. The last valid configuration partition profile will always be applied.

The Hardware Management Console (HMC) must be the current PowerVM management master for the managed-system when running the chsyscfg -r lpar and chsyscfg -r prof commands.

The chsyscfg -r sysprof command is not allowed.

OPTIONS
-r The type of resources to change. Valid values are lpar for partitions, prof for partition profiles, sys for the managed system, sysprof for system profiles, and frame for the managed frame.
-m The name of either the managed system to be changed, or the managed system which has the system resources to be changed. 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.

This option is required when changing the attributes of partitions, partition profiles, system profiles, or the managed system. This option is not valid otherwise.

-e The name of the managed frame to be changed. The name may either be the user-defined name for the managed frame, or be in the form tttt-mmm*ssssssss, where tttt is the type, mmm is the model, and ssssssss is the serial number of the managed frame. The tttt-mmm*ssssssss form must be used if there are multiple managed frames with the same user-defined name.

This option is required when changing the attributes of the managed frame. This option is not valid otherwise.

-f The name of the file containing the configuration data needed to change the 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 changed, and each configuration record must be for the same resource type. If the resource type is the managed system or the managed frame, then the file must contain only one configuration record.

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.

If ’+=’ is used in the attribute name/value pair instead of ’=’, then the specified value is added to the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is added to the existing list.

If ’-=’ is used in the attribute name/value pair instead of ’=’, then the specified value is subtracted from the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is deleted from the existing list.

Attribute names for partitions:
name | lpar_id
name or ID of the partition to
change (required)
new_name
default_profile
ipl_source
IBM i only
Valid values are a, b, c, or d
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.
work_group_id
Specify none if you are not using
Enterprise Workload Manager (EWLM)
lpar_avail_priority
Valid values are 0 - 255.
electronic_err_reporting
IBM i only
Valid values are:
0 - disable
1 - enable
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
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
boot_string
AIX, Linux, and VIOS only

Attribute names for partition profiles:
name
name of the partition profile to
change (required)
lpar_name | lpar_id
name or ID of the partition for
which the profile to change is
defined (required)
new_name
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:
21010003/3/1 specifies an I/O slot with a
DRC index of 21010003, 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, unless you are changing an existing virtual
fibre channel adapter and you want to retain its
existing WWPNs. If you do specify wwpns, you must
specify exactly two WWPNs, and they must be comma
separated.

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 when using the = or += operator
phys_port_id
Required when using the = or += operator
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.
Required when using the -= operator
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 a managed system:
new_name
power_off_policy
Valid values are:
0 - power off after all partitions are
shut down
1 - do not power off after all partitions
are shut down
service_lpar_id
Specify none to remove the service
partition assignment
service_lpar_name
power_on_lpar_start_policy
Valid values are autostart, userinit, or autorecovery.
This attribute replaces the power_on_option attribute.
Setting this attribute also sets the power_on_option
attribute to the equivalent value.
power_on_option
Valid values are autostart or standby.
This attribute has been deprecated. Use the
power_on_lpar_start_policy attribute instead. Setting
this attribute also sets the
power_on_lpar_start_policy attribute to the equivalent
value.
power_on_side
Valid values are perm or temp
power_on_speed
Valid values are slow or fast.

This attribute can be set for POWER6 and
POWER7 (firmware level 710 only) servers only.
power_on_speed_override
Valid values are none, slow, or fast.

This attribute can be set for POWER6 and
POWER7 (firmware level 710 only) servers only.
sp_failover_enabled
Valid values are:
0 - disable service processor failover
1 - enable service processor failover
addr_broadcast_perf_policy
Valid values are:
chip_affinity
no_affinity
node_affinity
max_lpars_per_hca
The managed system must be restarted for
this change to take effect.
hca_bandwidth_capabilities
Host Channel adapter (HCA) bandwidth capability
settings. Specify high/medium/low, where high, medium,
and low are each expressed as a percentage of the
total bandwidth, or specify default to set all 3
settings to their default values.

If high/medium/low is specified, both ’/’ characters
must be present, but any setting may be omitted. A
setting that is omitted is not changed.

The default value for each setting is:

high - 25%
medium - 12.5%
low - 6.25%

New HCA bandwidth capability settings are applied
only when partitions are activated.

For example:
50/25.5/10.25 specifies a high setting of 50%, a
medium setting of 25.5%, and a low setting of 10.25%.
33.3// specifies a high setting of 33.3%, and does
not change the medium and low settings.
turbocore
Valid values are:
0 - disable TurboCore mode
1 - enable TurboCore mode

The managed system must be restarted for this change
to take effect.
sys_time
Managed system date and time in the following format:

MM/DD/YYYY hh:mm:ss

where MM is the month, DD is the day, YYYY is the
year, hh is the hour in 24 hour format, mm is the
minute, and ss is the seconds.

This attribute can be set only when the managed system
is powered off.
mfg_default_boot_mode
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
mfg_default_ipl_source
Valid values are a, b, c, or d

Attribute names for system profiles:
name
name of the system profile to
change (required)
new_name
lpar_names | lpar_ids
comma separated
profile_names
comma separated

Attribute names for a managed frame:
new_name
frame_num

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

-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 resource can be changed.

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

-o The operation to perform. The only valid value is apply to apply a partition profile to a shutdown partition. Applying a partition profile is equivalent to activating a partition with that partition profile except the partition is not powered on.
-p The name of the partition to which to apply the partition profile.

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

--id The ID of the partition to which to apply the partition profile.

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

-n The name of the partition profile to apply. If this option is omitted, the last valid configuration partition profile will be applied.
--force When changing a partition profile, specify this option to allow a partition profile that is synchronized with the partition’s current configuration to be changed. After the profile is changed, synchronization of a profile with the partition’s current configuration will be suspended until the next time the partition is activated with a profile or a profile is applied to the partition.

When disabling the remote restart capability of a partition, specify this option to allow the capability to be disabled when the reserved storage device assigned to the partition cannot be read. Note that this will cause some partition settings, such as the partition’s boot or IPL settings and the partition’s time of day, to be reset to their default values.

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

EXAMPLES
Change the managed system’s user-defined name and power off policy:

chsyscfg -r sys -m 9406-570*89320051 -i "new_name=sys1,
power_off_policy=1"

Change partitions using the configuration data in the file /tmp/lparfile:

chsyscfg -r lpar -m sys1 -f /tmp/lparfile

Change the attributes of a shutdown partition by applying the profile prof1:

chsyscfg -r lpar -m system1 -o apply -p p1 -n prof1

Change a partition profile’s memory amounts (reduce the profile’s current memory amounts each by 256 MB), and number of desired processors:

chsyscfg -r prof -m sys1 -i "name=profile1,
lpar_name=partition3,min_mem-=256,desired_mem-=256,
max_mem-=256,desired_procs=2"

Change a system profile (add 2 new partition profiles):

chsyscfg -r sysprof -m sys1 -i "name=sysprof1,
"lpar_names+=partition3,partition4",
"profile_names+=3_prof1,4_defaultProf""

Change the managed frame’s user-defined name and frame number:

chsyscfg -r frame -e 9119-59*1234567 -i "new_name=frame1,
frame_num=1"

ENVIRONMENT
None

BUGS
None

AUTHOR
IBM Austin

SEE ALSO
lssyscfg, mksyscfg, rmsyscfg, chhwres

Linux CHSYSCFG (1) "March 2017"
Generated by manServer 1.07 from chsyscfg.1 using man macros.