Top
ServerView Resource Orchestrator Cloud Edition V3.1.1 Reference Guide (Command/XML)
ServerView
Part 2 File Reference > Chapter 15 XML Files > 15.18 L-Platform Template > 15.18.2 Image Information
PreviousNext

15.18.2 Image Information

This section explains the image information in detail.

15.18.2.1 Overview of Image Information

Image information files are XML documents that list the configuration information for cloning images.

Create and register a separate image information file for each cloning image.

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

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

[Windows Manager]
Installation_folder\RCXCFMG\templates\images\
[Linux Manager]
/opt/FJSVcfmg/templates/images/

Refer to "15.18.2.2 File Information Details" for a description of cloning items (tags).

The software ID (which was assigned when the software information was registered) must be entered as the software ID in the image information.

15.18.2.2 File Information Details

Image information files use the following XML format:

<?xml version="1.0" encoding="UTF-8" ?>
<image version="2.0">
	<id>[Cloning image ID]</id>
	<name>[Image information name]</name>
	<resourceId>[Resource ID]</resourceId>
	<imageName>[Cloning image name]</imageName>
	<ownerOrg>[Owner (tenant)]</ownerOrg>
	<ownerUser>[Owner (user)]</ownerUser>
	<publicCategory>[Public category]</publicCategory>
	<serverCategory>[Sever category]</serverCategory>
	<serverApplication>[Server application]</serverApplication>
	<serverType>[Default server type]</serverType>
	<cpuBit>[CPU bit number]</cpuBit>
	<sysvolSize>[System disk size]</sysvolSize>
	<maxCpuPerf>[Maximum CPU performance]</maxCpuPerf>
	<numOfMaxCpu>[Maximum number of CPUs]</numOfMaxCpu>
	<maxMemorySize>[Maximum memory size]</maxMemorySize>
	<numOfMaxDisk>[Maximum number of data disks]</numOfMaxDisk>
	<maxDiskSize>[Maximum data disk size]</maxDiskSize>
	<maxSysvolSize>[Maximum system disk size]</maxSysvolSize>
	<numOfMaxNic>[Maximum number of NICs]</numOfMaxNic>
	<initialPassword>[Initial password]</initialPassword>
	<icon>[Icon type]</icon>
	<virtualization>[Image type]</virtualization>
	<virtualizationMethod>[Virtualization method]</virtualizationMethod>
	<filterPool>[Filter string]</filterPool>
	<dataDiskFlag>[Data disk use]</dataDiskFlag>
	<softwares>
		<software>
			<id>[Software ID]</id>
			<order>[Display order]</order>
			<patches>
				<patch>
					<id>[Patch ID]</id>
					<locale>
						<lcid>[Locale ID]</lcid>
						<componentName>[Component name]</componentName>
						<description>[Description]</description>
					</locale>
					...
				</patch>
				...
			</patches>
		</software>
		...
	</softwares>
	<vdisks>
		<vdisk>
			<no>[Disk number]</no>
			<diskSize>[Disk capacity]</diskSize>
		</vdisk>
		...
	</vdisks>
</image>

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

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

Tag cloning names in square brackets [ ] can be omitted.

Tag name

Format

Setting range

Description

Mandatory

Settings

id

ASCII string

1 to 32 characters

The cloning image ID.

Yes

When image information is updated, cloning image ID to be updated is specified.
When new image information is created, specify nothing.

name

ASCII string

Up to 85 characters

The name of image information is specified.

Yes

resourceId

ASCII string

1 to 256 characters

The resource ID.

Yes

Specify the resource ID that was confirmed using the cfmg_listvmimage command.

imageName

ASCII string

1 to 32 characters

The cloning image name.

Yes

Specify the cloning image ID that was confirmed using the cfmg_listvmimage command.

ownerOrg

ASCII string

Fixed value

The tenant name to which the cloning image belongs.

Yes

The value is fixed as "cfmgadm".

ownerUser

ASCII string

Fixed value

The user ID of the user registering the cloning image.

Yes

