Welcome to the Alteryx Knowledge Base

Troubleshoot DNS Issues

Changing the gallery URL can often lead to a "website not found" error in a Windows authenticated/domain environment if a CNAME record has not been created in DNS (Domain Name System). CName records (also known as Canonical Name) are typically used to map any given name against the host providing the service, in this case, the Alteryx server hosting the gallery. When the gallery URL is changed in System Settings without adding the CNAME record, the following errors can appear.

Other symptoms include:

• The gallery website is not loading and is in a constant loading state.
• Unable to connect or upload workflows to the gallery server in the designer

To check this, Open Designer>> Click on File, Save As, Add Gallery

Enter the gallery URL and click on Connect. "Could not connect to server, please try again" is another indication that the gallery is not valid

• Alteryx Server

Diagnosis:

You can take the following steps to confirm it's a DNS-related issue. For other gallery-related issues, please reference the following article:

Gallery Service failed to start in a timely fashion

Is the URL resolvable? To check this

1. Open Command Prompt
2. Type "nslookup" followed by the URL without http and gallery. (Example: if the URL is http://mygallery123.com/gallery, then the command is "nslookup mygallery123.com").
3. If the CNAME record does not exist in DNS, the following results will be shown

Accessing the gallery using the IP address of the gallery server.

1. Open the web browser
2. Enter the URL, replacing the CNAME with the Server IP address hosting the gallery (Example: if the URL is http://mygallery123.com/gallery, replace with http://192.168.9.2/gallery)
3. If the gallery successfully loads, then this is another indication of a DNS issue.

The following external link shows how to find the IP Address of the Alteryx Server. Note: you must run the cmd from the server -IP address in Windows 10 from cmd (Command Prompt)

Please check additional resources section for gallery URL related issues.

Solution:

DNS entries are typically managed by the IT department. Please consult with your internal IT to complete this process. This solution covers the windows server platform.

1. Open DNS Manager and select the forward lookup zone for your domain.
   
   

1. Right-click on the Zone, then select New Alias (CNAME)

3. On the next window
   1. Fill in the Alias Name field with the name you want to use. For example mygallery123
   2. Fill in the FQDN for the target host field with the target host or browse to select from the available records. The target host is the Server hosting gallery.
   3. You can choose to tickDelete this record when it becomes staleoption. When enabled, this option willconvert your CNAME record into a dynamic record.Otherwise it isstatic by default.
   4. You can also tick theAllow any authenticated user to update all DNS records with the same nametoallow automatic update of this CNAME recordif the information on the target host record is changing overtime, such as when the server is using DHCP.

5. Click OK to complete the entry

Note: The new gallery URL may not work immediately as your machine caches previous DNS entries that have not expired yet. You can clear this manually by typing "ipconfig /flushdns" in command prompt on your local machine.