Download OpenCoral from CVS Repository
This section will describe how to download the latest stable source code of OpenCoral and compile it.
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_2-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.
Get the source code from CVS (Concurrent Versions System) repository with the following commands:
# su - coral $ cd $ touch .cvspass $ echo "/1 :pserver:email@example.com:2401/usr/local/coral-repository Atth0 y'tt" >> .cvspass $ cvs -d :pserver:firstname.lastname@example.org:/usr/local/coral-repository checkout -r <tag> opencoral
Note: to avoid always having to type -d :pserver:email@example.com:/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:firstname.lastname@example.org:/usr/local/coral-repository) and remembers the password as well.