petrobank® master data store™ plugin 5000 ... - halliburton

38
PetroBank® Master Data Store™ Plugin 5000.10.2 Installation Guide © 2014 Halliburton May 2014

Upload: others

Post on 25-Apr-2022

5 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plugin 5000.10.2

Installation Guide© 2014 Halliburton

May 2014

Page 2: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

© 2014 HalliburtonAll Rights Reserved

Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Halliburton. Unauthorized reproduction or distribution of this documentation, or any portion of it, may result in severe civil and criminal penalties, and will be prosecuted to the maximum extent possible under law.

Halliburton may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. The furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.

Halliburton | Landmark Software & Services2107 CityWest Blvd, Building 2, Houston, Texas 77042-3051, USA

P.O. Box 42806, Houston, Texas 77242, USAPhone:713-839-2000, FAX: 713-839-2015

Internet: https://www.landmarksoftware.com

Trademarks3D Drill View, 3D Drill View KM, 3D Surveillance, 3DFS, 3DView, Active Field Surveillance, Active Reservoir Surveillance, Adaptive Mesh Refining, ADC, Advanced Data Transfer, Analysis Model Layering, ARIES, ARIES DecisionSuite, Asset Data Mining, Asset Decision Solutions, Asset Development Center, Asset Development Centre, Asset Journal, Asset Performance, AssetConnect, AssetConnect Enterprise, AssetConnect Enterprise Express, AssetConnect Expert, AssetDirector, AssetJournal, AssetLink, AssetLink Advisor, AssetLink Director, AssetLink Observer, AssetObserver, AssetObserver Advisor, AssetOptimizer, AssetPlanner, AssetPredictor, AssetSolver, AssetSolver Online, AssetView, AssetView 2D, AssetView 3D, Barrier Assurance Monitoring, BLITZPAK, CartoSnap, CasingLife, CasingSeat, CDS Connect, CGMage Builder, Channel Trim, COMPASS, Contract Generation, Corporate Data Archiver, Corporate Data Store, Data Analyzer, DataManager, DataServer, DataStar, DataVera, DBPlot, Decision Management System, DecisionSpace, DecisionSpace 3D Drill View, DecisionSpace 3D Drill View KM, DecisionSpace AssetLink, DecisionSpace AssetPlanner, DecisionSpace AssetSolver, DecisionSpace Atomic Meshing, DecisionSpace Base Module, DecisionSpace Data Quality, DecisionSpace Desktop, DecisionSpace Geosciences, DecisionSpace GIS Module, DecisionSpace GRC Module, DecisionSpace Nexus, DecisionSpace Reservoir, DecisionSuite, Deeper Knowledge. Broader Understanding., Depth Team, Depth Team Explorer, Depth Team Express, Depth Team Extreme, Depth Team Interpreter, DepthTeam, DepthTeam Explorer, DepthTeam Express, DepthTeam Extreme, DepthTeam Interpreter, Desktop Navigator, DESKTOP-PVT, DESKTOP-VIP, DEX, DIMS, Discovery, Discovery 3D, Discovery Asset, Discovery Framebuilder, Discovery PowerStation, Discovery Suite, DMS, Drillability Suite, Drilling Desktop, DrillModel, DrillNET, Drill-to-the-Earth-Model, Drillworks, Drillworks ConnectML, Drillworks Predict, DSS, Dynamic Frameworks to Fill, Dynamic Reservoir Management, Dynamic Surveillance System, EDM, EDM AutoSync, EDT, eLandmark, Engineer’s Data Model, Engineer’s Desktop, Engineer’s Link, ENGINEERING NOTES, eNotes, ESP, Event Similarity Prediction, ezFault, ezModel, ezSurface, ezTracker, ezTracker2D, ezValidator, FastTrack, Field Scenario Planner, FieldPlan, For Production, FrameBuilder, Frameworks to Fill, FZAP!, GeoAtlas, GeoDataLoad, GeoGraphix, GeoGraphix Exploration System, Geologic Interpretation Component, Geometric Kernel, GeoProbe, GeoProbe GF DataServer, GeoSmith, GES, GES97, GesFull, GESXplorer, GMAplus, GMI Imager, Grid3D, GRIDGENR, H. Clean, Handheld Field Operator, HHFO, High Science Simplified, Horizon Generation, I2 Enterprise, iDIMS, iEnergy, Infrastructure, iNotes, Iso Core, IsoMap, iWellFile, KnowledgeSource, Landmark (as a service), Landmark (as software), Landmark Decision Center, LandNetX, Landscape, Large Model, Lattix, LeaseMap, Limits, LithoTect, LogEdit, LogM, LogPrep, MagicDesk, Make Great Decisions, MathPack, MDS Connect, MicroTopology, MIMIC, MIMIC+, Model Builder, NETool, Nexus (as a service), Nexus (as software), Nexus View, Object MP, OneCall, OpenBooks, OpenJournal, OpenLink, OpenSGM, OpenVision, OpenWells, OpenWire, OpenWire Client, OpenWire Server, OpenWorks, OpenWorks Development Kit, OpenWorks Production, OpenWorks Well File, Operations Management Suite, PAL, Parallel-VIP, Parametric Modeling, Petris WINDS Enterprise, PetrisWINDS, PetroBank, PetroBank Explorer, PetroBank Master Data Store, PetroWorks, PetroWorks Asset, PetroWorks Pro, PetroWorks ULTRA, PLOT EXPRESS, PlotView, Point Gridding Plus, Pointing Dispatcher, PostStack, PostStack ESP, PostStack Family, Power Interpretation, PowerCalculator, PowerExplorer, PowerExplorer Connect, PowerGrid, PowerHub, PowerModel, PowerView, PrecisionTarget, Presgraf, PressWorks, PRIZM, Production, Production Asset Manager, PROFILE, Project Administrator, ProMAGIC Connect, ProMAGIC Server, ProMAX, ProMAX 2D, ProMax 3D, ProMAX 3DPSDM, ProMAX 4D, ProMAX Family, ProMAX MVA, ProMAX VSP, pSTAx, Query Builder, Quick, Quick+, QUICKDIF, Quickwell, Quickwell+, Quiklog, QUIKRAY, QUIKSHOT, QUIKVSP, RAVE, RAYMAP, RAYMAP+, Real Freedom, Real Time Asset Management Center, Real Time Decision Center, Real Time Operations Center, Real Time Production Surveillance, Real Time Surveillance, Real-time View, Recall, Reference Data Manager, Reservoir, Reservoir Framework Builder, RESev, ResMap, Resolve, RTOC, SCAN, SeisCube, SEISINFO, SeisMap, SeisMapX, Seismic Data Check, SeisModel, SeisSpace, SeisVision, SeisWell, SeisWorks, SeisWorks 2D, SeisWorks 3D, SeisWorks PowerCalculator, SeisWorks PowerJournal, SeisWorks PowerSection, SeisWorks PowerView, SeisXchange, Semblance Computation and Analysis, Sierra Family, SigmaView, SimConnect, SimConvert, SimDataStudio, SimResults, SimResults+, SimResults+3D, SIVA+, SLAM, Smart Change, Smart Deploy, Smart Flow, Smart Skills, Smart Start, Smart Sustain, Smart Transform, Smart Vision, SmartFlow, smartSECTION, smartSTRAT, Spatializer, SpecDecomp, StrataMap, StrataModel, StratAmp, StrataSim, StratWorks, StratWorks 3D, StreamCalc, StressCheck, STRUCT, Structure Cube, Surf & Connect, SurfNet, SynTool, System Start for Servers, SystemStart, SystemStart for Clients, SystemStart for Servers, SystemStart for Storage, Tanks & Tubes, TDQ, Team Workspace, TERAS, T-Grid, The Engineer’s DeskTop, Total Drilling Performance, TOW/cs, TOW/cs Revenue Interface, TracPlanner, TracPlanner Xpress, Trend Form Gridding, Trimmed Grid, Tubular Basic, Turbo Synthetics, Unconventional Essentials, VESPA, VESPA+, VIP, VIP-COMP, VIP-CORE, VIPDataStudio, VIP-DUAL, VIP-ENCORE, VIP-EXECUTIVE, VIP-Local Grid Refinement, VIP-THERM, vSpace, vSpace Blueprint, vSpace Onsite, WavX, Web Editor, Well H. Clean, Well Seismic Fusion, Wellbase, Wellbore Planner, Wellbore Planner Connect, WELLCAT, WELLPLAN, WellSolver, WellXchange, WOW, Xsection, You’re in Control. Experience the difference., ZAP!, ZEH, ZEH Plot, ZetaAnalytics, Z-MAP, Z-MAP Plus, and ZPS are trademarks, registered trademarks, or service marks of Halliburton.

