Seismic Studio Linux

[Home] [Getting Started] [FAQ] [Issues] [download] [README]


Getting Started

UNDER CONSTRUCTION. Many changes to install process have been made. Please check the FAQ and README, they basically cover this section.

Setting up your Sentinel License Server
...32bit
...x86_64 (64bit)
Download Seismic Studio Linux
Installing & Configuring Seismic Studio Linux (Generic x86)
...First Install
...How to update
...Using a different version of Mono
...Running Seismic Studio
Installing & Configuring Seismic Studio Linux (RedHat 4.3 x86_64)
...First Install
...How to update
...Using a different version of Mono
...Running Seismic Studio
Video Card Drivers


Setting up your Sentinel License Server

Note: If you are not running a Sentinel Keys Server on your local machine (basically, you won't have the physical usb key plugged into your computer and are going over the network only), you will not need this package. Skip this step!

First, download the Sentinel Keys package or copy the installation folder from your Seismic Studio CD. The directory structure should look like below:

rengeo@linux-sg4w:~/SentinelKeysLinux> ll
total 8
drwxr-xr-x 2 rengeo users   80 2007-01-10 15:35 configuration_file_templates
drwxr-xr-x 3 rengeo users   72 2007-01-10 15:28 language_packs
-r--r--r-- 1 rengeo users 5949 2006-06-11 13:30 licenseagreement.txt
drwxr-xr-x 3 rengeo users   72 2007-01-10 15:35 sentinel_keys_protection_installer
rengeo@linux-sg4w:~/SentinelKeysLinux>

1.) The compiler interface is provided with the installation of Seismic Studio, so you don't need to worry about that. If you are connecting remotely and this machine is not the host machine, then no further setup is required. However, if this is the host machine and will have a Sentinel Hardware key plugged in, the followign setup is required.

2.) First, you'll need java jre 1.5 or later. If you already have this, skip this step, otherwise a self-extracting binary rpm is included in this package under language_packs/en_US/jre/jre-1_5_0_06-linux-i586-rpm.bin. You will need to install it as you would any other System file, preferably as root, otherwise in /usr/local/. The file should be executable, but if not, you may need to use chmod. Run it with ./jre-1_5_0_06-linux-i586-rpm.bin and it should extract and install itself automatically. It will extract as well, but the rpm should already be installed, so you don't need to install the .rpm file that was extracted! (Basically, the script just unpacks the .rpm file and then installs it on it's own). It should look like the following:

rengeo@linux-sg4w:~/SentinelKeysLinux> cd language_packs/en_US/jre/
rengeo@linux-sg4w:~/SentinelKeysLinux/language_packs/en_US/jre> ll
total 15860
-r-xr-xr-x 1 rengeo users 16221170 2006-06-11 13:30 jre-1_5_0_06-linux-i586-rpm.bin
rengeo@linux-sg4w:~/SentinelKeysLinux/language_packs/en_US/jre>./jre-1_5_0_06-linux-i586-rpm.bin


3.) now, change to the root directory of the Sentinel Keys package and go into the sentinel_keys_protection_installer/english/ folder. You will need root access to install this part. Run the installer script, ./skpi_install.sh and you will be prompted to a license agreement for using the Sentinel Keys software. After agreeing, you'll come to a prompt and choose option number 2, "Install both Server and SUD". This will install both the server and the usb daemon for using your Sentinel Hardware Key.

linux-sg4w:/home/rengeo/SentinelKeysLinux/sentinel_keys_protection_installer/english # ll
total 324
-r--r--r-- 1 rengeo users   5949 2006-06-11 13:30 licenseagreement.txt
-r--r--r-- 1 rengeo users 302434 2006-06-11 13:30 ReadMe.pdf
drwxr-xr-x 2 rengeo users    200 2007-01-10 15:35 sentinel_usb_daemon
drwxr-xr-x 2 rengeo users     96 2007-01-10 15:35 server
-r-xr-xr-x 1 rengeo users   9644 2006-06-11 13:30 skpi_install.sh
-r-xr-xr-x 1 rengeo users   5949 2006-06-11 13:30 skpi_uninstall.sh
linux-sg4w:/home/rengeo/SentinelKeysLinux/sentinel_keys_protection_installer/english # ./skpi_install.sh
-------------------------------------------------------------------------------
                Sentinel Keys Protection Installer 1.0.2 Installation Script
                           Copyright (C) 2006 SafeNet, Inc.
                               All rights reserved.
