jcfcolvmvc
- Organization of this page
Function
Obtains virtualization configuration information from vCenter, and outputs it to a virtualization configuration information file.
For details about 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
jcfcolvmvc
[-m communication-type]
-u user-ID
[-p password]
-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
- -m communication-type
-
Specifies the method of communication with vCenter.
When https is specified, https communication is used for communication with vCenter. When http is specified, http communication is used for communication with vCenter.
If this option is omitted, https communication is used.
- -u user-ID
-
Specifies the user ID of a connection-target vCenter account.
Specify a character string with a maximum of 255 bytes, excluding control characters, for the user ID.
- -p password
-
Specifies the password for the user ID that is specified in the -u option.
Specify a character string with a maximum of 255 bytes, excluding control characters, for the password.
If this option is omitted, the command assumes that there is no password.
- -c host-name [host-name]
-
Specifies the names of the hosts where vCenter 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 name of the virtualization configuration information file that stores the configuration information obtained from vCenter in relative path or absolute path format. 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
|
Item |
Output value |
|---|---|
|
Identification character string for a virtualization configuration information file |
#VM |
|
File format version |
090100 |
|
Character encoding |
UTF-8 fixed |
|
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 |
|
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:
|
|
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,ESX1,,, Vm2,ESX1,,, ESX1,,ESX,4.0,vCenter1 vCenter1,, vCenter,2.0,