2.2.2 List of Definition Files for Integrated Managers and List of Definition Files(host name) windows

The List of Definition Files for Integrated Managers window is used by the administrator to operate JP1/IM - Manager definition files from Web GUI.

Figure 2‒3: *List of Definition Files for Integrated Managers* window

The List of Definition Files(host name) window is used by the administrator to operate JP1/IM - Agent definition files from Web GUI.

Figure 2‒4: **List of Definition Files(host name)** window

The following items are displayed on the List of Definition Files for Integrated Managers and List of Definition Files(host name) screens.

Describes a criterion. A long description can be truncated and followed by an ellipsis (...). Click [Figure] to view the complete description. Click to go back to the initial view.

[Title]

When the target is JP1/IM - Manager

Displays the List of Definition Files for Integrated Managers.
When the target is JP1/IM - Agent

Displays List of Definition Files(host name).

[Category] tab

Display the category of the definition file displayed in the [Definition file list] in the tab. Depending on the definition file you want to view, the tabs in the following categories are listed from left to right. If both the category ID and category name are omitted, the definition file is displayed on the [others] tab. If there is no definition file to be displayed in the [others] tab, the [others] tab is not displayed.

For JP1/IM - Manager

jp1_central_console
jp1_intelligent
jp1_createtree
jp1_updatetree
Ascending order of user-created-definition file list definition file category names (UTF-8)
others

For JP1/IM - Agent

jp1_certificate
jp1_imagent
jp1_imexporter
jp1_imfluentd
Ascending order of user-created-definition file list definition file category names (UTF-8)
others

[Definition file list]

Displays a list of IM management node (JP1/IM - Manager or JP1/IM - Agent) definition files selected in the original Integrated Operation Viewer of this window. If there is no single data record to be displayed, "NO DATA" is displayed. The initial display is in ascending order of the file name.

[Select] checkbox

Select the line of the definition file that you want to download or delete.

[File name]

Displays the definition file name.

[File path]

Displays the file path of the definition file.

[Last update]

Displays the date and time when the definition file was last updated.

The date and time are displayed in "YYYY-MM-DD hh:mm:ss" format according to the time zone set on the Integrated Operation Viewer.

[Delete] button

■When the [Select] check box is selected in [Definition file list]

When you click this button, a message window will appear asking you to confirm the deletion of the definition file. [OK] Click this button to delete the checked definition file in [Definition file list].

■When there is no one check in the [Select] check box of [Definition file list]

This button is inactive.

[Download] button

■When the [Select] check box is selected in [Definition file list]

Clicking this button compresses the definition file with the check mark in [Definition file list] to zip format, and downloads it the file name of the "host-name_ID.zip from which the definition file is obtained" ^#.

■When there is no one check in the [Select] check box of [Definition file list]

This button is inactive.

#

ID is given a unique ID for each download.

A compressed file contains a property file that contains information about the file to be downloaded, in addition to the entity of the definition file selected for download. The properties file contains the definition file name and information about the file path. For more information about the properties file, see "Definition file properties file (imdd_file_properties.json) " and "Definition file properties file (jpc_file_properties.json)" in JP1/Integrated Management 3 - Manager Command, Definition File and API Reference (2. Definition file).

[Upload] button

The Upload Definition Files dialog box appears.

Generate Tree Information button

This item is displayed when the jp1_createtree tab is selected. Click this button to display the Generate Tree Information dialog box.

Apply Tree Information button

This item is displayed when the jp1_updatetree tab is selected. Click this button to display the Apply Tree Information dialog box.

Close button

Close the window.

Organization of this subsection

(1) Upload Definition Files dialog box
(2) Generate Tree Information dialog
(3) Apply Tree Information dialog box
(4) List of Secrets dialog

(1) Upload Definition Files dialog box

The Upload Definition Files dialog box is used to upload a definition file.

When you perform an upload, the commands required to change the configuration of the definition file (such as reloading) are also executed automatically after the upload.

Figure 2‒5: *Upload definition files* dialog

The display items of the Upload Definition Files dialog boxes are shown below.

Select Files (*. zip)

Specifies to the compressed file^# of the definition file to be uploaded as a character string of up to 200 bytes. Allowed characters are single-byte alphanumeric characters, single-byte spaces, "-", "_", ".". Control characters cannot be entered.

The maximum size of a file that can be specified is 10MB.

#

The name of the compressed file specified in the upload is arbitrary. The file format is the same as the compressed file to download.

In addition to the entity of the definition file to be uploaded, the compressed file must include a property file that contains information about the file to be uploaded. The property file contains the definition file name and information about the file path. For more information about property files, see "Definition file properties file (imdd_file_properties.json)" and "Definition file properties file (.json)" in the manual "Command, Definition File and API Reference" (2. Definition File).

Browse button

Display the input screen for specifying the file to upload.

Upload button

The upload confirmation screen is displayed.

[OK] Click this button to upload the specified file and add the uploaded file to the definition file list. ^#1

If there is no entry in the text area of [File specification (*. zip)], this button is inactive.

#1

Note the following when performing an upload:

Before updating the definition file, check the manual "JP1/Integrated Management 3-Manager Command, Definition File and API Reference" (2. Definition file) to make sure that the format and character code of the definition file are correct.

