> For the complete documentation index, see [llms.txt](https://community-test.logicnets.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://community-test.logicnets.com/release-9/platform-documentation/advanced-topics/external-document-storage/ess-basics/troubleshooting-external-document-storage.md).

# Troubleshooting External Document Storage

The following information may help you troubleshoot issues you may have when integrating your LogicNets applications with external storage systems.

### Document is not Closed Properly

When loading the document LogicNets will display an error page when the LogicNets System is started with a ESS-document/report-key that has been used previously but for which the session was not (properly) closed (using the *Submit*, *Save*, or *Cancel* button). This mechanism ensures that a document is not opened twice by the same user or by a different user at the same time.

![](https://2802811211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdFhfexCjZ5JMhwGzzywq%2Fuploads%2Fgit-blob-ccb7c2ab688914f14c6963d578c493e9a9418286%2F28b58cc8-0e22-44bb-92ad-5f4063d52c16.png?alt=media)

If you click *Cancel*, LogicNets aborts loading the document and displays a page that allows you to close the browser tab or redirect the web browser to the ESS webpage.

When you click *Reload*, the system reloads the document from the ESS webpage and loads the document into the LogicNets application. The system closes other LogicNets sessions that had this document opened.

### Connect Setup to the ESS Web Service Failed

If an error occurs during the connection to/setup up the ESS, the error is frequently caused by a misconfiguration of the ESS connection. They system displays the error screen below, and you should contact your system administrator for further information and help.

![](https://2802811211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdFhfexCjZ5JMhwGzzywq%2Fuploads%2Fgit-blob-421596f772c2d357f2277c6fc050e0a5b94fc0b3%2F78e60830-627f-4172-ae64-cfde91e04a3e.png?alt=media)

### Common Error Messages

| Error Message                             | Description                                                                                                                                                     |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Unknown connect error*                   | The system can reach the host but the socket on the ESS is not opened for receiving a connection.                                                               |
| *Cannot connect*                          | The ESS hostname is not correctly configured if you used HTTPS.                                                                                                 |
| *Host not found*                          | The ESS hostname is not correctly configured if you used HTTP.                                                                                                  |
| *Error initializing locations*            | The path to the HTTPS server certificate is not valid or the certificates in that configured path are not valid.                                                |
| *Unable to get server issuer certificate* | The server certificate cannot be validated. Please check whether all certificates in the server certificate chain are saved in the configured certificate file. |
| *Could not set client certificate key*    | The configured client certificate private key is corrupt or the private key does not belong to the configured client certificate.                               |
| *Failed to set client certificate*        | The configured client certificate is corrupt.                                                                                                                   |
| *HTTP Error 403.16 - Forbidden*           | Your client certificate is either not trusted or is invalid.                                                                                                    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://community-test.logicnets.com/release-9/platform-documentation/advanced-topics/external-document-storage/ess-basics/troubleshooting-external-document-storage.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.