Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager Command, Definition File and API Reference


jcfcolvmvirtage

Organization of this page

Function

This command acquires virtualization configuration information from Hitachi Compute Blade logical partitioning feature and outputs it to a virtualization configuration information file.

For the prerequisite conditions for executing this command, see 3.3.1(1) Prerequisites for managing a virtualization configuration in the JP1/Integrated Management 2 - Manager Configuration Guide.

Format

jcfcolvmvirtage
          -c host-name [host-name]
          -o output-file-name

Execution permission

In Windows: Administrator permissions (If the Windows UAC feature is enabled, the command is executed from the administrator console.)

In UNIX: Superuser permissions

Storage directory

In Windows:

Manager-path\bin\imcf\

In UNIX:

/opt/jp1imm/bin/imcf/

Arguments

-c host-name [host-name]

Specifies the name of the host where JP1/SC/CM that manages Hitachi Compute Blade logical partitioning feature is running. For a host name, specify a maximum of 255 characters. You can specify multiple host names by separating them with the space character or the tab delimiter.

-o output-file-name

Specifies the virtualization configuration information file that stores the configuration information obtained from JP1/SC that manages Hitachi Compute Blade logical partitioning feature in relative path or absolute path format. This option cannot be omitted. If the path contains a space, enclose the entire path in double-quotation marks (").

Return values

0

Normal termination#1

1

Argument error

2

Insufficient memory

3

JavaVM start error occurred

4

Execution permission error

5

The command was not executed from the administrator console

6

Output file already exists

7

Acquisition of virtualization configuration information failed#2

8

Input/output error

99

Other error

#1

The command terminates normally even when some of the virtual configuration information has not been acquired.

#2

The command outputs a return value if it is unable to acquire virtualization configuration information from any host.

Format of the virtualization configuration information file

Table 1‒25: Header information (line 1)

Item

Output value

Identification character string for a virtualization configuration information file

#VM

File format version

090100

Character encoding

UTF-8 fixed

Table 1‒26: Header information (line 2)

Item

Output value

Host name

Host_name

VMM host name

VMM_host_name

Virtualization management type

Virtual_manager_type

Virtualization management product version

Manager_version

Virtualization configuration management host

Virtual_host_manager

Table 1‒27: Output items (From line 3)

Item

Description

Host name

Host name

VMM host name

Name of the host where virtualization environment software runs.

In the case of a VMM host with no guest OS, the virtual host name field is blank and only the VMM host name is set.

Virtualization management type

Type of product that manages the virtualization configuration:

  • For JP1/SC/CM: JP1/SC/CM

  • For Hitachi Compute Blade logical partitioning feature: Virtage

Virtualization management product version

Version of the product that manages a virtualization configuration

Virtualization management former host name

Name of the host that manages a VMM host

Example output

#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,VIRTAGE1,,,
Vm2, VIRTAGE1,,,
VIRTAGE1,,Virtage,
SCCM1,VIRTAGE1,JP1/SC/CM,,