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:

  1. 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
    
  2. Download example thornlist, containing Alpaca thorns (alpaca.th).
  3. Checkout Cactus and all the thorns from the thornlist alpaca.th:
     ./GetCactus -install=~/CAlpaca -anonymous=yes \
        -verbose=no -repository=development alpaca.th
    
  4. 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
  5. 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
      
  6. 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* .
    
  7. 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.