Install on AWS

Dataiku provides a pre-built Marketplace AMI for running DSS on AWS EC2.

Note

Of course, you can use the regular Linux installation procedure (Installing a new DSS instance) on any compatible EC2 instance.

The AMI provides a shorter path to having a working standalone DSS instance with default options.

Warning

This AMI is provided as a way to quick start a DSS instance, mainly for testing purposes. It comes with several “pre-made” choices (accounts, disks, installation directories, …) and installed packages and may not be suitable for all purposes.

In particular, this AMI is generally not suitable for use as edge node of an existing Hadoop cluster. See DSS and Hadoop for more information.

For these cases, we recommend you install a new instance of DSS on a manually installed Linux EC2 instance.

Prerequisites

You need an AWS account to proceed. You will be billed only for the EC2 instance, the Marketplace AMI itself is free.

Installation

See https://www.dataiku.com/dss/trynow/aws/

Manual launch details

If you go with the Manual Launch, you should:

  • In instance details, enable the auto-assign public IP.
  • In security groups, expose the standard HTTP and/or HTTPS ports and SSH port for administration.
  • At the launch, select or create a public key to be able to administrate the instance via SSH.

How to

How do I use DSS?

DSS is available:

  • As regular HTTP, on the port 80 of the EC2 instance.
  • As HTTPS, on the port 443 of the EC2 instance - DSS is preloaded with a self-signed certificate, so you will get a security error. You can replace this with a real certificate afterwards.

At first launch, you will have to prove that you are the owner of the instance. Authenticate with:

  • the instance id (i-xxxxxxxx) as login
  • an empty password.

When first accessing the DSS UI, you will be prompted to register for the DSS free edition, or enter your DSS entreprise license.

How do I log into the EC2 instance?

You can log into the instance using the ec2-user account and the keypair that you specified during setup of the instance.

Beware: DSS does not run under the ec2-user account, but under the dataiku account. The ec2-user is sudoer, so from the ec2-user shell, you can use sudo su dataiku to get a shell as the dataiku user.

Out of the box, you cannot login as the dataiku user, and the dataiku user is not sudoer. (you can add your SSH key to the authorized keys of dataiku, though).

Where is the DSS data directory?

The DSS data directory on the EC2 instance is /home/dataiku/dss. All operations on this data directory (like installing R, JDBC drivers, …) must be performed as the dataiku user (see above).

What is installed by default?

The Dataiku AMI is based on Amazon Linux. It contains:

  • A standard installation of Dataiku DSS running under Linux user account “dataiku”.
  • A local PostgreSQL database, with a connection to it pre-configured in DSS.
  • A standard installation of R, also pre-configured in DSS.
  • A nginx reverse proxy exposing DSS onto the standard HTTP port 80, and the standard HTTPS port 443 using a self-signed certificate. For better security, you can provide your own certificate in directory /etc/nginx/ssl.
  • A Linux firewall configured to only allow connections to ports 80 (HTTP), 443 (HTTPS) and 22 (SSH).

Warning

Since this AMI is based on AmazonLinux, it is not suitable for installing some packages that require RedHat / CentOS, like Cloudera.

How do I install JDBC drivers?

JDBC drivers must be installed by copying the relevant files in the “lib/jdbc” folder of the DSS data directory (See Installing database drivers).

You can either download files from the instance or upload them using SSH. Copy into the /home/dataiku/dss/lib/jdbc folder must be done as the dataiku user (see above).