Download Stochastic Performance Logic User Manual

Some tests5 will not be performed because they require sensitive credentials which are
not distributed in the public repository.
2.2 Running the framework
The Framework is packaged in the SPL.jar 6 file located in the build/dist directory or in
the directory where the prepared package has been extracted.
To run it open shell where the SPL.jar is located and execute
java -jar SPL.jar
There are also prepared shell wrappers for running
spl.bat, spl.sh
If no arguments are specified the usage help description is printed.
2.2.1
Arguments
XML configuration file
This is the most essential argument. It is a path to the XML file specifying the
project configuration. This file describes location of the code which will be scanned
for annotations and how it will be obtained and how it will be build if necessary. It’s
a required argument. See [XML configuration file on page 23] for details.
Working directory
This argument specifies the working directory where persistent and temporary data
(including results itself) are stored. This and all following arguments are optional. If
the argument is omitted the default value is .spl in the current working directory. See
[Working directory on page 21] for details.
INI configuration file
The optional configuration may be stored in this file. For example it may contain access
information to remote machines or repositories or configuration of sampling code. See
[INI configuration file on page 30] for details.
Execution machine ID
The identification of the machine where to perform measuring. If this argument is
omitted the current machine is used for measuring. Current machine may be also
specified by “local” value of the argument. If remote machine is to be used the access
details must be specified in the INI configuration file. See [INI configuration file on
page 30] for details.
Choose interactivity
This argument specifies whether the user want to interact with the application. This
might be for example needed if remote execution is specified and the remote machine
requires password or interactive authentication. Or when credentials are required for
repository access. By default interactivity is disabled. To enable interactivity specify
5
Those tests cover Git, SVN and SSH connection to remote machines. Tests are in cz.cuni.mff.spl.deploy.build.vcs and cz.cuni.mff.spl.utils.ssh packages.
6
SPL.jar file name may include version number
17