Professional Documents
Culture Documents
1
Release Notes
Solaris and Linux
Contents
Release Letter for SeisSpace 2003.12.1.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Patch List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Cluster Environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Starting SeisSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Enhancements and New Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Fixed Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Known Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Release Notes
Page 1 of 48
January 2006
Landmark
Release Notes
Page 2 of 48
January 2006
Landmark
Release Notes
Page 3 of 48
January 2006
Landmark
Introduction
This is a combination of the original 2003.12.1 release notes with new information
appended for the 2003.12.1.1 functional upgrade. You can find all of the new text
associated with this upgrade by searching on 2003.12.1.1.
2003.12.1.1
This functional upgrade to SeisSpace is paired with the 2003.12.1.1 ProMAX functional
upgrade. Some components will not work as expected if you run this version of SeisSpace
with the original 2003.12.1 ProMAX release.
When we send out an upgrade to ProMAX we usually send out a tar file with a series of
menus, documentation files, executables, and libraries that are just inserted into an
existing ProMAX installation. For SeisSpace we are making this upgrade available as a
complete new installation. This is because SeisSpace is delivered as a combination of
individual files and some jar files that are combinations of several files. It is a lot safer for
us to repackage the entire jar files instead of trying to patch a jar file in your existing
installation.
To install this upgrade to SeisSpace you should:
Stop your existing work and site managers, clients, netdir admins and make sure all
FFDB managers are also killed.
Install this upgrade in the same place as your existing 2003.12.1 installation.
Copy the netdir.xml file from the 2003.12.1 logs directory into the 2003.12.1.1 logs
directory.
set up a new set of manager start scripts to point to the 2003.12.1.1 directory and the
new log directory.
Release Notes
Page 4 of 48
January 2006
Landmark
DO NOT attempt to have two sitemanagers running on two different ports accessing the
same netdir.xml file.
There is a comment in the Limitations section from the original release notes that
discusses a recommendation to put Hybrid and Pure SeisSpace flows in the flows list of
a SeisSpace project. After further consideration, the current recommendation is to put all
flows and Tables in the ProMAX project and only put SeisSpace datasets in the
SeisSpace projects.
Overview
These Release Notes provide the necessary information to correctly install and configure
SeisSpace on Solaris and Linux machines. These notes also contain operating system
requirements and descriptions of required third party software, as well as information for
setting up parallel configurations, network dependencies and tested hardware
configurations.
See Enhancements and New Functionality on page 43 and Fixed Problems on
page 45 for a description of the changes associated with this release.
SeisSpace and ProMAX are Landmarks seismic data processing applications. ProMAX
was originally designed for single workstation, small scale, 2D land data processing QC
applications. Over the years ProMAX has grown to be a full featured 2D, 3D, 4D, land,
marine and VSP data processing package. However, ProMAX does not parallelize
efficiently over a large number of distributed computers.
SeisSpace was originally designed for multiple CPUs and multiple workstations, or cluster
computing environments, for large scale, 3D marine data processing applications. There
are many land 3D applications as well, but SeisSpace does not support surface consistent
processes, such as refraction or residual statics.
SeisSpace is a major subsystem of the processing portfolio. ProMAX is the main system
with subsystems of General Processing Tools, The User Interface/Flow Builder, Tape
Input/Output, Queuing, Plotting, ProMANAGER, and its Development kit. SeisSpace adds
a new Navigator/Flow Builder/Flow Replicator User interface and a new processing
executive which runs in a different environment than that of the ProMAX executive.
This version of SeisSpace is an optional addition integrated with ProMAX. It features 3D
Prestack Time Migration and introduces the SeisSpace Navigator/Flow Builder that can
be used for all of your processing work in one consolidated user interface instead of three.
You can use the SeisSpace user interface to build and manage all ProMAX flows, all
SeisSpace flows and the flow replication previously handled by ProManager.
Release Notes
Page 5 of 48
January 2006
Landmark
SeisSpace/ProMAX Compatibility
SeisSpace and ProMAX come as a matched set. You must make sure that the correct
versions of ProMAX and SeisSpace are installed and configured to ensure compatibility
between the two systems.
Release Notes
Page 6 of 48
January 2006
Landmark
Data Exchange
SeisSpace and ProMAX use different data storage formats. However, you can access the
alternate formats. For example. SeisSpace Disk Data Input, in SeisSpace, directly reads
ProMAX datasets and SeisSpace Data Input, in ProMAX, directly reads SeisSpace
format data files. At this time, neither system will write to the alternate system data format.
Note: ProMAX datasets are not read in parallel. You may see some distribution of the
data over a series of nodes but in general you should not read ProMAX format data to
drive hybrid flows. You can read ProMAX format data for a SeisSpace 3D PSTM flow if
you have set the switch in the SeisSpace Disk Data Input to have each node read all of
the data.
SeisSpace directly accesses ProMAX tables. There are no SeisSpace-specific tables at
this time. ProMAX is used to pick mutes, and design gates and velocity tables to use in a
SeisSpace 3D Prestack Time Migration workflow.
Limitations
As with any complex, full-featured software product, SeisSpace 2003.12.1 contains some
bugs. However, none were considered serious enough to stop shipment of the release. A
Known Problems list for this release is available online through Landmark's website. This
list is frequently updated. See Known Problems on page 46 in the System Administration
manual for information on downloading this list.
Here are listed some know issues related to day to day use of the SeisSpace Navigator/
Flow Builder:
In a multi-user environment the site and work managers must be owned and running
as root. (This is not an absolute requirement for the sitemanager - but it is highly
Release Notes
Page 7 of 48
January 2006
Landmark
recommended). You can have multiple manager sets running as different users for
different reasons by using different communication port specification in the
PROWESS_PORT environment variable in the startup scripts. Landmark
recommends against having each user run their own set of managers.
After you restart the workmanager(s) for whatever reason, you must also restart the
Flat File Database (FFDB) managers. The recommended approach is to start the
Network View user interface immediately after restarting the launcher after restarting
the workmanager(s) and select any FFDB managers that are running and kill them.
The most obvious symptom of the need to do this is that jobs will not submit. To restart
the FFDB managers select the HOST folder at the top of the tree view and then do a
CTRL-MB1 click on the refresh icon to force a reread of the tree from disk.
As you expand the tree view and select projects, the retrieving data text is the sign
that the FFDB manager for that project is being started.
Testing of the 3D Prestack Time Migration jobs on large clusters has led us to the
recommendation that you not use more than about 30 nodes per job and that you not
attempt to hold more than about 1gb of image space in memory per node.
The Navigator does its best to prevent you from adding the wrong dataset types to the
wrong projects. Make sure that you add ProMAX datasets to the ProMAX project and
SeisSpace datasets to the SeisSpace projects. The Navigator also does its best to
prevent you from selecting the wrong type of data for a menu parameter.
The Flow Builder does its best to prevent you from building "interleaved" hybrid flows
where you have ProMAX and SeisSpace tools interleaved in the flow. These flows
may or may not work. You should restrict hybrid flows to being a single block of
ProMAX processes surrounded only by SeisSpace processes.
The Flow Builder does its best to prevent you from building "inverse-hybrid flows
where you could insert SeisSpace processes inside a flow that is driven by ProMAX
Input and Output modules. These flows might work but are not supported and should
not be built.
You can build and execute pure ProMAX flows under a SeisSpace Project and you can
build pure SeisSpace flows under a ProMAX project. In either case, these jobs should
work. It is recommended, however, that you build all pure ProMAX flows in the
ProMAX project and pure SeisSpace flows in the SeisSpace project. Hybrid flows can
be built in either project, and it may be easier for flow management to build hybrid flows
in the ProMAX project, but be aware that SeisSpace datasets for these flows need to
be managed in the SeisSpace project.
When working on ProMAX flows, the flow builder will allow you to choose datasets
from Areas and Lines in other projects (other PROMAX_DATA_HOMEs). Flows that
are built with data file from other projects or data homes will not work. You can only
choose datasets from other Lines in Areas within the same ProMAX project (or
Release Notes
Page 8 of 48
January 2006
Landmark
DATA_HOME). The ability to directly choose datasets from other lines in the same
area, or other lines in other areas in the same project is only available in Disk Data
Input, Disk Data Insert, Tape Data input, Tape Data Insert, 2D Supergather Formation,
3D Supergather Formation and Splice Datasets. All other modules must select data
from the same line. Tables must also be chosen from the same line.
Although it seems that you should be able to copy objects from one project to another,
these copy operations are not yet supported. You can make a copy of a flow by
opening the flow in the Flow Editor and copying the processes from that flow to the
new flow in a different project with the Copy and Paste or Drag and Drop functions.
There is currently no way to copy datasets from one Data_Home to another in the
Navigator.
When working with a hybrid flow in a SeisSpace project, you must select the tables for
ProMAX processes from the associated ProMAX Line. When working with a hybrid
flow in a ProMAX project, you must select the tables for ProMAX processes from the
same ProMAX Line.
As a general rule, be very careful when selecting datasets from other areas / lines for
ProMAX processes. In the ProMAX user interface, Disk Data Input, Disk Data insert,
Tape Data Input, Tape Data Insert, ESI Disk Data Input, ESI Disk Data Insert,
Supergather formation, 2D Supergather Formation, 3D Supergather Formation and
Splice Datasets allow you to choose input datasets from a different Area/Line. This is
done using the Read data from other lines / surveys option in these menus. In the
SeisSpace flow builder, this option is not necessary, and the parameter is not exposed
because you can directly select the datasets from a list in another line or Area/Line in
the same Data_Home. The ESI input modules do not work this way and can only be
used to read local datasets in the SeisSpace Flow Builder. When you build a flow in
this manner in the ProMAX user interface and edit it in the SeisSpace flow builder, you
will only see the dataset name in the parameter selection without the area and line.
(You can see the area and line for which the data belongs if you hover the mouse on
the dataset name in the menu.) When you save or submit a flow from the SeisSpace
flow builder that has selected input data from another area/line, the packet file copy of
the flow will be saved as appropriate for the ProMAX user interface and the xml files
will be saved as appropriate for the SeisSpace flow builder. When you move back and
forth between the SeisSpace flow builder and the ProMAX flow builder, there may be
incompatibilities in the way that the variables are assigned values from the menu. This
is not a problem so long as the datasets are selected from the same line as the line
containing the flow. The behavior can be summarized as follows:
When a flow is read for the first time from the packet.job file, it is scanned for
processes with parameters FOREIGN=1 and LABEL_AL=Area Line Dataset
triplet. The processes with this combination will be altered such that FOREIGN=0
and LABEL=Area LineFlow triplet and LABEL_AL=INVALID.
When a flow is saved or executed, the packet file version of the flow will be saved
as follows. If the flow has a process with FOREIGN=0 and LABEL=Area Line Flow
Release Notes
Page 9 of 48
January 2006
Landmark
triplet then the packet file will be saved with FOREIGN=1 LABEL_AL=Area Line
Flow triplet and LABEL=INVALID. If the process has FOREIGN=0 and
LABEL=Dataset then the packet file will be saved the same way.
There are many macros that utilize Disk Data Input and Disk Data Insert. Most of these
macros do not expose the Read from other lines / surveys option and will always use
the specified dataset as a local dataset. This can lead to some incompatibilities
between the ProMAX and SeisSpace flow builders. For example:
The SeisSpace flow builder will allow you to choose a dataset from another area/
line in these macros and in most cases will read that dataset, but if you try to run
the packet file from this flow in the ProMAX UI, the flow will not work because most
of these macros never exposed the option and have forced FOREIGN=0 in the
exec data of the menu file. These menus also expect to only have the single
dataset pathname and not a triplet.
Flow replication is not supported for Hybrid flows or SeisSpace flows in a ProMAX
project.
You may see occasional Flat File Database (FFDB) manager failures which are
caused by poor exit behavior of some of the native ProMAX routines. These types of
failures can occur when manipulating database objects such as renaming or deleting
objects when permission errors occur. This may also happen if you do a recursive
permission change on a ProMAX Area or Line when no secondary storage is specified
in the config_file. You will usually get some number of error dialog boxes and the folder
icons in the project will go to a gray color. You can restart the FFDB manager by
clicking on the Hosts folder at the top of the tree view, clicking on the refresh icon, and
then navigating down the project again. If you continuously kill the FFDB manager you
will most likely need to do a recursive permission and/or ownership change down the
problem line or area as the root user.
Flat File Database Manager (FFDB) failures may cause interactive jobs started within
that project to not complete correctly. The job log files will usually be truncated. You
can check by reviewing the job log to see if it has the expected number of ensembles
and traces. Jobs will continue for only a finite amount of time after its FFDB manager
disappears.
There are occasions where you may not be able to open the packet file for a flow that
was built in the SeisSpace flow builder using the ProMAX flow builder. You may also
see NIL processes in a flow. In this case, the packet file is generally corrupted and
must be rebuilt. If you encounter one of these NIL processes in the ProMAX user
interface, you will need to kill that instance of the ProMAX user interface and start
another one. Landmark is continuing to find and fix these problems.
Release Notes
Page 10 of 48
January 2006
Landmark
We are making the SeisSpace project archive and restore programs available, but
note that these processes must be run from a top level SeisSpace project. You cannot
properly restore an archive of a subproject at this time. You can archive an entire
project/subproject hierarchy, but not just a subproject.
We have disabled the ability to copy SeisSpace data and have also disabled the ability
to copy or rename SeisSpace projects or subprojects. There is a fundamental
difference in the way that ProMAX datasets are addressed in the flows compared to
how SeisSpace datasets are addressed. In the interest of trying to prevent the user
from accidentally deleting or overwriting the wrong datasets, we require you to
manage the projects and datasets as completely separate entities. ProMAX datasets
and tables are addressed by names that are local, or internal to the project, where as
SeisSpace datasets are addressed by a fully qualified project/subproject/pathname.
You can still easily copy a SeisSpace dataset from one project to another within the
same SeisSpace Data_Home by running a simple Disk Data Input/Disk Data Output
flow.
There are a few modules where we have had to update the ProMAX LISP menus in
order to make them work in the SeisSpace flow builder. These menus(processes) are:
cgmplot_socket.menu (Create CGM+ Plot Files), splc_dset.menu (Splice Datasets),
tapewrite_inc3.menu(Component to all Tape Output menus), seisspace_read.menu
(SeisSpace Data Input), tables.menu (Access Parameter Tables), unisec_build.menu
(Build Unisec Parmfile*), VolumeCompMacro.menu (Volume Comparison Macro*),
shva_edit.menu (Horizon Velocity Analysis), taperead_inc3.menu (Component to all
Tape Input menus), unisec_cgm.menu (UNISEC Create CGM+). You will have to
overlay these processes with the menus from each user interface as you move back
and forth between the UIs
The Navigator allows you to select multiple objects for a common operation, such as
deleting a series of replicated flows or a series of datasets. It has been noted that when
you select several hundred objects to be deleted, the user interface appears to hang
while it is actually deleting the selected objects. We suggest that if you want to perform
such operations, simply start another Navigator to do other work while the first one is
completing the delete operation.
Release Notes
Page 11 of 48
January 2006
Landmark
System Requirements
Hardware Requirements
SeisSpace Server
The SeisSpace Server is designed to run on a Linux cluster. A cluster is a number of PCs,
with a number of processing nodes, and a separate manager node. Landmark
recommends the following hardware:
Server or
Client
Processor Processor
(minimum) (target)
PC - linux
32 bit Intel
Server
PC - linux
64 bit AMD
opteron
Server
2 GB or
greater /
node
PC - linux
Server
64 bit Intel EMT
2 GB or
greater /
node
Platform
Memory
Memory
(minimum) (target)
2 GB /
node
NOTE: Intel Itanium chips are not supported at this time and the software will not run on
these systems.
You need a minimum of 512 Megabytes of memory per CPU and at least 1 Gigabyte
of swap or paging space.
Augment additions to the main memory by expanding the paging space; a Main
Memory: Paging Space ratio of 4:1 is recommended. For very high memory
machines the 4:1 ratio can be relaxed somewhat. Monitor the swap space under
normal load conditions to decide the amount of required swap space. It is critical to
have more swap space available than the amount equal to main memory and this
requirement can vary some from one node to another.
Release Notes
Page 12 of 48
January 2006
Landmark
The Manager node should have at least swap = main memory and a value of 1.5 to 2
times main memory is recommended.
The Login-nodes or nodes where a lot of interactive jobs will be running will require
more swap. On these nodes you should allocate at least 3 times if not 4 times the
amount of main memory as swap space.
The Processing nodes should be setup to have at least 2 times the amount of swap as
main memory but try to go to 3 times if possible.
SeisSpace Client
The SeisSpace Client can run on either a Linux or Solaris platform. Landmark
recommends the following hardware:
Server or
Client
Processor Processor
(minimum) (target)
PC - linux
32 bit Intel
Client
1 GB or
greater
PC - linux
64 bit AMD
Client
512 Mhz P3
1.8 Ghz
256 MB
AMD opteron
or greater
1 GB pr
greater
Solaris
Client
167 Mhz
Ultra
Dual 300
512 MB
Mhz Ultra II
1GB
Platform
Memory
Memory
(minimum) (target)
Release Notes
Page 13 of 48
January 2006
Landmark
Linux 32-bit
Landmark recommends installing all packages of RedHat Linux as a custom installation.
We also recommend to set up the system with no firewalls.
Linux Red Hat Version AWS3.0 Update 2 or 3 32-bit with the following packages is
needed for ProMAX and SeisSpace:
pdksh-5.2.14-21
mysql-3.23.58-1
mysql-server-3.23.58.1
perl-DBD-MySQL-2.1021-3
mt-st-0.7-11 (for tape devices)
There are a variety of kernel versions with various system patches as well. For RedHat
AWS 3.0 the minimum recommended kernel version is:
2.4.21-20.ELsmp #1 SMP Wed Aug 18 20:46:40 EDT 2004 i686 i686 i386 GNU/Linux
Although not officially supported for RedHat 7.3, the recommended minimum kernal
version is:
2.4.18-18.7.xsmp #1 SMP Wed Nov 13 19:01:42 EST 2002 i686
Linux 64-bit
Landmark recommends installing all packages of RedHat Linux as a custom installation.
We also recommend to set up the system with no firewall.
Linux Red Hat Version AWS3.0 Update 2, 3 or 4 64-bit with the following packages is
Release Notes
Page 14 of 48
January 2006
Landmark
If you do not know the operating system, windowing environment, or the release version
for your installation, enter the following command from a Linux platform:
Operating System
% uname -a
Motif /X11
% grep -i revision /usr/include/X11/IntrinsicP.h
Microsoft Windows
The SeisSpace Windows Client is not supported or distributed.
Solaris
Limited testing was done on Solaris 2.8. SeisSpace is only supported on Solaris for
working with ProMAX flows.
Note: in order to get PBS/Torque queues set up on Solaris you will need to have the gcc
compiler installed. If you do not have the compilers, contact support and they can provide
a tar file that can be used to perform the make install step without the compilers.
Release Notes
Page 15 of 48
January 2006
Landmark
Note: Please remember to pay attention to the Solaris-specific requirements to install and
configure MySQL for the flow replication database. This information is in the Setting Up the
MySQL Database section of the SeisSpace System Administration guide in the online help
system.
Release Notes
Linux
Solaris
SeisSpace
239 MB
247 MB
SeisSpace Client
164 MB
183 MB
ProMAX
1231 MB
1241 MB
Page 16 of 48
January 2006
Landmark
Patch List
This release was tested and certified using the patches as listed below. The exact patch
number as shown may not be available from Sun as they continually update version
numbers. Sun recommends installing the latest version of any patch. According to Sun,
patches are downward compatible. The patches are listed by the certified UNIX(R)
platforms and versions.
109544
108576
108604
108605
108652
Motif Patch
108940
Motif Patch
109154
We recommend downloading the recommended patch set from the Sun web site and
installing it. This ensures that all patch dependences are handled.
Release Notes
Page 17 of 48
January 2006
Landmark
Cluster Environments
Basic questions to consider for clusters
Installing and configuring SeisSpace on a cluster is a complex process and many issues
are involved in determining the optimal configuration. The following list of questions will
be helpful in discussing your installation with a Landmark representative.
How much internal disk does each node have and how are the file systems set up?
Can you see the file systems on any node from any other node with exactly the same
name?
How was the O/S loaded? That is, workstation or custom install with which packages
selected?
Is the internal networking of the cluster accomplished via a multiport hub or via a
programmed high speed switch?
Are the processing nodes visible from your desktop or only from the manager node?
Do the processing nodes have multiple IP addresses for fibre or copper network
connections?
Are ssh rsh telnet ftp rlogin enabled from node to node and to and from the
manager as a user or root?
What is the base automount prefix for accessing the automounted disks on other
machines?
Release Notes
Page 18 of 48
January 2006
Landmark
Will you use the local disks on the processing nodes for storage? Do you have disk
storage or a file server external to the cluster?
Are home directories common, that is exactly the same disk on each node?
Do all users have the same user id number on all of the nodes?
Which Queues are set up on the cluster? SeisSpace only communicates with PBS or
Torque.
Do the nodes have constant IP addresses? DHCP need to be set up so that the nodes
always have the same IP address.
Does a command exist to run the same command on all nodes in parallel as root and
a user?
Routing Issues
A special routing problem can occur if a Linux cluster mayor or manager node has two
ethernet interfaces: one for an external address and one for an internal cluster IP address.
If the mayor's hostname corresponds to the external address, then the machine
misidentifies itself to other cluster nodes. Those nodes will try to route through the external
interface.
Quick Fix
You can use the internal address of the mayor node as the external address of the mayor
node.
Release Notes
Page 19 of 48
January 2006
Landmark
where 172.16.0.1 is the internal IP address of the mayor node and 146.27.172.254 is
the external address of the mayor node.
Better Fix
Set the route on all cluster nodes to use the internal address of the mayor for any unknown
external address:
% route add -net 0.0.0.0 netmask 0.0.0.0 gw 172.16.0.1
Adding Routes
Outside machines might not have a route to the cluster nodes. To add a route to a PC
needing a cluster node, set the route to use the external address of the mayor node to all
cluster node addresses:
% route add 172.16.0.0 mask 255.255.0.0 146.27.172.254
where 172.16.0.0 with a mask of 255.255.0.0 specifies the address range of the cluster
nodes and 146.27.172.254 is the external address of the cluster mayor node.
route
route -n
netstat -r
netstat -rn
Make sure your nodes IP address is associated with the ethernet interface.
% ifconfig -a
Hardwire the correct association of IP addresses with hostnames. Use the same file for
all nodes, including the mayor.
Release Notes
Page 20 of 48
January 2006
Landmark
% cat /etc/hosts
% cat /etc/nsswitch.conf
% cat /etc/resolv.conf
You may decide to use a couple of the nodes as user "login" nodes to run:
Release Notes
Page 21 of 48
January 2006
Landmark
You should only run the following on the "invisible" cluster nodes:
PBS - mom
SeisSpace workmanager
ProMAX and SeisSpace jobs released from the queue or jobs directed to run on those
nodes.
Additional Considerations
In addition to the above, you will need to ensure that the manager node and the "login"
nodes are set up with multiple IP addresses so that they are visible on both networks. The
internal cluster network and the external user network.
For SeisSpace Host specification, the "login" node will need to be the primary
administrative host. This will make is so that direct submit jobs will run on the "login" node
instead of on the manager.
Running jobs on the manager should generally be avoided so that this node can be
available to do the system management work that it is intended to do.
You want to avoid having a PBS-mom running on the "login" node(s) to prevent jobs from
the queue from running on these nodes. The "login" node should be reserved for
interactive display jobs and small direct submit test jobs.
Release Notes
Page 22 of 48
January 2006
Landmark
Installation
Overview
The software is delivered on CD-ROMs. You can install the applications using the
Landmark CD Release Manager (CDINSTALL).
This install media contains the shell script setup and the necessary tools to extract the
application from the CD and transcribe the application to disk.
Note: For some Linux 64 installations, the xterm included on the CD and called by
CDINSTALL will not run properly. The installation does seem to work fine on 64 bit
machines running RedHat AWS3.0 Update4. If the installation does not complete
successfully, you must copy the files from the CD to disk, and replace copylocation/bin/
Linux/xterm with the one from your operating system (typically found in /usr/bin). The
xterm is used to run the post-installation script so if you do not replace the xterm,
CDINSTALL will report an error. You could also run CDINSTALL from the CD and then
execute the post-install script manually. In this case, execute SeisSpaceInstall in the
$PROWESS_HOME/install directory after setting the PROWESS_HOME environment
variable as the same user which performed the installation.
Note: The software installation starts from a script that prompts for input; you do not need
root privileges.
The CD Release Manager program provides a consistent graphical user interface for
installing SeisSpace and other Landmark applications. After you specify the programs to
be installed and the directories in which to install them, the program provides a graphical
status display of the installation progress. Do not use the upgrade option as it is not
functional.
The SeisSpace software distribution is on one CD-ROM which includes all necessary files
for installing SeisSpace:
SeisSpace
SeisSpace Client
The installation procedure is generally platform independent. You will need to install both
SeisSpace and SeisSpaceClient on Linux or Solaris and the installation directory
hierarchy can be identical for both platforms.
Page 23 of 48
January 2006
Landmark
1. Insert the application CD into a CD drive that is visible from the machine where you
wish to run the installer.
2. In a terminal window, change directories to your cdrom drive. For a typical Linux
installation, type the following command:
cd /mnt/cdrom
3. Change directories to the install directory and type the following command:
cd install
./setup
Typically /tmp is acceptable and you can enter y and press the enter key. The
installation script will continue with the following prompt:
**************************************************************
*
*
*
If you are not installing an OpenWorks Related Product
*
*
the OWHOME directory only refers to a target directory
*
*
*
**************************************************************
OWHOME must be set. A full path is required.
Please enter path :
Enter the full path to your installation directory. This path is used to determine where
to install the application. For example, if you want to install SeisSpace in a subdirectory
Release Notes
Page 24 of 48
January 2006
Landmark
from /usr/apps, then set OWHOME to /usr/apps and SeisSpace will be installed in /usr/
apps/SeisSpace. Landmark recommends that you install SeisSpace in the same root
directory where ProMAX is installed.
If you want to add the SeisSpace and SeisSpace client directories to the /
automountrprefix/hostname/disk/file-system/apps directory where ProMAX is
installed enter this full path name during your installation. (OWHOME when running
CDInstall). We use the name /apps for brevity.
When installed, you should have a directory structure similar to the following:
.../apps/ProMAX
.../apps/revisions
.../apps/SeisSpace
.../apps/SeisSpaceClient
The Software Selection window appears along with the Release Manager Release
Release Notes
Page 25 of 48
January 2006
Landmark
This window shows the applications that are available for installation, any special installation parameters to be used, the version number of the application, the space in MB
required to install the application, and the location where the application is to be installed.
Release Notes
Page 26 of 48
January 2006
Landmark
Icons
5. Select the applications to install. You must install both SeisSpace and
SeisSpaceClient. When you click on a field in the Install Option column, a popup
menu appears. Select one of the following:
6. Select the filesystem for installation. The Location column shows the default
locations. To change the default location displayed, click on the ... button next to the
location.
The Location Selection Dialog appears:
This window shows all file systems on which your system is mounted and the space available on each. To select a file system, click on it. Available directories on the file system
appear in the Path area.
7. Select the directory for installation. The name of the directory appears in the
Selection field. You can create a directory by typing the name in the Selection field.
Click OK to select the directory and close the window.
Click Cancel to close the window without selecting a directory.
Release Notes
Page 27 of 48
January 2006
Landmark
8. After you have selected the applications and installation locations, click Start. The
following window appears:
9. The installation program begins to copy files to the selected file system. As the
installation proceeds, the status bars at the bottom of the window are updated.
10. When the installation process is complete, an information window opens:
Release Notes
Page 28 of 48
January 2006
Landmark
Release Notes
Page 29 of 48
January 2006
Landmark
The logs directory is used to store the netdir.xml file. This file is the master
configuration file for the SeisSpace installations. Keep it in a directory outside of the
main installation directories to avoid deleting it when you reinstall or update the
installation version later. The site and work managers also write log files to this
directory.
Note: You should also move the ProMAX etc and queues directories outside the
ProMAX installation tree for safe keeping as well.
It is advantageous to put the following directories together under the .../apps directory:
.../apps/ProMAX
.../apps/revisions
.../apps/SeisSpace
.../apps/SeisSpaceClient
.../apps/logs
.../apps/etc
.../apps/queues
.../apps/bin
You can store the startup and maintenance scripts in the../apps/bin directory.
You will need to add the environment variables PROMAX_ETC_HOME and
PROMAX_QUEUES_HOME to the environments that start ProMAX. Also include them in
the ProMAX project environments described in Configuring SeisSpace.
DO NOT PROCEED UNTIL YOU HAVE RECEIVED A VALID LICENSE FILE FROM LANDMARK.
License Manager
This release is licensed under the FLEXlm licensing software (LAM). SeisSpace uses
ProMAX license features for the Navigator/Flowbuilder and for running ProMAX and
SeisSpace jobs. If you have a ProMAX 2003.0 license running against 2003.0 LAM
Release Notes
Page 30 of 48
January 2006
Landmark
license software, then you will not need a new license file and you will not have to reinstall
LAM.
Page 31 of 48
January 2006
Landmark
When you activate LAM, it creates a hidden file on your home directory called .flexlmrc.
This file contains a speed-optimization to help FLEXlm locate the license file and the
license server. You need to remove the file before changing your configuration.
Landmark suggests that you disable the creation of this file by including the following line
in your environment file:
FLEXLM_NO_CKOUT_INSTALL_LIC 1
Release Notes
Page 32 of 48
January 2006
Landmark
Starting SeisSpace
Overview
This section discusses building startup scripts, starting the managers, starting SeisSpace
and setting up the administrator host. Once the host has been selected, you then
configure your SeisSpace environment. We also discuss the Administrator Tool (this tool
modifies or creates the same information as the SeisSpace wizards), and setting up the
SQL database.
Below is a summary of the steps needed to start and run SeisSpace:
Start SeisSpace
Release Notes
Page 33 of 48
January 2006
Landmark
Release Notes
Page 34 of 48
January 2006
Landmark
# 5312.
#default# export PROWESS_PORT=5006
# Specify the path to the logs directory. This is where youll find
# log files and the netdir.xml file for the sitemanager.
#default# export PROWESS_LOGDIR=$PROWESS_HOME/../logs
# Execute the system sitemanager script.
$PROWESS_HOME/port/bin/sitemanager $1
Page 35 of 48
January 2006
Landmark
Page 36 of 48
January 2006
Landmark
Page 37 of 48
January 2006
Landmark
Note: The site and workmanager scripts take an input argument. This argument is
passed to the main $PROWESS_HOME/port/bin/sitemanager and workmanager
scripts. The argument can be start, stop, or restart.
380.
Page 38 of 48
January 2006
Landmark
The netdir.xml file and the log files will be owned by the non-root administrative user.
Eventually these files will be managed by root and will need to be owned by root with
permissions of rwxr_xr_x. You will change ownership and permissions on the files later in
the configuration procedures.
Log out
Log in as the administrative user you just created
Go to the Administrator tool to start the system configuration
Release Notes
Page 39 of 48
January 2006
Landmark
In a production environment, the site and workmanagers are started and owned by root
when the system boots, but the administrative user(s) will have permission to update the
netdir.xml configuration file.
Starting SeisSpace
7. As a non-root, administrative user, start the client by executing the SSclient script.
.../apps/bin/SSclient
The SeisSpace Connection window appears with Host and Port defaulted to the values
set for PROWESS_HOST and PROWESS_PORT in the SSclient startup script. The User
name is set as the current user running the script. (This should be the same user as is
Release Notes
Page 40 of 48
January 2006
Landmark
8. Click login.
The Launcher Bar appears:
This completes the SeisSpace installation and configuration of the basic managers.
You are advised at this time to select Help and navigate to the System Administration
section and complete the System and Data-Home setup.
If you started the sitemanager the first time as root and you start the Client the first time
Release Notes
Page 41 of 48
January 2006
Landmark
as root:
The SeisSpace Connection window appears with Host and Port defaulted to the
values set for PROWESS_HOST and PROWESS_PORT variables in the SSclient
script.
You will be presented with a single icon on the launcher bar that is the admin tool and
this will have only the user wizard available
Add an administrative user, exit and log back in as that user you just added.
Release Notes
Page 42 of 48
January 2006
Landmark
Preferences
Local Submit host- A preference was added to the Navigator pane of the preferences
GUI that asks where the local submit host is. There are two choices: Project and Client.
This feature was put in place for the sites that have a cluster with administrative nodes, or
login nodes, and the users have Linux boxes on their desktops that are viable for running
interactive and test jobs. In this case, you can still use the login node as the
administrative host and run the FFDB managers there, but locally submitted jobs can run
on the users Client desktop instead of the login node.
Program for executing command on remote machine - A preference was added
allowing for the use of ssh as an option to rsh to get commands to run on remote
machines. This is typically related to rshing or sshing to the queue server to run the Qsub
command to put jobs into the queue.
Job Submit
Improved the performance of the job submit from about 8 seconds per job to about 1
second per job. This is a significant benefit when youre submitting large numbers of jobs
at one time using the job table in flow replication.
The job submit user interface was simplified somewhat and re-arranged to better handle
the building the #PBS nodes=#:property:ppn=# line in the qsubmit q directives. The slider
bars for number of nodes, number of threads, and progress report interval have been
replaced with simple numeric entries. An option was enabled where you can automatically
choose the property if the property is the same as the queuename.
Also added an option to the Job Submit user interface where the queue directive equals
the queuename for a property.
Release Notes
Page 43 of 48
January 2006
Landmark
Navigator
Name Column- The name column in the table view of the navigator is now painted with
a different color compared to the other columns in the table. This is meant to be a visual
clue that this column is different from the rest and has different functions and options
Type Column- The type column, which is the column that is occupied by either a folder,
or table, or datasets icon can be used to select mutiple/sequential entries in the table by
holding down MB1 on the rows of interest.
Multiple object and project delete- The action of deleting multiple flows, or datasets or
entire lines or entire areas is significantly faster. The user interface now has an additional
level of verification before performing this operation.
Initial list of Areas/Lines- The action of getting the initial list of areas and lines under
areas is significantly faster.
Flow Replication
Mass Job Submit- The action of submitting jobs from the the job table to the queue is
significantly faster. It has been improved from approximately 8 seconds per job to about
1 second per job.
Job Viewer
Deletion from the Queue- The action of deleting jobs that are in the queue from the Job
Viewer is significantly faster
Release Notes
Page 44 of 48
January 2006
Landmark
Fixed Problems
2003.12.1.1
General
Host names with capital letters- There should no longer be a problem queuing up jobs
on host with capital letters in the host name.
Navigator
Job submit stalling flow rep job submit- The action of submitting a job from the flow
editor tab or from the Navigator tab directly from the tree or table listing no longer halts the
batch job submit operation being performed from the job table.
2003.12.1
General
User Interface - There were not a lot of defects in the original user interface, but we made
hundreds of changes and upgrades to it.
VFS directory paths - In the original version of SeisSpace that some sites have been
using for a while, the project directory paths in the vfs directory have had blanks in the
paths. It was felt that this was not the best way to do this. So we changed it so that the
project directory paths are squished. This makes the project directory paths in the project
directory and the project directory paths in the vfs directory consistent. (squished means
that blank spaces and some reserved characters are removed)
There should be no huge backward compatibility issue with this. You can read all
previously existing datasets. You will now see two different directory paths in the vfs
though. The original non-squished path and the new squished paths. Both directories will
be removed from the vfs if you delete the project from the navigator.
Both directories will be archived, but when restored there will only be the squished
directories.
Release Notes
Page 45 of 48
January 2006
Landmark
Known Problems
The Known Problems List is a list of all the significant problems that we know exist at the
time the software was released.
You can click the link below and see all the known problems for SeisSpace.
SeisSpace Known Problems list
You can view the Known Problems for ProMAX by clicking the following link:
ProMAX Known Problems list
Release Notes
Page 46 of 48
January 2006
Landmark
License Acknowledgements
The Open Group
Copyright 1985, 1986, 1988, 1998 The Open Group
Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above
copyright notice appear in all copies and that both that copyright notice and
this permission notice appear in supporting documentation.
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE OPEN GROUP
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Release Notes
Page 47 of 48
January 2006
Landmark
Landmark/Asia Pacific
11th Floor Menara Tan & Tan
207 Jalan Tun Razak
50400 Kuala Lumpur
Malaysia
Tel: 011-60-3-2164-1121
Fax: 011-60-3-2164-1135
Help Desk: 011-61-8-9481-4488
Email: apsupport@lgc.com
Landmark/EAME
Hill Park South
Springfield Drive
Leatherhead, Surrey GU22 7NL
England
Tel: 011-44-1372 868-600
Fax: 011-44-1372 868-601
Help Desk: 011-44-1372-868-686
Email: eame_helpdesk@lgc.com
Landmark/The Americas
2101 CityWest Blvd., Building 2
Houston, TX 77042-3021
P.O. Box 42806, Houston, TX 77242
U.S.A.
Tel: 713-839-2000
Help Desk: 713-839-2200
Fax: 713-839-2168
Email: support@lgc.com
3DFS, 3D Drill View, 3D Drill View KM, 3DView, 3D Surveillance, Active Field Surveillance, Active Reservoir
Surveillance, ADC, Advanced Data Transfer, ARIES, Asset Development Center, AssetJournal, Asset
Performance, AssetView, Atomic Meshing, Automate, BLITZ, BLITZPAK, CasingSeat, COMPASS,
Contouring Assistant, Corporate Data Archiver, Corporate Data Store, DataManager, DataStar, DBPlot,
DecisionSuite, Decisionarium, DecisionSpace, DecisionSpace AssetPlanner, DecisionSpace AssetView,
DecisionSpace Atomic Meshing, DecisionSpace Decision Management Systems(DMS), DecisionSpace
Nexus, DecisionSpace PowerGrid, DecisionSpace PowerModel, DecisionSpace PrecisionTarget,
DecisionSpace Reservoir, DecisionSpace TracPlanner, DecisionSpace Well Seismic Fusion, DepthTeam,
DepthTeam Explorer, DepthTeam Express, DepthTeam Extreme, DepthTeam Interpreter, Desktop
Navigator, DESKTOP-PVT, DESKTOP-VIP, DEX, DIMS, Discovery, Discovery Asset, Drill-to-the-Earth
Model, Drillability Suite, Drilling Desktop, DrillModel, DrillVision, DSS, Dynamic Reservoir Management,
Dynamic Surveillance System, EarthCube, EDM, eLandmark, Engineers Data Model, The Engineer's
Desktop, Engineers Link, Executive Assistant, ezFault, ezSurface, ezTracker, FG+, FastTrack,
FieldWorks, FZAP!, GeoDataLoad, GeoGraphix (stylized), GeoGraphix Exploration System, GeoLink,
GeoProbe, GeoProbe GF DataServer, GES, GESXplorer, GMAplus, GRIDGENR, Handheld Field Operator,
I2 Enterprise, iDIMS, IsoMap, iWellFile, Landmark, Landmark & Design, Landmark Logo & Design,
Landmark Decision Center, Landscape, Lattix, LeaseMap, LMK Resources, LogEdit, LogM, LogPrep,
Magic Earth, MagicDesk, Make Great Decisions, MathPack, MIMIC, MIMIC+, MIRA, Model Builder,
MyLandmark, Nexus, Object MP, OpenBooks, Open Explorer, OpenJournal, OpenSGM, OpenVision,
OpenWells, OpenWire, OpenWorks, OpenWorks Well File, PAL, Parallel-VIP, PetroBank, PetroWorks,
PetroWorks ULTRA, PlotView, Point Gridding Plus, Pointing Dispatcher, PostStack, PostStack ESP,
PowerCalculator, PowerExplorer, PowerHub, Power Interpretation, PowerJournal, PowerModel,
PowerView, Presgraf, PRIZM, PROFILE, Project Administrator, ProMAGIC, ProMAGIC Connect,
ProMAGIC Server, ProMAX, ProMAX 2D, ProMAX 3D, ProMAX 3DPSDM, ProMAX MVA, ProMAX VSP,
pSTAx, Query Builder, Quick, Quick+, QUICKDIF, QUIKCDP, QUIKDIG, QUIKRAY, QUIKSHOT, QUIKVSP,
Quickwell, Quickwell+, RAVE, RayMap, RayMap+, RTOC, Real Time Asset Management Center, Real
Time Asset Management Centre, Real Time Knowledge Company, Real Time Operations Center, Real Time
Production Surveillance, Real Time Surveillance, Reference Data Manager, Reservoir Framework Builder,
RESev, ResMap, RightTime, RMS, SCAN, SeisCube, SeisMap, SeisModel, SeisSpace, SeisVision,
SeisWell, SeisWorks, SeisWorks PowerCalculator, SeisWorks PowerJournal, SeisWorks PowerSection,
SeisXchange, Sierra, Sierra (design), SigmaView, SimResults, SIVA, SIVA+, smartSECTION, Spatializer,
SpecDecomp, StrataAmp, StrataMap, StrataModel, StrataSim, StratWorks, StressCheck, STRUCT, Surf &
Connect, SynTool, SystemStart for Servers, SystemStart, SystemStart for Clients, SystemStart for Storage,
Tanks & Tubes, TDQ, Team Workspace, TERAS, Total Drilling Performance, TOW/cs, TOW/cs Revenue
Interface, TracPlanner, Trend Form Gridding, Turbo Synthetics, VESPA, VESPA+, VIP, VIP-COMP, VIPCORE, VIP-DUAL, VIP-ENCORE, VIP-EXECUTIVE, VIP-Local Grid Refinement, VIP-THERM, WavX, Web
Editor, Well Seismic Fusion, Wellbase, Wellbore Planner, Wellbore Planner Connect, WELLCAT,
WELLPLAN, WellXchange, WOW, Xsection, You're in Control. Experience the difference, ZAP!, and Z-MAP
Plus are trademarks, registered trademarks or service marks of Landmark Graphics Corporation.
2006 Landmark Graphics Corporation. All rights reserved.
Release Notes
Page 48 of 48
January 2006