IVM mksyscfg Command

Purpose

Creates a logical partition on the managed system. This command is usable only in an Integrated Virtualization Manager environment.

Syntax

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

Description

The mksyscfg command creates a logical partition on the managed system.

Flags

-r ResourceType The type of resources to create:
lpar - Logical  partition 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/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.

Required Attributes for Partition

name
Name of the partition to create.
lpar_env
aixlinux is the only valid attribute. This attribute creates an RPA partition type, which supports AIX® or Linux®.
min_mem
The minimum megabytes of memory for this partition.
desired_mem
The assigned megabytes of memory for this partition
max_mem
The maximum megabytes of memory for this partition

Optional Attributes for partitions

profile_name
Name of the profile to create. This attribute is not required, but if specified, must be the same as the name attribute.
Note:
Both name and profile_name are required, and must be the same. When using this command on the Hardware Management Console, you must specify the profile name and partition name because it supports multiple profiles per partition.
lpar_id
Unique integer ID for the partition. If this attribute is not specified, the lowest available partition will be assigned.
min_procs
The minimum number of processors for this partition. In shared processing mode, this refers to virtual processors.
desired_procs
The assigned number of processors for this partition. In shared processing mode, this refers to virtual processors.
max_procs
The maximum number of processors for this partition. In shared processing mode, this refers to virtual processors.
min_proc_units
The minimum number of processing units for this partition
desired_proc_units
The assigned number of processing units for this partition
max_proc_units
The maximum number of processing units for this partition
proc_mode
Valid values are:
ded - dedicated processor mode
shared - shared processor mode
sharing_mode
Value 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
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
auto_start
Valid values are:
0 - do not automatically start with system power on
1 - automatically start with system power on
max_virtual_slots
Note:
The system determines this value.
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 additional_vlan_ids, 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.
-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

  1. To create a partition named lp3 with 128 MB, type: 
    mksyscfg -r lpar -i "name=lp3,lpar_env=aixlinux,min_mem=128,desired_mem=128,max_mem=128"
  2. To create a partition with 128 MB and a dedicated processor, type: 
    mksyscfg -r lpar -i "name=lp4,lpar_env=aixlinux,min_mem=128,desired_mem=128,max_mem=128, \
proc_mode=ded, sharing_mode=share_idle_procs,min_procs=1,desired_procs=1,max_procs=2"
  3. To create a partition with 128 MB and 0.2 shared processing units, type: 
    mksyscfg -r lpar -i "name=lp2,lpar_env=aixlinux,min_mem=128,desired_mem=128,max_mem=128, \ 
proc_mode=shared, sharing_mode=uncap,min_procs=1,desired_procs=1,max_procs=2, \ 
min_proc_units=0.1,desired_proc_units=0.2, max_proc_units=2"
  4. To create a partition with 128 MB and 0.2 shared processing units. and a virtual Ethernet adapter on VLAN 1, type: 
    mksyscfg -r lpar -i "name=lp2,lpar_env=aixlinux,min_mem=128,desired_mem=128,max_mem=128, \
proc_mode=shared, sharing_mode=uncap,min_procs=1,desired_procs=1,max_procs=2, \ 
min_proc_units=0.1,desired_proc_units=0.2, max_proc_units=2,virtual_eth_adapters=4/0/1//0/0"

Related Information

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

Send feedback |  Rate this page