Energy Upstream

Kingdom® 2017
Kingdom Data Management User Guide
July 2017
Trademarks and Copyright
This manual was produced by IHS Markit.
July 2017
.

1401 Enclave Pkwy Ste 500

Houston, Texas 77077
U.S.A.
Tel: (281) 531-4660
Fax: (832) 531-9966
Website: www.ihs.com/kingdom
Sales: [email protected]
Support: [email protected]
The following trademarks appear in this manual.

IHS Markit Kingdom® software and all of its components, AVOPAK, CGMPAK, GeoSyn®,
LoadPAK, PAKnotes®, Petra®, SynPAK®, Tunnel L+, Tunnel O, VelPAK®, VuPAK®,
Kingdom 1D Forward Modeling, Kingdom Colored Inversion, The Kingdom Company,
Kingdom Data Management, Kingdom DM Catalog Builder Kingdom Illuminator
Kingdom Seeker, and Kingdom I3D Scan are trademarks of IHS Markit.
Portions of data loading are copyrighted by Blue Marble Geographics.
Mapping API for the Spatial Explorer map provided by Esri ArcGIS Runtime SDK for .NET.
Kingdom Geophysics contains components under U.S. Patent Numbers 6,675,102,
8,265,876, and 9,105,075.
VuPAK® includes OpenInventor® and VolumeViz from FEI Visualization Sciences Group,
Inc. Some components or processes may be licensed under U.S. Patent Number 6,765,570.
Tunnel L+ includes OpenWorks® and SeisWorks® Development Kit from the Halliburton
Corporation.
Kingdom Connect and Tunnel O include OpenSpirit® FrameWork from OpenSpirit, a
TIBCO Software Group Company. Kingdom Data Management includes components from
OpenSpirit and are copyrighted by OpenSpirit, a TIBCO Software Group Company.
Kingdom Gateway plug-in for Petrel* E&P software platform uses the Ocean* software
development framework and * is a mark of Schlumberger.
Kingdom®1D Forward Modeling® includes software developed as part of the NPlot library
project available from: http://www.nplot.com/.
Portions of Kingdom® bitmap graphics are based on GD library by Boutell.Com, Inc. Further
information about the company can be found at www.boutell.com.
PAKnotes TIFF support is based in part on libtiff.

2017 Confidential iii

Rock Solid Attributes® is a registered trademark of Rock Solid Images Inc. and contains
confidential, proprietary, and trade secret information of Rock Solid Images Inc. Copyright©
Rock Solid Images Inc. All Rights reserved.
HDF5 (Hierarchical Data Format 5) Software Library and Utilities Copyright 2006-2015 by
The HDF Group. NCSA HDF5 (Hierarchical Data Format 5) Software Library and Utilities
Copyright 1998-2006 by the Board of Trustees of the University of Illinois.
VelPAK and Seismic Inversion are developed by Equipoise Software Ltd on behalf of IHS
Markit.
Microsoft is a registered trademark of Microsoft Corporation. Windows 7, Windows 8
operating systems, MS-DOS and SQL Server are trademarks of Microsoft Corporation.
Oracle® Databases are registered trademarks of Oracle Corporation.
OpenWorks, SeisWorks, Interpret 2000 and Interpret 2003 are registered trademarks of
Halliburton Corporation.
IHS Markit incorporates BMC® AppSight™ Black Box Technology in its software. BMC
Software, BMC Software logos and all other BMC Software product and service names are
registered trademarks or trademarks of BMC Software Inc. © 2009 BMC Software, Inc. All
rights reserved.
All other trademarks are the property of their respective owners.

Copyright Notice
© 2011 - 2017 IHS Markit. For Internal use only. All rights reserved.
This manual contains confidential information and trade secrets proprietary to IHS Markit Ltd.
and its affiliated companies (“IHS Markit”). No portion of this manual may be reproduced,
reused, distributed, transmitted, transcribed or stored on any information retrieval system, or
translated into any foreign language or any computer language in any form or by any means
whatsoever without the express written permission of IHS Markit. For more information,
please contact Customer Care at [email protected].

Misuse Disclaimer
IHS Markit makes no representation or warranties of any kind (whether express or implied)
with respect to this manual or the Kingdom® software and to the extent permitted by law, IHS
Markit shall not be liable for any errors or omissions or any loss or damage or expense
incurred by an user. IHS Markit reserves the right to modify the Kingdom® software and any
of the associated user documentation at any time.

Acknowledgments
IHS Markit wishes to gratefully acknowledge the contributions of the many client software
testers in preparing the Kingdom® software. The enthusiastic Beta testers, smoke testers,
and staff greatly appreciate their invaluable feedback and contributions.

2017 Confidential
Kingdom Data Management (KDM)
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Getting Started with Kingdom Data Management (KDM)

Catalog Configuration
Create or connect to your KDM catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Create a New Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Specify Database Parameters for the KDM Catalog . . . . . . . . . . . . . . . . . . . . 7
Select Security for KDM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Set Admin Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Connect to an Existing Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
KDM Configuration Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Create Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Update Admin Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Select Global Seismic File Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Security - User Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Purge Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Catalog Builder
Locate and inventory Kingdom projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Add directory locations for Kingdom projects . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Add Kingdom database servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Reasons for failed inventories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
View, Print, and Save Inventory Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Scheduling Catalog Builder

Run Catalog Builder as a Batch Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Schedule a Catalog Builder task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Managing your Kingdom projects and data

Project and data management overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
File menu options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Managing your Project Catalog

Catalog Management options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Managing KDM project groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Group Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Project Management Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Delete Project from Kingdom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Tools Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Event Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Customize the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
KDM Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

© 2017 IHS Markit. All Rights Reserved. v

 Kingdom Projects Currently in Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Viewing and editing Kingdom project data

Data tab overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Data Quality Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Data Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Well Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
2D Seismic Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
3D Seismic Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Interpretation Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Group Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Querying across multiple Kingdom projects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Creating a query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Saving queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Viewing and editing saved queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Viewing query results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Convert, Copy, Compare Projects

Converting Kingdom project databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Copying Kingdom projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Comparing projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Managing your Kingdom seismic files

Project Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Move and Relink Seismic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Relink Seismic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Transfer Data
Transferring data with KDM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Transfer Data with KDM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Select the projects and authors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Selecting data in the OSP Copy Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
OpenSpirit Data Selector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Data Transfer within a Bounding Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Data Transfer report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

vi © 2017 IHS Markit. All Rights Reserved.

 Kingdom® 2017

Kingdom Data Management (KDM)

Overview
Kingdom Data Management (KDM) provides an integrated platform for managing all
information across your Kingdom environment. After creating your Kingdom catalog, you can
use KDM to compare multiple projects, query for key interpretation data, convert projects
between multiple databases, and make unique copies of projects to share with others.
This section contains the following topics:
• Getting Started with Kingdom Data Management (KDM)
• Catalog Configuration
• Catalog Builder
• Scheduling Catalog Builder
• Managing your Kingdom projects and data
• Viewing and editing Kingdom project data
• Convert, Copy, Compare Projects
• Managing your Kingdom seismic files
• Transfer Data
2 © 2017 IHS Markit. All Rights Reserved.
Getting Started with Kingdom Data Management
(KDM)
Note: To ensure data integrity expecially when transferring data, you should always use the
same version of Kingdom and KDM.

1. Create your KDM Catalog

a. Launch Kingdom Data Manager and select Create a New Catalog.
b. Select a database type for the catalog: SQL Server (including Express) or Oracle
c. Enter your login credentials. Your database administrator may need to provide the
login credentials. KDM does not support Windows authentication. You must use SQL
Server authentication.
d. Select a security mode. The default is None.
e. Enter the path to your Kingdom software installation directory.
Your catalog has been created.
2. Locate and inventory your Kingdom projects with Catalog Builder.
a. Click Catalog Builder in the tool bar.
b. In Catalog Builder, select your Search Mode.
c. If your Search Mode is Folders, click Project Locations in the toolbar.
If your Search Mode is Computers, select the computers you want to search.
d. For a Folder Search, add the locations where your Kingdom projects reside and
Close.
e. Select Full as your Inventory Mode.
f. Click Start. Catalog Builder will begin searching for Kingdom projects.
g. When the inventory is complete and your projects are listed in the Catalog Builder,
return to the Kingdom Data Manager window.
3. Add Kingdom projects to your Project Catalog.
a. Click Unassigned Projects in the Kingdom Data Manager toolbar.
b. From the list of unassigned projects, select the projects you want to add to your
Project Catalog.
c. Click Assign. The projects will appear under Kingdom Projects.
Now you’re ready to begin managing your Kingdom data with the Kingdom Data Manager
toolbar.

KDM Keyboard Shortcuts

Alt+Z = Open Catalog

© 2017 IHS Markit. All Rights Reserved. 3

Alt+C = Copy Project
Alt+X = Convert Project
Alt+D = Transfer Project Data
Alt+S = Open in Kingdom
Alt+O = Display Project or Group Data
Alt+P = Open Project Menu
Alt+A = Compare Projects
F1 = Help
F2 = Rename Group
Alt+F4 = Exit Kingdom
Ctrl+F4 = Close Active Window

4 © 2017 IHS Markit. All Rights Reserved.

Catalog Configuration
Create or connect to your KDM catalog
When you launch Kingdom Data Management for the first time, you have 2 options:

Create a New Catalog If you are using Kingdom Data Management for the first time
you need to create a new catalog and then specify the
required parameters for your catalog. The Configuration
wizard will walk you through the required steps.

Connect to an Existing Catalog The application should detect if you have an existing catalog.
However, you may have moved or renamed it. Select this
option if you know where an existing catalog is.

Note: The KDM catalog schema was modified in the 2015 HF1 version to allow for 255
characters for seismic data type names. When you connect to an existing catalog in
KDM version 2015 HF1 or later, the catalog is upgraded and is not backward
compatible with earlier versions of KDM.

See Getting Started with Kingdom Data Management (KDM) for a summary of steps required
to get you up and running with Kingdom Data Management.

What is a Catalog?
A catalog is an inventory of your Kingdom projects. This inventory, or catalog, contains the
metadata of all your Kingdom projects that the Catalog Builder located in the designated
locations (specified file locations, or shared files on multiple computers).
When you launch Kingdom Data Manager for the first time, the Configuration wizard will walk
you through the required configuration steps. After you have created and configured your
KDM Catalog, you can run Catalog Builder to inventory and catalog your Kingdom projects.

© 2017 IHS Markit. All Rights Reserved. 5

Required Configuration Steps
• Specify Database Parameters for the KDM Catalog
• Select Security for KDM
• Set Admin Preferences

Note: These same steps can also be accessed through KDM’s main menu: Tools >
Configuration.

6 © 2017 IHS Markit. All Rights Reserved.

 Create a New Catalog

Create a New Catalog

The first time you launch Kingdom Data Manager (KDM), you will be prompted to create a
new catalog or connect to an existing catalog.
If you do not have an existing catalog, click Create a New Catalog.
Creating a new Catalog requires the following configuration steps:

Specify database parameters Enter your login credentials and database server for SQL
Server Express, SQL Server, or Oracle database.

