3. How to use - ogarling/LR2Graphite GitHub Wiki

LRlauncher is a Windows executable which is meant to be run in two modi:

  • Jenkins mode which requires five command line arguments to be provided
  • command line mode which requires two command line arguments (i.e. the path to the LoadRunner scenario file and the targets-io dashboard name)

Both modes require that LRlauncher.ini is populated with the appropriate values.

The LoadRunner scenario file script path(s) property value will be automatically modified (and a backup created with extension ".old"). The result directory property value in the LoadRunner runtime setting section (RTS) will be overridden at invoking a loadtest in the LoadRunner controller so it may contain the (local) value used when developing the script on another environment.

Spaces in transaction names of the scripts will be replaced with underscores due to incompatibility with Graphite naming. It is recommended to leave out other special characters to prevent compatibility issues.

Project directory structure

In the root of your project the following files must exist:

  • LRlauncher.ini
  • one or more LoadRunner scenario files (.lrs)
  • one or more LoadRunner script directories
  • subdirectory called "LR2Graphite" containing LR2Graphite.exe and LRlauncher.exe

Git

When using Git (will probably be the case when using Jenkins) the LoadRunner script directories and LR2Graphite helper executables can be added as git submodules.
To add the LR2Graphite helper executables as a submodule use:

git submodule add https://github.com/ogarling/LR2Graphite.git

To add LoadRunner scripts you can simply use the embedded git client in VuGen to maintain the script repository(ies).

git submodules add {repo URI}

When using Jenkins your project will probably be a Git repo as well. To update the the submodules within automatically when cloning the main repo during a build please change the
Jenkins job configuration -> Source Code Management -> Git -> Additional Behaviours ->
Recursively update submodules ENABLED
Update tracking submodules to tip of branch ENABLED
Next: Jenkins mode