Continuum Analytics: Documentation

# Installation

Anaconda Adam can be used to install the Anaconda platform, including multiple nodes or virtual machines.

Refer to the Requirements page for more information about system requirements, including networking and security requirements.

- 1. Download Adam
- 2. Run the Installer
- 3. License File (Optional)
- 4. Define Cluster Profile
- 5. Create Cluster
- 6. Install Platform Components
- 7. Access Platform Components

## 1. Download Adam

Download the installer to the host machine where you want to manage the Anaconda platform:

    $ wget https://anaconda.org/anaconda-adam/adam-installer/4.2.1/download/adam-installer-4.2.1-Linux-x86_64.sh

or:

    $ curl -LO https://anaconda.org/anaconda-adam/adam-installer/4.2.1/download/adam-installer-4.2.1-Linux-x86_64.sh

## 2. Run the Installer

Run the installer, and specify the destination directory (e.g., `~/adam`):

    $ bash adam-installer-4.2.1-Linux-x86_64.sh -b -p ~/adam

Add the `adam` command to your path by modifying `~/.bashrc`:

    $ echo -e '\n# Anaconda Adam\nexport PATH=~/adam/bin:$PATH' >> ~/.bashrc

Source your `~/.bashrc` file to activate the changes:

    $ source ~/.bashrc

Run the `adam` command to verify the installation and to create the configuration directories:

    $ adam

## 3. License File (Optional)

If you have an Anaconda Workgroup, Anaconda Enterprise, or other Anaconda license file, you can copy it to the `~/adam/licenses` directory. Anaconda Adam will search this directory for license files named `license*.txt`, e.g., `~/adam/licenses/license_bundle_20160524191753.txt`.

## 4. Define Cluster Profile

Create a cluster profile at `~/.continuum/adam/profile.d/my-cluster.yaml` with the following contents:

    name: my-cluster
    provider: bare

    bare:
      username: centos
      # password: password  # Optional
      port: 22
      keypair: ~/.ssh/my-private-key
      nodes:
      - host: node1.company.com
      - host: node2.company.com
      - host: node3.company.com
      - host: node4.company.com

    security:
      flush_iptables: false
      selinux_context: false
      selinux_permissive: false

In the profile, edit the `username`, SSH `port`, and IP addresses or hostnames of the `nodes` in the cluster. The first node in the list of `nodes` will be defined as the head node, and the remaining nodes will be defined as compute nodes.

Each host should be able to connect to the other hosts via the specified FQDN or IP address. It is recommended that you use the FQDN of the nodes that matches the hostname on each machine.

You will need to specify the location of your private SSH key (`keypair`) to use. Verify that you have SSH access to all of the cluster nodes, and that the specified `username` has sudo privileges.

You can also enable the various `security` settings depending on your cluster setup.

Refer to the Installation - Advanced Configuration page for more information about advanced configuration options for Anaconda Adam and Anaconda platform components.

## 5. Create Cluster

Create your cluster by specifying the name of the cluster and the profile name:

    $ adam up -n my-cluster my-cluster

## 6. Install Platform Components

After creating a cluster, you can install platform components using `adam <platform-component> install`:

    $ adam repository -n my-cluster install
    $ adam enterprise-notebooks -n my-cluster install
    $ adam mosaic -n my-cluster install
    $ adam accelerate -n my-cluster install
    $ adam scale -n my-cluster cluster install
    $ adam scale -n my-cluster dask install

## 7. Access Platform Components

After the platform component installations complete, you can open the platform components interface in your browser using `adam <platform-component> open`:

    $ adam repository -n my-cluster open
    $ adam enterprise-notebooks -n my-cluster open
    $ adam mosaic -n my-cluster open

Refer to the Getting Started page for more information about using the Anaconda platform components.