Upgrading Your DataExchange Installation
Instructions for Upgrading an Existing DataExchange Installation
The following topics explain how to move to a newer version of DataExchange:
•
Before You Upgrade DataExchange
•
Upgrading DataExchange
•
Common Questions After Upgrading DataExchange
Before You Upgrade DataExchange
For users who want to move to the current release of DataExchange from an earlier version, the upgrade steps have changed from past releases. You now must uninstall the previous version of DataExchange using a specific set of steps, while also upgrading PSQL.
To get ready to upgrade DataExchange, review the following items before proceeding with the steps under
Upgrading DataExchange
. In addition, since upgrading requires a new installation, see also the topic
Preparing to Install DataExchange
.
DataExchange Readme
We strongly recommend that you read the DataExchange release notes. This readme file provides information that could not be included in the product documentation but may be essential to your installation and use of the product. It is included in a DataExchange installation on 64-bit systems as the file readme_dx.htm in C:\Program Files (x86)\Actian\PSQL\Replication\Docs. However, since this file may be updated after the release, its latest version is always posted on the
Actian website
.
Windows Administrator Rights
You must have full administrator-level rights on the system where you install DataExchange. For more information, see
Administrator Rights
.
Data File Backup
We recommend that you perform a backup of all of your current data files before beginning the upgrade. You may also want to perform a full system backup and test its restoration. A full system backup is best practice before any software installation on a server.
Upgrading DataExchange
Upgrading to the latest version of DataExchange must be done at the same time as upgrading PSQL. The following steps apply to upgrades from earlier versions of DataExchange to DataExchange 13.00 and from earlier versions of PSQL to PSQL 13.00 and 13.10.
►
To upgrade DataExchange
Remember to upgrade
all
sites used in replication.
1
Deactivate the replication databases on both the Partner Site and First Site.
2
Remove the replication template from the First Site.
3
Stop the PSQL services, then delete the replication databases and replication-related files from the following locations:
•
C:\Program Files (x86)\Actian\PSQL\Replication\projects
•
C:\Program Files (x86)\Actian\PSQL\Replication\templates
4
Uninstall DataExchange on the Partner Site.
5
Uninstall DataExchange on the First Site.
6
Upgrade PSQL on the First Site.
7
Upgrade PSQL on the Partner Site.
8
Install DataExchange on the First Site machine as the First Site.
9
Install DataExchange on the Partner Site machine as the Partner Site.
10
Use DXDeploy to create a replication project.
11
On the Partner Site, if you are asked to replace existing files for Real Time Backup (RTB), select
Save these files before replacing
.
12
Initiate replication.
If DataExchange installation fails before the program copies any files to the target installation directory, see the %temp% directory of the current login for the installation log file. On 64-bit systems this file is DataExchange_v
nn
_64_Install.log, and on 32-bit systems it is DataExchange_v
nn
_x86_Install.log, where
nn
is the DataExchange version.
Note
If you have been replicating multiple databases, instead of the steps
1
–
7
above, consider installing PSQL on fresh machines using the PCC schema export and import feature to move the databases from their original locations to the new systems. Then continue with steps
8
–
12
.
Common Questions After Upgrading DataExchange
See
Common Questions After Installing DataExchange
.