Skip to main content

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

Release files for cgcloud-toil 1.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cgcloud-toil 1.6.0
File Size Uploaded
cgcloud-toil-1.6.0.tar.gz 6.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cgcloud-toil 1.6.0
File Interpreter ABI Platform
cgcloud_toil-1.6.0-py2.7.egg Legacy Egg format - - Details

Total release size: 23.4 kB

Release files / cgcloud-toil-1.6.0.tar.gz

Download URL cgcloud-toil-1.6.0.tar.gz
Size 6.8 kB
Tags Source
SHA-256 checksum
How to use checksums
99bced6bab50403be3aa7fec39bdff688678a73e8ac6d367b49118249f55dcc7
BLAKE2b-256 checksum
How to use checksums
569b1dfdd4f5638bf9c3cab0b575dfdc185fb983394385f38aeab552dc06482a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / cgcloud_toil-1.6.0-py2.7.egg

Download URL cgcloud_toil-1.6.0-py2.7.egg
Size 16.6 kB
Tags Egg
SHA-256 checksum
How to use checksums
0ca32b442c3eae98221694ddef15d3f4f05305245419c78628f8ded1bf8878b1
BLAKE2b-256 checksum
How to use checksums
828c11b576292039a1732cce4cade69251914ff646dddc716b10f358bf8b992e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.6.0 This release

2 release files

1.5.6

2 release files

1.5.5

2 release files

1.5.4

2 release files

1.5.3

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.8

2 release files

1.3.7

2 release files

1.3.6

2 release files

1.3.5

2 release files

1.3.4

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.3

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page