9.13 cfmg_listvmimage (Displaying a Cloning Image List)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\cfmg_listvmimage - Displaying a Cloning Image List

[Linux Manager]
/opt/FJSVcfmg/bin/cfmg_listvmimage - Displaying a Cloning Image List

Synopsis

cfmg_listvmimage [-utf8]

Functional Description

This command outputs an XML list of the cloning images that have been registered with Resource Management.

All cloning images that have been registered with Resource Management will be output in the following format:

<?xml version="1.0" encoding="UTF-8"?>
<images>
	<image>
		<id>[Resource ID]</id>
		<name>[Cloning image name]</name>
		<comment>[Comment]</comment>
		<type>[Cloning image type]</type>
		<version>[Cloning image version]</version>
		<time>[Date and time when the cloning image was created]</time>
		<serverType>[Server type]</serverType>
		<virtualizationMethod>[Virtualization method]</virtualizationMethod>
		<dataDiskFlag>[Data disk use]</dataDiskFlag>
		<vdisks>
			<vdisk>
				<no>[Disk number]</no>
				<diskSize>[Disk capacity]</diskSize>
				<diskAttributes>[Disk format]</diskAttributes>
			</vdisk>
			...
		</vdisks>
	</image>
	...
</images>

Note

If image information registered with Resource Management does not exist, information will be output in the following format:

<?xml version="1.0" encoding="UTF-8"?>
<images />

Options

-utf8 (optional): This option outputs the list in UTF-8 format.
This option is only enabled for Windows Manager versions.
If this option is omitted, the list is output in ISO-8859-1 format.
For Linux Manager versions, the list is output in UTF-8 irrespective of this option.

Requirements

Permissions: Infrastructure administrator with OS administrator privilege

Location: Admin server

Example

> cfmg_listvmimage
<?xml version="1.0" encoding="Windows-31J"?>
<images>
	<image>
		<id>ST01-M_896</id>
		<name>RHELx64_IMG</name>
		<comment />
		<type>cloning</type>
		<version>1</version>
		<time>2010-11-17-15:20:17+09:00</time>
		<serverType>extra_small</serverType>
		<virtualizationMethod>pv</virtualizationMethod>
		<dataDiskFlag>true</dataDiskFlag>
		<vdisks>
			<vdisk>
				<no>0</no>
				<diskSize>20.0</diskSize>
				<diskAttributes>thin</diskAttributes>
			</vdisk>
			<vdisk>
				<no>1</no>
				<diskSize>40.0</diskSize>
				<diskAttributes>thin</diskAttributes>
			</vdisk>
		</vdisks>
	</image>
</images>

Remarks: Encoding will be "UTF-8" with the Linux Manager.

Exit Status

This command returns the following values:

0: The command executed successfully.

non-zero: An error has occurred.