H. Migration Procedure and Notes on Migration
To upgrade PFM - Agent for Oracle, you need to perform overwrite installation on PFM - Agent for Oracle. For details about the installation procedure, see the following chapters.
- In Windows:
- In UNIX:
For details about notes on upgrading the versions of Performance Management programs, see the section describing the notes on version upgrading in the chapter and appendix that explain installation and setup in the JP1/Performance Management Planning and Configuration Guide.
This appendix shows the notes on upgrading the version of PFM - Agent for Oracle.
-
Do not uninstall the old version of PFM - Agent for Oracle during upgrading. If you uninstall it, performance data created in the old version is deleted and will no longer be available in the new version.
-
When you perform overwrite installation on a PFM - Agent for Oracle program, the following information is updated automatically:
-
Store database files of Agent Store service
-
ini file
-
Instance environment of PFM - Agent for Oracle
-
-
In Performance Management programs of version 08-00 or newer, the locations of the Store executing programs (jpcsto.exe and stpqlpr.exe) have been changed. When PFM - Manager and PFM - Agent are upgraded to version 08-00 or newer, the Store executing programs at the older locations are deleted.
-
After you have installed PFM - Agent for Oracle as an overwrite installation, be careful when you perform the setup procedures described in Create an Oracle account to be used in PFM - Agent for Oracle. You need to perform that procedure only when the Oracle account being used has been changed or deleted.
-
When you use Windows or Linux, for monitoring of the Oracle database, the 32-bit Oracle Client has been the required product in PFM - Agent for Oracle 10-50 or earlier. However, in PFM - Agent for Oracle 11-00 or later, the Oracle Client 64-bit library is used for monitoring.
To upgrade PFM - Agent for Oracle 10-50 or earlier to 11-00 or later, instance information is subject to change, and must therefore be updated before starting the PFM - Agent for Oracle service. The following table shows the instance information for which you need to specify the environment settings, and the settings themselves.
Table H‒1: Items in instance information needed to update when upgrading the PFM - Agent for Oracle version Item
PFM - Agent for Oracle
10-50 or earlier
11-00 or later
oracle_home
Specify the Oracle home folder for Oracle Client 32-bit.
Specify the Oracle home folder for Oracle Database.
oracle_version
Specify the version of Oracle Client 32-bit.
Specify the version of Oracle Database.
When monitoring target is Oracle Database 12c or later (about Oracle Database 18c), 12 is set.
sqlnet
Specify Y
Specify the settings according to the explanation in Table 2-14 (for Windows) or Table 3-18 (for UNIX).
net_service_name
Specify the net service name that can be used to connect to the monitoring-target Oracle Database specified in Oracle Client 32-bit.
If you specify Y for sqlnet, specify this item. Specify the net service name that can be used to connect to the monitoring-target Oracle Database specified in Oracle Database.
- Note
-
Note
-
PFM - Agent for Oracle 11-00 or later uses the Oracle Client 64-bit library included with the Oracle database, so you do not need to install the 64-bit Oracle Client.
-
Oracle Client 32-bit, which was used for monitoring in version 10-50 or earlier, is not needed and can therefore be uninstalled if it is not used by any program other than PFM - Agent for Oracle.
-