ServerView Resource Orchestrator Cloud Edition V3.4.0 Reference Guide (Command/XML)

15.18.4 Template Information

This section explains the template information in detail.

15.18.4.1 Overview of Template Information

Template information is defined in XML documents that list the configuration information for L-Platform templates.

Create and register one template information file for each L-Platform template.

Infrastructure administrators must take this model into account when performing creation.

A model template information file is stored in the following folder:

[Windows Manager]

Installation_folder\RCXCFMG\templates\templates\
The following models are stored: 
	sample1.xml(Single server configuration)
	sample2.xml(Two-layer configuration)
	sample3.xml(Three-layer configuration)

[Linux Manager]

/opt/FJSVcfmg/templates/templates/
The following models are stored: 
	sample1.xml(Single server configuration)
	sample2.xml(Two-layer configuration)
	sample3.xml(Three-layer configuration)

Refer to "15.18.4.2 File Information Details" for information on a description of items (tags).

The cloning image ID of the cloning image registered with Resource Management is entered for the cloning image ID in the template information.

15.18.4.2 File Information Details

Template information files use the following XML format:

<?xml version="1.0" encoding="UTF-8" ?>
<template version="1.1">
	<id>[Template ID]</id>
	<lcid>[Locale ID]</lcid>
	<name>[Template name]</name>
	<baseTemplateId>[Base template ID]</baseTemplateId>
	<ownerOrg>[Owner (tenant)]</ownerOrg>
	<ownerUser>[Owner (user)]</ownerUser>
	<publicCategory>[Public category]</publicCategory>
	<designSheetPath>[Path to the design sheet]</designSheetPath>
	<releaseDate>[Release date]</releaseDate>
	<numOfMaxVnet>[Maximum number of VNETs]</numOfMaxVnet>
	<numOfMaxVm>[Maximum number of VMs]</numOfMaxVm>
	<productId>[Model number]</productId>
	<description>[Description]</description>
	<keyword>[Search keyword]</keyword>
	<estimate>[Rough cost estimate]</estimate>
	<license>[License]</license>
	<support>[Support]</support>
	<vnets>
		<vnet>
			<id>[Network ID]</id>
			<name>[Name]</name>
			<numOfMaxVm>[Maximum number of VMs]</numOfMaxVm>
			<resourceId>[Network resource ID]</resourceId>
			<category>[Network type]</category>
			<segmentType>[Segment type information]</segmentType>
			<order>[Display order]</order>
		</vnet>
		...
	</vnets>
	<slbDesignType>[UI type of SLB]</slbDesignType>
	<lnetdevs>
		<lnetdev>
			<name>[LNetDev name]</name>
			<type>[LNetDev type]</type>
			<lnetdevIfs>
				<lnetdevIf>
					<name>[Interface name]</name>
					<networkId>[Network ID]</networkId>
				</lnetdevIf>
				...
			</lnetdevIfs>
			<ruleset>
				<name>[Ruleset name]</name>
				<designtype>[UI type]</designtype>
				<lplatformModel>[L-Platform model]</lplatformModel>
				<description>[Ruleset description]</description>
				<parameters>
					<parameter>
						<name>[Parameter name]</name>
						<label>[Display name]</label>
						<segmentlabel>[Segment display name]</segmentlabel>
						<serverlabel>[Server display name]</serverlabel>
						<view>[Display flag]</view>
						<required>[Flag indicating whether parameter is required]</required>
						<syntax>[Syntax]</syntax>
						<value>[Parameter value]</value>
						<summary>[Parameter summary]</summary>
						<description>[Parameter description]</description>
					</parameter>
					...
				</parameters>
				<parameterGroups>
					<parameterGroup>
						<name>[Parameter group name]</name>
						<id>[Parameter group ID]</id>
						<parameters>
							<parameter>
								<name>[Parameter name]</name>
								<label>[Display name]</label>
								<view>[Display flag]</view>
								<value>[Parameter value]</value>
								<description>[Parameter description]</description>
							</parameter>
							...
						</parameters>
					</parameterGroup>
					...
				</parameterGroups>
			</ruleset>
		</lnetdev>
	</lnetdevs>
	<servers>
		<server>
			<no>[Server serial number]</no>
			<imageId>[Cloning image ID]</imageId>
			<name>[Server name]</name>
			<serverType>[Server type]</serverType>
			<pool>[Deployment destination pool resource name]</pool>
			<vmHostId>[VM host resource ID]</vmHostId>
			<vmHostName>[VM host name]</vmHostName>
			<sparePool>[Spare pool resource name]</sparePool>
			<storagePool>[Storage pool resource name]</storagePool>
			<diskResourceId>[Disk resource ID]</diskResourceId>
			<diskResourceName>[Disk resource name]</diskResourceName>
			<virtualStorageId>[Virtual storage resource ID]</virtualStorageId>
			<virtualStorageName>[Virtual storage name]</virtualStorageName>
			<powerPriority>[Startup priority level]</powerPriority>
			<useDataDisk>[Data disk use]</useDataDisk>
			<nicgroups>
				<management>[Control NIC]</management>
				<nicgroup>
					<index>[NIC group index]</index>
					<networkId>[Connection destination network ID]</networkId>
				</nicgroup>
				...
			</nicgroups>
			<vnics>
				<management>[Control NIC]</management>
				<vnic>
					<no>[NIC serial number]</no>
					<networkId>[Connection destination network ID]</networkId>
					<group>[NIC group index]</group>
				</vnic>
				...
			</vnics>
			<vdisks>
				<vdisk>
					<no>[Disk serial number]</no>
					<diskSize>[Disk capacity]</diskSize>
					<resourceId>[Resource ID]</resourceId>
					<resourceName>[Disk resource name]</resourceName>
					<storagePool>[Storage pool resource name]</storagePool>
					<virtualStorageId>[Virtual storage resource ID]</virtualStorageId>
					<virtualStorageName>[Virtual storage name]</virtualStorageName>
					<contained>[Disk contained in image]</contained>
				</vdisk>
				...
			</vdisks>
		</server>
		...
	</servers>
