Before upgrading from previous versions of DTP, make sure you read the following chapters and make all necessary adjustments:
- Requirements
- Backing Up Your System
- Backing Up DTP Enterprise Pack (if applicable)
In this section:
Upgrading on Windows
- Stop Parasoft services; see Stopping DTP Services.
- Run the DTP installer and choose the Reinstall DTP option when prompted. By default, DTP installs in the C:\Parasoft\DTP directory. If you plan to install DTP Enterprise Pack and want to install install to the Program Files directory, you will need to start DTP Enterprise Pack using the console as administrator (see Getting Started with DTP Enterprise Pack).
- Click Next and verify the installation settings.
- Click Install to proceed.The installer will uninstall the existing version before and the newer version.
- Click Finish when the installation is complete to start DTP services. All configuration files should be preserved.
Upgrading on Linux and Solaris
- Stop Parasoft services; see Stopping DTP Services.
Run the installation script with the
-u
option:./DTP.sh -u DTP_HOME
whereDTP_HOME
is the installation directory of the current installation.You must type the full, non-relative path.
Example:
/home/parasoft/dtp
but not./parasoft/dtp
If you are installing the DTP distribution that includes an embedded database server, the installer will confirm the status of the database server service.
The installer will check the specified DTP installation directory for DTP Enterprise Pack. If Enterprise Pack is detected, you will be prompted to either remove or update the pack. If Enterprise Pack is not detected, you will be prompted to install it in the [DTP_INSTALL]/dtpservices directory. See Upgrade Scenarios for DTP and DTP Enterprise Pack for additional information.
When the
DTP.sh
script finishes, rundtpconsole.sh
to start DTP and Data Collector. If you are installing the DTP distribution that includes an embedded database server, services will start automatically and you can immediately begin using DTP.
Upgrading the Database Structure
Report Center verifies the database structure when you log in with administrator credentials after upgrading. You may be prompted to update the database.
To upgrade the database structure, following these steps:
- Click Execute to run the database schema upgrade process. A message is displayed when it is finished. Report Center is ready to use.
Verify that Report Center and Project Center functionality and port numbers were preserved.
- Check the conf_update.log file in the DTP_HOME/logs/ directory to verify that the configuration updated successfully.
Upgrading DTP and DTP Enterprise Pack
The DTP installer for 5.4 and later includes DTP Enterprise Pack, which is a suite of process intelligence tools for advanced risk assessment and remediation (Enterprise license required). Older versions of Enterprise Pack required manual installation and, in many cases, were installed in a separate directory from DTP. Use the following scenarios as a guide for properly updating both applications.
Enterprise Pack Installed as a Subdirectory of DTP
If Enterprise Pack is installed in [DTP_INSTALL]/dtpservices, you will be prompted to update or remove Enterprise Pack when you run upgrade DTP. No additional steps are necessary.
Enterprise Pack installed as a Separate Directory
In previous version, DTP Enterprise Pack was installed separately–usually in a separate directory.
You can migrate your existing Enterprise Pack assets to the new [DTP_HOME]/dtpservices directory created during the DTP upgrade.
- Run the installer to upgrade DTP and install Enterprise Pack in the [DTP_INSTALL]/dtpservices directory when prompted.
- Create a backup of your existing Enterprise Pack assets.
- Run the dtpservices.sh script in the new Enterprise Pack to restore your old assets to the new installation (see Restoring a Backup Archive).
- Start using the new Enterprise Pack installation.