wiki:ShmInstallUbuntu

Version 13 (modified by MarcusWalther, 9 years ago) (diff)

--

Installation on Ubuntu systems

This is a short description for the Seismic Handler installation on Ubuntu 8.04 (or newer, also applies to 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)! There is also a virtual applicant available: VMware Ubuntu or download a pre-compiled package as indicated at the bottom of this page.

Important note: Ubuntu 9.04's motif libraries are broken. You can use the Ubuntu 8.04's libs as a quick and dirty fix (details see ticket #12).

Prerequisities

Please be sure that you have the following packages installed:

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

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

sudo apt-get install make libmotif-dev libc6-dev tcsh xterm x11proto-core-dev x11proto-print-dev x11proto-xext-dev libxt-dev libx11-dev xutils-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 ("4.2" is only valid for 8.04, later distributions have a higher number)
    • 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!
  8. Correct permissions for the directory "~/shfiles" by "cd ; sudo chown -R $USER shfiles".

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 or 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.

Pre-compiled Ubuntu 8.04 package

If you prefer you can download a pre-compiled version of seismic handler that will install it to /usr/local/shcode/. This version was compiled with libah for reading AH files and also adapted to use a BASH shell startup script (shcode/setup/shsetup.sh) and the package can handle the addition of the correct lines to /etc/profile taking care of setup SH for all system users.

You must do:

  1. Download the package here  http://www.foo4fun.net/software/seismichandler_SH5.0e_SHM2.4i~0.1_i386.deb,
  2. Install it with gdebi: gdebi seismichandler_SH5.0e_SHM2.4i~0.1_i386.deb or double click this file from the file browser,
  3. Open a new gnome-terminal and configure it to load the shell as a login shell, to do that go to (menu path) Edit -> Current Profile -> Title and Command -> Run command as a login shell.
  4. Close your terminal, open it again and type in SHM.