3.6.1 Changing the performance data storage location
The performance data collected by PFM - Agent for Enterprise Applications is managed in the Store database of the Agent Store service of PFM - Agent for Enterprise Applications. This subsection describes how to change the storage location of performance data.
- Organization of this subsection
(1) Using the jpcconf db define (jpcdbctrl config) command to change settings
To change the data storage folders listed below for the performance data that is to be managed in the Store database, use the jpcconf db define command. If you wish to save the performance data already in the Store database storage folder prior to the change, use the -move option of the jpcconf db define command. For details about the jpcconf db define command, see the manual JP1/Performance Management Reference.
-
Storage folder
-
Backup folder
-
Export folder
-
Partial backup folder#
-
Import folder#
#: Supported only when Store version 2.0 is used.
The following table lists and describes the information that can be set by the jpcconf db define command, such as option names and value ranges.
|
Description |
Host environment |
Option name |
Permitted value (Store version 1.0) |
Permitted value (Store version 2.0) |
Default value |
|---|---|---|---|---|---|
|
Performance data creation folder |
Physical host |
sd |
1 to 127 bytes of full path name |
1 to 214 bytes of full path name#1 |
|
|
Logical host |
sd |
1 to 127 bytes of full path name |
1 to 214 bytes of full path name#1 |
|
|
|
Performance data backup folder (full backup) |
Physical host |
bd |
1 to 127 bytes of full path name |
1 to 211 bytes of full path name#3 |
|
|
Logical host |
bd |
1 to 127 bytes of full path name |
1 to 211 bytes of full path name#3 |
|
|
|
Performance data backup folder (partial backup) |
Physical host |
pbd |
-- |
1 to 214 bytes of full path name#1 |
|
|
Logical host |
pbd |
-- |
1 to 214 bytes of full path name#1 |
|
|
|
Maximum generation number when performance data is backed up |
bs |
1 to 9 |
1 to 9 |
5 |
|
|
Performance data export folder |
Physical host |
dd |
1 to 127 bytes of full path name |
1 to 127 bytes of full path name |
|
|
Logical host |
dd |
1 to 127 bytes of full path name |
1 to 127 bytes of full path name |
|
|
|
Performance data import folder |
Physical host |
id |
-- |
1 to 222 bytes of full path name#4 |
|
|
Logical host |
id |
-- |
1 to 222 bytes of full path name#4 |
|
|
- Legend:
-
--: Cannot be set
- #1
-
If a relative path is set, the length of the specified folder path (absolute path) must not exceed 214 bytes.
- #2
-
The environment directory is located on the shared disk that was specified when the logical host was created.
- #3
-
If a relative path is set, the length of the specified folder path (absolute path) must not exceed 211 bytes.
- #4
-
If a relative path is set, the length of the specified folder path (absolute path) must not exceed 222 bytes.
(2) Editing the jpcsto.ini file to change settings (for Store version 1.0 only)
If you are using Store version 1.0, you can directly edit jpcsto.ini.
(a) Settings in the jpcsto.ini file
The table below shows the settings in the jpcsto.ini file, such as the label names that can be edited and the permitted value ranges.
|
Description |
Host environment |
Label name |
Permitted value (Store version 1.0)#1 |
Default value |
|---|---|---|---|---|
|
Performance data creation folder |
Physical host |
Store Dir#2 |
1 to 127 bytes of full path name |
|
|
Logical host |
Store Dir#2 |
1 to 127 bytes of full path name |
|
|
|
Performance data backup folder (full backup) |
Physical host |
Backup Dir#2 |
1 to 127 bytes of full path name |
|
|
Logical host |
Backup Dir#2 |
1 to 127 bytes of full path name |
|
|
|
Maximum generation number when performance data is backed up |
Backup Save |
1 to 9 |
5 |
|
|
Performance data export folder |
Physical host |
Dump Dir#2 |
1 to 127 bytes of full path name |
|
|
Logical host |
Dump Dir#2 |
1 to 127 bytes of full path name |
|
|
- #1
-
-
Specify all folder names as full path names.
-
All alphanumeric characters, symbols, and the space are permitted, except for the following characters:
;, ,, *, ?, ', ", <, >, |
-
If a specified value is invalid, the Agent Store service cannot be started.
-
- #2
-
No duplication of folder names can be specified in Store Dir, Backup Dir, and Dump Dir.
- #3
-
The environment directory is located on the shared disk that was specified when the logical host was created.
(b) Preparations before editing the jpcsto.ini file
-
In order to change the Store database storage folder, you must first create the storage folder that is to be used.
-
Once you have changed the Store database storage folder, the performance data that was collected previously is no longer available. If you need the previous performance data, the following procedure can be used to inherit it:
-
Use the jpctool db backup command to make a backup of the performance data that is stored in the existing Store database.
-
Change the Store database storage folder according to the procedure described in 3.6.1 Changing the performance data storage location.
-
Use the jpctool db restore command to restore the backup data into the new folder.
-
(c) Editing the jpcsto.ini file
To edit the jpcsto.ini file:
-
Stop the PFM - Agent services.
If PFM - Agent services are running at the local host, stop all of them.
-
Use a program such as a text editor to open the jpcsto.ini file.
-
Make necessary changes (e.g., change the performance data storage folder).
Correct the shaded information shown below, as necessary.
![[Figure]](GRAPHICS/ZUM02005.GIF)
Notes
-
Do not enter any space characters at the beginning of a line or before or after an equal sign (=).
-
A period (.) in a label value indicates the default storage folder for the Agent Store service's Store database (installation-folder\agtm\store\instance-name). To change the storage folder, specify a path relative to this folder or the absolute path.
-
The jpcsto.ini file contains not only the database storage folder but also definition information. Make sure that you do not change any values other than in the [Data Section] section. If a value outside the [Data Section] section is changed, Performance Management might not function normally.
-
-
Save the jpcsto.ini file and then close it.
-
Start the Performance Management services.
- Note
-
If you have used this procedure to change the Store database storage folder, the previous performance data still remains in the old folder. If you do not need these files, delete only the following files:
-
All files whose extension is .DB
-
All files whose extension is .IDX
-