In this section:

Introduction

Before upgrading from previous versions of DTP, make sure that your system meets the system requirements.

The installer automatically backs up your data as part of the upgrade process, but you can manually back up your system as an extra precaution.

If you intend to install DTP Enterprise Pack and are on Windows, you may be prompted to download the Microsoft Visual C++ Redistributable package during the installation process. See Microsoft Visual C++ Redistributable for additional information.

Windows 

Starting with DTP 2020.1, DTP is installed in two directories. The main installation directory contains application files, such as the web server and other executables. The DTP data directory contains application configuration files, as well as data sent to DTP from connected tools. By default, DTP application files will be installed in the C:\Program Files\Parasoft\DTP directory and DTP data files will be installed in the C:\ProgramData\Parasoft\DTP directory. See Installation Overview for additional Information.

Follow these instructions if you are upgrading from the most recent version of DTP and DTP Enterprise Pack:

1. Stop all Parasoft services, including DTP Enterprise Pack if applicable. See Stopping DTP Services. 
2. Run the installer and choose the Reinstall DTP option when prompted. The DTP installer automatically handles all upgrade processes. If you intend to install DTP Enterprise Pack, you may be prompted to download the Microsoft Visual C++ Redistributable package before the wizard starts. See Microsoft Visual C++ Redistributable for additional information. 
3. Click Finish to complete installation and start DTP and Enterprise Pack (if installed) processes.

If you are upgrading from DTP 5.4.2 or older, you can remove the GRS database as an optional step (see the DTP 5.4.3 release notes for additional information). Refer to the documentation for your database server software for instructions on how to delete the database.

If you did not install Enterprise Pack during the initial DTP installation process, you can re-run the latest DTP installer to install DTP Enterprise Pack at any time. 

Linux 

Starting with DTP 2020.1, DTP is installed in two directories. The main installation directory contains application files, such as the web server and other executables. The DTP data directory contains application configuration files, as well as data sent to DTP from connected tools. See Installation Overview for additional Information.

Follow these instructions if you are upgrading from the most recent version of DTP and DTP Enterprise Pack:

1. Open a command prompt and navigate to the current DTP installation.
2. Run the dtpconsole script stop all Parasoft services, including DTP Enterprise Pack if applicable. See Stopping DTP Services.

3. Run the DTP installation script with the -u option to specify the DTP installation directory to update and the -d option to specify where DTP data files should be installed:
   
   ./DTP.sh -u <DTP_INSTALL> -d <DTP_DATA_DIR>
   
   

   You must type the full, non-relative path.

   For example: ./DTP.sh -i /home/<user>/dtp -d /home/<user>/dtp_data

   If you are installing the DTP distribution that includes an embedded database server, the installer will confirm the status of the database server service.

4. 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. 

5. When the DTP.sh script finishes, run dtpconsole.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. 

6. Navigate to the <DTP_INSTALL>/dtpservices directory and run the dtpservices.sh script with the start argument to start Enterprise Pack. 
   
   ./dtpservices.sh start

If you are upgrading from DTP 5.4.2 or older, you can remove the GRS database as an optional step (see the DTP 5.4.3 release notes for additional information). Refer to the documentation for your database server software for instructions on how to delete the database.

If you did not install Enterprise Pack during the initial DTP installation process, you can re-run the latest DTP installer to install DTP Enterprise Pack at any time. 

Upgrading from DTP 5.3.3 or Older 

If you are upgrading from 5.3.3 or older, you must upgrade to 5.4.0, 5.4.1, 5.4.2, or 5.4.3 in order to upgrade to the latest version. Upgrading from Concerto is only supported by upgrading to 5.4.0 prior to upgrading to the latest version. Refer to your version the Upgrading chapter of the DTP 5.4.3 documentation for details.

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:

1. Click Execute to run the database schema upgrade process. A message is displayed when it is finished. Report Center is ready to use.

2. Verify that Report Center and Project Center functionality and port numbers were preserved. 

    All customization settings that were set in DTP_HOME/grs/config/*.xml files are preserved during the Report Center upgrade process.

3. Check the conf_update.log file in the <DTP_DATA_DIR>/logs/ directory to verify that the configuration updated successfully.

Additional Notes

When upgrading DTP, a backup is automatically created in the same parent directory. For example, a DTP installation at /home/test/dtp would result in a backup at /home/test/dtpYYMMDD_HHmmSS, where YYMMDD_HHmmSS represents the date and time when the backup and upgrade were created. When crontab has been modified by your DTP upgrade script, the old crontab is backed up to a <DTP_INSTALL>/bin/cronguard.cron~ file.