olga 2014 installation guide

OLGA-S 2014 Version 2014.1

Installation guide

-S MULTIPHASE FLOW MODEL

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 1

2. REQUIREMENTS 2 2.1 Recommended hardware 2 2.2 Required software 2

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

4. FLEXLM INSTALLATION ON WINDOWS 4 4.1 Requirements 4 4.2 Installation of FlexLM 4 4.3 License configuration 4 4.4 System info 7 4.5 License files 8 4.6 TCP/IP Windows 8

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

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 [email protected]. E-mail support: The OLGA-S support e-mail address is [email protected]. 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: [email protected].


2. REQUIREMENTS

2.1 Recommended hardware

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.


3. INSTALLATION OF OLGA-S

The installation program will perform the installation of all necessary components for OLGA-S. 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:

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.

3.1 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.


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:


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 @.

is the port number used by FlexLM. This is normally not used in the license files.

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@.


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 @ e.g. @server1.


is the port number used by FlexLM. This port number can be set in the license

file. 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.


4.5 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 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.

1. INTRODUCTION2. REQUIREMENTS2.1 Recommended hardware2.2 Required software

3. INSTALLATION OF OLGA-S 3.1 Note on administrator privileges3.2 Uninstalling OLGA-S

4. FLEXLM INSTALLATION ON WINDOWS4.1 Requirements4.2 Installation of FlexLM 4.3 License configurationA. Use a license server on this machine (Local license server)B. Connect to a network license server

4.4 System info4.5 License files4.6 TCP/IP Windows

OLGA-S_2014-1 AboutOLGA-S.pdf1. WHAT IS OLGA-S2. FREQUENTLY ASKED QUESTIONS2.1 Which Multiphase correlation do I use for my system?2.2 What does it mean that OLGA-S is a mechanistic model?2.3 When do I use the two phase and when do I use the three phase version of OLGA-S?2.4 What about atmospheric conditions? 2.5 What about heavy oils?2.6 What is the accuracy of OLGA-S?

olga 2014 installation guide

Documents