Select level of security Select a security mode for your catalog.

Set Admin preferences Specify the location of the Kingdom installation folder. By
default Kingdom installs to C:\Program
Files\IHS\KingdomSuite. However, the Kingdom software may
be installed in a different location.

You can review or change any of your KDM Catalog configuration settings through
Configuration Tools. From the Kingdom Data Manager main menu select Tools >
Configuration.

Specify Database Parameters for the KDM Catalog

Tools > Configuration > Create Catalog
Create a New Catalog during the initial configuration or from the Kingdom Data Manager
main menu. Select Tools > Configuration and click Create Catalog.
Select the database type for your KDM Catalog.

SQL Server Express Does not required a user name and password.

SQL Server Requires the system administrator (sa) username and password
for the selected SQL Server instance. If you do not have the sa
credentials, see your database administrator. KDM does not
support Windows authentication. You must use SQL Server
authentication

Oracle Requires the system administrator (sa) username and password

for the selected Oracle instance. If you do not have the sa
credentials, see your database administrator.

SQL Server Express

Create a new KDM catalog during the initial configuration or from the Kingdom Data Manager
main menu. Select Tools > Configuration.

To create a KDM Catalog in SQL Server Express:

1. In the Create New Catalog dialog box, select SQL Server as the Database type.

© 2017 IHS Markit. All Rights Reserved. 7

Create a New Catalog

2. Click the down arrow beside Database instance and select the SQL Server Express
instance.
The instance will be in the form <Computer Name>\SMTKingdom.
3. As soon as you select the SQL Server Express instance, the User name and Password
fields disappear.

Note: If your SMTKingdom instance of SQL Server Express is not displayed, then type it
in: <ComputerName>\SMTKingdom. You will then need to enter the following user
name and password:

User Name: SMTKingdom

Password: $ei$micMicro

The password is case sensitive.

4. Enter a name for the new catalog.

5. Click Next to Select Security for KDM.

8 © 2017 IHS Markit. All Rights Reserved.

 Create a New Catalog

SQL Server
Create a new KDM catalog during the initial configuration or from the Kingdom Data Manager
main menu. Select Tools > Configuration and click Create Catalog.
To create a KDM Catalog in SQL Server:
1. In the Create New Catalog dialog box, select SQL Server as the Database type.
2. Connect by System Account—to create the Kingdom Catalog database you need
administrative rights to the SQL Server. Contact your database administrator if you do not
have sufficient permissions.
• Click the down arrow beside Database instance and select the SQL Server instance
(the host server).
• Enter your administrative user name and password. KDM does not support Windows
authentication. You must use SQL Server authentication.

Note: If your server broadcasting is turned off, your SQL-Server host server will not be
included in the displayed list. If this is the case, type in the name of the SQL-Server
host server.

3. Create new database for your catalog

© 2017 IHS Markit. All Rights Reserved. 9

Create a New Catalog

- Catalog name—enter the name of the new database which will house the KDM
inventory information.
- New user - enter the name for the default user of this new database.
- Password—enter the password for the new user.
- Confirm Password -re-enter the password for the new user.
• Next—click Next to Select Security for KDM for the KDM Catalog.

Note: You may see the message “Cannot find any Oracle clients” on the bottom
status bar of the Create Catalog dialog box. This message only indicates that
the presence of a local Oracle client installation is not detected. This will not
affect the creation of your SQL-Server database.

Oracle
Before configuring your Oracle KDM Catalog database, the following steps need to be
performed on the selected Oracle database (instance) by the Oracle database administrator.
• Create TableSpace—(for example KDMCatalog with recommended 4GB size)
• Create a User Account (User Name).
• Grant connect, resource to the user.
• Create user Password for the default tablespace KDMCatalog temporary tablespace
TEMP.
Once your Oracle DBA has created the required tablespace and login credentials, you can
designate it as your KDM Catalog.
To create a KDM Catalog in Oracle:
1. During the initial configuration or from the Kingdom Data Manager main menu select
Tools > Configuration.
2. Database Type—in the Create New Catalog dialog box, select Oracle as the Database
type.
3. Connect by System Account—you will need to get the Oracle database, assigned user
name and password from the Oracle DBA to connect.
• Click the down arrow beside Database instance and select the Oracle instance (the
host server).
• Enter your user name and password.
4. Click Test Connection to test the ability of your system to connect to the specified Oracle
database instance, User Name and Password.
5. After a successful connection to the Oracle instance, the KDM Catalog information will
appear in the bottom half of the Create Catalog dialog box.

10 © 2017 IHS Markit. All Rights Reserved.

 Create a New Catalog

6. Click OK to proceed to the next step in the configuration: Select Security for KDM.

Select Security for KDM

Tools > Configuration > Set Security
If you are creating your KDM Catalog for the first time, select your Security setting after you
have entered the database parameters. The default is None which gives all users full
administrative privileges.
• KDM Users—cannot run the Catalog Builder, or change any Configuration settings.
• KDM Administrator(s)—have full access to the Configuration tools.
You can change your Catalog Security from the Configuration Tools accessed from the
Kingdom Data Manager.
From the Kingdom Data Management main menu select Tools > Configure > Set Security.

© 2017 IHS Markit. All Rights Reserved. 11

Create a New Catalog

• None—select to provide no security mode for KDM. None is the default selection which
gives full administrative privileges to all KDM users.
• KDM Security—select to assign KDM users administrative or user privileges.

Note: After you have created your users and assigned privileges, you will want to delete
the initial default login names and passwords to maintain security.

Administrator default user name / password = kdmadmin / kdmadmin

KDM User default user name / password = kdmuser / kdmuser

Set Admin Preferences

In the Admin Preferences dialog box, specify the location of the Kingdom installation folder.
To change the installation directory location, select Tools > Configuration > Update Admin
Preferences.
Browse to your Kingdom software installation directory if the field is blank or needs to be
updated. The version of Kingdom Data Management and Kingdom must be the same.
The default installation directory for Kingdom is the following:
C:\Program Files\IHS\KingdomSuite\Kingdom DM [version]

12 © 2017 IHS Markit. All Rights Reserved.

 Connect to an Existing Catalog

Connect to an Existing Catalog

On startups after the initial set up, the database KDM connects to is the last database used.
However, if KDM cannot find the existing catalog, the Start Menu opens.
If you know that you have a catalog, click Connect to an Existing Catalog and browse to the
existing catalog.
The KDM database schema is not backwards compatible. After you upgrade to a new version
of Kingdom Data Management, your previous KDM Catalog database will be upgraded to the
latest version.

Note: If you have more than one Kingdom Data Manager database, you can select a
different database through the Configuration Tools. From the Kingdom Data
Manager main menu select Tools > Configuration and select Update Admin
Preferences.

To connect to an existing catalog:

1. Select MS SQL Server or Oracle as your database type.
2. Enter the database information.
3. Click OK to connect to the selected catalog.

© 2017 IHS Markit. All Rights Reserved. 13

KDM Configuration Tools

KDM Configuration Tools

Tools > Configuration
The Configuration Tools provides the following options:

Create Catalog Create a new KDM catalog. You can change to a different catalog
if you have more than one.

Set Security Change your security setting. The default setting is None (all users
have administrative privileges)

Update Admin Connect to a different KDM Catalog, change the Kingdom

Preferences installation folder location, view security mode and Global seismic
folder locations.

Set Global Seismic Set a global seismic file location when transferring seismic data
between Kingdom projects. The seismic files will be written to the
set location inside project specific folders

User Admin Create (edit) users and set user or administrative privileges for
KDM users.

Purge Catalog Delete the contents of your catalog. Two levels of Purge are
available: Partial Purge and Complete Purge

14 © 2017 IHS Markit. All Rights Reserved.

 KDM Configuration Tools

Create Catalog
Tools > Configuration > Update Admin Preferences
Create a catalog from the Kingdom Data Manager main menu.
You can have more than one KDM Catalog if desired. To log in to a different catalog select
Tools > Configuration > Update Admin Preferences.
Catalogs can be in a SQL Server Express, SQL Server, or Oracle database. For SQL Server
Express, select MS SQL as your database type.

Note: KDM does not support Windows authentication for SQL Server databases. You must
use SQL Server authentication.

See Specify Database Parameters for the KDM Catalog.

© 2017 IHS Markit. All Rights Reserved. 15

KDM Configuration Tools

Update Admin Preferences

Tools > Configuration > Update Admin Preferences
The Admin Preferences are all of the initial configuration settings when you created your
KDM Catalog.
If you have more than one KDM Catalog, you can connect to a different catalog through the
KDM Configuration Tools. You can also change the Kingdom installation folder, security mode
or global seismic folder locations.
C:\Program Files\IHS\KingdomSuite\TKSversion

16 © 2017 IHS Markit. All Rights Reserved.

 KDM Configuration Tools

Database Type—enter the database information for the KDM Catalog to which you want to
connect. See Connect to an Existing Catalog.
Other Settings—includes the following:

Kingdom installation Folder Displays the path to the installation folder. To change the
path, click Browse.

Security mode Displays the selected mode. To change it, return to the
Configuration dialog box and select Set Security.

© 2017 IHS Markit. All Rights Reserved. 17

KDM Configuration Tools

Global seismic folder All selected global seismic folder locations are listed
locations including the set priorities and threshold - or capacity. Click
Select Locations to make changes.

Select Global Seismic File Locations

KDM’s Data Transfer tool provides bulk Kingdom to Kingdom data transfer ability. The default
location for the Kingdom seismic files (*.1 and *.ksd) is the individual project folders.
However, you can also set a global seismic file location when transferring seismic data. The
seismic files will be written to the set location inside project specific folders.
If the Global Seismic File Locator is set, this location replaces the Kingdom project folder as
the default location for seismic files when using the Data Transfer tool.

To add a global seismic file location:

1. Click Add and browse to the first global seismic file location. The file path and name will
appear in the dialog box.
The number to the left of the file is the maximum capacity permitted on the selected
drive. Once the space used on the selected drive reaches this number, further seismic
files will be saved to the next specified location. The default capacity is 90%.
2. Change the maximum capacity if desired. Select the location, and then adjust the
maximum capacity %(Percent) by either entering a value in the % field, or by selecting the
desired percent using the arrows. Click Update to see the change.
3. Add more locations. Click Add and browse to additional global seismic file locations.
4. To re-order a location select it in the list and then use the large up and down arrows to
change its position.

18 © 2017 IHS Markit. All Rights Reserved.

 KDM Configuration Tools

5. To remove a location from the list, select the location and click Remove.

Note: Once you have set global seismic file locations, all seismic files transferred with
the Data Transfer tool will be written into this location. To change back to the
default of writing the seismic files to the Kingdom project directory, return to the
Global Seismic File Location dialog box and Remove all locations.

Security - User Administration

You have two KDM Security modes: None, or Kingdom Data Management Security. None is
the default which gives all users administrative privileges. See Select Security for KDM.
If you selected Kingdom Data Management Security, as administrator you can manage the
KDM users.
• KDM Users—cannot run the Catalog Builder, or change any Configuration settings.
• KDM Administrator(s)—have full access to the Configuration tools.

