C.1.2 VM Specific Information Definition File

This file contains the information to be specified for a virtual machine when creating an L-Server or when modifying a configured (defined) L-Server.
VM specific information definition files can be created for each user group.
Use the UTF-8 character code.
The order of the priority of the parameters is as follows:

L-Server XML file > L-Server template > Definition file (User group) > Definition file (Shared on the system)

Storage Location of the Definition File

[Windows Manager]
Installation_folder\SVROR\Manager\etc\customize_data\vm_prop

[Linux Manager]
/etc/opt/FJSVrcvmr/customize_data/vm_prop

Point

In the storage location above, the sample definition file (vm_VMTYPE.rcxprop.sample) is stored. When using the sample as the definition file, place the file after changing "VMTYPE" to the VM type and deleting ".sample".

Definition File Name

Definition files can be divided into definitions that are available for each user group and definitions that are common on the system.

If the same key is configured in the definition file common on the system and the definition file for a specific user group, priority is given to the values indicated in the definition file for the user group.

User Groups
vm_user_group_name_VM_type.rcxprop
Common on System
vm_VM_type.rcxprop

Note

For VM_type, enter the VM type to be specified when creating an L-Server, such as VMware, Hyper-V, Oracle VM, or RHEL-KVM. This value is not case-sensitive.
When there are multiple files with the same VM_type specified in the filename, the VM_type of the filenames are sorted in ascending order of character code, and the one listed first will be selected.
Example
usergroup1_VMware
usergroup1_VMWARE -> This file will be selected.
usergroup1_vmware
Remove any blank spaces in the VM_type.
Example
Oracle VM -> OracleVM

Definition File Format

In the definition file, an item to define is entered on each line. Each line is entered in the following format.

Key = Value

Definition File Items

Specify the following items.

Table C.1 The List of Parameters
Key	Description
processor_reserve_spec	Specify the minimum amount of CPU resources to be allocated. Enter a value in the range from 0 to the limit of CPU performance, using a number with up to one decimal place, in units of gigahertz. In the XML files for L-Servers and L-Server templates, set the value for "CPUReserve".
processor_share	Specify the relative proportion of CPU resources for allocation. Enter an integer equal to or greater than 1. In the XML files for L-Servers and L-Server templates, set the value for "CPUShare". Enabled when the VM type is set to "VMware".
memory_reserve_size	Specify the minimum amount of memory resources to be allocated. Enter a value in the range from 0 to the limit of memory size, using a number with up to one decimal place, in units of gigabytes. In the XML files for L-Servers and L-Server templates, set the value for "MemoryReserve". Enabled when the VM type is set to "VMware".
memory_share	Specify the relative proportion of memory resources for allocation. Enter an integer equal to or greater than 0. In the XML files for L-Servers and L-Server templates, set the value for "MemoryShare". Enabled when the VM type is set to "VMware".
processor_weight	Specify the priority for CPU allocation. Enter an integer between 1 and 10,000. In the XML files for L-Servers and L-Server templates, set the value for "CPUWeight". Enabled when the VM type is set to "Hyper-V".
dynamic_memory	Specify the dynamic memory settings. When dynamic memory is enabled Specify "true". When dynamic memory is disabled Specify "false". When omitted, the value varies depending on the initial memory size and memory buffer specified when creating an L-Server. When the initial memory size or memory buffer is configured Dynamic memory is enabled When neither initial memory size nor memory buffer is configured Dynamic memory is disabled When dynamic memory is disabled, the values specified for memory_startup_size and memory_buffer_rate will be ignored. Enabled when the VM type is set to "Hyper-V".
memory_startup_size	Specify the initial amount of memory to be allocated at startup. Enter a value between 0.1 and the limit of memory size. In the XML files for L-Servers and L-Server templates, set the value for "StartupRAM". When setting this value for a virtual machine, enable dynamic memory in the XML file to be specified when creating an L-Server template or L-Server, or do not specify dynamic memory. When no L-Server template is used and dynamic memory settings are not specified in the XML file specified when creating an L-Server, dynamic memory is enabled or disabled based on the existence of this setting and the setting for memory_buffer_rate. When this setting or memory_buffer_rate are set Dynamic memory is enabled When this setting and memory_buffer_rate are not set Dynamic memory is disabled When dynamic memory is disabled, this setting is ignored. Enabled when the VM type is set to "Hyper-V".
memory_buffer_rate	Specify the percentage of memory to be reserved as a buffer. Enter an integer between 5 and 2000 in units of percent. In the XML files for L-Servers and L-Server templates, set this value for "MemoryBuffer". When setting this value for a virtual machine, either enable dynamic memory in the XML file to be specified when creating an L-Server template or L-Server, or do not specify dynamic memory. When no L-Server template is used and dynamic memory is not specified in the XML file specified during L-Server creation, dynamic memory setting is enabled or disabled based on whether this setting and the setting for memory_startup_size exist. When this setting or memory_startup_size exists Dynamic memory is enabled When this setting and memory_startup_size are not set Dynamic memory is disabled When dynamic memory is disabled, this setting is ignored. Enabled when the VM type is set to "Hyper-V".
memory_weight	Specify the priority for allocation of memory. Enter an integer between 0 and 10,000. In the XML files for L-Servers and L-Server templates, set this value for "MemoryWeight". Enabled when the VM type is set to "Hyper-V".
max_definable_memory_size	Specify the maximum amount of memory that can be configured for the VM guest on KVM. Enter a value in the range from the limit of memory size to the memory size of a physical server, using a number with up to one decimal place, in units of gigabytes. The memory amount for the VM guest can be changed, using this value as the upper limit. When omitted, this memory size is the same as the amount of physical memory for the VM host. When specifying this item, if the amounts of memory mounted on the VM hosts registered in a VM pool are not the same, specify the memory capacity using a lower value than that of the VM host with the lowest memory capacity. When specifying values exceeding the physical memory capacity, starting of an L-Server will fail.

See

When not describing a parameter in the VM specific information definition file, refer to each element name in "14.3.2 Definition Information for Virtual L-Servers (XML)" in the "Reference Guide (Command/XML) CE".

Note

When modifying specifications of an L-Server to which resources have been allocated, the settings in this definition file are not reflected because priority is given to the values already configured for the L-Server. In this case, enter new values in the XML file and then execute the appropriate commands to reflect the changes.

When individual parameters are specified when creating an L-Server template or L-Server, priority is given to those settings over those in this definition file.