MULTIPHASE FLOW MODEL

OLGA-S 2014
Version 2014.1

Installation guide

-S

O L G A-S I N S T A L L A T I O N G U I D E

Page i

TABLE OF CONTENTS
1.

INTRODUCTION

2.

REQUIREMENTS
2.1 Recommended hardware
2.2 Required software

2
2
2

3.

INSTALLATION OF OLGA-S
3.1 Note on administrator privileges
3.2 Uninstalling OLGA-S

3
3
3

4.

FLEXLM INSTALLATION ON WINDOWS

4.1 Requirements
4.2 Installation of FlexLM
4.3 License configuration
4.4 System info
4.5 License files
4.6 TCP/IP Windows

4
4
4
4
7
8
8

O L G A-S I N S T A L L A T I O N G U I D E

1.

Page 1

INTRODUCTION

This document describes the installation of OLGA-S for:

Windows Vista
Windows 7
Windows 8
The OLGA-S installation comprises the following:

OLGA-S DLL multiphase point model for 64 and 32 bit executables

FlexLM (license control system)

Suggestions for improvements or new features are always appreciated, please send these to
olgasupport@slb.com.
E-mail support: The OLGA-S support e-mail address is olgasupport@slb.com. Your support
request will be registered in our internal support database, a support ID will be returned to you
in an e-mail to confirm the receipt of your request, and you will get support as quickly as
possible.
When reporting an error, please provide all available background material (all input files for
the failed case, specifications for suggested improvements, OLGA-S version, executable that
is running OLGA-S, etc.).
The generic e-mail address for all OLGA-S related questions/bug reports/support is:
olgasupport@slb.com.

O L G A-S I N S T A L L A T I O N G U I D E

2.

REQUIREMENTS

2.1

Recommended hardware

Page 2

Please see the Schlumberger Support portal for information.

2.2

Required software
Operating system:
o Microsoft Windows Vista or
o Microsoft Windows 7
o Microsoft Windows 8

Note:
Make sure you have the latest service pack and critical updates for the version of Windows
that you are running. To find recent security updates, visit Windows Update.

O L G A-S I N S T A L L A T I O N G U I D E

Page 3

INSTALLATION OF OLGA-S

3.

The installation program will perform the installation of all necessary components for OLGAS.
When the installation of OLGA-S starts, follow the instruction on screen. You will get a
selection between a Quick installation and a Custom installation. The quick installation selects
all components and installs to the default installation folder without any further user
interaction. In custom installation, you select which components to install and can also set the
installation folder. The selectable component is:

3.1

License Manager - SPT License Handler is a license administration tool that utilises
the FlexLM license control system. FlexLM license control has to be installed to run
OLGA-S, see chapter 4 for details on the installation of SPT License Handler.

Note on administrator privileges

You need administrator privileges to install OLGA-S. Due to the User Account Control (UAC)
on Windows, you are prompted to allow the installation to run even though you have logged in
as an administrator. You must answer Yes.

3.2

Uninstalling OLGA-S

Open the Control Panel and select Add/remove programs. Select the relevant OLGA-S
version in the list and click the button Remove or Uninstall. No user interaction is necessary.

Please note that SPT License Handler (FlexLM) is installed as a separate component. To
remove this component, locate SPT License Handler in the list and click the button Remove.
No user interaction is necessary.

O L G A-S I N S T A L L A T I O N G U I D E

4.

Page 4

FLEXLM INSTALLATION ON WINDOWS

FlexLM is the license control system applied by OLGA-S. FlexLM allows for several different
license configurations. If OLGA-S will run on one PC only, there will usually be a license
server running locally on the same PC. However, if OLGA-S is to run on several PCs in the
same network, it may be convenient that they share a common license server. This concept is
called floating licenses, and means that all the PCs share a common license pool. Typically,
this common license server runs on a network server.

4.1

Requirements

The license control requires that TCP/IP is installed and started on your PC. For information
on how to verify this, see Section 4.7.

4.2

Installation of FlexLM

The FlexLM installation starts automatically when installing OLGA-S. The SPT License
Handler installation offers the following 3 different license setups
A. Use a license server on this machine
B. Connect to a network license server
Select Option A if;
1) You install OLGA-S and have a license file that is valid for the same machine as you
use to run OLGA-S. You will get a local license server that handles your license
- or 2) You install a network license server.
Select Option B if your company has a network license server serving all OLGA-S
installations.
You may change this option later by using the License Handler. The sections below give
some more details on Options A-B.

4.3

License configuration

A. Use a license server on this machine (Local license server)

