Skip to main content

Platform Configuration Methods

The Designer Cloud Powered by Trifacta platform supports multiple methods of configuration.

Warning

Do not make changes through multiple configuration interfaces at the same time. Saved changes can completely overwrite the platform configuration file, removing any unsaved changes from another method.

Admin Settings page

Through the Admin Settings page in the application, platform administrators can perform most configuration tasks.

Note

The Admin Settings page is the recommended method for applying configuration changes to the Designer Cloud Powered by Trifacta platform. Entries are validated against known types, and the platform is automatically restarted when you save your changes.

Minimum requirements

To use the Admin Settings page, please verify that the following have been completed:

  1. Install and initialize the databases. See Install Databases.

  2. Install or upgrade the Alteryx software on the node. See Install.

  3. Start the platform. See .Start and Stop the Platform.

  4. See below for access.

Access

  1. Login to the application as an administrator.

  2. Select User menu > Admin console > Admin settings.

  3. Perform your configuration tasks as needed.

In the documentation, JSON configuration items that are available through this page are described using dot notation, as in the following example:

"webapp.bodyParser.json.limit": "10mb",

Tip

In the Admin Settings page, you can paste the property name without quotes into the search box:webapp.bodyParser.json.limit

Limitations

The Admin Settings page is not useful for the following configuration scenarios:

  • Changing the configuration when the application is not available.

  • You cannot add or delete parameters through this interface.

  • Some platform integrations require configuration changes to files other than trifacta-conf.json. These changes are described later in the documentation.

In the above scenarios, you should apply your changes through trifacta-conf.json.

Note

When a change is saved through the Admin Settings page, the entire trifacta-conf.json file is overwritten.

For more information, see Admin Settings Page.

Workspace Settings Page

In the Workspace Settings page, you can review a set of feature enablement and Trifacta Application settings that can be modified on a per-workspace basis.

Tip

Over time, more settings from the Admin Settings page and trifacta-conf.json will be migrated to this page. For more information, see Changes to Configuration.

For more information, see Workspace Settings Page.

trifacta-conf.json

On the Trifacta node, you can edit the configuration file directly if necessary.

  1. Login to the Trifacta node as an administrator.

  2. Edit the following file: trifacta-conf.json.

  3. Make changes as necessary.

  4. In the documentation, configuration items may be listed in either JSON dot notation or in hierarchical JSON notation, as in the following:

    "webapp": {
      ...
      "timeoutMilliseconds": 2000,
      ...
     
    },

    Note

    The ellipses in the configuration indicate that there are unlisted parameters in the actual configuration. Typically, you should search for the final parameter name.

    Note

    In trifacta-conf.json, all values in the spark.props section or hadoopConfig section must be quoted values, as these values are passed to services external to the platform.

  5. Save the file and restart the platform. See Start and Stop the Platform.

Database Configuration

Where possible, you should use the Admin Settings page for making configuration changes to the databases. See Admin Settings Page.

For more information, see Install Databases.