3.4.1 Changing the performance data storage destination

The performance data collected by PFM - Agent for Service Response is managed in the Store database of the Agent Store service of PFM - Agent for Service Response. 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
(2) Editing the jpcsto.ini file to change settings (for Store version 1.0 only)

(1) Using the jpcconf db define command to change settings

The Store database uses the following folders to manage the collected performance data. These folders 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 folder
Backup destination folder
Partial backup destination folder^#
Export destination folder
Import destination folder^#

#: This folder 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.

Table 3‒3: Options of the command that changes the performance data storage location
Item	Option	Specifiable value (Store 1.0)^#	Specifiable value (Store 2.0)^#	Default
Save destination folder	`sd`	Folder name of 1-127 bytes	Folder name of 1-214 bytes	`installation-folder\agtv\store`
Backup destination folder	`bd`	Folder name of 1-127 bytes	Folder name of 1-211 bytes	`installation-folder\agtv\store\backup`
Partial backup destination folder	`pbd`	--	Folder name of 1-214 bytes	`installation-folder\agtv\store\partial`
Maximum backup generation number	`bs`	1 to 9	1 to 9	5
Export destination folder	`dd`	Folder name of 1-127 bytes	Folder name of 1-127 bytes	`installation-folder\agtv\store\dump`
Import destination folder	`id`	--	Folder name of 1-222 bytes	`installation-folder\agtv\store\import`

Legend:: --: This item cannot be set.
#: The folder name must be an absolute path name or a relative path name from the default Store database folder (installation-folder\agtv\store).

To Page Top

(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) Setting items in jpcsto.ini

The following table lists the label names for which information can be edited in the jpcsto.ini file, and other information such as the values that can be specified.

Table 3‒4: Performance-data storage location settings (under [Data Section] in jpcsto.ini)
Item	Label name	Specifiable value (Store 1.0)^#1	Default
Save destination folder	`Store` `Dir`^#2	Folder name of 1-127 bytes	`installation-folder\agtv\store`
Backup destination folder	`Backup` `Dir`^#2	Folder name of 1-127 bytes	`installation-folder\agtv\store\backup`
Maximum backup generation number	`Backup` `Save`	1 to 9	5
Export destination folder	`Dump` `Dir`^#2	Folder name of 1-127 bytes	`installation-folder\agtv\store\dump`

#1

The folder name must be an absolute path name or a relative path name from the default Store database folder (installation-folder\agtv\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 folders for Store Dir, Backup Dir, and Dump Dir.

(b) Before editing the jpcsto.ini file

When changing the Store database folder, make sure that the folder after the change has already been created.
When the Store database folder is changed, performance data collected before the change can no longer be used. If the performance data collected before the change is needed, carry the data over as follows:
1. Use the jpctool db backup command to back up the performance data stored in the Store database.
2. Change the Store database folder as shown in (c) Editing the jpcsto.ini file.
3. Use the jpctool db restore command to restore the backed up 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 programs and 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 (for example, change performance data storage folders).

Correct the shaded information shown below, as necessary.

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\agtv\store). To change the storage folder, specify a path relative to this folder, or specify the absolute path.
- To change the Store database storage location, you must already have created the folder that you specify here.
- 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 may not function normally.
Save the jpcsto.ini file and then close it.
Start the Performance Management programs and services.

Note:

When you use this procedure to change the Store database folder, the performance data files are not deleted from the previous folder. If these files are no longer necessary, delete only the following files:

All files with the .DB extension
All files with the .IDX extension

To Page Top