All other trademarks, service marks and product or service names are the trademarks or names of their respective owners.

NoteThe information contained in this document is subject to change without notice and should not be construed as a commitment by Halliburton. Halliburton assumes no responsibility for any error that may appear in this manual. Some states or jurisdictions do not allow disclaimer of expressed or implied warranties in certain transactions; therefore, this statement may not apply to you.

Page 3: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Third Party Licenses and AttributionsHalliburton acknowledges that certain third party code has been bundled with, or embedded in, its software. The licensors of this third party code, and the terms and conditions of their respective licenses, may be found at the following location:

$USER_INSTALL_DIR/help/manuals/Third_Party.pdf

DisclaimerThe programs and documentation may provide links to external web sites and access to content, products, and services from third parties. Halliburton is not responsible for the availability of, or any content provided on, third party web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Halliburton is not responsible for: (a) the quality of third party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Halliburton is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.

Page 4: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

This page has been left blank intentionally.

Page 5: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Contents PetroBank® Master Data Store™ Plugin Installation Guide

5000.10.2 v

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1System Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Software requirements and pre-requisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Third Party Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Esri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6FME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Installing the PetroBank® MDS Plug-In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Installing Pre-requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Installation Workflow Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Installing Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Enabling Advance Search Filter Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Verifying Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Installing GIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Installing ArcGIS Server 10.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Installing ArcDesktop 10.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Creating Geodatabase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Installing Oracle Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Installing Oracle Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Installing Geodatabase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installing FME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Installing FME workbenches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Installing Order Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Installing DS BPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Importing DecisionSpace BPM Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Installing Order Tracking Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Creating a System Environment Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Verifying Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Web Framework Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Installing Web Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Web Framework application for PetroBank MDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Step-A: Create a Web Framework application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Step - B: Activate a PetroBank MDS Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Step - C: Configure service settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Contents

