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

C.9.1 Creating Definition Files

This section explains how to create definition files.
For definition files common to virtual L-Servers, refer to "Chapter 8 Creating Definition Files".

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

For manager and guest OS that support the customization function, refer to "C.9.12 Customization function of guest OS".


Guest OS Customization Definition File

When the customization function of 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

The definition file describes the item defined every one line. Each line is described in the form of the following.

Key = Value

When the same key is described to two or more lines, the definition of the line described at the end becomes effective.

Definition File Items

Key

Value

Description

Internet Protocol address of management LAN of resource pool name or mastering pool of Citrix XenServer

Storage repository name to store VCD

Describe the storage repository name to store VCD. Please specify, when you use customization of guest OS.

Note

  • XenServer of the pool mastering on CitrixXen is described by one line.

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

  • Use the UTF-8 character code for files.

  • When the descriptions start with a "#", the string is regarded as a comment line.

  • When two lines of Internet Protocol address of the pool master who belongs to the resource pool name and the resource pool in the definition file are defined, the line in which the resource pool name is defined becomes effective.

  • The definition of the line described in the end becomes effective when there are two or more lines of Internet Protocol address of the same resource pool name or same pool master.

  • Equal sign ("="), underscore ("_"), and single quotation (') cannot be used for the resource pool name and 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

A customizable OS type definition file is described every one line by the following formats.

OS Type

  • OS type describes OS type of the VM guest of XenServer.

  • When the descriptions start with a "#", the string is regarded as a comment line.

  • disregard the nul line.

  • Use the UTF-8 character code for files.

  • OS type treats everything from the head to the line feed code as one name every one line.

  • The specification of all lines becomes effective when there are two or more lines of the same OS type.

Point

OS type describes OS type of the template of XenServer.
OS type can be acquired in the following commands. Please refer to the product manual to which the website of the Citrix Co. corresponds for details.

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

Website of Citrix Co.

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

Conversion definition file of OS type

In Resource Orchestrator, it judges based on information that OS type (Windows/Linux) of L-Server is acquired from the VM product.

It is when OS information cannot be correctly acquired in a part of VM product, and might not be processed ROR correctly.

In detailed information on L-Server that uses Windows OS or Linux OS, when the character string of "Windows" or "Linux" is not included in OS type, it is possible to process it as a specified OS type by defining a part of OS information displayed in this definition file and a correct OS type name.

Client OS and server OS are judged from OS type information for Windows OS in ROR. Please define a correct OS type including the character string "Server" when server OS of Windows is used 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

The conversion definition file of OS type is described every one line by the following formats.

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

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

  • When the descriptions start with a "#", the string is regarded as a comment line.

  • disregard the nul line.

  • Use the UTF-8 character code for files.

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

  • "Correct OS type" specifies the alphanumeric character.

  • Neither the capital letter nor the small letter described in "OS type of detailed information on L-Server" are distinguished.

  • Moreover, it judges by a partial agreement with the character string described in "OS type of detailed information on L-Server".

Example

The example of the definition file is described as follows.

It is an example as follows when OS type "Microsoft" displayed in detailed information on L-Server is converted into OS type correct "Microsoft Windows Server 2008 Standard Edition".

"Microsoft"="Microsoft Windows Server 2008 Standard Edition"