IVM chsyscfg Command

Purpose

Changes attributes of partitions, partition profiles, or the managed system. This command is available only in an Integrated Virtualization Manager environment.

Syntax

To change system attributes:

chsyscfg -r sys { -f ConfigurationFile | -i ConfigurationData } [ -m ManagedSystem ]

To change partition attributes

chsyscfg -r lpar { -f ConfigurationFile | -i ConfigurationData } [ -m ManagedSystem ]

To change partition profile attributes

chsyscfg -r prof { -f ConfigurationFile | -i ConfigurationData } [ -m ManagedSystem ]

Description

The chsyscfg command changes attributes of partitions, partition profiles, or the managed system.

Flags

-r ResourceType	The type of resources to change: sys Managed system resources lpar Logical partition resources prof Logical partition profile resources
-m ManagedSystem	The name of the managed system. This attribute is optional because there is only one system to manage. 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.
-f ConfigurationFile	The name of the file containing the configuration data needed to change the resources. The configuration data consists of attribute name and value pairs, which are in comma separated value (CSV) format. These attribute name and 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, 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 \ (back slash) 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 values are 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 values are deleted from the existing list. Attribute names for partitions name \| lpar_id name or ID of the partition to change (required) new_name new name for the partition. shared_proc_pool_util_auth Valid values are: 0 - do not allow authority 1 - allow authority work_group_id Valid values are: none - do not participate in the workload management group 1 - participate in the workload management group
	Attribute names for partition profiles name \| lpar_name \| lpar_id Name or ID of the partition to change (required) Note: This command uses the profile name and lpar_name interchangeably because this environment does not support multiple profiles per partition. When using this command on the Hardware Management Console, you must specify the profile name and partition name or ID because it supports multiple profiles per partition. new_name New name for the partition. min_mem minimum memory in megabytes desired_mem assigned memory in megabytes
	max_mem maximum memory in megabytes proc_mode Valid values are: ded: dedicated processor mode shared: shared processor mode min_procs Minimum processors. In shared processing mode, this refers to virtual processors. desired_procs Assigned processors. In shared processing mode, this refers to virtual processors. max_procs Maximum processors. In shared processing mode, this refers to virtual processors. min_proc_units Minimum shared processing units. desired_proc_units Assigned shared processing units. max_proc_units Maximum shared processing units. sharing_mode Valid values are: keep_idle_procs: Valid with dedicated processor mode share_idle_procs: Valid with dedicated processor mode cap: Capped mode. Valid with shared processor mode uncap: Uncapped mode. Valid with shared processor mode uncap_weight A weighted average of processing priority when in uncapped sharing mode. The smaller the value, the lower the weight. Valid values are: 0 - 255 auto_start Valid values are: 0 - do not automatically start with system power on 1 - automatically start with system power on boot_mode Partition power on 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 max_virtual_slots Maximum number of virtual I/O adapter slots virtual_eth_adapters Comma separated list of virtual ethernet adapters, with each adapter having the following format: `slot_number/is_ieee/port_vlan_id/additional_vlan_ids/is_trunk/is_required` All 5 '/' characters must be present, but optional values may be omitted. Optional values are `is_ieee`, `additional_vlan_ids`, `is_required` and `is_trunk`. Valid values for `is_ieee`, `is_trunk`, and `is_required`" 0 - no 1 - yes For example, `4/0/2//0/0` specifies a virtual Ethernet adapter with a virtual slot number of 4, is not IEEE 802.1Q enabled, has a port virtual LAN ID of 2, no additional virtual LAN IDs, it is not a trunk adapter, and is not required.
	Attribute names for the managed system new_name new name for the managed system pend_configured_max_lpars The maximum number of logical partitions which can be created after restarting the managed system. lpar_comm_ipaddr The IP address through which client partitions will communicate with the management partition. This is used primarily for Dynamic Logical Partitioning (DLPAR). It is defaulted to the first IP address configured on your system, but can be manually set if desired. If you set this manually, and then change your systems IP address, you must update this value. lpar_comm_default Returns the lpar_comm_ipaddr to using the default IP address configured on the system as reported by lstcpip -interfaces. Valid values: 1: Default IP address will be used.
-i ConfigurationData	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.

Exit Status

This command has a return code of zero on success.

Security

This command is not accessible by users with the ViewOnly role.

Examples

To change the user defined name for the managed system, type:
```
chsyscfg -r sys -i "new_name=sys1"
```
To change partitions using the configuration data in the file /tmp/lparfile, type:
```
chsyscfg -r lpar -f /tmp/lparfile
```
To reduce a partition profile's assigned and minimum memory by 256 MB, type:
```
chsyscfg -r prof -i "lpar_name=partition3,min_mem-=256,desired_mem-=256" 
```

Related Information

The lssyscfg command, the mksyscfg command, and the rmsyscfg command.

Send feedback | Rate this page