Top
ServerView Resource Orchestrator Cloud Edition V3.1.1 Setup Guide
ServerView

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

[VMware]
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

[VMware] [Citrix Xen]
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" or "Citrix-Xen".

memory_share

[VMware]
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.

[Hyper-V]
Enter an integer between 1 and 10,000.
[Citrix Xen]

Enter an integer between 1 and 65,535.

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" or "Citrix-Xen".

dynamic_memory

[Hyper-V]
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

[Hyper-V]
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

[Hyper-V]
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

[Hyper-V]
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

[KVM]
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.

Enabled when the VM type is set to "KVM".

memory_hotplug

[KVM]
Specify enabling/disabling of the memory hotplug function for VM guests.

  • When enabling the memory hotplug function

    Specify "true".

  • When disabling the memory hotplug function

    Specify "false".

If left blank, "true" is set. The default is "true".

The relationship between memory_hotplug and max_definable_memory_size settings is explained in "Table C.2 Relationship Between memory_hotplug and max_definable_memory_size Settings [KVM]".

Enabled when the VM type is set to "KVM".

clock_offset

[KVM]
Specify "UTC" or "LOCAL" for the offsets of the virtual hardware clock (virtual CMOS) for virtual machines.

If left blank, "LOCAL" is set. The default is "LOCAL".

Enabled when the VM type is set to "KVM".


Table C.2 Relationship Between memory_hotplug and max_definable_memory_size Settings [KVM]

Setting of memory_hotplug

Setting of max_definable_memory_size

When Settings are Configured

When Omitted

"true", or when the settings are omitted

Configure the max_definable_memory_size values for the maximum memory values.

Configure the total physical memory size of the host for the maximum memory size.

"false"

The value of the memory size is equal to the maximum memory size.

The max_definable_memory_size values are disabled.

The value of the memory size is equal to the maximum memory size.

See

When not describing a parameter in the VM specific information definition file, refer to each element name in "15.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.