TestOptimal Wiki

Model-Based Testing (MBT)

User Tools

Site Tools


Server Configuration

»Menu: Help / Configure Server

Server Configuration allows you to view and edit configuration settings for your TestOptimal installation.


You can access Server Configuration from Help menu, select Server Configuration.

For security reason, Server Configuration can only be changed when accessed from localhost.

Commonly Uesd Settings

  • Email Address: licensed email address
  • Edition: TestOptimal edition
  • TestOptimal Ver: edition of TestOptimal currently installed
  • Release Date: date of TestOptimal release build
  • Category Code(s): for Runtime editions, used by SvrMgr to determine type of models this server can execute.
  • Admin Users - list of users to be given the admin permission. Admin users have full authority to change system configuration and access to all models. (Release 3.0)
  • Auth Class - user authentication java class. see Authentication Setup
  • Auth Realm - when authentication is enabled, this field will be displayed on the web browser basic authentication window. (Release 3.0)
  • Server Manager URL: used for checking in models to SvrMgr and submit batch of models to execute on Runtime servers managed by SvrMgr.
  • shortcut keys - define shortcut keys
  • MScript Wrap - To turn word wrapping on/off in MScript Editor.
  • MScript Auto-Format - if to wrap the attributes of long MScript tags to separate line
  • MScript Indent Char# - number of characters to indent nested MScript tags
  • Delete SnpScreen - if to delete all snapshot screen files before each model execution
  • Auto Start IDE - automatically opens IDE when you login to the system.
  • Check AUT - if to auto check AUT mode when model opens.
  • Show State Flags - to select what flags to be displayed on state header. Default R (requirement)
    • A: state activate type (Concurrent/Load models only)
    • D: if data set is used
    • R: requirements tags
    • S: stereotype
    • V: if setting variables in state triggers (MScript)
  • Show Transition Flags: to select what flags to be displayed next to transition label. Default R,D to display requirement tags and data set indicator
    • D: if data set is used
    • F: if transition is from a final substate of a submodel
    • G: if guard condition or guard triggers are used
    • R: requirement tags
    • S: stereotype
    • T: show number of traversals for transitions that requires more than one or is optional, format T:n where n is the number of traversals required
    • V: if setting variables in transition triggers (MScript)
    • W: show transition weight for transitions that have default weight=5. Weight is displayed in the format: W:n where n is the transition weight
    • appium.startup.sleepMS - number of milliseconds to wait for Appium server to start, default 2000.

Advanced Settings

Other configuration settings you can specify by editing /www/MbtSvr/config/config.properties file:

  • modelFolder - change the default location of model folder, supply absolute file path to “model” folder
  • custom tokens - add custom tokens to be used in MScript.
  • MScript Log - configure MScript log auto-purging criteria
  • admin config - other admin configuration settings
  • Server Manager URL - URL to Server Manager, used to run model remotely on Runtime servers managed by Server Manager, requires EnterpriseEdition with LoadPlugin
  • SyncModel - Y or N, if to auto sync models from Server Manager, requires Server Manager URL has been set in Config. Default Y. Only applicable for float license
  • SyncModelKeepVerNum - number of archive versions for models to keep in Server Manager. Default value is 5. Only applicable for float license
  • SyncModelPerformDelete - Y or N, if to delete the models that do not exist in Server Manager. Default value is N. Only applicable for float license
  • Java Mail Setup - you may set up javaMail to send email notification from MScript
  • Graph.traversal.allstate - Y or N, if traversal graph should include states that are not covered. Default N.
  • StartSvrTimeoutMillis - runtime server startup timeout used by Server Manager. Default 30 seconds.
  • EXEC.QLENGTH.MAX - maximum queue length allowed for concurrent transitions, default 200
  • EXEC.THREADPOOL.SIZE - concurrent execution threads within each virtual user, default 10
  • enableUnsecuredOsCmd - to enable (Y) or disable (N) unsecured running os command on this server remotely. Default is disabled.

All these configuration settings are stored in /www/MbtSvr/config/config.properties. There are many other configuration settings which you can change to meet your needs. You can edit config.properties file to set those setting that are not in the Server Config dialog.

Configure Security

NOTE: If you are looking for how to handle popup login window of your web applications, this topic is covered in Web Login Handling.

By default, security is not enabled for your TestOptimal server. That is, anyone can knows the url to your TestOptimal server will be able connect to your server and modify your model. Therefore, it is highly recommended to have the security enabled.

Enable Security

The security is enabled in two steps: specifying user authentication and setting user authorization as described below.

  • user authentication is to validate the user id and password against the predefined user domain.
    • TestOptimal supports several ways to authenticate users. The authentication is specified in Help / Config page. Be sure to add your self as an admin user by entering your user id to the Admin User field.
  • user authorization is to give authenticated user the access to the system and models.
    • By default, any users who are authenticated can access all models in the system. But you can limit each model to a set of users only. This is done by specifying a list of user ids in model property. The user ids must be separated by semi-colon “;”. Leave this field empty to allow all users to access the model.
    • Admin user(s) automatically are authorized to all models.

You must restart TestOptimal server and re-open browser to make the changes effective.

Startup Arguments

TestOptimal server is a java application and can be customized through command arguments. To edit the command arguments, edit the file startTestOptimalServer.bat on Windows or startTestOptimalServer.sh on Mac/Linux.

  • -port nnnn: to change TestOptimal listening port#. The default is 8888. TestOptimal uses two consecutive ports, by default 8888 and 8889 are used.
  • -lic licenseKey: to reset the license key every time the server is started.
  • -email emailAddress: to reset the email address every time the server is started.
  • -logLevel level: to set the server log level which changes the amount of debugging messages written to the server log file.
    • SEVERE (highest value)
    • INFO
    • CONFIG
    • FINE
    • FINER
    • FINEST (lowest value)
  • -mscriptLogLevel level: to set the MScript log level, see valid log level described above.
  • -domain domainName: to set the domain for the server, useful for SvrMgr that runs on a different domain than the Runtime servers.
  • -logLimit nnn: to limit the server log file to a specific file size and rotate among 5 server log files. nnn is file size in kb.

Config Twitter

Set of MScript functions are created to post and retrieve twitter messages. This allows you to automatically tweet messages into the twitter account from MScript.

For example you can post an update status message when model execution completes or when it encounter errors.

Config Settings

In order to use twitter functions, you must first configure twitter account in config.properties:

  • twitter.consumerKey - consumer key for your registered twitter application
  • twitter.consumerSecret - consumer secret key for your registered twitter application
  • twitter.accessToken - access token for the twitter account to post updates to.
  • twitter.accessSecret - access secret key for twitter account to post updates to.

Twitter Registration

  • Register your application to obtain consumerKey and consumeSecret at http://twitter.com/oauth_clients/new.
  • Acquire accessToken and tokenSecret by granting the registered application (above) to the twitter account which the status message will be posted to.

Internet Proxy Server Setup

If your computer is connected to an internet proxy server to access internet, you must configure TestOptimal server to connect to the proxy server. Please refer to Internet Proxy Server Setup for more details.

config.txt · Last modified: 2017/12/24 01:55 by admin