Upgrading Only the .NET UI Component
Beginning with QAD 2009.1 Enterprise Edition, you can upgrade the .NET UI component of a previous release to the next release (one release forward) using the Enterprise Edition installer’s upgrade feature. However, you cannot perform a .NET UI-only upgrade for the following versions:
• From 2012.1 to 2013 EE due to a report schema change
• From 2013.1 to 2014 EE because 2014 EE does not support the use of mixed Progress versions
This section assumes that you have not upgraded QAD Enterprise Edition and you are only upgrading the .NET UI component.
Warning You cannot use a newer QDT version to configure the QXtend component of an earlier Enterprise Edition installation. To maintain QXtend functionality following a .NET UI upgrade, you must also select the QXtend component when you upgrade the QAD EE User Interface.
To upgrade only the .NET UI component, do the following:
2 Shut down the existing environment using the appropriate script.
3 Go to the <media_install_directory>/qdt/envs/<env>/scripts directory.
4 Run the checkqadfin<env>.*, checkqadui_AS<env>.*, and checkqadui_WS<env>.* scripts to verify that the environment has shut down.
5 Go to the media’s install directory and run the install script for your environment.
6 Specify the current QDT installation directory as the target directory for the upgrade.
7 The QDT installer should recognize that QDT is already present in the directory and validate the version being replaced. Note both versions for later reference.
8 Accept the default log and XML locations offered. They are the same as the previous installation.
9 Use the default folder name that appears. The name should be the same as the name used in the previous installation.
10 Review the displayed installation summary and then proceed.
11 After the file copy completes, press Enter to end the script.
12 Go to the QDT installation directory and launch QDT as follows:
Windows: Select Start|All Programs|QAD Deployment Toolkit|Start QDT.
Linux/UNIX: Go to <qdt_install_directory> and run the qadinst installation script.
For Red Hat 6 environments, run the qadinst_RH6_64bit or qadinst_RH6_32bit executable. See Installation Guide: QAD Enterprise Edition - Progress Database for more information regarding Red Hat 6 requirements.
13 Go to Help|About and use the information noted in step 7 to verify that the previous QDT version was updated.
14 Choose Edit/Installation Media Location and select the location of the media used for the QDT update.
15 Shut down and start the databases in single-user mode using the command:
$DLC/bin/_progres -1 database_name
16 Enter the following code in the Progress Editor to unfreeze the admin (logical qadadm) database tables:
for each _file where _file-number > 0 and _File-Number < 32768:
_frozen = no
17 Once the tables are unfrozen, go to Tools|Data Dictionary|Admin, Load Data and Definitions|Data Definitions (.df file) and fully qualify the input path to point to the location.
18 Select OK.
19 Repeat steps
14 through
18 for each environment/admin database being updated.
20 Once the environment (admempty and production databases) is updated, dump out the updated admempty database definitions (admempty.df). The new admempty.df should replace the existing admempty.df. This step allows for future cloning of this environment.
21 Click Admin on the main QDT screen.
22 Select Start QAD EE in the Action pane to start the environment.
23 Select Execute to start the databases and AppServers for the environment.
24 The system prompts you to execute all steps listed. Select Yes.
25 The system prompts you to clear the log. Accept the default (No).
26 Select Close.
27 When the operation finishes, select Close to dismiss the log window and return to the Action pane.
28 Select Configure QAD EE in the Action pane.
29 Select the UI Configuration: Create UI Configuration in the Action Set pane and select Reset.
The Reset feature allows you to reset a step or steps in a previously configured Action Set.
30 The system prompts you to reset all operations listed for Create UI Configuration. Select Yes to continue.
31 Select Close when the operation finishes.
32 In the Product pane, select QAD <environment_name>: QAD EE.
33 Select Configure QAD EE from the Action pane. Note that Create UI Configuration is no longer marked as complete and can be run again.
34 Select Execute to re-create the updated UI configuration.
35 Select Close to dismiss the log pane. Note that the UI Configuration is again marked as complete in the Steps in Action Set pane.