Ecrin v4.

02 KAPPA 1988-2007

Diamant Master Quick Start Guide p 1/5

Diamant Master Quick Start Guide

A. Introduction
The Figure below illustrates the framework and the underlying architecture. It is assumed that
all components have been properly installed (please refer to the 'Diamant Master Installation'
documentation).

Diamant Master Components

DMS (Diamant Master Server): the server application responding to client requests
to View/Create/Delete/Modify Fields, or elements of Fields.
DMDB (Diamant Master DataBase): where anything associated with Diamant Master Fields
is stored.
DMC (Diamant Master Controller): A web-based application to configure and monitor
the Diamant Master.
Processes: Processes launched by the server to execute tasks such as the tag mirroring
(DMMP), the filtering (DMFP), etc.
Data interface: Responsible for the access to external databases this part comprises a generic
layer and specific plugins (DLLs). Note that adding or adapting a given plugin requires only
one DLL to be added or modified.

Ecrin v4.02 KAPPA 1988-2007

Diamant Master Quick Start Guide p 2/5

B. Workflow
Some configuration steps are required on the DMC before clients can work with the Diamant
Master server, namely:

User definition: The users running the clients must be declared inside the DMC,
see section G.3 of the 'Diamant Master Installation'.

Data source definition: In the DMC you need to declare the adequate data sources,
see the DMC on-line help.

The following sections focus on the main workflow steps. Please note that you can call
the Ecrin on-line help (or the help in the DMC) for more detailed information.
B.1 Connect to the Server and Create/Open a Field

Start Ecrin and select File Diamant Master Connection. The dialog below (left) appears.

Connection dialog

Add server dialog

After entering the server name you can click on Connect. The bottom list in the
Connection dialog shows the existing Fields.

You can Create a new Field if there are none.

You then need to Open the field: the content is displayed in the
Diamant data tree >

If you have sufficient rights, you can create and delete hierarchy elements and all other
connected clients will be notified at once. Note that a node currently active in a client browser
is considered locked and cannot be deleted by others.

Ecrin v4.02 KAPPA 1988-2007

Diamant Master Quick Start Guide p 3/5

B.2 Create a Well + a Gauge + a Filtered data set

A Gauge in Diamant Master terminology is a mirror of a tag in your data server. Creating
a mirror is a pre-requisite to creating any kind of filtered data set. You should never attempt
to load directly, i.e. without mirror, a tag with a large number of points (say more
than 1,000,000).
Create Well:

Right click on the Field and select Add new Well (or use the corresponding toolbar
icon

).

Create Gauge:

Right click on the well and select Add new Gauge (mirror). This displays a dialog where
the data sources you defined in the DMC are listed:

Click on the desired Data Source and press Next >>. This will
call the interface for the specific plugin, to let you select the tag
in your data server. The Load dialog will be shown next, and
after validating, the gauge object appears in the data tree,
see opposite.

At this stage, the DMMP (Diamant Master Mirroring Process) will

start building the mirror. The tag data is pulled using a buffer size
as specified in the DMC.
You can connect to the DMC in your Internet browser to see
the mirroring progress (in Administration - Mirroring Details).
As a client in Ecrin, you can see the progress of the mirroring by selecting the Gauge node,
and displaying the 'Info' or 'Plot' pane. Note that data is transferred automatically only the first
time you click on the gauge. After this first action, you need to call Update All
the new points from the Master.

to get

At the same time as the mirror, the mirroring process on the Master creates a preview file.
At first this file contains all the points, but as more points are read, the preview points become
sparser. What is transferred to the client, and plotted, is the preview only.

Ecrin v4.02 KAPPA 1988-2007

Diamant Master Quick Start Guide p 4/5

Displaying the gauge preview

After enough points are obtained, the preview sampling is 1 point every 1000. You can check
this in the node Information:

Gauge information: checking the number of preview points

The mirroring process will catch up with whatever historical data present in the server and
when it is up-to-date, will update the mirror at a set frequency.

Ecrin v4.02 KAPPA 1988-2007

Diamant Master Quick Start Guide p 5/5

Create filtered data: Once a tag is mirrored and provided that a sufficient number of points
have been mirrored, you can create a filtered data set (you need 100,000 points
in the mirror).

Right click on the Gauge node, and select Add new Filtered data. The filtering is defined
with the usual dialog sequence (preview, preload, filter).

When you validate, the master writes the filter description in the Master database where the
filtering process will pick it up. The filtering process runs continuously and acts whenever a
mirror has grown sufficiently to be filtered. More precisely, if the client has used 100,000
points in the Pre-load, whenever 100,000 mirror points are read, a new filter window will be
considered. The filtering process writes the filtered point in a BLI file.
In the client, data points are loaded in memory only when they are displayed. For instance
when you click on a Filtered data node in the browser, the clients asks the server the data
points written in the BLI until that stage, and loads them in its memory. Once this has
happened, the subsequent update in the client memory will be triggered by a manual call
to the Update All option

You can force the filtering of the last mirrored data with the Filter last mirrored data option.
Note that if a Master process is working on this filtered data, you will receive a message.
B.3 What else?
Adding filtered data sets: Under a Gauge node you can add as many filtered data sets as you
want to test different settings.
Drag & drop: Filtered data may be dropped to other modules (Saphir, Topaze).
.
Editing: You can enter the editing mode from the plot display by clicking on the Lock icon
By doing so you are instructing the Master to hold any other modification of the particular
data. Actually if another user is editing, or if the Master itself is updating the data, the icon will
reflect this. For instance the icon

will appear when another user is editing.

After editing you must update the Master by pressing the Lock icon again. This validates your
changes and the usual processes can resume.
Production data: The well rates may be defined, either from an existing filtered data set, or by
a direct load, without filter, from a production database. In any case, once loaded they will
become candidates from the automatic summing of productions. This is handled by the Master
Calculation Process, operating a set frequency.
Plots, data functions:
You can create as many plots as you want and drag and drop on them, filtered data, as well as
create functions.
Please refer to the Ecrin on-line help for more information on all the above options.

[End of Document]