OpenSpirit Adapter for Petrel Installation Guide · For comments or problems with this manual or the software it addresses, contact TIBCO ... OpenSpirit Adapter for Petrel Installation

TIBCO OpenSpirit® Adapter for Petrel Installation Guide Software Release 26.0.0

July 2017

ii

Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENTIS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc.

TIBCO, OpenSpirit, and TIBCO OpenSpirit Adapter for Petrel are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.

All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE RELEASE NOTES FOR THE AVAILABILITY OF THIS SOFTWARE VERSIONON A SPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.

THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.

Copyright © 2000-2017 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information

3

Table of Contents Installation Prerequisites ................................................................................................... 4

Installation Steps .............................................................................................................. 5

Support Resources ........................................................................................................ 5

Ocean Plug-in Manager Installation Method ................................................................. 6

Windows Installer Installation Method .......................................................................... 8

Windows Silent Installer Installation Method .............................................................. 12

Windows Firewall Exemption Rules ........................................................................... 13

Uninstalling ................................................................................................................ 13

Ocean Plug-in Manager Uninstall ............................................................................ 13

Windows Installer Uninstall .................................................................................... 15

Installation Files ............................................................................................................. 17

Glossary ......................................................................................................................... 18

4 | Installation Prerequisites

Installation Prerequisites The TIBCO OpenSpirit Adapter for Petrel requires the following software be installed prior to installation:

• Petrel 2017.x

• OpenSpirit runtime v4.2.0 (or newer) The supported Windows versions are those that Petrel supports. Refer to the Petrel application documentation for operating system and hardware requirements.

The TIBCO OpenSpirit Adapter for Petrel requires an Ocean plug-in license feature named "OCEAN_TIB_OPENSPIRITADAPTER" to be available and it requires a Petrel Geoscience Core license.

The public key token for the TIBCO OpenSpirit Adapter for Petrel is d2630e7a1eb995dd.

ECCN: US origin, EAR99

OpenSpirit Adapter for Petrel Installation Guide

Installation Steps | 5

Installation Steps The TIBCO OpenSpirit Adapter for Petrel can be installed using the Ocean Plug-in Manager or it can be installed using a Windows Installer (.msi file). Both methods of installation are described below.

The method used to install the OpenSpirit Adapter determines if the adapter is available to all users on the workstation it is installed on, or if it is only available to the user that performs the installation. Also, there are ways to install Ocean plug-ins on a network share that enable plug-ins to be available to all workstations and users that have been configured to use the shared plug-ins. Refer to the Petrel installation guide for a complete description of the various methods of installing Ocean plug-ins.

Support Resources Documentation for this and other TIBCO products is available on the TIBCO Documentation site. This site is updated more frequently than any documentation that might be included with the product. To ensure that you are accessing the latest available help topics, visit:

https://docs.tibco.com

For comments or problems with this manual or the software it addresses, contact TIBCO Support:

• For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site: https://support.tibco.com select About Support > Getting Started

• If you already have a valid maintenance or support contract, visit this site: https://support.tibco.com Entry to this site requires a user name and password. If you do not have a user name, you can request one.

TIBCO Community is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCO Community offers forums, blogs, and access to a variety of resources. To register, go to the following web address:

https://community.tibco.com


https://docs.tibco.com/

https://support.tibco.com/

https://support.tibco.com/

https://community.tibco.com/

6 | Installation Steps

Ocean Plug-in Manager Installation Method 1. Download the Plug-in Installer Package (.pip) file for the OpenSpirit Adapter and

start Petrel. 2. Select the Ocean Plug-in Manager option from the Petrel File menu.

This will open the Ocean Plug-in Manager window.



3. Click on the Install plug-in button. This will open a file selector window. Select the OpenSpirit Adapter .pip file.

An installation confirmation message will appear after the plug-in has been installed. The message confirms the plug-in has been installed, but requires Petrel to be restarted in order to see and use the plug-in.



4. Close the Ocean Plug-in Manager window and restart Petrel.

