Troubleshooting

The troubleshooting process starts with gathering details and eliminating variables that do not cause the problem.

Then, we develop a hypothesis and attempt to fix it based on the gathered information.

Gathering details

Turn on trace log

There are two options to starting debugging/tracing the issues.

• Specify the SNAKE_LOG_TRACE=true environment variable while starting Snake Runner.
• Add the following lines into your configuration file.

Restart the runner after applying one of those options.

Check logs

• Docker / Linux:

  docker logs snake-runner | tee snake-runner.log
  

• Windows:

  Get-WinEvent -ProviderName snake-runner > snake-runner.log
  

Known issues

Windows and OpenSSH ssh-agent

The ssh-agent, distributed by openssh and installed on Windows using Add-WindowsCapability PowerShell cmdlet, is not supported.

Please install Git-BASH from the official site and add it to your system %PATH.

Unable to clone SSH repositories

Consider using HTTP(s) for fetching Git repositories if your company doesn’t allow to use SSH.

Using HTTP(s) for cloning

Contacts

Contact us and we will be glad to assist you with any technical problems.

• Slack: slack.reconquest.io
• Email: we@reconquest.io
• Service Desk: reconquest.atlassian.net