Upgrade from Govern 5.x to Govern 6.0
Overview
This page is intended for customers, business analysts and technical services to provide tools and tips when upgrading to Openforms 6.0 from a prior Openforms version or from Govern for Windows. Govern users that are upgrading from Release 5.1 to Release 6.0 will need to note the changes in the behavior of the Release 6.0 suite of applications. Click here for Upgrade Configuration Details.
Tips before upgrade
- Prior to any upgrade, it is recommended that a complete backup of the database prior to copying or upgrading be performed.
Design Workflow Changes
The Model Designer (MoD) application is no longer a part of the suite. Forms are now designed with the OpenForms™ Designer (OFD). The Business Entity Designer (BED) is still used for designing Business Entities.
Database Changes
For Release 6.0, changes have been made to the structure of models used in the Model Designer (MoD) Release 5.1 and the new OpenForms™ Designer (OFD) Release 6.0. As a result of these changes, the databases that are used by Release 6.0 applications are not compatible. Govern applications that are prior to Release 6.0 will be referred to as legacy applications. Govern Databases created for use with releases prior to 6.0 will be referred to as legacy databases.
In order to assure the integrity of the 6.0 database, the Govern system will prevent the use of any legacy databases unless they have been created for, or upgraded to Release 6.0.
Legacy Applications
Release 5.1 Applications
The following Release 5.1 applications WILL NOT work with a Release 6.0 database.
- Business Entity Designer (BED)
- Query Tool (QT)
- Security Manager (SM)
- Model Designer (MoD)
- Govern
- Govern New Administration (GNA)
Release 5.1 Exceptions
Users attempting to set a Release 6.0 database as a Default Connection Key in the Connection Key Management form in the Release 5.1 Govern New Administration (GNA), will be presented with a warning indicating that they cannot select a database version that is greater than Release 5.1. No change will be made to the default connection key.
When a user tries to access any of the above applications, a warning message is displayed.
Release 6.0 Applications
Govern Release 6.0 applications will not run with a Release 5.1 or lower database. The following is a list of the Release 6.0 applications that will not work with a legacy database, i.e. a version that is less than Release 6.0.
- Business Entity Designer (BED)
- Security Manager (SM)
- Query Tool (QT)
- Open Form Designer (OFD)
- Govern (Release 6.0)
Attempting to run any of the above Release 6.0 applications will result in a warning being displayed.
Release 6.0 Exceptions
Users attempting to set a Release 5.1 database as a Default Connection Key in the Connection Key Management form in the Release 6.0 Govern New Administration (GNA), they will be presented with a warning indicating that they cannot select a database version that is less than Release 6.0. If the user selects Yes, the system will run the Database Verification process and will update the selected database to a Release 6.0 version.
| WARNING: When users select the Yes option, GNA will display the Database Verification form to perform a non-reversible upgrade to their database. After the process is complete, the NET_DB_VERSION column in (Table: USR_KEY_MASTER) is updated. |
| NOTE: If errors are encountered during the Database Verification process, the conversion to a Release 6.0 database will not be complete. Any errors will have to be addressed and the process repeated. |
Upgrade Paths to Release 6.0
| WARNING: Prior to any upgrade, it is recommended that a complete backup of the database prior to copying or upgrading should be performed. |
Users that will be using Release 6.0 have two (2) paths to upgrade to Govern Release 6.0 applications:
OPTION 1 – Direct Upgrade
This path is one that will immediately upgrade your current installation database from Release 5.1 to Release 6.0. The database upgrade is irreversible and as such, a complete database backup should be made prior to the upgrade. Should it be necessary to roll back to your Release 5.1 database, the backup can be restored. The Deploy EZ application will be used to update the currently existing deployment. The deployment will consist of the Release 6.0 replacement applications.
| NOTE: This Option 1 upgrade path will replace the Release 5.1 applications with their Release 6.0 versions. |
Upgrade Steps for OPTION 1
- Open the Govern New Administration (GNA) Release 5.1.
- Use the Connection Key Management form to ensure that the default connection key is set to your Release 5.1 database; close the GNA application when done.
- Perform a complete backup of your current Release 5.1 database with your Database Management application.
- Update your current deployment with Deploy EZ; update the applications to the latest Release 6.0 versions.
- Run the Govern New Administration (GNA) Release 6.0.
- At the prompt, click Yes to perform the database update.
- When the process is complete, restart the application.
Upon completion of the process, the NET_DB_VERSION column in (Table: USR_KEY_MASTER) is updated. The database conversion is complete. Close GNA and restart the application.
OPTION 2 – Parallel Install
This Option 2 upgrade path is non destructive in that a new Release 6.0 Deployment is created; a name that reflects that it is a Release 6.0 is recommended. As with Option 1 above, a full backup of the Release 5.1 database is mandatory. In addition a new Connection Key (CK) must be created to reflect the existence of a Release 6.0 database. Installing the applications in the Release 6.0 deployment will not overwrite any existing Release 5.1 applications. The newly installed application will run independently of the legacy applications on a separate database.
NOTE: The Option 2 upgrade path will leave the existing Release 5.1 applications and database intact; as no upgrade is actually performed on existing Release 5.1 applications. The database upgrade that is performed is on a duplicate database that is created from a backup of the Release 5.1 version.
There is no synchronization of data between the old and new database; the 5.1 and 6.0 environments are independent of each other. If synchronization of data is required it will have to be performed by a qualified database administrator that is knowledgeable on the functioning of the Govern application and the database structure. |
Upgrade Steps for OPTION 2
- Perform a complete backup of your current Release 5.1 database with your Database Management application.
- With you DB Management application, create a duplicate of the Release 5.1 database; rename with a 6.0 designation, e.g. mydbase_60
- Open the Govern New Administration (GNA) Release 5.1.
- Use the Connection Key Management form to create a connection key to the newly designated Release 6.0 database.
- Set the new connection key as the Default connection; close the GNA application when done.
- Launch Deploy EZ.
- Create a new deployment with a Release 6.0 designation.
- Create your deployment with the latest required Release 6.0 applications.
- Run the Govern New Administration (GNA) Release 6.0.
- At the prompt, click Yes to perform the database update.
- When the process is complete, restart the application.
Upon completion of the process, the NET_DB_VERSION column in (Table: USR_KEY_MASTER) is updated. The database conversion is complete. Restart your applications.
Batch Programs
Batch programs are now linked to profiles and as such will need to be recreated.
The USR_BP_MENU will no longer be used.
Configuration Re-engineering
Click here for more information.
100-upgrade-OFtoOF




(0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this.
Loading...