-------------------------------------------------------------------------------
This script will install
    - Sentinel USB Daemon 7.3.0
    - Sentinel Keys Server 1.0.2 (Optional)
-------------------------------------------------------------------------------
   1 : Install only SUD
   2 : Install both Server and SUD
   0 : Exit
Please enter your choice: 2
-------------------------------------------------------------------------------
Installing Sentinel USB Daemon 7.3.0
Preparing...                ########################################### [100%]
   1:sntl-sud               ########################################### [100%]
Starting Sentinel USB Daemon:                                         done
Sentinel USB Daemon installation was successful.
-------------------------------------------------------------------------------
Installing Sentinel Keys Server
Preparing...                ########################################### [100%]
   1:shk-server             ########################################### [100%]
Starting Sentinel Keys Server:                                        done
linux-sg4w:/home/rengeo/SentinelKeysLinux/sentinel_keys_protection_installer/english # exit
exit
rengeo@linux-sg4w:~/SentinelKeysLinux/sentinel_keys_protection_installer/english>

And that's it! Your server should be up and running now. If you're having problems connecting to your server, check your firewall settings and make sure that port 7001 is open.

Download Seismic Studio Linux

Go to the downloads page, and download the appropriate package for your Linux Distribution. Supported Distributions are currently:
Red Hat Enterprise Linux 4.3 or higher
SuSE Linux 10.0 or higher

Many other distributions are able to work, but may require a more involved setup. If your distribution isn't listed here and you are experiencing problems with the generic x86 installer, please contact us to see if we can support your distribution. Please note that we may not guarantee support on all linux versions, but we will do our best to accomodate you and do our best to add your distribution to our list of supported distributions.

Installing & Configuring Seismic Studio Linux (Generic x86)

First Install


1.) Make a new directory in the destination folder. Recommended directories are /usr/local/RenegadeGeophysics/ or /home/username/RenegadeGeophysics/
note: If you're installing into any of the /usr/ prefixes, you will need administrator privelages
2.) Download the full Seismic Studio tar archive into the directory you created. You can find it here.
3.) Extract the tar archive.
4.) ...
5.) profit!

Example:
[rengeo@localhost demo]$ ls
SeismicStudioLinux1_2_99_x86_32_full.tar.gz
[rengeo@localhost demo]$ tar xfz SeismicStudioLinux1_2_99_x86_32_full.tar.gz
[rengeo@localhost demo]$ ls
SeismicStudioLinux  SeismicStudioLinux1_2_99_x86_32_full.tar.gz
[rengeo@localhost demo]$ ll
total 39764
drwxrwxr-x  7 rengeo rengeo     4096 May 14 16:03 SeismicStudioLinux
-rw-rw-r--  1 rengeo rengeo 40657243 May 15 11:31 SeismicStudioLinux1_2_99_x86_32_full.tar.gz
[rengeo@localhost demo]$ cd SeismicStudioLinux
[rengeo@localhost SeismicStudioLinux]$ ll
total 48
drwxr-xr-x  2 rengeo rengeo 4096 May 14 15:30 bin
drwxr-xr-x  2 rengeo rengeo 4096 Apr  6 09:49 lib
drwxrwxr-x  8 rengeo rengeo 4096 Apr 12 15:24 mono
-rwxr-xr-x  1 rengeo rengeo 3389 May 14 15:59 README
drwxr-xr-x  2 rengeo rengeo 4096 May 14 13:58 rst
drwxr-xr-x  2 rengeo rengeo 4096 Apr  6 09:49 SeismicStudio1.2.99
[rengeo@localhost SeismicStudioLinux]$

How to update

1.) Download the updater here into the same directory that your SeismicStudioLinux directory is located in.
2.) Extract the tar archive and overwrite if asked. This will make a new directory with the new Seismic Studio Version, in parallel to your old version. If you're updating the same version, files from that version will be overwritten.
3.) Delete the directory for the old version if you want (will be SeismicStudioLinux/SeismicStudioOLDVERSION)

