IVM mkgencfg command

Purpose

Performs the initial logical partition configuration for the managed system. This command is operable only in an Integrated Virtualization Manager environment.

Syntax

mkgencfg -o init [-i "ConfigurationData" ] [ -m ManagedSystem ]

Description

The mkgencfg command performs the initial logical partition configuration for the managed system. As part of the initial configuration, virtual Ethernet adapters are created in the management partition. The virtual Ethernet MAC address prefix can optionally be configured through this command.

Flags

Flag name	Description
-o Operation	The type of operations: `init` - Perform initial logical partition configuration actions for the managed system
-i ConfigurationData	The configuration data consists of attribute name/value pairs, which are in a comma separated value (CSV) format. The format of a configuration record is as follows: `"attribute-name=value,attribute-name=value,..."` Note that certain attributes accept a comma separated list of values, as follows: `""attribute-name=value,value,...",..."` When you specify a list of values, the attribute name/value pair must be enclosed in double quotation marks. Depending on the shell being used, nested double quotation marks might need to be preceded by an escape character. Valid Attributes for Configuration Data: mac_prefix The prefix needs to be a 3 byte hexadecimal value. It specifies the first 2.5 bytes of the MAC address to be assigned to all virtual Ethernet adapters for this managed system. The value cannot be a multicast address (010000 bit must be off), and needs to be a private address (020000 bit must be on). For example, a valid MAC address prefix is 0642A0. pend_configured_max_lpars The maximum number of partitions supported by the management partition after the next restart.
	virtual_eth_mac_base_value The virtual Ethernet MAC address base value is a per partition value. The base value is used to build the MAC addresses for each virtual Ethernet adapter in that partition. The base value is the first 5 bytes of the MAC address. The virtual slot number of the virtual Ethernet adapter makes up the last byte. If you do not assign a base value, one is generated automatically using the following format: `Base value = 0xSSSSSBBBBB` Where `SSSSS` is the system wide MAC address prefix and `BBBBB` is a randomly generated sequence of bits (guaranteed to be unique within this physical system). Note: The system wide MAC prefix is randomly generated unless you override it using `mkgencfg -o init -i mac_prefix`. If the base value is automatically generated, then the MAC address format for a virtual Ethernet adapter is `0xSSSSSBBBBBNN`, where `NN` is the slot number. If you specify the base value using mkgencfg for partition 1 or mksyscfg/chsyscfg for any other partition, then the format is `0xBBBBBBBBBBNN`, where `BBBBBBBBBB` is the base value that you specified. If a virtual Ethernet adapter is in a slot greater than or equal to 256, then the slot number overflows into the base value, since it does not fit in 1 byte. For example, Integrated Virtualization Manager handles it as `0xBBBBBBBBBB00` + `0x00000000NNNN`. The mkgencfg command is the only way to specify the base value for partition 1. After this value is set, you cannot change it without losing all partition configuration. If you need to change the value, use the lpcfgop command. The value is set implicitly when mkgencfg is running. The value will be generated automatically, unless you specify the value. The mkgencfg command runs implicitly when you run your first change command. You can change the base value for any other partition, when the partition is powered off. A side effect of setting the base value for partition 1 with mkgencfg, is that the system wide prefix is set to the first 2.5 bytes of the partition 1 base value. As a result, there are restrictions on setting both `mac_prefix` and `virtual_eth_mac_base_value` with mkgencfg at the same time. If you specify both, the `mac_prefix` value needs to be equal to the first 2.5 bytes of the `virtual_eth_mac_base_value` value.
-m ManagedSystem	The name of the managed system. This attribute is optional because there is only one system to manage. The name might 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.

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 initialize the logical partition configuration for the managed system using defaults, type:
```
mkgencfg -o init
```
To initialize the logical partition configuration for the managed system with support for 17 partitions and a MAC prefix of 0x06ABC0, type:
```
mkgencfg -o init -i "pend_lpm_max_lpars=17,mac_prefix=06ABC0"
```

Last updated: Wed, November 18, 2020