Page 6: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plugin Installation Guide Contents

vi 5000.10.2

Page 7: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Introduction PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Overview 1

Introduction

Overview

The PetroBank® Master Data Store (MDS) Plug-in enables users to search, browse, view, and order data from the PetroBank® Master Data Store™ software using the DecisionSpace® Integrated Server. Data from the PetroBank Master Data Store software can be viewed using a GIS tool or by performing a keyword/text search. Company level entitlements are honored at all times so that users can only view data for which their company has access rights.

The key features of the software are listed below:

• Searching and browsing data

• Publishing shapefiles and viewing data

• Ordering data

Page 8: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Introduction

2 System Architecture 5000.10.2

System Architecture

Page 9: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Introduction PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Features 3

Features

The PetroBank MDS Plug-in comprises of the following main features:

• Search: Search enables you to search and retrieve data from the PetroBank MDS database.

• GIS: GIS displays spatial information extracted from the PetroBank MDS database.

• Order tracking: Order tracking enables you to track the progress of the data you ordered.

Page 10: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Introduction

4 Software requirements and pre-requisites 5000.10.2

Software requirements and pre-requisites

The PetroBank MDS Plug-in has several prerequisites. Some of these prerequisites are Landmark software products which can be downloaded from Landmark Software Manager (LSM). Others are third party software products. A list of prerequisites is given in the table below:

