Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ import fsInventoryMenuImage from '/assets/images/freshservice-integration/fs-inv
This page covers advanced data mapping customization and XML file editing.
- For initial setup and installation, see [Setting Up the Device42 Freshservice Integration](index.mdx).
- For usage and operations, see [Using the Freshservice Integration](use-freshservice-integration.mdx).
- For help with sync and connection issues, see [Troubleshoot the Freshservice Integration](mapping-integration-troubleshooting.mdx).
:::

## Manage Customization with Newer Releases
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'
This page covers the initial setup and installation of the Freshservice integration.
- For daily usage and operations, see [Using the Freshservice Integration](use-freshservice-integration.mdx).
- For advanced data mapping customization, see [Advanced Freshservice Mapping and Customization](customize-freshservice.mdx).
- For help with sync and connection issues, see [Troubleshoot the Freshservice Integration](mapping-integration-troubleshooting.mdx).
:::

## About the Device42 Freshservice Integration
Expand Down Expand Up @@ -162,26 +163,12 @@ Now, when you're logged out of both Device42 and Freshservice, clicking the **Fr

## Troubleshooting

### Secure Tunnel Connection Error

If you see this error:

```
[ERROR] 2025-06-30T19:06:37Z main.go:327: Connection error, error: websocket: bad handshake, response: Error: secure tunnel already established with same instance ID. Is there another D42 instance running with same settings?
```

This means multiple Device42 instances are using the same GUID. Each Device42 instance must have a unique GUID. The primary should keep its GUID, and any duplicate GUIDs on other instances should be regenerated to be unique.

To action this:

1. Check the GUID on your primary Device42 instance at **Tools > Integrations > Cloud Services**.
2. Check the GUID of your other Device42 instances (hot standby, development, and so on).
3. If the instances have the same GUID, regenerate the GUID on all instances except the primary one.
4. Restart Device42 services on the instances where you changed the GUID.
If you run into problems during or after setup, such as sync job errors or Cloud Connector connection issues (including the "secure tunnel already established with same instance ID" error), see [Troubleshoot the Freshservice Integration](mapping-integration-troubleshooting.mdx) for diagnostic steps and solutions.

## Next Steps

Once you have completed the setup, you can:

- [Use the Freshservice Integration](use-freshservice-integration.mdx) for data synchronization, and understanding data flows.
- [Customize the Freshservice Integration](customize-freshservice.mdx) for advanced data mapping and XML configuration.
- [Troubleshoot the Freshservice Integration](mapping-integration-troubleshooting.mdx) for help diagnosing sync and connection errors.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'
This page covers the usage and operations of the Freshservice integration.
- For initial setup and installation instructions, see [Setting Up the Device42 Freshservice Integration](index.mdx).
- See [Advanced Freshservice Mapping and Customization](customize-freshservice.mdx) for instructions and examples on modifying the default sync.
- For help with sync and connection issues, see [Troubleshoot the Freshservice Integration](mapping-integration-troubleshooting.mdx).
:::

## Using the Integration App
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.