Note: If you selected Kingdom Data Management Security you will be required to Logon
if you want to perform administrative tasks.

After you have created your users and assigned privileges, you will want to delete the initial
default login names and passwords to maintain security.
• Administrator default user name / password = kdmadmin / kdmadmin
• KDM User default user name / password = kdmuser / kdmuser

Note: If you created your catalog with OpenKingdom Domain, the default user name /
password combinations will be the following:

okdadmin / okdadmin
okduser / okduser

© 2017 IHS Markit. All Rights Reserved. 19

KDM Configuration Tools

The following User Administration options are available from the Administration menu or by
right clicking a user name or role:
• Change Password
• Add User
• Delete a User
• Assign Admin—assign administrative privileges to a user
• Delete a Role—remove administrative or user privileges from a user

Logon
If you have been assigned a user logon and password for Kingdom Data Management, the
Logon dialog box will open each time you launch the application or execute an Administrative
task.
• KDM Users—cannot run the Catalog Builder, or change any Configuration settings.
• KDM Administrator(s)—have full access to the Configuration tools.
Enter your username and password and click Logon to continue.
The default username / passwords are kdmadmin / kdmadmin for administrators, and
okduser / okduser for users.
Security settings are set in the initial configuration and registration process. To change
the security settings, select Configuration > Change Security Mode. See Select
Security for KDM for information on security settings.

Purge Catalog
Tools > Configuration > Purge Catalog
Purge will delete the contents of the KDM Catalog.
In the KDM Configuration Tools, select Purge Catalog.
The following Purge Modes are available:

20 © 2017 IHS Markit. All Rights Reserved.

 KDM Configuration Tools

• Complete Purge—deletes all of the contents of your Catalog including the tree structure,
server registration and saved queries. Only your empty Kingdom Projects node will
remain.
• Partial Purge—will keep the following:
- Project Catalog tree structure, including the project names.
- Project summaries
- Server registration
- Saved queries
All other data in the Catalog will be deleted including all detailed project information.

Note: After a partial purge, the word (Partial) will be appended to project names on the
Project Catalog.

Warning: A Purge command is irreversible. The projects themselves are not deleted, but
the KDM Catalog is deleted including the metadata for all projects not assigned to
the Project Catalog.

© 2017 IHS Markit. All Rights Reserved. 21

KDM Configuration Tools

22 © 2017 IHS Markit. All Rights Reserved.

Catalog Builder
Locate and inventory Kingdom projects
After you have created and configured your KDM Catalog, you can locate and inventory
Kingdom projects with the Catalog Builder. The Catalog Builder will find projects in multiple
directory locations and can read SQL Server Express, SQL Server, or Oracle project
databases.
When Catalog Builder inventories a project, it extracts the project metadata from the Kingdom
project database (wells, seismic surveys, and interpretation data—contours, faults, grids,
horizons and formation tops) and stores the metadata in the KDM Catalog.

The Catalog Builder Toolbar provides the following tools:

Project Locations Add the directories that contain the Kingdom projects. Select the file
directories or computer(s) that have Kingdom projects.

Database Servers Kingdom projects that have SQL Server or Oracle databases need to be
registered. You will need the instance name, user name, and password for the
servers. SQL Server Express databases do not need to be registered.

Inventory Report View, Print, and Save Inventory Report. An Inventory Report is available after
Catalog Builder has located and inventoried your Kingdom projects.

© 2017 IHS Markit. All Rights Reserved. 23

 Start Start the inventory of your projects. The results will be displayed in the main
Project panel.
If no results are displayed, check the bottom status bar. If the computer(s) you
specified to Catalog Builder are down or not shared, then the following
message will appear in the bottom status bar: <Computer Name > is down
or has no shared folders

To inventory your Kingdom projects:

1. Launch the Catalog Builder from the Kingdom Data Management main window. Select
Tools > Catalog Builder.
2. Add directory locations for Kingdom projects—if Folders is your search mode, select the
file directories that have Kingdom projects.
3. Add Kingdom database servers—if any of your Kingdom projects are in SQL Server or
Oracle databases you need to input the user name and password information.
4. Select a Search Mode and Inventory Mode:

Search Mode Options include:

• Folders—click Project Locations on the toolbar and add Kingdom
project directories.
• Computers—select computers with shared folders on the network.
All computers on your network will be displayed.

Inventory Mode Options include:

• Project List Only—locates all Kingdom projects on the designated
drives and list them in the right Project panel. Catalog Builder does
not inventory the projects. All folders with a .tks file are listed, but have
Not Inventoried as the Status.
• Partial—inventories each project, but does not inventory formation
tops. If formation tops are not required, excluding formation tops will
save time and space.
• Full—inventories each project. The success of the inventory—
SUCCEED or FAILED—is listed beside each project.

5. Click Start to begin the inventory.

6. View Search Results and Inventory Report. If you have projects that failed to inventory,
see Reasons for failed inventories.
7. Assign Projects to your Project Catalog.

Add directory locations for Kingdom projects

Select the file directories or computer(s) that have Kingdom projects. After you have selected
the locations, you can search and inventory all directories or computers at once, or you can
select to search and inventory just specific locations.

24 © 2017 IHS Markit. All Rights Reserved.

Note: The Catalog Builder can only read shared file locations.

From the Kingdom Catalog Builder, click Project Locations on the Taskbar.

Add click to open the Browse For Folder dialog box and navigate to a directory
with the Kingdom projects you want to inventory.

Remove Select a location (row) and click Remove.

Shared Environment Considerations

In shared environments, we recommend that you define your search locations with the
Universal Naming Convention (UNC) path beginning at the network, or domain level. A
search location defined by the full UNC path will identify the specific computer by name
thereby giving each Kingdom project a unique path and identification.

Add Kingdom database servers

Kingdom Catalog Builder requires database server information to connect to the project
databases. If a server is not registered, Catalog Builder will not be able to open the
connection necessary for an inventory of projects located on the server. Prior to running
Kingdom Catalog Builder, the list of servers should be updated to include all available servers
and ensure a successful inventory of all desired projects.
Before you can register a new server instance, you will have to obtain the server instance
name, user name, and password information from the database administrator.

© 2017 IHS Markit. All Rights Reserved. 25

SQL Server Express
The SMTKINGDOM SQL Server Express instance does not need to be registered. This
applies to both Auto SSE and Manual SSE projects.
The name of this instance is <computer name>\SMTKINGDOM. The following username and
password is coded into the instance:
- Username: smtkingdom
- Password: $ei$micMicro

SQL Server Windows Authentication

Kingdom Data Management requires SQL Server authentication. If you log in to your projects
with Windows authentication, you will need to get the SQL Server authentication user name
and password from the database administrator and enter these credentials in Catalog
Builder > Database Servers.
1. From the Catalog Builder toolbar, click Database Servers.
.

2. Select your server type: SQL Server or Oracle.

3. Click the down arrow and select the server instance.
4. Enter your user name and password.
5. Click Test Connection to confirm connectivity with the server.

26 © 2017 IHS Markit. All Rights Reserved.

6. If the test is successful, click Add to register the database connection.
• Remove—select to remove the registration information for the instance or user
highlighted in the Kingdom Database Servers tree. Note that this does not affect the
actual database.

Note: The SMTKingdom instance of SQL Server Express has the following username
and password pre-configured. The password is caps sensitive:

Username: SMTKingdom
Password: $ei$micMicro

Note: If the Catalog Builder was unable to connect with the server using the information
entered, then a Database Connection Unsuccessful message appears.
Check that the information entered is correct, that the server is turned on, and
retry.

Reasons for failed inventories

To see the reason a project failed to inventory, double-click on the word Failed to open the
error message. You can also open the Inventory Report. In the Catalog Builder toolbar, click
Inventory Report.
The most common reasons that a project fails to inventory are the following:

Password or Database is not Available Error The database cannot be accessed.

Files are Missing Error The project (*.tks) file or database

(<project name>.xml) file cannot be found

TKS Version Error The project is in a version of Kingdom

software earlier than 7.5.

Microsoft Access Projects KDM cannot inventory projects with an

Access database. You will have to
convert the database first by opening in
the current version of Kingdom.

If the status is Not Inventoried, this is not a failed inventory. It is a choice you made by
selecting List Only as the inventory mode. The project names and paths are listed, but the
metadata is not extracted.

Password or Database is not Available Error

To successfully inventory Kingdom projects, all the database servers that hold Kingdom
projects must be registered. If the database servers cannot be accessed, the Password or
Database is not Available error opens.
For a successful inventory of all Kingdom projects, ensure that all servers on which Kingdom
projects are stored are registered.

© 2017 IHS Markit. All Rights Reserved. 27

Click Database Servers in the toolbar to register additional databases.

Files are Missing Error

If a Kingdom project directory is missing a required file, or a required file is corrupted, the
<project name and path>.xml Files are missing error message will be displayed:
The Catalog Builder has found some inconsistency with the <project name>.tks
file and the database pointer file (<project name>.xml). Open the project
folder and examine your files for possible naming errors or missing files.

TKS Version Error

If Kingdom Data Manager tries to inventory a Kingdom project in a Kingdom software version
earlier than 7.5, the TKS Version error message displays.
To inventory this project, open it with a Kingdom software version 7.5 or later, and reinventory
using the Catalog Builder.

View, Print, and Save Inventory Report

The Catalog Builder Inventory Report lists the following information for each project
inventoried for the last search operation:

Project file location Displays the full path and file name.

Database type SQL Server or Oracle. SQL Server Express projects are listed
as SQL Server

Inventory status Successful or Failed

Search mode Folder or Computer

Search date includes date mm/dd/yyyy and time hh:mm:ss am or pm

Search message Gives a Succeed to Register message or the error message if

the project inventory status was Failed.

You can filter by Status, Search mode, or Database type. Click the down arrow beside the
desired field(s), select the item and you want to search by and click Search.
You can then Print, and/or Export the report (to Excel, or as a PDF) by clicking the
corresponding icon in the toolbar.

28 © 2017 IHS Markit. All Rights Reserved.

Scheduling Catalog Builder
Run Catalog Builder as a Batch Program
The KDM Catalog Builder allows you to run an inventory immediately as a batch program.
You can also schedule to run the batch program a single time or multiple times at a future
date and time through the Schedule a Catalog Builder task.

Note: .Before you can run Catalog Builder as a batch program, you must have the search
locations for your Kingdom projects defined. From the Catalog Builder main menu,
select Project Locations. Then Add the desired folders or networks to the list.

To run the batch program immediately on the selected search locations:

1. Select Start and search for cmd to open a DOS Command window..
2. Beside the command prompt, enter the path to the KDMCatalogBuilder.exe file in the
KDM installation directory with the entire path enclosed in quotation marks. After the
quotation marks, enter <space>-f for folder scouting mode. Enter <space>-n for a
network scouting mode.
“C:\Program Files\IHS\KingdomSuite\Kingdom DM
[version]\KDMCatalogBuilder.exe” -f
“C:\Program Files\IHS\KingdomSuite\Kingdom DM
[version]\KDMCatalogBuilder.exe” -n
3. After entering the path and the file or network specification, press Enter. The Catalog
Builder will begin inventorying projects in the defined location(s).