Prerequisite Description Version Source

PetroBank Master Data Store software

PetroBank Master Data Store views and tables are required by the PetroBank MDS Plug-in.

5000.7.2.2 Landmark

DecisionSpace Integration Server

The DecisionSpace® Integration Server has the following main features:

— DecisionSpace Search consists of a suite of technologies that help deliver enterprise search for the DecisionSpace platform.

— DecisionSpace Portal provides a framework and hosting environment for developing and running new web-based business applications.

— DecisionSpace BPM Repository can be used as a process repository to store business processes.

5000.10.2 Landmark

ArcGIS Server An ArcGIS server is required to manage map services.

10.1 Esri

Oracle Client Oracle Client is required for populating spatial data from MDS shapefiles into the geodatabase.

11g Landmark

Oracle Server Oracle Server is required for hosting the geodatabase.

11g Landmark

ArcDesktop for Windows

ArcDesktop enables FME to populate spatial data from the PetroBank Master Data Store software into the geodatabase.

10.1 Esri

FME Desktop

(Esri edition 2014)

FME is used to display GIS information from shapefiles generated by the PetroBank Master Data Store software. FME reads shapefiles and loads them into the geodatabase.

Note: This is only required in certain circumstances. Please refer to page 19 for further information.

2014 Safe Software

Python Python is used by FME to generate log files. Log files are generated when the geodatabase is populated with spatial information using FME work benches. Python is also needed for Solr queue management required by MDS scripts.

2.7.4 Python Software Foundation

Page 11: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Introduction PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Software requirements and pre-requisites 5

Apache HTTP Server for Linux

The Apache HTTP server must be installed on each server hosting Archive Object documents.

2.2.3 Apache Software Foundation

Prerequisite Description Version Source

Page 12: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Introduction

6 Third Party Software 5000.10.2

Third Party Software

The PetroBank MDS Plug-in consists of the following third party components:

Esri

Esri is a provider of Geographic Information System (GIS) software and geodatabase management applications. The PetroBank MDS Plug-in uses the capabilities of ArcGIS Server, ArcGIS Desktop, and Geodatabase for publishing and displaying spatial data.

FME

FME enables the PetroBank MDS Plug-in to QC spatial information extracted from the PetroBank Master Data Store database, and populate the Geodatabase in ArcGIS Server.

Page 13: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Overview 7

Installing the PetroBank® MDS Plug-In

Overview

You must perform installations and configurations in the order in which they are presented. Do not skip sections (unless it is mentioned that a particular installation is optional) as an installation or configuration in one section may be dependent on items set up in a previous section.

Page 14: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

8 Installing Pre-requisites 5000.10.2

Installing Pre-requisites

You must install the PetroBank® Master Data Store™ software before installing the PetroBank MDS Plug-in. For more information on this, please refer to the PetroBank® Master Data Store Software Installation Guide.

Page 15: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installation Workflow Diagram 9

Installation Workflow Diagram

The following diagram presents installation workflow:

Page 16: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

10 Installing Search 5000.10.2

Installing Search

Prerequisite: You must install the DecisionSpace® Search feature on Linux before installing MDS Search. For more information on this, please refer to the DecisionSpace® Integration Server Search Installation Guide.

The PetroBank MDS software can index the data types listed below:

• Acquisition• Archive object document• Inventory object• Navigation• Production• Seismic• Survey• Velocity• Well• Well log • Wellbore

You can search these data types using MDS Search feature.

Follow the steps given below to install the MDS Search:

1. Stop the Search Server by killing its related processes.

2. Locate the mdssearch.bin file from the mds.zip package and launch it. Note: This file is located in the machine where Web Framework is

Page 17: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing Search 11

