Standard installation

Downloading the Adam installer

To download the installer, run one of the commands below on the host machine where you want to manage the Anaconda platform:

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

Or:

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

Installing Adam

  1. Run the installer, specifying the installation directory:

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

    NOTE: Replace ~/adam with the actual installation directory.

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

    echo -e '\n# Anaconda Adam\nexport PATH=~/adam/bin:$PATH' >> ~/.bashrc
    
  3. To activate the changes, source your ~/.bashrc file:

    source ~/.bashrc
    

Verifying the installation

To verify that the installation succeeded and to create configuration files in ~/.continuum/adam, run the adam command, which outputs the Adam help text:

$ adam
Usage: adam [OPTIONS] COMMAND [ARGS]...

Options:
  --version                    Show the version and exit.
  -l, --log-level [info|debug|error]
                               Logging level [default: debug]
  -h, --help                   Show this message and exit.

Commands:
  cmd                   Execute a command on the nodes
  describe              Describe an Adam cluster or profile
  ec2                   EC2 options
  enterprise-notebooks  Anaconda Enterprise Notebooks options
  info                  Display Adam version, system, and
                          license information
  jupyter               Jupyter options
  kubernetes            Kubernetes options
  list                  List Adam clusters and profiles
  platform              Anaconda Platform options
  provision             Provision options
  remove                Remove a cluster
  repository            Anaconda Repository options
  salt                  Execute a Salt module
  scale                 Anaconda Scale options
  ssh                   SSH to one of the nodes (0-based
                          index)
  up                    Create a cluster from a profile

Installing your Anaconda Enterprise license file

Copy your Anaconda Enterprise license file to any of the following directories:

  • ~/adam/licenses/.
  • ~/.continuum/.
  • Any other directory shown by the command ~/adam/bin/conda info --license.

Adam searches all of these directories for license files named license*.txt.

EXAMPLE: ~/adam/licenses/license_bundle_20170428044737.txt.

Defining a cluster profile

  1. Switch to root user and create a file with this name and path ~/.continuum/adam/profile.d/profile.yaml and the following contents:

    name: profile
    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
    
  2. Replace centos with an actual username. Verify that the username has sudo privileges.

  3. Replace 22 with the appropriate SSH port number.

  4. Replace ~/.ssh/my-private-key with the location of the private SSH key (key pair) to be used. Verify that you have SSH access to all of the cluster nodes.

  5. Edit the IP addresses or hostnames of the nodes in the cluster. Each host must be able to connect to the other hosts using the specified FQDN or IP address.

    TIP: We recommend using the nodes’ FQDN that matches the hostname on each machine.

    NOTE: The first node in the list of nodes is the head node. The remaining nodes are compute nodes.

By default, the anaconda user/group is created across the cluster and owns the directory and files located in the root installation directory. If desired, you can customize the cluster profile to change these and other settings.

Creating a cluster

To create a cluster, run:

adam up -n [cluster-name] [profile-name]

EXAMPLE: To create a cluster named “cluster” from a cluster profile named “profile”:

adam up -n cluster profile

Installing platform components

After creating or provisioning a cluster, you can install platform components by running:

adam [platform-component] -n [cluster-name] install

EXAMPLE: To install Repository, Enterprise Notebooks, and Scale on a cluster named “cluster”:

$ adam repository -n cluster install
$ adam enterprise-notebooks -n cluster install
$ adam scale -n cluster cluster install
$ adam scale -n cluster dask install

Opening a platform component

To open a platform component’s user interface in your browser, run:

$ adam [platform-component] -n [cluster-name] open

EXAMPLE: To open Repository and Enterprise Notebooks on a cluster named “cluster”:

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

For more information see Working with platform components.