4.7.1 Changing the storage location of performance data
Performance data collected by PFM - Agent for Platform is managed in the Store database of the Agent Store service of PFM - Agent for Platform. The following explains how to change the storage location for performance data.
- Organization of this subsection
(1) Using the jpcconf db define command to change settings
The Store database uses the following directories to manage the collected performance data. These directories can be changed by using the jpcconf db define command. If you need the performance data collected before the Store database storage location is changed, execute the jpcconf db define command with the -move option specified. For details about the jpcconf db define command, see the manual JP1/Performance Management Reference.
-
Save destination directory
-
Backup destination directory
-
Partial backup destination directory#
-
Export destination directory
-
Import destination directory#
#: This directory can be set only when the Store version is 2.0.
The following table describes the options of the jpcconf db define command, including the values that can be specified.
Item |
Option |
Specifiable value (Store 1.0)# |
Specifiable value (Store 2.0)# |
Default |
---|---|---|---|---|
Save destination directory |
sd |
Directory name of 1-127 bytes |
Directory name of 1-214 bytes |
/opt/jp1pc/agtu/store |
Backup destination directory |
bd |
Directory name of 1-127 bytes |
Directory name of 1-211 bytes |
/opt/jp1pc/agtu/store/backup |
Partial backup destination directory |
pbd |
-- |
Directory name of 1-214 bytes |
/opt/jp1pc/agtu/store/partial |
Maximum backup generation number |
bs |
1 to 9 |
1 to 9 |
5 |
Export destination directory |
dd |
Directory name of 1-127 bytes |
Directory name of 1-127 bytes |
/opt/jp1pc/agtu/store/dump |
Import destination directory |
id |
-- |
Directory name of 1-222 bytes |
/opt/jp1pc/agtu/store/import |
- Legend:
-
--: This item cannot be set.
- #
-
The directory name must be an absolute path name or a relative path name from the default Store database directory (/opt/jp1pc/agtu/store).
(2) Editing the jpcsto.ini file to change settings (for Store version 1.0 only)
If the Store version is 1.0, you can directly edit the jpcsto.ini file to change the settings of the above items.
(a) Items to be set in the jpcsto.ini file
The table below shows the label names and setting ranges that can be edited in the jpcsto.ini file.
Item |
Label name |
Specifiable value (Store 1.0)#1 |
Default |
---|---|---|---|
Save destination directory |
Store Dir#2 |
Directory name of 1-127 bytes |
/opt/jp1pc/agtu/store |
Backup destination directory |
Backup Dir#2 |
Directory name of 1-127 bytes |
/opt/jp1pc/agtu/store/backup |
Maximum backup generation number |
Backup Save |
1 to 9 |
5 |
Export destination directory |
Dump Dir#2 |
Directory name of 1-127 bytes |
/opt/jp1pc/agtu/store/dump |
- #1
-
-
The directory name must be an absolute path name or a relative path name from the default Store database directory (/opt/jp1pc/agtu/store).
-
Characters that can be specified are alphanumeric characters, symbols, and spaces, excluding the characters listed below:
;, ,, *, ?, ', ", <, >, |
-
If the specified value is invalid, the Agent Store service cannot start.
-
- #2
-
You cannot specify the same directories for Store Dir, Backup Dir, and Dump Dir.
(b) Before editing the jpcsto.ini file
-
When changing the Store database directory, make sure that the directory after the change has already been created.
-
When the Store database directory is changed, performance data collected before the change can no longer be used. If the performance data collected before the change is needed, inherit the data over as follows:
-
Use the jpctool db backup command to back up the performance data stored in the Store database.
-
Change the Store database directory as described in (c) Editing the jpcsto.ini file.
-
Use the jpctool db restore command to restore the backed up data into the new directory.
-
(c) Editing the jpcsto.ini file
To edit the jpcsto.ini file:
-
Stop the PFM - Agent service.
If PFM - Agent programs and services are active on the local host, stop them all.
-
Use a text editor, for example, to open the jpcsto.ini file.
-
Change the storage destination directory for performance data, for example.
Modify the shaded areas below as needed.
- Important
-
-
Do not insert a space at the beginning of the line or before or after the equal sign (=).
-
(.) in each label value indicates the default storage destination directory (/opt/jp1pc/agtu/store) for the Store database of the Agent Store service. To change the storage destination, specify a relative path from the storage destination directory, or specify an absolute path.
-
The jpcsto.ini file also describes definition information in addition to the database storage destination directory. Therefore, do not change values other than those in the [Data Section] section. If you change values other than those in the [Data Section] section, Performance Management may not operate normally.
-
-
Save and close the jpcsto.ini file.
-
Start the Performance Management programs and services.
- Note:
-
When you use this procedure to change the Store database directory, the performance data files are not deleted from the previous directory. If these files are no longer necessary, delete only the following files:
-
All files with the .DB extension
-
All files with the .IDX extension
-