Installation on S.u.S.E systems

This is a short description for the Seismic Handler installation on OpenSuse 11. You'll need administrative rights to perform the installation (because you have to deal with some changes inside system directories)!

Prerequisities

Please be sure that you have the following packages installed (I had to hit "Retry" several times, because some packages weren't found at first):

• gcc
• openmotif-devel
• make

The following packages should be installed already in desktop environments, but you should check for them!

• tcsh
• xterm
• xorg-x11-libX11-devel
• xorg-x11-libXt-devel

Download the source packages for Seismic Handler and save them somewhere you'll find them later (in this how-to /tmp is used):

• ​installation script
• ​source package
• ​fk package (optional)
• ​locsat package (optional)

Installation steps

1. Open a shell window and change directory to the place you downloaded the source packages.
2. Make installation script executable by running "chmod a+x SHM-install.csh"
3. Become root user ("su").
4. Create installation directory "mkdir /usr/share/sh"
5. Set links for standard header files:
   • ln -s /usr/lib/gcc/i586-suse-linux/4.3/include/stdarg.h /usr/include/stdarg.h
   • ln -s /usr/include/linux/stddef.h /usr/include/stddef.h
6. Start script by "sudo ./SHM-install.csh /usr/share/sh /tmp" (replace /tmp by the absolute path you saved the source files)
7. Now you can alter the default values of the installation to your personal preferences. If finished, enter "i" to start installation. It is not necessary to compile the fk and locsat package even if you downloaded them!

Configuration

Open or create a file ".cshrc" in your home directory and insert the following line:

source /usr/share/sh/sh/setup/shsetup

If you use bash as your standard shell, you should define the following aliases (for more convenience place them in .bash_rc or .bash_aliases):

alias SH='tcsh -c SH'
alias SHM='tcsh -c SHM'

Possible pitfall: The locsat directory is linked from the home directory of the installing user (in this case "root"). All users must have reading access to this "lcs" link. This may conflict with your security settings, but it's necessary due to lacks in the locsat package.

Hint: Create your own configuration file to keep your personal configuration when installing new updates of SHM. Make a copy of $SH_INPUTS/shm-config.txt and create an environment variable SH_USER_PARAM pointing to it. E.g.: "cp $SH_INPUTS/shm-config.txt $HOME" and "setenv SH_USER_PARAM $HOME/shm-config.txt". Put the setenv-command to your $HOME/.cshrc file to make it permanent. Then edit your configuration file $SH_USER_PARAM to match your needs. Please read the ​documentation page of the configuration file for details.