The value is fixed as "cfmgadm".

publicCategory

ASCII string

List

This item selects the cloning image category.

Yes

Select one of the following options:
- "PUBLIC": Show the cloning image to all users.
- "PRIVATE": Show the cloning image to the owner (user) only. This can only be specified if the replication function is being used. It cannot be specified at template creation.

serverCategory

ASCII string

Fixed value

This item selects the category of the server included in the cloning image.

Yes

The value is fixed as "GENERAL".
The server is a generic server.

serverApplication

ASCII string

List

The usage of the server included in the cloning image.

Yes

One or more of the following options can be selected:
- "WEB": Web server
- "AP": Application server
- "DB": DB server
If multiple options are specified, separate each option with a forward slash ("/"). Options can be specified in any order.

(Example) WEB/AP, AP/WEB/DB, etc.

serverType

ASCII string

0 to 32 characters

The server type.

Optional

If this cloning image has been used, specify the name of the L-Server template that is to be selected as the default from amongst the L-Server templates that have been set using Resource Management.

cpuBit

integer

List

The CPU bit count of the server included in the cloning image.

Yes

Select one of the following options:
- 32: 32 bit
- 64: 64 bit

sysvolSize

decimal

In decimal notation, to one decimal place
(0.1 to 99999.9)

The size of the system disk for the server to be deployed.

Yes

Specify this value in GB.
The value must be greater than the size of the system disk included in the cloning image.

[ maxCpuPerf ]

decimal

In decimal notation, to one decimal place
(0.1 to 99999.9)

The maximum specifiable CPU performance for the server.

Yes

Specify the maximum CPU performance in GHz that can be specified for the server in Manager View.

[ numOfMaxCpu ]

integer

1 to 99

The maximum specifiable number of CPUs for the server.

Yes

Specify a value up to the maximum number of CPUs that the user can specify in Manager View.

[ maxMemorySize ]

decimal

In decimal notation, to one decimal place
(0.1 to 99999.9)

The maximum specifiable memory size for the server.

Yes

Specify in GB the maximum memory size that can be specified for the server in Manager View.
If the server virtualization software is RHEL-KVM and memory hot plug is enabled in a VM-specific information definition file, ensure that you specify a value less than or equal to max_definable_memory_size.

numOfMaxDisk

integer

0 to 99

The maximum number of extension disks that can be added to the server.

Yes

Specify a value up to the maximum number of disks that can be specified.

[ maxDiskSize ]

decimal

In decimal notation, to one decimal place
(0.1 to 99999.9)

The maximum specifiable disk size for extension disks.

Yes

Specify a value in GB, up to the maximum disk size that can be specified for extended disks.

[ maxSysvolSize ]

decimal

In decimal notation, to one decimal place
(0.1 to 99999.9)

The maximum specifiable disk size for system disks.

Yes

Specify a value in GB up to the maximum disk size that can be specified for system disks.

numOfMaxNic

integer

1 to 99

The maximum number of network interface cards (NICs) that can be added to the server.

Yes

Specify a value up to the maximum number of NICs that can be specified.

initialPassword

UTF-8 string

Up to 85 characters

The initial password for the operating system.
The automatically generated password can be set on Windows and Solaris if this is omitted.

Yes

Specify the password for the following user.
[Windows]
Specified password is set to OS. If this setting is omitted, an automatically-generated password will be set in the OS.
- When the server virtualization software is VMware or Hyper-V,
the local administrator account password will be configured.
- When the server virtualization software is RHEL-KVM, the local administrator account password will be configured.
The operating systems that can be specified in the guest OS are Windows Server 2008 R2.
Specify the same password as the one that has been set in the cloning image.
- When the server virtualization software is OVM for x86
The local administrator account password will be configured. The password specified here is not set in the OS. Specify the same password as the one that has been set in the cloning image.

