Contents:
This guide takes you through the steps for installing Designer Cloud Enterprise Edition software on CentOS or Red Hat.
For more information on supported operating system versions, see System Requirements.
Preparation
Before you begin, please complete the following.
NOTE: Except for database installation and configuration, all install commands should be run as the root user or a user with similar privileges. For database installation, you will be asked to switch the database user account.
Steps:
- Set the node where Designer Cloud Enterprise Edition is to be installed.
- Review the System Requirements and verify that all required components have been installed.
- Verify that all required system ports are opened on the node. See System Ports.
Review the Desktop Requirements.
NOTE: Designer Cloud Enterprise Edition requires the installation of Google Chrome on each desktop. Additionally, two plugins must be enabled and of sufficient versions to properly use the Trifacta Photon client. For more information,. see Desktop Requirements.
Review the System Dependencies.
NOTE: If you are installing on node without access to the Internet, you must download the offline dependencies before you begin. See Install Dependencies without Internet Access.
- Acquire your License Key.
Install and verify operations of the datastore, if used.
NOTE: Access to the Spark cluster is required.
Verify access to the server where the Designer Cloud Powered by Trifacta platform is to be installed.
Cluster Configuration: Additional steps are required to integrate the Designer Cloud Powered by Trifacta platform with the cluster. See Prepare Hadoop for Integration with the Platform.
Installation
1. Install Dependencies
Without Internet access
If you have not done so already, you may download the dependency bundle with your release directly from Alteryx Inc. For more information, see Install Dependencies without Internet Access.
With Internet access
Use the following to add the hosted package repository for CentOS/RHEL, which will automatically install the proper packages for your environment.
# If the client has curl installed ... curl https://packagecloud.io/install/repositories/trifacta/dependencies/script.rpm.sh | sudo bash # Otherwise, you can also use wget ... wget -qO- https://packagecloud.io/install/repositories/trifacta/dependencies/script.rpm.sh | sudo bash
2. Install JDK
By default, the Alteryx node uses OpenJDK for accessing Java libraries and components. In some environments, basic setup of the node may include installation of a JDK. Please review your environment to verify that an appropriate JDK version has been installed on the node.
NOTE: Use of Java Development Kits other than OpenJDK is not currently supported. However, the platform may work with the Java Development Kit of your choice, as long as it is compatible with the supported version(s) of Java. See System Requirements.
NOTE: OpenJDK is included in the offline dependencies, which can be used to install the platform without Internet access. For more information, see Install Dependencies without Internet Access.
The following commands can be used to install OpenJDK. These commands can be modified to install a separate compatible version of the JDK.
sudo yum install java-1.8.0-openjdk-1.8.0 java-1.8.0-openjdk-devel
NOTE: If java-1.8.0-openjdk-devel
is not included, the batch job runner service, which is required, fails to start.
JAVA_HOME:
By default, the JAVA_HOME
environment variable is configured to point to a default install location for the OpenJDK package.
NOTE: If you have installed a JDK other than the OpenJDK version provided with the software, you must set the JAVA_HOME
environment variable on the Alteryx node to point to the correct install location.
The property value must be updated in the following locations:
Edit the following file:
/opt/trifacta/conf/env.sh
- Save changes.
3. Install Alteryx package
NOTE: If you are installing without Internet access, you must reference the local repository. The command to execute the installer is slightly different. See Install Dependencies without Internet Access.
NOTE: Installing the Designer Cloud Powered by Trifacta platform in a directory other than the default one is not supported or recommended.
Install the package with yum, using root:
sudo yum install <rpm file>
4. Verify Install
The product is installed in the following directory:
/opt/trifacta
JAVA_HOME:
The platform must be made aware of the location of Java.
Steps:
- Edit the following file:
/opt/trifacta/conf/trifacta-conf.json
Update the following parameter value:
"env": { "JAVA_HOME": "/usr/lib/jvm/java-1.8.0-openjdk.x86_64" },
- Save changes.
5. Install License Key
Please install the license key provided to you by Alteryx Inc. See License Key.
6. Store install packages
For safekeeping, you should retain all install packages that have been installed with this Alteryx deployment.
7. Install and configure Alteryx databases
The Designer Cloud Powered by Trifacta platform requires installation of several databases. If you have not done so already, you must install and configure the databases used to store Alteryx metadata. See Install Databases.
Configuration
After installation is complete, additional configuration is required.
The Designer Cloud Powered by Trifacta platform requires additional configuration for a successful integration with the datastore. Please review and complete the necessary configuration steps. For more information, see Configure.
This page has no comments.