If the definition file is invalid, the update may fail. If updating of the definition file fails, an JP1 event is sent. Check the details of JP1 event that occurred and take appropriate action.
Some services are restarted automatically when you update the definition file. For the service to be restarted, refer to the explanation of each definition file in the manual "Command, Definition File and API Reference" (2. Definition file).

When the service is restarted, monitoring may be temporarily stopped. In addition, in a clustered configuration, a failover may occur due to ^#2 of setting the outage detection times for the service targets monitored by the cluster software.

Therefore, update the definition file during maintenance.

#2

Depending on the specifications of the machine and the load on the system, the service is restarted for each update of one definition file, so the estimated stop detection time is about one minute for each definition file.

For example, if you are updating 10 definition files at the same time, specify 10 minutes as the cluster software stop detection time.

If you cannot increase the detection time, log in to the host without using the definition file operation facility and update the definition file directly.

Close button

Close this screen.

To Page Top

(2) Generate Tree Information dialog

The Generate Tree Information dialog box is used to generate tree information in the integrated manager.

Figure 2‒6: **Generate Tree Information** Dialog

The display items of the Generate Tree Information dialog box is shown below.

[OK] button: Click this to request the manager specified in the integrated manager host to generate tree information.
[Cancel] button: Close this screen.

To Page Top

(3) Apply Tree Information dialog box

The Apply Tree Information dialog box is used to reflect the tree information in the Integration manager.

Figure 2‒7: **Apply Tree Information** dialog

The display items of the Apply Tree Information dialog box is shown below.

[OK] button

Clicking this button imports IM management node-related files tree into Intelligent Integrated Management Base and creates IM management node.

Configuration change mode

Select the reflection method from the pull-down menu. The default is "Configuration change mode".

New/Rebuild Mode: Specify this in the following cases:

- New build

- Fixing build errors

- When the IM database is backed up (jimdbbackup command) and recovered (jimdbrecover command)

- When the Integrated monitoring DB is unset (jcodbunsetup command) and re-set up (jcodbsetup command)

- Upgrading JP1/IM - Manager in an environment that uses an Intelligent Integrated Management infrastructure

- Configuration change mode: In addition to correcting construction errors, it is specified when the addition, deletion, and modification of the management of the Intelligent Integrated Management infrastructure are reflected.
Configuration change mode: Specify this mode to reflect addition, deletion, or modification of Intelligent Integrated Management Base managed objects in addition to the modification of build errors.

[Cancel] button

Close this screen.

To Page Top

(4) List of Secrets dialog

The List of Secrets dialog is a screen for managing secrets used by integrated agents.

Figure 2‒8: **List of Secrets** dialog

The display items of the List of Secrets dialog box are shown below.

[Title]

Displays the secret list (host name). The host name is the host name of the target integrated agent.

[Secret key]

Enter the secret key to be added, up to 1024 characters. Characters within ASCII code 0x20 to 0x7E can be entered.

[Secret]

Enter the secret to add, up to 1024 characters. Characters within ASCII code 0x20 to 0x7E can be entered. The entered characters are displayed in the abbreviation of ••.

[Add] button

You can add the contents entered in [Secret key] and [Secret] to the secret list. "Add" is displayed in [Change Contents] of the added secret.

Show only updated Secret checkbox

When this checkbox is selected, only secrets whose changes are not blank are displayed in the secret list.

List of Secrets

Lists the secrets that are managed on the target host in ascending secret key order. You can sort by the Secret Key column. 10 items are displayed in the list. The number of items displayed per page is 200. A scroll bar appears if you cannot list all secrets.

If there is no single secret, "NO DATA" is displayed.

[Previous page] key

Displays the previous page of the secret list.

Display area

Displays the number of secrets that correspond to the search conditions and the displayed area of the current page in the format of "x to y/z".

[Next page] button

Displays the next page of the secret list.

[Secret key search]

Enter the secret key to be searched, up to 1024 characters. Characters within ASCII code 0x20 to 0x7E can be entered. Filter the secret list by secret key with the entered character string.

[Search] button

Performs a partial search with the contents entered in the secret key search and displays the search results in the secret list.

[Delete] checkbox

Check the row of the secret you want to delete.

[Changes]

The following items are displayed according to the settings.

Initial State	Operation Description
Initial State	Add	Update	Deleted
Blank	-	Update	Deleted
Add	-	Add	Disappear the run
Update	-	Update	Deleted
Deleted	Update	Update	Deleted

[Secret key]

The secret key is displayed.

[Secret]

The secret is displayed in ** asterisk.

Edit button

Click this button to display the Edit Secret dialog box.

[Figure]

[Secret key]: The selected secret key in the List of Secrets dialog is displayed. Cannot be edited.
[Secret]: Enter the secret to edit using up to 1024 characters. You can enter characters within 0x20 to 0x7E of ASCII codes. The entered characters are displayed in the abbreviation of ••.
[Update] button: The edited contents are reflected in the List of Secrets dialog. "Update" is displayed in [Change contents] of the target secret.
[Cancel] button: Close the dialog.

[Delete] button

"Delete" is displayed in [Change] of the secret of the row selected by the [Delete] check box.

[Apply] button

A confirmation screen for adding, updating, or deleting a secret appears. [OK] Click the button to apply the addition, update, or deletion of the secret to the target host.

Close button

The List of Secrets window confirms the end of the screen. [OK] Click this button to close the List of Secrets window.

To Page Top