Skip to main content

Setup and manage a toil and Apache Mesos cluster in EC2

Project description

The CGCloud plugin for Toil lets you setup a fully configured Toil/Mesos cluster in EC2 in just minutes, regardless of the number of nodes.

Prerequisites

The cgcloud-toil package requires that the cgcloud-core package and its prerequisites are present.

Installation

Read the entire section before pasting any commands and ensure that all prerequisites are installed. It is recommended to install this plugin into the virtualenv you created for CGCloud:

source ~/cgcloud/bin/activate
pip install cgcloud-toil

If you get DistributionNotFound: No distributions matching the version for cgcloud-toil, try running pip install --pre cgcloud-toil.

Be sure to configure cgcloud-core before proceeding.

Configuration

Modify your .profile or .bash_profile by adding the following line:

export CGCLOUD_PLUGINS="cgcloud.toil:$CGCLOUD_PLUGINS"

Login and out (or, on OS X, start a new Terminal tab/window).

Verify the installation by running:

cgcloud list-roles

The output should include the toil-box role.

Usage

Create a single t2.micro box to serve as the template for the cluster nodes:

cgcloud create -IT toil-box

The I option stops the box once it is fully set up and takes an image (AMI) of it. The T option terminates the box after that.

Substitute toil-latest-box for toil-box if you want to use the latest unstable release of Toil.

Now create a cluster by booting a leader and the workers from that AMI:

cgcloud create-cluster toil -s 2 -t m3.large

This will launch a leader and two workers using the m3.large instance type.

SSH into the leader:

cgcloud ssh toil-leader

… or the first worker:

cgcloud ssh -o 0 toil-worker

… or the second worker:

cgcloud ssh -o 1 toil-worker

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cgcloud-toil-1.6.0a1.dev362.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

cgcloud_toil-1.6.0a1.dev362-py2.7.egg (16.5 kB view details)

Uploaded Source

File details

Details for the file cgcloud-toil-1.6.0a1.dev362.tar.gz.

File metadata

File hashes

Hashes for cgcloud-toil-1.6.0a1.dev362.tar.gz
Algorithm Hash digest
SHA256 8fc4388d350e3b7eb53d1d1dbb0bd398938b81b38007d51eb677bf8b9f4745d0
MD5 3e6c0dd4cf2220af66268c70a8620c41
BLAKE2b-256 b0fa968d8a3f7be94c940bc18a003c668e100ff12e12e7c115cc8c824252c94d

See more details on using hashes here.

File details

Details for the file cgcloud_toil-1.6.0a1.dev362-py2.7.egg.

File metadata

File hashes

Hashes for cgcloud_toil-1.6.0a1.dev362-py2.7.egg
Algorithm Hash digest
SHA256 97b7e4cae0fc8911a036f784c97c4ab8952d108074f561a5480f3b0eeb901fdf
MD5 476f6d2b865f64ed2e37aee2bbc3cca5
BLAKE2b-256 201ac36f7d4cfa5f49b3b7b60b292c7871c73cf6a4360f676be47bd7a92990dc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page