Tip: Before running the KDMCatalogBuilder.exe, be sure to register all database servers that
contain Kingdom projects. If the application cannot access an external database such
as Oracle, or SQL Server, the scouting operation will be suspended until the user name
and password information is entered, or until the login task is canceled.

© 2017 IHS Markit. All Rights Reserved. 29

Schedule a Catalog Builder task

Schedule a Catalog Builder task

The Scheduled Task Wizard allows you to set the parameters for the selected task, in this
case, a scheduled inventory with Catalog Builder. Follow the wizard and select Open the
Properties dialog for this task when I click Finish in the final step of the wizard to set the
default inventory mode.

Note: Before the KDM Catalog Builder batch program can successfully run, you must
specify your default inventory mode as a folder scout (-f) or network scout (-n) through
the Properties window of the Task Wizard. If this step is omitted, the batch program
will not run.

Note: Before you can run KDM Catalog Builder in folder scouting mode, you must have the
search locations for your Kingdom projects defined. From the Catalog Builder main
menu, select Project Locations. Then Add the desired folders or networks to the list.

To specify the settings for the KDM Catalog Builder in the Microsoft Windows Scheduler
follow the steps below to open and run the Scheduled Task Wizard. These instructions are
for a Windows 7 OS.
1. Open up Task Scheduler by either typing “task” into the Start Menu search bar, or by
opening All Programs > Accessories > System Tools > Task Scheduler.

30 © 2017 IHS Markit. All Rights Reserved.

 Schedule a Catalog Builder task

2. Under Actions in the right panel, select Create Basic Task.

3. Enter a name for the task and a description (optional) and click Next.
4. In Task Trigger, select when you want the task to start and click Next.
5. Complete the time information for the task trigger as prompted and click Next to the
Action page.
6. In Action, select Start a program and click Next.
7. In Start a Program, browse to the KDMCatalogBuilder.exe file in the Kingdom DM
installation directory.
8. Click Open, and then Next.
9. In Summary, check to Open the Properties dialog for this task when I click Finish.
10. Select the Actions tab to set your default scout setting as folder (-f) or network (-n).

© 2017 IHS Markit. All Rights Reserved. 31

Schedule a Catalog Builder task

11. Select the KDMCatalogBuilder Action and click Edit.

12. In the Add arguments text field, type -f for folder inventory mode or -n for network
inventory mode. Click OK.

You can also view the set parameters of the scheduled task in the other tabs of the Properties
window, and change them as required.
For more information on scheduling tasks, refer to the Microsoft Windows Help and Support
Center:

32 © 2017 IHS Markit. All Rights Reserved.

Managing your Kingdom projects and data
Project and data management overview
After you have completed the Catalog Configuration, you can begin managing the Kingdom
projects in your Project Catalog. Launch Kingdom Data Management by one of the following
methods:
• Double click the Kingdom Data Management icon on your desktop.
• Select Start > Programs > IHS Kingdom [version] > Kingdom Data Management
[version].

Note: To ensure data integrity, especially when transferring data, make sure that your
version of Kingdom and KDM are the same.

Each of these methods opens the Kingdom Data Manager window and displays the Project
Catalog. The top level of your Project Catalog is labeled Kingdom Projects.

Note: To rename the top level, right click the name in the tree and select Rename. You can
rename this node on the tree but you cannot delete it.

© 2017 IHS Markit. All Rights Reserved. 33

The KDM main menu
The KDM main menu includes the following:

File Options include update the Kingdom Data Management application,

review your license status, open your project catalog and exit the
application.

Group Provides options for managing project groups you created in your Project
Catalog. Options include New, Open, Rename, Details, Assign Project to
Group, Show Unassigned Projects, and Delete

Projects Provides options for managing Kingdom projects in your catalog. Options
include Project Explorer (move and relink seismic tool), Convert, Copy,
Compare, Transfer Data, Refresh, Remove, Open in Kingdom and
Delete.

Tools Tools include Configuration (administration and configuration of your

KDM environment), the Catalog Builder, the Query tool, Event Viewer,
and access to Kingdom’s DbAdmin tool.

Reports KDM Reports are printable and include the following: data transfer
transactions, the Inventory Report from the Catalog Builder, and Kingdom
projects currently in use.

Kingdom Data Manager toolbar

The most commonly used project and data management tools can also be launched from the
Kingdom Data Manager Toolbar:

Convert Convert project database from one database type to another.

Kingdom project databases can be SQL Server, SQL Server
Express, or Oracle.

Copy Makes an identical copy of a Kingdom project. All project files and
the database are copied to a designated location and can be added
to the Kingdom Project Catalog

Compare Compare projects for the similarity or differences of selected data

objects. Available items to compare are wells, 2D and 3D seismic,
and all interpretation items.

34 © 2017 IHS Markit. All Rights Reserved.

 Transfer Data Kingdom is an OpenSpirit-enabled data store. Kingdom Data
Manager’s Transfer Project Data tool enables one-step Kingdom to
Kingdom data transfer without the need for manual file transfer.
This transfer tool transfers well, seismic and interpretation data
between Kingdom projects and allows you to convert unit,
coordinate, and attribute values on the fly based on the
requirements of the destination (target) project.

Catalog Builder Locate and inventory Kingdom projects. The metadata from the
inventoried projects is added to the Kingdom Project Catalog.

Query Query across multiple Kingdom projects

Unassigned Projects View the list of projects inventoried with the Catalog Builder, but not
yet assigned to your Project Catalog.

© 2017 IHS Markit. All Rights Reserved. 35

File menu options

File menu options

The following options are available on the File menu.
• Update Kingdom Data Management— launch the Update Manager to install a
downloaded Hotfix or ServicePAK. Kingdom Data Management will need to close before
the Update Manager can launch.
• License—monitor the status and availability of current licenses or select the License
Search Sequence as Standalone or Network.
• Open Catalog (Alt+Z)—display your Project Catalog. Only projects that you have
assigned to the catalog will be displayed. You may have some unassigned projects
inventoried by the Catalog Builder, but not yet assigned to your Project Catalog.

License
The License item contains the following:
License Status—determine the availability of licenses for Kingdom Data Manager and
monitor the status of the current network or standalone licenses.
From the Kingdom Data Manager main menu, select File > License > License Status. The
License Status dialog box displays the availability of licenses for Kingdom Data
Management. You can monitor the status of the current network or standalone licenses.
For details, access the Kingdom Software Help Topics from Kingdom and select
Licensing.
License Search Sequence—select a standalone or network license search.From the
Kingdom Data Manager main window menu bar, select File > License > License Search
Sequence to specify either a Standalone license search or a Network Edition license search.
The License Search Sequence dialog box gives you the following options:
• Get License from My Computer (Standalone Edition)—the Standalone Edition
requires a Sentinel plug on a USB or parallel port on the computer. If a Sentinel is not
found, then Kingdom Data Management will give you the option to search the network for
a license.
• Get License from the Network License Server (Network Edition)—Kingdom Data
Management will search the network for the license. If no network license is found, the
Specify Kingdom Network License Server dialog box will open.
If Kingdom Data Management is unable to connect to a network license server, the Kingdom
Software will shut down. See Initial Startup of Kingdom using a Network License in the
Kingdom Installation Guide.

36 © 2017 IHS Markit. All Rights Reserved.

Managing your Project Catalog
Catalog Management options
By default the main group in your Project Catalog is titled Kingdom Projects. You can create
groups under Kingdom Projects to organize your projects into whatever context suites your
environment: geographic region; business branch; network location are examples.

Group Management Right-click an existing group or from the main menu select
Groups.

Project Management Right-click an existing project or from the main menu select
Projects.

Tools Menu From the main menu select Tools.

KDM Reports From the main menu select Reports.

© 2017 IHS Markit. All Rights Reserved. 37

Managing KDM project groups

Managing KDM project groups

Tip: All of the group menu options are also available by right clicking a group in the Project
Catalog.

A Group is simply a collection of projects. The common element is defined by you. Groups
can be defined by whatever context suites your environment: geographic region; business
branch; network location are examples.By default the main group in your Project Catalog is
titled Kingdom Projects.
The Groups menu provides the following options:

New Enter a name for the group and a description. A group folder is created
and listed in your project catalog in its alphabetic position. To change
the position just drag and drop to a different place in the tree.
After the group folder is created, you can drag and drop the projects
into the folder.

Open Opens the data tabs for the selected group. The data tabs display a
data summary, an inventory of wells, 2D seismic, 3D seismic, and
interpretation objects contained in the projects in the group.
You can also view the data summary of a project by right-clicking on the
project and selecting Open.

Rename Enter a new name for the group.

Details View an extensive list of information about all projects in the selected
group, including group data item totals for countable fields such as files
sizes, number of interpretations, number of wells, number of surveys,
etc.

Add Project to Group You can add a project to a group in 2 ways:

• Right-click on the group folder and select Add. Then browse to a
Kingdom project *.tks file and assign the project to your active Project
Catalog. The result is the same as using Catalog Builder to inventory
a single project.
• In the Project Catalog tree, drag and drop the projects one-by-one
into the group folder.

Unassigned Projects View the list of Kingdom projects inventoried by Catalog Builder but not
yet assigned to a group in the active Project Catalog.
You can add an unassigned project to your catalog in 2 ways:
• Drag and drop the project from the Unassigned Projects dialog box to
the designated group in the Project Catalog tree.
• Select one or more unassigned projects and then beside Select
Group select the group and click Assign.

38 © 2017 IHS Markit. All Rights Reserved.

 Managing KDM project groups

Delete Group You can rename but not delete the top level group Kingdom Projects.
You cannot delete a group that still has projects assigned to it. You
need to remove, or delete any projects from the selected group before it
can be deleted.
If you choose Projects > Delete Project from Kingdom, you will
delete the actual project.

Group Details
From the Project Catalog window, select a group, and click Details to open the Group
Details dialog box
The Group Details Customize tab lists all of the possible data items available.

Group Details - View tab

The Group Details View table displays the details and totals of data objects selected in the
Customize tab. These include totals for countable fields such as files sizes, number of
interpretations, number of wells, number of surveys, etc.
.

To export the data to an Excel.xlsx file or a text.csv file:

1. Check the box beside each record to export, or click All.
2. Click Export to select individual records.

Group Details—Customize
The Customize tab in the Group Details dialog box displays a list of data items that can be
displayed in the View tab for the selected group. The list of data items are listed in the figure
below:

© 2017 IHS Markit. All Rights Reserved. 39

Managing KDM project groups

Select the data items you want to view and click Apply. Then click the View tab.

40 © 2017 IHS Markit. All Rights Reserved.

 Project Management Options

Project Management Options

Tip: All of the project menu options are also available by right clicking a project in the Project
Catalog. The Projects menu is active when a project is selected in the Project Catalog.

