You can specify Enterprise Pack environment variables in your operating system. Refer to the procedure that matches your OS below.

Windows

The following instructions provide guidance on how to configure environment variables on Windows 10, but you should refer to the documentation for your version of Windows for details. 

  1. Open Control Panel from the Windows start menu.
  2. Go to System and Security > System > Advanced system settings.
  3. Choose Environment Variables to open the environment variables editing screen. 
  4. Add the desired Enterprise Pack variables in the System variables section. Refer to Environment Variables for information about the available variables.
  5. Click OK to save the variables and restart the Enterprise Pack service (see Starting DTP Applications).

Linux

On Linux systems, you can configure the necessary environment variables before running the dtpconsole.sh script, for example:

export DEP_USE_REMOTE_DB=true
export DEP_DB_HOSTNAME=<HOST>
export DEP_DB_PORT=<PORT>
./dtpconsole.sh

Refer to Environment Variables for information about the available variables.

You can also configure the system to set the variables you want to use at startup. For example, you could modify the environment file located in your /etc directory to include these variables. 

Environment Variables

You can configure the following environment variables:

MongoDB

VariableDescription
DEP_USE_REMOTE_DB 

Accepts a Boolean value that enables/disables starting Enterprise Pack using the embedded database. By default, the embedded database is used:

export DEP_USE_REMOTE_DB=false 

Set the variable to true to use a remote database.

DEP_DB_HOSTNAME 

Specifies the hostname for connecting to a remote database. Example:

export DEP_DB_HOSTNAME=localhost 

This variable is ignored if DEP_USE_REMOTE_DB=false 

Default value is localhost 

DEP_DB_PORT 

Specifies the port number for connecting to the database. Example:

export DEP_DB_PORT=8316 

You can use this variable to change the port number for connecting to the embedded database if DEP_USE_REMOTE_DB=false 

Default value is 8316 

DEP_DB_USERNAME 

Specifies the username for authenticating the connection to the database. This variable is optional and should only be used when the remote database has authentication enabled. Example:

export DEP_DB_USERNAME=<USERNAME>  

This variable is ignored if DEP_USE_REMOTE_DB=false 

DEP_DB_PASSWORD 

Specifies the password for authenticating the connection to the database. This variable is optional and should only be used when the remote database has authentication enabled. Example:

export DEP_DB_PASSWORD=<PASSWORD>  

This variable is ignored if DEP_USE_REMOTE_DB=false 

Passwords must be encrypted; plain text passwords are not supported. To encrypt this value, use the -encodepass  CLI option included with any Parasoft tool (for example, jtestcli.exe -encodepass <PASSWORD>).

DEP_AUTH_DB 

Specifies the database to use for authenticating the user. This variable is optional and should only be used when the remote database has authentication enabled. Example:

export DEP_AUTH_DB=test  

This variable is ignored if DEP_USE_REMOTE_DB=false 

Extension Designer

VariableDescription
DEP_ACCESS_LOG_BACKUPS 

Determines how many archived log files are stored by Extension Designer. Applies to all network logs captured by Extension Designer individually (see Configuring Extension Designer Logs on Extension Designer Best Practices for more information about what logs are captured). When the number of archived logs for a given log (for example, extension-designer-access.log) reaches this value, Extension Designer will automatically remove the oldest log to make room for the newest as needed.

export DEP_ACCESS_LOG_BACKUPS=100 

Default value is 90