jslmmgrimport (imports service monitor information)
- Organization of this page
Function
This command imports service monitor information that was exported by the jslmmgrexport command.
You can import the data that was exported for a monitored service by the jslmmgrexport command as is or by specifying the name of a monitored service and the name of the service group to which the monitored service is to belong. If data was exported for all monitored services, you import that data without specifying a monitored service name or service group name.
For both import methods, the command processing depends on whether the name of an exported monitored service or the name of an exported service group to which the monitored service belongs that is contained in the data to be imported already exists at the import destination.
The following table describes the processing when service monitor information is imported.
No. |
Data to be imported |
Whether the name of a monitored service or the name of the service group to which the monitored service belongs that is contained in the data to be imported already exists at the import destination |
|
---|---|---|---|
Exists# |
Does not exist |
||
1 |
Monitored service management information |
Data is imported according to the specified -m option. |
Target data is imported as is. |
2 |
Performance data and list of events |
Data is imported according to the specified -p option. |
A monitored service added by import processing is applied to the windows at the time of login.
If you need to change definition information for a monitored service because the IP address of the Web server that provides the monitored service or the IP address of ITSLM - UR has changed, you can edit the definition information in the imported data. However, if the imported data was created by exporting information for all monitored services, the definition information cannot be edited.
Execute this command while the following ITSLM - Manager services are running:
-
JP1/ITSLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0)
-
JP1/ITSLM - Manager Service (service name: JP1_ITSLM_MGR_Service)
In a cluster system, execute this command on the active server (if the command is executed on the standby server, an error will result).
jslmmgrimport is set as the identifier in the messages this command outputs to the message logs.
For details about the message logs, see 7.2.3 Message logs.
For details about the messages displayed during command execution, see 11.3 Messages.
Format
jslmmgrimport -i import-data-file-name [ -g service-group-name -s service-name ] [ -m [ IP-address-of-Web-server IP-address-of-ITSLM-UR ] ] [ -p ]
Execution permission
User account that belongs to the OS's Administrators group
Storage folder
ITSLM-Manager-installation-folder\mgr\bin\
Arguments
-i import-data-file-name
Specifies as an absolute path the name of the file from which data is to be imported. Specification in UNC is not supported.
If the specified file does not exist, is not accessible, or does not contain valid data exported by the jslmmgrexport command, an error results.
-g service-group-name
Specifies the name of the service group to which the target monitored service belongs.
If both this option and the -s option are omitted, the command uses the appropriate value from the data that is to be imported as is.
If the data to be imported is for all monitored services, do not specify either the -s option or the -g option. If these options are specified in such a case, an error results.
You can specify for the name of the service group a name that differs from the one used for the export processing. However, the specified name must be a string of characters that does not include the characters ", /, [, ], ;, :, |, =, ,, +, ?, <, >, space, tab, machine-dependent characters, and control characters. If the specified name does not observe this limitation, an error results. Also, a name beginning with a hyphen (-) cannot be specified.
-s service-name
Specifies the name of the target monitored service.
This option can be omitted together with the -g option. If this option is omitted, the command uses the value from the data that is to be imported as is.
If the data to be imported is for all monitored services, do not specify either the -s option or the -g option. If these options are specified in such a case, an error results.
You can specify for the name of the monitored service a name that differs from the one used for the export processing. However, the specified name must be a string of no more than 64 characters that does not include the characters ", ,, ', \, space, tab, machine-dependent characters, and control characters. If the specified name does not observe this limitation, an error occurs. Also, a name beginning with a hyphen (-) cannot be specified.
-m
Specifies that if the import target already contains a monitored service with the same name as in the data to be imported, the imported data is to overwrite the management information for that monitored service.
If the import target contains a Web transaction with the same name as in the data to be imported, the display order in effect at the import target remains in effect. If the import target does not contain a Web transaction with the same name, the imported data is added following the Web transactions already registered at the import target.
If this option is omitted and the import target already contains both the name of the service group to which the monitored service specified in the -g option belongs and the name of the monitored service specified in the -s option, the command results in an error.
An error also occurs if import processing will result in the number of Web transactions for a service exceeding 10 (which is the maximum value).
This option is also used to change in the monitored service management information the IP address of the Web server that provides the monitored service and the IP address of ITSLM - UR. The following shows the specification method.
-
IP address of Web server
Specify the new IP address of the Web server that will be providing the monitored service. The specification format is as follows:
XXX.XXX.XXX.XXX
- Legend:
-
XXX: A number from 0 through 255
If the value is specified in any other format, an error results.
-
IP address of ITSLM - UR
Specify the new IP address of ITSLM - UR. The specification format is as follows:
XXX.XXX.XXX.XXX
- Legend:
-
XXX: A number from 0 through 255
If the value is specified in any other format, an error results.
When data exported for multiple monitored services is to be imported or the number of Web transactions per monitored service exceeds 10 as a result of import processing, specifying this option results in an error.
A service in a system monitoring configuration cannot be imported as a service in a service monitoring configuration by specifying the IP address of the Web server and the IP address of ITSLM - UR. Similarly, a service in a service monitoring configuration cannot be imported as a service in a system monitoring configuration.
-p
Specifies that service performance is to be imported.
When this option is specified and the import target contains a monitored service whose name is the same as a name in the data to be imported, this option overwrites with the imported data the performance of the existing monitored service within the range of the service performance information contained in the imported data. When overwrite import processing is performed, only the data that is within the retention period is imported based on the data with the most recent time, and any data whose retention period has expired is not imported.
The command does not import service performance when this option is omitted, in which case the command imports only management information for monitored services.
Notes
-
The definition information that is edited by this command is the information contained in the imported data. The file from which the data was exported is not edited.
-
This command's processing and the following operations are mutually exclusive:
-
Registering and deleting monitored services
-
Registering and deleting Web transactions
-
Editing Web transactions (including changing their order)
-
Starting monitoring of a monitored service that is subject to overwrite import processing because the -m option is specified
-
Adding, editing, copying, and deleting report templates
-
Updating configuration information
-
Saving monitoring item settings for system performance
-
Setting up service performance monitoring
-
Setting up system performance monitoring
-
Setting up availability monitoring
If this command is executed while any mutually exclusive processing is underway, the command results in an error and its processing is canceled. Similarly, if any mutually exclusive processing is launched while this command is executing, that processing results in an error and is canceled.
-
-
This command can import data that was exported by ITSLM - Manager version 09-51 or later.
-
Do not execute another command while this command is executing, except for the jslmminfoget command.
-
Do not cancel execution of this command by closing the command prompt that is executing this command or by pressing Ctrl+C on the keyboard.
-
If this command is canceled while it is executing, partially processed data might remain in the database. If you canceled this command while its execution was underway, clean up the database to delete any unneeded data.
For details about cleaning up the database, see jslmmgrdbcleanup (cleans up database).
When this command has been canceled, rollback processing is performed on the database. Therefore, if this command, any mutually exclusive command, or a window operation is performed while rollback processing is underway, a database error will occur. If a database error occurs during command execution or during a window operation after this command has been canceled, wait a while, then re-execute the command or operation.
-
This command does not check whether a service group with the name specified in the -g option already exists. For this reason, import processing can be performed even though a nonexistent service group name is specified. To manipulate such a monitored service, use JP1/Base to register its service group (JP1 resource group) name.
Return value
Return value |
Description |
---|---|
0 |
Import processing terminated normally. |
1 |
Import processing failed. |
130 |
The import processing was canceled because Ctrl+C was pressed. |
Example
C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmmgrimport -i D:\data\itslm_export -g GroupA -s ServiceA -m 10.150.100.10 10.150.200.20 -p