Skip to main content

Connectivity issues

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​

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.
  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​

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​

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​

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​

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​

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​

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.

See also​