From the Kingdom Data Manager main window, choose Projects to select one of the
following project operations:
Projects Menu Options

Open Display detailed tables of the project’s wells, 2D, 3D, and
interpretation. Some well data can be edited. A summary of the
project data is also available.

Project Explorer Display the current directories and files for the project. This tool
is especially useful for managing seismic files: Relink, Move and
Relink.

Convert Convert project databases from one database type to another.

Kingdom project databases can be SQL Server, SQL Server
Express, or Oracle.

Copy Make an identical copy of a Kingdom project. All project files and
the database will be copied to a designated location and
database instance. The copied project can then be added to the
Kingdom Project Catalog.

Compare Display the similarity or differences of selected data objects.

Available items to compare are wells, 2D and 3D seismic, and
all interpretation items.

Transfer Data Kingdom Data Manager’s Transfer Project Data tool enables
one-step Kingdom to Kingdom data transfer without the need for
manual file transfer. This transfer tool transfers well, seismic and
interpretation data between Kingdom projects and allows you to
convert unit, coordinate, and attribute values on the fly based on
the requirements of the destination (target) project. between
Kingdom projects.

Reinventory Project Catalog Builder will reinventory the selected project. All project
data will be updated.

Remove Project from Group The project will be removed from the group and added to the
Unassigned Projects list.

Remove Project from The project will be completely removed from the catalog. The
Catalog actual Kingdom project will not be affected.

© 2017 IHS Markit. All Rights Reserved. 41

 Project Management Options

Projects Menu Options

Open in Kingdom Open the Kingdom project with the version of Kingdom software
specified during configuration of your Kingdom Data
Management environment.

Delete Project from Kingdom Delete the project folder and database of the selected project.
External seismic files for this project are not deleted.

If the project is open in Kingdom, you cannot execute the following project operations: Copy,
Convert, Move and Relink Seismic, Delete. A message will tell you the Windows user in the
project and the workstation on which the project is open in Kingdom.
To Copy or Convert Kingdom projects with SQL Server or Oracle databases, the database
login account must have Create View and Create Table permissions.

Delete Project from Kingdom

From the Kingdom Data Manager main window, choose Projects > Delete Project from
Kingdom.

Warning: This will delete the entire Kingdom project (the project files and the database) not
just the project metadata in the Project Catalog. Proceed with caution.

To delete a Kingdom project, you must check the Confirm delete box and specify if you want
to delete local seismic.

Shared Seismic Warning

If other project(s) use the seismic of the project you have selected to delete, you will not be
able to delete the project at this time. The Shared Seismic dialog box opens and lists the
name and path of all inventoried Kingdom projects using the seismic.

Note: Kingdom Data Manager will only list projects inventoried by KDM Catalog Builder. If a
project has not been inventoried, it will not appear on this list, and deletion of the
selected Kingdom project will affect all interpretations associated with the shared
seismic data.

42 © 2017 IHS Markit. All Rights Reserved.

 Project Management Options

• If this project is sharing seismic to another project you have the following options:
a. Remove the share in the listed project from the Kingdom main menu.
From the Kingdom main menu select Surveys > Survey Management > Sharing.
b. If you want to keep the child project, relink the child project to the source seismic files
through Kingdom Data Manager. See Relink Seismic.
• Click OK to proceed (if there are no shared projects) or exit.

Linked Seismic Warning

If other project(s) are linked to the seismic of the project you have selected to delete, you will
not be able to delete the project at this time. The Linked Seismic dialog box opens and lists
the name and path of all inventoried Kingdom projects using the seismic. In other words, the
project you have selected is the parent project to other projects. Deleting the seismic will
affect interpretations in the other projects.

Note: Kingdom Data Manager will only list projects inventoried by KDM Catalog Builder. If a
project has not been inventoried, it will not appear on this list, and deletion of the
selected Kingdom project will affect all interpretations associated with the linked
seismic data.

© 2017 IHS Markit. All Rights Reserved. 43

Project Management Options

The Linked Seismic Report gives you two options:

1. Choose not to delete the local seismic files as you delete this project. The seismic
files linked to other projects will remain intact. Interpretations in the child projects will not
be affected.
2. Use Kingdom software to remove the seismic from these projects then come back
to delete the project and local seismic.
• Click OK to exit the Linked Seismic Report dialog box.

Files Not Deleted

The Delete Kingdom Project utility will not delete the following files in the Kingdom project
folder or external to the project folder:
• Files created by the author
• Project files relocated in folders created by the author
• Seismic files when specified
• External author folders

44 © 2017 IHS Markit. All Rights Reserved.

 Tools Menu

Tools Menu
The Tools menu includes the following options:

Configuration Review or set your Kingdom Data Management environment

Catalog Builder Locate and inventory Kingdom projects. The metadata from
the inventoried projects is added to the Kingdom Project
Catalog.

Query Build queries to run across multiple Kingdom projects

Event Viewer View the Event Log that records major events or transactions
performed on a project.

DtB Admin The Database Administration tool includes access to the SQL
Server Express Management tool and tools to manually
export a Kingdom project database for database conversion
or project backup/restore.

Event Viewer
From the Kingdom Data Manager main menu select Tools > Event Viewer.
The Event Log records major events or transactions performed at a project level by Kingdom
Data Manager. The major events recorded include the following:
• Copy project
• Convert project database
• Relink seismic
• Move and relink seismic
• Purge catalog
• Delete project from Kingdom

View the Event Log

The View tab in the Event Log dialog box displays the project data items specified in the
Customize tab for all projects for which there are recorded, major events.

© 2017 IHS Markit. All Rights Reserved. 45

Tools Menu

See the Data tab overview for functionality available on all tabs such as sort and export.

Customize the Event Log

Click the Customize tab in the Event Log dialog box to display a list of project items that can
be displayed in the View tab.

Select the data items you want to view and click Apply. Then click the View tab.

46 © 2017 IHS Markit. All Rights Reserved.

 KDM Reports

KDM Reports
From the Kingdom Data Manager main window, choose Reports. The following three
reports are available:
• Data Transfer report
• Kingdom Projects Currently in Use
• Inventory Report

Kingdom Projects Currently in Use

From the Kingdom Data Manager main window, choose Reports > Kingdom Projects
Currently in Use to view a list of all Kingdom projects in your catalog that are currently in
use.
Operations that require Write privileges to the project cannot be executed by Kingdom Data
Management if the project is active, or in use. These include:
• Copy Project
• Convert Project
• Delete Kingdom Project
• Move and Relink Seismic
The Active Kingdom Projects dialog box contains the following two tabs:
Kingdom Projects in Use—View
Kingdom Projects in Use—Customize

Kingdom Projects in Use—View

The View tab in the Active Kingdom Projects dialog box lists all inventoried Kingdom
projects currently in use. You cannot execute operations that require writing to the Kingdom
project while the project is in use.
The figure below illustrates the fields displayed for each Kingdom project currently in use.

© 2017 IHS Markit. All Rights Reserved. 47

KDM Reports

See the Data tab overview for functionality available on all tabs such as sort and export.

Kingdom Projects in Use—Customize

Click the Customize tab in the Active Kingdom Projects to display a list of project data items
that can be displayed in the View tab. Click each data items that you wish to display in the
View tab.

Select the data items you want to view and click Apply. Then click the View tab.

Note: Select an auto-refresh interval greater than 60 seconds. An interval of less than 60
seconds may degrade the performance of Kingdom Data Manager.

48 © 2017 IHS Markit. All Rights Reserved.

Viewing and editing Kingdom project data
Data tab overview
Before you can view and edit data in your Kingdom projects, you must have created and
configured your KDM Catalog, located and inventoried your Kingdom projects with Catalog
Builder, and moved projects from your Unassigned list to your Project Catalog.
See Getting Started with Kingdom Data Management (KDM).
Your Project Catalog is displayed inside the Kingdom Data Manager main window. If your
Project Catalog is not displayed, go to File > Open Catalog.
You can view the data for the entire catalog, a single group, or a single project. Click any
project or group in your Project Catalog and select Group > Open or Project > Open to view
tabbed tables of the following project data. You can also right click any group or project and
select Open.
• Data Summary
• Well Data
• 2D Seismic Data
• 3D Seismic Data
• Interpretation Data

Note: When comparing projects, the Compare tabs also have the Customize and View tabs
described below as well as Sort and Export.

Each data type has 2 tabs:

Customize The Customize tab lists all of the fields for the selected data type: wells, 2D
seismic, 3D seismic, and interpretation. On this tab you select which fields
you want to display in the Views tab.

View The View tab displays the data in columnar format for all of the fields
selected on the Customize tab.

The data tabs include the following functionality:

Sort The columnar data tables—Wells, 2D, and 3D—can be sorted by any column
by clicking in the column header. Click once to sort in ascending order, and
click again to sort in descending order. The default order is ascending by
Project Name.
You can scroll right and left, up and down to view all results.You can also
adjust column widths, and move columns.

© 2017 IHS Markit. All Rights Reserved. 49

 Export Each data category has an Export option. You can export the displayed data
as one of the following:
• Save as an Excel (*.xls) spreadsheet
• Save as a text (*.csv) file
• Open in Excel
You cannot print directly from the data table, however you can export and
then print the exported file.
Before you can export results, you must select the records to export.
• To select all, check the check box in the header row. Uncheck to deselect
all.
• To select individual records, check the box beside each record and click
Export.

QC For Wells, 2d Seismic, and 3D Seismic you have the option to activate or set
your own Data Quality Rules to check the quality of your data.

Paged Results Set the number of results you want to display on a single page.
In the bottom-left corner of the View tab, click the down arrow beside the
page record count. The default is 20. You can display up to 10,000 records
on a single page.
Select the number you want to display and click Go.

Data Quality Rules

Wells, 2d Seismic, and 3D Seismic data tables include the Data Quality Rules option in the
Customize tab which flags data results that fall outside of normally acceptable parameters.
Each data category has a unique set of data items and quality rules:
• Data Quality Rules for Well Data
• Data Quality Rules for 2D Seismic
• Data Quality Rules for 3D Seismic
If you choose to activate the Data Quality Rules option, you can accept the Auto Check
default parameters displayed in the Auto Check Conditions column, or you can set up your
own rules for individual items to flag data that is outside of the set conditions. You can also
exclude specific data items from the quality check by selecting No Rule.

50 © 2017 IHS Markit. All Rights Reserved.

See Data Quality Rules for Well Data, Data Quality Rules for 2D Seismic, and Data Quality
Rules for 3D Seismic for descriptions of the default or auto check conditions for each data
type.

Data Summary
The top data tab for the selected project or group is the Summary tab which gives a numeric
breakdown of the following data categories:
• General (for single projects only)
• Culture Information
• Interpretation Information
• Seismic Information
• Well Information
None of the summary information is editable.
See the Data tab overview for functionality available on all tabs: sort, export, data quality
rules, and paged result options.

© 2017 IHS Markit. All Rights Reserved. 51

Well Data
You can view the data for the entire catalog, a single group, or a single project. Click any
project or group in your Project Catalog and select Group > Open or Project > Open.

