Two main software tools are required for D0 code development.  CVS ("d0cvs") provides access to the software repository, and KAI is the C++ compiler adopted by D0 (and the FNAL computing division).  Installation of these two packages will be outlined in this document.

The version of d0cvs for a remote site depends on whether the system has kerberos installed*.  If a system is running kerberos there are two steps:

1) send your kerberos principal (usually "username"@fnal.gov) to d0-release-mgr@fnal.gov
2) Install d0cvs:

> setup upd
> upd install -h www-d0.fnal.gov d0cvs -G'-c'

followed by:

> setup d0cvs

At this point you should be able to access the D0 CVS system.

(*see this page for more information.)

For "non-kerberized" systems, CVS access is allowed through secure shell (ssh). Only ssh v1 is supported at this time. Login to the system under your normal user account and execute the command (assuming ssh is installed):

> ssh-keygen

or if you are using an ssh v2 client

> ssh-keygen -t rsa1

The program will prompt you for a password -- do not use your Linux system password -- choose a different one.  Two "key" files are generated:

$HOME/.ssh/identity (private), and
$HOME/.ssh/identity.pub (public)

Send your public key file to d0-release-mgr@fnal.gov.  (Note that each user requiring access to the CVS system is required to create and submit the public key.)  Now install the ssh-specific version of d0cvs:

> upd install -h www-d0.fnal.gov d0sshcvs -G'-c'

Again login to you normal user account and setup cvs:

> setup d0sshcvs

You can verify that everything is working correctly by executing a CVS command like:

> cvs checkout package_name

where package_name is the name of a particular D0 software package, for example.  You will be prompted for the password you supplied when the ssh key files were generated.  A directory called package_name will be created containing the software.

As of March 2001 the FNAL site-wide license for the KAI compiler is available to off-site institutions as well.  This is good news for remote sites: the license fee was previously a few hundred dollars -- the new arrangement means remote sites may download and install the KAI compiler free of charge.  There are three steps to setting up the package:

1) install KAI via UPD;
2) request a KAI license from D0;
3) install the license upon receipt.

The procedure is outlined below.

Setup UPD and check for the available versions of KAI:

> setup upd
> upd list -aK+ kai | grep -i linux

A large number of versions will be displayed.  The latest version without specific qualifiers was v4_0f as of mid-June 2002.

Now install the package:

> upd install kai v4_0f -G'-c'

Next submit the license request as specified here.  The request should be directed to  kai-support@fnal.gov.  The license will be sent to you via e-mail.  Follow the instructions contained in the message for installing the license.  The installation procedure includes:

1) save the license file (attached as a text file to the e-mail message) as 'license.dat'
2) copy license.dat to KCC_BASE/flexlm/license.dat.

KCC_BASE is an environment variable which should be equivalent to:

/fnal/ups/prd/kai/Linux-2-4/v4_0f/KCC_BASE

(You can verify this by doing:

> setup kai
> echo $KCC_BASE )

The KAI compiler should now be available on your system.

Questions/comments? Contact Mark Sosebee
Last updated June 22, 2002