![[Contents]](FIGURE/CONTENT.GIF)
![[Index]](FIGURE/INDEX.GIF)
![[Back]](FIGURE/FRONT.GIF)
![[Next]](FIGURE/AFTER.GIF)
Job Management Partner 1/Integrated Management - Manager Administration Guide
If necessary, you can edit the management information of IM Configuration Management that has been output (exported) from a host, and you can input (import) the edited information onto a different host. You use thejcfimport command for the import operation, but you cannot import collected host information.
Since importing will change the data held by IM Configuration Management, we recommend that you back up the data before executing the import operation.
This subsection explains the system configuration information that is imported by the jcfimport command.
- Organization of this subsection
- (1) Host information
- (2) System hierarchy information
- (3) Profile information
(1) Host information
In the case of manually-entered information, the content of the export file (host_input_data.csv) is imported.
The table below shows the items that are imported from the export file (host_input_data.csv) for manually-entered information, and the input range for each item.
Table 8-7 Host information that is imported (manually-entered information)
Item Input range Required/Optional Default Host A character string of up to 255 bytes may be input. Permitted characters are alphanumeric characters and the hyphen (-), excluding control codes. Required# -- Host name list A maximum of four host names may be input. Permitted characters are alphanumeric characters and the hyphen (-), excluding control codes. Optional Blank Comment A character string of up to 80 bytes may be input. Optional Blank Host type physical, logical, virtual, or unknown may be input. Optional physical Active host A character string of up to 255 bytes may be input. Permitted characters are alphanumeric characters and the hyphen (-), excluding control codes. Optional Blank Standby host A maximum of four host names may be input. For each host name, a character string of up to 255 bytes may be input. Permitted characters are alphanumeric characters and the hyphen (-), excluding control codes. Optional Blank VMM host A character string of up to 255 bytes can be input. Permitted characters are alphanumeric characters and the hyphen (-), excluding control codes. Optional Blank
- Legend:
- --: There is no default value.
- #
- If the required item is not specified, an error occurs. If an optional item is not specified, the default value is imported.
If characters that do not have code compatibility or model-dependent characters are used in the host information, these characters may become garbled when they are imported.
If any of the conditions listed below applies to the export file (host_input_data.csv) for manually-entered information, an error occurs and the file is not imported.
- A host name is duplicated.
- A host name is longer than 255 bytes.
- The number of hosts exceeds the number supported (1,024 if the IM database size is S or M, and 10,000 if the size is L).
- A value outside the permitted input range is specified.
- The number of input data columns is insufficient (the number of commas is insufficient).
- The host name described for the active host, standby host, or VMM host does not exist in the host information file.
- A value other than physical or virtual is specified as the host type for the active host or standby host.
- A value other than physical is specified as the host type for the VMM host.
- A value other than physical, logical, virtual, or unknown is specified as a host type.
If a host has the same host name as the import destination host, that host is not registered in IM Configuration Management as a managed host after the export file (host_input_data.csv) for manually-entered information has been imported.
(2) System hierarchy information
The content of the export file (system_tree_information.txt) for the system hierarchy information is imported.
If any of the conditions listed below applies to the content of the export file (system_tree_information.txt) for the system hierarchy information, an error occurs and the file is not imported.
- The same host is described on multiple lines (the managed host has multiple higher hosts).
- The host configuration is looped.
- The host name specified for the managing host is not enclosed in square brackets [ ] ("]" is missing).
- No host name is specified for the managing host.
- More than 10,000 hosts are defined.
After the export file (host_input_data.csv) for host information (manually-entered information) or the export file (system_tree_information.txt) for the system hierarchy information is edited, the host name specified in the export file (system_tree_information.txt) for the system hierarchy information may not be specified in the export file (host_input_data.csv) for host information (manually entered-information) in some cases. In such cases, after the export file (system_tree_information.txt) for the system hierarchy information is imported, an import warning message is displayed and the undefined host is automatically registered in IM Configuration Management as a managed host.
When you are trying to import the system hierarchy information, if the export file (system_tree_information.txt) for the system hierarchy information does not exist, an error message is displayed and the importing operation is halted.
(3) Profile information
The content of the export files for the profile information is imported. The table below shows the export files for the profile information that is imported.
Table 8-8 Export files for the profile information that is imported
Profile information Export file name Event Forwarding Settings File forward Event Log-Trap Action Definition File ntevent.conf Local Action Execution Definition File jbslcact.conf When profile information is imported, its destination is determined using the directory name under definition_files directory. The directory name on the hierarchy one step below the definition_files directory is read as a host name, and the directory name on the hierarchy two steps below the definition_files directory is read as a product name. The file stored in each directory is registered on the applicable host as settings information. Consequently, if you change the host name in the export file (host_input_data.csv) for host information (manually-entered information), you must also change the directory name. If you do not change it, the profile information cannot be imported.
The profile information file is loaded as a character code described in encode of the export file (data_information.txt) for the export data information. For this character code, the environment variable LANG of the OS of the server that executed the export operation is set. When you import profile information, make sure that the character code described in the export file (data_information.txt) matches the character code of the profile information file.
If characters that do not have code compatibility or model-dependent characters are used in the host information, these characters may become garbled when they are imported.
If more than 10,000 hosts are defined, an error occurs and no file is imported.
If the export file for the profile (configuration file) contains an unsupported product or unsupported profile, these are ignored and processing continues.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.