Tip: You can also right click any group or project and select Open.

Click the Wells tab.

Customize your Well Data Table

Click the Customize tab to display a list of well data items that can be displayed in the data
table and to apply a quality check to the existing results. See Data Quality Rules for Well
Data.

The Wells Customize tab lists the available data items in the left column. To display all items,
check the box beside the column header Data Items. Check again to deselect all items.

52 © 2017 IHS Markit. All Rights Reserved.

Data Quality Rules for Well Data

When activated, the Data Quality Rules option automatically checks

the quality of the data and highlights data that is outside of the specified acceptable range.
Not all data items have an associated Data Quality Rule.
If any data values fall outside of the acceptable range as defined by the Auto Check
Conditions or by rules that you create, then these values will be highlighted in yellow in the
data table. The Auto Check Conditions for selected data items in the Wells data table are
as follows:

Data Item Auto Check Conditions)

UWI empty; > 20 characters in length or <12 characters in length

Elevation <-30,000 or > 30,000 feet

End Depth > 500,000 feet

Surface X Location Max +/- circumference of the earth along the equator

Surface Y Location Max +/- half the circumference of the earth along the meridian

Latitude <-90 or > 90

Longitude <-180 or > 180

To create your own data quality rule:

1. Click the down arrow in the Rule Type column beside the desired Data Item.

2. Select the desired condition. For all items except UWI, the possible conditions are:
3. Enter the desired value in the Value column.
4. Click in the Color Cell and select a different color if desired.
5. Click Apply.

Note: The X and Y coordinate autocheck values are the largest absolute values that an
X or Y coordinate could have. The X value is the circumference of the earth along
the equator. The Y value is half the circumference of the earth along a meridian.

© 2017 IHS Markit. All Rights Reserved. 53

View and Edit your Well Data
The Wells View tab displays the well data items specified in the Customize tab for all wells in
the selected group or project.

Note: If the Data Quality Rules option is selected in the Customize tab, then data values
that fall outside of the parameters set as acceptable will be highlighted in yellow or the
color specified.

All data items in the Wells table are editable except for the following:
• Project Name
• Project Path
• Well Symbol

In the figure above, a Data Quality Rule was set to highlight wells with an end depth of 0.
These zero values can be corrected by entering the actual values.
• Replace existing cell content—click in the cell and enter new data
• Edit existing cell content—click in the cell and then again to the right of the existing
value to highlight existing content.
See the Data tab overview for functionality available on all tabs: sort, export, data quality
rules, and paged result options.

54 © 2017 IHS Markit. All Rights Reserved.

2D Seismic Data
You can view the data for the entire catalog, a single group, or a single project. Click any
project or group in your Project Catalog and select Group > Open or Project > Open.

Tip: You can also right click any group or project and select Open.

Customize your 2D Seismic Data Table

Click the Customize tab to display a list of 2D seismic data items that can be displayed in the
data table and to apply a quality check to the existing results. See Data Quality Rules for 2D
Seismic.
.

The 2D Customize tab lists the available data items in the left column. To display all items,
check the box beside the column header Data Items.

Data Quality Rules for 2D Seismic

© 2017 IHS Markit. All Rights Reserved. 55

 When activated, the Data Quality Rules option automatically checks
the quality of the data and highlights data that is outside of the specified acceptable range.
Not all data items have an associated Data Quality Rule.
If any data values fall outside of the acceptable range as defined by the Auto Check
Conditions or by rules that you create, then these values will be highlighted in yellow in the
Results table. The Auto Check Conditions for selected data items are as follows:

Data Item Auto Check Conditions

File Type Defaults to No Rule. Select .1 or .ksd.

Load Format Defaults to No Rule. Select 8, 16, or 32 bit.

File Size in KB Defaults to No Rule. Select file size value of 0 to create a rule.

XSPMin Max +/- circumference of the earth along the equator

XSPMax Max +/- circumference of the earth along the equator

YSPMin Max +/- half the circumference of the earth along the meridian

YSPMax Max +/- half the circumference of the earth along the meridian

Number of Traces Data <0 or Data is NULL

Sample Interval Data <0 or > 0.100 (in seconds = 100 milliseconds)

Start Time Data <-0.100 (in seconds = 100 milliseconds) or > 0.100 (in seconds)

Mistie Time Shift Data <-0.100 (in seconds = 100 milliseconds) or > 0.100 (in seconds)

To create your own data quality rule:

1. Click the down arrow in the Rule Type column beside the desired Data Item. The Rule
Type options available will depend on the data item selected. The rule type for most data
items is a numerical range or value. For some data items the rule type is a choice of
possible values:

2. Select the desired condition.

3. Enter the desired value in the Value column when applicable.
4. Click in the Color Cell and select a different color if desired.

56 © 2017 IHS Markit. All Rights Reserved.

5. Click Apply.
The X and Y coordinate autocheck values are the largest absolute values that an X or Y
coordinate could have. The X value is the circumference of the earth along the equator.
The Y value is half the circumference of the earth along a meridian.

View your 2D Seismic Data

The 2D View tab displays the 2D seismic data items specified in the Customize tab for all 2D
volumes in the selected group or project.
In the figure below, the Data Quality Rule was set to flag all seismic files with a file size of 0.

See the Data tab overview for functionality available on all tabs: sort, export, data quality
rules, and paged result options.

© 2017 IHS Markit. All Rights Reserved. 57

3D Seismic Data
You can view the data for the entire catalog, a single group, or a single project. Click any
project or group in your Project Catalog and select Group > Open or Project > Open.

Tip: You can also right click any group or project and select Open.

Customize your 3D Seismic Data Table

Click the 3D Customize tab to display a list of 3D seismic data items that can be displayed in
the data table and to apply a quality check to the existing results. See Data Quality Rules for
3D Seismic.

The 3D Customize tab lists the available data items in the left column. To display all items,
check the box beside the column header Data Items.

58 © 2017 IHS Markit. All Rights Reserved.

Data Quality Rules for 3D Seismic

When activated, the Data Quality Rules option automatically checks the
quality of the data and highlights data that is outside of the specified acceptable range. Not all
data items have an associated Data Quality Rule.
If any data values fall outside of the acceptable range as defined by the Auto Check
Conditions or by rules that you create, then these values will be highlighted in yellow in the
Results table. The Auto Check Conditions for selected data items are as follows:

Data Item Auto Check Conditions

File Type Defaults to No Rule. Select .1 or .ksd.

Load Format Defaults to No Rule. Select 8, 16, or 32 bit.

File Size in KB Defaults to No Rule. Select file size value of 0 to create a rule.

Inline Min Defaults to No Rule. Select > = or <= and enter Value.

Inline Max Defaults to No Rule. Select > = or <= and enter Value.

Inline Spacing Defaults to No Rule. Select > = or <= and enter Value.

Inline Increment Defaults to No Rule. Select > = or <= and enter Value.

Number of Inlines Data <0 or Data is NULL

Crossline Min Defaults to No Rule. Select > = or <= and enter Value.

Crossline Max Defaults to No Rule. Select > = or <= and enter Value

Crossline Spacing Defaults to No Rule. Select > = or <= and enter Value

Crossline Increment Defaults to No Rule. Select > = or <= and enter Value

Number of Crosslines Data <0 or Data is NULL

Sample Interval Data <0 or > 100ms

Number of Samples Defaults to No Rule. Select =0, > = or <= and enter Value

Record Length Data <0 or Data is NULL

Start Time Data <-0.100(in seconds = 100 milliseconds) or > 0.100(in

seconds...)

Mistie Time Shift Data <-0.100(in seconds = 100 milliseconds) or > 0.100(in
seconds...)

© 2017 IHS Markit. All Rights Reserved. 59

To create your own data quality rule:
1. Click the down arrow in the Rule Type column beside the desired Data Item. The Rule
Type options available will depend on the data item selected. The rule type for most data
items is a numerical range or value. For some data items the rule type is a choice of
possible values:

2. Select the desired condition.

3. Enter the desired value in the Value column when applicable.
4. Click in the Color Cell and select a different color if desired.
5. Click Apply.

Note: The X and Y coordinate autocheck values are the largest absolute values that an
X or Y coordinate could have. The X value is the circumference of the earth along
the equator. The Y value is half the circumference of the earth along a meridian.

View your 3D Seismic Data

The 3D View tab displays the 3D seismic data items specified in the Customize tab for all 3D
volumes in the selected group or project.
In the figure below, the Data Quality Rule was set to flag all seismic files with a file size of 0,
and all seismic files with an 8 bit load format.

60 © 2017 IHS Markit. All Rights Reserved.

See the Data tab overview for functionality available on all tabs: sort, export, data quality
rules, and paged result options.

© 2017 IHS Markit. All Rights Reserved. 61

Interpretation Data
View your Interpretation Data
The Interpretation View tab lists all authors in the selected group or project, and the
interpreted data for each author. The possible data categories are contours, faults, fault
polygons, grids, horizons, and formation tops.
1. Select an author in the top left panel.
In the Data Category panel, each data category will display the number of interpretations
by that author.
2. Select a data category to display details of the interpretations in the table.

Customize your Interpretation Data Tables

Five of the six Interpretation Data Categories contain the data items in the left boxin the
figure below. The data items available for formation tops are displayed in the right box in the
same figure.

62 © 2017 IHS Markit. All Rights Reserved.

 Contours / Faults
Fault Polygons / Grids / Horizons Formation Tops

The Customize tab for the Horizons Data Category is displayed below. Note that
Interpretation does not have Data Quality Rules. all columns are gray.

See the Data tab overview for functionality available on all tabs: sort, export, data quality
rules, and paged result options.

© 2017 IHS Markit. All Rights Reserved. 63

Group Details
From the Project Catalog window, select a group, and click Details to open the Group
Details dialog box

Group Details - View

The View tab in the Group Details dialog box displays the details and totals of data objects
selected in the Customize tab. Like the project View tab, the group View tab has sort and
export functionality. See the Data tab overview for details.
.

Group Details—Customize
The Customize tab in the Group Details dialog box displays a list of data items that can be
displayed in the View tab for the selected group. The list of data items are listed in the figure
below:

64 © 2017 IHS Markit. All Rights Reserved.

Select the data items you want to view and click Apply. Then click the View tab.

© 2017 IHS Markit. All Rights Reserved. 65

Querying across multiple Kingdom projects

Querying across multiple Kingdom projects

In the Kingdom Data Manager main window, choose Tools > Query to create queries against
the Project Catalog, display a list of saved queries, and view the results of a query.
The Query dialog box contains the following tabs:

Create Create one or multiple expressions (conditions) for your query.

Queries View saved queries and their associated expressions.

Results View a table of the results of your query. Fields displayed are
selected in the Display Fields panel of the Create tab.

Creating a query
From the Kingdom Data Manager main menu, choose Tools > Query to open the Query
dialog box. Click the Create tab, which allows you to create queries against your Project
Catalog.

To create a query:

66 © 2017 IHS Markit. All Rights Reserved.

 Querying across multiple Kingdom projects

