Top
ServerView Resource Orchestrator Cloud Edition V3.4.0 Setup Guide
FUJITSU Software

8.9.1 Creating Definition Files

This section explains how to create definition files.

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

This section explains the definition files specific to Citrix-Xen.

For the managers and guest OSs that support the customization function, refer to "8.9.12 Customization Function of Guest OS".


Guest OS Customization Definition File

When the customization function of a guest OS is used, the following definition files are set.

Location of the Definition File

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

Definition File Name

os_customize_citrixxen.rcxprop

Definition File Format

Describe each line of the definition file in the following format:

Key = Value

When the same key is stated in multiple lines, the definition in the line described last is valid.

Definition File Items

Specify the following items:

Key

Value

Description

The IP address of the admin LAN of the pool master name or the resource pool name of Citrix XenServer

The name of the storage repository name for storing VCD

Describe the name of the storage repository for storing VCD. Specify when using customization of guest OSs.

Note

  • Describe the XenServer pool master on CitrixXen in one line.

  • When the key corresponding to the IP address of the resource pool or the pool master of Citrix XenServer of the object does not exist in the definition file, an error occurs.

    • The key corresponding to the resource pool of Citrix XenServer

    • The key corresponding to the admin LAN IP address of the pool master

  • Use the UTF-8 character code for this file.

  • When a description starts with "#", the string is regarded as a comment line.

  • When both of the following are defined in a definition file, the line in which the resource pool name is defined is used.

    • The Citrix XenServer resource pool name

    • The admin LAN IP address of a pool master belonging to the above resource pool

  • When there are two or more lines of the following definition, the latter line will be used.

    • The same resource pool name

    • The IP address of the pool master

  • Equal signs ("="), underscores ("_"), and single quotes (') cannot be used for the resource pool name or the storage repository name.


Customizable OS type definition file

When using the customization function of guest OS, define a customizable OS type in the following definition files.

Location of the Definition File

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

Definition File Name

customizable_os_type_citrixxen.rcxprop

Definition File Format

Describe each line of the definition file in the following format:

OS Type

  • Describe the OS type of the VM guest of XenServer for OS Type.

  • When a description starts with "#", the string is regarded as a comment line.

  • Empty lines are ignored.

  • Use the UTF-8 character code for files.

  • Everything from the start of a line to the next line feed code is treated as a single OS type.

  • When there are two or more lines of the same OS type, the specifications in all lines are used.

Point

Describe the OS type of the template of XenServer in OS type.
OS type can be acquired using the following commands. Refer to the Citrix web site for the relevant product manual.

>xe vm-param-get uuid=Template_UUID param-name=os-version param-key=name <RETURN>

Citrix Web site

URL: http://support.citrix.com/product/xens/


OS Type Conversion Definition File

In Resource Orchestrator, the OS type (Windows/Linux) of L-Servers is determined based on information obtained from VM products.
In some cases, OS information cannot be correctly acquired for some VM products. As a result, processes of this product may not be performed correctly.

In detailed information of L-Servers that use Windows OS or Linux OS, when the character string of "Windows" or "Linux" is not included in OS type, edit this definition file to display the correct OS type.
By relating part of the OS type displayed in the detailed information of the L-Server and the correct OS type name in this definition file, the L-Server will be processed as an L-Server of the specified OS type.

For Windows, client OS and server OS are judged from OS type information in ROR. Define the correct OS type including the character string "Server" when the server OS is Windows and OS information is not displayed correctly.

Location of the Definition File

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

Definition File Name

convert_os_type.rcxprop

Definition File Format

Describe each line of the definition file in the following format:

"OS type of detailed information on L-Server"="Correct OS type"

  • OS type describes the OS type of the detailed information of the L-Server.

  • When a description starts with "#", the string is regarded as a comment line.

  • Empty lines are ignored.

  • Use the UTF-8 character code for files.

  • Only the first line defined is used when there are two or more lines of the same "OS type of detailed information on L-Server".

  • Specify the correct OS type using alphanumeric characters.

  • The "OS type of detailed information on L-Server" is not case-sensitive.

  • The character string in "OS type of detailed information on L-Server" is used to determine if the OS is a guest OS or server OS.

Example Definition File

In the following example, the OS type "Microsoft" displayed in detailed information of an L-Server is converted into the correct OS type, "Microsoft Windows Server 2012 Standard Edition".

"Microsoft"="Microsoft Windows Server 2012 Standard Edition"