</template>

The following table shows descriptions of each of these items (tags), as well as their settings:

Modify template information files if necessary, by referring to the information in this table.

Tag names in square brackets [ ] can be omitted.

Tag name	Format	Setting range	Mandatory	Description
[ id ]	string	0 - 32 characters	No	The ID assigned to the template. If this template ID is omitted, one is automatically assigned.
[ lcid ]	string	Fixed value	Yes	The locale for the software information. Select one of the following: - "en": English - "zh": Chinese
[ name ]	string	Up to 85 characters	Optional	The template name. The template name specified here is used for the default system name for the L-Platform system. For the system name, the characters that can be used and the length of the name vary depending on the method for setting resource names. It is recommended that template names be specified within the following range, which is effective for any method for setting resource names: - Names containing no more than 23 alphanumeric characters, underscores ("_") and hyphens ("-") Refer to "9.5 Setting the Method for Setting Resource Names" in the "Setup Guide CE" for information on the method for setting resource names.
baseTemplateId	-	-	No	The name of the base template.
ownerOrg	string	Fixed value	Yes	The tenant name to which the template belongs. The value is fixed as "cfmgadm".
ownerUser	string	Fixed value	Yes	The user ID of the user registering the template. The value is fixed as "cfmgadm".
publicCategory	string	Fixed value	Yes	The category of the template. The value is fixed as "PUBLIC". The template is available to all users.
designSheetPath	-	-	No	The storage folder for the design sheet.
releaseDate	string	0 - 10 characters	Optional	The date when the template is made available. The format is "yyyy/mm/dd".
numOfMaxVnet	integer	1 - 99	Yes	The maximum number of segments that can be used by the system in the template.
numOfMaxVm	integer	0 - 30	Yes	The maximum number of servers that can be used by the template's system.
productId	-	-	No	The product ID of the template that will be used for billing purposes.
description	string	Up to 85 characters	Optional	Enter template descriptions, including information about the system that the template produces and the contents of the template.
keyword	string	Up to 85 characters	Optional	The search keyword for the template. The template search function finds templates that use this keyword. Case is not distinguished for half-width and full-width alphanumerics.
estimate	decimal	Fixed value	Yes	The price of the template. The value is fixed as "0".
license	string	List	Yes	Specifies whether a license has been assigned to the template. Select one of the following options: - "0": No license assigned - "1": License assigned
support	string	List	Yes	Specifies whether support has been assigned to the template. Select one of the following options: - "0": No support assigned - "1": Support assigned
vnets	-	-	No	The details of the system segments.
vnet	-	0 or more	No	As many segment information files as there are segments.
id	string	1 - 20 characters	Yes	The ID that identifies the segments within the template. Specify any ID within the template. Specify the value specified in this designated value, in the vnic networkID.
name	string	0 - 20 characters	Optional	The segment name.
numOfMaxVm	integer	0 - 30	Yes	The maximum number of servers that can be added to the segment and used.
[ resourceId ]	string	1 - 256 characters	Yes	The resource ID of the virtual network assigned to the segment. Confirm the resource ID using the cfmg_listvnet command. If omitted, the selection is automatic. To omit this, also omit the tag.
[ category ]	string	1 - 10 characters	Yes	The segment type for filtering the network resources that can be selected. Select one of the following options: - "BUSINESS": Business segment - "MANAGEMENT": Management segment If this is omitted, "BUSINESS" will be used. To omit this, also omit the tag.
[ segmentType ]	string	1 - 32 characters	Yes	The segment type information for filtering the network resources that can be selected. If this is omitted, no filtering will be performed. To omit this, also omit the tag.
[ order ]	integer	0 or more	Yes	The order for displaying the segments. Smaller numbers are displayed earlier in the order. When you specify the same value as other segments, there is no guaranteed order for display amongst those segments with the same value. If this is not specified, the order is automatically determined with a number starting at 0 set in the order in the XML file.
[ slbDesignType ]	string	List	Yes	Specify the type of user interface for the server load balancer. - "UserCustomize": User-customized When omitted, it is assumed that "UserCustomize" is specified.
[ lnetdevs ]	-	-	No	The system LNetDevs.
lnetdev	-	1 or more	No	Specify as many <lnetdev> tags as there are LNetDevs.
name	string	1 - 32 characters	Yes	The LNetDev name.
type	string	List	Yes	The LNetDev type. Select one of the following: - "Firewall": Firewall - "SLB": Server load balancer
lnetdevIfs	-	-	No	The LNetDev virtual interface definition.
lnetdevIf	-	1 or more	No	Specify as many <lnetdevlf> tags as there are virtual interfaces.
name	string	1 character or more	Yes	The name of the network ID parameter corresponding to the LNetDev virtual interface.
networkId	string	1 - 20 characters	Yes	The corresponding VNET segment ID.
ruleset	-	-	No	The ruleset.
name	string	1 - 32 characters	Yes	The ruleset name.
[ designtype ]	string	List	Yes	Specify the type of the user interface. - "UserCustomize": User-customized Specify the same value as was set in the ruleset.
lplatformModel	integer	List	Yes	Specify the L-Platform model. Select one of the following: - 1: Firewall only - 2: Server load balancer only - 3: Firewall and server load balancer
description	string	1 - 256 characters	Optional	The ruleset description.
parameters	-	-	No	The ruleset parameters.
parameter	-	1 or more	No	Specify as many <parameter> tags as there are parameters.
name	string	1 character or more	Yes	The parameter name.
label	string	0 - 32 characters	Optional	The parameter name to be displayed on the GUI.
segmentlabel	string	0 - 32 characters	Optional	Specify the segment name displayed in the GUI.
serverlabel	string	0 - 32 characters	Optional	Specify the server name displayed in the GUI.
view	string	List	Yes	The parameter display flag. Select one of the following options: - "true": Display - "false": No display
[ required ]	string	List	Yes	Specify whether the parameter is required. Select one of the following options: - "true": Required - "false": Optional If omitted, "false" will be used.
[ syntax ]	string	List	Yes	Specify the parameter syntax. Select one of the following: - "INTEGER(0..255)": integer Specify the range of values with "minimum value...maximum value" format - "DisplayString (SIZE (0...256))": string Specify the minimum number of characters and the maximum number of characters with SIZE (0 to 256) - "DisplayString(SELECT("AA" | "BB" | "CC"))": string Select a SELECT string (AA, BB, and CC are arbitrary strings) - "Physical Address": Media Access Control address Media Access Control address format (xx:xx:xx:xx:xx:xx) - "IpAddress": IP address IPv4 address format (xxx.xxx.xxx.xxx) or IPv6 address format (xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx) - DisplayString (SELECT IPADDRESS("SegA"|"SegB"|"SegC")): Select server (IP address) from target segments - DisplayString (SELECT IPADDRESS SLB SERVER()): Select server (IP address) from target SLB servers
value	string	1 character or more	Yes	The parameter value.
summary	string	0 - 256 characters	Optional	Specify a summary for the parameter.
description	string	0 - 256 characters	Optional	The parameter description.
[ parameterGroups ]	-	-	No	Specify the parameter groups of the ruleset. Specify only when parameter groups have been set in the ruleset.
parameterGroup	-	1 or more	No	Specify as many <parameterGroup> tags as there are parameter groups.
name	string	1 character or more	Yes	Specify the parameter group name. Specify the same value as was set in the ruleset.
id	integer	Fixed value	Yes	Specify the identifier information to be assigned to the parameter group name. The value is fixed as "0".
parameters	-	-	No	Specify the parameters within the parameter group.
parameter	-	1 or more	No	Specify as many <parameter> tags as there are parameters.
name	string	1 character or more	Yes	Specify the parameter name. Specify the same value as was set in the ruleset.
label	string	0 - 32 characters	Optional	Specify the parameter name to be displayed on the GUI. This tag will be ignored even if specified. Specify a space.
view	String	Fixed value	Yes	Specify the parameter display flag. The value is fixed as "true".
value	String	1 character or more	Yes	Specify the parameter value.
description	String	0 - 256 characters	Optional	Specify the parameter description. This tag will be ignored even if specified. Specify a space.
servers	-	-	No	Specify the server.
server	-	0 or more	No	Server information for the number of servers that exist.
no	integer	0 - 29	Yes	This item specifies a serial number for the server that is unique within the template.
imageId	string	1 - 32 characters	Yes	The image ID of an image to be deployed on the server. It is necessary to register the image information in advance and check the image ID.
[ useDataDisk ]	string	List	Yes	Specify true if a data disk is included in the image. Select one of the following values: - "true": Data disk used - "false": Data disk not used If nothing was specified, the setting will be "false".
name	string	Up to 85 characters	Yes	The name of the server. This is a name that is used to distinguish servers within the template, and is not the host name.
serverType	string	1 - 32 characters	Yes	The name of the L-Server template to be selected as the default template from amongst the L-Server templates that have been set up using Resource Management. Specify the same value as was specified in the image information file.
[ pool ]	string	1 character or more	Yes	The resource name (resource name in Resource Management) of the deployment destination pool of the server. Specify the resource name of the VM pool for virtual, and of the server pool for physical. Specify resource names starting with a forward slash "/". (Example) /vmPool_2 If this is omitted, the first pool registered with Resource Management will be selected. This can also be modified during deployment.
[ vmHostId ]	string	1 - 256 characters	Yes	Specify the resource ID of the VM host when directly specifying the VM host to which the server has been deployed. If omitted, a VM host from the VM pool specified in "pool" is selected automatically. If "pool" has been omitted, do not specify. This can only be specified if the server virtualization software is VMware or OVM for SPARC.
[ vmHostName ]	string	1 - 256 characters	Yes	Specify the name of the VM host when directly specifying the VM host to which the server has been deployed. If "pool" has been omitted, do not specify. This must be specified if vmHostId was specified. This can only be specified if the server virtualization software is VMware or OVM for SPARC.
[ sparePool ]	string	1 character or more	Yes	The resource name (resource name in Resource Management) of the spare server pool for when a physical server fails.
[ storagePool ]	string	1 character or more	Yes	The resource name (resource name in Resource Management) of the storage pool at the server deployment destination. Specify resource names starting with a forward slash "/". (Example) /StoragePool_2 If omitted, the first storage pool registered with Resource Management will be selected. This can also be modified during deployment. Cannot be specified when the server virtualization software is OVM for x86. The storage pool is selected automatically.
[ diskResourceId ]	string	1 - 256 characters	Yes	Specify the resource ID of an existing disk when directly specifying an existing disk as the system disk. This can only be specified if the server virtualization software is RHEL-KVM or OVM for SPARC.
[ diskResourceName ]	string	1 - 32 characters	Yes	Specify the resource name of an existing disk when directly specifying an existing disk as the system disk. This can only be specified if the server virtualization software is RHEL-KVM or OVM for OVM for SPARC. This must be specified if diskResourceId was specified.
[ virtualStorageId ]	string	1 - 256 characters	Yes	Specify the resource ID of the virtual storage when directly specifying the virtual storage to which the system disk has been deployed. If omitted, a disk from the storage pool specified in "storagePool" is selected automatically. If "storagePool" has been omitted, do not specify. This can only be specified if the server virtualization software is VMware.
[ virtualStorageName ]	string	1 - 91 characters	Yes	Specify the name of the virtual storage when directly specifying the virtual storage to which the system disk has been deployed. If "storagePool" has been omitted, do not specify. This must be specified if virtualStorageId was specified. This can only be specified if the server virtualization software is VMware.
[ powerPriority ]	integer	1 - 256	Yes	This setting indicates the priority level when performing batch power supply operations within either the L-Platform or within the tenant. The smaller the value, the higher the priority level. When omitted, the value is set to 128.
[ nicgroups ]	-	-	No	The redundant network interface card (NIC) groups.
[ management ]	integer	1 or more	Yes	The index of the NIC group to be specified in the control NIC. This is mandatory if "management" under "vnics" has been omitted. "management" cannot be set in both "nicgroup" and "vnics".
nicgroup	-	-	No	Specify as many <nicgroup> tags as there are redundant network interface card (NIC) groups. A nicgroup without an NIC cannot be defined.
index	integer	1 - 99	Yes	A number for the NIC group that is unique within the server.
networkId	string	1 - 20 characters	Yes	The network ID of the segment to which the NIC group is to connect.
vnics	-	-	No	The network interface card (NIC).
[ management ]	integer	1 or more	Yes	The NIC number specified in the control NIC. Specify the value specified in <no> under <vnic>. When <nicgroups> is specified, this item is mandatory in the case of omitting <management> under <nicgroups>. One of the NIC/NIC Groups defined in either <nicgroup> or <vnic> must be specified. It is not possible to specify a NIC whose <group> is specified. It is not possible to assign management settings to both <nicgroup> and <vnics>.
[ vnic ]	-	1 or more	No	As many <vnic> tags as there are NICs.
no	integer	1 - 99	Yes	This item specifies a serial number for the NIC that is unique within the server.
networkId	string	1 - 20 characters	Yes	The segment ID for the segment that the NIC connects to. Specify the value that was specified in the vnet id.
[ group ]	integer	1 - 99	Yes	If grouping is performed for this NIC, the index number of the NIC group (value of "index" in "nicgroup"). If this is omitted, no grouping will be performed.
vdisks	-	-	No	The extension disk for the server.
[ vdisk ]	-	0 or more	No	As many <vdisk> tags as there are disks. These tags are required only when extension disks exist. - If the server virtualization software is Hyper-V, specify up to three. - If the server virtualization software is OVM for SPARC, only existing disks can be specified. - Cannot be specified if the server virtualization software is Solaris Zones, and the server is managed by BladeLogic.
[ no ]	integer	1 or more	Yes	A serial number for the disk that is unique within the server. If it is a data disk that is included in the image, specify the same value as is output to the <no> tag with the cfmg_listvmimage command.
[ diskSize ]	decimal	In decimal notation, to one decimal place (0.1 - 99999.9)	Yes	The size of the disk. Specify this value in GB. If it is a data disk that is included in the image, specify the same value as is output to the <diskSize> tag with the cfmg_listvmimage command.
[resourceId]	string	1 - 256 characters	Yes	The resource ID of an existing disk if an existing disk is to be connected. Make sure to specify it when the server virtualization software is OVM for SPARC.
[ resouceName ]	string	1 - 32 characters	Yes	The disk resource name of an existing disk if an existing disk is to be connected. Make sure to specify it when the server virtualization software is OVM for SPARC.
[ storagePool ]	string	1 character or more	Yes	The resource name (resource name in Resource Management) of the storage pool at the extension disk deployment destination. Specify resource names starting with a forward slash "/". (Example)/StoragePool_2 Cannot be specified when the server virtualization software is OVM for x86. The storage pool is selected automatically.
[ virtualStorageId ]	string	1 - 256 characters	Yes	Specify the resource ID of the virtual storage when directly specifying the virtual storage to which the data disk has been deployed. If omitted, a disk from the storage pool specified in "storagePool" is selected automatically. If "storagePool" has been omitted, do not specify. This can only be specified if the server virtualization software is VMware.
[ virtualStorageName ]	string	1 - 91 characters	Yes	Specify the name of the virtual storage when directly specifying the virtual storage to which the data disk has been deployed. If "storagePool" has been omitted, do not specify. This must be specified if virtualStorageId was specified. This can only be specified if the server virtualization software is VMware.
[ contained ]	string	List	Yes	Specify true if the data disk is included in the image. Select one of the following values: - "true": Disk contained in image - "false": New disk If nothing was specified, the setting will be "false".

The meanings of the symbols in the Mandatory column are as follows:
Yes: If a tag was specified, you must specify the value.
Optional: Value can be omitted.
No: A value setting is not required. Tag only specification.