- When the server virtualization software is Citrix XenServer
Specify the password for the local administrator account. When using Linux Manager or using Windows Manager and a cloning image where "OS setting" are disabled, the password specified here is not set in the OS. Please specify the same password set in the cloning image.
Refer to "17.5.1 Collecting and Registering" in the "User's Guide for Infrastructure Administrators (Resource Management) CE" for information on "OS setting" when collecting cloning images.

[Linux]
Specify the super user password.
The password specified here is not set to OS.
Please specify the same password as the one that has been set in the cloning image.

[Solaris]
- When the server virtualization software is Solaris zone
Specify the superuser password. The specified password is set in the OS. If this setting is omitted, an automatically-generated password will be set in the OS.
- When the server virtualization software is OVM for x86
Specify the superuser password. The password specified here is not set in the OS. Specify the same password as the one that was set in the cloning image.

[Other]
Specify the password for default users (such as the super user), that can log in. The password specified here is not set to OS.
Please specify the same password as the one that has been set in the cloning image.

icon

UTF-8 string

List

The icon of the server included in the cloning image.

Yes

Select an icon from the following list that corresponds to serverApplication:
- unit_tag_web.png: WEB
- unit_tag_ap.png: AP
- unit_tag_db.png: DB
- unit_tag_webap.png: WEB/AP
- unit_tag_webdb.png: WEB/DB
- unit_tag_apdb.png: AP/DB
- unit_tag_webapdb.png: WEB/AP/DB
- unit_tag_blank.png: Other

virtualization

ASCII string

List

The virtual or physical cloning image type.

Yes

Select one of the following options:
- "hvm": Virtual
- "pv": Physical

[ vitualizationMethod ]

ASCII string

List

The cloning image virtualization type.

Optional

Specify only if the server virtualization software is OVM for x86.
Select one of the following options:
- "pv": para virtualization
- "hvm": full virtualization
- "pvhvm": full virtualization + PV driver

[ filterPool ]

UTF-8 string

1 to 85 characters

The string for filtering the VM pool choices for the cloning image.

Optional

[ dataDiskFlag ]

ASCII string

List

Specify true if a data disk is included in the image.

Yes

Select one of the following:
- "true": Data disk exists
- "false": Data disk absent
If nothing was specified, the setting will be "false".

softwares

-

-

The software installed on the server.

No

This tag is required.

software

-

1 or more

Specify as many <software> tags as there are software programs installed on the server.

No

id

ASCII string

1 to 32 characters

The software ID of the software.

Yes

Specify the software ID that was displayed in the registration results obtained using the cfmg_addsoft command or in the output results obtained using the cfmg_listsoft command.

order

integer

0 or more

The order in which software programs are displayed.

Yes

Specify the software in order, starting from "0". Make sure that the operating system is listed first.

patches

-

-

Patch information for the software.

No

[ patch ]

-

0 or more

Specify as many <patch> tags as there are patches or updates that need to be applied.

No

These tags are required only when patch information exists.

id

ASCII string

1 to 32 characters

The patch ID for the patch.

Yes

Specify the update number, etc.
The same patch ID cannot be specified multiple times for one software ID.

locale

-

1 or more

Patch information for each locale.

No

lcid

ASCII string

Fixed value

The locale for patch information.

Yes

The value is fixed as "en"

componentName

UTF-8 string

Up to 85 characters

The name of the component to which the patch is applied.

Optional

Specify an empty string if the patch specification does not include the concept of components.
If patch information that matches all of the software ID, patch ID, and locale is already registered, it will be updated by information that is registered later.

description

UTF-8 string

Up to 85 characters

A description for the patch.

Optional

If patch information that matches all of the software ID, patch ID, and locale is already registered, it will be updated by information that is registered later.

[ vdisks ]

-

-

Specify the data disk that is included in the image.

No

vdisk

-

1 or more

Specify for each of the data disks included in the image.

Yes

no

integer

1-99

Specify the number of the disk to be connected to the L-Server.

Yes

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 to 99999.9)

Specify the size of the disk.

Yes

Specify the same value as is output to the <diskSize> tag with the cfmg_listvmimage command.

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.

PreviousNext
Copyright 2010-2013 FUJITSU LIMITED