2.90:Upgrading Grooper to a New Version

So you're ready to upgrade?

About

The basics of upgrading Grooper can be broken down into three steps.

1. Uninstall the old version of Grooper.
2. Install the new version of Grooper.
3. Upgrade your existing Grooper repositories in Grooper Config.

Depending on your Grooper install, your upgrade process may be slightly more involved (For example, if you are running scripts in your environment to customize Grooper's functionality, you may need to update the associated Object Libraries). However, these three basic steps will apply to all upgrades.

How To

Perform a Simple Upgrade

Starting Point1. Uninstall Current Version2. Install the New Version3. Upgrade Repositories from Grooper Config

Starting Point

In this tutorial, we will upgrade a version 2.80 Grooper install to version 2.90. In Grooper, config you will see we have two repository connections: one named "Grooper290" and the other "Grooper280". Currently, Grooper version 2.80 is installed on this machine. Note the "Grooper280" repository is listed as "Ok" in the Status column. The "Grooper290" repository is listed as "Newer Version". This is because this environment was actually downgraded from 2.90 to 2.80 for the purpose of this tutorial. By the end of this tutorial, the Grooper install will be upgraded to version 2.90, and both repositories will be listed as "Ok", indicating they have both been upgraded to version 2.90.

FYI	If you are upgrading from version 2.70 to 2.90, you may upgrade directly to version 2.90. However, if you are upgrading from version 2.60 to 2.90, you must first upgrade to version 2.70, and then upgrade to version 2.90.

Uninstall Current Version

The first thing you need to do is uninstall the current version of Grooper before installing the new version. This can be done in a number of ways, such as uninstalling from the Windows Control Panel. Access a list of your currently installed programs by traversing the following path in Control Panel Control Panel > Programs > Programs and Features Select Grooper from the program list. Press the "Uninstall" button. If it appears, confirm you want to uninstall on the subsequent dialog box. Reboot your computer after the program finishes uninstalling. You should get a notification a reboot is required to complete the setup like the one seen here.

Install the New Version

If you have not done so, you will need to download the current installer file from Grooper x Change. Zip archives containing the installer files can be found in the "Downloads and Resources" section, linked bellow https://https://xchange.grooper.com/categories/downloads-and-resources Once downloaded, unzip the zip archive. For this tutorial, we downloaded and unzipped the installer files for version 2.90.0036. Navigate through the extracted folder to find the "setup" executable. Run the "setup" executable to open the installer.

You should see the Grooper Installer window pop up next. Step through the installer's prompts to install the new version of Grooper. Since you're upgrading, all pre-requisite installations (such as the Microsoft .Net Framework) should already be installed. However, should you need to install any prereqs, the installer will prompt you to do so.

Upgrade Repositories from Grooper Config

After the installer has finished running, open Grooper Config to upgrade the older versioned repositories to the installed version.

Notice two things about our Grooper Repositories here: The repository named "Grooper290" now matches the current version (2.90). It's Status is listed as "Ok". Any Grooper Repository whose version matches the currently installed version of Grooper will have a Status of "Ok". The repository named "Grooper280" is still on the older version (2.80) and needs to be upgraded. Its Status is listed as "Needs Upgrade" Any Grooper Repository whose version is older than the currently installed version of Grooper will have a Status of "Needs Upgrade". FYI Major versions of Grooper change the Grooper Database in meaningful ways. These changes to the database must be reflected by upgrading the Grooper Repository. For major version upgrades (For example, 2.80 to 2.90), all repositories configured on an older version must be upgraded. For minor version upgrades (For example, 2.90.0001 to 2.90.0002) you do not need to upgrade each Grooper Repository. No major changes are made to the Grooper Database, and you can skip this step.
To upgrade a Grooper Repository, select the repository that needs upgrading. Press the "Upgrade..." button in the upper toolbar. Press the "Execute" button on the following pop up window to confirm the upgrade.
After the upgrade is complete, you will see the upgraded Grooper Repository's Status change from "Needs Upgrade" to "Ok". Congratulations! You've upgraded Grooper.