deployed. This will typically be in “C:\Program Files (x86)\Landmark\DSPortal\WSP\Plugins\Petrobank MDS”.

3. Review the information given in the Introduction screen and click Next to proceed.

4. Review the software license agreement information given in the License Agreement screen and then select I accept the terms of the License Agreement option.

Page 18: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

12 Installing Search 5000.10.2

5. Click Next to proceed.

6. Assuming that DecisionSpace Search is installed at the default location, click Choose to select the target directory /opt/Landmark/DecisionSpaceSearch5000.10.1.0/solr-4.3.0/dscore/ds/conf.

7. Click Next to proceed.

8. Enter the PetroBank Solr credentials. Specify the PetroBank database credentials required by the

Page 19: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing Search 13

indexing scripts for crawling the database. Note: You will need to specify the “pb_crawler” user credentials that has been specifically created for crawling purposes.

9. Click Next to proceed.

Page 20: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

14 Installing Search 5000.10.2

10. Review the Pre-Installation Summary and click Install to install the necessary Solr configuration.

11. Once the installation is complete, click Done to exit the installer.

Once search is installed, the next step is to populate the search index. For more information on how to populate the search index, please refer to the PetroBank® MDS Plug-In System Administration Guide.

Enabling Advance Search Filter Criteria

To enable Advance Search Filter Criteria you must execute pb_metadata.sh only once after installation.

1. Open a new terminal as MDS Search installation user.

2. Switch to the home directory.

If you encounter the following warning, ignore and continue.

“WARNING - Source /opt/Landmark/DecisionSpaceSearch5000.10.0/solr-4.3.0/dscore/ds/conf/../lib/ojdbc5.jar does not exist.”

Page 21: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing Search 15

3. Enter the following commands:

cd $HOME cd Solr_script/curl ./pb_metadata.sh

Verifying Installation

1. Start Search server by running <Search_Install_Path>/ApplicationServer/bin/standalone.sh.

2. Open an internet browser and enter the following address: http://<dssearch-host>:8080/solr/ds/dsselect?q=*:* Where, <dssearch-host>is the host machine running MDS Search. If there are no errors, then an XML response from the search server displays.

Page 22: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

16 Installing GIS 5000.10.2

Installing GIS

Perform installations in the order given in the sections below.

Installing ArcGIS Server 10.1

ArcGIS Server 10.1 must be installed on Windows 2008 R2 Server. ArcGIS Server 10.1 requires a 64-bit operating system. For more information on installing ArcGIS Server, please refer to the ArGIS Server documentation. You can also watch this step-by-step video.

Note: It is highly recommended to use a much higher specification than the minimum specified by Esri.

Installing ArcDesktop 10.1

ArcGIS Desktop 10.1 is a 32-bit application and must be installed on Windows. For more information on installing ArcGIS Desktop, please refer to the relevant installation guide.

Creating Geodatabase

The geodatabase is used by the GIS component of the MDS Plug-in to store and manage PetroBank MDS spatial data. Please install components in the order given below:

Installing Oracle Database

You must install the 64-bit Oracle Database Server 11gR2, or use an existing instance of this software. The target platform can be either 64-bit Linux or Windows. You must also install the Oracle Text package. For more information on installing Oracle Database Server, please refer to the Oracle online documentation.

Installing Oracle Client

You must install the 32-bit Oracle client 11gR2 on the same machine where you installed ArcGIS Desktop 10.1. For more information on installing Oracle client, please refer to the Oracle online documentation.

Page 23: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing GIS 17

Installing Geodatabase

The geodatabase is created using the “Create Enterprise Geodatabase” geoprocessing tool in ArcGIS Desktop. The tool does the following:

• Creates an SDE user and default tablespace (400 MB)

• Grants the SDE user privileges to create a geodatabase and drop database connections

• Creates a geodatabase in the database

The following instructions explain how to create a geodatabase using the Create Enterprise Geodatabase tool:

1. Start ArcMap or ArcCatalog on the machine where Oracle client is installed.

