Installation Guide
*Mark of Schlumberger
Schlumberger Private - Customer Use
Copyright © 1998–2013 Schlumberger. All rights reserved.
This work contains the confidential and proprietary trade secrets of
Schlumberger and may not be copied or stored in an information retrieval
system, transferred, used, distributed, translated or retransmitted in any
form or by any means, electronic or mechanical, in whole or in part, without
the express written permission of the copyright owner.
Trademarks & Service Marks
Schlumberger, the Schlumberger logotype, and other words or symbols used
to identify the products and services described herein are either
trademarks, trade names or service marks of Schlumberger and its
licensors, or are the property of their respective owners. These marks may
not be copied, imitated or used, in whole or in part, without the express
prior written permission of Schlumberger. In addition, covers, page
headers, custom graphics, icons, and other design elements may be service
marks, trademarks, and/or trade dress of Schlumberger, and may not be
copied, imitated, or used, in whole or in part, without the express prior
written permission of Schlumberger. Other company, product, and service
names are the properties of their respective owners.
2 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Petrel 2013 Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Studio Deployment Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Studio Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Studio Deployment Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
4 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Contents v
5 Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Plug-in Installation and Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Plug-in Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Plug-in Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Plug-in Manager Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Customizing the Plug-in Manager Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Deploying Plug-ins from a Network Shared Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Changing the Default [Plug-ins Home] Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-1
Contents vii
In This Section
About Schlumberger is the leading oilfield services provider, trusted to deliver superior
Schlumberger results and improved E&P performance for oil and gas companies around the world.
Through our well site operations and in our research and engineering facilities, we
develop products, services, and solutions that optimize customer performance in a
safe and environmentally sound manner.
Online Documentation is provided in the following electronic formats via the listed location:
Documentation
• Petrel* 2013 Installation Guide (Adobe® Acrobat® PDF file):
https://support.slb.com.
• Online help: Petrel > Help > Help Center
You can use Adobe® Reader to read the PDF file. Adobe Reader installation
programs for common operating systems are available as a free download from the
Adobe Web site at www.adobe.com.
Alert Statements The alerting statements are Notes, Cautions, and Warnings. These statements are
formatted in the following style:
• • • • • •
Note: Information that is incidental to the main text flow, or to an important
point or tip provided in addition to the previous statement or instruction.
• • • • • •
Caution: Advises of machine or data error that could occur should the user fail
to take or avoid a specified action.
• • • • • •
Warning: Requires immediate action by the user to prevent actual loss of data
or where an action is irreversible, or when physical damage to the
machine or devices is possible.
Contacting Schlumberger
Technical Support Schlumberger has sales and support offices around the world. For information on
contacting Schlumberger, please refer to the information below.
For Technical Support for SIS software:
• Schlumberger Support Portal: https://support.slb.com
• Customer Care Center e-mail: customercarecenter@slb.com
• Phone Support:
- SIS Support (main)
http://www.slb.com/contact_us/technology/sis/sis_support.aspx
- Click here for Europe, Russia, and Africa Support
- Click here for Middle East and Asia Pacific Support
- Click here for North and South America Support
In This Chapter
Overview 2-1
Introduction
This guide explains how to install Petrel E&P Software Platform 2013. The following
topics are discussed:
• Installing on a workstation using a local license
• Installing on a workstation using a license on a central license server
This guide also explains the procedures required after installation:
• Defining your license server environment
• Selecting your license package
Additionally, this guide includes detailed information on deploying Petrel 2013 on a
network shared disk. See “Deploying Petrel On a Network Shared Disk” on page 4-8.
Overview 2-3
Licensing
To run Petrel 2013, you need a valid license for this release. The license can be
configured either locally on your computer or on a central license server.
Petrel 2013 uses a combination of FlexeraTM FlexNet Publisher® licensing and a
WIBU® CodeMeter® dongle to provide a secure licensing solution.
• • • • • •
Note: This version of Petrel requires a Petrel 2013 license file. Licenses for this
release are backward compatible with all previous release versions.
• • • • • •
Note: For information about licensing, please see Schlumberger Licensing User
Guide located in the Documentation folder containing your Petrel
Installation files. For example,
C:\Temp\Petrel2013InstallFiles\Documentation.
Studio Overview The Studio E&P knowledge environment empowers a new level of usability and
productivity that supports an E&P organization’s quest to streamline and optimize its
workflow across the asset lifecycle, while also capturing vital knowledge to maximize
personal and team productivity. It features a powerful set of tools that allow
geoscientists and engineers to access, review, and use information, all of this in the
context of their workflows — providing three capabilities that increase productivity.
Find your information
Studio lets you easily search and find all available information across multiple data
sources in the context of your project and workflows. Using powerful search tools it
allows you to filter results based on specific criteria. These integrated workflows
provide greater awareness and access, thus the required data is always available at
your fingertips.
Collaborate with your team
Studio supports collaboration along multiple dimensions that let team members
publish interpretations and insights, sign up for notifications, utilize instant
messaging capabilities to easily connect and communicate with team members and
add virtual sticky notes to data. This provides greater context and understanding for
making better decisions.
Manage your knowledge
Studio provides a proven, scalable database — supported by industry standard
technology (Oracle® and Microsoft SQL Server®). Specifically designed to handle
E&P project data as well as the knowledge related to that data, all stored together in
context, users can obtain better retention and reuse of the generated knowledge.
Studio Deployment Deploying Studio in your environment enables data managers to define data
Overview environments comprising Petrel projects or databases across which users can
search, view, and filter to find data using Studio. The goal of this section is to help
you identify the best deployment option to enable rapid searching, viewing, filtering,
and loading information of interest. There are several deployment options:
• Search across local Petrel projects
This option enables users to search for, filter, and load data into their Petrel
environment from Petrel projects on their local machine. This capability is
Overview 2-5
available with every native Petrel 2013 installation. For more information, see the
Petrel online Help.
• Search across local Petrel projects and network data environments
This option enables users to search for, filter, and load data from Petrel projects
across the network for increased data awareness. This option requires
configuration of data environments using the Studio Manager. For more
information about setting up these data environments, see the relevant sections
in this installation guide, the Petrel Data Management training course materials,
and the Petrel online Help.
• Search across local Petrel projects, network data environments, and Studio
Databases
This option enables users to search for, filter, and load data in the Studio
Database for maximum scalability and data awareness. This option requires
deploying a Studio Database. A data manager configures the data environments
and Studio Database using the Studio Manager. For information on configuring
data environments and Studio Databases, see the relevant sections of this
installation guide and the Petrel online Help. For more information and assistance
with deploying a Studio Database, contact SIS Services.
In This Chapter
System Requirements
The following table lists the minimum, recommended, and preferred system
requirements for Petrel 2013.2. The preferred system contains the minimum
requirements to efficiently support Geophysics workflows.
Table 3-1 Petrel 2013.2 System Requirements
Preferred Hardware
Operating system Microsoft Windows 7 SP1 - (64-bit)
Enterprise or Ultimate editions
Processor Dual quad-core or hex-core processors (best
with a fast clock speed and high cache)
Memory 64 GB RAM
Display The quality of the viewing experience
increases with the size and number of
monitors
Graphics NVIDIA Quadro K5000
Primary storage Fast rotational speed HDD (10k, 15k) or
300 GB SSD
For better user experience, multiple high
speed disks is recommended.
Secondary storage Optional
• • • • • •
Note: Schlumberger constantly tests the latest hardware available from major
suppliers. In an attempt to minimize unexpected problems and costs,
Schlumberger often uses branded solutions such as those offered by HP,
Dell®, Lenovo®, Intel®, and NVIDIA.
Operating Systems Petrel 2013.2 only runs on 64-bit. Schlumberger Information Solutions has retired
support for the Windows XP operating system and 32-bit platforms starting with the
Petrel 2013.2 release.
Table 3-2 lists the supported operating systems for these versions.
Table 3-2 Petrel 2013.2 Supported Operating Systems
For general Petrel usage, you can use a processor that meets the minimum
recommendations. To achieve better performance, use the best available
configuration (see Table 3-1).
A number of modules in Petrel 2013.2 can effectively use multiple cores.
Table 3-3 Petrel Modules that effectively use multiple cores
Petrel Modeling Several modeling algorithms in Petrel 2013.2 take advantage of multiple core
Recommendations processing. Increasing the number of processors improves the run time of these
algorithms. This current trend of converting algorithms to run in parallel will
continue based on algorithm run time.
Memory (RAM) To run Petrel efficiently, Schlumberger recommends at least 16GB of RAM. The total
system memory must be greater than the memory used by the application. This
ensures that your operating system has dedicated RAM so that you do not have to
use your page file (disk memory).
To estimate the size of your system, use the following guidelines:
• Small data sets (~1 GB): 16 GB of internal memory
• Medium-sized data sets (~5 GB): 16 to 32 GB of memory
• Large data sets (large 3D seismic volumes, regional seismic models, or
big simulation [ECLIPSE] runs): with 64 to 192 GB of RAM
Graphics Cards Table 3-5 lists the recommended tested graphics cards for Petrel 2013.2. Your
graphics card should meet the following requirements:
• Run pixel shader 2 or later
• Be OpenGL compatible
• Be CUDA enabled (for more information, see the CUDA GPUs page on the NVIDIA
site, at http://www.nvidia.com/object/cuda_gpus.html)
For a better visualization experience, use a high-end graphics card and a good
monitor (such as a 27 or 30-inch LCD monitor).
There are two graphics memory settings in Petrel:
• Under system settings, the graphics card memory
• The "render cache size"
The GPU memory used for Geobody interpretation is shared with the Seismic texture
cache. This can be set in the System Settings of Petrel. It’s recommended that you
set the increase the Seismic texture cache size working with Geobody workflows.
The value entered will automatically be truncated to 75% of the total GPU memory
available. The amount of memory (both physical memory and GPU memory) used by
Petrel can be monitored on the status bar in the lower right of the application frame.
As a rule, these two settings should never be larger than the available memory of
the installed graphics card.
The total allocated graphics memory for Petrel should not be 100% of the available
memory on the card. This allows graphics memory to be available for the OS and
other programs that may need it.
Depending on the workflow, there will be a variation on whether more memory
should be allocated to the geobodies process (when working with geobodies) or to
the system graphics settings (when performing volume visualization).
For geobody specific workflows (probe creation and manipulation), the memory
allocated to the geobodies process can be up to 80% of the available memory. See
Table 3-4. Note that there are only 100 MB for the Q5000, and 200 MB for the
Q6000 available as spare memory for OS functions and other programs (these
values will most likely differ from user to user). However, in this scenario, we are
assuming that no other programs are open that will require graphics memory. If
other programs are open that require graphics memory, these numbers will need to
be adjusted.
If volume rendering is also being done in conjunction with geobody probes (option
on the Volume visualization tab (only becomes active in a 3D window)), then you
would probably need to reduce this to ~70%, and allocate more to the graphics
memory setting under system settings.
If the average workflow will revolve around the creation of probes based on a 32GB
seismic volumes, then the Q6000 is the way to go, as it will also have the longest
lifespan for a user, rather than having to upgrade the graphics card again.
Table 3-4 Graphics Card Memory Specifications
Choosing the right graphics card optimizes Petrel visualization performance. Low-
end and high-end graphics cards perform substantially differently when using large
3D grids or when performing seismic volume rendering.
NVIDIA Tested The latest recommended and tested official driver from NVIDIA is 311.35 for both
Graphics Cards Workstations and Mobile Workstations. Schlumberger recommends upgrading to the
latest official drivers from your PC vendor's home page or directly from NVIDIA.
Testing has revealed that there are many critical fixes important to Petrel in NVIDIA
driver 296.88 and newer. Accordingly, 296.88 is our minimum required driver for
NVIDIA graphics cards.
• • • • • •
Note: NVIDIA SLI™ technology currently does not add any benefit to Petrel.
However, it might be helpful with large high-resolution monitors such as
30-inch LCD monitors.
6-DOF Devices The 3D window in Petrel 2013.2 supports a range of 6-degree-of-freedom (6-DOF)
devices from 3Dconnexion (www.3dconnexion.com), a Logitech® subsidiary. These
devices have six optical sensors, so you can simultaneously pan, zoom, and rotate
3D models or scenes in the 3D window. You can do this while using the mouse. The
devices are Plug and Play and are very intuitive. Their ergonomic design can help
prevent repetitive strain injuries by reducing the amount of traditional mouse usage.
• • • • • •
Note: Schlumberger constantly tests the latest hardware available from major
suppliers. To minimize unexpected problems and costs, contact your
Schlumberger sales representative.
• • • • • •
Note: Most hardware vendors will have highly customizable options available for
each model of their workstations, it is advisable not referring to just the
model number when making the decision of hardware. It is advisable to
check detail of workstation system hardware configuration aligning with
Petrel system requirements. For example, A HP Z820 can have internal
components (CPU, Hard disk, GPU) that has lower specifications than
Z620.
• • • • • •
Note: Although the listed hardware has been tested, Schlumberger cannot
certify it. Problems outside of Schlumberger control (such as driver
and BIOS bugs, and operating system limitations) may affect the
user experience.
• As much memory as your hardware and operating system permits, and at least 32
GB RAM
Schlumberger recommends that the sum of the graphics card memory setting plus
the geobody render cache should not exceed the total available graphics memory.
For better performance, use multiple of Serial Attached SCSI (SAS) 15K RPM or solid
state disk drives. Consider the following:
• Storage capacity (for example, 500 GB)
• Rotational speed (for example, 15K RPM)
Faster rotation speeds generally deliver faster performance.
• Interface (SATA or SAS)
SAS drives offer higher performance, especially with multiple disk configurations.
They also generally have a higher mean time between failure. SAS is a high-
performance point-to-point architecture in which all devices connect directly to
the storage controller.
Table 3-9 lists setup scenarios for Petrel Geophysics.
Table 3-9 Petrel Geophysics Setup Scenarios
Seismic
Operating Graphics Seismic
RAM Texture
System Card RAM Cache
Cache
Seismic Interpretation
64-bit 32 to 96 GB 1.5 to 4 GB 768 MB to Up to 180
system 3 GB GB,
(Windows 7 depending depending
SP1) on graphics on RAM
RAM
Seismic and Geobody Interpretation
64-bit 32 to 192 4 to 6 GB 2 to 4 GB Up to 180
system GB GB,
(Windows 7 depending
SP1) on RAM
LiveQuest Solution
In a central computing environment, you can use LiveQuest for remote access and
access to its collaboration features in Petrel 2013 application servers. LiveQuest has
a user-friendly interface that you can access from any computer connected to your
enterprise network.
LiveQuest uses a high-end thin-client technology to allow secure remote access to
Petrel 2013. Petrel has been thoroughly tested within LiveQuest in a LAN
environment, and has been found to perform well, including the Petrel Geophysics
workflows. Due to the nature of thin-client technology, visualization quality and
performance may be affected by network bandwidth and latency. Further
information and advice on deploying LiveQuest is available from SIS Services.
There are two models for deployment of Petrel on a LiveQuest environment:
• Dedicated Server
• Shared Server
• • • • • •
Note: A Dedicated Server is the only one supported for running Geophysics
workflows on Petrel 2013 through LiveQuest. A Shared Server is not
supported for running Geophysics workflows on Petrel 2013, however it is
suitable for running non-3D graphics intensive workflows on Petrel 2013,
through LiveQuest.
Dedicated Server A Dedicated Server is a system in where all the resources are allocated for one (1)
user at a time on its remote session.
This Server type deployment is the only one supported for running Geophysics
workflows on Petrel 2013, because it delivers the outstanding performance required
by the users.
Minimum The minimum hardware and software requirements for a dedicated server for Petrel
Requirements 2013 includes the following:
Table 3-10 Petrel 2013 Dedicated Server Requirements
Preferred Hardware
Operating system Windows 7 SP1 64-bit
Enterprise or Ultimate editions
Processor Dual quad-core or hex-core processors (best
with a fast clock speed and high cache)
Memory 64 GB RAM
Network 1 Gbps Network Adapter or higher
Graphics NVIDIA Quadro K5000
Recommended Tested Schlumberger regularly tests hardware from different vendors. Table 3-11 list some
Hardware Solutions of the hardware used in the LiveQuest commercialization cycle. For detailed
information about the listed systems, please contact the Schlumberger Information
Solutions Services organization.
• • • • • •
Note: Schlumberger constantly tests the latest hardware available from major
suppliers. To minimize unexpected problems and costs, contact your
Schlumberger sales representative.
Systems
• HP Blade WS 460 Gen6 with the specs listed on Table 3-10 on page 3-12.
• • • • • •
Note: Although the listed hardware has been tested, Schlumberger cannot
certify it. Problems outside of Schlumberger control (such as driver and
BIOS bugs, and operating system limitations) may affect the user
experience.
Shared Server A Shared Server is a system in where all the resources are shared among multiple
users at a time on its remote sessions. This Server type deployment is not supported
for running Geophysics workflows on Petrel 2013 because it will not deliver the
outstanding performance required by users, however it is suitable for running non-
3D graphics intensive Petrel workflows.
When sizing a Shared Server for Petrel, the following two key requirements must be
taken into account:
• Number of remote concurrent users
• Data access requirements
• • • • • •
Note: A Shared Server for Petrel must be running on a physical machine and it
cannot be virtualized because Petrel is not supported on virtualized servers
at the moment.
Minimum The minimum hardware and software requirements for a Shared Server for Petrel
Requirements 2013 hosting up to two concurrent users including the following:
• 2 Intel hex-core processors
• 128 GB DDR3 SDRAM 1600 Mhz
• 1 NVIDIA Quadro K5000 or 6000
• 1 1 Gbps or higher network adapter
• Microsoft Windows Server 2008 R2 (64-bit)
• LiveQuest ThinAnywhere Windows RDP plug-in version 2012.2 or higher
• Microsoft Terminal Services/Remote Desktop Services configured in Remote
Applications mode
• • • • • •
Note: You also can use dual-port NICs on a teaming configuration for increased
network availability and performance.
Thin-Client A Thin-Client is a system that would be used by the users to remotely access the
applications provisioned through LiveQuest.
Minimum Requirements The minimum hardware and software requirements for a Thin-Client includes the
following:
• 1 Intel Core i5 or i7 (2nd Generation)
• 1 Gbps network adapter
• 6Gb of RAM
• Windows 7 / Red Hat Linux 5 up to 5.8
In This Chapter
Installation 4-1
• • • • • •
Note: If you are a new user of the Software Download Center, you must register
before you can download Petrel.
• You must have at least 1.5 GB of free disk space to install Petrel.
• • • • • •
Note: If you will be installing a future version of Petrel that includes plug-ins
such as Production or Drilling, you will need to refer to the plug-in release
notes for an installation overview and steps on verifying the installation.
Installing Petrel
2013
• • • • • •
Note: You must install Petrel on a local drive (a drive that is locally installed on
your system). Deployment of the data environment on a network shared
disk is not supported
Installation 4-3
• • • • • •
Note: If you are connecting to a license server and you have never run Petrel
2007, Petrel 2008, Petrel 2009.1, or Petrel 2009.1.1 on your workstation,
or if you are connecting to a new license server, you must define the
license server environment before starting Petrel 2013.2.
• • • • • •
Note: If you have already run a previous version of Petrel, and you are
connecting to the same license server, you can start Petrel 2013, as long
as the license server has a valid Petrel 2013 license.
• • • • • •
Note: This message only appears the first time you run Petrel. If it appears after
the first time you open Petrel, there is a problem in connecting to the
license server or finding the CodeMeter dongle.
• • • • • •
Warning: If you click Yes, both license server environment variables will be
overwritten. If other applications are using these variables and you
overwrite them, then you may not be able to run the applications.
Only click Yes if you are sure that you want to overwrite the variables.
If you are unsure, contact your system administrator or
Schlumberger Support.
3 Click Yes.
The Define license server environment window opens.
4 Enter the following information:
a. On the License server environment variable field, select the address of
your local computer or of the central license server where your license
is stored.
The address must be in the following format:
port@servername
Where:
port is the port number where the license service is running (typically
27000). You can omit the port number if it is in the default range of 27000 to
27009 and if your workstation is on the same local network as the
license server.
servername is the host name or IP address of the system where the license
was installed and configured.
b. Select Use configuration file and then navigate to the location of your
Petrel configuration file.
c. Click OK.
• • • • • •
Note: For information about verifying a license server, combining multiple
licenses, or monitoring license usage, see Schlumberger Licensing User
Guide.
Installation 4-5
Petrel 2013 opens on your workstation. Every time you open Petrel, it will use
your Favorite license package automatically. As a result, Petrel will open faster
because you bypass the Select license package window. (If you need it in
the future, select Help > License packages).
If you have multiple Favorite packages, when you open Petrel the Favorites
window will open. This window shows a list of your Favorite license packages.
You select the Favorite license package you want to use.
You are ready to use Petrel.
• • • • • •
Note: For information about renaming the license packages or viewing a list of
Petrel users who use a license package, see Schlumberger Licensing User
Guide.
Installation 4-7
Overview This section explains how a system administrator can deploy Petrel 2013.2 on a
network shared disk.
Deploying Petrel 2013.2 on a network shared disk offers the following advantages:
• Easy and efficient deployment of Petrel
• Single configuration file for all Petrel users
• Transparent configuration and installation of updates for all Petrel users
Deploying Petrel on a network shared disk reduces the management burden of
system administrators since they only needs to install, configure, and maintain Petrel
on one location.
Also, the system administrator can configure a single Petrel configuration file to
standardize license packages and specific Petrel settings for all Petrel users. For
detailed information, see Appendix A, “Global Configuration File,” on page A-5.
Since the Petrel 2013.2 configuration and installation of updates are transparent to
Petrel users, they can simply launch Petrel and begin working immediately.
Deploying Petrel Before beginning this procedure, you must be familiar with installing Petrel and
2013.2 already have access to a functional Petrel license. Refer to the following procedures
for details:
• “Installing Petrel 2013” on page 4-3
• • • • • •
Note: A system administrator should perform this procedure. Petrel users cannot
launch Petrel 2013.2 directly from the network path where the distribution
resides. Petrel users must map the network shared folder on their local
workstation.
Installation 4-9
Migrating 2010.1 If you used Petrel Coordinate System Manager 2010.1 or 2011.1 to customize the
or 2011.1 Catalog enterprise or extension catalog, you can migrate these catalogs to the 2013.2
Files catalogs. If you stored the 2011.1 enterprise or extension catalog in the default
location
%APPDATA%\Schlumberger\Petrel\CRSCatalogConfiguration\2011.1,
the software migrates the catalogs for you. If you stored the 2011.1 catalogs in
another location, for example on a shared network drive, or if you want to migrate
2010.1 catalogs, you must manually enter the catalog locations in the
CoordinateCatalogConfiguration.xml file before you open Petrel
Coordinate System Manager 2013.2 or the Coordinate reference system selection
dialog box in Petrel 2013.x.
If you opened Petrel Coordinate System Manager or the Coordinate reference
system selection dialog box in Petrel before migrating your 2010.1 custom catalog
files or 2011.1 custom catalog files stored on a network shared drive, follow the
procedure “Re-Migrating 2010.1 Catalog Files” on page 4-11.
• • • • • •
Note: Petrel Coordinate System Manager installed with Petrel 2012.x uses
2011.1 catalog files.
<value>%APPDATA%\Schlumberger\Petrel\CRSCatalogConfigurati
on\2011.1\CoordinateCatalogEnterprise.ctl</value>
</Catalog>
b. To update the extension catalog file location, update the following value with
the catalog file location:
<Catalog name="CopyFromUserdefinedExtensionCatalog">
<value>%APPDATA%\Schlumberger\Petrel\CRSCatalogConfigurati
on\2011.1\CoordinateCatalogExtensions.ctl</value>
</Catalog>
3 Save and close the configuration file.
4 Migrate the catalogs by performing one of the following actions:
• Launch Petrel Coordinate System Manager 2013.2.
• Launch Petrel 2013.x and open the Coordinate reference system selection
dialog box.
a. Click Project > Project settings.
b. In the Coordinates and units tab, click Select.
Re-Migrating Your 2010.1 catalog files are not automatically migrated to 2013.2. You must
2010.1 Catalog manually migrate them by modifying the
Files CoordinateCatalogConfiguration.xml file (see “Migrating 2010.1 or 2011.1
Catalog Files” on page 4-10). However, if you opened Petrel Coordinate System
Manager or the Coordinate reference system selection dialog box in Petrel before
you migrated your 2010.1 catalog files, you can use this procedure to re-migrate
your 2010.1 catalog files to 2013.2.
• • • • • •
Note: You can also use this re-migration procedure if you opened Petrel
Coordinate System Manager or the Coordinate reference system selection
dialog box before you modified the CoordinateCatalogConfiguration.xml
file with the location of your 2011.1 catalog files stored on a network
shared drive.
Installation 4-11
b. To update the extension catalog file location, update the following value with
the location of your 2010.1 catalog file:
<Catalog name="CopyFromUserdefinedExtensionCatalog">
<value>%APPDATA%\Schlumberger\Petrel\CRSCatalogConfigura
tion\2011.1\CoordinateCatalogExtensions.ctl</value>
</Catalog>
4 Save and close the configuration file.
5 Migrate the catalogs by performing one of the following actions:
• Launch Petrel Coordinate System Manager 2013.2.
• Launch Petrel 2013.x and open the Coordinate reference system selection
dialog box.
a. Click Project > Project settings.
b. In the Coordinates and units tab, click Select.
Uninstalling Petrel
You can uninstall Petrel from the Control Panel.
Installation 4-13
In This Chapter
Plug-ins 5-1
Overview
With the Ocean Plug-in Manager, you can access, organize, and manage plug-ins
within Petrel. The plug-ins could come from a variety of sources:
• Distributed from the Ocean Store (www.ocean.slb.com)
• Developed internally within your company
• Developed as third-party plug-ins
The Ocean Plug-in Manager uses a Petrel plug-in installer package (.pip), allows you
to package and distribute plug-ins. You will not need to run an installer application
to install or uninstall a plug-in.
From the Ocean Plug-in Manager, you can access plug-ins from two locations:
• Plug-ins published in the Ocean Store
• Plug-ins from internal sources in your organization that are in network
share folders
This chapter describes how the system administrator can customize the deployment
of plug-ins and customize the Ocean Plug-in Manager interface to enable or
disable features.
Plug-in Installation Ocean* for Petrel is a public open API on top of Petrel that allows the development
and Uninstallation of plug-ins to expand the capabilities of Petrel or to integrate it within existing petro-
technical platforms and workflows.
Each plug-in comes with its own installer and targets a specific version of Petrel.
When a plug-in is installed, it registers itself to let Petrel know that it exists and how
it can be uninstalled. Similarly, if the plug-in is uninstalled, it will un-register itself
from Petrel.
If you uninstall Petrel, Petrel will check for plug-ins, and prompt you to uninstall the
registered plug-ins. Uninstalling all plug-ins is recommended if you uninstall Petrel.
Plug-in Licenses When you order a Petrel plug-in from the Ocean Store, full instructions for installing
and activating the plug-in license are included in the email sent to you. You also can
find the information on the Ocean Store’s Help page.
Plug-in Manager
Plug-in Manager Ocean Plug-in Manager settings are stored in petrel.exe.config configuration file
Settings located in Petrel installation folder, for example:
C:\Program Files\Schlumberger\Petrel 2013\petrel.exe.config
• • • • • •
Note: Users should create a backup of this file before making changes to it.
Customizing the Follow these steps to customize the Plug-in Manager interface.
Plug-in Manager
Interface
Plug-ins 5-3
</
Slb.Ocean.Utilities.PetrelPluginManagerUiElements.Properti
es.Settings>
</applicationSettings>
5 Inside
<Slb.Ocean.Utilities.PetrelPluginManagerUiElements.Properties.Settings> tag
add the settings you would like to modify, following the format:
<setting name="SettingName" serializeAs="Type">
<value>Value</value>
</setting>
For example:
<setting name="StoreTabEnabled"
serializeAs="String">
<value>True</value>
</setting>
6 Following this format, you can change the following Plug-in Manager settings:
• StoreTabEnabled: Set as “True” if you want the Plug-in Manager’s Store
section enabled.
• SecurityTabEnabled: Set as “True” if you want the Plug-in Manager’s
Security section enabled and visible.
• CorporateTabEnabled: Set as “True” if you want the Plug-in Manager’s
Corporate section enabled and visible.
• InstallPluginButtonEnabled: Set as “True” if you want the Install Plug-
ins feature enabled in the Plug-in Manager. This feature is available only for
plug-ins packaged with a Petrel plug-in installer package (.pip file).
• UpdatePluginButtonEnabled: Set as “True” if you want the Update
Plug-in feature enabled from the Plug-in Manager.
• AddTrustedPublisherButtonEnabled: Set as “True” if you want the
Add Trusted Publisher feature enabled.
• RemoveTrustedPublisherButtonEnabled: Set as “True” if you want
the Remove Trusted Publisher feature enabled.
• ChangeSecurityLevelEnabled: Set as “True” if you want the Change
Security Level feature enabled.
7 Save the file.
• • • • • •
Note: The Ocean Plug-in Manager cannot browse plug-ins directly from the
network path where the plug-ins reside. Petrel users must map to the
network shared folder on their local workstation.
<Slb.Ocean.Utilities.PetrelPluginManagerUiElements.Propert
ies.Settings>
</
Slb.Ocean.Utilities.PetrelPluginManagerUiElements.Properti
es.Settings>
</applicationSettings>
Plug-ins 5-5
5 Inside
<Slb.Ocean.Utilities.PetrelPluginManagerUiElements.Propert
ies.Settings> tag, make sure that the following setting is present and set
to True:
<setting name="CorporateTabEnabled"
serializeAs="String">
<value>True</value>
</setting>
6 Inside
<Slb.Ocean.Utilities.PetrelPluginManagerUiElements.Propert
ies.Settings> tag, add the following section, if it is not yet there:
<setting name="LocalStoreDirectories" serializeAs="Xml">
<value>
<ArrayOfString xmlns:xsi="http://
www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/
XMLSchema"> />
</ArrayOfString>
</value>
</setting>
7 Inside <ArrayOfString> tag, add the folder locations where Ocean plug-ins
can be located.
You can add as many locations as you need. For example:
<string "H:\Corporate Plug-ins" </string>
<string "D:\My Developed Plug-ins"</string>
<string "I:\Asset Team Plug-ins"</string>
• • • • • •
Note: You can use this procedure to set a local folder (for example,
C:\my developed plug-ins) as the location of the plug-ins directory from
where you want to deploy the plug-ins.
• • • • • •
Note: More information about this setting is available in Microsoft knowledge
base article http://msdn.microsoft.com/en-us/library/
dd409252(VS.100).aspx
10 From a DOS shell, run the caspol command to configure the machine runtime
security policy. This command enables your system to trust the execution of
.exe and .dll files from a network shared folder.
a. Change to the following directory:
C:\Windows\Microsoft.NET\Framework \v2.0.50727
b. From this location, run caspol.exe as follows:
C:\Windows\Microsoft.NET\Framework\v2.0.50727>
caspol.exe -quiet -machine -addgroup 1 -url "file://
\\shared_disk\Global Petrel\Petrel 2013\*" FullTrust -
name "Petrel_fulltrust” -description
"Allow_exe_and_dll_to_run_with_full_.NET_trust"
You can copy the line above into a DOS shell, but make sure that you change
“file://\\....” to the location where you copied the Petrel distribution. This
location must be accessible at the time the caspol command is executed.
The caspol command updates your system security at the machine policy level.
The security policy updates are at:
• %WINDIR%\Microsoft.NET\Framework\version
directory\config\Security.config
• %WINDIR%\Microsoft.NET\Framework\version
directory\config\Security.config.cch
• • • • • •
Warning: Do not open these files if you are not familiar with them. Erroneous
changes to these files could make your system unstable.
11 Repeat step 10 for each network shared folder you want Ocean Plug-in
Manager to browse for plug-ins.
Plug-ins 5-7
• • • • • •
Note: The user must have read/write access to the new [Plug-in Home]
directory.
• • • • • •
Note: The [Plug-in Home] directory may be located on a network shared folder.
The system administrator must execute the caspol.exe command to
configure the machine runtime security policy (see see “Deploying Plug-ins
from a Network Shared Folder” on page 5-5 for more details).
• • • • • •
Warning: Plug-ins using installers for deployment may be deployed under
[Petrel Home]\extensions. Only plug-ins deployed or installed
from the Plug-in Manager are guaranteed to be deployed
automatically in the customized [Plug-in Home].
• • • • • •
Note: There is a known issue when installing plug-ins into a restricted folder
structure. For more information, see “Plug-in Issue and Solution” on page
A-8.
What is Ngen? Ngen is a Native image generator tool which improves performance of managed
applications. Ngen.exe creates native images, which are files containing compiled
processor-specific machine code, and installs them into the native image cache on
the local computer. The runtime can use native images from the cache instead of
using the just-in-time (JIT) compiler to compile the original assembly.
How does it work? Ngen compilation is on by default. After Petrel has been installed and the system is
idle Ngen starts to create native images and stores them in a hidden directory.
C:\Windows\assembly\NativeImages_v4.0.30319_64. The whole process is invisible
to the user and the system controls when to create the native images and when to
use them.
If you look you will find a lot of files in this directory. Some belong to Petrel
(identifiable through a SLB. Prefix) others belong to other applications. This is why
you should never delete this directory. The files are going to be removed when
Petrel is uninstalled.
Can I run Ngen Yes. In order to run Ngen manually open a Command prompt and cd to the Petrel
manually? installation directory. Usually that is: C:\Program Files\Schlumberger\Petrel 2013.
The run
ngenrun.bat install to install (this takes a couple of minutes)
ngenrun.bat uninstall to uninstall (also takes a couple of minutes)
While this tool has proven to significantly aid the start-up time of Petrel, each user
needs to evaluate their own case in conjunction with their IT staff, as there may be
certain scenarios where start-up optimization will need to be turned off.
Setting License You can customize a license package name on the Edit Package Licenses window
Package Names in in Petrel and distribute settings to other users with the global configuration file.
the License File When you do this, you must redistribute the settings every time a license
file changes.
A simpler process for setting company-wide license package names is to set the
names directly in the FlexNet license file. Then, the Petrel users set a flag to use the
package names in the license file.
• • • • • •
Note: You may need to enable viewing of hidden files in Folder Options.
<Configuration>
<SystemSettings>
<UsePackageNameInLicenseFile Value="True"/>
</SystemSettings>
</Configuration>
• • • • • •
Note: This file allows you to customize a series of settings. If you want to let
users customize some settings, these must be removed from the
configuration file if you are configuring it for multiple users.
• When you start Petrel for the first time, Petrel will pick up these package
names from the license. When this setting is enabled, all your packages will be
selected as Favorites automatically.
You will not be able to edit the Package names or Favorite settings after you
enable the names from the license file.
• The second time you launch Petrel 2013, a short list of Favorites will appear,
instead of the initial Select license package window. This will speed up the
startup process, allowing you to choose the license from the list.
If you only selected one license package as a Favorite when you edited the license
file, Petrel opens automatically.
• • • • • •
Note: To open the Select license package window again, select Help >
License packages.
Global To standardize system settings in Petrel 2013 for multiple users, you can implement
Configuration File a global configuration file. Petrel stores the user system settings in the
PetrelConfiguration.xml file. The first time you run Petrel 2013 and exit, the file
is created in the following folder:
%APPDATA%\Schlumberger\Petrel\2013
- For Windows 7, the application data and settings folder is:
C:\Users\<username>\AppData\Roaming\Schlumberger\ Petrel\2013
The PetrelConfiguration.xml file contains the following information:
• Settings configured on the Select license package window, such as package
name and favorite package
• Settings configured using Tools > System Settings in Petrel
• • • • • •
Note: If changes are made to these settings, the changes are stored in the
PetrelConfiguration.xml file each time a user exits Petrel.
For more information, see System Settings in the Petrel online Help.
• • • • • •
Note: This procedure is performed by the System or License Administrator.
1 Open Petrel.
2 Configure your license packages on the Select license package dialog box.
3 Configure your system settings in Petrel.
4 Close Petrel.
Your PetrelConfiguration.xml file is updated with the settings that you
selected, and it is ready to be distributed globally.
5 Copy the PetrelConfiguration.xml file to a shared disk drive that all users
can access, and set it to read only.
Remove the following lines from the global configuration file:
<UseGlobalSettingsFile Value="True"/>
<GlobalSettingsFile Value=""/>
6 To enable Petrel users to use the global configuration file, you need to set their
local configuration file to point to the global PetrelConfiguration.xml file.
Make a copy of the PetrelConfiguration.xml file created in Step 5, and
remove everything from the file except the following lines:
<?xml version="1.0" encoding="us-ascii" standalone="no" ?>
<Configuration>
<SystemSettings>
<UseGlobalSettingsFile Value="True"/>
Troubleshooting and Frequently Asked Questions A-5
<GlobalSettingsFile Value="E:\PetrelConfiguration.xml"/>
</SystemSettings>
</Configuration>
• • • • • •
Important: For the GlobalSettingsFile Value, replace
E:\PetrelConfiguration.xml with the path to the shared folder
where you place your global configuration file.
Failure Messages You may get the following error messages from the limited connection configuration
When Opening in the file server that is serving the Petrel network folder:
Petrel
• “The application failed to initialize properly.”
• “Required Petrel module failed.... Not enough server storage is available to
process this command.”
You must modify the server's IRPStackSize in the registry table. If the subkey is not
present, use Registry Editor to add it.
The IRPStackSize parameter specifies the number of stack locations in I/O request
packets (IRPs) that are used by a Windows Server 2003 and a Windows XP server.
You may have to increase this number for the following transports:
• Media access control (MAC) drivers
• File system drivers
Each stack uses 36 bytes of memory for each received buffer. This value is set in the
following registry subkey:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet \Services\LanmanServer\Parameters
The default value of the IRPStackSize parameter is 15. The range is from 11 (0xb in
hexadecimal) through 50 (0x32 in hexadecimal).
The Microsoft Support website has more information about this issue:
• • • • • •
Warning: This should be done by IT engineers or system administrators. Do not
make any changes to the registry unless you are familiar with the
Registry Editor. If you make a mistake, it may harm your computer.
0xc0150002 Error You may get an 0xc0150002 error if all necessary components are not installed.
Message When
Make sure the following components are installed on the workstation:
Opening Petrel
• Visual C ++ libraries
• Microsoft .NET Framework 4.0
• Microsoft.VC80.MFC (64-bit), if the workstation is 64-bit
“Access Denied” If you try to install a plug-in into a restricted location on your computer, the Plug-in
During Plug-in Manager displays an “Access Denied” message.
Installation
Plug-ins are usually deployed or installed in the following directory:
[Petrel Home]\extensions
For example:
c:\Programs Files\Schlumberger\Petrel\2013.2\extensions
The [Petrel Home]\extensions directory is the default [Plug-ins Home]
directory. If you receive an “Access Denied” message while installing a plug-in, the
access to [Petrel Home] and/or [Plug-ins Home] is most likely restricted.
To allow the Plug-in Manager to install plug-ins, change the default
[Plug-ins Home] directory as described “Changing the Default [Plug-ins Home]
Directory” on page 5-8.
System Settings
NVIDIA Optimus Turn this feature off as it causes Petrel to behave incorrectly.
To Disable Optimus
1 Reboot the system.
2 Access the BIOS settings.
3 Go to the video section.
4 Disable Optimus.
5 Reboot the system.
To read more about NVIDIA’s Optimus Technology, please follow this link
http://www.nvidia.com/object/optimus_technology.html.
Windows Aero Prior to 2013, running Petrel in Windows Aero mode created unwanted visual
artifacts for certain operations. This is now fixed, and it is recommended to run
Petrel in Windows Aero mode.
Hyper-threading Hyper-threading can be safely turned on now for the vast majority of your Petrel
workflows. If in doubt, please check with your local Schlumberger SIS Services
team.
Can I deploy the You can deploy the Petrel E&P Software Platform 2013 without using
Petrel E&P PetrelPlatformInstaller.exe as follows:
Software Platform
• First, ensure that you have all of the pre-requisites for the Petrel E&P Software
2013 without using
Platform 2013 installed:
PetrelPlatformInst
aller.exe? • .Net 4.5 (4.0 is also supported, however there is no startup optimization)
• Windows6.1-KB2533623-x64.msu
• vcredist_x86.exe
Troubleshooting and Frequently Asked Questions A-9
• vcredist_x64.exe
• vcredist__2008_ATL_x86.exe
• SQLSysClrTypes.msi
• Then, install the Petrel E&P Software Platform 2013:
• Petrel 2013 (64-bit).msi
• Next, ALL other supplied MSIs must be installed. For this version, they are:
• Petrel 2013 Help.msi
• Petrel 2013 Manuals.msi
• Petrel 2013 SeismicWellTie.msi
• Petrel 2013 RDR.msi
• Petrel 2013 INTERSECT Connector.msi
Deploying Petrel on When deploying Petrel on a network shared disk, you have to run the DocIndexer in
a network shared order to get a search index. If not, a page will be shown stating this when you
disk attempt to run a search.
Several Users If there are several users running Petrel on the same computer, they will have to run
Running Petrel the DocIndexer tool individually (if they log on as individual users).
Search Index The documentation search index will only be removed for the user who installed
Petrel.
If an user have manually created a search index (stored in the %AppData%
location), this index will not be removed.
Additionally, this index will not be updated if the "install user" upgrades Petrel for
example, Petrel 2013.2.
• • • • • •
Note: A large number of printers are supported. For a full list, go to
www.sdicgm.com.
Examples
In the following image, you can see that the width of the selected file exceeds the
width of the targeted media. Because the Panel check box is selected, the image
width value is orange. Orange indicates that the image requires paneling and that
Petrel will print multiple panels.
With the Panel check box cleared, the width value is red. In this case, Petrel prints
only what is fitted on the initial panel.
On the Page Scaling field, you can select Width and then unlock the image. When
you do this, Petrel automatically scales the image width to the maximum width of
the media, while maintaining depth scale. This gives depth accuracy while allowing
the full width of the image to be displayed.
You can also specify scale values, which alters length and width dimensions by the
same percentage. If you need a specific width or height, you can enter that value
and APS will alter the other axis appropriately.
You also can export to a .cgm or .pdf file on the Petrel printing window.
Single Sign On If you will use single sign-on, every Petrel end-user workstation must have the
following components installed:
• Oracle client 11.2.0.3
• Advanced Security Option (ASO)
Also, set the ORACLE_HOME variable on the Petrel client machine, or modify the
Petrel.exe.config file to use the Oracle client.
ASO Configuration Configuring the Advanced Security Option for Kerberos authentication against Active
Directory consists of three main procedures:
1. Configure the Active Directory service account.
2. Configure the Oracle database server.
3. Configure the Oracle client.
If your company’s geodesy group uses custom coordinate systems with codes
developed internally, you can prevent your users from making changes to the
standard authority coordinate reference systems, transforms, and
conflation policies.
• • • • • •
Important: If you did not deploy the Studio Database for Petrel and you
want to make these configuration changes, change the
configuration of the Coordinate System Manager. If you did deploy
the Studio Database, change the configuration of the Studio
Manager.
AllowAdminOutOfBoxCatalog=True AllowAdminOutOfBoxCatalog=False
Default flag for Coordinate System Default flag for the Studio Database for
Manager Petrel
Can delete any coordinate reference Cannot delete any coordinate reference
system, transform, or conflation policy system, transform, or conflation policy
(if Source=EPSG, Esri, SIS, Mentor, or
PE_9_3_1)
Can create any coordinate reference Only can create coordinate reference
system, transform, or conflation policy, systems, transforms, or conflation
using any authority or code if there is no policies with Petrel as the authority (that
conflict with existing ones in the catalog is, Source=Petrel) and with a code that
is within the designated ranges
Can add a coordinate reference system Cannot add a coordinate reference
or simple transform from the Esri system or simple transform from the Esri
catalog, using the code (for example, if catalog, using the code (because it
a person deletes one and later wants to cannot be deleted)
add it back)
How does it work? The recommended workflow is to make the conversion to the enhanced summary
file format part of the simulation submission job rather than via Petrel. For further
information please refer to Technical Details. General Considerations contains
information on performance and resource requirements.
Conversion-related When you load a Petrel project, be it legacy or not, Petrel will check whether
worksteps in Petrel conversion is needed. If so, the conversion process to the new file format is started
in the background without impeding Petrel itself. Names of individual cases being
converted appear in red font with the addition "(summary conversion being
active...)" as seen in the following figure:
• • • • • •
Note: You are advised not to access summary data for a case for the duration of
the conversion process in case the data is stored on a network location.
Although you can access the data, you will not benefit from increased
summary data performance until the end of the conversion.
If you decide not to use the enhanced summary file format for a particular case,
open its settings dialog by right clicking the case, selecting the Results import tab
and clearing the Use enhanced summary file format option, as shown in the
following figure:
If this option is grayed out, Petrel either has not found any summary data for this
case, or the option selection has been cleared on the Results import tab on the
case.
You will notice several messages in the message log explaining the process.
Technical Details
There are two ways the conversion into the enhanced summary file format can
be done.
1. As part for the simulation submission workflow
Upon successfully completing the simulation, the conversion to the enhanced
file format is triggered as a port-processing step before the results are loaded
back into Petrel. This is the recommended workflow (as it hides the conversion
time).
2. When importing the deck into Petrel or loading the results
Petrel will check whether conversion is needed. In this case, the conversion will
happen on the machine on which Petrel is installed. Although the conversion is
done without impeding Petrel, it is not recommended that you allow Petrel to
do the conversion as it can be expensive in terms of resources needed (time
and memory).
The Preferred The conversion from the simulator output for the summary results into the
Workflow for enhanced summary file format may take a considerable amount of time depending
Conversion on the size of the summary data, network speed, and the load on the machine Petrel
is running. Therefore, you are advised to make the conversion process part of the
simulation submission system. This section describes three different situations to
make the conversion part of the recommended post-simulation workflow.
1. ECLRun >= 2012 Let us first consider ECLRun 2012, the first version of ECLRun aware of this new file
format. If you submit a simulation run via ECLRun 2012, it will trigger the simulation
data conversion after successful completion of the simulation run. That means by
the time the results are read back into Petrel, the enhanced summary file has
already been created and hence Petrel will not do it. You will benefit from the
advantages of this new file format immediately.
You can control certain aspects of the conversion by editing the
PetrelConfiguration.xml file.
• • • • • •
Note: Before changing this file, please close all instances of Petrel; otherwise,
Petrel will revert your changes upon shutdown.
Open the file and find the section <SimulationCommands>. It should look like
this:
<SimulationCommands>
<Command Name="ECLIPSE 100">
<Submit>eclrun.exe [-v %VERSION%] [-s %SERVER%] [-q
%QUEUE%] [--username %USERID%] [--passwd %PASSWORD%]
[%OPTIONS%] eclipse %DATAFILE%</Submit>
<Fetch>eclrun.exe [--passwd %PASSWORD%] check
%DATAFILE%</Fetch>
Assume that you are using ECLRun 2012 and you have to support submissions from
both Petrel 2012 and Petrel 2013. By default, ECLRun will start the newest converter
it finds. It decides this based on the file system structure, for example \ecl\2012.1\,
\ecl\2012 etc. If you do not tell ECLRun explicitly to start the 2012 converter for
submission from Petrel 2013, the converted summary file will be rejected by Petrel
2013 and regenerated locally into the new file format, which can be time-
consuming. To avoid this, append the submission string of the 'Submit' xml tag with
[- - hdf-converter-version 2012.1] for all the simulators E100, E300 and Frontsim for
the 2012 PetrelConfiguration.xml file. For example:
eclrun.exe [-v %VERSION%] [-s %SERVER%] [-q %QUEUE%] [--
username %USERID%] [--passwd %PASSWORD%] [%OPTIONS%] [--hdf-
converter-version 2012.1] e300 %DATAFILE%
To suppress conversion into the new summary file format altogether, use [- -
summary-conversion=no], i.e.
eclrun.exe [-v %VERSION%] [-s %SERVER%] [-q %QUEUE%] [--
username %USERID%] [--passwd %PASSWORD%] [%OPTIONS%] [--
summary-conversion=no] e300 %DATAFILE%
The location of the xml file is system-dependent. For Windows 7 its default location
is C:\Users\UsernName\AppData\Roaming\Schlumberger\Petrel\Petrel-
version\.
2. Pre-2012 ECLRun In this case, ECLRun will be unaware of the enhanced summary file format. To
complete the conversion automatically at the end of the simulation run, use the
stand-alone converter utility. Contact Schlumberger support to obtain the version
you need. Once the converter is properly installed, ensure it is run after the end of a
successful simulation before the simulation results are read back into Petrel. See
“Stand-alone Enhanced Summary Converter Utility” on page D-5 for additional
details for using the converter.
• • • • • •
Note: If you have changed PetrelConfiguration.xml to include the hdf options
mentioned above, you should break simulation submissions from within
Petrel 2013 with older ECLRun versions in case you should decide to
downgrade.
3. Custom Remote For successful for summary conversion obtain the stand-alone converter from
Submission Systems Schlumberger support. Supported systems include Microsoft Windows and various
Linux versions. Contact your system administrator for setup instructions. See
“Stand-alone Enhanced Summary Converter Utility” on page D-5 for additional
details for using the converter.
Stand-alone The Windows version of the stand-alone converter will be installed with the Petrel
Enhanced Summary installation. The executable is named ConvertSummaryData2DataBase.exe and
Converter Utility is located in the same location as the Petrel application file petrel.exe.
• • • • • •
Note: Usually, the simulation run happens on a cluster. One way to make the
summary conversion part of the submission workflow is to install the
stand-alone converter on the same machine the simulation is being
executed. For this you will need to obtain either the Windows or Linux
version of the converter from Schlumberger support.
If the first argument is a directory, the converter will recursively look for (F)SMSPEC
files in that directory and convert the corresponding summary data into the new file
format. In the case of a specific (F)SMSPEC file, only its summary data will be
converted. The second argument could, for example be C:\TEMP for Windows and
/tmp for Linux. Examples for Windows include the following:
• ConvertSummaryData2DataBase.exe C:\Users\foo\foo.SMSPEC C:\TEMP
• ConvertSummaryData2DataBase.exe C:\Users\foo\foo
C:\Users\foo\AppData\Local\Temp
• ConvertSummaryData2DataBase.exe C:\Users\foo\foo %TEMP%
Enhanced Summary File Format D-5
If you see errors loading shared libraries when trying to run the Linux hdf converter,
you might have to add the path to the shared libraries installed with ECLRun to your
LD_LIBRARY_PATH environment variable. This could look like this when using shell
csh: $ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:/path/to/
shared/libraries. To make this persistent, you must add this command to the
shell config file, for example .cshrc for csh.
General Considerations
This page lists some general comments on behavior, resources and performance for
the enhanced summary file format.
Best practice • While in use by Petrel, the enhanced summary file (extension .h5) cannot be
guidelines modified/deleted outside of Petrel. This ensures that the data Petrel works with
and exposes to the user is in sync with the data on disk. If you still need to
remove or change it, you will have to remove the simulation results for the
particular case first from inside Petrel (right click on the simulation case, and
select Remove simulation results).
• Petrel will warn you upon project load if any of the enhanced summary files are
read-only. This might become an issue after a simulation run. In this case, when
the simulation results are pulled back, Petrel is unable to update the enhanced
summary file returned by the simulation submission. In order to not display wrong
summary results, Petrel will in this case fall back to the standard summary files
*.(F)SMSPEC and *.A/Sxxxx. A warning is written to the message log.
• If the option Convert summary data into enhanced summary file format,
(which appears after right clicking on a case), is greyed out, Petrel either has not
found any summary data for this case, or the option to use the enhanced
summary file format has been cleared on the Results import tab on the case.
• When summary data is loaded into Petrel, the old-style summary data is in sync
with the summary data must be the new enhanced summary file. To keep them in
sync, the converter writes the new keyword TIMESTMP (documented in the
Eclipse File Format Reference Manual) into the (F)SMSPEC file. Hence, for
conversion to work reliably, the (F)SMSPEC file must not be read-only.
Performance Performance can be an issue if you are working with large summary data sets. In
Consideration any case, the enhanced summary file should be generated as part of the simulation
run so it is available to Petrel by the time the results come back from the remote
submission. Performance considerations include the following:
• The bigger the summary data files, the longer the conversion will take.
• Make sure you have sufficient main memory> The more memory, the faster the
conversion will be. Roughly, make sure you have #physical RAM = 2*size of
summary files.
• If the project data is located on a network location, a fast network connection
pays off
• You should only request the summary data and report steps you really need. The
more data you request, the slower the conversion and import into Petrel.
• If a lot of physical memory is available (as described above), consider setting the
environment variable SLB_FAST_SUMMARY_READER on the machine that does
the enhanced file format conversion. Doing so can considerably speed up
conversion.
G N
Geobody interpretation setup scenario 3-10 network shared disk
Index 1-1
Schlumberger Private - Customer Use
deploying plug-ins on 5-5 S
No licenses found message 4-4
Seismic interpretation setup scenario 3-10
Select license package window 4-6
O single sign on
Ocean Plug-in Manager 5-2 client system requirements C-2
Ocean Store 5-2 single sign-on
operating system, system requirements for 3-2 configuring the client for C-2
Oracle C-2 Slb.P4E.Dbx.Config file C-4
SLBSLS_LICENSE_FILE 4-4
P Software Download Center 4-2
storage
password, remembering C-4
network storage recommendations 3-11
Petrel
system requirements 3-2
download 4-2
system requirements
system requirements 3-2
for Petrel 3-2
uninstalling 4-13
for Petrel with LiveQuest 3-12, 3-14
Petrel license
system setup scenarios 3-10
selecting package 4-6
PetrelConfiguration.xml 4-4
and the global configuration file A-5 U
plotting B-1 uninstalling
Plug-in Manager Petrel 4-13
customizing interface 5-3 plug-ins 5-2
plug-ins upgrading repositories C-2
activating licenses for 5-2
deploying from a network shared disk 5-5
installing 5-2
installing in different directory 5-8
Ocean Plug-in Manager 5-2
Petrel 5-2
purchasing 5-2
uninstalling 5-2
printing B-1
processor
recommendations 3-4
system requirements 3-2
R
recommendations
graphics cards 3-5
laptops and workstations 3-9
network storage 3-11
processors 3-4
system components for Geophysics module 3-10
registry
update server’s IRPStackSize A-6
Remember password feature C-4
remote access with LiveQuest 3-12
repository
backup and recovery C-2
upgrade C-2