In this section:

Prerequisites


Installing DTP on Windows

  1. Run the DTP installer and click Next at the welcome screen. 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. 

  2. Read and accept the license agreement when prompted to continue. 

  3. Choose an installation directory and click Next. By default, DTP installs in the C:\Program Files\Parasoft directory. 

  4. Data files for DTP are installed in the C:\ProgramData\Parasoft\DTP directory (see Installation Overview for additional information). Click Next to proceed.
  5. Choose your installation options and click Next when prompted. You can install DTP Enterprise Pack at this time or re-run the installer to add it to your DTP infrastructure later. Enterprise Pack will be installed in the C:\Program Files\Parasoft\DTP\dtpservices directory.
     
    If you are installing the distribution with an embedded database server, it will also appear in the installation options screen:

  6. Choose a location for the start menu shortcut and click Next.

  7. Review the installation information and click Install when ready or click Back to choose different installation options. 

  8. Click Finish after the installation is complete. You will be prompted to start the installed components.

See Opening and Licensing DTP to begin using DTP. 

JDBC Drivers

DTP does not ship with the MySQL, PostgreSQL, and Oracle JDBC drivers necessary to set up a database connection. After starting and licensing DTP, you may see an error when configuring your database connection. Refer to the JDBC Drivers section for instructions on how to install the drivers so that you can connect DTP to your database.

Installing DTP on Linux

Some Linux distributions do not ship with all libraries necessary to install DTP with an embedded database. You should install the libraries before deploying DTP (see the note under step 6).

The DTP.sh installer requires the package to be unzipped on Cent OS 7. Run the following command to unzip the installer prior to running the DTP.sh:

sudo yum install unzip

  1. If you are logged in as the root user and are installing the embedded database distribution of DTP on Linux, log out and log back in as another user with administrator privileges.

  2. Extract the DTP installation script from the tarball to your current directory. The following command is an example of a common method: 

    tar xvzf parasoft_dtp_[version]_linux.tar.gz

  3. Run the DTP installation script and use the -i  option to specify the installation directory location and the -d option to specify the application data directory. You must use full paths. For example:

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

    Do not use relative paths to specify the directories:

    ./DTP.sh -i ../../dtp -d ~/var/dtp_data

    You will be prompted to specify a location if you run the script without doing so. 
    If you want to set up crontab entries for DTP during installation, turn on the --setup-cron flag:

    ./DTP.sh -i /home/<user>/dtp -d /home/<user>/dtp_data --setup-cron

    Activating the --setup-cron flag will cause a menu of options to appear during the installation process from which you can choose to either append DTP entries to the current crontab or overwrite it.

  4. If you want to install Parasoft DTP Enterprise Pack, choose [y] and press Enter when prompted. Enterprise Pack includes Extension Designer, which enables you to derive sophisticated SDLC data analytics and implement granular programming policies. See DTP Enterprise Pack for additional information. A valid DTP Enterprise license is required to use Extension Designer functionality.

  5. If your DTP distribution includes an embedded database server, the server will automatically start during installation. Some Linux distributions, however, do not ship with all libraries necessary to install embedded database distributions of DTP. The installer will exit after printing the following message to the console:

    Installation was not started because the following libraries are missing:

<list of missing libraries>

Use your Linux distribution's package manager to install the missing libraries then reinstall DTP.
For example, you can install libaio.so.1 in Ubuntu with the following command:
	sudo apt-get install libaio1
If the libaio.so.1 is missing from your Red Hat Enterprise Linux distribution, then run:
	sudo yum install libaio.x86_64
Consult the documentation shipped with your Linux distribution for additional information.

    Install the libraries as described in your Linux distribution documentation and restart the installation process.

    Installation will also stop if you are logged in as the root user (see step 1) and print the following message to the console:

    Installation was not started. You cannot be logged in as the root user when installing DTP 
with embedded DB. Please log in as another user and reinstall

If you chose to install DTP Enterprise Pack (see step 4), a directory called "dtpservices" will be added to the <DTP_INSTALL> directory. See DTP Enterprise Pack for details.

Silent Install Options

The following options can be added to DTP.sh to install DTP without user interaction:

--install-dtpservices - This option will install or upgrade Parasoft DTP Enterprise Pack.

--skip-dtpservices - This option will not install or upgrade Parasoft DTP Enterprise Pack.

Initial Startup

Use the following procedure to start DTP server, Data Collector, and Enterprise Pack for the first time. After the initial startup and configuration, you can start DTP applications using the dedicated scripts. The scripts are non-interactive and suitable for starting and stopping DTP services in automated environments, such as cloud-based instances. See Using the Automation Scripts for instructions.

  1. Run the DTP Configuration Manager after the installation completes: 
    DTP_HOME/bin/dtpconsole.sh
    The DTP main menu is displayed:

    DTP - Configuration Manager
Copyright (C) by Parasoft Corporation
MAIN MENU
=========
Options:
  (1) DTP Server (Report Center, License Server)
  (2) Data Collector
  (3) DTP Enterprise Pack
  (4) Status
  (5) Database configuration
  (6) System administration
  (7) Show Machine Id
  (q) Exit to system

  2. Choose (1) to enter the DTP Server menu. 

  3. Choose (1) to run the service and (q) to return to the menu.
  4. Choose (5) to enter the Database configuration menu. 
  5. Choose (1) to create a new DTP database. If you are connecting DTP to an existing DTP database, see Connecting to an Existing DTP Database.
  6. Choose (1) to create and initialize a new DTP database schema. If you are connecting DTP to an existing DTP database that has not yet been initialized, see Configuring the Database Connection.
  7. Choose (1) to create the new database schema for MySQL or (2) for Oracle and press Enter. Default is MySQL.
  8. Press Enter when the database is created and initialized to return to the dtpconsole menu.  
  9. Choose one of the following options:
  10. Choose (2) to enter the Data Collector menu.
  11. Choose (1) to run the Data Collector service and (q) to return to the menu
  12. Choose (3) to enter the Enterprise Pack menu. 
  13. Choose (1) to run the service and (q) to return to the menu. You can only start and stop DTP Enterprise Pack through the DTP console interface. Additional administration commands for Enterprise Pack applications are available in the dedicated dtpservices.sh in the [DTP_INSTALL]/dtpservices/ directory. See Getting Started with Enterprise Pack. 

  14. See Opening and Licensing DTP to begin using DTP.

Connecting to an Existing DTP Database

  1. Choose (2) from the DTP Database Configuration menu to connect your DTP installation to an existing DTP database.
  2. Choose (1) to create the new database schema for MySQL or (2) for Oracle and press Enter. Default is MySQL.
  3. Press Enter when the database is connected to return to the dtpconsole menu.

Initializing an Existing Database Schema 

  1. Choose (2) from the DTP Database DTP Create Setup Menu if you are connecting to an existing DTP database that has not been initialized.
  2. Choose (1) to create the new database schema for MySQL or (2) for Oracle and press Enter. Default is MySQL.
  3. Press Enter when the database is initialized to return to the dtpconsole menu.

Additional Installation Notes