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:
Install and initialize the databases. See Install Databases.
Install or upgrade the Alteryx software on the node. See Install.
Start the platform. See .Start and Stop the Platform.
See below for access.
Access
Login to the application as an administrator.
Select User menu > Admin console > Admin settings.
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.
Login to the Trifacta node as an administrator.
Edit the following file:
trifacta-conf.json
.Make changes as necessary.
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 thespark.props
section orhadoopConfig
section must be quoted values, as these values are passed to services external to the platform.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.