1. Select Data Category. The Group/Project tree is disabled until you select a category. You
can only select one category at a time.
2. Select the group or project in the tree that you want to query. You can query your entire
Project Catalog, a single group, or a single project.
3. Create a query expression. Under Create Expressions:
a. Select the first data item. The list of items is specific to the selected data category. If
you do not see the item you want listed, click the Display Fields tab.
b. Select the condition. The following conditions may need an explanation:
- For “contains”, select Like and use % (wildcard search) before and/or after the
entered string.
- <> means “Is not equal to”.
c. Click Add to add the expression to the query table.
d. If you want to preview the results so far, click Preview or Show Results.
e. Repeat a through c until all expressions have been added to the query.
f. Group the expressions if necessary. Select at least two rows (expressions) in the
query table and click the parentheses ( ) button.
g. Now link with AND OR logic. The default logical operator between expressions is
AND. To select OR:
- Highlight the first expression.
- Hold down the <Shift> key and highlight the second expression.
- Click the OR button. The word or will now replace and in the Group column.
For example: Query for formation tops belonging to authors GS with a depth between
100 and 900 from wells with a name of either Acro or Trex.

© 2017 IHS Markit. All Rights Reserved. 67

Querying across multiple Kingdom projects

4. If you will use this query again, don’t forget to Save Query. Saved queries can be edited
on the Queries tab at any time.
You can also edit the data in the Value columns in the query table itself Just double-click
in the cell and edit the value.

68 © 2017 IHS Markit. All Rights Reserved.

 Querying across multiple Kingdom projects

Saving queries
In the Kingdom Data Manager main window, choose Tools > Query to open the Query
dialog box. You can create a query with multiple expressions, and save the query by clicking
Save Query which opens the dialog box below.

Enter a name for the query. All other fields are non-editable.
Click OK to return to the Create tab. The saved query will be displayed on the Queries
tab of the Query dialog box.

© 2017 IHS Markit. All Rights Reserved. 69

Querying across multiple Kingdom projects

Viewing and editing saved queries

From the Kingdom Data Manager main menu bar, choose Tools > Query to open the
Query dialog box. Click the Query tab, which displays the saved queries.

The Queries tab in the Query dialog box contains the following elements:
• Available Queries (read only)—displays a graphical list of folders containing saved
queries by data type according to the Data Type selected on the Create tab.
Select a saved query in the Available Queries panel to view the Expressions and
Selected Objects for that query.
- Query Expression Table (Expression List)—displays the expressions of a selected,
saved query.
• To change an expression, double click the value cells to update parameters.

70 © 2017 IHS Markit. All Rights Reserved.

 Querying across multiple Kingdom projects

• Click the Save Query button at the bottom of the Queries tab to save the modified
query.
- Selected Objects- displays the Display Fields selected in the Create tab for a saved
query, and the group/Project tree. The domain or project for which the query was
created will be highlighted.

Viewing query results

From the Kingdom Data Manager main menu bar, choose Tools > Query to open the Query
dialog box. Click the Results tab, which allows you to view the results of the current query.

The Results tab in the Query dialog box displays the data in columnar format. This tab has
the basic functionality of the other data tabs. For more information on sorting and exporting
see Data tab overview.

© 2017 IHS Markit. All Rights Reserved. 71

Querying across multiple Kingdom projects

72 © 2017 IHS Markit. All Rights Reserved.

Convert, Copy, Compare Projects
KDM makes converting and copying Oracle and SQL projects simple and efficient.This
section discusses the following:

Convert convert existing Kingdom project database from one database type to another.
Databases can be SQL Server, SQL Server Express, or Oracle.

Copy make an identical copy of a Kingdom project. All project files and the database
will be copied to a designated location and can be added to the Kingdom
Project Catalog.

Compare examine the similarities or differences of selected data objects between two
Kingdom projects. Available items to compare are wells, 2D and 3D seismic,
and all interpretation items.

Important notes on converting and copying projects

If you want to convert or copy your project to SQL Server or Oracle, you will need the server
instance, user name, and password for the specified database. See your database
administrator if you do not have this information.
If you are copying a project into a multi-project database, at least one project in that database
must have been upgraded to the current version of Kingdom..

Projects in Use You cannot convert a project if the Kingdom project is currently in use.
All authors must exit the project and the project must be closed. See
Kingdom Projects Currently in Use for a list of Windows users currently
in the project.

Oracle Kingdom requires Oracle project administrators to have CREATE

TABLE, CREATE VIEW, and CREATE TRIGGER system privileges to
create and upgrade projects.

SQL To convert Kingdom projects with full SQL Server, the database login
account must have Create View and Create Table permissions.

SQL Server Express SQL Server Express does not require a user name and password. The
instance name will be in the following format: <computer
name>\SMTKingdom.
Copying or converting an Auto SSE project to another SQL Server
Express instance will change the project to Manual SSE.
SQL Server Express has a single database size limit of 4GB. If your
source Oracle or SQL Server database exceeds or is very close to 4GB
then your project conversion will fail.

© 2017 IHS Markit. All Rights Reserved. 73

Converting Kingdom project databases

Converting Kingdom project databases

Converting project databases requires database permissions that only database
administrators have been granted. Before you begin, please see Important notes on
converting and copying projects.

To convert a Kingdom project database:

1. Select the project that you want to convert (Source Project) from your Project Catalog
tree.
2. Choose Projects > Convert to open the Convert Project Database dialog box.
3. Review the Source Project information. These fields are view only.
4. Enter the required information for the Destination (or converted) Project:
5. Click Test Connection to test the connection to the database and server instance for the
destination project using the login credentials you entered.
6. Click Convert to begin the conversion process. Depending on the size of the project, this
could take several minutes.

74 © 2017 IHS Markit. All Rights Reserved.

 Copying Kingdom projects

Copying Kingdom projects

Copying project databases requires database permissions that only database administrators
have been granted. Before you begin, please see Important notes on converting and copying
projects.
Copy Project makes an identical copy of the project folder and the project database. You can
copy the database into another instance of the same database type (SQL Server, SQL Server
Express, or Oracle) or you can copy the database to a different database type.

To copy a Kingdom project:

1. Select the project that you want to copy (Source Project) from your Project Catalog tree.
2. Choose Projects > Copy to open the Copy Project dialog box.
3. Review the Source Project information. These fields are view only.
4. Select your seismic preferences. You have the following two options:

Do not Copy Seismic The new project will use the source project’s seismic data. Links to
the source project’s seismic files will be written to the database of
the copied project. This is the default.

Copy Seismic Copy seismic files in the selected project to the new project folder
shown in the path displayed in the Path text field in the
Destination Project area.

Having multiple projects use the same source seismic data will save space; however,
unless the source seismic is in a Read Only folder, the seismic data used by multiple
projects can be deleted, edited, or moved by authors in any of the sharing projects.
Deleting, moving, or editing the source seismic will affect interpretations such as horizons
and faults created using the altered seismic.
Consider the security of the source seismic carefully before sharing seismic between
projects.
5. Specify the database information for the Destination Project:
6. Click Test Connection to test the connection to the database and server instance for the
destination project using the login credentials you entered.
7. Click Copy to begin the copy process. Depending on the size of the project, this could
take several minutes.

© 2017 IHS Markit. All Rights Reserved. 75

Copying Kingdom projects

76 © 2017 IHS Markit. All Rights Reserved.

 Comparing projects

Comparing projects
From the Kingdom Data Manager main window, choose Projects > Compare Projects to
open the Project Compare dialog box in which you can compare the similarity or differences
of selected data objects in two specified projects.
Alternatively, in the Project Catalog dialog box, right-click a project name and select
Compare Projects.

To compare two projects:

1. Select the Comparison Criteria tab.
2. In the left Project Catalog select the first project, Project A.
3. In the right Project Catalog (center pane), select the second project, Project B.
4. In the right pane, select the data categories that you want to compare. The two projects
you are comparing are now highlighted in gray in their corresponding project catalogs.

Tip: If you do not want All categories, you can multi-select using the Shift or Ctrl key.

5. Click Compare. KDM opens the In Both Identical tab for you to begin your comparison.
6. View the results of your Project Compare for each selected data category:
• In Both Identical
• In Project A Only
• In Project B Only
• In Both with Differences
7. Like the other KDM data tabs, the Compare tabs have two views, Customize and View.
They also have sort and export functionality. See Data tab overview for more information.

© 2017 IHS Markit. All Rights Reserved. 77

Comparing projects

78 © 2017 IHS Markit. All Rights Reserved.

Managing your Kingdom seismic files
Project Explorer
From the Kingdom Data Manager main window, choose Projects > Project Explorer to
view the current directories and files for the project selected in the Project Catalog. You can
also right click the project in the catalog and select Project Explorer.
Project Explorer is a useful tool in helping you understand the layout, completeness and
integrity of an inventoried Kingdom project. For each file in the project, Project Explorer lists
the size, type, date modified, and accessibility of the file. This is especially useful when
project files are not located in the project folder such as author folders and seismic data.
This tool shows the following:
• the locations of all author folders, including external author folders
• the location and contents of the main project directory
• the location and accessibility of the project’s seismic data, including the local project
directory, external directories, and shared locations. The seismic data falls into 4
categories:

Local Displays a list of .1 and .ksd files in the folder of the selected
project.

External Displays a list of seismic files in the selected project that

reside in an external location. This seismic may or may not be
used by another project

Shared-from Displays seismic files in the selected project that have been
shared from another project in Kingdom using the Surveys >
Survey Share/Copy tool

Shared-to Displays the remote location of files belonging to external

authors (authors with folders outside the project directory)

The tool is especially useful in determining if all seismic files are in accessible locations
for the project. In a network environment, this may not always be the case. Project
Explorer provides tools to accomplish the following:

Move and Relink Seismic Relink a Kingdom project to its seismic files if these files
have been moved from their original location.

Relink Seismic Move a Kingdom project’s seismic files (*.ksd and *.1) and
relink the project to the seismic files in the new location.
If a project’s seismic files are not accessible, the rows will
be pink. If you know the location of the inaccessible seismic
data, you can use the Relink Seismic tool to reconnect the
data to the project.

Please see Important notes about seismic data before moving or relinking your seismic.

© 2017 IHS Markit. All Rights Reserved. 79

Tip: Adjust column widths, move columns, and sort the data ascending or descending by
any column to customize the data table.

Important notes about seismic data

Before moving your seismic data, please consider the following important notes:

Write-protect your source Seismic data used in multiple projects can be deleted, edited, or
seismic moved by authors in any of the sharing projects which would
affect interpretations in all linked projects. The source seismic
files should therefore be write protected. Only Mistie or Trace
Calculation operations require write privileges to the seismic
data.

Locate your seismic files The default location for a Kingdom project’s seismic files in the
project folder. However, seismic files can reside anywhere on the
network. Multiple users can then be linked to this single source
which can save space.

Seismic file names Kingdom seismic filenames are not project specific. Maintain
separate folders for each project.

Shared seismic and Project Explorer can only maintain the links of Kingdom projects
projects not inventoried that are in your KDM Catalog. If a project shares the selected
seismic files but has not been inventoried, then the project will
lose the connection to the seismic data.

