Upgrading
Published 08 July 2015
- Updating to this version requires a schema upgrade as part of the installation. We recommend you back up the data repository database before you update.
- If you're using SQL Monitor 4.2 or earlier with IIS and you update to this version, you need to reconfigure the SQL Monitor website to use .NET 4. If you don't have .NET 4, you can download it from the Microsoft Download Center.
Upgrading to a later version of SQL Monitor retains your current monitoring data in the Data Repository. SQL Monitor updates the Data Repository database schema to the newer version during installation.
How do I know when an upgrade is available?
When an upgrade is available, SQL Monitor displays a message above the product name banner:
Click the link for information about the upgrade, and a link to download the installer.
You'll only see this banner if you're connected to the internet.
Before upgrading
Before you upgrade to a later version, we recommend that you back up your current Data Repository. Once the upgrade is completed, you won't be able to roll back to a previous version of your Data Repository database.
Upgrading from SQL Monitor v2, v3, or v4 to SQL Monitor v5
If you upgrade with a support and upgrades package, the v2, v3, or v4 licenses expire and SQL Monitor reactivates them as v5 licenses.
If reactivation fails, or the v2, v3, or v4 license doesn't include support and upgrades, SQL Monitor deletes the serial numbers from the Configuration > Licensing page and starts a 14-day trial of v5. You cannot roll back to the previous version.
If your v2, v3, or v4 license doesn't include support and upgrades, we recommend that you install a trial version of v5 on a separate machine. When you're ready to purchase v5 licenses, you can add the support and upgrades package to make upgrading easier.
- To find your serial numbers, go to http://www.red-gate.com/myserialnumbers and enter your email address and password.
- To purchase a v5 license with the support and upgrades package, contact dba.info@red-gate.com.
Installing the upgrade
The upgrade installer is the same installer you used when you first installed SQL Monitor. It replaces the current Web Server and Base Monitor, but keeps the current SQL Monitor configuration.
You will need to re-enter the account credentials for the Base Monitor to connect to the Data Repository.
To install the upgrade:
- Download the installer to the machine that hosts the SQL Monitor Web Server.
- Run the installer, and follow the wizard to re-install the Web Server and Base Monitor.
On the Set up Data Repository page, the Data Repository details are entered for you. You don't need to set up the Data Repository again.
- Under Connect to Data Repository database using, enter the credentials for an account with db_owner permissions.
SQL Monitor uses these credentials to upgrade the Data Repository after installation.
- Click Next. The installer prompts you to take a backup of the Data Repository before continuing:
- When you've backed up the Data Repository database, complete the rest of the wizard and click Install.
All the components are installed. SQL Monitor will tryto upgrade the database schema as soon as the web service is running. - If you open SQL Monitor in your browser before the upgrade is complete, you'll see the schema upgrade progress bar:
If the upgrade is successful, your browser displays the Enter password page or the Global dashboard.
If the upgrade is not successful, an error page is displayed.
Updating the physical path in IIS
If you've upgraded SQL Monitor from v2, v3, or v4, you need to change the physical path to the SQL Monitor web server configured in IIS.
Change the path to C:\Program Files\Red Gate\SQL Monitor 5.
For full instructions, see Change the physical path of application content (TechNet).
Upgrading errors
If you encounter an error when upgrading, refer to the error message highlighted in the box. These error messages are returned by SQL Server, not SQL Monitor.
The most common reason for a failed Data Repository upgrade is that the account entered doesn't have sufficient permissions to modify the database. Enter an account with db_owner permissions and click Retry Upgrade.
The account credentials are only used to upgrade the database schema. They aren't used by SQL Monitor for anything else.