Example:
rengeo@linux-sg4w:~/rengeoDemo> ll
total 46389
drwxr-xr-x 3 rengeo users       80 2007-04-04 14:03 ApplicationSettings
-rw-r--r-- 1 rengeo users        0 2007-03-29 16:03 README
drwxr-xr-x 7 rengeo users      208 2007-04-04 10:28 SeismicStudioLinux
-rw-r--r-- 1 rengeo users 47456206 2007-04-04 14:03 SeismicStudioLinux1_2_99_x86_full.tar.gz
rengeo@linux-sg4w:~/rengeoDemo> cp -v ../RenegadeGeophysics/SeismicStudioLinux1_2_99_x86_update.tar.gz .
`../RenegadeGeophysics/SeismicStudioLinux1_2_99_x86_update.tar.gz' -> `./SeismicStudioLinux1_2_99_x86_update.tar.gz'
rengeo@linux-sg4w:~/rengeoDemo> ll SeismicStudioLinux
total 9
drwxr-xr-x 2 rengeo users  264 2007-04-04 10:28 bin
drwxr-xr-x 2 rengeo users   88 2007-03-12 10:11 lib
drwxr-xr-x 8 rengeo users  192 2007-03-29 15:03 mono
drwxr-xr-x 2 rengeo users  272 2007-04-04 12:37 rst
drwxr-xr-x 2 rengeo users  752 2007-04-03 15:35 SeismicStudio1.2.99
-rwxr-xr-x 1 rengeo users 6893 2007-04-04 10:26 ss-setup
rengeo@linux-sg4w:~/rengeoDemo> tar xvfz SeismicStudioLinux
SeismicStudioLinux/                         SeismicStudioLinux1_2_99_x86_full.tar.gz    SeismicStudioLinux1_2_99_x86_update.tar.gz
rengeo@linux-sg4w:~/rengeoDemo> tar xvfz SeismicStudioLinux1_2_99_x86_update.tar.gz
README
SeismicStudioLinux/bin/
SeismicStudioLinux/bin/ss
SeismicStudioLinux/bin/sfm
SeismicStudioLinux/bin/sgyv
SeismicStudioLinux/bin/segyfilemanager
SeismicStudioLinux/bin/segyviewer
SeismicStudioLinux/bin/seismicstudio
SeismicStudioLinux/bin/seismicstudio.seismicstudio
SeismicStudioLinux/rst/
SeismicStudioLinux/rst/segyfilemanager.rst
SeismicStudioLinux/rst/config.rst
SeismicStudioLinux/rst/DO_NOT_EDIT_THESE_FILES
SeismicStudioLinux/rst/seismicstudio.seismicstudio.rst
SeismicStudioLinux/rst/ss-setup.rst
SeismicStudioLinux/rst/segyviewer.rst
SeismicStudioLinux/SeismicStudio1.2.99/
SeismicStudioLinux/SeismicStudio1.2.99/Tao.OpenGl.dll
SeismicStudioLinux/SeismicStudio1.2.99/RenUtil.dll
SeismicStudioLinux/SeismicStudio1.2.99/RenMathLib.dll
SeismicStudioLinux/SeismicStudio1.2.99/Tao.OpenGl.Glu.dll
SeismicStudioLinux/SeismicStudio1.2.99/Tao.Platform.Windows.dll
SeismicStudioLinux/SeismicStudio1.2.99/LayerModelLib.dll
SeismicStudioLinux/SeismicStudio1.2.99/hasp_net_windows.dll
SeismicStudioLinux/SeismicStudio1.2.99/RenInterface.dll
SeismicStudioLinux/SeismicStudio1.2.99/SegyViewer.exe
SeismicStudioLinux/SeismicStudio1.2.99/BatchLib.dll
SeismicStudioLinux/SeismicStudio1.2.99/ProjectLib.dll
SeismicStudioLinux/SeismicStudio1.2.99/SegyFileManager.exe
SeismicStudioLinux/SeismicStudio1.2.99/Segyviewer.exe
SeismicStudioLinux/SeismicStudio1.2.99/RenError.dll
SeismicStudioLinux/SeismicStudio1.2.99/RenLib.dll
SeismicStudioLinux/SeismicStudio1.2.99/SeismicStudio.exe
SeismicStudioLinux/SeismicStudio1.2.99/ParametersV1.dll
SeismicStudioLinux/SeismicStudio1.2.99/Tao.OpenGl.ExtensionLoader.dll
SeismicStudioLinux/SeismicStudio1.2.99/Library.dll
SeismicStudioLinux/SeismicStudio1.2.99/SeismicSlice.dll
SeismicStudioLinux/ss-setup
rengeo@linux-sg4w:~/rengeoDemo>

