CADAC

Contributed Software

File Locations

CADAC software should be placed under the GPFS-WAN project directory, /gpfs-wan/projects/cadac/, in the software/ subdirectory. The software/ directory is analogous to a typical usr/ directory, with the addition of a doc/ and contrib/ directory. 

/gpfs-wan/projects/cadac/software/
                                  bin/
                                  contrib/
                                  doc/
                                  include/
                                  lib/
                                  share/

We would like to reserve the bin/, doc/, include/, lib/, share/ directories for software specific to supporting the CADAC. Contributed software should either be placed in its own directory, or in the contrib/ directory, organized by member.

Permissions and Ownserhips

This space is for shared tools, so please ensure the group has read and execute permissions as necessary on any directories or files you add. The group id (csd116) should be set automatically, but the permissions will not.

Adding Personal Scripts

Most CADAC members will probably not need to install complete software packages, but will need to share some scripts or other tools. Doing this is simple:

  1. Create a directory under software/contrib
  2. Add your tools as you see fit
  3. To help others, put a README at the top level

As an example, here is how to create a personal directory, and make sure the group can access it: 

ds001 % cd /gpfs-wan/projects/cadac/software/contrib/
ds001 % mkdir rick
ds001 % chmod g+rx rick
ds001 % ls -l
total 128
drwxr-s---  2 ux455215 csd116 65536 2007-08-08 22:31 rick/

Now we'll copy down some things from our home directory, and ensure the CADAC group has access. 

ds001 % cd rick/
ds001 % cp ~/scripts/hello.py ~/scripts/README ./
ds001 % chmod g+r *
ds001 % chmod g+x hello.py

Finally, test the script, and check the README 

ds001 % cat README 
= Rick Wagner's Software =

Here's where I keep my basic analysis scripts.

== Contents ==

 * hello.py - A "Hello, world!" type example.

ds001 % ./hello.py 
Hello, CADAC!

Adding Standalone Packages

If you want to add a standalone package, we prefer that it reside in its own directory, with a name indicating the package and it's version. For example, if you had a program named CoolVizTool at version 0.5, it would go into 

/gpfs-wan/projects/cadac/software/CoolVizTool-0.5

This is common when install software into /usr/local/ on a computer.

After you have installed and tested the new software, please post an announcement to the mailing list. In the email, put in some description of the package and its location. We will collect these notices and maintain a list of the added packages.