This provides a more detailed set of instructions for maintaining the DDS applications. For quick, simple installation procedure on a single platform, go to Quick Applications Installation.

HOW TO INSTALL THE DDS APPLICATIONS FROM SOURCE CODE:

DDS applications can be obtained by 1) downloading, untarring, making and installing applications; or 2) creating your own applications using DDS library calls and linking into the libraries. You can use the make structure, MakeVariables and MakeRules, provided in the etc directory. The other make files are for building the dds libraries.

1. Before building any DDS applications, the DDS libraries must first be in place (see Library Installation). These libraries include:
   • libdds_r3.a - core DDS API routines
   • libchost.a - host dependent routines for "C" programs
   • libfhost.a - host dependent routines for Fortran programs
   • libgio.a - generalized buffered I/O routines for DDS
   • libfft.a - basic fft wrappers for different platforms
   • libfftw.a - fftw routines from fftw.org used by the fft wrappers on platforms that do not have good fft's
   • librfftw.a - rfftw routines from fftw.org used by the fft wrappers

   These libraries can be installed by downloading the DDS source, making and installing the libraries. For platforms that are not already setup for the DDS make structure, you can modify the make structure (see Makefile Configuration) then build and install the libraries. That can be a challenge.
   

   For each application enter "gmake" to build an application; "gmake update" to build and update the binary to the distribution directory; "gmake install" to update and also install the bin startup script and the man page; or "gmake all" to make use of the REMOTE_HOSTS to build and install on multiple platforms. Use "gmake help", "gmake variables" and/or "gmake flags" for more information on the application make structure which is totally different form the dds libarary make scheme.

2. For the MPI codes, make sure an executable copy of "mpirun" is in the correct path (${DDS_DIST}/*/*/mbs/prod/*) for your system. Also modify MakeVariables in ${DDSROOT}/src/lib/host so that the CCFlags, FCFlags, LibDirs & Libes have the correct info for building MPI on your platform.
   
   
3. Execute the script called "MakeApps" which will make and install all applications. for the current platform (or you can go into each of the src/cmd subdirectories and run "gmake" and "gmake install").
   
   
4. After building the applications, add "${DDS_DIST}/bin" into your PATH environment variable and run "rehash". That should allow you to be able to run any of the built applications. Each application has a startup script in "${DDS_DIST}/bin which will setup and execute the corresponding binary associated with the current platform. This way executables from multiple platforms can coexist together under ${DDS_DIST}. Run any application with "-h" or "help=" on the command line to display the online help for that application. You can also add "${DDS_DIST}/man/mbs" to your MANPATH environment variable to get to the application man pages.