Using a different version of Mono
TODO

Running Seismic Studio

1.) Seismic Studio relies on 2 environment variables in order to run. $SS_PREFIX and $MONO_PREFIX

$SS_PREFIX

This is where your Seismic Studio is installed. This is the root directory where you can find the version specific directory. The contents of this directory should look like:

[rengeo@localhost SeismicStudioLinux]$ pwd
/home/rengeo/RenegadeGeophysics/SeismicStudioLinux
[rengeo@localhost SeismicStudioLinux]$ ls -lah
total 80K
drwxrwxr-x  7 rengeo rengeo 4.0K Apr 12 15:23 .
drwxrwxr-x  4 rengeo rengeo 4.0K Apr 25 14:58 ..
drwxr-xr-x  2 rengeo rengeo 4.0K Apr 16 12:47 bin
drwxr-xr-x  2 rengeo rengeo 4.0K Apr  6 09:49 lib
drwxrwxr-x  8 rengeo rengeo 4.0K Apr 12 15:24 mono
drwxr-xr-x  2 rengeo rengeo 4.0K Apr  6 09:49 rst
drwxr-xr-x  2 rengeo rengeo 4.0K Apr  6 09:49 SeismicStudio1.2.99
[rengeo@localhost SeismicStudioLinux]$ echo $SS_PREFIX
/home/rengeo/RenegadeGeophysics/SeismicStudioLinux/
[rengeo@localhost SeismicStudioLinux]$
TODO
2.) If you want to be able to run Seismic Studio from anywhere, you will need to add the SeismicStudioLinux/bin/ directory to your path. You can add this to your login script so it sets up your path automatically. For shells using .bashrc add a line similar to the example below:

export PATH="/home/rengeo/RenegadeGeophysics/SeismicStudioLinux/bin:$PATH"

Where "/home/rengeo/RenegadeGeophysics/" is where your root installation prefix is located.

You may use any of the provided links (ss or seismicstudio), but they all point to bin/seismicstudio.seismicstudio. You may make your own link if you want as well.
To run a different version of Seismic Studio that is installed in parallel, use [-x versionnumber] when running Seismic Studio.

Installing & Configuring Seismic Studio Linux (RedHat 4.3 x86_64)
...First Install
TODO
...How to update
TODO
...Using a different version of Mono
TODO
...Running Seismic Studio
TODO

Video Card Drivers

Windows.Forms, the main GUI interface that Seismic Studio uses, uses libgdiplus for it's drawing. libgdiplus is built on top of cairo, which uses openGL to draw to your display. Most default Linux distributions will install the generic drivers for everything. The main driver to be worried about is your video card driver, since most distributions use the MESA openGL API. MESA is sort of a stripped down openGL implementation that works, but is horribly slow. If using MESA drivers, the windows in Seismic Studio (especially graphically intensive windows such as trace display) will draw very slowly.

To help this, installing drivers specific video card will help tremendously. All video cards have their own openGL API, and all the drivers do is access the openGL on your video card. Therefore, you do not need to install the manufacturer's drivers, if you have a 3rd party driver installed already, as 3rd party drivers are just fine. The driver just needs to be able to use that openGL API on your video card. We recommend the nvidia chipset, as the ATI chipset can be hard to install on Linux. However, you can use any chipset you want (ATI, nvidia being the main ones), provided you have working drivers. We will not support installation of 3rd party drivers, so you and your IT department are on your own getting those installed.

To find out what drivers you are currently using, open up a command prompt and type (you may need to do this as root)
glxinfo | grep OpenGL

If it says MESA anywhere in that output, you need to install drivers for your specific video card. Please contact your system administrator if you don't know what you're doing, as linux driver installation can be a little bit more interesting than windows. Also, you can TRY running Seismic Studio using the MESA drivers, but we are not responsible for terrible performance you may experience if you go this route. Here's a sample output from my personal test box running SuSE 10.1, with an nvidia video card, and is what your video card driver info should look like:
linux-sg4w:/home/rengeo # glxinfo |grep OpenGL
OpenGL vendor string: NVIDIA Corporation
OpenGL renderer string: GeForce 7900 GS/PCI/SSE2
OpenGL version string: 2.1.0 NVIDIA 96.29
OpenGL extensions:
linux-sg4w:/home/rengeo #


Page last updated 5/31/07 by Eric Morgan