This is an old revision of the document!


Server Configuration

TestOptimal has two configuration files:

  • config/application.properties - server settings, e.g. port#, SSL, etc.
  • config/config.properties - controls features in TestOptimal

You may perform customization by adjusting the settings in the above properties file.

Below is a list of typical customization:


Change Server Port

By default, TestOptimal Server listens on port 8888. You may change it to a different unused port by editing config/application.properties as an example below:

 server.port=8000

Auto Start TestOptimal Server

You may set up a scheduled job to auto start TestOptimal Server by running startTestOptimalServer.bat/sh:

  • Windows: scheduled task to run startTestOptimalServer.bat following these steps: Main, Trigger, Action, Settings
  • Mac / Linux: create a cron job to run startTestOptimalServer.sh

Enable HTTPS

You may enable HTTPS using the self-signed certificate bundled in the download package by editing config/application.properties file per instruction in the file (example below):

 ### support HTTPS: to enable HTTPS, uncomment out following settings and set server.ssl.enabled=true
 server.ssl.enabled=true
 server.ssl.key-store-type=PKCS12
 server.ssl.key-store=classpath:keystore/to.p12
 server.ssl.key-store-password=test@optimal
 server.ssl.key-alias=testoptimal
 security.require-ssl=true

If you wish to use your own certificate, you will need to copy your certificate file into /src/main/resources/keystore/ folder and adjust server.ssl.key-store setting accordingly.

All TestOptimal Servers to must have consistent HTTPS settings.


config/config.properties

  • Exec.DelSnapScreenOnModelStart: Y/N, auto clear files in snapscreen folder before model execution
  • Exec.vu.ThreadPoolSize: >0 (default 5), max number of threads allowed for each virtual user (VU) - Concurrent models only
  • Graph.printPlantUML: true/false (default false), internal use
  • IDE.msgHideMillis: >0 (default 5000), number of milliseconds to hide system/alert messages
  • IDE.playModelDelay: >0 (default 100), pause in milliseconds used in Play model
  • IDE.shortcuts.xyz: ide toolbar, use menu to customize
  • modelFolder: absolute file path for model folder (default “”)
  • security.installation.id: identifier (default TOSVR), id to differentiate multiple TestOptimal server suites
  • security.trusted.ip.addresses: ip addresses separated by comma (default *), server white list (SvrMgr server only)
  • security.password.xyz: password, xyz is email address you registered, password is encrypted. To change password: shut down server and enter new password. New password will be encrypted automatically when server is re-started.
  • svrmgr.host: host name (default localhost), SvrMgr to upload execution stats (Runtime Server only)
  • svrmgr.port: port number (default 8888), see svrmgr.host above
  • Startup.SyncModel: Y/N (default N), auto refresh models from SvrMgr on server startup - Runtime Server only
  • Model.archive.includeRegExp: regular expression on file names to be included in the archive, default “.*\.(gvy|json|txt|ds|tsv|xls)$”
  • License.Ack*: Y/N (default N), set it to N to force prompt to create account, server restart required
  • License.Check*: encoded, internal use only
  • License.Email*: licensed email address
  • License.LicKey*: license key

* To reset license and security, shut down server, remove all settings “License.*” and restart server.