wiki:ShmInstallUbuntu

Version 4 (modified by MarcusWalther, 14 years ago) (diff)

--

Installation on Ubuntu systems

This is a short description for the Seismic Handler installation on Ubuntu 8.04 (and related distributions like Kubuntu, Xubuntu, ...). 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:

  • gcc
  • make
  • libmotif-dev
  • tcsh
  • xterm
  • x11proto-core-dev
  • x11proto-print-dev
  • x11proto-xext
  • libxt-dev
  • libx11-dev

If you don't use the Adapt Manager, enter the command

sudo apt-get install gcc make libmotif-dev tcsh xterm x11proto-core-dev x11proto-print-dev x11proto-xext libxt-dev libx11-dev

and follow the instructions.

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

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. Create installation directory "sudo mkdir /usr/share/sh"
  4. Set links for libraries needed:
    • sudo ln -s /usr/lib/libXext.so.6 /usr/lib/libXext.so
    • sudo ln -s /usr/lib/libXpm.so.4 /usr/lib/libXpm.so
  5. Set links for standard header files:
    • sudo ln -s /usr/lib/gcc/i486-linux-gnu/4.2/include/stdarg.h /usr/include/stdarg.h
    • sudo 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 your account). 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.