General Guidelines for the Installation of the ESP-r System

Instructions for Installing ESP-r on different computer types (Unix, Linux, OSX, Cygwin emulator on Windows machines and Native Windows versions are covered in the ESP-r Developers Guide (see the download page)..

See pages 12 and 13 for information on computer platforms and compilers. See pages 14-18 for hints on installing from source. See pages 30-44 for a discussion on how to work with the source code control Subversion. There is a further tutorial on Subversion on pages 48-52.

1. In your source distribution src/esp-r there is a script called Install which will guide you through the installation procedure and allow you to make selections corresponding to the different operating systems and window managers. Answer the questions to suit your system and compiler version and choice of X11/GTK/pure-text.

2. Type (for example) "./Install -d /usr/esru --gcc4 --reuse_ish_calcs" (for a complete installation with compiler flags set for GCC4 or newer and for the exemplar models convert the existing shading data rather than re-calculate them). Use "./Install -h" to see the other options. Answer the questions as posed.

3. Set up your environment along the lines of the sample dot files in directory /usr/esru/src/esp-r/env. For some machines you may need to set the fonts (setenv EFONTS ...) in your .login file as shown in the sample login file and your PATH as shown in the .cshrc file. N.B. if the defined fonts do not exist ESP-r will probably crash on start-up.

4. The file /usr/esru/esp-r/default defines the default settings for example problems, climate, control, etc. These can be changed if the default settings offered in the standard distribution are not appropriate for your site.

5. To run ESP-r on some Sun workstations it may be necessary to firstly define the default colour map. This can be done by issuing the command "xstdcmap -default" or placing it in your .xinitrc file. You might also need to add "xstdcmap -delete all" to your .xinitrc file.

6. With 32 bit versions of Linux and GCC compilers 4.1-4.3 ESP-r runs well. One 64 bit Linux computers the ESP-r graphic interface is somewhat less stable although the numerical engine produces essentially the same results for 32 bit and 64 bit.

7. In directory validation/QA, there are models and scripts which can be run to check on your implementation. See the Readme file in that directory for details. 14. If - or should we say when ;-) - problems are encountered please email us at esru@strath.ac.uk.

Good Luck