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
• Internet Proxy Server Setup
• Auto Start TestOptimal Server
• Enable HTTPS

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

Some companies restrict internet connection from individual computers inside company's intranet / local area network, in which case individual computers can access internet through a Proxy Server. If your company uses proxy server, you must define the proxy server host and port number in config/config.properties to allow TestOptimal server to access internet for software updates and license validation.

To define proxy server, add / modify the following config settings:

ProxyHost=myhost
ProxyPort=1234
ProxyUserID=abc
ProxyPassword=xxx

ProxyUserID and ProxyPassword are only required if your proxy server requires user id and password. If your proxy server does not require user id and password to access the internet, then leave these properties blank or delete them.

Another way to define proxy server is to set the java startup argument “-D”:

java -Dhttp.proxyHost=myproxyserver.com -Dhttp.proxyPort=80 ...

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

• Windows: scheduled task as Main, Trigger, Action, Settings
• Mac / Linux: create a cron job

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=false
 #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.

• 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.scriptIndentNum: >0 (default 3), number of spaces to indent scripts in script editors
• 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
• 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.