Welcome to the Alteryx Knowledge Base

Connect to a User-Managed MongoDB with Robo 3T

This KB provides you with steps on connecting to a User-Managed MongoDB using Robo 3T.

• Alteryx Server
  • All
• Robo 3T
• Alteryx Server Administrator privileges 

AlteryxGallery Database

Open Robo 3T > File > Connect > Create

• Connection tab
  • Select the appropiate Type that matches your MongoDB environment
  • Set Name to 'AlteryxGallery'
  • If Type is configured as 'Direct Connection':
    • Set Address as the MongoDB server hostname, for example, 'localhost'
    • Set the Port number. By default, user-managed MongoDB instances use port 27017.

• If Type is configured as 'Replica Set':
  • Add the Members found under:
    • Alteryx System Settings > Controller > Persistence > Database > Host
    • Alteryx System Settings > Controller > Persistence > Database > MongoDB Connection if you have 'Advanced User-Managed MongoDB' selected
  • Add the Set Name where applicable
    
    

• Authentication tab
  • Enable 'Perform authentication'
  • Set Database to 'AlteryxGallery'
  • Set User Name and Password used in the existing MongoDB connection
• Set Auth Mechanism to 'SCRAM-SHA-1'
• Select Test to ensure the connection is successful
• Select Save

• Select the MongoDB Connection, then select Connect, to open it in Robo 3T.

Procedure - AlteryxGallery_Lucene Database

Perform the same steps as previously, but replace any mention of the 'AlteryxGallery' database with 'AlteryxGallery_Lucene'.

Procedure - AlteryxService Database

Perform the same steps as previously, but replace any mention of the 'AlteryxGallery' database with 'AlteryxService'.