= Installation instructions =

== preparation ==

 1. Make sure you have installed {{{subversion}}} client tools, namely the executable {{{svn}}}.
 1. Install !ObsPy, please follow the [https://github.com/obspy/obspy/wiki/Installation-on-Linux online instructions].
 1. Install {{{python-sqlalchemy}}} software (available in every Linux software repository).
 1. Install {{{python-pysqlite2}}} package.
 1. Install {{{wxpython}}} graphical framework (dito, sometimes called "python-wxtools" or "python-wxpython").

== installation program ==

The current alpha version offers a simple installation program only. 

 1. Download [export:SHX/trunk/SeismicHandler/bin/setup.py setup.py].
 1. Run "{{{python setup.py make}}}", this will create the installation script {{{/tmp/install-shx.py}}}.
 1. Execute "{{{sudo python /tmp/install-shx.py}}}".
 1. After installation the path to the command-line interface is printed. You may set an alias to this script for convenience.

== manual installation ==

 1. Go to the desired installation directory of SHX (afterwards referred as $instdir).
 1. Get the current code from Subversion repository:
{{{
svn export https://www.seismic-handler.org/svn/SHX/trunk/SeismicHandler
}}}
 1. Create a symbolic link inside python's library. Using the next instructions you can determine the proper path:
{{{
$ python
>>> from distutils.sysconfig import get_python_lib
>>> print(get_python_lib())
/usr/local/lib/python2.7/site-packages
>>> quit
$ cd /usr/local/lib/python2.7/site-packages
$ ln -s $instdir/SeismicHandler
}}}
 1. Now you can start the command line interface via
{{{
$ $instdir/SeismicHandler/bin/SH
}}}
 1. For convenience you may set an alias in local profile:
{{{
alias SHX=$instdir/SeismicHandler/bin/SH
}}}

=== Notes ===

For easy updates simply use "check out" command of subversion instead of "export":
{{{
svn co https://www.seismic-handler.org/svn/SHX/trunk/SeismicHandler
svn up # later update
}}}