The plug-in can be installed in a directory outside of the Petrel installation, by modifying the "DefaultDirectory" entry in Petrel's %APPDATA%\Schlumberger\Petrel\2017\PluginManagerSettings.xml. This is a Petrel feature.

Windows Installer Installation Method 1. Download the plug-in installer .msi file. 2. Make sure the Petrel application is not running. Start the installer by double clicking

on the .msi file in Windows File Explorer.



3. Follow the installation wizard and click the "Next>" Button when prompted



4. Read and accept the license agreement, then click on the “Next>" Button.

5. Make your startup optimization choice and click on the "Next>" Button.



6. Click on the Install button to begin the installation.

7. A progress bar appears while the plug-in files are installing.



8. Click on the Finish button when the installation is complete. After a successful installation the OpenSpirit tool bar should appear in Petrel the next time it is launched.

The plug-in can be installed in a directory outside of the Petrel installation, by modifying the "DefaultDirectory" entry in Petrel's %PROGRAMDATA%\Schlumberger\Petrel\2017\PluginManagerSettings.xml. This is a Petrel feature.

Windows Silent Installer Installation Method The Windows installer can also be run in silent install mode. Silent installs do not display any user interface. Perform the following steps to silently install the Petrel Adapter.

1. Download the plug-in installer .msi file. 2. Make sure the Petrel application is not running. 3. Open a Windows command window as administrator

4. CD to the folder containing the downloaded .msi file and execute the following command: msiexec /i "TIBCO OpenSpirit Adapter for Petrel 2017.msi" /qn



Windows Firewall Exemption Rules Firewall exemptions are required for two application executables in order for the OpenSpirit Adapter to work properly. The executables that need exempting are:

%Ocean2017Home%Petrel.exe %Ocean2017Home%Extensions\TIBCO\OpenSpirit Adapter 26.0.0\ZgyJobs.exe %Ocean2017Home%Extensions\TIBCO\OpenSpirit Adapter 26.0.0\ZgyMonitor.exe

A Windows batch script is provided that contains commands to add the exemptions to your Windows firewall. The batch script is located in the OpenSpirit Adapter folder with file name FirewallExemptionRules.bat. You will need Administrator or elevated privileges in order to successfully run the script. Consult with your IT administrator about adding the rules if a firewall is being run on the system you will be using to run Petrel.

The commands in the FirewallExemptionRules.bat script specify the default location for the OpenSpirit Adapter folder. The default location is: %Ocean2017Home%Extensions\TIBCO\OpenSpirit Adapter 26.0.0. The commands must be modified before running the batch script if the adapter was installed in an alternate location.

Uninstalling The procedure for uninstalling the OpenSpirit Adapter depends on the method used to install the adapter.

Ocean Plug-in Manager Uninstall An OpenSpirit Adapter that was installed using the Ocean Plug-in Manager is uninstalled using the Ocean Plug-in Manager. Open the Ocean Plug-in Manager from the Petrel Options menu and click on the OpenSpirit Adapter entry.



This will expand the OpenSpirit Adapter entry exposing an Uninstall button. Click on the Uninstall button to uninstall the plug-in.



A progress window will appear while the plug-in is uninstalling. Click on the Close button when the uninstall is complete. The plug-in will still appear in the installed plug-ins list. You will need to restart Petrel for the plug-in to be removed from the list and from the Petrel tool bar.

Windows Installer Uninstall An OpenSpirit Adapter that was installed using a Windows installer (.msi file) is uninstalled using the Windows Control Panel's Program and Features list as shown in the following image.

The adapter can be removed by selecting it from the list and clicking on the Uninstall option. Make sure Petrel is not running before starting the uninstall. A confirmation prompt may appear when the Uninstall option is selected.



Click on the Yes button to proceed with the uninstall. A progress window will then appear. The progress window will go away when the uninstall completes. The OpenSpirit Adapter will not appear in Petrel when Petrel is restarted.


Installation Files | 17

