17.21 ioutils importexlog (importing external logs)
Functionality
This command imports CSV-format operation logs (external logs) collected from systems other than JP1/IT Desktop Management 2 into JP1/IT Desktop Management 2.
The external logs are stored in the operation log backup folder that is configured during the setup. Also, if the system is configured to automatically restore operation logs in the Settings for Operation Logs view, they are automatically imported into the operation log database.
To execute the command, specify 1 for the HibunLogImport value in the configuration file for the external log import command.
You can import HIBUN logs into JP1/IT Desktop Management 2 by using this command. For details about the procedure, see 10.9 Importing HIBUN logs.
Format
ioutils importexlog -import folder-where-the-CSV-format-log-file-to-be-imported-is-stored -log type-of-the-log-to-be-imported
Arguments
- -import folder-where-the-CSV-format-log-file-to-be-imported-is-stored
-
Specify the absolute path to the CSV-format log file folder to be imported.
- -log type-of-the-log-to-be-imported
-
Specify the type of the log to be imported. One of the following can be specified:
-
HA: HIBUN access log
-
HE: HIBUN event log
-
HO: HIBUN extended operation log
-
Storage location
JP1/IT Desktop Management 2-installation-folder\mgr\bin\
You can execute this command without specifying a storage location for the executable file, by using the command prompt provided by JP1/IT Desktop Management 2.
Format of the configuration file for the external log import command
The following table lists and describes the specifications of the configuration file for the external log import command. Note that after you change settings in this file, restart the JP1/IT Desktop Management 2 service:
Item |
Description |
---|---|
File name |
jdn_manager_importexlog_config.properties |
Storage location |
JP1/IT Desktop Management 2-installation-folder\mgr\conf |
The following table lists and describes the format of the configuration file for the external log import command:
Property |
Description |
Default value |
Acceptable value |
---|---|---|---|
HibunLogImport |
Specify 1 if HIBUN logs are imported. |
0 |
0 or 1 |
UnknownLogImport.type-of-log |
Specify 1 if unknown logs are imported.
|
0 |
0 or 1 |
Deny.type-of-log.CSV-column-number |
Specify the log or logs you do not want to import, separated by commas (,). This property can be specified multiple times.
|
Deny.HA.12=NRD Deny.HA.13=CFL,OPN,WRI,COM |
String |
- Important
-
If the value of HibunLogImport is set back to 0 from 1, filters do not work properly for the Operation Type and Operation Type (Detail) filters starting with [HIBUN] or the Operations Logs filter for which one of the device categories below is applied. You therefore need to re-create the filter.
-
Removable media
-
External hard disk
-
CD or DVD drive
-
Infrared device
-
Wireless LAN
-
Modem
-
Windows Mobile device
-
Palm handheld device
-
BlackBerry device
-
Serial or parallel port
-
Other controlled device
-
Wired LAN (USB connections)
-
Wired LAN (non-USB connections)
-
The following example shows the configuration file for the external log import command:
HibunLogImport=1
Deny.HA.13=CFL,OPN
Notes
-
Execute this command when the management server setup is completed, and the services on the management server have started.
-
This command cannot be simultaneously executed by multiple users.
-
This command cannot be executed simultaneously with any of the following commands:
-
exportdb
-
importdb
-
ioassetsfieldutil export
-
ioassetsfieldutil import
-
ioutils exportasset
-
ioutils exportdevice
-
ioutils exportdevicedetail
-
ioutils exportfield
-
ioutils exportfilter
-
ioutils exportplog
-
ioutils exportpolicy
-
ioutils exporttemplate
-
ioutils exportupdategroup
-
ioutils exportupdatelist
-
ioutils importasset
-
ioutils importfield
-
ioutils importfilter
-
ioutils importpolicy
-
ioutils importtemplate
-
ioutils importupdategroup
-
ioutils importupdatelist
-
reorgdb
-
startservice
-
stopservice
-
updatesupportinfo
-
deletenwgroup
-
distributelicense
-
-
If the Task Scheduler is used to execute this command during operation, redirect the standard output and standard error to a file, so that you can view messages from the command.
-
You can check the execution result of the command in the Events module. The event numbers are 1165, 1166, and 1167.
-
The command skips processing of an invalid CSV file after printing a message (KDEX4129-W or KDEX4130-W) to the standard output, and then continues subsequent processing.
-
In the multi-server configuration, the relay management server does not inform external logs it imported of the upper-level management server.
-
In the cluster configuration, specify the folder on the shared disk for folder-where-the-CSV-format-log-file-to-be-imported-is-stored, so that the primary and standby servers can refer to the folder.
Return values
The following table shows the return values of the ioutils importexlog command.
Return value |
Description |
---|---|
0 |
The command finished normally. |
11 |
The format for specifying the command arguments is invalid. |
12 |
The specified folder is invalid, the disk does not have sufficient capacity, or the folder does not exist. |
15 |
Failed to store the file due to insufficient disk space or a disk access error. |
31 |
Another command is being executed. |
51 |
You do not have the permissions to execute this command. |
54 |
The management server has not been set up. |
57 |
The configuration or environment for executing the command is invalid. |
101 |
Command execution failed because there is not enough memory, or due to some other reason. |
120 |
A database access error occurred. |
Example
The following example shows how to use the command when HIBUN access log exported in CSV format found in the C:\temp\hibunlog folder is imported into JP1/IT Desktop Management 2:
ioutils importexlog -import C:\temp\hibunlog -log HA
Related Topics: