5.1. General Migration Terms
Speedgain for Databases migration is an easy task. In general terms: only the image tag numbers have to be changed to current release + some additional tasks have to be done. The following chapters describe which tasks these are when migrating from one version to another.
New collectors will not automatically be enabled in pre-existing policies. Have a look for new collectors in every release and activate them if needed - see chapter Change / Add monitoring policies for a how-to and look at Collectors for a list of all available collectors and the version of their availability.
5.1.1. Performance Database migration between major releases
While its simple to migrate most Speedgain for Databases images, the migration of Speedgain Performance Database (PDB) within the s4dbs_postgres container must be followed a certain upgrade path to migrate database binaries, structures and extentions between major releases (V1.X.Y → V2.X.Y).
The following listing shows the supported migration paths for the PDB container (most the time called s4dbs_postgres) and the "milestones" that have to be taken:
| Speedgain version | Migration path | Important Notes |
|---|---|---|
Upgrade to Speedgain 1.8.2 or below |
no migration path |
|
Upgrade to Speedgain 2.1.Z |
Version 1.X.Y → 1.8.2 → 2.1.Z |
We recommend to read migration instructions of v1.8.2 → v2.0.0. These instructions also apply when upgrading from v1.8.2 → v2.1.Z |
Upgrade to Speedgain 2.Y.Z and above |
Version 2.1.X → 2.Y.Z |
|
Please note: the letters X, Y and Z are just placeholders for a minor or patch release number of Speedgain |
||
As you see, to migrate from version 1.X.Y you have to upgrade at least to Speedgain 1.8.2 and then to the next major release. We recommend to migrate to the latest Speedgain v2.1. patch release. You must migrate to version 2.1.X first before you can upgrade to version 2.2. or higher! Please see the migration instructions for the particular Speedgain version you want to upgrade to.
5.1.2. PDB Migration Example
Lets assume you run Speedgain in version 1.6.2 and you want to upgrade to version 2.2.0. You have to follow this PDB migrate path:
1. |
1.6.2 → 1.8.2 |
2. |
1.8.2 → 2.1.2 (At the time of writing, the latest version of Speedgain was 2.1.2.) |
3. |
2.1.2 → 2.2.0 |