DecisionSpace InstallationNotes
DecisionSpace InstallationNotes
Version 5000.0.1
Installation Guide
Contents
Introduction ................................................................................................................... 2
Troubleshooting .......................................................................................................... 46
Trademarks .................................................................................................................. 53
Introduction
This installation guide provides instructions for installing DecisionSpace® software
version 5000.0.1. It contains the following information:
• Hardware requirements
• Software requirements
• Post-installation procedures
• Troubleshooting
Refer to the DecisionSpace® Software Version 5000.0.1 Release Notes for New Function-
ality and Known Problems
The DecisionSpace® Software Version 5000.0.1 Release Notes contain a summary of the new
functionality in this release, as well as software fixes and known problems that impact all
DecisionSpace 5000.0.1 software. In addition, each of the DecisionSpace software has its own
set of Release Notes for issues that are specific to that software.
DecisionSpace Desktop
The Decision Desktop is a common user interface that allows you to access all software
in your workflow. The single interface provides a seamless viewing experience and unifies
common components and functionality across the DecisionSpace® software suite into
one tightly integrated DecisionSpace software environment.
The Desktop has replaced the Session Manager as the first visible user interface. Session
parameters are now configured in the Desktop, and once configured these parameters
remain in effect across sessions. You no longer need to configure session parameters for
each session unless required.
The Desktop provides a launcher that can be configured to start Landmark and other
vendors’ software right in the Desktop. The Launcher can also import existing Command
Menu configuration files of the OpenWorks software for quick configuration.
The DecisionSpace® software Desktop runs on Windows 32-bit, Windows 64-bit, and Red
Hat Enterprise Linux 64-bit systems.
If you do not have any DecisionSpace software installed on your system, you can use the
DecisionSpace Launcher software to start other Landmark and vendors’ software on a
Red Hat Enterprise Linux 64-bit system. It is a minimal deployment of the DecisionSpace
software that utilizes the software launching capability of the DecisionSpace software
Desktop.
You can utilize the DecisionSpace Launcher software as a common software launch point
rather than command line launch of software from a terminal window. The launcher can
also import existing Command Menu configuration files of the OpenWorks® software for
quick configuration.
• DecisionSpace software 5000.0.1 can run in either the OpenWorks® mode, where the
OpenWorks server and client are required, or in non-OpenWorks mode, where data
stores other than an OpenWorks database are accessed.
• DecisionSpace software 5000.0.1 for Windows has been tested with OpenWorks
version 5000.0.0.2 running the Oracle 10g server and client.
Note: You require Oracle 10.2.0.3.0 32-bit for the OpenWorks client, and Oracle
10.2.0.3.0 64-bit for DecisionSpace software installed on Windows 64-bit. For
instructions on installing Oracle 32 and 64-bit, refer to the OpenWorks® Software
Installation Procedures manual for Release 5000.0.0.2.
• Instructions for installing or upgrading the OpenWorks 5000.0.0.2 servers and clients
are provided in the OpenWorks® Software Installation Procedures manual for Release
5000.0.0.2.
• Instructions for installing Landmark Software Manager software are provided in the
LAM Installation Procedures manual for Release 5000.0.0. LSM allows you to
download all Landmark products.
The following DecisionSpace version 5000.0.1 software run on the Windows XP and
Linux operating systems:
• AssetView™ software
• PowerGrid™ software - only available on Windows 32-bit and Linux 64-bit systems.
• PowerView® software
• PowerCalculator® software
Related Documents
The following Installation Procedures and Release Notes can be accessed from the
DecisionSpace Help menu. The installation procedures provide detailed instructions on
how to install the OpenWorks® software and include the requirements for various
platforms. The release notes summarize new functionality in each software as well as
software fixes and known problems. The LAM Guide provides detailed instructions on how
to install and configure the Landmark license application manager on Windows and Linux
systems.
The following table lists the software requirements for the OpenWorks 5000.0.0.2 server
installation:
Software Version
Document Viewer Adobe Reader 7.0.8 or later (Adobe Acrobat Reader 5.x or Adobe Reader
6.x also displays PDF documents.)
For information on installing LAM 5000.0.0, refer to the LAM Guide for Release 5000.0.0.
Mobile Workstation
The “mobile workstation” is a Windows XP workstation that runs both the OpenWorks
server and the OpenWorks client on the same laptop. It allows you to run DecisionSpace
software while your laptop is disconnected from the network.
Laptops
DecisionSpace software version 5000.0.1 runs on the Dell Precision M90 with nVidia
Quadro FX 2500M graphics with Windows XP, Service Pack 2.
Standalone Configuration
• LAM Server
Software Version
Document Viewer Adobe Reader 7.0.8 or later (Adobe Acrobat Reader 5.x or Adobe Reader
6.x also displays PDF documents.)
System Requirements
DecisionSpace software has the following hardware and software requirements for
Windows operating systems.
Hardware Requirements
The following table lists the hardware requirements for Windows workstations running
DecisionSpace software version 5000.0.1. DecisionSpace software runs on the minimum
requirements listed. However, performance may not reach acceptable levels with large or
complex datasets.
Graphics Cards
Workstations
The following graphics cards were tested by the DecisionSpace® Quality Management
team for Windows XP, Service Pack 2. These cards can be expected to perform
adequately.
• Desktop Workstation - nVidia Quadro FX 4500 and nVidia Quadro FX 3450 (PCI
Express Bus). These cards were tested with version 162.62 of the nVidia driver for
Windows XP 32-bit systems.
It is recommended that DecisionSpace software that require high-end cards, such as the
AssetView™ software, run only on the graphic cards listed above.
Other DecisionSpace software may have different requirements for graphics cards. For
detailed information on the graphics cards supported and tested in other DecisionSpace
software, refer to the Release Notes for the individual software. If you run Collaborative
Well Planning or the 3D Drill View KM™ software with the AssetView™ software, refer to
the AssetView™ Software Release Notes. If you run Collaborative Well Planning with the
GeoProbe® software, refer to the GeoProbe® Software Release Notes.
DecisionSpace software does not currently support ATI cards on desktops or laptops.
Software Requirements
The following table lists the software requirements required to run client installations of the
DecisionSpace software version 5000.0.1 on Windows workstations.
Document Adobe Reader 7.x (Adobe Acrobat Reader 5.x or All Products
Viewer Adobe Reader 6.x also displays PDF documents.)
a. The OpenWorks client and its associated software are not required when running in non-Open-
Works mode.
Licensing
To run DecisionSpace® software, a workstation must have the relevant software features
in the license. For a list of features for your software, refer to the Release Notes for the
individual product.
To use all the features of the software that are part of Collaborative Well Planning, you
must have a license feature for each of its software and for the OpenWorks software.
Without an OpenWorks license feature, or while running in non-OpenWorks mode,
software that are part of Collaborative Well Planning are only able to manipulate data from
the Wellbore Planner™ (WBP files) and COMPASS™ software. To use the EDM Import
or EDM Export options, refer to the Installing Well Planning section of the Collaborative
Well Planning Release Notes 5000.0.0.1.
Installation on Windows
Pre-installation Step
Before you install the DecisionSpace software on Windows, install the OpenWorks®
5000.0.0.2 client. (See the OpenWorks® Software Installation Procedures manual for
Release 5000.0.0.2.)
Installing the DecisionSpace software on a system that does not yet have the
DecisionSpace software version 5000.0.1 installed includes installing the following
DecisionSpace software:
• AssetView™ software
• PowerGrid™ software
• PowerView® software
• PowerCalculator® software
1. Log into the client computer with a user account that belongs to the Administrators
group on the DecisionSpace machine.
3. Navigate to:
DriveLetter:\Windows\Disk1\InstData\VM\setup.exe
6. Select the Launch Release Notes and Launch Installation Guide checkboxes.
7. Click Next.
9. Click Next.
12. Specify where you want the DecisionSpace® software version 5000.0.1 to reside on
your machine.
Ensure that the install directory has at least 1 GB of free space if you want to install
the entire DecisionSpace suite (See page 5 for the list of DecisionSpace software).
You must also ensure that the default drive (usually C:) has at least 400 MB of free
space. The additional space on the default drive is necessary for temporary files
created during the installation.
You may want to uninstall the existing version of the DecisionSpace software to free up
disk space.
4. Click Next.
6. Click Next.
You do not need to reboot your system after the uninstall. If you have installed multiple
versions of the DecisionSpace software, uninstall them by navigating to the location
where you installed the DecisionSpace software and double-clicking
UninstallDecisionSpacexxx.xx.x.exe.
Remaining Files
An uninstall of the DecisionSpace software does not uninstall the session management
files that you may have saved when running a session. These files must be manually
deleted.
To upgrade a DecisionSpace software installation in the same location where you had
previously installed it, Landmark recommends that you first uninstall the previous
installation, and then install the current version as described in “Install the DecisionSpace
Software” on page 12.
Post-Installation Notes
This section is relevant only if you are upgrading to Release 5000.0.1 from earlier versions
of the DecisionSpace software.
When you use the DecisionSpace software, certain user interface settings (such as entity
color, entity thickness, font size, etc.) and session files are stored on your computer. If
created in earlier versions of the DecisionSpace software, these files may not work well
in Release 5000.0.1 and should be removed. The pertinent files are not removed when
you remove a previous DecisionSpace software installation with the Start > Add or
Remove Programs command.
Files that contain DecisionSpace user interface settings are by default located
at %USERPROFILE%\Landmark\DecisionSpace. Old session files are similarly located
at %USERPROFILE%\Landmark\DecisionSpace\sessions. To delete the old files,
remove these two folders. They will be recreated with up-to-date files when the
DecisionSpace® software version 5000.0.1 is used for the first time.
If you are running an older version of the DecisionSpace software and try to load a session
file created by the DecisionSpace software 5000.0.1, you may not receive an error
message, but you may see anomalies in the session itself.
The DecisionSpace workstation must be able to connect to a license.dat file that has
license keys for the various DecisionSpace software that you want to run. The license.dat
file must be hosted by a FLEXlm license server. Typically, the license server is installed
on the OpenWorks® server, although other configurations are possible.
1. Select Start > Control Panel > System. The System Properties dialog box displays.
2. In the Advanced tab, click the Environment Variables button to display the
Environment Variables dialog box.
3. Click the New button in the System Variables group box to display the New System
Variable dialog box.
5. Type a string in the Variable value text box. For example, your environment variable
can be as follows:
LM_LICENSE_FILE = \\Server\lam\license.dat
or
LM_LICENSE_FILE = <port>@<Server/IP>
If you prefer to install a license server on your local workstation, refer to the OpenWorks®
Software Installation Procedures manual for Release 5000.0.0.2.
1. Select Start > Control Panel > System. The System Properties dialog box displays.
2. In the Advanced tab, click the Environment Variables button to display the
Environment Variables dialog box.
3. Click the New button in the System Variables group box to display the New System
Variable dialog box.
5. Type a string in the Variable value text box. The string represents the license features
that the DecisionSpace software should ignore when launching. For example, your
environment variable can be as follows:
LGC_LICENSE_REJECT=LicenseFeatureName1
or
LGC_LICENSE_REJECT=LicenseFeatureName1;LicenseFeatureName2;LicenseFeatur
eName3
where Feature is the name of the license feature that the DecisionSpace software
should ignore when launching. The feature names must be separated by a semi-colon.
For example, the LGC_LICENSE_REJECT variable can be as follows:
LGC_LICENSE_REJECT=PRECISIONTARGET;TRACPLANNER;DRILLVIEW_KM
temp) directory on the system. You can change the settings of this file to prevent the
DecisionSpace® software from filling up the system's temporary storage.
As a default, the DecisionSpace software cache is set to 200 MB. However, you may want
to adjust the size of the DecisionSpace software cache depending on the following
factors:
• The size of the system's temporary storage. If the temporary storage becomes filled,
software on the system may not function properly or may not function at all. The size
of the DecisionSpace software cache must always be smaller than the available
temporary storage.
• The data displayed in the DecisionSpace software. Ideally, the cache should be large
enough to hold all the data you will be using at one time in the DecisionSpace software.
For example, a seismic horizon may need around 20 MB of storage, and if you need to
display 50 horizons at one time, ideally, the cache should be at least 1 GB. However, the
cache may need to be smaller depending on other factors. A smaller cache can adversely
affect performance when manipulating the data.
• tmpDir, the jvm argument, defines the location of the temporary files on the system. If
tmpDir is set to default, the default temporary directory (tmp or temp) on the
system is used.
When you run the DecisionSpace software, by default, all DecisionSpace software write
their output files to %USERPROFILE%\Landmark\DecisionSpace. Files are written to
folders that correspond to their content type. These folders store sessions, color maps,
runtime messages, error messages, annotation data, image files (jpg, bmp, etc.), and UI
defaults. The files in these folders can become numerous and can occupy significant disk
space.
LGC_DATA_HOME variable can be used to set a different location for the output files of
the DecisionSpace® software. Note that the pre-existing files will not be copied to the new
LGC_DATA_HOME location. This is not fatal but may cause some inconvenience.
To set the LGC_DATA_HOME variable, access the Environment Variables dialog box in
the System Properties dialog box (select Start > Control Panel > System > Advanced >
Environment Variables) and set the variable as follows:
LGC_DATA_HOME C:\DecisionSpace\output_data
ConsoleOutput0.log
ConsoleOutput1.log
ConsoleOutput2.log
ConsoleOutput3.log
ConsoleOutput4.log
ConsoleOutput5.log
ConsoleOutput6.log
output-00.err
output-01.err
A new log file is created each time you start a new session with the increment number
increasing by one each time. The number of log files of either type is limited to 10.
You can use the LGC_JAVA_XMX variable to allocate memory to the Java Virtual
Machine (JVM) when the default value of 1 GB is insufficient. You can verify whether the
default value of 1 GB is insufficient by looking at the .err log files for a Java out-of-memory
error. The LGC_JAVA_XMX variable specifies how much memory is reserved specifically
for the JVM as opposed to the memory available for non-Java code. Typical upper limits
for Java Xmx on 32-bit Windows systems would be around 1.7 GB or less.
Changing the LGC_JAVA_XMX variable value may affect the DecisionSpace® software
performance. For example, if your workflow involves large seismic volumes, increasing
the Xmx variable value may increase performance for seismic data but could decrease
performance for other DecisionSpace software. Consult your onsite representative or call
Landmark customer support to change these variable values. To change the Xmx variable
value, the value should be defined in the following form:
768m
where “m” stands for megabytes, “k” for kilobytes, and no letter stands for bytes. If the
LGC_JAVA_XMX value is set too high, you may get an OpenGL error message. If this
occurs, try setting a lower LGC_JAVA_XMX value until the message no longer appears.
The LGC_JAVA_XSS environmental variable is used to set the maximum size of the Java
Virtual Machine's stack. This variable is defaulted to 4 MB. Consult your onsite
representative or call Landmark customer support if you want to change this value.
When you run the DecisionSpace software in OpenWorks mode, and if you will be using
the Pointing Dispatcher (PD), you may need to set some environment variables.
When you run the DecisionSpace software in OpenWorks mode, you may sometimes use
multiple OpenWorks PD sessions with different instance numbers. To transfer data from
a DecisionSpace software via PD to a particular OpenWorks session, set an environment
variable called OW_INSTANCE_NUMBER that specifies the same instance number as
the OpenWorks PD session.
If all your installed DecisionSpace software are running on the same platform, do not set
the LGC_PD environment variable. If, however, your software are on different platforms,
you need to set the environment variable LGC_PD to the hostname where PD is running
followed by the number of the PD.
For example, you may have three separate machines, one that is your OpenWorks server,
one that has AssetView® software installed, and one that has the OpenWire® software
installed. Usually, the OpenWorks server is configured as the PD server. In this situation,
the other two machines must be configured as PD clients to the PD server.
PD is normally session dependent. Setting the environment variables on client and server
machines allows users who are working in the same OpenWorks® project to receive
notifications of database updates.
For your DecisionSpace software to receive any PD updates from the OpenWorks software, the
Project Status Tool in the OpenWorks project must be set to the same project as the one currently
being used in your DecisionSpace software.
To check the setting, select Programs > Landmark > OpenWorks > Project Administration >
Project Status. In the Project Status Tool window, if the Project text box is set to None
Selected or any project name other than the one currently being used in the DecisionSpace
software, click the List button next to the Project text box to display the Change Project dialog.
Select the project name currently selected in your DecisionSpace software from the Available
Projects list, and click OK. Relaunch the software to see the PD updates.
The PD server is usually the OpenWorks server. The PD server may be a Windows XP,
a Linux, or a Unix server.
For detailed information about PD, refer to the OpenWorks® Software Online Help.
Windows XP
To configure PD, you must know the host name where PD is running (for example,
wizard) and an open TCP port number (such as 20001).
LGC_PD HostName:TCP_PortNum
LGC_PD_SERVICE TCP_PortNum
If the OpenWorks software fails to read the PD environment variables when running PD,
manually set them in the Environment Variables dialog box. To display the Environment
Variables dialog box, select Start > Control Panel > System. Select the Advanced tab
in the System Properties dialog, and then click the Environment Variables button.
Use the following steps if the Unix server is using Static PD (that is,
PD_USE_SESSION_MGR is set to NO).
To configure PD, you must know the host name where PD is running (for example,
wizard) and an open TCP port number (such as 20001). Enter the following in a
terminal window on the server:
Use the following steps if the Unix server is using Dynamic PD (that is,
PD_USE_SESSION_MGR is set to YES).
To configure PD, you must know the host name where PD is running (for example,
wizard) and an open TCP port number (such as 20001). Enter the following in a
terminal window on the server:
To configure PD on the client, you must know the host name where the PD server is
running (for example, wizard) and the TCP port number (such as 20001) that the PD
server is using.
LGC_PD HostName:TCP_PortNum
2. Set the LGC_PD variable in the System Properties dialog box in the Environment
Variables dialog box as it was set in lgcenv.cf. To display the Environment Variables
dialog box, select Start > Control Panel > System, select the Advanced tab in the
System Properties dialog, and then click the Environment Variables button.
4. To receive PD updates from the OpenWorks database, the PD client must be set to
the same OpenWorks project that is currently being updated. Therefore, before
launching a DecisionSpace® software, ensure that you select the appropriate project
in the OpenWorks® Project Status Tool. To open the OpenWorks Project Status Tool,
select Programs > Landmark > OpenWorks > Project Administration > Project
Status.
Installation Information
• The DecisionSpace software installer does not support a long directory path. Do not
install to a directory path greater than 25 characters. It is recommended to install to a
directory path with less than 20 characters.
• The DecisionSpace software installer does not support spaces in the directory path.
The installation prevents you from installing to a directory with spaces.
• OWSYSSID can be set by default in the background and may not be detected by you
until error messages appear when loading data. To set OWSYSSID, select Programs
> Landmark OpenWorks > Project Administration > Project Status Tool.
Hardware Requirements
The table below lists the hardware requirements for Linux workstations running
DecisionSpace software 5000.0.1.
DecisionSpace software will run on the minimum requirements listed below. However,
performance may not reach acceptable levels with large or complex datasets.
Graphics Cards
The following graphics cards were tested by the DecisionSpace Quality Management
team for the Linux workstation. These cards can be expected to perform adequately.
It is recommended that DecisionSpace software that require high-end cards, such as the
AssetView™ or Well Seismic Fusion™, run only on the graphic cards listed above.
Other DecisionSpace software may have different requirements for graphics cards. For
detailed information on the graphics cards supported and tested in other DecisionSpace
software, refer to the Release Notes for the individual product. If you run WellPlanning or
the 3D Drill View KM™ software with the AssetView™ software, refer to the AssetView™
Software Release Notes. If you run WellPlanning with the GeoProbe® software, refer to
the GeoProbe® Software Release Notes.
Linux does not currently provide a mechanism for allocating memory with addresses that
fall within the first 4 GB of memory on a computer with Intel's EM64T processor. Some
implementations of the swiotlb kernel parameter set aside a very small amount of memory
for its memory pool (4 MB). Exhaustion of this pool might cause a kernel panic. Panic is
an unrecoverable error detected by the kernel.
To avoid memory problems or a panicked kernel, increase the size of the pool. To
increase the pool, use the following parameter in the kernel command line:
swiotlb=IntegerNumeric
nVidia suggests raising the size of the pool to 32 MB when using its driver. For example,
pass the following value to the kernel:
swiotlb=16384
With kernel 2.6.9, the default size of the pool was raised to 64 MB, and mechanisms for
handling situations when the pool becomes filled have improved.
Note: The information in this section is from the Readme file for the nVidia drivers. For
more information, see the Readme file included with the drivers.
Software Requirements
Document Viewer Adobe Reader 7.x (Adobe Acrobat Reader 5.x or All products
Adobe Reader 6.x also displays the PDF documents.)
a. The OpenWorks® client and its associated software are not required when running in non-
OpenWorks® mode.
For information on installing Oracle 10.2.0.3.0, OpenWorks Client 5000.0.0.2, and Adobe
Acrobat Reader, see the OpenWorks® Software Installation Procedures manual for
Release 5000.0.0.2.
For information on installing LAM 5000.0.0, refer to the LAM Guide for Release 5000.0.0.
Licensing
Each DecisionSpace software requires that one or more product-specific license keys be
listed in the Landmark license file. For a list of the available license keys, refer to the
Release Notes for the individual product.
To be able to use all the features of the software that are part of Collaborative Well
Planning, you must have a license feature for each of its software and for the OpenWorks
software. Without an OpenWorks® license feature, or while running in non-OpenWorks
mode, the software that are part of Collaborative Well Planning are only able to
manipulate data from the Wellbore Planner™ (WBP files) and COMPASS™ software. For
information on using EDM™, refer to the Collaborative Well Planning Release Notes
5000.0.0.1.
Installation on Linux
The following section provides procedures for installing the DecisionSpace® software
version 5000.0.1 on a Linux workstation.
Pre-installation Step
Before you install the DecisionSpace software on Linux, install the OpenWorks®
5000.0.0.2 client. (See the OpenWorks® Software Installation Procedures manual for
Release 5000.0.0.2.)
The following steps explain the installation of the DecisionSpace software on a Linux
system that does not yet have the DecisionSpace software version 5000.0.1 installed. The
installation on Linux currently includes the following DecisionSpace software:
• AssetView™ software
• PowerGrid™ software
• PowerView® software
• PowerCalculator® software
1. Log into the client machine with a Linux user account that has write permissions for
the area where you want to install the DecisionSpace software.
2. Navigate to your home directory or to some other directory where you have execute
write permissions.
or
mount /mnt/cdrom
/tmp/Disk1/InstData/Solaris/VM/setup.bin(for Solaris)
/mnt/tmp/Disk1/InstData/Solaris/VM/setup.bin(for Solaris)
Important: Do not execute the install command from within the mounted directory
system. If you do, the installation hangs when you are prompted to eject CD 1.
6. Select the Launch Release Notes and Launch Installation Guide checkboxes.
7. Click Next.
9. Click Next.
12. Specify where you want the DecisionSpace® software version 5000.0.1 to reside on
your machine.
Ensure that the install directory has at least 1 GB of free space if you want to install
the entire DecisionSpace software suite. See page 4 for the list of DecisionSpace
software.
Also, ensure that the default drive (usually the home directory for the user login) has
at least 400 MB of free space. This space on the default drive is necessary for
temporary files created during the installation.
To upgrade a DecisionSpace software installation in the same location where you had
previously installed it, we would recommend that you first uninstall the previous
installation, and then install the current version as described in “Install the DecisionSpace
Software” on page 27.
Post-Installation Notes
If you have installed DecisionSpace software with the OpenWorks software as an LGC
user, to configure the DecisionSpace software workstation to connect to a valid license
file, set the LM_LICENSE_FILE variable in .lgclogin (depending on the shell type being
used on Linux) as follows:
If you have installed DecisionSpace software without the OpenWorks software, you can
set the LM_LICENSE_FILE variable in your login profile files (depending on the shell type
being used on Linux).
To install the license server on your local workstation, see the OpenWorks® Software
Installation Procedures manual for Release 5000.0.0.2 for instructions.
or
where Feature is the name of the license feature that the DecisionSpace software
should ignore when launching. The feature names must be separated by a colon. For
example, the LGC_LICENSE_REJECT variable can be as follows:
As a default, the DecisionSpace software cache is set to 200 MB. However, you may want
to adjust the size of the DecisionSpace software cache depending on the following
factors:
• The size of the system's temporary storage. If the temporary storage becomes filled,
software on the system may not function properly or may not function at all. The size
of the DecisionSpace software cache must always be smaller than the available
temporary storage.
• The data displayed in DecisionSpace software. Ideally, the cache should be large
enough to hold all the data you will be using at one time in DecisionSpace software.
For example, a seismic horizon may need around 20 MB of storage, and if you need to
display 50 horizons at one time, ideally, the cache should be at least 1 GB. However, the
cache may need to be smaller depending on other factors. A smaller cache can adversely
affect performance when manipulating the data.
• tmpDir, the jvm argument, defines the location of the temporary files on the system.
If tmpDir is set to default, the default temporary directory (tmp or temp) on the
system is used.
When you run DecisionSpace software, by default, all DecisionSpace software write their
output files to %HOME\run. Files are written to folders that correspond to their content
type.
These folders store sessions, color maps, runtime messages, error messages, annotation
data, image files (jpg, bmp, etc.), and UI defaults. The files in these folders can become
numerous and can occupy significant disk space. If you are concerned about the use of
disk space in %HOME\run, we recommend that you set the LGC_DATA_HOME variable
to a folder on a disk with more available space. Note that pre-existing files will not be
copied to the new LGC_DATA_HOME location. This is not fatal but may cause some
inconvenience.
Set the LGC_DATA_HOME variable in your .lgclogin or .lgcprofile file, using a line like the
following:
LGC_DATA_HOME=/DecisionSpace/session_data .lgcprofile
export LGC_DATA_HOME
Red Hat Linux Workstation 3.0 ships with GNOME as its default desktop manager. If you
want to change your default desktop manager to KDE:
1. Select the “footprint” icon > System Settings > More System Settings > Desktop
Switching Tool.
2. Select KDE.
KDE
To place a DecisionSpace software launch icon on your desktop using the KDE window
manager:
3. In the Properties for Program window, replace the text “Link to Application” with a
name for the icon, (i.e., “Launch DS”)
9. Click OK.
The Properties for Program window now displays the Landmark icon.
12. Select Launch.sh in the directory where you installed the DecisionSpace software.
You can also select noOpenWorksLaunch.sh in the directory where you installed the
DecisionSpace® software if you have installed the AssetView™, Nexus™,
PowerView®, and WellPlanning - AssetView™ software.
The Landmark icon with “Launch DS” text displays. When you double-click the shortcut,
the DecisionSpace software launches.
You can drag the icon on the desktop and drop it on the launch panel bar at the bottom of
the screen to provide access to the DS launcher.
GNOME
To place a DecisionSpace software launch icon on your desktop using the GNOME
window manager:
3. Specify a name for the icon in the Name field, (i.e., “Launch DecisionSpace”).
4. In the Command field, click the Browse button. Navigate to the DecisionSpace
software installation directory and select Launch.sh.
You can also select noOpenWorksLaunch.sh in the directory where you installed
DecisionSpace software, if you have installed AssetView™, PowerView®, and
WellPlanning - AssetView™ software.
6. Click the Icon button. Navigate to the DecisionSpace software installation directory
and select “Landmark.ico.”
7. Click OK.
You should now see an icon with the LGC logo and the text “Launch DecisionSpace.”
When you double-click on the shortcut, the DecisionSpace software launches.
You can drag the icon on the desktop and drop it on the launch panel bar at the bottom of
the screen to provide access to the DS launcher.
The DecisionSpace software installer on Linux does not automatically detect an existing
DecisionSpace software installation and provide an uninstall option.To uninstall the
DecisionSpace software:
Note: If you installed the DecisionSpace software as a root user, you must uninstall it
as a root user.
Installation Information
• The best way to avoid trouble during a DecisionSpace software installation is to ensure
that all hardware and software requirements are met before you begin running
DecisionSpace software. (See page 26 and page 24.) If your hardware is not up to
specification, DecisionSpace software might still run, but its performance may be
significantly diminished. If you do not meet the software requirements, some of the
DecisionSpace software components will not run at all.
• The DecisionSpace software installer does not support a long directory path. Do not
install to a directory path greater than 25 characters. We recommend installing to a
directory path with less than 20 characters.
• OWSYSSID can be set by default in the background and may not be detected by you
until error messages appear when loading data. To set OWSYSSID, select
Programs > Landmark > OpenWorks > Project Administration > Project Status.
• If the Linux DecisionSpace software installer aborts during an installation, it may try to
resume the installation process from wherever it failed during the initial installation
attempt. In this case, we recommend that you delete any target folders that were
created before beginning the installation process again.
• If you copy files from your Windows to your Linux system, you may encounter
problems if the files are not converted to UNIX format. For example, a copied but
unedited dir.dat file may cause errors in locating SeisWorks® data. DecisionSpace®
software is sensitive to DOS versus the UNIX/Linux format and will fail silently when
the format is incorrect. This silent failure can result in some data being visible in
DecisionSpace software while other data is not visible.
To resolve this problem, ensure that you have done one of the following for any dir.dat
file copied from your Windows to your Linux system:
• Edit with a UNIX-based editor, and add extra spaces to the nonsys entries in the
dir.dat file.
This should be a standard practice for any text-based configuration files you copy from
Windows to Linux systems.
1. Create a properties file, and save it in any location. For example, the name of your
properties file can be ds.properties.
For Windows
INSTALLER_UI=silent
USER_INSTALL_DIR=TargetDirectory
CHOSEN_INSTALL_FEATURE_LIST=FeatureList
SHORTCUT_DESKTOP=1
SHORTCUT_DESKTOP_NOOW=1
SHORTCUT_START_MENU=1
SHORTCUT_START_MENU_NOOW=1
For Linux
INSTALLER_UI=silent
USER_INSTALL_DIR=TargetDirectory
CHOSEN_INSTALL_FEATURE_LIST=FeatureList
SHORTCUT_DESKTOP=1
SHORTCUT_DESKTOP_NOOW=1
where
• TargetDirectory is the full path to the base folder where you want the software
installed
Note: On Windows, the TargetDirectory path must be defined using forward slashes
(/) to delineate the directories. For example:
USER_INSTALL_DIR=C:/Landmark/DecisionSpace5000.0.1
ApplicationName
or
ApplicationName1,ApplicationName2, ApplicationName3
If you are installing more than one software, each name must be separated by a
comma. Use the following names to specify the software you want to install:
AV AssetView™ software
PC PowerCalculator® software
PG PowerGrid™ software
PV PowerView® software
Windows
2. In the Run dialog, click the Browse button and navigate to the setup.exe file.
Double-click the file. It will be located at:
DriveLetter\Windows\Disk1\InstData\VM\setup.exe
3. To the path to the executable file in the Open field, append the following:
-f path_to_properties_file
where path_to_properties_file means the full path to the properties file you had saved
earlier.
As an example, a full installation execution string might look like the following:
DriveLetter/Landmark/DecisionSpace/setup.exe –f C:\temp\ds.properties
4. Select OK from the Run dialog to begin the installation in the silent mode.
Linux
1. Open a terminal session and navigate to the setup.bin file. It will be located at:
/Landmark/DecisionSpace/setup.bin
–f /temp/ds.properties
where path_to_properties_file means the full path to the properties file you have saved
earlier.
As an example, a full installation execution string might look like the following:
DriveLetter/Landmark/DecisionSpace/setup.exe –f C:/temp/ds.properties
Hardware Requirements
The table below lists the hardware requirements for Linux workstations running
DecisionSpace Launcher software 5000.0.1.
DecisionSpace Launcher software will run on the minimum requirements listed below.
However, performance may not reach acceptable levels with large or complex datasets.
Software Requirements
Document Viewer Adobe Reader 7.x (Adobe Acrobat Reader 5.x or All products
Adobe Reader 6.x also displays the PDF documents.)
For information on installing LAM 5000.0.0, refer to the LAM Guide for Release 5000.0.0.
1. Log into the client machine with a Linux user account that has write permissions for
the area where you want to install DecisionSpace software.
2. Navigate to your home directory or to some other directory where you have execute
write permissions.
or
mount /mnt/cdrom
/tmp/Disk1/InstData/Linux64/VM/setup.bin
or
Important: Do not execute the install command from within the mounted directory
system. If you do, the installation hangs when you are prompted to eject CD 1.
7. Click Next.
9. Click Next.
The DecisionSpace Launcher software installer on Linux does not automatically detect an
existing DecisionSpace software installation and provide an uninstall option.To uninstall
the DecisionSpace Launcher software:
Note: If you installed the DecisionSpace software as a root user, you must uninstall it
as a root user.
3. Click Next.
5. Click Next.
http://www.halliburton.com/customersupport/Licensemanagement
If you have any questions, call your Landmark Customer Services Representative, or see:
http://www.halliburton.com
You must have the hostid of the system where the license.dat file will reside to request a
license. To obtain the hostid, enter the following:
Upon receiving the license request, a Landmark representative generates and returns
your license. The license contains information such as:
• Product name
• Version
• Expiration date
• Number of copies
• Encrypted key
For example, a license for five copies of the Well Seismic Fusion™ software is similar to
the line below:
Once you receive your license, add your license.dat file to your system and restart the
license manager. After the license manager has been restarted, you are able to use your
newly installed software.
For more information on managing the LAM, refer to the LAM Guide for Release 5000.0.0.
Troubleshooting
Caution
Instructions below tell you how to edit the configuration file to increase the diagnostic level
of the DecisionSpace® software. This reconfiguration should be used for support purposes
only and should not be done unless instructed to do so by Landmark representatives. If
you do increase the diagnostic level, ensure that you change it back to the normal usage
before running DecisionSpace software, as running the software at the increased level
substantially reduces performance.
When a program is executed, any prints and diagnostics are sent to a log file,
ConsoleOutput<Increment>.log on Windows, and DecisionSpace5000.0-
<Increment> on Linux, where Increment is a number from 0 to 9. To avoid accumulating
too many files and taking up too much space, the number of files is limited to 10. A new
log file is created each time you start a new session with the increment number increasing
by one each time up to 9 and then repeating at 0 by overwriting the existing file.
or
%USERPROFILE%\Landmark\DecisionSpace\logs
$HOME/run
You can identify the most recent files in Windows Explorer by viewing the file details
(select View > Details), or by using the -tr options for the ls command in Linux.
You can increase the diagnostic level to get more messages to help Landmark support
and onsite consultants diagnose problems. To increase the diagnostic level when
instructed to do so:
C:\Landmark\DecisionSpace5000.0.1\modules\dsinfra\config\logging
.properties
Install_path/DecisionSpace5000.0.1/modules/dsinfra/config/
logging.properties
2. Find the Default Global Logging Level line. The line is similar to the following:
Change it to:
com.lgc.level= FINEST
REMEMBER: When you are not trying to diagnose a problem, do not leave this
diagnostic setting set to FINEST . This setting substantially decreases performance.
To return the diagnostic level to normal usage, re-edit the logging.properties file
to:
com.lgc.level=CONFIG
Access problems can be exacerbated in an environment where some SID aliases include
a domain name and others do not, or in an environment where SID aliases include domain
names, and Unix (or Linux) and Windows clients are accessing those databases. In this
last case, if the same tnsnames.ora is placed on each client, some clients may be able
to access some databases and some may not be able to access other databases.
The cause of these access problems are partially associated with not using the Landmark-
recommended format for SIDs and are associated with how the OpenWorks software
uses and stores those names.
The OpenWorks software in Windows uses aliases for SIDs differently from the
OpenWorks software in the Unix or Linux operating systems. As the OpenWorks software
for Windows reads tnsnames.ora, it strips the domain portion of an alias from each SID
listed in the file. The OpenWorks software in other operating systems does not strip the
domain name from the SID alias.
This environment variable is not included in some initialization files for a user on a system.
It is included in a file in the installation of the OpenWorks software in Windows. The file is
lgcenv.cf. It has no effect in the OpenWorks software on any operating system, except
Windows. This file is located in %OWHOME%/conf. The variable can have the following
settings:
If this variable is not set in lgcenv.cf, the OpenWorks software in Windows acts as if
the variable has been set to one.
The OpenWorks server stores the alias of the SID for the OpenWorks database in the
database itself. From a client perspective, the SID alias of an OpenWorks database is
stored in tnsnames.ora. For a client to access an OpenWorks database, the alias
stored in the OpenWorks database and tnsnames.ora must match.
The Oracle user can check the value of the SID alias by entering the following at an
SQL*Plus prompt:
For example, to check the SID alias, the Oracle user enters the following:
NODE_DB_NAME
----------------------------------------------------------------
SID_Name
SQL> exit
[oracle10g@name admin]$
Recommendations
• When naming OpenWorks SIDs on a local network, all the SID aliases should use the
same format. For example, a format could be:
or
• An alias composed of the database name and a domain name (for example,
DatabaseName.Company.com).
• If the name of a database changes, the database administrator must change the name
in tnsnames.ora on each client accessing the database and the name must match
the value of NODE_DB_NAME in the OW_SYS_PROJECT table.
• If the clients on Windows access databases with SID aliases that include a domain
name, the OW_TNS_STRIP variable must be entered in %OWHOME%/conf/
lgcenv.cf, and must be set to zero. For example:
OW_TNS_STRIP 0
• If the SIDs accessed from a particular client have aliases with more than one domain
name, comment out or delete a line similar to the following in sqlnet.ora :
names.default_domain = DomainName
To comment out the line, enter a pound sign ( # ) at the beginning of the line:
# names.default_domain = DomainName
To change the SID alias in an OpenWorks database, the Oracle user must enter the
following at an SQL*Plus prompt:
SQL> exit
[oracle10g@name admin]$
When Service Pack 2 is first installed in Windows XP, the Windows Firewall is on by
default. Some of its default settings conflict with the seamless running of DecisionSpace®
software, its help files, and other Landmark software.
Listed below are issues that have been encountered as of this writing:
• When starting DecisionSpace software for the first time, unblock Java.
• After the Windows FireWall is installed, the defaults for Internet Explorer (the default
viewer for help files in Windows) do not allow seamless browsing of help files.
Specifically, the execution or viewing of files stored in a local file system (files with an
file:///xxx URL) is blocked when initially accessed.
For seamless viewing of these files, change the browser's default behavior. Do as
follows in Internet Explorer:
1. Select Tools > Internet Options. The Internet Options dialog displays.
This procedure opens the browser to potential security threats. Landmark can
guarantee that viewing its help files poses no risk; however, this solution may not be
in accord with a company’s security requirements.
Without allowing general access to all active content files, currently no other general
solution allows trusted content files to run as this procedure does.
• OpenWorks scripts (such as NTOrauser.sh) may lose their association with a shell
in which to run the script. The scripts must be associated with Sh.EXE
through ...\nutcroot\mksnt\sh.PIF .
You can use the LGC_JAVA_XMX variable to allocate memory to the Java Virtual
Machine (JVM) when the default value of 5 GB on 64-bit Linux systems is insufficient. You
can verify whether the default values are insufficient by looking at the .err log files for a
Java out of memory error.
Consult your onsite representative or call Landmark support to change these variable
values.
DecisionSpace5000.0-0.err
DecisionSpace5000.0-1.err
DecisionSpace5000.0-2.err
DecisionSpace5000.0-3.err
DecisionSpace5000.0-4.err
DecisionSpace5000.0-5.err
DecisionSpace5000.0-6.err
DecisionSpace5000.0-7.err
DecisionSpace5000.0-8.err
DecisionSpace5000.0-9.err
output-00.err
output-01.err
The DecisionSpace5000.0-Number.err files contain various types of output messages that would
be printed to the console if it were open. The output-[increment].err file contains only JAVA output
messages. A new .err file is created each time you start a new session with the increment number
increasing by one each time. The number of error files of either type is limited to 10.
Trademarks
3D Drill View, 3D Drill View KM, 3DFS, 3D Surveillance, 3DView, Active Field Surveillance, Active Reservoir Surveillance,
ADC, Advanced Data Transfer, ARIES, ARIES DecisionSuite, AssetConnect, Asset Decision Solutions, Asset Development
Center, AssetDirector, Asset Journal, AssetLink, AssetLink Advisor, AssetLink Director, AssetLink Observer, AssetObserver,
AssetObserver Advisor, Asset Performance, AssetPlanner, AssetSolver, AssetSolver Online, AssetView, BLITZPAK, CasingLife,
CasingSeat, COMPASS, Corporate Data Archiver, Corporate Data Store, Data Analyzer, DataManager, DataStar, DBPlot,
Decision Management System, DecisionSpace, DecisionsSpace 3D Drill View KM, DecisionSpace AssetLink, DecisionSpace
AssetPlanner, DecisionSpace AssetSolver, DecisionSpace AssetView 2D, DecisionSpace AssetView 3D, DecisionSpace Atomic
Meshing, DecisionSpace Decision Management Systems(DMS), DecisionSpace for Production, DecisionSpace Infrastructure,
DecisionSpace Nexus, DecisionSpace PowerModel, DecisionSpace PrecisionTarget, DecisionSpace Reservoir, DecisionSpace
TracPlanner, DecisionSpace Well Seismic Fusion, DecisionSpace WellSolver, DecisionSuite, DepthTeam, Depth Team,
DepthTeam Explorer, Depth Team Explorer, DepthTeam Express, Depth Team Express, DepthTeam Extreme, Depth Team
Extreme, DepthTeam Interpreter, Depth Team Interpreter, Desktop Navigator, DESKTOP-PVT, DESKTOP-VIP, DEX, DIMS,
Discovery, Discovery Asset, Discovery FrameBuilder, DMS, Drillability Suite, Drilling Desktop, DrillModel, Drill-to-the-Earth
Model, DSS, Dynamic Reservoir Management, Dynamic Surveillance System, EarthCube, EDM, EDT, eLandmark, Engineer’s
Data Model, Engineer's Desktop, Engineer’s Link, ESP, Event Similarity Prediction, ezFault, ezModel, ezSurface, ezTracker,
FastTrack, FG+, FieldPlan, Field Scenario Planner, FZAP!, GeoAtlas, GeoDataLoad, GeoGraphix, GeoGraphix Exploration
System, GeoLink, GeoProbe GF DataServer, GES, GES97, GESXplorer, GMAplus, GMI Imager, GRIDGENR, Handheld Field
Operator, HHFO, I2 Enterprise, iDIMS, IsoMap, iWellFile, i Wellfile, KnowledgeSource, Landmark, Landmark Decision Center,
Landmark & Design, Landmark Logo and Design, Landscape, Lattix, LeaseMap, LMK Resources, LogEdit, LogM, LogPrep,
Make Great Decisions, MathPack, MIMIC, MIMIC+, Model Builder, MyLandmark, Nexus, Object MP, OpenBooks,
OpenJournal, OpenSGM, OpenVision, OpenWells, OpenWire, OpenWorks, OpenWorks Development Kit, OpenWorks Well File,
OpenWorks Production, PAL, Parallel-VIP, PetroBank, PetroBank Explorer, PetroBank Master Data Store, PetroWorks,
PetroWorks Asset, PetroWorks Pro, PetroWorks ULTRA, PlotView, Point Gridding Plus, Pointing Dispatcher, PostStack,
PostStack ESP, PostStack Family, PowerCalculator, PowerExplorer, PowerExplorer Connect, PowerGrid, PowerHub, Power
Interpretation, PowerJournal, PowerModel, PowerView, PrecisionTarget, Presgraf, PRIZM, Production Asset Manager,
Production, PROFILE, Project Administrator, ProMAGIC, ProMAGIC Connect, ProMAGIC Server, ProMAX, ProMAX 2D,
ProMAX 3D, ProMAX 3DPSDM, ProMax 4D, ProMax Family, ProMAX MVA, ProMAX VSP, pSTAx, Query Builder, Quick,
Quick+, QUICKDIF, QuickWell, QuickWell+, QUIKRAY, QUIKSHOT, QUIKVSP, RAVE, RAYMAP, RAYMAP+, Real
Freedom, Real Time Asset Management Center, Real Time Decision Center, Real Time Operations Center, Real Time Production
Surveillance, Real Time Surveillance, Real-Time View, Reference Data Manager, Reservoir Framework Builder, RESev, ResMap,
RightTime, RTOC, SCAN, SeisCube, SeisMap, SeisModel, SeisSpace, SeisVision, SeisWell, SeisWorks, SeisWorks 2D,
SeisWorks 3D, SeisWorks PowerCalculator, SeisWorks PowerJournal, SeisWorks PowerSection, SeisWorks PowerView,
SeisXchange, Semblance Computation and Analysis, Sierra Family, SigmaView, SimConnect, SimConvert, SimDataStudio,
SimResults, SimResults+, SimResults+3D, SIVA+, SLAM, smartSECTION, Spatializer, SpecDecomp, StrataAmp, StrataMap,
StrataModel, StrataSim, StrataWorks, StratWorks, StratWorks 3D, StreamCalc, StressCheck, STRUCT, Structure Cube, Surf &
Connect, SynTool, SystemStart, SystemStart for Clients, SystemStart for Servers, System Start for Servers, SystemStart for
Storage, Tanks & Tubes, TDQ, Team Workspace, TERAS, The Engineer’s Desktop, Total Drilling Performance, TOW/cs, TOW/
cs Revenue Interface, TracPlanner, TracPlanner Xpress, Trend Form Gridding, Turbo Synthetics, VESPA, VESPA+, VIP, VIP-
COMP, VIP-CORE, VIPDataStudio, VIP-DUAL, VIP-ENCORE, VIP-EXECUTIVE, VIP-Local Grid Refinement, VIP-THERM,
WavX, Web Editor, Wellbase, Wellbore Planner, Wellbore Planner Connect, WELLCAT, Well Cost, WELLPLAN, Well Seismic
Fusion, WellSolver, 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.
All other trademarks, service marks and product or service names are the trademarks or names of their respective owners.
Landmark acknowledges that certain third party code has been bundled with, or embedded in, Landmark’s
software. The licensors of this third party code, and the terms and conditions of their respective licenses,
may be found at the following location:
<DecisionSpace>\help\com\lgc\dspx\Third_Party.pdf