Upgrade to Version 6.1.27 from Older Versions

If you want to upgrade PerformanceGuard versions older than version 6.1.27 to the latest version, you need to first upgrade your old version to version 6.1.27, and then upgrade version 6.1.27 to the latest version.

Caution

Is your current PerformanceGuard version older than version 5.7.24? In that case you should not follow the procedures listed in the following. Instead you should contact CapaSystems.

Caution

IMPORTANT: We recommend that you have a PerformanceGuard consultant help you with the upgrade. Many older PerformanceGuard systems have been installed with a type of installation file that did not facilitate easy future upgrades of the PerformanceGuard databases. If you perform the upgrade yourself on such a system, you could lose your PerformanceGuard configuration settings.

Tip

Before you upgrade PerformanceGuard, make sure that you are familiar with [ Terminology and Abbreviations|_Ref-1262546846]. Also make sure that you know the Hardware Recommendations and Software Requirements.

The following describes how to upgrade all server components in your PerformanceGuard system from old versions to version 6.1.27.Follow the all of the procedures step-by-step unless you are a very experienced user.
[[Database-Upgrade-Scripts.zip]]

Prerequisites

Before the upgrade you need to have the following ready:

• Your Windows credentials in order to access computers with PerformanceGuard installed
• Your SQL Server administrator credentials in order to access the MS SQL-server
• SQL Server credentials in order to access the PerformanceGuard backend server database
• SQL Server credentials in order to access the PerformanceGuard frontend server database
• A downloaded PerformanceGuard installation file

Stop Services

Stop the following services:

• PerformanceGuard Backend Server
• PerformanceGuard Web Server
• PerformanceGuard Frontend Server

Back Up Databases

A backup is important to secure your existing databases. See Back Up Database.

Upgrade Database

If you are upgrading through multiple versions, it’s sufficient to install the latest software and upgrade the database according to the following schema:

Caution

It’s necessary to run all the intermediate upgrades in order to upgrade to the correct version. Apply scripts prefixed with BACKEND on the backend server, and apply scripts prefixed with FRONTEND on the frontend server.

Caution

The first BACKEND_XXXtoYYY.sql upgrade removes all stored procedures from the database, so make sure to apply the BACKEND_PROCEDURES.sql after the last BACKEND_XXXtoYYY.sql.

_XXXPatches.sql can be re-applied without any problems

Installed Version	Script for Upgrading to Next Version
Latest PerformanceGuard	Follow instructions in Upgrade Versions Between 6.1.27 and 6.3.104 to Latest Version.
6-1-27	BACKEND_610Patches.sql FRONTEND_610Patches.sql
6-0-37	BACKEND_600to610.sql FRONTEND_600to610.sql
5-9-16	BACKEND_590to600.sql FRONTEND_590o600.sql
5-8-11	BACKEND_58xto590.sql
5-7-24	BACKEND_570to580.sql FRONTEND_570o580.sql

All database scripts can be downloaded Upgrade to Version 6.1.27 from Older Versions.
If your current version is 5-9-16, first upgrade to 6-0-37, then upgrade to 6-1-27.

Example: Backend Server Database Upgrade

1. Open SQL Server Management Studio
2. Log in as administrator using <PGUARD_BE_DB_AUTH>
3. Open <ZIP_FILE_ROOT>\Backend Database Scripts\03-BACKEND_590to600.sql
4. Click Execute
5. Open <ZIP_FILE_ROOT>\Backend Database Scripts\04-BACKEND_600to610.sql
6. Click Execute
7. Open <ZIP_FILE_ROOT>\Backend Database Scripts\05-BACKEND_PROCEDURES.sql
8. Click Execute
9. Open <ZIP_FILE_ROOT>\Backend Database Scripts\06-BACKEND_610patches.sql
10. Click Execute

Example Frontend Server Database Upgrade

1. Open SQL Server Management Studio
2. Log in as administrator using <PGUARD_FE_DB_AUTH>
3. Open <ZIP_FILE_ROOT>\Frontend Database Scripts\02-FRONTEND_590to600.sql
4. Click Execute
5. Open <ZIP_FILE_ROOT>\Frontend Database Scripts\03-FRONTEND_600to610.sql
6. Click Execute
7. Open <ZIP_FILE_ROOT>\Frontend Database Scripts\04-FRONTEND_610patches.sql
8. Click Execute

Upgrade Services (if You Are Upgrading 5.9.x or Older)

If you are upgrading through multiple versions:

1. Back up [PerformanceGuard installation folder]\display\conf\performanceguard.xml
2. Back up [PerformanceGuard installation folder]\display\conf\pglicense.xml
3. Back up [PerformanceGuard installation folder]\display\maps\.**
4. Back up [PerformanceGuard installation folder]\notification\conf\config.properties
5. Back up [PerformanceGuard installation folder]\reports\.**
6. Remove PerformanceGuard
7. Remove Java 5 (only if you are upgrading from a version older than 6.0.x)
8. Install the newest version (remember to select custom installation because the databases already exist)
9. The services are started by the installer
10. Restore the backup files from steps 1-5 in the corresponding places in the new installation.

Upgrade Services (if You Are Upgrading 6.0 or 6.1.16)

1. Replace the file [PerformanceGuard installation folder]\notification\backend.jar with <ZIP_FILE_ROOT>\notification\backend.jar

2. Replace the file [PerformanceGuard installation folder]\collector\frontend.jar with <ZIP_FILE_ROOT>\collector\frontend.jar

3. Replace the file [PerformanceGuard installation folder]\display\display.war with <ZIP_FILE_ROOT>\display\display.war

4. Replace the file [PerformanceGuard installation folder]\display\console.war with <ZIP_FILE_ROOT>\display\console.war

5. Replace the file [PerformanceGuard installation folder]\display\ral.war with <ZIP_FILE_ROOT>\display\ral.war

6. Replace the file [PerformanceGuard installation folder]\display\JettyStarter.jar with <ZIP_FILE_ROOT>\display\JettyStarter.jar

7. Delete the contents of [PerformanceGuard installation folder]\display\work

8. Delete the contents of [PerformanceGuard installation folder]\collector\cache

9. Replace the file [PerformanceGuard installation folder]\tools\servermanager\servermanager.exe with <ZIP_FILE_ROOT>\tools\servermanager\servermanager.exe

10. Delete the log files (you might want to save the log files before deleting them):

    1. [PerformanceGuard installation folder]\notification\logs\.**
    2. [PerformanceGuard installation folder]\display\logs\.**
    3. [PerformanceGuard installation folder]\collector\logs\.**

11. If you are upgrading to 6.2.x or higher

    1. Replace or add the file [PerformanceGuard installation folder]\display\dot\phantomjs.exe with <ZIP_FILE_ROOT>\display\dot\phantomjs.exe
    2. Replace or add the file [PerformanceGuard installation folder]\display\dot\phantomjs_helper.js with <ZIP_FILE_ROOT>\display\dot\phantomjs_helper.js
    3. Replace or add the file [PerformanceGuard installation folder]\display\dot\PerfCounterUtility.exe with <ZIP_FILE_ROOT>\display\dot\PerfCounterUtility.exe

12. Start the services

    1. Start the PerformanceGuard Backend service
    2. Start the PerformanceGuard Web service
    3. Start the PerformanceGuard Frontend service

Upgrading from Version 6.1.27 or Newer to the Latest Version

For information about how to upgrade from version 6.1.27 to the latest version of PerformanceGuard, see Upgrade Versions Between 6.1.27 and 6.3.104 to Latest Version.