Please note that you need administrator privileges to install a local license server. If you do
not have administrative privileges, this option is disabled.
Normally, default settings for the local license server are given by the installation. If the status
indicator is a green check mark (see below) just close the dialog and start using OLGA-S.
If the setup is unsuccessful, or you would like to change the default settings, click the
Configure button. The dialog shown below is displayed:

O L G A-S I N S T A L L A T I O N G U I D E

Page 5

Any problems in the license server setup are described in the Local license server status box.
You may change the following settings;
Location of license server(s)
This setting tells OLGA-S where to look for the license server. The location should be given
in the format <port>@<host>.
<port> is the port number used by FlexLM. This is normally not used in the
license files.
<host> is the name of your PC. Click Add local server to let the program
determine the name of your server.
Example: @tso
You may specify the location of several license servers by separating each location with a
semicolon. This may be needed in cases where you do not have all licenses on your machine.
If some licenses only are available from a network server you can append the location of the
network license server after your local license server.
Note:
This setting is stored in the environment variable SCPLMD_LICENSE_FILE. Do not overwrite
existing license server locations if you are not sure which program is using them.
You may edit the port number in your license file. To use other port numbers than FlexLMs
default port range (27000-27009,) the reference to the port (e.g. 7570) should be added on
the SERVER line, and the environment variable should be set to 7570@<host>.

O L G A-S I N S T A L L A T I O N G U I D E

Page 6

License Folder
This setting tells the license server where to find the license files. Enter only the path to the
license folder to enable use of multiple license files. The license server will look for license
files with *.lic extension in the given license folder. Default location is C:\Program Files\SPT
Group\Licenses.
FlexLM Folder
The FlexLM folder contains the license daemons; lmgrd.exe and scplmd.exe. Default location
is C:\Program Files\ SPT Group \FlexLM.
Install license server button
The license server is normally installed after an OLGA-S installation. This button can be used
if the license server for some reason is uninstalled. All settings described above must be
given before installing the license server.
Uninstall license server button
Click this button if you want to uninstall the local license server.
Note: The license daemons are not removed, but the license server is stopped. It can easily
be installed again by clicking the Install license server button.
Restart license server button
You must restart the license server if a new license file is added to the license folder.
B. Connect to a network license server
Instead of running a local license server you may connect to a company wide license server.
This enables several users to share a pool of floating licenses. To configure your machine to
use an existing network license server, select Connect to a network license server and click
the Configure button.

Enter the location of the network server. The location should be given in the format
<port>@<host> e.g. @server1.

O L G A-S I N S T A L L A T I O N G U I D E

Page 7

<port> is the port number used by FlexLM. This port number can be set in the license
file.
<host> is the name of the license server. Consult the server responsible or the license
file located on the server.

You may specify the location of several license servers by separating each with a semicolon.
Note: This setting is stored in the environment variable SCPLMD_LICENSE_FILE. Do not
overwrite existing license server locations if you are not sure which programs are using them.

4.4

System info

Click the System info button (see figures below) to obtain information about your PC.

O L G A-S I N S T A L L A T I O N G U I D E

4.5

Page 8

License files

The license file location is set when you install OLGA-S, please save the license file to this
location. (The default location is C:\Program Files\ SPT Group \Licenses\.)
License files must have *.lic extension.
The license file location can be found as follows:
1. Start the License Manager from the FlexLM subfolder under the OLGA-S folder at the
Start menu.
2. Click the Configure button.
Note: If the license file is for your local PC, save it locally. If the license file is for a common
server, save it on the server.
Editing the license file:
Typically line 1 of the license file reads:
SERVER this_host <ethernet address>
The hostname (this_host) may be changed to reflect the actual hostname/computername.
This will be necessary if you receive the FlexLM error: -95, when trying to run a licensed
program.

4.6

TCP/IP Windows

TCP/IP is a widely accepted communication protocol, and is used by FlexLM for the
communication between the license daemon and the application. Chances are high TCP/IP
already is installed and started on your PC, especially if you are using the PC in a network or
are connected to Internet
In this section you will find information on how to handle TCP/IP depending on your system
configuration. The configuration will usually be one of the following:

TCP/IP is installed and started correctly on the PC.

To verify this, check (Control Panel - Services) that TCP/IP is installed
and started. If this is the case, then you can obtain the license info as
described above.

TCP/IP is installed, but not started on the PC.

Check (Control Panel - Services), and start the TCP/IP service.

TCP/IP is not installed, but the PC has a network adapter.

TCP/IP is found on the Windows installation CD, and installation should
be straight forward selecting Control Panel - Network and following the
instructions. Please consult your Windows documentation, or your
system administrator.

If you are unable to run a license daemon on your PC, please contact us and our support
function for further assistance. In most cases however, you will be using the standard
licensing strategy, and complete the installation according to one of the four situations
mentioned above.