3.6.2 Updating the Store version to 2.0
The two types of Store database storage formats are versions 1.0 and 2.0. For details about Store version 2.0, see the JP1/Performance Management Planning and Configuration Guide.
Store version 2.0 is used by default only when you have configured a new instance in an environment of PFM - Base or PFM - Manager version 08-11 or later using PFM - Agent for Enterprise Applications version 09-00 or later. Otherwise, the Store version 1.0 format is used, and you will have to use the setup command to update the Store version to 2.0.
If you need to restore Store version 1.0 for some reason, cancel the setup of Store version 2.0.
The following table shows whether Store version 2.0 is supported, depending on the installation conditions, and describes the operating procedure.
|
Installation condition |
Whether Store version 2.0 is supported |
Store version 2.0 operating procedure |
|
|---|---|---|---|
|
Version of the installed PFM - Base or PFM - Manager |
PFM - Agent installation method |
||
|
08-00 or earlier |
Overwrite installation |
Not supported |
Upgrade PFM - Base or PFM - Manager to version 08-11 and then execute the setup command. |
|
New installation |
|||
|
08-11 or later |
Overwrite installation |
An existing instance is supported after setup |
Execute the setup command. |
|
A new instance is supported |
Use the jpcconf inst setup command to set up when the instance is configured. |
||
|
New installation |
Supported |
Use the jpcconf inst setup command to set up when the instance is configured. |
|
- Organization of this subsection
(1) Setting up Store version 2.0
This subsection describes how to set up Store version 2.0 when you update the Store database.
-
Estimating the system resources and setting the retention period
Make sure that the system resources required for installing Store version 2.0 are appropriate for the execution environment. The types of required system resources are as follows:
-
Disk capacity
-
Number of files
-
Number of files opened by each process
Use retention period settings to adjust these values. Set the retention period taking into account the resources available in the execution environment. For details about estimating the system resources, see the Release Notes for PFM - Agent for Enterprise Applications.
-
-
Setting folders
After you have updated your Store database to Store version 2.0, the Agent Store service might not start using the data storage folder settings for performance data that were set for Store version 1.0. For this reason, you must specify the folder settings again. For details, see 3.6.1 Changing the performance data storage location.
-
Executing the setup command
To update the Store version to 2.0, execute the jpcconf db vrset -ver 2.0 command. You must execute this command for each Agent instance.
For details about the jpcconf db vrset -ver 2.0 command, see the manual JP1/Performance Management Reference.
-
Setting the retention period
Set the retention period that was determined during the estimation process in step 1. Start the Agent Store service and use PFM - Web Console to specify the settings.
(2) Canceling the setup of Store version 2.0
To cancel the setup of Store version 2.0, use the jpcconf db vrset -ver 1.0 command. When the setup of Store version 2.0 is canceled, all data in the Store database is initialized and the Store database is reset to Store version 1.0.
For details about the jpcconf db vrset -ver 1.0 command, see the manual JP1/Performance Management Reference.
(3) Notes
This subsection provides notes about updating.
(a) When updating from Store version 1.0 to Store version 2.0
When the Store database is updated from Store version 1.0 to 2.0, the retention period settings are inherited for records of the PI record type. However, for records of the PD record type, the default retention days value (which determines the number of records to be retained) is set to the default value for each record regardless of the previous settings, and the data that had been collected prior to the default retention days value is deleted.
For example, if 1,000 PD records whose Collection Interval is 3,600 seconds are set to be retained in Store version 1.0, about 42 days (1,000/24) worth of data is stored because 24 PD records are stored per day. If this Store database is updated to Store version 2.0 and the value 10 had been set as the default retention days value for PD records, the data obtained more than 10 days ago will be deleted and will no longer be viewable.
Before you update the Store database to Store version 2.0, check the settings for the number of records to be retained for the PD record type. If more than the default retention days worth of data is set to be retained in Store version 2.0, use the jpctool db dump command to output the data from the database. For details about the default retention days in Store version 2.0, see the Release Notes for PFM - Agent for Enterprise Applications.
(b) When restoring Store version 1.0 from 2.0
If you cancel the setup of Store version 2.0, the data is initialized. Therefore, before you restore Store version 1.0, execute the jpctool db dump command to output the Store version 2.0 information.
(c) Default record retention period in Store version 2.0
Store version 2.0 is supported when PFM - Manager or PFM - Base version 08-11 or later is combined with PFM - Agent for Enterprise Applications version 08-00 or later. The default record retention period depends on whether PFM - Agent for Enterprise Applications 09-00 or later is used or PFM - Agent for Enterprise Applications 08-00 is used.
- If PFM - Agent for Enterprise Applications 09-00 or later is used:
-
For details about the default record retention period, see the Release Notes for PFM - Agent for Enterprise Applications.
- If PFM - Agent for Enterprise Applications 08-00 is used:
-
The default retention period is set to 10 days for all records of the PD and PL record types. For records of the PI record type, the default retention period is set as shown in the table below.
- Legend:
-
--: Cannot be specified