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:
- Click Start and right-click Parasoft> DTP> Start DTP Server.
- 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.
- Press any key to proceed when prompted.
- 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.
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
Choose (1) to enter the DTP Server menu.
- Choose (1) to run the service and (q) to return to the menu.
- Choose (5) to enter the Database configuration menu.
- 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.
- 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.
- Choose (1) to create the new database schema for MySQL or (2) for Oracle and press Enter. Default is MySQL.
- MySQL:
- Specify the hostname or IP address where the database server is located and press Enter. Default is
localhost
. - Specify the port number and press Enter. Default is
3306
. - Specify a name for the database and press Enter. Default is
DTP
. - Specify the root user and press Enter. Default is
root
. - Specify the root user password and press Enter.
- Review the configuration settings and press (y) to proceed.
- Specify the hostname or IP address where the database server is located and press Enter. Default is
- Oracle:
- Specify the hostname or IP address where the database server is located and press Enter. Default is
localhost
. - Specify the port number and press Enter. Default is
1521
. - Choose (1) to use SID as the database specifier type or (2) to use the service name and press Enter. Default is SID.
- Specify the system ID or service name of the database (default is orcl) and press Enter.
- Specify the root user and press Enter. Default is
root
. - Specify the root user password and press Enter.
- Review the configuration settings and press (y) to proceed.
- Specify the hostname or IP address where the database server is located and press Enter. Default is
- MySQL:
- Press Enter when the database is created and initialized to return to the dtpconsole menu.
- Choose one of the following options:
- Choose (2) to enter the Data Collector menu.
- Choose (1) to run the Data Collector service and (q) to return to the menu
- Choose (3) to enter the Enterprise Pack menu.
- 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.
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 run | Run the DTP server process in the current window. |
dtp.sh start | Start DTP server as a background process. |
dtp.sh stop | Stop DTP server. |
dtp.sh status | Display the current status of DTP server. |
dtp.sh help | Print 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 run | Run the Data Collector process in the current window. |
datacollector.sh start | Start Data Collector as a background process. |
datacollector.sh stop | Stop Data Collector. |
datacollector.sh status | Display the current status of Data Collector. |
datacollector.sh help | Print 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 run | Run the Enterprise Pack process in the current window. |
dtpservices.sh start | Start Enterprise Pack as a background process. |
dtpservices.sh stop | Stop Enterprise Pack. |
dtpservices.sh status | Display the current status of Enterprise Pack. |
dtpservices.sh reset-server | Reset the DTP server connection settings for Enterprise Pack to the defaults. See Server Settings for information about the server configuration. |
dtpservices.sh help | Print 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.
- 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. - Run the kill command using the same argument to kill these process:
pkill node
orpkill -f <installation home>/nodejs/bin/node