Installing the Alpaca tools

The Alpaca tools can be downloaded from the Alpaca SVN repository:

svn co --username cvs_anon https://svn.cct.lsu.edu/repos/cactus/Alpaca/HTTPS
svn co --username cvs_anon https://svn.cct.lsu.edu/repos/cactus/Alpaca/RuntimeVisIt
svn co --username cvs_anon https://svn.cct.lsu.edu/repos/cactus/Alpaca/VisIt
svn co --username cvs_anon https://svn.cct.lsu.edu/repos/cactus/Alpaca/Visualisation

This script automates the task, optionally downloading and installing Cactus and Carpet and a test package for running all the tools in a simple test case. Much more advanced framework for managing Cactus configurations and simulations, the Simulation Factory, allows to install, enqueue and monitor Cactus simulations on various computers and supercomputers. Alpaca tools can be managed by SimFactory just like any other set of Cactus thorns or arrangements.

Installation consists of the following steps:

Checkout the GetCactus script, which automates downloads and updates of the Cactus flesh, thorns and arrangements:

 cvs -d :pserver:cvs_anon@cvs.cactuscode.org:/cactus login   # type password : anon
 cvs -d :pserver:cvs_anon@cvs.cactuscode.org:/cactus co Utilities/Scripts/GetCactus

Download example thornlist, containing Alpaca thorns (alpaca.th).

Checkout Cactus and all the thorns from the thornlist alpaca.th:

 ./GetCactus -install=~/CAlpaca -anonymous=yes \
    -verbose=no -repository=development alpaca.th

Download an optionlist alpaca.cfg for creating a Cactus configuration. You will most certainly need to edit this file in order to be able to run it on your system. Here's a few example optionlists:

Option list	Machine	Description
`numrel09.cfg`	numrel	LSU Numrel workstations, 4-CPU AMD Linux FC11
`queenbee.cfg`	queenbee	The large LONI Linux cluster
`ranger.cfg`	ranger	The huge Linux cluster at TACC

If you plan on using an existing optionlist, e.g. one from SimFactory, here's a few lines which need to be added, in order to work with Alpaca tools:
- Add libsim include path to CPPFLAGS, for example:
```
CPPFLAGS = ...\
   -I/opt/visit1.12.1/src/databases/SimV1
```
- Add the following to the linker flags:
```
 LDFLAGS = ...\
   -Wl,--export-dynamic -ldl -L/opt/visit1.12.1/src/lib \
   -Wl,-rpath,/opt/visit1.12.1/src/lib
```
- Add path to VisIt libraries and include files:
```
 VISIT = yes
 VISIT_LIB_DIRS = /opt/visit1.12.1/src/archives
 VISIT_INC_DIRS = /opt/visit1.12.1/src/sim/lib
```

Checkout Carpet (in this example, the Cactus is being installed to ~/CAlpaca directory):

 cd ~/CAlpaca
 git clone -o carpet git://carpetcode.dyndns.org/carpet.git
 cd arrangements
 ln -sf ../carpet/Carpet* .

Create a Cactus configuration test and compile executable:

 make test-config THORNLIST=alpaca.th options=alpaca.cfg PROMPT=no
 make -j4 test    # specify how many processors compiler should use

Once the tools have been installed correctly, see each tool's individual page for instructions on how to use it.