2. Open the Create Enterprise Geodatabase tool. This tool is located in the Geodatabase Administration toolset of the Data Management toolbox. You can search for or browse to this tool as well.

3. Choose Oracle from the Database Platform drop-down list.

4. Type the TNS network alias in the Instance text box. It is assumed that an alias is already configured using the Oracle Net Configuration Service.

You must connect to the database as a database administrator to create the geodatabase administrator and tablespace. Therefore, the Database Administrator text box is populated with the sys user name.

1. Enter sys user's password in the Database Administrator Password text box.

2. Type the name of the geodatabase administrator in the Geodatabase Administrator text box.

• The geodatabase administrator must be named sde. If a user with that name does not already exist in the database, the tool creates one and grants it the privileges to create a geodatabase. If the user already exists, the required privileges are granted to it.

Page 24: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

18 Installing GIS 5000.10.2

• If you are creating a user-schema geodatabase, type the name of an existing user who will own the geodatabase. You must already have a master sde geodatabase before you can create a user-schema geodatabase. The tool grants the user privileges necessary to create a geodatabase.

3. Type a password for the geodatabase administrator in the Geodatabase Administrator Password text box.

• If the geodatabase administrator you specify already exists in the database, be sure to type the correct password for the existing user; this tool does not change the password.

• If you are creating an sde user, the password you type is used when creating the sde user.

4. Specify a tablespace for the geodatabase administrator.

• If you have a preconfigured tablespace to be used for the geodatabase repository, type its name in the Tablespace Name text box.

• If you want the tool to create a tablespace for you, type a valid name in the Tablespace Name text box and the tool creates a 400 MB tablespace in the Oracle default location. If you do not type a tablespace name, SDE_TBS tablespace is created and set as the default tablespace for the sde user.

5. To specify an Authorization File, browse to and choose the keycodes file that was created when you authorized ArcGIS for Server Enterprise. This file is written to: C:\\Program Files\ESRI\License<release#>\sysgen folder on Windows servers.

6. Click OK to run the tool. A log file for the geodatabase creation (GDBCreateGeodatabase<#>.log) is written to the directory specified for your %TEMP% variable on the computer where the tool is run.

Page 25: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing GIS 19

Installing FME

FME is required to display GIS information from shapefiles generated by the PetroBank Master Data Store software. FME will read the shapefiles and load them into the geodatabase. FME is third party software and must be purchased upfront from the vendor. Please visit:

http://www.safe.com/fme/fme-technology/fme-desktop/overview/

FME is a prerequisite for installation of FME workbenches. For more information on installing FME, please refer to the FME documentation.

Installing FME workbenches

The summary of steps are as follows:

a) Run FME WorkBenches Installer

b) Run GeoDatabase Scripts

Page 26: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

20 Installing GIS 5000.10.2

Step - (A): Run FME WorkBenches Installer:

1. Locate mdsgeodb.exe file from the mds.zip package and double-click it.

Page 27: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing GIS 21

2. Review the information given in the Introduction screen and click Next to proceed.

3. Review the software license agreement information given in the License Agreement screen and then select I accept the terms of the License Agreement option.

4. Click Next to proceed.

5. Enter the directory where you would like to install FME workbenches by clicking Choose to select the target directory.

Page 28: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

22 Installing GIS 5000.10.2

6. Click Next to proceed.

7. Review the Pre-Installation Summary and click Install to install FME workbenches.

8. Once the installation is complete, click Done to exit the installer.

Page 29: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing GIS 23

Step - (B): Run Geodatabase scripts

The GeoDatabase SQL scripts are located under the folder where FME Workbenches was installed. This is typically “C:\Program Files (x86)\FME_ShapeFiles_Workbenches”.

Note: To run the scripts you will need to launch “sqlplus” and connect as the “system” or “sys” user accounts.

The following steps need to be done in the order listed below.

