TIP

This article assumes that you have read the getting started article.

INFO

The updated arguments (--config, --log-directory, --creds-file) are available starting from version 1.8.2. Previous options like line and creds= are deprecated in this version and should no longer be used.

Launch Arguments

The Theta Terminal can be configured to launch in different ways. This article will address all options you have at your disposal for customizing the launch.

Credentials File

Instead of specifying your login credentials as a launch argument, you can use the --creds-file option to specify a file where the credentials are stored. Specifying credentials as launch arguments could be a security risk since the launch arguments are shown on some task managers. This option resolves that security concern.

The credentials file must contain 2 lines:

• The first line is the username.
• The second line is the password.

Credentials File Contents

test@thetadata.net
mypassword123

Example

Where creds.txt is the name of the file. Providing the full path to the file might be required.

java -jar ThetaTerminal.jar --creds-file=creds.txt

Configuration File

You can specify the location of the configuration file using the --config argument. See our launching multiple terminals article for more information.

Example

Where config_0.properties is the configuration file:

java -jar ThetaTerminal.jar --config=/path/to/config_0.properties

Log Directory

To define where log files will be stored, use the --log-directory argument. This ensures that logs are written to your preferred directory.

Example

java -jar ThetaTerminal.jar --log-directory=/path/to/log/directory

Memory Allocation

You can specify the amount of memory that your system will allocate towards the Theta Terminal by including:

-Xms: The starting amount of memory the Theta Terminal consumes.

-Xmx: The maximum amount of memory the Theta Terminal can consume.

Example

To initially allocate 4GB of RAM and set an upper limit of 8GB, where username and password are you ThetaData credentials.

java -Xms4G -Xmx8G -jar ThetaTerminal.jar username password

Enter password manually

Specifying no arguments will require you to enter your password manually.

java -jar ThetaTerminal.jar

Examples for config_1.properties

Credential Files

java -jar ThetaTerminal.jar --creds-file=creds.txt --config=/path/to/config_1.properties

Memory-Allocation

java -Xms4G -Xmx8G -jar ThetaTerminal.jar username password --config=/path/to/config_1.properties

Manual Password

java -jar ThetaTerminal.jar --config=/path/to/config_1.properties