Petrel 2020-6 Installation Guide
Petrel 2020-6 Installation Guide
Petrel 2020-6 Installation Guide
Schlumberger - Private
Copyright Notice
Security Notice
The software described herein is configured to operate with at least the minimum specifications set out by Schlumberger. You are advised that
such minimum specifications are merely recommendations and not intended to be limiting to configurations that may be used to operate the
software. Similarly, you are advised that the software should be operated in a secure environment whether such software is operated across a
network, on a single system and/or on a plurality of systems. It is up to you to configure and maintain your networks and/or system(s) in a secure
manner. If you have further questions as to recommendations regarding recommended specifications or security, please feel free to contact your
local Schlumberger representative.
Schlumberger - Private
TABLE OF CONTENTS
OVERVIEW
Distribution............................................................................................................................................................................................................. 3
REQUIREMENTS
System requirements............................................................................................................................................................................................4
Operating systems..........................................................................................................................................................................................4
Other required software................................................................................................................................................................................4
Licensing.................................................................................................................................................................................................................8
Support for 4K (and higher resolution) monitors............................................................................................................................................14
Ergonomics and alternative input devices......................................................................................................................................................15
Recommended tested hardware solutions.....................................................................................................................................................16
Petrel Geophysics recommendations..............................................................................................................................................................16
Network storage recommendation.................................................................................................................................................................. 17
Remote visualization support............................................................................................................................................................................ 17
INSTALLATION
Pre-requisites...................................................................................................................................................................................................... 18
Download the installation package..................................................................................................................................................................18
Install Petrel......................................................................................................................................................................................................... 18
Run the installation executable from the command line.............................................................................................................................. 19
Deploy Petrel without using the installation executable..............................................................................................................................19
INTERSECT Connector....................................................................................................................................................................................... 19
Configuring the default INTERSECT Connector.......................................................................................................................................19
Default SLB plugins.............................................................................................................................................................................................20
Deploying Petrel on a network shared disk....................................................................................................................................................20
Petrel Coordinate System Manager.................................................................................................................................................................23
Uninstall Petrel.................................................................................................................................................................................................... 25
PLUG-INS
Installing and uninstalling plug-ins.................................................................................................................................................................. 26
Plug-in licenses................................................................................................................................................................................................... 26
Plug-in Manager..................................................................................................................................................................................................26
Deploy plug-ins from a network shared folder...............................................................................................................................................27
Change the default location of the [plug-ins home] directory.....................................................................................................................30
Plug-in troubleshooting......................................................................................................................................................................................30
Access denied during plug-in installation................................................................................................................................................30
Petrel Startup Optimization option................................................................................................................................................................... 31
i
Schlumberger - Private
TABLE OF CONTENTS
SUPPORT INFORMATION
ii
Schlumberger - Private
OVERVIEW
Overview
Schlumberger is the leading oilfield services provider, trusted to deliver superior 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.
Distribution
This Petrel release and documentation for this release and previous versions of Petrel are available from the Support
Portal. A user account is required on the portal. If you do not already have a user account, you can register to access the
portal at https://www.software.slb.com/support.
The Ocean* Store provides Petrel plug-ins at ocean.slb.com
3
Schlumberger - Private
INSTALLATION GUIDE 2020.6
Requirements
System requirements
Minimum Preferred
Processor Quad-core processor (best with a fast clock Dual 4 to 8 core processor (best with a fast
speed and high cache) clock speed and high cache)
Display The quality of the viewing experience increases with the size and number of monitors
Graphics desktop NVIDIA® Quadro® P4000 or NVIDIA Quadro NVIDIA Quadro P6000 or P5000
P2000
Graphics mobile NVIDIA Quadro P3000 or NVIDIA Quadro M2200 NVIDIA Quadro P5000 or P4000
Primary storage Fast rotational speed HDD (10K, 15K RPM) or PCIe based Flash or SSD
SSD
Secondary storage Optional SSD or Fast rotational speed HDD (10K, 15K)
• The Petrel interface is optimized for horizontal resolutions from 1280 and higher and for vertical resolutions from 1024
and higher.
• Support for VR (virtual reality) has been removed from Petrel 2017 onward.
• Windows 10 updates - Microsoft® supports semi-annual update channel (includes .NET®) - future Petrel versions will
be supported on the current channel update at the Petrel release date.
• Schlumberger continually 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®, AMD®, and NVIDIA.
Operating systems
Microsoft Windows 10 Professional or Enterprise Edition (64-bit)
Processors
Processor speed improves performance for these types of tasks:
• Large calculation tasks, such as volume size, seismic attribute generation, property modeling, and upscaling.
• Adding information to the graphics card.
For general Petrel use, a processor that meets the minimum recommendations is sufficient. For better performance, use
the best available configuration.
Several modules can benefit from multi-core processors.
Geophysics
4
Schlumberger - Private
REQUIREMENTS
Gridding
System requirements 5
Schlumberger - Private
INSTALLATION GUIDE 2020.6
Memory (RAM)
To run Petrel efficiently, Schlumberger requires at least 16 GB of RAM and recommends at least 32 GB (64 GB for
Geophysics workflows and Structural Modeling). 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 need use your page file (disk
memory).
To estimate the required system size, follow these guidelines:
• For small- to medium-sized data sets (<5 GB): 32 GB of memory.
• For large data sets (large 3D seismic volumes, regional seismic models, large structural models with many horizons, or
large simulation [ECLIPSE] runs): 64 to 192+ GB of RAM.
Graphics cards
Your graphics card must meet these requirements:
• Run Pixel Shader 2.0 or later.
• Be OpenGL compatible.
For a better visualization experience, use a high-end graphics card and a good monitor (such as a 27‒30-inch LCD monitor
or Ultra High Definition 4K monitors).
NOTE: NVIDIA Quadro RTX GPUs are also recommended and supported for use with Petrel.
Petrel is certified and supported on NVIDIA Quadro graphics cards only. Integrated graphics cards are not
recommended.
From Petrel 2017 onward, NVIDIA Quadro FX graphics cards are no longer supported.
6
Schlumberger - Private
REQUIREMENTS
Surfaces (cells) or points >1 mill P2000 or better Memory: 4 GB+ 16 GB+
M2200 or better GPU cores: 700+
NOTE: The option Workstation App - Dynamic Streaming in the NVIDIA Control Panel under 3D settings > Manage
3D settings is set by default through the application to ensure optimal performance for Petrel, when
visualizing data in the 2D or 3D windows.
System requirements 7
Schlumberger - Private
INSTALLATION GUIDE 2020.6
Hyperthreading
Hyperthreading is an option that does not improve Petrel performance. Whether the option is ON or OFF has no impact on
Petrel. If the option is turned ON for other reasons, be aware that this affects how Windows reports CPU utilization.
Licensing
® ® ®
Petrel uses a combination of FlexeraTM FlexNet Publisher licensing and a WIBU CodeMeter dongle to provide a
secure licensing solution. This requires a continuous connection to a USB-based CodeMeter dongle that serves licenses
through a remote- or local-license server. To use a local license, you must have the Schlumberger Licensing tool and
CodeMeter runtime installed. Both of these tools come with Petrel.
NOTE: The 2020.1 (recommended) or 2017 version of the Schlumberger Licensing tool is required. This version is
fully backward compatible with previous Petrel versions and does not require new license files. For more
information, please see the Schlumberger Licensing User Guide.
As a minimum, Petrel requires a core module license. Petrel supports the following core module licenses:
• Geoscience core
• Reservoir engineering core
• Combined core (combines Geoscience core and Reservoir engineering core)
• Shale core
• Geophysics core
• Data and results viewer core
• Ocean framework (enables Ocean development)
Each core module license enables a different set of Petrel features.
Core module licenses are offered in two types:
8
Schlumberger - Private
REQUIREMENTS
• License bundle
• Stack on start
(The Shale core is available as a license bundle only.)
Petrel supports either license type in a standalone mode or mixing license types from multiple or a single license server
provided through multiple or a single license file.
NOTE: When choosing your license type and license feature sets, consult your local D&I Account Manager or D&I
Services team for guidance on an optimal configuration.
For information about the Schlumberger Licensing Tool, refer to the Schlumberger Licensing User Guide,
located in the installation folder of the Petrel installation files (for example, C:\Program Files\Schlumberger
\Petrel 2020\Help).
Licensing terminology
License bundles A license bundle is a physical license. It must contain a Petrel core license and it may contain
(packages) optional Petrel module licenses. Checking out a bundled license feature checks out all the licenses
that the bundle contains.
In the Petrel E&P Software Platform - License selection dialog box, by default, license packages are
listed under Core licenses as Bundle + #.
Stack on start A stack on start (SOS) license consists of individual licenses for each Petrel module. SOS licenses
(SOS) can be part of the same license file or exist as separate license files.
In the Petrel E&P Software Platform - License selection dialog box, Petrel core module SOS licenses
are listed under Core licenses. All other Petrel modules are listed under Petrel modules. If multiple
servers are connected, licenses are summed.
Profiles A profile is a user-defined selection of licenses. This feature in Petrel allows you to check out a
preselected set of licenses at startup.
License feature A license feature, as used in FlexNet, is the actual licensed module or bundle of modules (in the case
of bundled Petrel licenses).
Module A module is a set of Petrel functionality that is usually tied to a license feature. Petrel modules are
listed in the Petrel modules section of the License UI. There are dependencies between Petrel
modules that are automatically honored during selection.
Expiry date Each license bundle has an expiry date that defines when the license expires. All features that are
part of the bundle expire on the same expiry date defined in the license file.
Each stack on start feature (increment) has an expiry date that defines when the feature license
expires. Stack on start increments may have different expiry dates.
Petrel shows an expiration warning before the license expires.
Maintenance The maintenance date defines when the current maintenance contract must be renewed to obtain
date access to new Petrel releases. The maintenance date consists of a month and year. After the
maintenance date passes, Petrel versions released after this date do not work until the maintenance
date is renewed.
Each license bundle and SOS license feature has a maintenance date.
Licensing 9
Schlumberger - Private
INSTALLATION GUIDE 2020.6
License selection
You can use the License selection dialog box to manage all aspects of license selection independently of the license type
or server. In addition, you can use the License selection dialog box to create and maintain user-defined license profiles to
match individual end-user profiles or workflows. For more details about using the License selection dialog box, refer to
the relevant section in the Petrel online Help.
Color-coded information, warning, and error messages are captured and displayed at the bottom of the License selection
tab. Multiple messages are stacked based on priority. For an overview of all messages, refer to the Message log pane in
the License selection tab.
License bundles
When you use licensing bundling, you must check out the entire package bundle. Bundles must contain a Petrel core
module. Individual modules cannot be selected or deselected from the bundle. Typically, you will have one or more
package bundles with one or more seats of each package bundle. Checking out a bundled license enables all the
functionality licensed by the modules that are part of the bundle.
For example, suppose you have purchased a single Petrel user license that consists of a Geoscience core, a Reservoir
engineering core, and a set of Petrel modules (for example, Seismic interpretation, Facies modeling, etc.). Once the
license file is generated by Schlumberger Information Solutions and installed at your site, when you log in to Petrel, the
License selection dialog box opens.
If additional Ocean licenses are available, they are listed under the Ocean modules section and can be selected or
deselected as needed.
Stack on start
When you start Petrel with a stack on start license file, you can choose the Petrel core and module licenses that you
want to use. Your selections become the stack of modules checked out and used during your Petrel session. The modules
remain checked out throughout the session until you log off.
In the License selection dialog box, the dependencies between Petrel core licenses and Petrel modules are explicitly
mapped. This ensures that you can select valid module combinations only.
If additional Ocean licenses are available, they are listed under the Ocean modules section. These licenses can be
selected or deselected as needed.
You can select and deselect stack on start licenses as needed during your Petrel session. The Petrel modules node also
provides a right-click Select All option for quickly selecting all listed module licenses.
10
Schlumberger - Private
REQUIREMENTS
NOTE: • A prerequisite for checking out additional licenses at Petrel runtime is that license modules must to be of
type Stack on Start (SOS). License modules that are part of bundle licenses are not available for runtime
checkout. The same applies to Ocean Plug-in licenses, which will be enabled with a later Petrel release.
• It is not possible to connect additional license servers while Petrel is running. Additional licenses can
only be added from the servers connected at startup.
To check out additional license at runtime, click File > License modules and click the boxes for further licenses in the
License status dialog box. Already selected licenses are marked and disabled (shown in gray text).
License profiles
The license profiles feature replaces previous functionality that provided names for packages. To create a profile, select
the combination of licenses that you need and save the selected combination as a profile with a name.
%appdata%\Schlumberger\Petrel\2020
Licensing 11
Schlumberger - Private
INSTALLATION GUIDE 2020.6
Insert the full path and filename to your global license profile file, i.e.
When using a global license profile the options to save, create, delete or favorite profiles are grayed out. Global license
profiles supersede any local Profiles.xml file.
To create a global license profile launch Petrel and save all license configurations using the options in the License UI.
This creates a file named Profiles.xml in %appdata%\Schlumberger\Petrel\2020
Use this file as your global license profiles file, copy it to the desired location and update the path for the setting in the
PetrelConfiguration.xml file.
NOTE: If the profiles are not available from the license server, the License UI shows a warning message in the
message log to let you know that the Profile could not be loaded because no licenses are available on the
current server.
Tooltips
You can view detailed information about the functionality provided by a Petrel module in the License selection dialog box
by hovering over the item.
This helps you to decide whether the module contains the features for the work to be executed and thus helps you to
make the right selections.
License module expiry dates can be visualized in the tooltip by enabling the Show expiry date in license description
option in the license settings tab of the license selection dialog box.
Customers are able to add custom description to the license module tooltip using a custom description xml file enabled
through a PetrelConfiguration.xml file. See the Petrel Help Center to learn how to enable this option.
12
Schlumberger - Private
REQUIREMENTS
NOTE: Upon starting Petrel the next time, licenses added at runtime are not preserved in the current selection of
profile.
NOTE: Detailed information about setting up license servers, quorum servers, and troubleshooting can be found in
the Schlumberger Licensing User Guide, located in the Documentation folder of the downloaded and
extracted installation files. For more advanced license server configurations involving virtual or quorum
setups, it is recommended to involve D&I services to help design a tailored system providing maximum
performance and minimum IT maintenance. Contact your local account manager for more information.
Licensing 13
Schlumberger - Private
INSTALLATION GUIDE 2020.6
• Always use a static port, for example, 27000@server.com, which optimizes the communication with the license
system.
• Set TCP_NODELAY. FLEX sends data between the client and server using TCP/IP packets. By default, the TCP/IP stack
buffers small packets (< 147 bytes in FLEX), known as Nagle´s algorithm, to coalesce a large number of packets before
sending them across the network. This ACK delay (200 ms) results in artificially high latency times for small packets
such as most FLEX licensing operations. For this reason, we recommend disabling the Nagle algorithm by defining the
TCP_NODELAY system setting as a license server environment variable to overcome this behavior, and reduce the
licensing wait period. For more information read the Flexera documentation.
• Use one license file only. Combining all licenses into one physical file improves communication with the license server
and by eliminating the need to open and close multiple files to read license information.
• Validate through the codemeter control center that the certified time is close to the current time. Navigate to
Codemeter control center > File > Webadmin > Content > CmContainer and if necessary, update the certified time.
NOTE: If you switch between wireless and cable-based connections while Petrel is running or after hibernation, a
reconnection with the license server may fail because of a network conflict.
Petrel disconnects from the license server or loses the license on a regular basis
Follow these steps:
1. Upgrade CodeMeter to the latest version.
2. Swap a new Petrel dongle.
3. Update Petrel dongle Certified Time.
4. Use a different USB port.
14
Schlumberger - Private
REQUIREMENTS
NOTE: To set 175%, click Set custom text size (DPI), make your selection and sign out/sign in.
Petrel has a few UIs that are still unable to handle high display scaling correctly. An alternative, if this is an issue, is to
reduce the resolution to 3K (2560 x 1440) in combination with 100% or 125% DPI. In that scenario, all UIs should work
correctly.
NOTE: In Windows 10, the Display settings dialog box has an option for dynamic display scaling. This is simply a
monitor magnifier, and everything on the screen will be scaled. The scaling approach is sub-optimal. Sign
out/Sign in is strongly recommended for the best display scaling quality and experience.
NOTE: 4K monitors have a significantly higher number of pixels which require sufficient graphics card support.
NOTE: In a multi-monitor setup, the best results are achieved where all the monitors have the same resolution
(different scaling has no detrimental effect, for example, a 4K laptop @250% + a 4K 32" monitor @150%).
<runtime>
<AppContextSwitchOverrides value="
Switch.System.Windows.Input.Stylus.DisableStylusAndTouchSupport=false"/>
…
</runtime>
NOTE: Schlumberger routinely tests the latest hardware available from major suppliers. To minimize unexpected
problems and costs, contact your Schlumberger sales representative.
Most hardware vendors offer highly customizable options of each workstation model. To ensure that your
workstation selection meets Petrel system requirements, note the individual workstation specifications
instead of relying on a model number. As a general rule, the hardware used should not be more than two
years older than the Petrel version running on it.
Tested laptops
Tested workstations
Additionally, smaller platforms (desktop and laptop) in the workstation ranges from the above manufacturers have shown
to perform well in light geoscience workflows or with smaller datasets.
NOTE: Although the hardware listed here has been tested, it is not certified for use by Schlumberger. Problems
beyond the control of Schlumberger (for example, driver bugs, BIOS bugs, operating system limitations) may
affect individual experiences.
Graphics cards
16
Schlumberger - Private
REQUIREMENTS
For better performance, use multiples of serial-attached SCSI (SAS) 15K RPM, SSDs or PCIe based flash. Consider:
• Storage capacity (for example, 500 GB)
• Rotational speed (for example, 15K RPM)
• Interface (SATA, SAS, PCIe)
Setup scenarios
Scenario Operating system RAM Graphics card Seismic texture Seismic cache
RAM cache
Installation
Pre-requisites
Petrel is a complete package installation. Installation requires:
• A workstation that is running a supported operative system.
• At least 5 GB of free disk space in the installation directory to install Petrel
• 3 GB on the C: drive for system files
• Administrator rights on the local system
You can install this version of Petrel on a system that already has previous versions of Petrel. However, if you want this
version of Petrel only, you must uninstall the older versions.
NOTE: If you plan to install a future version of Petrel that includes plug-ins such as Production or Drilling, refer to
the plug-in release notes for an installation overview and steps on verifying the installation.
NOTE: If you are a new user to the Software Download Center, you must register before you can download
products.
6. In the list of packages, locate the Petrel package that you want to download and click .
You can download a full version or you can download a specific upgrade, extension, or plug-in.
Install Petrel
1. Insert the DVD or navigate to the location where you downloaded the installation files.
2. In the DVD browser, from the root folder, run PetrelPlatformInstaller.exe.
The License Terms & Conditions panel appears.
3. On the License agreement panel, read the agreement, select I accept the terms in the license agreement, and then
click Next.
4. On the Prerequisite Check panel, inspect warnings or errors by hovering over the icon and then click Next.
For optimal performance, all checks should show a green check mark.
5. On the Destination Folder panel, accept the default folder, or click Change to select the folder where you want to
install Petrel, and then click Install.
NOTE: You must install Petrel on a local drive (a drive that is locally installed on your system), or refer to deploy
Petrel on a network shared disk.
18
Schlumberger - Private
INSTALLATION
Option Description
A log file is automatically created for each installation and stored in the user’s %TEMP% directory.
INTERSECT Connector
You do not need to choose the INTERSECT connector version during Petrel installation. Instead, multiple INTERSECT
connectors will be installed simultaneously and you can select the INTERSECT connector you want to use in Petrel by
accessing File > Options > Select INTERSECT Connector. Switching the connector only takes effect when Petrel is
restarted. Petrel stores the selection details in the following file: %APPDATA%\Schlumberger\Petrel
\2020\IntersectConnector.xml
<IntersectConnector>
<intersect>INTERSECT version</intersect>
<iscommercial>True/False</iscommercial>
<override>True/False</override>
</IntersectConnector>
For example, to define 2018.1 INTERSECT Connector as the default, you can specify the following:
<IntersectConnector>
<intersect>2018.1</intersect>
<iscommercial>True</iscommercial>
<override>False</override>
</IntersectConnector>
override =True/False: If set to False, the users will not be able to change the INTERSECT connector through
the Select INTERSECT Connector dialog box in Petrel.
iscommercial = True/False: Petrel will always attempt to load the latest commercial connector corresponding
to the specified INTERSECT version. The iscommercial setting controls the behavior when no matching commercial
connector is found, and a matching pre-commercial connector is available. If set to True, the pre-commercial connector
will not be loaded. If set to False, the pre-commercial connector will be loaded.
'PluginID' is the second attribute in any line returned by the list command - examples highlighted below:
All the plugins can be uninstalled from Control Panel under 'Uninstall a program'. All the plugins can also be uninstalled
using the command line format:
MSI packages for the default plugins are available in the Plugins folder of the Petrel distribution for those running
scripted installations (see also Knowledge Base Content ID 6969918).
20
Schlumberger - Private
INSTALLATION
Deploy Petrel
Before beginning this procedure, you must be familiar with installing Petrel and you must already have access to a
functional Petrel license.
NOTE: A system administrator must perform this procedure. Petrel users cannot launch Petrel directly from the
network path where the distribution resides. Petrel users must map the network shared folder on their local
workstation.
NOTE: When running Petrel from a network shared disk performance is affected depending on network latency.
Network shared installations cannot benefit from the Petrel startup optimization and caching, which has an
impact on the Petrel startup performance.
%windir%\Microsoft.NET\Framework64\v4.0.30319\caspol.exe -quiet
-machine -reset
%windir%\Microsoft.NET\Framework64\v4.0.30319\caspol.exe -quiet
-enterprise -reset
%windir%\Microsoft.NET\Framework64\v4.0.30319\caspol.exe -quiet
-machine -addgroup 1 -url "file://\\your.server.com\Global Petrel
\Petrel2020\*" FullTrust -name "Petrel_fulltrust"
-description "Allow exe and dll from directory on Network drive to run
with full .NET trust, necessary for calling native code."
%windir%\Microsoft.NET\Framework64\v4.0.30319\caspol.exe -quiet
-enterprise -addgroup 1 -url "file://\\your.server.com\Global Petrel
\Petrel2020\*" FullTrust -name "Petrel_fulltrust"
-description "Allow exe and dll from directory on Network drive to run
with full .NET trust, necessary for calling native code."
NOTE: If you change these settings, the changes are stored in the PetrelConfiguration.xml file each time you exit
Petrel.
For more information, refer to System settings in the Help Center.
<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.
22
Schlumberger - Private
INSTALLATION
Make a copy of the PetrelConfiguration.xml file created in Step 5 and remove everything from the file except these
lines:
NOTE: For the GlobalSettingsFile Value, replace E:\PetrelConfiguration.xml with the path to the shared folder where
you place your global configuration file.
Copy the new PetrelConfiguration.xml file to the %APPDATA% folder on all Petrel user machines. Typically, you copy the
new PetrelConfiguration.xml file to this default folder on Windows, which is C:\users\<username>\AppData\Roaming.
When Petrel starts, Petrel uses the settings defined in the global configuration file (PetrelConfiguration.xml). After
completion of the first Petrel run, a new PetrelConfiguration.xml file is created (if it does not exist) in the user data and
settings location. This file is identical to the global configuration file. It allows individual users to personalize their own
Petrel environment for an individual session without modifying anyone else’s settings. The settings in the global
configuration file overwrite the personalized settings when Petrel is restarted.
Users can also select the global configuration file in the Define license server environment window. Refer to Deploying
Petrel on a network shared disk for more information about selecting the global configuration file.
Lines can be deleted from the global configuration file, and only settings that correspond to the remaining lines in the
global configuration file can be controlled globally. The user can control settings that do not have corresponding lines in
the global configuration file.
NOTE: Settings in later steps override settings in earlier steps. For example, the settings in the company file will
override the same settings in the user configuration file.
If the default catalog has been customized or replaced, a migration must be performed in order to make the
customizations available in this version of Petrel.
For more information about the Petrel Coordinate System Manager, refer to the Petrel Coordinate System Manager Online
Help.
<Catalog name="CopyFromEnterpriseCatalog">
<value>%APPDATA%\Schlumberger\Petrel\CRSCatalog
Configuration\2015.1\CoordinateCatalogEnterprise.ctl
</value>
</Catalog>
b. To update the extension catalog file location, update this value with the catalog file location:
<Catalog name="CopyFromUserdefinedExtensionCatalog">
<value>%APPDATA%\Schlumberger\Petrel\CRSCatalogConfiguration
\2015.1\CoordinateCatalogExtensions.ctl</value>
</Catalog>
3. Save and close the configuration file.
4. Migrate the catalogs by performing one of these actions:
• Launch Petrel Coordinate System Manager.
• Launch Petrel and open an existing Petrel project or create a new one.
24
Schlumberger - Private
INSTALLATION
NOTE: You can also use this remigration 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 older catalog files stored on a network
shared drive.
1. Delete the default location for the Petrel catalog files that are used by Petrel Coordinate System Manager:
%APPDATA%\Schlumberger\Petrel\CRSCatalogConfiguration\2020
2. Navigate to the xml directory in your Petrel installation directory and open the CoordinateCatalogConfiguration.xml
file. For example, C:\Program Files\Schlumberger\Petrel 2020\xml.
3. Locate the section <!--Look-up path to previous catalogs --> and update the default enterprise
and extension catalog file locations.
a. To update the enterprise catalog file location, update this value with the location of your catalog file from an older
version, for example, 2013.1:
<Catalog name="CopyFromUserdefinedExtensionCatalog">
<value>%APPDATA%\Schlumberger\Petrel\CRSCatalog
Configuration\2013.1\CoordinateCatalogExtensions.ctl</value>
</Catalog>
4. Save and close the configuration file.
5. Migrate the catalogs by performing one of these actions:
• Launch Petrel Coordinate System Manager.
• Launch Petrel and open an existing Petrel project or create a new one.
Uninstall Petrel
NOTE: The installer detects installed Ocean plug-ins and uninstalls the plug-ins before uninstalling Petrel.
If Ocean plug-ins were installed on a shared network disk, you may need to uninstall each plug-in separately
before uninstalling Petrel, depending on how the plug-ins were initially installed.
1. From the Start menu, open the Control Panel, then click Uninstall a program.
2. In the list of currently installed programs, select the Petrel application, and then click Uninstall.
Uninstall Petrel 25
Schlumberger - Private
INSTALLATION GUIDE 2020.6
Plug-ins
The Ocean Plug-in Manager enables you to access, organize, and manage plug-ins within Petrel. Plug-ins can come from
a variety of sources. They may be:
• Distributed from the Ocean Store
• Developed internally within your company
• Developed as third-party plug-ins
The Ocean Plug-in Manager uses a Petrel plug-in installer package (.pip) for packaging and distributing plug-ins. You do
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 developed by your own organization and available on your network
The information in this chapter is for system administrators. This chapter tells you how to customize the deployment of
plug-ins and how to customize the Ocean Plug-in Manager interface to enable or disable features.
NOTE: Ocean Plug-in Manager does not validate compatibility for plug-in versions. Avoid installing plug-in versions
that do not correspond with the installed Petrel version. Non-corresponding versions might cause errors.
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 that is sent to you. You can also find this information on the Ocean Store’s Help page.
Plug-in Manager
The Petrel.exe.config configuration file contains the Ocean Plug-in Manager settings. You can find Petrel.exe.config in the
Petrel installation folder. For example:
26
Schlumberger - Private
PLUG-INS
3. Find the <configSections> tag and add this section, if it is not there:
This code enables configuration settings under a separate <application Settings> tag.
4. Inside the <configuration> tag, on the same level as the <configSections> tag, add this section if it is not
there:
<applicationSettings>
<Slb.Ocean.Petrel.PluginManagerUiElements.Properties.Settings>
</Slb.Ocean.Petrel.PluginManagerUiElements.Properties.Settings>
</applicationSettings>
5. Inside the <Slb.Ocean.Petrel.PluginManagerUiElements. Properties.Settings> tag, add the
settings you want to modify. Use this format:
For example:
A system administrator can use the Ocean Plug-in Manager to configure the internal source for plug-ins (for example,
network shared folders) to distribute and deploy plug-ins within Petrel. These plug-ins are available in the Corporate
section of the Ocean Plug-in Manager.
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.
<sectionGroup name="applicationSettings"
type="System.Configuration.ApplicationSettingsGroup, System,
Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
<section name="Slb.Ocean.Petrel.PluginManagerUiElements.
Properties.Settings" type="System.Configuration.ClientSettingsSection,
System, Version=4.0.0.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089" requirePermission="false"/>
</sectionGroup>
<applicationSettings>
<Slb.Ocean.Petrel.PluginManagerUiElements.Properties.Settings>
</Slb.Ocean.Petrel.PluginManagerUiElements.Properties.Settings>
</applicationSettings>
5. In the <Slb.Ocean.Petrel.PluginManagerUiElements. Properties.Settings> tag, make sure
that this setting is set to True:
28
Schlumberger - Private
PLUG-INS
7. Inside the <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>
<string>\\myServer\MyFolder</string>
NOTE: • Deploy your Ocean plug-in PIP files or assembly files into subfolders of the root folder configured in
Petrel.exe.config.
• Use PIP files for faster resolution of the plug-in list in the Corporate tab.
• Plug-ins that are already installed locally will not show up in the Corporate tab.
• 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.
NOTE: Refer to this Microsoft Knowledge Base article for more information about this setting.
C:\Windows\Microsoft.NET\Framework64\v4.0.30319
b. From this location, run caspol.exe:
You can run the caspol.exe command from a DOS shell, but make sure that you change \\myServer\MyFolder\* to
the location where your plugin assemblies are. This location must be accessible when you execute the caspol
command.
The caspol command updates your system security at the machine policy level. You can find the security policy
updates at:
• %WINDIR%\Microsoft.NET\Framework64\version directory\config
\Security.config
• %WINDIR%\Microsoft.NET\Framework64\version directory\config
\Security.config.cch
NOTE: Do not open these files you unless you are familiar with them. Incorrect changes to these files could
make your system unstable.
11. Repeat step 10 for each network shared folder that you want Ocean Plug-in Manager to browse for plug-ins.
NOTE: • You must have read/write access to the new [Plug-in Home] directory.
• 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
(refer to Deploy plug-ins from a network shared folder for more details).
NOTE: Plug-ins that use 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].
Plug-in troubleshooting
Access denied during plug-in installation
If you try to install a plug-in into a restricted location on your computer, the Plug-in Manager displays an Access Denied
message.
Plug-ins are usually deployed or installed in this directory:
[Petrel Home]\Extensions
For example:
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.
30
Schlumberger - Private
PLUG-INS
To allow the Plug-in Manager to install plug-ins, change the default [Plug-ins Home] directory as described in
Change the default location of the [plug-ins home] directory.
The simulator output for summary results in the form of *.(F)SMSPEC and *.A/Sxxx files reflects the way the simulator
solves the mathematical equations for increasing time. Accessing the data for a particular summary vector–usually for
plotting against time–requires the entire data set. This access pattern is poorly supported by the simulator output
mentioned previously, more so if the data is located on a network drive. In effect, accessing summary data often results in
high access times over network connections. This is the primary motivation behind the introduction of a new, enhanced
file format for storing summary data from Petrel 2017 onward. Requesting summary data in this new file format results in
greatly increased access speed over network connections.
The recommended workflow is to make the conversion to the enhanced summary file format part of the simulation
submission job rather than through Petrel.
NOTE: If the data is stored on a network location, do not access summary data for a case during the conversion.
Although you can access the data, you do 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. Then select the Results import tab and clear the Use enhanced summary file format check box.
Generally, Petrel ensures that the enhanced summary file format is being used and kept up-to-date. However, you have
the option to enforce conversion by right-clicking on a simulation case, case folder, or case collection and selecting
Convert summary data into enhanced summary file format on the popup menu.
If this option is disabled (displayed with gray text), Petrel either has not found any summary data for the case or the option
selection has been cleared in the Results import tab on the case.
The message log displays several messages that explain the process.
Technical details
Conversion into the enhanced summary file format can occur in one of two ways:
• As part for the simulation submission workflow: After 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 because it hides the conversion time.
• When importing the deck into Petrel or loading the results: Petrel checks whether conversion is needed. In this case,
the conversion takes place on the machine where Petrel is installed. Although the conversion is done without
impeding Petrel, it is not recommended that you allow Petrel to do the conversion because it can be expensive in
terms of resources needed (time and memory).
32
Schlumberger - Private
ENHANCED SUMMARY FILE FORMAT
NOTE: Before changing this file, close all instances of Petrel; otherwise, you will lose your changes when you close
Petrel.
Open the file and find the section <SimulationCommands> . It should look like this:
<SimulationCommands>
<Command Name="FrontSim">
<Submit>eclrun.exe [-v %VERSION%] [-s %SERVER%] [-q %QUEUE%] [--username
%USERID%] [--passwd %PASSWORD%] [%OPTIONS%] frontsim %DATAFILE%</Submit>
<Fetch>eclrun.exe [--passwd %PASSWORD%] check %DATAFILE%</Fetch>
<Kill>eclrun.exe [--passwd %PASSWORD%] kill %DATAFILE%</Kill>
</Command>
</SimulationCommands>
Technical details 33
Schlumberger - Private
INSTALLATION GUIDE 2020.6
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:
To suppress conversion into the new summary file format altogether, use [- - summary-conversion=no]. For
example:
The location of the xml file is system-dependent. For Windows 10, the default location is: C:\Users\UsernName
\AppData\Roaming\Schlumberger\Petrel\Petrel- version\
Pre-2012 ECLRun
In this case, ECLRun is 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 runs after the end of a successful simulation before the
simulation results are read back into Petrel. Refer to Standalone enhanced summary converter utility for additional details
for using the converter.
NOTE: If you have changed PetrelConfiguration.xml to include the hdf options, you should break simulation
submissions from within Petrel 2014 with older ECLRun versions in case you should decide to downgrade.
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 that runs the simulation.
For this, you must obtain either the Windows or Linux version of the converter from Schlumberger support.
34
Schlumberger - Private
ENHANCED SUMMARY FILE FORMAT
To make this persistent, you must add this command to the shell config file, for example .cshrc for csh.
General considerations
This page lists general comments about behavior, resources, and performance for the enhanced summary file format.
Performance considerations
Performance can be an issue if you are working with large summary data sets. In 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 remote
submission. Performance considerations include:
• The bigger the summary data files, the longer the conversion takes.
• Make sure you have sufficient main memory. Conversion is faster if more memory is available. Roughly, make sure
your #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 request only the summary data and report steps you really need. The more data you request, the slower
the conversion and import into Petrel.
• If a large amount of physical memory is available, consider setting the environment variable
SLB_FAST_SUMMARY_READER on the machine that does the enhanced file format conversion. This can speed up
conversion considerably.
General considerations 35
Schlumberger - Private
INSTALLATION GUIDE 2020.6
SQLNET.AUTHENTICATION_SERVICES=(KERBEROS5PRE,NONE)
• Add KERBEROS5 to any other authentication services that you are using.
SQLNET.KERBEROS5_CONF=c:\oracle\network\krb5\krb5.conf
• This parameter points to the krb5.conf file.
SQLNET.KERBEROS5_CONF_MIT=TRUE
SQLNET.KERBEROS5_CC_NAME=OSMSFT://
3. Create an environment variable named TNS_ADMIN with a path that points to the location of the sqlnet.ora file.
36
Schlumberger - Private
STUDIO DATABASE CONFIGURATION
The automatic connection is only available when connecting to a repository using Windows authentication with SQL
Server or SSO with Oracle.
To enable the automatic connection at the application level:
1. On the Petrel workstation, open the Slb.P4E.Dbx.Config file (in the Petrel installation directory, located at ...
\Schlumberger\Petrel 2020\Extensions\Schlumberger\Studio).
2. Look for ConnectionOptionsSection in the config file and set EnableAutoConnect to True.
3. Save the file.
NOTE: If you did not deploy Studio and you want to make these configuration changes, change the configuration of
the Coordinate System Manager. If you did deploy Studio, change the configuration of Studio Manager.
AllowAdminOutOfBoxCatalog=True AllowAdminOutOfBoxCatalog=False
Default flag for Coordinate System Manager Default flag for Studio Manager
Can delete any coordinate reference system, transform, or conflation Cannot delete any coordinate reference system, transform, or conflation
policy policy
Can create any coordinate reference system, transform, or conflation Only can create coordinate reference systems, transforms, or conflation
policy, using any authority or code if there is no conflict with existing policies with Petrel as the authority (that is, Source=Petrel) and with a
ones in the catalog code that is within the designated ranges
AllowAdminOutOfBoxCatalog=True AllowAdminOutOfBoxCatalog=False
Can add a coordinate reference system or simple transform from the Esri Cannot add a coordinate reference system or simple transform from the
catalog, using the code (for example, if a person deletes one and later Esri catalog, using the code (because it cannot be deleted)
wants to add it back)
38
Schlumberger - Private
SUPPORT INFORMATION
Support information
Use the Software Support Portal to access technical support for Schlumberger products.
• Contact support for assistance.
• Download product documentation.
• Review product training options.
• Learn about exploration, development, production, and DELFI product and service offerings.