1. Execute create_gdb_user.sql. Note: Before executing this script, you must open the script file and edit the highlighted portions in the lines below to contain the actual path to the datafiles you will use in your Oracle server instance: CREATE TABLESPACE gdb DATAFILE 'C:\\MDS\\GeoDB\\GEODB\\gdb1.dbf' SIZE 200M AUTOEXTEND ON MAXSIZE UNLIMITED; CREATE TABLESPACE lgc DATAFILE 'C:\\MDS\\GeoDB\\GEODB\\lgc1.dbf' SIZE 200M AUTOEXTEND ON MAXSIZE UNLIMITED; Once executed, this script will create the “gdb” user account with password as “gdb”. e.g. @create_gdb_user

2. Create SDE connection file. Using ArcCatalog create an SDE connection file that points to the GeoDatabase created. For more information please refer to the Petrobank MDS Plug-In System Admininstration Guide. Note: The connection needs to use the “gdb” credentials.

3. Load Spatial Data into GeoDatabase Please make sure all seismic, velocity and navigation shapefiles are processed before moving to the next step. This is required to create necessary database tables that the stored procedures refer to. For more information please refer to PetroBank MDS Plug-In System Administration Guide.

Page 30: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

24 Installing GIS 5000.10.2

4. After loading the data, please check for the existence of these tables in the geodatabase:

• GDB.PB_ENT_2DNAVD

• GDB.PB_ENT_2DSEISMIC

• GDB.PB_ENT_2DVEL

• GDB.PB_ENT_3DNAVD

• GDB.PB_ENT_3DSEISMIC

• GDB.PB_ENT_3DVEL

5. Execute create_procedures.sql to create stored procedures and entitlement views.

You will now publish map services, For further information please refer to PetroBank® MDS Plug-In System Administration Guide.

Page 31: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing Order Tracking 25

Installing Order Tracking

Perform installations in the order given in the sections below.

Installing DS BPM

You must install the DecisionSpace Business Process Modeling (BPM) feature before the order tracking workflow can be configured. For more information on installing this feature, please refer to the DecisionSpace® Integration Server Business Process Modeling Installation Guide.

Importing DecisionSpace BPM Workflow

Perform the following steps to import the workflow definition into the DecisionSpace BPM repository.

1. In the mds.zip, locate repository_export.zip in the war folder.

2. Extract the repository_export.xml file from the repository_export.zip file.

3. Enter URL http:// <ds-bpm-host>:8080/dsbpm-repo.

4. Select Administration > Import Export and click Browse.

5. Select the repository_export.xml file and click Import.

6. Open the Knowledge Bases section and verify that the com.lgc.ordertracking package hierarchy is available.

7. Go to the com.lgc.ordertracking package and click Edit.

8. Click Validate configuration.

9. Click Build Package. A message displays informing you that the package has been built successfully.

10. Go to http://<ds-bpm-host>:8080/dsbpm-engine/admin-console/index.html to import com.lgc.ordertracking from DSBPM admin console.

Page 32: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

26 Installing Order Tracking 5000.10.2

11. Enter user name and password. The default credentials are username and password: superadmin.

12. Click Import Processes.

13. Select the com.lgc.ordertracking check box.

14. Click Import.

Installing Order Tracking Service

You must deploy the order tracking service on the same system where DecisionSpace BPM is running.

1. From mds.zip, extract order_tracking.war file from the war folder.

2. Log on to the machine where DecisionSpace BPM is installed.

3. Locate the order_service folder from the “mds.zip” package.

4. Create a folder named Landmark under your root folder if it does not exist already. For example, on a windows machine: C:\Landmark.

5. Copy the order_tracking folder in the order_service folder to the Landmark folder. You have C:\Landmark\order_tracking.

Creating a System Environment Variable

1. Go to the Computer folder and click System properties.

2. Select Change settings. The System Properties dialog displays.

3. Select Advanced.

4. Click Environment Variables.

5. Click New to create a new environment variable.

