rpm_tools

Recipes for building binary and source RPMs for CSDMS tools.

Requirements

These recipes are designed for Linux distros that are compatible with Red Hat Enterprise Linux (e.g., CentOS, Fedora, SUSE). To install CSDMS tools on Mac OS X, please see the csdms/homebrew-tools project.

To build and install the tools in this repository, the mandatory and default packages in the "Development Tools" group (such as make, gcc, and rpm-build) are required, as well as cmake, git and rpmdevtools. Install them with:

$ sudo yum groupinstall "development tools"
$ sudo yum install cmake git rpmdevtools

Each tool will also have its own set of dependencies.

Preparation

Download and install (with Python >= 2.7) the packagebuilder package from the csdms/packagebuilder repository:

$ git clone https://github.com/csdms/packagebuilder.git
$ cd packagebuilder
$ sudo python setup.py install

This installs the script build_rpm, which is used to build the binary and source RPMs for a tool. The standard rpmbuild tool can also be used, but build_rpm handles much of the busy work to make the build process easier.

To separate CSDMS software from other programs, the tools in this repository are designed to be installed into the directory /usr/local/csdms, although this is optional. Set the environment variable CSDMS_DIR to the installation path on your machine:

$ export CSDMS_DIR=/usr/local/csdms

CSDMS_DIR is used by several recipes in this repository.

The QA_RPATHS environment variable may also need to be set:

$ export QA_RPATHS=19

to handle the custom CSDMS install location.

Building and installing the CSDMS tools

The tools in this repository form a cascading set of dependencies. Build and install them in this order:

1. csdms-python

   After installing this package, set the CSDMS_PYTHON environment variable to the location of the Python executable:

   $ export CSDMS_PYTHON=$CSDMS_DIR/bin/python

2. csdms-hdf5

3. csdms-netcdf (requires csdms-hdf5)

4. csdms-python-tools (requires csdms-python, csdms-netcdf)

5. babel (requires csdms-python, csdms-python-tools)

6. cca-spec-babel (requires babel)

7. csdms-boost-headers

8. ccaffeine (requires babel, cca-spec-babel, csdms-boost-headers)

9. bocca (requires babel, cca-spec-babel, ccaffeine)

10. boccatools (requires babel, bocca, csdms-python)

11. esmf (requires csdms-netcdf, csdmd-python, csdms-python-tools)

12. cmi (csdms-python, babel, cca-spec-babel, ccaffeine, bocca, boccatools, as well as child, sedflux, hydrotrend, and cem from csdms/rpm_models)

13. coupling (csdms-python, csdms-python-tools, esmf)

Build RPMs by calling build_rpm with the package name as a parameter. For example, to build csdms-python:

$ build_rpm csdms-python --tag=2.7.6 --prefix=$CSDMS_DIR

Many of the packages are built against a set version of a tool; e.g., Python 2.7.6. Check the package's .spec file to get the version used for input to build_rpm's tag argument. On success, RPMs will be located in the directories ~/rpmbuild/RPMS (binary) and ~/rpmbuild/SRPMS (source) on your machine.

Install the package from the binary RPM with rpm or yum. For example:

$ sudo rpm -ivh csdms-python-2.7.6-2.el6.x86_64.rpm
$ # or...
$ sudo yum install csdms-python-2.7.6-2.el6.x86_64.rpm

Check that the package was installed successfully:

$ $CSDMS_DIR/bin/python --version
Python 2.7.6

The CSDMS repository

Built versions of all of the tools listed here are available from the CSDMS repository, http://csdms.colorado.edu/repo/. See the README.md file for instructions on how to install these packages on your machine.

About CSDMS

CSDMS, the Community Surface Dynamics Modeling System, is an NSF-funded project that supports a diverse community of users and developers of earth and ocean system models. CSDMS develops, integrates, archives and disseminates earth system models and tools to an international community with the goal of building the frameworks necessary to model the earth system. Modelers use CSDMS for access to hundreds of open source surface dynamics models and tools, as well as model metadata.