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
- Stop all Parasoft services, including DTP Enterprise Pack if applicable. See Stopping DTP Services.
- Run the installer and choose the Reinstall DTP option when prompted. The DTP installer automatically handles all upgrade processes.
- 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
Follow these instructions if you are upgrading from the most recent version of DTP and DTP Enterprise Pack:
- Open a command prompt and navigate to the current DTP installation.
- Run the dtpconsole script stop all Parasoft services, including DTP Enterprise Pack if applicable. See Stopping DTP Services.
- Run the DTP installation script with the
-u
option: ./DTP.sh -u <DTP_INSTALL>
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.
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.- Navigate to the <DTP_INSTALL>/dtpservices directory and run the
dtpservices.sh
script with thestart
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.
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
- Stop Parasoft services. See Stopping DTP Services for instructions.
- Open a command prompt and navigate to the current (older) Enterprise Pack installation directory.
- Run the
dtpservices.bat stop
command to stop DTP Enterprise Pack. Run the latest DTP installer and follow 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. The installer will automatically backup and restore installed in this directory Enterprise Pack. If the Enterprise Pack you are upgrading from is installed in another location, you should migrate Enterprise Pack to the <DTP_HOME>/dtpservices directory. Also see Integration with DTP Enterprise Pack.
- 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.
- Click Finish and open a command prompt and navigate to the <DTP_HOME>/dtpservices directory.
- 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.
- Run the
dtpservices.bat restore --src <path to backup archive>
command. - Start DTP services. See Starting DTP Services for instructions.
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 and repeat the preceding steps to install DTP Enterprise Pack at any time.
Linux
Linux administration processes are executed from the command line.
- Open a command prompt and navigate to the current DTP installation.
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. The installer will automatically backup and restore installed in this directory Enterprise Pack. If the Enterprise Pack you are upgrading from is installed in another location, you should migrate Enterprise Pack to the <DTP_HOME>/dtpservices directory. Also see Integration with DTP Enterprise Pack.
- Navigate to the current (older) Enterprise Pack installation directory.
- 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.
- Run the
dtpservices.bat restore --src <path to backup archive>
command. - Return to the <DTP_INSTALL> directory and run
dtpconsole.sh
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 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 the release notes for DTP 5.3.2 for additional information.
Windows
- Stop Parasoft services. See Stopping DTP Services for instructions.
- Open a command prompt and navigate to the <PIE_INSTALL> directory.
- Run the
pie_service.bat full-backup ..\pie-upgrade-backup
or command to create a backup archive in the parent directory. Run pie_service.bat stop to terminal PIE processes.
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. The installer will automatically backup and restore installed in this directory Enterprise Pack. If the Enterprise Pack you are upgrading from is installed in another location, you should migrate Enterprise Pack to the <DTP_HOME>/dtpservices directory. Also see Integration with DTP Enterprise Pack.
- 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.
- Run the
dtpservices.bat restore --src <path to PIE backup archive>
command. - Start DTP services. See Starting DTP Services for instructions.
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.
Linux
- Open a command prompt and navigate to the current (old) DTP installation.
Run the dtpconsole script stop Parasoft services and DTP Enterprise Pack (see Stopping DTP Services)..
- Navigate to the <PIE_INSTALL> directory.
- Run the
pie_service.sh full-backup ../pie-upgrade-backup
or command to create a backup archive in the parent directory. Run
pie_service.sh stop
to terminal PIE processes.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. The installer will automatically backup and restore installed in this directory Enterprise Pack. If the Enterprise Pack you are upgrading from is installed in another location, you should migrate Enterprise Pack to the <DTP_HOME>/dtpservices directory. Also see Integration with DTP Enterprise Pack.
- Navigate to the upgraded <DTP_INSTALL>/dtpservices directory and run the
dtpservices.sh restore --src <path to PIE backup archive>
command. - Navigate to the <DTP_INSTALL> directory and run the dtpconsol script to start DTP services (see Starting DTP Services).
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.
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.