# Troubleshooting

This page contains common issues and their solution. To better understand the synchronization process that led to the error, you can try to re-run the synchronization with an additional `--verbose` option.

If you don't find your issues here, please [contact support](/specsync/jira/contact/specsync-support.md).

### Unable to find or restore package error when installing or restoring SpecSync as a .NET tool <a href="#nuget-package-not-found" id="nuget-package-not-found"></a>

When you install SpecSync as a [.NET tool](/specsync/jira/installation/dotnet-core-tool.md), you might receive errors during the `dotnet tool install SpecSync.Jira` or the `dotnet tool restore` commands. The error message might contain `Unable to find package SpecSync.Jira` or `The tool package could not be restored`.

The problem is usually that there is a custom NuGet source configured in your organization that does not mirror SpecSync packages.

**Solution 1:** For the installation you can specify the official NuGet source by adding the `--add-source https://api.nuget.org/v3/index.json --ignore-failed-sources` options to the install or restore command.

E.g. the installation with specified NuGet source would be...

```bash
dotnet tool install SpecSync.Jira --add-source  https://api.nuget.org/v3/index.json --ignore-failed-sources
```

**Solution 2:** You can change your local NuGet configuration or the `NuGet.config` file of your project to include the official NuGet source `https://api.nuget.org/v3/index.json`. Alternatively you can ask the administrator of your custom NuGet source to mirror the SpecSync NuGet packages.

### No usable version of libssl was found error when running SpecSync Linux binaries on Ubuntu 22.04 <a href="#no-usable-libssl-ubuntu2204" id="no-usable-libssl-ubuntu2204"></a>

When the Linux binary package of an older SpecSync version is executed on Ubuntu 22.04 the synchronization might fail with the error message `No usable version of libssl was found`.

This is caused by the SSL library incompatibility between .NET Core 3.1 and Ubuntu 22.04.

**Solution 1:** You can use the Ubuntu 20.04 stable version for these SpecSync versions where you can have compatible SSL packages (`libssl1.1`).

**Solution 2:** Upgrade SpecSync for Jira to v1.1.1. Those versions use .NET 6 for the Linux binaries that are compatible with `libssl3` available for Ubuntu 22.04.

**Solution 3:** The compatibility can also be achieved by downgrading and installing the necessary libssl library. This can be achieved by adding the following command to your `Dockerfile` (source: [StackOverflow post](https://stackoverflow.com/a/72137153/26530)):

```
RUN wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5_amd64.deb \
    && dpkg -i libssl1.0.0_1.0.2n-1ubuntu5_amd64.deb
```

### 'W5113: Unable to find attachment file' warnings when publishing results from TRX file <a href="#issue1668" id="issue1668"></a>

When the TRX logger is used with `dotnet test` command for running the tests to be published with SpecSync, you might encounter warnings like

* `W5113: Unable to find attachment file '<some-attachment-path>'. Ignored.`

The issue is probably caused by the TRX logger, that saves the attachment files to the test output folder (usually the `TestResults` folder of the project), but the TRX file is saved elsewhere, for example because a folder is specified for the TRX logger in the `LogFileName` setting, like `--logger "trx;LogFileName=..\results.trx`.

**Solution:** Use the `--results-directory` setting of `dotnet test` to specify the results directory, and use the `LogFileName` only to specify the file name. E.g. `dotnet test --logger trx;logfilename=results.trx --results-directory "C:\MyProject"`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.specsolutions.eu/specsync/jira/contact/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.