You may need to start DTP services after a new installation, migration, or upgrade. In this section:

Starting DTP Services on Windows

You can easily use the Windows Start menu to start and stop DTP services:

  1. Click Start and right-click Parasoft> DTP> Start DTP Server.
  2. Choose Run as administrator from the contextual menu. If your DTP distribution includes an embedded database server, the menu will also include an option for starting and stopping the database server.

  3. Press any key to proceed when prompted.

  4. Repeat the process to start Data Collector, the Parasoft Database service if your DTP distribution includes an embedded database server, and DTP Enterprise Pack if applicable.

You can also use Windows Services to start and stop DTP services, as well as change startup from automatic to manual.

See the documentation for your version of Windows for details.

Starting DTP Services on Linux

You can either use the dtpconsole.sh script to start DTP and its related services or run each application's script directly.  

Using the Console Script

In addition to starting and stopping DTP and its related services, the dtpconsole.sh script provides interactive management capabilities, such as configuring database connections. 

  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, Team Server, 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.
    1. MySQL:
      1. Specify the hostname or IP address where the database server is located and press Enter. Default is localhost.
      2. Specify the port number and press Enter. Default is 3306.
      3. Specify a name for the database and press Enter. Default is DTP.
      4. Specify the root user and press Enter. Default is root.
      5. Specify the root user password and press Enter.
      6. Review the configuration settings and press (y) to proceed.
    2. Oracle:
      1. Specify the hostname or IP address where the database server is located and press Enter. Default is localhost.
      2. Specify the port number and press Enter. Default is 1521.
      3. Choose (1) to use SID as the database specifier type or (2) to use the service name and press Enter. Default is SID.
      4. Specify the system ID or service name of the database (default is orcl) and press Enter.
      5. Specify the root user and press Enter. Default is root.
      6. Specify the root user password and press Enter.
      7. Review the configuration settings and press (y) to proceed.
  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.

Using the Automation Scripts

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. Automation scripts are not compatible with crontab functionality.  If you are using crontab functionality, use the dtpconsole.sh script to start and stop DTP.

DTP Server

Use the dtp.sh script located in the <DTP_INSTALL>/bin directory. You can specify the following commands:

dtp.sh runRun the DTP server process in the current window.
dtp.sh startStart DTP server as a background process.
dtp.sh stopStop DTP server.
dtp.sh statusDisplay the current status of DTP server.
dtp.sh helpPrint the help to the console.

Data Collector

Use the datacollector.sh script located in the <DTP_INSTALL>/bin directory. You can specify the following commands:

datacollector.sh runRun the Data Collector process in the current window.
datacollector.sh startStart Data Collector as a background process.
datacollector.sh stopStop Data Collector.
datacollector.sh statusDisplay the current status of Data Collector.
datacollector.sh helpPrint the help to the console.

DTP Enterprise Pack

Use the dtpservices.sh script located in the <DTP_INSTALL>/dtpservices directory. You can specify the following commands:

dtpservices.sh runRun the Enterprise Pack process in the current window.
dtpservices.sh startStart Enterprise Pack as a background process.
dtpservices.sh stopStop Enterprise Pack.
dtpservices.sh statusDisplay the current status of Enterprise Pack.
dtpservices.sh reset-serverReset the DTP server connection settings for Enterprise Pack to the defaults. See Server Settings for information about the server configuration. 
dtpservices.sh helpPrint the help to the console.

Potential Errors When Stopping on Linux

In some unexpected instances, you may see the following message when running the stop on Linux:    

"Time out on DTP Enterprise Pack process termination. Please kill all processes manually. (Refer to the documentation)"

This message only triggers if any of the children processes of the main DTP Enterprise Pack application (typically one of the service processes) started but was not killed completely. These processes must be terminated before starting DTP Enterprise Pack again. 

  1. Run following command:    
    pgrep node or pgrep -f <installation home>/nodejs/bin/node
    This command will print out all processes that DTP Enterprise Pack started.
  2. Run the kill command using the same argument to kill these process:
    pkill node 
    or
    pkill -f <installation home>/nodejs/bin/node
  • No labels