Microsystems Technology Laboratories > OpenCoral
 

Download OpenCoral from CVS Repository

This section will describe how to download the latest stable source code of OpenCoral and compile it.

Assumptions

We assume that OpenCoral will be compiled and deployed on a machine called coral_server. The fully qualified machine name is coral_server.my_institution.edu and the email domain is mail_host.my_institution.edu. OpenCoral source code will be owned by the coral user and stored in ~coral/opencoral and deployed in /usr/local/coral.

Download Source from the CVS Repository

We use CVS (Concurrent Versions System) to maintain all of the code used by the Coral system. Unless you are helping to develop Coral, you will virtually always want to use a stable, release version of the Coral codebase. In CVS terminology, this will be known as a "tagged" version. The latest <tag> is coral-3_5_0-maint. In general, it is wise to check with "Team Coral" to determine the latest stable version as it is difficult to keep this documentation up to date. Alternatively, you may find it useful to check the "Announcements" forum at OpenCoral Announcements forum where we announce each new release of Coral.

Note
Coral tags of coral-3_5_0-maint and newer require Java 8. Versions of Coral tagged as coral-3_4_9-maint and older require Java 6. If you are installing Coral for the first time, we recommend that you use Java 8 and the latest tagged version of the opencoral repository.

Get the source code from CVS (Concurrent Versions System) repository with the following commands:

# su - coral
$ cd
$ touch .cvspass
$ echo "/1 :pserver:coralcvs@opencoral.mit.edu:2401/usr/local/coral-repository Atth0 y'tt" >> .cvspass
$ cvs -d :pserver:coralcvs@opencoral.mit.edu:/usr/local/coral-repository checkout -r <tag> opencoral 

Note: to avoid always having to type -d :pserver:coralcvs@opencoral.mit.edu:/usr/local/coral-repository with each CVS command, it is easier to define the environment variable CVSROOT, either on the command line or in your .cshrc or .bash_profile file, as appropriate. However, once you have checked out the opencoral repository, once you are in the /path-to-opencoral-src/opencoral directory, CVS will know where the repository is found (:pserver:coralcvs@opencoral.mit.edu:/usr/local/coral-repository) and remembers the password as well.