Troubleshooting

Some common setup issues encountered while attempting to use JadeGit and steps to resolve are covered below.

Cannot sign-on to Jade IDE

When the library cannot be loaded during the IDE start-up, Jade shows an error message indicating you don't have access to the class browser. If you check the jommsg log and see a message indicating the jadegitdev library/module cannot be loaded (or similar name), check the following:

• Check INI file to confirm JadeSecurity.DevelopmentSecurityLibrary has been configured correctly to use the jadegitdev library and it's in the bin folder (along with other JadeGit binaries).

• Try running jadegit --version from the command line (in the bin folder). If there's no output, there may be a missing component or something is blocking it. Running the exe directly from windows explorer may display a more meaningful error message.

• If it's failing to find/load a library, check the latest VC++ redistributables have been installed.

• If it's blocked (by Microsoft Defender), run Unblock-File jadegit*.* from PowerShell (in the bin folder), and try again.

Config value 'user.name' or 'user.email' was not found

When attempting to commit changes, you may see an error like this which indicates your user name or email hasn't been configured within git.

Assuming git is installed (JadeGit depends on Git for Windows), use the following commands to configure your user name and email (via Git Bash, PowerShell or another command line interface).

git config --global user.name "<Full Name>"
git config --global user.email "<Email Address>"

Use the following command to check what has been set (before or after):

git config --global --list

Remote Operations

The following issues may be encountered while attempting to connect & authenticate with a remote repository provider (i.e. Azure DevOps, GitHub, GitLab).

Failed to send request: The connection with the server was terminated abnormally

This error occurs when the proxy hasn't been configured. If it's been reconfigured recently, try restarting to ensure changes have taken effect, otherwise check proxy has been configured.

There are two options for configuring the proxy:

• Configure proxy using git config (which will just affect git clients).

git config --global http.proxy http://username:[e-mail]:port
git config --global https.proxy http://username:[e-mail]:port

• Configure proxy using HTTP_PROXY environment variables (which will affect other software using these).

The system cannot find the file specified

This error occurs when a git command cannot be invoked from the command line, because the location of the git binary cannot be found in the Path environment variable. This is needed by JadeGit to invoke git credential commands during authentication.

Check Git is installed, and command can be invoked from the command line. If not, check the Path environment variable has been updated to include the relevant path to the git cmd folder. If this has been updated recently, restart & try again.

ServicePointManager does not support proxies of HTTPS scheme

Check the HTTPS_PROXY environment variable or git https.proxy config setting is prefixed with 'http://'. Refer to this stackoverflow question for further info.