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.
[Windows Manager]
Installation_folder\SVROR\Manager\etc\customize_data
os_customize_citrixxen.rcxprop
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.
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.
[Windows Manager]
Installation_folder\SVROR\Manager\etc\customize_data
customizable_os_type_citrixxen.rcxprop
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.
[Windows Manager]
Installation_folder\SVROR\Manager\etc\customize_data
convert_os_type.rcxprop
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.
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" |