How To: Resolve Data Lab Notifications Error

This page only applies to on-premise installations of Seeq Data Lab

Overview

This document addresses a specific error that occurs during the installation of Seeq Data Lab Email Notifications in on-premise installations. The error message "Failed to establish a new connection: [Errno -3] Temporary failure in name resolution" suggests that the Email Notifier is unable to resolve the hostname used by Seeq Data Lab.

ConnectionError: HTTPConnectionPool(host='<host>', port=34216): Max retries exceeded with url: /data-lab/9C3F6ECC-E889-42F5-A049-D6D85D0E16C3/api/contents/Email%20Notifications/Email%20Notifier.ipynb (Caused by NewConnectionError('<urllib3.connection.HTTPConnection object at 0x7fdbaf116280>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

To resolve this issue, several steps need to be taken. First, on the Seeq Data Lab server, the value of Network/Hostname should be confirmed. Using a terminal, the nslookup command can be used to verify if the server address is correctly resolved.

If the nslookup command fails to resolve the server address, adjustments need to be made. In some cases, customers may be using DNS servers, requiring the use of a fully qualified domain name (FQDN) within the network. In such cases, the Network/Hostname should be set to the FQDN.

After configuring the appropriate Network/Hostname, it is crucial to maintain consistency in the use of FQDN throughout the hostname settings on the Seeq Server. This includes ensuring that the URL used to access Seeq, as well as the Appmode URL for both the Add-on Management Tool and Email Notifications, all employ the FQDN.

Once these settings are in place, it is necessary to restart both the Data Lab and Seeq services to apply the changes and resolve the hostname resolution issue.

The subsequent sections provide instructions and recommendations for implementing these steps and resolving the error encountered during the installation of Seeq Data Lab Email Notifications.

Solution

To resolve the "Failed to establish a new connection: [Errno -3] Temporary failure in name resolution" error during the installation of Seeq Data Lab Email Notifications, follow these steps:

On the Seeq Data Lab server, verify the value of Network/Hostname.
Open a terminal and use the nslookup command to confirm if the server address is correctly resolved. If the command fails to resolve the server address, adjustments need to be made.
If DNS servers are being used and a fully qualified domain name (FQDN) is required within the network, update the Network/Hostname setting to reflect the FQDN.
Ensure consistency in the use of the FQDN throughout the hostname settings on the Seeq Server. This includes the URL used to access Seeq, as well as the Appmode URL for both the Add-on Management Tool and Email Notifications.
Once the settings are updated, restart both the Data Lab and Seeq services to apply the changes.