C.6.1 Creating Definition Files

This section explains how to create definition files.

For definition files common to virtual L-Servers, refer to "C.1 Definition Files Commonly Shared when Creating Virtual L-Servers".

Selecting Disk Data Type for Virtual L-Servers [KVM]

When performing the following operations for a virtual L-Server on RHEL-KVM, the data type to be deleted can be selected.

When the definition file has been edited, restart the manager.

Deleting an L-Server
Detaching L-Server Disks
Deleting Cloning Images

Location of the Definition File

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

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

Definition File Name

storage.rcxprop

Definition File Format

In the definition file, the items to set are entered on individual lines. Each line is entered in the following format.

Specified item = Specified value

Definition File Items

CLEAN_VM_GUEST_DISK_RESOURCE

When performing the following operations for a virtual L-Server on RHEL-KVM, the data type to be deleted can be selected.

Deleting an L-Server
Detaching L-Server Disks
Deleting Cloning Images

When the following values are used for specified values.
- If "true" is specified
  The data of disks is deleted.
- If "false" is specified
  The data of disks is not deleted.
If nothing is specified
"false" is set.
Example
An example definition file is indicated below.
CLEAN_VM_GUEST_DISK_RESOURCE = true
Note
When specifying "true" for the specified value, check the following advisory notes.
- Operations such as deleting virtual L-Servers on RHEL-KVM will take more time. Operation time changes depending on the number of disks and the disk size.
- When starting to delete disks, message 22502 is output in the event log.
  While deleting the disk data, the status of disk resource will be "unknown".
  When deletion of the data is complete, the message 22503 is output in the event log, and the status of disk resource changes to "normal".
  If the deletion of data fails, message 42504 is output in the event log. The status of disk resources will not be changed from "unknown".

Definition File for Setting the Resources Reserved for VM Hosts [KVM]

When setting the resources reserved for VM hosts, configure the amount of resources in the following definition files:

Location of the Definition File

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

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

Definition File Name

host_config_RHEL-KVM.rcxprop

Definition File Format

In one line,specify the following format separated by commas (",").

ALL,amount_of_memory_capacity,amount_of_cpu_capacity

range_of_class,setting_range,amount_of_memory_capacity,amount_of_cpu_capacity

Definition File Items

list of items is as below.

When discribe definitions that are common on the system

Items	Description	Remarks
ALL	identifier for the system
Memory Capacity	value unit: GB use a number with up to one decimal place value in the range from 0	you don't need to specify unit.
CPU Capacity	{value}{unit} unit percentage: % number of physical cpu core: core value When specifying %, an integer between 0 and 100 When specifying core, an integer 0 or later	you need to specify unit. When specifying %, we define amount of VM hosts as100%. amount of VM hosts is physical cpu spec * number of physical cpu core.

Items

Description

Remarks

ALL

identifier for the system

Memory Capacity

value

unit: GB
use a number with up to one decimal place
value in the range from 0

you don't need to specify unit.

CPU Capacity

{value}{unit}

unit
- percentage: %
- number of physical cpu core: core
value
- When specifying %,
  - an integer
  - between 0 and 100
- When specifying core,
  - an integer
  - 0 or later

you need to specify unit.
When specifying %,
we define amount of VM hosts as100%.
amount of VM hosts is
physical cpu spec * number of physical cpu core.

When discribe definitions that are tenants or pools or physical servers

Items	Description	Remarks
range of class	identifier for range of class. the following identifiers are available When specifying tenants TENANT When specifying pools POOL When specifying physical servers PHYSICAL_SERVER
range	the following ranges are available When specifying tenants tenant name include resource folders When specifying pools pool name include resource folders or tenants When specifying physical servers physical server's name
Memory Capacity	refer to the above table
CPU Capacity	refer to the above table

Example

An example definition file is indicated below.

    ALL,3,10%

    TENANT,/hoge_FLODER/HOGE_TENANT,4,20%

    POOL,/hoge/VMPool,3,1core
    POOL,/TENANT_1/hoge_pool,,20%

    PHYSICAL_SERVER,bx600_1,1
    PHYSICAL_SERVER,bx900_1,4,3core

Note

About comment line
When the descriptions start with a "#", the string is regarded as a comment line.
Or,the line configured only blank spaces(" "),tab,line break signs regarded as a comment line.
A comment line is skipped.
If there is same definition, the last definition is available.
The definitions of physical servers is available even if physical servers of KVM hosts are not registered in VM pools.
If you don't describe definitions of amount_of_memory_capacity,
Please not to write between commas (",")
Example
POOL,/VMPool,,3core
If you don't describe definitions of amount_of_cpu_capacity,please write nothing.
Example
POOL,/VMPool,1