7.25 set Command

Use the --set command to configure vCPUs or memory for a guest.

Syntax

To configure the number of virtual CPUs for a guest:

vm_maker --set --vcpu vcpu [ --domain guest_name [ --config ] [ --force ]]

To configure the memory for a guest:

vm_maker --set --memory size --domain guest_name [ --restart-domain ] [ --force ]

To configure the MAC for specified Ethernet interface:

vm_maker --set --mac mac_address --interface interface_name --domain guest_name [ --restart-domain ]

Options

• --vcpu: Specifies the number of virtual CPUs for a guest.
• --memory: Sets the memory size for the specified guest. Memory can be specified using K, M, or G, for example, 40G or 25000M.
• --mac: Sets the media access control (MAC) address for the specified network interface.

• –-domain: When used with --vcpu or --memory, this argument indicates that the setting applies to a single guest. Otherwise the setting applies to all guests. You must use --domain when changing the memory size.

• --config: Indicates that the number of virtual CPUs should not be changed until you restart the guest. This option can only be used when modifying a single guest.
• --interface: The Ethernet network interface to configure.
• --restart-domain: Use this option to automatically restart the guest after vm_maker changes the configuration.
• --force: Forces the new setting to be implemented. This option can only be used when modifying a single guest.

Usage Notes

• Changing the number of virtual CPUs for a guest happens immediately by default, without restarting the guest.
• When changing the memory, you must restart the guest before the settings take effect.