The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain
and Copyright (C) 2005- The University of Notre Dame.
All rights reserved.
This software is distributed under the GNU General Public License.
See the file COPYING for details.
The Cooperative Computing Tools (cctools) are a collection of programs that enable large scale distributed computing on systems such as clusters, clouds, and grids. These tools are commonly used in fields of science and engineering that rely on large amounts of computing.
Binary packages are available for several operating systems at the download page Simply unpack the tarball in any directory that you like, and then add the bin directory to your path. For example, to install cctools for RHEL7 in your home directory:
# replace VERSION with a version number found in the download page.
CCTOOLS_NAME=cctools-VERSION-x86_64-redhat7
cd $HOME
wget http://ccl.cse.nd.edu/software/files/${CCTOOLS_NAME}.tar.gz
tar zxvf ${CCTOOLS_NAME}.tar.gz
export PATH=$HOME/${CCTOOLS_NAME}/bin:$PATH
Download a source package from the download page. And follow this recipe while logged in as any ordinary user:
# replace VERSION with a version number found in the download page.
CCTOOLS_NAME=cctools-VERSION-source
wget http://ccl.cse.nd.edu/software/files/${CCTOOLS_NAME}.tar.gz
tar zxvf ${CCTOOLS_NAME}.tar.gz
cd ${CCTOOLS_NAME}
./configure
make
make install
export PATH=${HOME}/cctools/bin:$PATH
Or, you can directly build the latest version from our git repository:
git clone https://github.com/cooperative-computing-lab/cctools cctools-source
cd cctools-source
./configure
make
make install
export PATH=${HOME}/cctools/bin:$PATH
The software will happily build and run without installing any external packages. Optionally, the cctools will interoperate with a variety of external packages for security and data access. To use these, you must download and install them separately:
Once the desired packages are correctly installed, unpack the cctools and then issue a configure command that points to all of the other installations. Then, make and install as before. For example:
./configure --with-globus-path /usr/local/globus ...
make
make install
export PATH=${HOME}/cctools/bin:$PATH
Building Parrot with support for the iRODS service requires some custom build instructions, since Parrot requires access to some internals of iRODS that are not usually available. To do this, first make a source build of iRODS in your home directory:
cd $HOME
git clone https://github.com/irods/irods-source
cd irods-source
git checkout 4.0.3
packaging/build.sh --run-in-place icommands
Then, configure and build cctools relative to that installation:
git clone https://github.com/cooperative-computing-lab/cctools cctools-source
cd cctools-source
./configure --with-irods-path $HOME/irods-src ...
make
make install
In order to build CCTools on Mac OS X you must first have the Xcode Command Line Tools installed. For OS X 10.9 and later this can be done using the following command:
xcode-select --install
Then, click "Install" in the window that appears on the screen. If the command line tools are already installed, you will get an error and can proceed with the instructions in the "Installing From Source" section above. For OS X versions before 10.9, you will need to first install Xcode. Xcode can be found in the App Store or on the installation disk.