Gallery

Version:
Current
Last modified: October 16, 2020

The Gallery is a cloud-based application for publishing, sharing, and executing workflows. It communicates with the service to manage and execute workflows. Gallery uses a MongoDB persistence layer for state maintenance. This allows you to deploy the Gallery across multiple servers behind a load balancer (not provided as part of the architecture) to support horizontal scalability.

The Gallery is a private website, hosted on your server infrastructure that allows internal users to share workflows, apps, and macros. Alteryx also offers a Public Gallery (https://gallery.alteryx.com/) where users can sign up and share workflows, apps, and macros.

Configure the Gallery component on the Gallery screens in System Settings. The Gallery screens are available for configuration if you've selected 1 of these options on the Environment > Setup Type screen: 

  • Complete Alteryx Server
  • Custom > Enable Gallery

Gallery General

The Gallery General screen has configuration options, such as where you want to store temporary files and log files.

Gallery Workspace

The Gallery Workspace is the location where the Gallery stores temporary files. By default, it is a folder within the global workspace folder. This path should point to a location that is safe to store large amounts of files.

  • Logging Directory: This is the location where you want to store Gallery log messages. Visit Configure and Use Server Logging for more info. 
  • Base Address: This is the URL that users use to go to the Gallery. 
  • Enable SSL: Enabling SSL changes the URL in the Base Address field to https. If your certificate is set to a port other than the default 443, include the port in the URL (for example, https://localhost:445/gallery/). See Enable Gallery SSL.
  • Default Run Mode: Run Mode determines the workflows that Gallery users can run. Use Default Run Mode to block workflows with specific tools or directory access from running in the Gallery.

    Semi-safe and Safe are only available if you have enabled the Run As setting in System Settings on the Worker > Run As screen or if you have specified Run As. See Worker and Credentials for more information.

    If your Default Run Mode is Safe or Semi-safe, Gallery admins can change the run mode in each workflow on the Workflows page in the Gallery Admin interface. See Workflows.

    • Unrestricted: Gallery users can run any workflow.
    • Semi-safe: Block Gallery users from running workflows that read data from or write data to a location that is not within the workflow staging directory (workspace).
    • Safe: Block Gallery users from running workflows that read data from or write data to a location that is not within the workflow staging directory (workspace). Gallery users are also blocked from running workflows that use specific tools, events, and data connectors. See 

      Safe and Semi-safe Run Modes: Blocked Tools, Events, and Data Connectors.

Gallery Authentication

The Gallery Authentication screen has configuration options for the type of authentication you want to use to access the Gallery. Server supports built-in authentication, integrated Windows authentication with or without Kerberos support, and SAML authentication. Visit Set Up Gallery Authentication for detailed steps for setting up your Gallery's authentication.

Gallery SMTP Configuration

The SMTP screen has configuration options for enabling SMTP. The information on the SMTP page is required for Server to send email notifications for various events, such as registering your Gallery account, changing your password, or sharing a workflow.

  1. Enter the email address from which you want emails to be sent in From Email.
  2. Enter the email service hostname in Host.
  3. Enter a username and password in Username and Password, if the SMTP server configuration requires it.
  4. Select Test to send a test email to the email address in From Email.
  5. The port default is 25 as this is standard for SMTP. You can customize this port if necessary.
  6. If the SMTP server is set up to use SSL, select the Use SSL checkbox.

Deselect Enable SMTP to complete the Server setup without enabling SMTP. Email notifications from the Gallery are disabled until SMTP settings are configured.

Gallery Persistence

On the Gallery Persistence screen, specify where you want to store Gallery information, like users, collections, etc.

By default, both Web Persistence and Search Persistence are set to use the same settings as those specified for the controller on the Controller > Persistence screen. See Controller.

Use Advanced Connections

Select Use Advanced Connections if you do not want to use the same location as specified for the controller or if you require support for these...

  • TLS/SSL
  • Replica Sets
  • Sharding
  • MongoDB Atlas

If you were using replica sets before the availability of the connection string option (2019.4 release), you have to change to a connection string.

When you select. Use Advanced Connections, the Web Persistence and Search Persistence sections display a Connection field for you to specify your MongoDB connection string.

Screenshot of gallery persistence settings with Used Advanced Connections option selected

Connection String Tips and Examples

  • Supported connection string parameters are driver dependent. Parameters must be supported by all below listed supported drivers to be used in a connection string. Supported driver versions include...
    • c 1.15 (mongoc)
    • c++ 3.4.1 (mongocss)
    • c# 2.7.2 (mongoc#)
  • Special characters in usernames, passwords, or parameter values must be URL encoded.

Web Persistence Examples

  • On-premise, single-node example with SSL/TLS:

    mongodb://username:P%40ssw0rd@hostname.domain.tld:27017/AlteryxGallery?authSource=databasename&ssl=true

  • On-premise, replica set, example with SSL/TLS:

    mongodb://username:P%40ssw0rd@host01.domain.tld:27017,host02.domain.tld:27017,host03.domain.tld:27017/AlteryxGallery?authSource=databasename&replicaSet=rs0&ssl=true

  • Atlas example:

    mongodb+srv://username:P%40ssw0rd@host-0-1mngx.mongodb.net/AlteryxGallery?retryWrites=true&w=majority

Search Persistence Examples

  • On-premise, single-node example with SSL/TLS:

    mongodb://username:P%40ssw0rd@hostname.domain.tld:27017/AlteryxGallery_Lucene?authSource=databasename&ssl=true

  • On-premise, replica set, example with SSL/TLS:

    mongodb://username:P%40ssw0rd@host01.domain.tld:27017,host02.domain.tld:27017,host03.domain.tld:27017/AlteryxGallery_Lucene?authSource=databasename&replicaSet=rs0&ssl=true

  • Atlas example:

    mongodb+srv://username:P%40ssw0rd@host-0-1mngx.mongodb.net/AlteryxGallery_Lucene?retryWrites=true&w=majority

See the MongoDB Connection String documentation for help formatting your connection string.

Web Persistence

Select Use Controller Persistence Settings to use the same location as specified for the controller on the Controller > Persistence screen. This is the default option for Gallery web persistence. See Controller.

If you want the Gallery to use a different MongoDB connection than the controller, chose 1 of these:

OR

  • Uncheck Use Controller Persistence Settings and specify the Host, Database nameUsername, and Password.

Search Persistence

Indices for search functionality within the Gallery are also stored in the MongoDB.

Select Same settings as Web Persistence to use the same location as specified for web persistence. This is the default option for Gallery search persistence.

If you want the search indices to use a different MongoDB connection than web persistence, chose 1 of these:

OR

  • Uncheck Same settings as Web Persistence and specify the Host, Database Name, Username, and Password.

What's Next?

Configure Engine.

Was This Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support.