jslmmgrexport (exports service monitor information)
- Organization of this page
Function
This command exports service monitor information needed for data migration. This export processing can be performed for a single monitored service or for all monitored services.
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).
jslmmgrexport 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
jslmmgrexport [ -g service-group-name -s service-name ] -t { export-period | all | none } -o output-file-name [ -f ]
Execution permission
User account that belongs to the OS's Administrators group
Storage folder
ITSLM-Manager-installation-folder\mgr\bin\
Arguments
-g service-group-name
Specifies the name of the service group to which the monitored service to be exported belongs. If a nonexistent service group name is specified, an error results. A name beginning with a hyphen (-) cannot be specified.
When you specify this option, you must also specify the -s option.
To export service monitor information for all monitored services, omit both this option and the -s option. However, if no monitored services have been registered in ITSLM, executing this command with this option and the -s option both omitted results in an error.
-s service-name
Specifies the name of the monitored service whose service monitor information is to be exported. If a nonexistent service name is specified, an error results. A name beginning with a hyphen (-) cannot be specified.
When you specify this option, you must also specify the -g option.
To export service monitor information for all monitored services, omit both this option and the -g option. However, if no monitored services have been registered in ITSLM, executing this command with this option and the -g option both omitted results in an error.
-t
Specifies the period for which service performance data is to be exported. The following explains the specification method.
-
export-period
Specifies the number of days whose service performance data is to be exported.
The permitted value is from 1 through 60 (numeric characters). If the specified value is not within this range, an error results.
The command exports as many days' worth of past service performance data as specified here, using the time the date value changes as the reference. The data at the reference time is excluded. The time is based on the local time of the computer used to execute the command.
The following table shows the relationship between when the command is executed and the period subject to export processing.
Table 9‒3: Relationship between when the command is executed and the period subject to export processing No.
Example specification
Command execution date and time
Reference date and time
Period subject to export processing
1
1
2011/11/15 00:00:00
2011/11/15 00:00:00
2011/11/14 00:00:00 through 2011/11/14 23:59:59
2
7
2011/11/15 12:34:56
2011/11/15 00:00:00
2011/11/08 00:00:00 through 2011/11/14 23:59:59
3
30
2011/11/15 23:59:59
2011/11/15 00:00:00
2011/10/16 00:00:00 through 2011/11/14 23:59:59
-
all
Specifies that all service performance data that has been accumulated in the database is to be exported.
-
none
Specifies that no service performance data is to be exported.
-o output-file-name
Specifies as an absolute path the name of the output file to which the data is to be exported. Specification in UNC representation is not supported.
The command collects the data to be exported and then outputs it in binary format to the specified file.
The service performance information subject to export processing consists of real-time information and past information. After a period of a specific amount of time, service performance information is compressed and then retained as past information. Any information whose age is less than the specific amount of time is retained as real-time information without being compressed. Therefore, the size of the output file changes even when the service monitor information is the same because the amount of real-time data varies depending on when the command is executed.
-f
Specifies that if the output file specified in the -o option already exists, that file is to be overwritten with the export data.
If this option is omitted and the specified output file already exists, the command results in an error.
Notes
-
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)
-
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.
-
-
Do not change the exported data. If the exported data is changed, it can no longer be used for import processing.
-
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 was canceled while its execution was underway, do not use the jslmmgrimport command to import the export data file that was partially created by this command.
-
This command cannot be used to export access logs.
Return value
Return value |
Description |
---|---|
0 |
Export processing terminated normally. |
1 |
Export processing failed. |
130 |
The import processing was canceled because Ctrl+C was pressed. |
Example
C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmmgrexport -g GroupA -s ServiceA -t 1 -o D:\data\itslm_export