## Connectivity issues

URL: https://docs.atlan.com/apps/connectors/database/trino/troubleshooting/troubleshooting-trino-connectivity

> Troubleshoot Trino connectivity with error, cause, and solution guidance.

Resolve common authentication, connection, and configuration errors when connecting Atlan to Trino. This guide covers errors that appear during test authentication, preflight checks, and crawler execution.

## Transport layer security required for basic authentication

:::danger Error
**TLS/SSL is required for authentication with username and password.**
:::

### Cause

The Trino server isn't configured to accept TLS/SSL connections or the connection attempt isn't using HTTPS.

### Solution

1. Configure TLS/SSL on the Trino server following [Trino's TLS documentation](https://trino.io/docs/current/security/tls.html).
2. Verify that the TLS/SSL certificates are valid and not expired.
3. Restart the Trino services.
4. In the Atlan crawler configuration, set **Enable TLS/HTTPS** to **True**.

---

## Transport layer security disabled with SSL verification enabled

:::danger Error
**Connection property SSLVerification requires TLS/SSL to be enabled.**
:::

### Cause

SSL verification is enabled but TLS/HTTPS is disabled in the crawler configuration.

### Solution

1. In the crawler configuration, set **Enable TLS/HTTPS** to **True**.
2. Click **Test Authentication**.

---

## Incorrect credentials

:::danger Error
**The username or the password provided to connect to the Trino account is incorrect.**
:::

### Cause

The username or password doesn't match the credentials configured in Trino.

### Solution

1. Verify the username and password are correct by logging in to Trino directly.
2. Update the credentials in the Atlan crawler configuration.
3. Click **Test Authentication**.

---

## Incorrect host address

:::danger Error
**Your Trino hostname isn't correct, provide a correct hostname and retry.**

or

**The host address provided by the user isn't correct, check the host address.**
:::

### Cause

The hostname is invalid, unreachable, or incorrectly formatted.

### Solution

1. Verify the hostname is correct and formatted as a domain name or IP address.
2. Test network connectivity to the Trino server.
3. If using a private network, verify the PrivateLink endpoint is configured correctly.
4. Click **Test Authentication**.

---

## Server connection failure

:::danger Error
**The host or port provided by the user isn't correct, check your host and port.**
:::

### Cause

The hostname or port number is incorrect, or the Trino server is unreachable.

### Solution

1. Verify the hostname and port number in the crawler configuration match your Trino server settings.
2. Verify the port (typically 8080 for HTTP or 443 for HTTPS) is correct.
3. Test connectivity using `ping <host>` or `telnet <host> <port>`.
4. Check firewall rules permit traffic to the Trino port.

---

## Authentication failed

:::danger Error
**Authentication failed: Unauthorized**
:::

### Cause

The user account doesn't have the necessary permissions to access the Trino catalogs.

### Solution

1. Verify the user has read-only access for the catalogs you want to crawl.
2. Check the `rules.json` file to verify the user is listed with appropriate permissions.
3. Verify the catalogs in the access control rules match the catalogs you want to crawl.
4. Click **Test Authentication**.

---

## Connection timed out

:::danger Error
**Connection timed out. Check your host and port.**
:::

### Cause

The Trino server isn't responding within the timeout period.

### Solution

1. Verify the hostname and port number in the crawler configuration are correct.
2. Test connectivity using `ping <host>` or `telnet <host> <port>`.
3. Check if the Trino server is running and reachable.
4. Verify firewall rules permit traffic from Atlan to the Trino server.

---

## Need help

If you need assistance after trying the steps, contact Atlan support: [Submit a request](https://docs.atlan.com/support/submit-request).

## See also

* [Trino connector limitations](https://docs.atlan.com/llms/connectors/trino/trino-connector-limitations/llms.txt): Known limitations and behaviors of the Trino connector.

---