Hitachi

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


jcfexport

Organization of this page

Function

This command outputs the hierarchy configuration (IM configuration) of the system managed by IM Configuration Management, host information, and definition information.

When you execute this command, the three types of information (host, system hierarchy, and profiles) that have been managed by IM Configuration Management before import processing are all deleted and then the specified information is imported.

To use this command, IM Configuration Management Service must be running. This command cannot be executed while the jcfimport command is executing. A maximum of five commands can be executed concurrently.

Format

jcfexport        [-h logical-host-name]
                 [-f]
                 -o directory-name
                 [-m | -r | -c | -g | -a]

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

-h logical-host-name

When you are operating in a cluster system, this option specifies the logical host name of the host that executes the command. If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable is not specified, the physical host name is assumed. If you are not using a cluster system, specification of this option is not needed.

-f

Specifies that the file is to be overwritten if the specified directory already contains a file with the same name as the export file. If this option is omitted and the export target already contains a file with the same name, the information is not exported.

-o directory-name

Specifies the name of the directory to which the export data is to be output, expressed as an absolute path or a path relative to the location where the command is executed. This option is mandatory. If the path contains a space, enclose the entire path in double-quotation marks (").

-m

Specifies that only the host information is to be exported. The exported information is output to the host input information file (host_input_data.csv).

This option cannot be specified together with the -r, -c, -g, or -a option. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.

-r

Only host information and remote authentication information are exported.

This option cannot be specified together with the -m, -c, -g, or -a option. If specified in such a case, an invalid argument error results. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.

-c

Specifies that only the host information and the system hierarchy information is to be exported. The host information is output to the host input information file (host_input_data.csv), and the system hierarchy is output to system_tree_information.txt.

This option cannot be specified together with the -m, -r, -g, or -a option. If specified in such a case, an invalid argument error results. If you omit all of the -m, -c, and -a options, the -a option is assumed. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.

-g

Only host information, business group information, and monitoring group information are exported.

This option cannot be specified together with the -m, -r, -c, or -a option. If specified in such a case, an invalid argument error results. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.

-a

Specifies that all three types of information are to be exported. The exported information is output to data_information.txt. The host information is output to the host input information file (host_input_data.csv), the system hierarchy is output to system_tree_information.txt, and the definition information is output to the following files directly under directory-specified-in--o-option\definition_files\host-name\product-name:

  • Forwarding settings file (forward)

  • The action definition file of a log file trap (an arbitrary file)

  • Log file trap startup definition file (jevlog_start.conf)

  • Event log trapping function operation definition file (ntevent.conf)

  • Location action definition file (jbslcact.conf)

This option cannot be specified together with the -m, -r, -c, or -g option. If specified in such a case, an invalid argument error results. If all of the -m, -r, -c, -g, and -a options are omitted, the -a option is assumed.

Notes

For hosts where no profile configuration file is collected, there is no data to be exported (and no directory is created).

Return values

0

Normal termination

4

Invalid option

8

Server cannot be connected

12

Memory shortage occurred

16

Invalid permission

20

Error, such as a file error, invalid path, or file already exists

21

Upper limit for number of concurrent executions reached

24

An input/output error occurred

120

System error occurred

124

Terminated due to other error

201 or greater

JavaVM start error occurred

Example

Export all IM Configuration Management information to the directory under c:\temp:

jcfexport -o c:\temp