In this section:

Introduction

In most cases, the DTP installer automatically handles all upgrade processes, but you should refer to the Upgrade Scenarios section to verify your upgrade path. 

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.

Basic Upgrade 

Follow these instructions if one of the following conditions apply:

• You are upgrading from 5.4.0 or later with or without DTP Enterprise Pack, or
• you are upgrading from 5.0.0 - 5.3.3 without DTP Enterprise Pack

Windows

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. 
3. Click Finish to complete installation and start DTP and Enterprise Pack (if installed) processes.

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

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:

4. ./DTP.sh -u <DTP_INSTALL>
   where DTP_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.

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

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

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

5.3.2 - 5.3.3 with Enterprise Pack

Follow these instructions if the following conditions apply:

• You are upgrading to the most recent version of DTP
• You are upgrading with DTP Enterprise Pack. 

Windows

1. Stop Parasoft services. See Stopping DTP Services for instructions.
2. Open a command prompt and navigate to the current (older) Enterprise Pack installation directory.
3. Run the dtpservices.bat stop  command to stop DTP Enterprise Pack.

4. Run the latest DTP installer and following the prompts until the upgrade is complete. See New DTP Installations.

   DTP Enterprise Pack will be installed in the <DTP_HOME>/dtpservices directory as a result of the upgrade process. If this is the current location of your Enterprise Pack installation, the installer will automatically backup and restore Enterprise Pack.

5. By default, the Installation Complete dialog prompts you to start DTP services and DTP Enterprise Pack. Disable all services to prevent them from starting automatically.
   
6. Click Finish and open a command prompt and navigate to the <DTP_HOME>/dtpservices directory.
7. Run the following command to create a backup archive:
   
   dtpservices.bat backup --target <path to old Enterprise Pack directory> 
   
   The back up archive will be save to the parent directory specified with the --target command. This process may take several minutes to complete.
    
8. Run the dtpservices.bat restore --src <path to backup archive> command.
9. Start DTP services. See Starting DTP Services for instructions.

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

Linux

Linux administration processes are executed from the command line. 

1. Open a command prompt and navigate to the current DTP installation.

2. Run the dtpconsole script stop Parasoft services and DTP Enterprise Pack (see Stopping DTP Services).

   DTP Enterprise Pack will be installed in the <DTP_HOME>/dtpservices directory as a result of the upgrade process. If this is the current location of your Enterprise Pack installation, the installer will automatically backup and restore Enterprise Pack.

3. Navigate to the current (older) Enterprise Pack installation directory.
4. Run the following command to create a backup archive:
   
   dtpservices.bat backup --target <path to old Enterprise Pack directory>
   
   The back up archive will be save to the parent directory specified with the --target command. This process may take several minutes to complete.
    
5. Run the dtpservices.bat restore --src <path to backup archive> command.
6. Return to the <DTP_INSTALL> directory and run dtpconsole.sh to start all DTP services, including DTP Enterprise Pack.

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

5.0.0 - 5.3.1 with PIE 1.x

The transition from Process Intelligence Engine (PIE) 1.x to DTP Enterprise Pack is significant and requires manually migrating custom flows. See Migrating PIE Slices to Extension Designer for additional information.

Windows

1. Stop Parasoft services. See Stopping DTP Services for instructions.
2. Open a command prompt and navigate to the <PIE_INSTALL> directory.
3. Run the pie_service.bat full-backup ..\pie-upgrade-backup or command to create a backup archive in the parent directory.
   

4. Run pie_service.bat stop to terminal PIE processes. 

5. Run the latest DTP installer and following the prompts until the upgrade is complete. See New DTP Installations.

   DTP Enterprise Pack will be installed in the <DTP_HOME>/dtpservices directory as a result of the upgrade process. If this is the current location of your Enterprise Pack installation, the installer will automatically backup and restore Enterprise Pack.

6. By default, the Installation Complete dialog prompts you to start DTP services and DTP Enterprise Pack. Disable all services to prevent them from starting automatically.
7. Run the dtpservices.bat restore --src <path to PIE backup archive> command.
8. Start DTP services. See Starting DTP Services for instructions. 

Linux

1. Open a command prompt and navigate to the current (old) DTP installation.

2. Run the dtpconsole script stop Parasoft services and DTP Enterprise Pack (see Stopping DTP Services)..

3. Navigate to the <PIE_INSTALL> directory.
4. Run the pie_service.sh full-backup ../pie-upgrade-backup or command to create a backup archive in the parent directory.
   

5. Run pie_service.sh stop to terminal PIE processes. 

6. Run the latest DTP installer and following the prompts until the upgrade is complete. See New DTP Installations.

   DTP Enterprise Pack will be installed in the <DTP_HOME>/dtpservices directory as a result of the upgrade process. If this is the current location of your Enterprise Pack installation, the installer will automatically backup and restore Enterprise Pack.

7. Navigate to the upgraded <DTP_INSTALL>/dtpservices directory and run the dtpservices.sh restore --src <path to PIE backup archive> command.
8. Navigate to the <DTP_INSTALL> directory and run the dtpconsol script to start DTP services (see Starting DTP Services).

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_HOME/logs/ directory to verify that the configuration updated successfully.