Installation guide for Blueback Toolbox - Ocean - Schlumberger

Blueback Reservoir AS
Installation guide for
Blueback Toolbox
Version 13.1
06.12.2012

Blueback Reservoir – Toolbox 13.1 Installation guide
Copyright © 2012 Blueback Reservoir. All rights reserved.
This work contains the confidential and proprietary trade secrets of Blueback Reservoir 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.
Schlumberger Trademarks & Service Marks
Schlumberger, the Schlumberger logotype, trademarks, trade names or service marks of Schlumberger
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.
Country of Origin: Norway/UK
Contents
Introduction 3
Installation 3
System requirements 3
Downloading the Blueback Toolbox 4
Installing the Blueback Toolbox in Petrel 2011 using the Ocean plug-in
manager 5
Installing the Blueback Toolbox with Windows installer 6
Installed components 7
Using the MSI installer in Petrel 2011 7
Using the PIP installer in Petrel 2011or MSI installer in Petrel 2012 8
Uninstalling the Blueback Toolbox for Petrel 2011 in the Ocean plug-in
manager 9
Uninstalling the Blueback Toolbox installed with Windows installer 10
Licensing 10
Page | 2

Blueback Reservoir – Toolbox 13.1 Installation guide
Introduction
Thanks for downloading our new Toolbox version, Toolbox 13.1.
Public key token: 51e9179abfe24f1d
Remember: the toolbox is very much a user driven product. Please continue to send
ideas to support@blueback-reservoir.com or visit our support portal: support.bluebackreservoir.com.
Installation
This chapter will guide you through the installation of the Blueback Toolbox. Contact
support@blueback-reservoir.com if you have any problems or questions.
Note that the different categories of the Toolbox (Geophysics, Geology, Reservoir
Engineering, Project Management, Seismic Inversion and Seismic Reservoir
Characterization) are all bundled into one installer. When the Toolbox has been
installed all these categories are installed. If more than one category has been
purchased only one installation needs to be done. The different categories are later
activated with license files.
System requirements
It is required to have Petrel 2011.X or Petrel 2012.X installed before you start the
installation process.
Only Petrel 64 bit version is supported.
It is also required to have a valid Petrel license on your local computer or from a
license server.
As a minimum, we suggest having a valid Petrel Core license
Page | 3

Blueback Reservoir – Toolbox 13.1 Installation guide
To run Eclipse simulations, Eclipse needs to be installed and licensed
The Blueback Toolbox is a Petrel plug-in and has the same system requirements as
Petrel. See the Petrel Installation Guide for more information.
Downloading the Blueback Toolbox
The Blueback Toolbox is downloaded from the Ocean store, scroll down the list to any
of the Blueback Toolboxes (they share the same installer), select the Petrel version you
need, and the link (date of release) will direct you to the installer:
There are 2 different ZIP files for 2011 version of Petrel and 1 zip file for 2012 version of
Petrel (‘X’ is the patch release number, ‘’ is the revision number of the
build):
Petrel version
Petrel 2012.1 64 bit
Petrel 2011.1 or 2011.2
64 bit
Petrel 2011.1 or 2011.2
64 bit
Installation file
Blueback toolbox_13.1__2012.X_ 64bit MSI. zip
for Windows installer
Blueback toolbox_13.1 __2011.X _64bit PIP for
Ocean plug-in manager
Blueback toolbox_13.1__2011.X _64bit MSI.zip
for Windows installer
Page | 4

Blueback Reservoir – Toolbox 13.1 Installation guide
For Petrel 2011, the plug-in can be installed using either the Ocean plug-in manager or
a Windows installer (with setup.exe and a .msi file).
For Petrel 2012, the plug-in can be installed using the Windows installer (with setup.exe
and a .msi file), which installs the PIP using PluginManager.exe as part of the installation
process.
The version of Petrel can be seen by starting Petrel and then opening the “About
Petrel” dialog in the Help menu.
Installing the Blueback Toolbox in Petrel 2011 using the Ocean plug-in manager
See the Petrel installation manual for details about how plug-ins are installed and
managed using the Ocean Plug-in Manager.
1. Save the zipped installation file downloaded from the Ocean store in a folder.
Make sure that the correct zip file according to the Petrel version is downloaded.
See chapter Downloading the Blueback Toolbox.
2. Unzip the file.
3. Start Petrel with administrator privileges. Note that you may need to start Petrel
with the “Run as administrator” option depending on the security settings of the
machine:
Page | 5

