3.31.2 Parameters for the test executor

  1. Once you have browsed to the Jubula installation directory and entered "testexec.exe", you can enter the parameters for the test execution.
  2. The test executor has various parameters 2:
    \includegraphics[height=2cm]{lightbulb} A list of language codes is available in the reference manual (-->Reference Manual [*]).

    Detail Parameter
    Help "-h"
      Gives parameter help
    Project name "-project <project name>"
      e.g. -project ''ExampleProject''
    Project version "-version <project version>"
      e.g. -version ''1.3''
    AUT configuration name "-autconfig <configuration name>"
      e.g. -autconfig ''localconfiguration''
      Use when starting an AUT via a configuration.
    AUT ID "-autid <ID>"
      e.g. -autid ''SimpleAdder1''
      Use when AUT was started via autrun.
    Configuration file "-c <path to configuration file>"
      e.g. -c ''C:/Program Files/guidancer/config''
      Use this instead of entering all arguments
      via the command line.
    Workspace "-data <path to workspace>"
      e.g. -data ''C:/Users/Test''
      The Jubula workspace with the preference
      settings for the Database connection
    Database scheme "-dbscheme <scheme>"
      e.g. -dbscheme ''embedded''
    Database username "-dbuser <username>"
      e.g. -dbuser ''username''
    Database password "-dbpw <password>"
      e.g. -dbpw ''password''
    Server "-server <AUT Agent hostname>"
      e.g. -server ''localhost''
    Port number "-port <port number>"
      e.g. -port ''60000''
    Language "-language <language code>"
      e.g. -language ''en_US''
    Test Suite "-testsuite <testsuite name>"
      e.g. -testsuite ''suite1''
      Use to start a Test Suite
      Only one Test Suite or Test Job can be started
    Test Job "-testjob <testjob name>"
      e.g. -testjob ''job1''
      Use to start a Test Job
      Only one Test Suite or Test Job can be started
    Data directory "-datadir <path to external"
      "test data directory>"
      e.g. -datadir ''C:/Program Files/Test/Data''
    Result directory "-resultdir <path to directory>"
      e.g. -resultdir ''C:/Program Files/Test/results''
    No run option (optional) "-n"
      e.g. -n
      Checks if the Test Suite is startable.
    Quiet option (optional) "-q"
      e.g. -q
      Does not give out test information.
    Database URL (optional) "-dburl <URL>"
      e.g. -dburl ''db.example.de''
      If no URL is given, the default will be used.
    Timeout (optional) "-timeout <timeout in seconds>"
      e.g. -timeout ''3600''
      Enter an optional timeout for the command line client.
    No screenshot (optional) "-s "
    Test results not relevant (optional) "-r "
      Flags the test results as not relevant
      in the test result summary 3.22.8.

  3. You can either enter a Test Suite to be executed or a Test Job . Only one of these two commands is accepted for the test executor.
    \includegraphics[height=2cm]{lightbulb} If you are starting a Test Suite , Jubula will start your AUT from its configuration if you have entered one. If you are starting a Test Job , you must make sure that the first AUT you require is already started with the autrun command. Other AUT's required during the test must either also be started already, or started as a part of the test itself.
  4. If the AUT you want to test was started with the autrun command, you must enter an AUT ID. If your AUT will be started with an AUT configuration, then enter the configuration name.

    \includegraphics[height=2cm]{lightbulb} The test executor also accepts arguments to pass on to the Java Virtual Machine. This means that you can, for example, increase the initial and maximum amount of system memory allocated to the JVM with the parameters "-Xms<memory_size>" and "-Xmx<memory_size>", respectively. For example, the parameter "-Xmx128M" would make a maximum of 128 MB of system memory available to the test executor. When entering the standard parameters for the test executor, you may add "-J<JVM_parameter>" for each JVM parameter you wish to set. For example, "-J-Xmx128M". Multiple parameters, like standard parameters, are separated by spaces.
    Here is an example of defining mutliple JVM parameters: "-J-Xmx128M -JXms128M".

  5. Using the no run option will check the completeness of the Project , test data and the validity of the Database connection. The AUT Agent connection is not checked.
  6. Once you have entered all the necessary parameters, press »ENTER«.
  7. The client will connect to the AUT Agent , connect to the Database , open the Project , start the AUT (for Test Suites ) or connect to it (for Test Jobs ) and then execute the Test Suite or Test Job you specified.
  8. Once the test has finished, the client will show an exit code.
    \includegraphics[height=2cm]{lightbulb} To stop the test execution, use »CTRL+C«

Copyright BREDEX GmbH 2012. Made available under the Eclipse Public License v1.0.