Installation Files The following files are created by the OpenSpirit Adapter installation. These files and the OpenSpirit Adapter 26.0.0 folder are removed during uninstall. The default OpenSpirit Adapter installation folder is

"%OCEAN2017HOME%\Extensions\TIBCO\OpenSpirit Adapter 26.0.0".

FirewallExemptions.bat GISAttributeSchemaExample.xml GisAttributesSchema.xsd GisExtendedAttributes.dll help.chm log4net.dll LogNameToLogMnemonic.xml msvcp140.dll OceanUserPluginConfig.config OpenSpirit.App.Ocean.Interfaces.dll OpenSpirit.App.Ocean.Petrel.dll OpenSpirit.App.Ocean.PlugIn.dll OpenSpirit.App.Ocean.PlugIn.Plugin_Manifest.xml OpenSpirit.App.Opf.dll OpenSpirit.App.Opf.Impl_31.dll OpenSpirit.NET.dll OpenSpirit.Shared.Ocean.Zgy.dll OpenSpiritGroupingConfig.config OpenSpiritHorizonTypeAndPetrelTemplate.xml OpenSpiritLogKindToPetrelMnemonic.xml OpenSpiritPlugin.config OpenSpiritPlugin.log4net OpenSpiritStudioFindLoader.dll OpenSpiritWellSymbolsToWellType.xml Plugin.xml Support.config vcruntime140.dll WellTypesToOpenSpiritWellSymbol.xml ZgyJobs.exe ZgyMonitor.exe ZgyMonitor.exe.config


18 | Glossary

Glossary A

application adapter: A piece of software that allows an application to connect to OpenSpirit in order to read/write data from any data store with an OpenSpirit data connector or to exchange events (messages) with other OpenSpirit enabled applications.

C CRS: A Coordinate Reference System. In Petrel, a project has a CRS which is a map

projection system with a reference geographic system which has an associated datum. In addition, a preferred datum shift to WGS84 is defined.

D data connector: A piece of software that connects a data store to OpenSpirit to allow

applications that connect to OpenSpirit to read/write data from this store.

data selection event: A message passed between applications, via OpenSpirit, that contains datakeys that refer to data in data stores accesible via an OpenSpirit data connector.

datakey: Link that connects a Petrel object (e.g. a well, seismic volume, or horizon) to a data item in an external data store.

datakeys: Links that connect a Petrel object (e.g. a well, seismic volume, or horizon) to a data item in an external data store. Given a datakey OpenSpirit can read or write any updates to/from Petrel.

datum shift: A transformation from one geographic system (and its associated datum) to another. There are different algorithms use to accomplish this transformation including: geocentric translation (3 parameters) Molodensky (5 parameters), Bursa/Wolfe (7 parameters) , and grid based approach such a NADCON or NTv2

G gis event: A message passed between applications, via OpenSpirit, that contains the

geometry. attributes, and CRS of point, polyline, or polygon features that belong to GIS layers. Such messages are normally used to exhange data between applications that is posted as culture data in a basemap.

grid event: A message passed between applications, via OpenSpirit, that contains the grid defintion, grid values, CRS and z units of a grid representing the elevation of a geologic surface or some other attribute defined on a grid. A Petrel surface may be sent as a grid event.

L


Glossary | 19

live-link: A 3D seismic virtual attribute cube created when importing a 3D seismic volume using OpenSpirit. A live-link does not contain seismic data, it points to seismic data that resides in the database it was selected from (e.g. OpenWorks, GeoFrame, etc.). Seismic data is dynamically read from the source database when a Petrel window or process requests data from the live-link. Live-links can be converted into a normal 3D seismic object by realizing the live-link.

M MSL: mean sea level

S SRD: A seismic reference datum (SRD) is the elevation (with respect to MSL) at which the

seismic travel time equals zero.


Documents

OpenSpirit Adapter for Petrel Installation Guide · For comments or problems with this manual or the software it addresses, contact TIBCO ... OpenSpirit Adapter for Petrel Installation