Blueback Reservoir – Toolbox 13.1 Installation guide
4. Open the Ocean plug-in manager in the Help menu
5. Click “Install plug-in”
6. Locate the .pip file unzipped in point 1 and 2 and load it.
7. Restart Petrel
Installing the Blueback Toolbox with Windows installer
The zipped installation file is about 50 MB. This includes the online documentation.
Installing the Blueback Toolbox for the first time:
Page | 6

Blueback Reservoir – Toolbox 13.1 Installation guide
1. Save the zipped installation file in a folder
2. Unzip the file
3. Double click the Setup.exe file to start the installation and follow the instructions
4. The Blueback Toolbox is launched from inside Petrel, so you need to start Petrel
to check that the installation has been successful.
Upgrading from previous versions:
1. Check if there is a new version available. See the HELP pull down menu, and
select the option “Check for Blueback Toolbox updates…” This will return info on
how to get the latest version.
2. Start the installation from the new Setup.exe file. The installer will detect and
remove old versions of the Toolbox.
Installed components
Using the MSI installer in Petrel 2011
The Blueback Toolbox plug-in installer will do the following changes to the system:
1. Add a folder to the Petrel installation directory called
“Extensions\Blueback\Toolbox.
2. Add the following files:
Page | 7

Blueback Reservoir – Toolbox 13.1 Installation guide
3. Modify the petrel.exe.config file to register the plug-in modules
4. A new trusted vendor is defined called “BluebackReservoir” allowing the
Blueback Toolbox to be executed when Petrel is executed with the medium and
high security levels.
Using the PIP installer in Petrel 2011or MSI installer in Petrel 2012
The Blueback Toolbox plug-in installer will do the following changes to the system:
1. Add a folder to the Petrel installation directory called “Extensions\Blueback
Toolbox_13.1.2011 or .2012”.
2. Add the same files as described above in addition to Plugin.xml and
BluebackToolbox_Manifest.xml for Petrel 2012 installation.
Page | 8

Blueback Reservoir – Toolbox 13.1 Installation guide
Uninstalling the Blueback Toolbox for Petrel 2011 in the Ocean plug-in manager
To uninstall the Blueback Toolbox from Petrel 2011 do the following:
1. Start Petrel.
2. Open the Ocean plug-in Manager from the Help menu in Petrel.
3. Select the Blueback toolbox plug-in
4. Click Uninstall
5. Restart Petrel
Page | 9

Blueback Reservoir – Toolbox 13.1 Installation guide
Uninstalling the Blueback Toolbox installed with Windows installer
1. Open Add/Remove programs (Windows XP) or Uninstall a program (Windows 7)
from the Windows control panel.
2. Find the entry for the Blueback Toolbox
3. Click Remove. The uninstaller will remove the plug-in from the system.
Licensing
The Blueback Toolbox is using the same licensing system as Petrel. The Ocean Store will
provide Petrel license files for the Toolbox modules. These license files must be loaded
into the “Schlumberger licensing” application. See the Petrel Installation Guide for more
information.
The Blueback Toolbox license modules will be shown in the Petrel license package
dialog in the Ocean plug-ins folder. Make sure that these License modules are selected.
Page | 10

Blueback Reservoir – Toolbox 13.1 Installation guide
Note: The Seismic Inversion tools are only shown if the Earthworks Seismic Inversion plugin
is installed and has a valid license.
Page | 11

Blueback Reservoir – Toolbox 13.1 Installation guide
The license status can also be checked in the Schlumberger licensing utility. Open it
from Start->Programs->Schlumberger->Schlumberger Licensing 20XX->Schlumberger
Licensing
Click the “Status…” button. The Blueback Toolbox licenses are called:
OCEAN_BBR_BLUEBACK_TOOLBOX_DM for Blueback Toolbox project
management,
OCEAN_BBR_BLUEBACK_TOOLBOX_GF for Blueback Toolbox geophysics,
OCEAN_BBR_BLUEBACK_TOOLBOX_GE for Blueback Toolbox geology,
OCEAN_BBR_BLUEBACK_TOOLBOX_RE for Blueback Toolbox reservoir
engineering,
OCEAN_BBR_TOOLBOX_RC for Blueback Toolbox seismic reservoir
characterization
OCEAN_BBR_EARTHWORKS_INVERSION for Earthwork Seismic Inversion (only
available with valid Earthwork Seismic Inversion license)
Page | 12

Blueback Reservoir – Toolbox 13.1 Installation guide
Page | 13