Pelegant installation

The binaries of Pelegant for different platforms have been distributed together with the elegant executables. The detail information about the prebuilt Pelegant can be found at
Prebuilt Pelegant usage for multi-core computers.

For some users, it might be useful to build Pelegant from the source code. We provide the steps in building Pelegant on Linux as follows:

1. Install MPICH (1 or 2). This step can be done by either the user or the cluster administrator. Add the location of MPI executables in your PATH.
2. If you are using an x86 processor, set the environment variables HOST_ARCH and EPICS_HOST_ARCH to linux-x86 (or linux-x86_64 for 64 bits). If you are using a ppc processor you can set these variables to linux-ppc.
3. If EPICS/Base is already installed on your computer you can skip to the next step. Pelegant is built using the EPICS/Base configure files available from the OAG web site at APS. You will need to unpack this to create epics/base/configure. Go to the epics/base directory and type make.
4. Next you will need to download the EPICS extensions configure files from the OAG web site. This will unpack to create epics/extensions/configure. Go to the epics/extensions/configure directory and type make.
5. Download the latest SDDS source code from the OAG web site. This will unpack to create epics/extensions/src/SDDS. Go to this directory and type make.
6. Go to the epics/extensions/src/SDDS/SDDSlib directory and run the following commands to build parallel SDDS library:

   make clean
   make MPI=1
   

7. Go to the epics/extensions/src/SDDS/pgapack directory to build the parallel genetic algorithm library:

   make
   

8. Download the OAG configure files from the OAG web site. This will unpack to create oag/apps/configure. Go to this directory and type make.
9. Download the Pelegant source code from the OAG web site. This will unpack to create oag/apps/src/elegant.
10. Set the path for your installation of MPICH in Makefile.OAG in oag/apps/src/elegant. This is not required if the MPI executables are in your PATH.
11. From oag/apps/src/elegant, run the following command to build Pelegant:

     make Pelegant
    

    Pelegant should now exist at oag/apps/bin/linux-x86/Pelegant. (To build the serial version, just type ``make.'' This will also build related software.)

    elegant and Pelegant share the same source code. Makefile will decide which part of code will be compiled according to the binary file (either Pelegant or elegant) you want to build.

If you have any question about installing the Pelegant, please send an email to soliday@aps.anl.gov