67.1. Migration Recommendations #
When migrating to PPEM 2.0, note the following changes implemented in this version:
The manager and agent components are rewritten in Golang and implement the new API version. For this reason, the following PPEM components are mutually incompatible between versions 1.0 and 2.0:
the manager version 2.0 and agents version 1.0
the web application version 2.0 and the manager version 1.0
the manager configuration file version 1.0 and version 2.0
the agent configuration file version 1.0 and version 2.0
Agents version 2.0 no longer regularly collect metrics and logs of DBMS instances. PPEM now uses pgpro-otel-collector to work with metrics and logs.
Therefore, the following migration recommendations for PPEM 2.0 are provided:
Install PPEM 2.0 on hardware separate from that used for version 1.0. Additionally, stop all version 1.0 components (including the manager and agents) before installing and starting the version 2.0 manager and agents.
Important
Do not run two PPEM versions simultaneously on the same server.
This may lead to unpredictable behavior, as simultaneous operation was not tested and is not guaranteed.
To use advanced DBMS instance health monitoring features in PPEM, install and configure pgpro-otel-collector.
For more information, refer to the official Postgres Pro documentation on pgpro-otel-collector and integration with PPEM.