80 © 2017 IHS Markit. All Rights Reserved.

 Project in use Kingdom Data Manager will not Move and Relink seismic if the
Kingdom project is currently in use. All authors must exit the
project and the project must be closed. See Kingdom Projects
Currently in Use for a list of Windows users currently in the
project.

Move and Relink Seismic

Please see Important notes about seismic data before moving or relinking your seismic.

To move and relink your seismic:

1. Right-click the project in your Kingdom Catalog and select Project Explorer.
2. In the left pane of the Project Explorer window, expand the Seismic directory, and select
the seismic files you want to relocate (Local, External, or Shared-to).
3. In the right pane, select the seismic files.

4. Click Move and Relink to open the Move and Relink dialog box.
Linked Projects displays information about any projects in your KDM Catalog (including
projects not assigned to a group in your Project Catalog.) that also use the seismic data
that you have selected to move and relink. Project Explorer will update the seismic tables
in these projects to maintain the link.

© 2017 IHS Markit. All Rights Reserved. 81

5. Browse to the designated destination location of the seismic being moved.
6. Click Move and Relink to begin the move and relink process.

Move and Relink Report

The Move and Relink Seismic operation generates a Move and Relink report which lists the
seismic files selected for relocation. Three Export options are available:
• Save as a Microsoft Excel*.xls spreadsheet
• Save as a text *.csv file
• Open in Microsoft Excel

Tip: Scroll to the right to see if the operation for each seismic file was successful.

82 © 2017 IHS Markit. All Rights Reserved.

Relink Seismic
The first thing you need to do is determine if any of the project’s seismic files are not
accessible.
Right click the project in your Kingdom Catalog and select Project Explorer.
If the seismic files are not accessible, then No is displayed in the Accessible column and the
seismic files are highlighted in orange. The seismic database record cannot be matched to a
.1 or .ksd file. The seismic files may have been moved through Windows, not Project
Explorer.
If you know the new location of the seismic, then you can easily relink the seismic with
Project Explorer.

© 2017 IHS Markit. All Rights Reserved. 83

Warning: Exercise caution that you do not link to the wrong file — Kingdom will crash.
Seismic file names are not unique across the network.

To relink seismic data to the project:

1. In the left panel of the Project Explorer window, expand the Seismic directory, and select
the seismic files you want to examine (Local, External, or Shared-from).
2. In the right panel, select the seismic files that are not accessible.

84 © 2017 IHS Markit. All Rights Reserved.

3. Click Relink.
4. In the Browse window, navigate to the location of the seismic files and select OK.
5. When the relink is complete, click Close to return to the Project Explorer window.

© 2017 IHS Markit. All Rights Reserved. 85

86 © 2017 IHS Markit. All Rights Reserved.
Transfer Data
Transferring data with KDM
Kingdom is an OpenSpirit-enabled data store. Kingdom Data Manager’s Transfer Project
Data tool enables one-step Kingdom to Kingdom data transfer without the need for manual
file transfer. This transfer tool transfers well, seismic and interpretation data between
Kingdom projects and allows you to convert unit, coordinate, and attribute values on the fly
based on the requirements of the destination (target) project.

Requirements for transferring data

• Both Kingdom projects must be updated to the same version before using the transfer
tool. Projects are automatically updated when opened in the new version of Kingdom.
• After updating the projects, both projects must be re inventoried. Right click the project in
the Project Catalog tree and select Refresh Inventory.
• Both source and destination projects must have defined projection systems.
• If your projects are very large, the time required to start the OpenSpirit data service might
be affected. You may want to extend the length of time before the OpenSpirit data service
times out by specifying an environment variable. How you access the environmental
variables depends on your operating system.
a. Click New under System variables
b. Enter the variable name: SMT_EMBEDDED_STARTUP_TIMEOUT
c. Enter a variable value in seconds. Without the variable, the value is 75 seconds.
For example, a value of 120 will extend the timeout to 120 seconds.
You do not have to reboot, but you will need to close and reopen the application.

What the Data Transfer tool does not transfer

The KDM Transfer Data tool does not transfer the following objects:

Time slice volumes Cultures

Illuminator seismic volumes* Contours

Raster logs Fault polygons

*Illuminator seismic volumes are generated with Kingdom’s advanced horizon autopicker

To transfer data with KDM:

1. Select the projects and authors
2. Selecting data in the OSP Copy Manager
3. OpenSpirit Data Selector

© 2017 IHS Markit. All Rights Reserved. 87

Transfer Data with KDM

Transfer Data with KDM

Before you begin, please read Requirements for transferring data
The steps to transfer data are as follows:
1. Select the projects and authors
2. Select data categories and items
3. Select the actual data and submit job

Select the projects and authors

Before you begin, please read Requirements for transferring data
Before data transfer can occur, you may need to specify the Kingdom installation directory.
This step usually occurs during configuration of your KDM Catalog. However, if you are
prompted to set the installation directory, enter or browse to the folder where Kingdom is
installed and click OK.

To select the Kingdom projects and authors:

1. In your KDM Project Catalog right-click on the source project and select Transfer Data.
KDM will start the data transfer service. It may take a few seconds for a successful
connection.
When the data transfer service has started, the Transfer Data dialog box opens where
you specify your destination project. The source project was selected from your Project
Catalog in step 1.The source project name and details are displayed on the left.
While the data transfer service is running, the specified author(s) will be active. If you
open the Kingdom project, you will not be able to log on as these authors.
2. The default Author selection in the source project is <All Authors>. Click the down arrow
to select a single author’s interpretations to transfer to your destination project or transfer
the interpretation from all authors.

Note: In your destination project, you can only select a single author. All interpretation
will be assigned to this single author. Therefore, in your source project, you may
want to transfer data one author at a time so that you can map your data author by
author.

3. Select your Destination project form the Project Catalog. The destination project name
and details are displayed on the right.
4. Select the single author to receive the interpretation data.
5. Click Transfer to start the Copy Manager where you will select the data items you want to
transfer. It may take a few seconds for the Copy Manager to start.
The Copy Manager and OpenSpirit Data Selector are OpenSpirit (OSP) tools.

88 © 2017 IHS Markit. All Rights Reserved.

 Transfer Data with KDM

Selecting data in the OSP Copy Manager

In the Copy Manager select the well, seismic, and interpretation data categories you want to
transfer to the destination project. Data categories include the following:

Wells Seismic Interpretation

Well bores 3D Surveys Horizons (grids and horizons)

Well logs 3D Volumes Faults
Well picks (formation tops) 2D Surveys Seismic Earth Model (Time)*
Well velocities (T-D charts) 2D Lines Seismic Earth Model (Depth)*
2D Datasets (trace data)

Note: *OpenSpirit assigns all of the Kingdom horizons and faults to a default domain in time
or depth. Select DEPTH Earth Model and TIME Earth Model for both horizons and
faults.

© 2017 IHS Markit. All Rights Reserved. 89

Transfer Data with KDM

In addition to the Copy Data tabs described above, the dialog box includes the following
feilds:

Log Directory Displays the default location for the log directory. This log is created
after the data transfer and records the status of each transferred
item.
The log also opens automatically when the data transfer is complete.

Destination Project You can click Select Project to view projects in the current
OpenSpirit session. However, you should not need to change the
destination project.

Data Store Type This information is read only and is populated by OpenSpirit.

Data Store Name This field is also populated by OpenSpirit.

Copy Rules The default is not to overwrite existing objects.

After you select the data categories, click OK to open the OpenSpirit Data Selector.

90 © 2017 IHS Markit. All Rights Reserved.

 Transfer Data with KDM

OpenSpirit Data Selector

In the Copy Manager you selected the data categories and items you want to transfer to the
destination project. In the OpenSpirit Data Selector you select the actual data you want to
transfer.

Note: Click the Help icon for definitions of individual items, or select Help > Data Selector
Help to access OpenSpirit’s help documentation.

Note: You can only select data from the categories and items that you selected in the
Copy Manager.

To select the data and submit the job:

1. Select the data category tab on the left, and then in each associated tab across the top
select the data you want to send to the destination project.

To transfer all data, click Submit in the upper-right corner.

To define a bounding box within the project from which to transfer data, see Data Transfer
within a Bounding Box
2. .Save current configuration? Accept the default or select a new File name and Save in
location and click Save.
3. The CopySync Jobs report opens which tracks the status of the data transfer job(s).
When the job is finished, click Close.

© 2017 IHS Markit. All Rights Reserved. 91

Transfer Data with KDM

4. View the Data Copy Service Report which lists the status of all copied data. If the Data
Copy Service report does not open, you can open it from the Kingdom Data Manager
Reports menu:
• Close the Transfer Data dialog box with the X in the upper right corner and click
Reports > Data Transfer in the Kingdom Manager.
• Click Browse which should open the Log Directory. Select the *<date and
time>.html file for the current job.

Data Transfer within a Bounding Box

You can transfer a wells subset using the data transfer tool by defining a rectangular
bounding box within your source project.
Transferring a subset of project data includes the following:
- In Kingdom record the XY coordinates for the lower left and upper right corners of the
rectangular subset area.
- Set the session coordinate system with the Session Wizard (Steps 1-6 below).
- Enter your XY coordinates in the Bounding Box Selection (Steps 7-12 below).
1. In the Data Selector select Session > Edit to open the Session Wizard.
2. In Edit Session dialog box, click Edit
3. In Session project(s) click Next.
4. In Please provide the passwords click Next.
5. In Units select Imperial or Metric for defaults. Click Next.
6. In Coordinate System click the checkbox beside the session. You have a project
coordinate system, but this creates the session coordinate system. After the coordinate
system is displayed, click Finish to return to the OpenSpirit Data Selector.

7. In the Data Selector toolbar click the General Preferences icon as in the figure above.
8. In General Preferences, check Use Session Coordinate System and click OK.
9. In the Data Selector, choose the Well Bore tab and then click the Data Scope icon in the
toolbar.
10. Under Spatial Filter select Bounding Box.
11. In Bounding Box Selection enter the XY coordinates for the Lower Left and Upper
Right corners of the subset area. Click OK.

92 © 2017 IHS Markit. All Rights Reserved.

 Transfer Data with KDM

12. In the Data Scope for Well Bore click OK.

Data Transfer report

The printable Data Transfer Report (Data Copy Service Report) lists the status of all
transferred data using Kingdom Data Management’s Transfer Data tool.
After a successful Kingdom to Kingdom data transfer, Data Transfer report should
automatically open.
You can also open this report from the Kingdom Data Manager Reports menu.
1. Select Reports > Data Transfer.
2. Click Browse which should open the Log Directory.
3. Select the *<date and time>.html file for the desired job.
The default location for the Data Copy Service log depends on your operating system. For
Windows 7 the default is
C:\Users\username\AppData\Local\Application Data\OpenSpirit\Embedded -
Kingdom v#.#\log\CopySync\*.htm

© 2017 IHS Markit. All Rights Reserved. 93

Transfer Data with KDM

94 © 2017 IHS Markit. All Rights Reserved.