Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r0682

D toc

This guide takes you through the steps for installing 

D s product
rtrue
 software on Ubuntu. 

For more information on supported operating system versions, see Product Support Matrix in the Planning Guide.

Preparation

Before you begin, please complete the following.

Info

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:

  1. Review key sections of the Planning Guide:
    1. Review the System Requirements and verify that all required components have been installed.
    2. Verify that all required System Ports are opened on the node.

    3. Review the System Dependencies in the Planning Guide.

    4. Cluster configuration: Additional steps are required to integrate the 

      D s platform
       with the cluster. See Prepare Hadoop for Integration with the Platform in the Planning Guide.

  2. Acquire your License Key.
  3. Install and verify operations of the datastore, if used.

    Info

    NOTE: Access to the cluster may be required.

  4. Verify access to the server where the

    D s platform
     is to be installed.

Installation

Tip

Tip: The Python setup tools can be useful for debugging startup issues. To install:

Code Block
wget https://bootstrap.pypa.io/ez_setup.py -O - | python

1. Install Dependencies

Without Internet access

If you have not done so already, you may download the dependency bundle with your release directly from 

D s company
formalfalse
. For more information, see Install Dependencies without Internet Access.

With Internet access

Use the following to add the hosted package repository for Ubuntu, which will automatically install the proper packages for your environment. 

Info

NOTE: Install curl if not present on your system.

Then, execute the following command: 

Info

NOTE: Run the following command as the root user. In proxied environments, the script may encounter issues with detecting proxy settings.

Code Block
curl https://packagecloud.io/install/repositories/trifacta/dependencies/script.deb.sh | sudo bash


Special instructions for Ubuntu installs

These steps manually install the correct and supported version of the following:

  • nodeJS
  • nginX

Due to a known issue resolving package dependencies on Ubuntu, please complete the following steps prior to installation of other dependencies or software. 

  1. Login to the 

    D s node
     as an administrator.

  2. Execute the following command to install the appropriate versions of nodeJS and nginX.

    1. Ubuntu 14.04:

      Code Block
      sudo apt-get install nginx=1.12.2-1~trusty nodejs=10.13.0-1nodesource1
    2. Ubuntu 16.04 

      Code Block
      sudo apt-get install nginx=1.12.2-1~xenial nodejs=10.13.0-1nodesource1
  3. Continue with the installation process.

2. Install JDK

By default, the  

D s 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.

Info

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. For more information, see System Requirements in the Planning Guide.

Tip

Tip: 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.

Code Block
sudo apt-get install openjdk-8-jre-headless

JAVA_HOME:

By default, the JAVA_HOME environment variable is configured to point to a default install location for the OpenJDK package. 

Info

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

D s node
to point to the correct install location. 

The property value must be updated in the following locations:

  1. Edit the following file: /opt/trifacta/conf/env.sh

  2. Save changes.

3. Install 
D s item
itempackage

Info

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.

Info

NOTE: Installing the

D s platform
in a directory other than the default one is not supported or recommended.

Install the package with apt, using root:

Info

NOTE: If you encounter errors running the following command, execute the next command anyway. If that command completes without error, the installation is ok.


Code Block
sudo dpkg -i <deb file>

The previous line may return an error message, which you may ignore. Continue with the following command: 

Code Block
sudo apt-get -f -y install


4. Verify Install

The product is installed in the following directory: 

Code Block
/opt/trifacta

JAVA_HOME:


The platform must be made aware of the location of Java.

Steps:

  1. Edit the following file: 
    D s triconf
    pathtrue
  2. Update the following parameter value:

    Code Block
    "env": {
      "JAVA_HOME": "/usr/lib/jvm/java-1.8.0-openjdk.x86_64"
    },
  3. Save changes.

5. Install License Key

Please install the license key provided to you by

D s company
formalfalse
. See License Key.

6. Install Hadoop dependencies

If you are integrating with a supported Hadoop cluster, you must install the dependencies for the Hadoop cluster on the 

D s node
. See below.

7. Store install packages

For safekeeping, you should retain all install packages that have been installed with this

D s item
itemdeployment
.

Install Hadoop Dependencies

Include Page
Install Hadoop Dependencies
Install Hadoop Dependencies

Next Steps

Install and configure 
D s item
itemdatabases

The 

D s platform
 requires installation of several databases. If you have not done so already, you must install and configure the databases used to store 
D s item
itemmetadata
. See Install Databases in the Databases Guide.

Install configuration

After installation is complete, additional configuration is required to make the platform operational. See Install Configuration.

Install Desktop Application

You can deploy the

D s deskapp
as a desktop client to enable end-users to connect to the
D s webapp
without using one of the supported web browsers. See Install Desktop Application.