FAQs

Installation

Where’s the gauge executable installed by default?

OS Path
Windows %ProgramFiles%\gauge\bin
MacOS/Linux /usr/local/bin

Where are the plugins installed?

OS Path
Windows %APPDATA%\gauge\plugins
MacOS/Linux ~/.gauge/plugins

What is GAUGE_HOME?

GAUGE_HOME environment variable can be used to customize config files and plugins installation location.

How can I manually install a plugin?

Download the plugin distributable zip file and install it using the -f flag.

gauge install plugin_name -f path_to_zip_file

Execution

Why do I get validation failure warning?

[WARN] Validation failed. The following steps have errors
...

Check if the step is implemented. The steps are case sensitive, check if the cases match.

Why does the runner fail to start?

Failed to start a runner. Compatible runner version to 0.0.7 not found

The language plugin is not compatible with the gauge version installed. Run

gauge install language_name

Why are there too many open files?

Error: too many open files

The upper limit to the number of open files is low. Increase the upper limit by adding a command ulimit -S -n 2048 to you ~/.profile. Don’t forget to re-login for the changes to take effect.

Why can’t gradle execute gauge specs, despite adding a task as per the document?

* What went wrong:
A problem occurred evaluating root project 'INDYGauge'.
> Could not get unknown property 'GaugeTask' for root project 'INDYGauge' of type org.gradle.api.Project.

This can happen when gradle is unable to recognize the GaugeTask. Try using the fully qualified name for GaugeTask as below: .. code-block:: console

task customGauge(type: com.thoughtworks.gauge.gradle.GaugeTask) {
gauge {
specsDir = ‘specs’ env = ‘default’ tags = ‘tag1’ inParallel = true nodes = 4 additionalFlags = ‘–verbose’

}

}

IDE

Configuration

Note

Gauge specific properties are stored in gauge.properties under gauge configuration folder. Refer to Gauge Properties.

How can I increase the language runner timeout?

By setting

runner_connection_timeout = 3000

Logs

Where does gauge log the test execution output. warnings, validation results etc?

You’ll find the logged at logs/gauge.log in your projects directory.

Note

logs is the default location for log files. This can be changed using logs_directory in project’s properties.

Where can I find gauge core API logs for debugging IDE plugins?

You’ll find that at logs/api.log in your projects directory.

Note

logs is the default location for log files. This can be changed using logs_directory in project’s properties.

How can I customize the log directory location?

You can specify a custom directory by changing the logs_directory property under env/default/default.properties Refer to project’s properties.

logs_directory = my_custom_log_directory

Where does gauge non project specific logs like plugin installation etc.?

OS Path
Windows %APPDATA%\gauge\logs
MacOS / Linux ~/.gauge/logs