Installation¶
This page provides information about installing or updating Anaconda for cluster management on a client machine (Windows, Mac, or Linux, 64-bit) to manage cloud-based or bare-metal clusters.
Python Requirements¶
Anaconda for cluster management requires Python 2.7. You can create a new environment in conda with Python 2.7 using the following command:
$ conda create -n acluster python=2.7
Then, activate the acluster
environment before running the installation
instructions using the following command:
$ source activate acluster
Installation Instructions¶
Anaconda for cluster management can be installed on the client machine using the conda package manager, which is included in the Anaconda Python distribution. To download Anaconda, follow the instructions on the Anaconda download page.
1. Authentication¶
Anaconda for cluster management can be installed after logging into your Anaconda Cloud account. After you have installed Anaconda and refreshed or opened a new terminal window, install the command-line client for Anaconda Cloud using the following command:
$ conda install anaconda-client -n root
Login to your Anaconda Cloud account using the following command:
$ anaconda login
2. Installing on client machine¶
After you have logged in to your Anaconda Cloud account, install Anaconda for cluster management on your local machine using the following command:
$ conda install anaconda-cluster -c anaconda-cluster
3. Initialization¶
Anaconda for cluster management saves all configuration information in the
~/.acluster
directory. To create this directory and populate it with the
initial configuration, run the acluster
command, which will print all of
the available subcommands:
$ acluster
After running the acluster
command, the ~/.acluster
directory is
created, along with an example provider
file located in
~/.acluster/providers.yaml
and example profile
files located in
~/.acluster/profiles.d/
.
After installing Anaconda for cluster management, you can use the acluster
command on your local machine to create new clusters, get information about
clusters that are currently running, install conda packages on the cluster
nodes, and more.
You can now proceed to the Quickstart page for a brief walkthrough of the functionality of Anaconda for cluster management or the Cloud-based Cluster Setup or Bare-metal Cluster Setup pages to create and manage a cloud-based or bare-metal cluster.
Updating¶
If you’ve installed Anaconda for cluster management and want to update to the latest version, make sure you are logged in to your Anaconda Cloud account, and use the following command:
$ conda update anaconda-cluster -c anaconda-cluster
License File Installation¶
A bundled Anaconda subscription license file
(e.g., license_bundle_20160329183212.txt
) can be copied into the
~/.continuum
directory on the client machine.
A legacy Anaconda for cluster management license file
(e.g., cluster_20150408210022.lic
) can be copied into the ~/.acluster
directory on the client machine.
Once the license file is copied there, you can create, provision, and manage up to the maximum number of cluster nodes that your license is valid for.
You can view information about your currently installed license using the
acluster info
command:
$ acluster info
anaconda-cluster version: 1.4.0
License information:
License status: Valid
Number of existing nodes: 4
Licensed nodes: 16
License expiration date: 2017-03-29
Platform: Darwin-15.4.0-x86_64
Processor: i386
Byte-ordering: little
Python version: 2.7.11 | Continuum Analytics, Inc.
[GCC 4.2.1 (Apple Inc. build 5577)]
apache-libcloud version: 0.20.1
yaml version: 3.11
A bundled Anaconda subscription license file with additional products (e.g.,
Accelerate) can be copied into the licenses
directory of the system-wide
installation of Anaconda on each of the cluster nodes
(default: /opt/anaconda/
). You might need to create the
/opt/anaconda/licenses/
directory if it does not already exist.
Note that you can also use the following commands from the client machine to upload a license file to all of the cluster nodes.
$ acluster cmd "mkdir /opt/anaconda/licenses"
$ acluster put <LOCAL_FILE> <REMOTE_FILE> --all