Page 33: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Installing Order Tracking 27

6. Enter ORDER_TRACKING_HOME in Variable name and enter the order_tracking folder path, for example, C:\Landmark\order_tracking, in Variable value field.

7. Click OK.

8. Locate the order_tracking.war file under the ‘order_service/war folder.

9. Copy the order_tracking.war file to the following folder: <DSBPM-Install-Location>\ApplicationServer\standalone\deployments.

10. Start DS BPM, if it is not already running.

Page 34: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

28 Installing Order Tracking 5000.10.2

For Windows, the DS BPM service can be started from the Services manager.

Verifying Deployment

Before you verify the installation, please wait for five minutes.

1. Open an Internet browser and enter the following URL: http://localhost:8080/order_tracking/rest/order?orderId=10000000&appId=PBEX

2. If the deployment was successful and there are no errors, then the following JSON response displays: “{"records" :[], "totalRecords" :0}”

Page 35: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Web Framework Application 29

Web Framework Application

Installing Web Framework

For more information on installing Web Framework, DecisionSpace® Integration Server Web Framework Installation Guide.

Web Framework application for PetroBank MDS

Follow the steps below to create and configure an application to search and order data from Petrobank MDS.

The summary of steps are as follows:

a) Create a Web Framework application

b) Activate Petrobank MDS Pages feature

c) Configure service settings

Step-A: Create a Web Framework application

1. From the Windows Start menu, select Landmark > DecisionSpace Portal > Web Framework Management.

2. Click Application.

3. Enter a name and description and click Create Application. A message displays informing you that the application has been created.

4. Click OK.

Step - B: Activate a PetroBank MDS Feature

1. Log in as Portal Administrator to Web Framework.

2. Navigate to the application site settings page by typing: http://<wf-host>/<appid>/_layouts/settings.aspx. For e.g. http://mywf-host:9000/mds/_layouts/settings.aspx

Page 36: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

30 Web Framework Application 5000.10.2

3. Select Manage Site features.

4. From the Site Features page, find Petrobank MDS App Pages and click Activate.

Step - C: Configure service settings.

1. Log in as Portal Administrator to Web Framework.

2. Go to the Administration page.

3. Select Settings.

4. Select Service Settings.

5. Select Dev DSBPM.

6. Click Edit Service Configuration.

7. Update the ConnectionURL http://dsbpm-host:8080/dsbpm-engine/rest/ by replacing “dsbpm-host” with the fully qualified domain name of the machine where DecisionSpace BPM is installed.

8. Go to the application page. The application home page displays Notifications(0) in the left-side panel adjacent to Dev DSBPM URL set.

9. Go to Administration page.

10. Select Settings.

11. Click Edit Service Configuration. Replace “dssearch-host” with the fully qualified domain name of the machine where DecisionSpace Search is installed. This provides settings required for company users to search for items.

12. Click Edit Service Configuration for Order Service.

13. Replace “localhost” in the Connection URL with the fully qualified domain name of the machine where DecisionSpace BPM is installed.

Page 37: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

Installing the PetroBank® MDS Plug-In PetroBank® Master Data Store™ Plug-In Installation Guide

5000.10.2 Web Framework Application 31

14. Click Webpart Configuration.

15. Click Shopping Cart Control.

16. Select 1.

17. Click Edit ShoppingCart Control Configuration.

18. If you have deployed Web Framework and PetroBank MDS Plug- in on SharePoint 2013 then update the actionTemplate textbox. Replace "/_layouts/DSP/DSPortalBase/PBEXApp/ OrderTracking.aspx?servicename=Order Service" with "/_layouts/15/DSP/DSPortalBase/PBEXApp/ OrderTracking.aspx?servicename=Order Service"

Page 38: PetroBank® Master Data Store™ Plugin 5000 ... - Halliburton

PetroBank® Master Data Store™ Plug-In Installation Guide Installing the PetroBank® MDS Plug-In

32 Web Framework Application 5000.10.2