OLGA 2020 Version 2020.1 Installation guide OLGA Installation guide Copyright © 2020 Schlumberger. All rights reserved. This work contains the confidential and proprietary trade secrets of Schlumberger and may not be copied or stored in an information retrieval system, transferred, used, distributed, translated or retransmitted in any form or by any means, electronic or mechanical, in whole or in part, without the express written permission of the copyright owner. Trademarks & Service Marks Schlumberger, the Schlumberger logotype, and other words or symbols used to identify the products and services described herein are either trademarks, trade names or service marks of Schlumberger and its licensors, or are the property of their respective owners. These marks may not be copied, imitated or used, in whole or in part, without the express prior written permission of Schlumberger. In addition, covers, page headers, custom graphics, icons, and other design elements may be service marks, trademarks, and/or trade dress of Schlumberger, and may not be copied, imitated, or used, in whole or in part, without the express prior written permission of Schlumberger. Other company, product, and service names are the properties of their respective owners. An asterisk (*) is used throughout this document to designate a mark of Schlumberger. Security Notice The software described herein is configured to operate with at least the minimum specifications set out by Schlumberger. You are advised that such minimum specifications are merely recommendations and not intended to be limiting to configurations that may be used to operate the software. Similarly, you are advised that the software should be operated in a secure environment whether such software is operated across a network, on a single system and/or on a plurality of systems. It is up to you to configure and maintain your networks and/or system(s) in a secure manner. If you have further questions as to recommendations regarding recommended specifications or security, please feel free to contact your local Schlumberger representative. -2Schlumberger Private OLGA Installation guide Table of contents Table of contents Introduction Security notice Requirements OLGA installation Install OLGA in silent mode Install OLGA Namespace Explorer Uninstall OLGA License configuration 3 4 4 5 6 7 8 8 9 -3Schlumberger Private OLGA Installation guide Introduction The OLGA* dynamic multiphase simulator software package installation is comprised of the following: l OLGA Engine (dynamic multiphase flow simulator). l OLGA GUI (graphical user interface). l RMO (Risk Management and Optimization) l OLGA Viewer. l OLGA-S. l Multiphase Toolkit. l OPC server functionality. l OLGA Namespace Explorer. l OLGA Excel tool. l OLGA-SDK. l OLGA AppLauncher. The following modules are also available but require additional licenses: l OLGA FEMTherm Viewer. l Mud Property Table (by WFD). l OLGA ROCX (near-wellbore reservoir model). l Multiflash. The installation also includes the following required Windows® packages: l Microsoft® Visual C++® Redistributable for Microsoft Visual Studio® 2010, 2012, 2013 and 2017. l Microsoft MPI (MS-MPI) Redistributable version 9. The Schlumberger Software Support Hub provides useful information about the product and a knowledge base. Contact Schlumberger if you encounter problems with the OLGA software package. Security notice Follow these security guidelines to reduce vulnerability when using OLGA: l Make sure that you follow the security policy set for your company. l Make sure that only trusted applications are installed on your computer. l Make sure that all confidential data are encrypted. l Make sure that malware protection software is installed and updated on your computer. l All systems, including personal devices, used to connect to the Internet via a personal Internet Service Provider must have a personal firewall or firewall appliance installed and enabled. -4Schlumberger Private OLGA Installation guide l Do not share entire disk drives. File sharing permissions must be set to the minimum access necessary. You must only allow access to those individuals that must see specific data. l Do not use file sharing software or similar peer-to-peer systems. These services enable access by outsiders to many file types on your device, often without your knowledge. l Make sure that 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. Requirements Recommended hardware See Schlumberger Software Support Hub for information. Screen resolution for OLGA GUI The minimum screen resolution recommended for using the OLGA GUI is 1024 x 768. Officially supported platforms l l Operating systems: o Windows 10 (64). o Windows Server 2012 (64). o Windows Server 2016 (64). Microsoft .NET Framework (x86) o o .NET 4.6.1. .NET 4.0 Full profile. You can also run OLGA on other operating systems, but they are not officially supported by us. -5Schlumberger Private OLGA Installation guide OLGA installation The installation program installs all the necessary components for OLGA and the OLGA Graphical User Interface (GUI). Note: You must have administrator privileges to install OLGA. Because of the User Account Control (UAC) on Windows, you are prompted to allow the installation to run, even if you are logged in as an administrator. You must click Yes. The installation verifies that all the required software components are installed when installing OLGA. The required software components are: l .NET Framework (x86) version 4.6.1 and 4.0. l Visual C++ redistributable for Visual Studio 2010. l Visual C++ redistributable for Visual Studio 2012 update 4. l Visual C++ redistributable for Visual Studio 2013. l Visual C++ redistributable for Visual Studio 2017. If you do not have the correct version of .NET Framework installed, you are guided to the download page for .Net 4.6.1. If any of the Visual C++ redistributables are missing, the installation will install them. When the installation of OLGA starts, follow the instructions on-screen. You can select between a Quick installation and a Custom installation. The quick installation selects default components and installs to the default installation folder without any further user interaction. The following components are included in the default installation: l OLGA GUI. l OLGA Engine. l OPC server functionality. l OLGA Namespace Explorer. l RMO. l OLGA-S and Multiphase toolkit. l Multiflash. l Desktop shortcut. l Microsoft MPI (MS-MPI). In the custom installation, you select which components to install and you can also set the installation folder. The OLGA GUI and OLGA Engine will always be installed. In addition to the components in a default installation, you can select to install the following components: l OLGA-SDK. l OPC servers for non-admin users. -6Schlumberger Private OLGA Installation guide l OLGA Excel tool (requires Microsoft Excel). l OLGA AppLauncher. Note: Make sure that you include all components that you need. If you later want to add additional components, you must uninstall and then reinstall with the correct set of components. If you select OLGA-SDK, the development kit for OLGA extensions is installed, provided that you have the required software component MS Visual Studio 2017 installed. You are asked to confirm that you want to install OLGA-SDK later in the installation. Refer to the OLGA Help and the OLGA SDK developer’s guide available in the installation folder for more details about OLGA extensions. If you select OPC servers for non-admin users, five OPC servers are installed, named OLGAOPCServer, OLGAOPCServer1, OLGAOPCServer2, OLGAOPCServer3, and OLGAOPCServer4. By default, you must have administrator privileges to run OLGA simulations using an OPC server. These pre-installed OPC servers enable you to run OLGA OPC server simulations without administrator rights. Note: You must have a valid OLGA license to pre-install OPC servers. If you select OLGA-APPLAUNCHER, the installer will copy the AppLauncher SDK files as a zip file into the Tools\AppLauncher folder in the installation folder. The developer’s guide included in the zip file provides more information on how to make use of the AppLauncher SDK. MS-MPI is required for submodeling and for the OLGA-ECLIPSE link. If another version of MS-MPI is installed, the installer asks if you want to upgrade to the current version. Install OLGA in silent mode You can install and uninstall OLGA without any user interaction. To do this, you must start the installer with the /S command line option. When you run the installer in silent mode, the default installation folder is used and the following components are installed: l OLGA GUI. l OLGA Engine. l OPC server functionality. l OLGA Namespace Explorer. l RMO. l Multiphase toolkit. l Multiflash. l Desktop shortcut. l Microsoft MPI (MS-MPI). Note: You must have administrator privileges to install OLGA. Because of the User Account Control (UAC) on Windows, you are prompted to allow the installation to run, even if you are logged in as an administrator. You must click Yes. -7Schlumberger Private OLGA Installation guide Install OLGA Namespace Explorer The OLGA installation comprises a 64-bit version of OLGA Namespace Explorer (ONE) which is installed by default. When there is a previous 32-bit version of ONE or 32-bit APIS Foundation installed, the following error message will appear during installation. Figure 1 APIS Management studio message If this happens, uninstall all ONE installations, including the current failed one, and the 32-bit APIS Foundation if there is any. To do this, under Windows Settings, select Apps, and then reinstall OLGA. Uninstall OLGA Under Windows Settings, select Apps. Select the relevant OLGA version in the list, and then click Uninstall. Note: OLGA-S, OLGA Excel tool, OLGA Namespace Explorer, and OLGA-SDK are installed as separate components. To remove these components, locate them in the list, and then click Uninstall. If OLGA is running, you must close OLGA before the uninstall can continue. If any of the other tools that are installed with OLGA are running while you uninstall OLGA, you do not get a warning message. After you uninstall OLGA, some files from these tools may not be removed. However, you can safely delete these files manually. Note: For OLGA 2014.2 and later, previous patch installations of OLGA are not uninstalled when you install a new version of OLGA. -8Schlumberger Private OLGA Installation guide License configuration You must set up the license with Schlumberger License Server version 2020.1. The license server installer is available from the Schlumberger Software Download Center under More Supported Products > Utilities > FLEXlm. Details on how to configure the license server are available in the Schlumberger Licensing user guide in the Schlumberger Licensing installation directory. Note: You must set up the environment variable SCPLMD_LICENSE_FILE to point to the same license server as the environment variable SLBSLS_LICENSE_FILE. -9Schlumberger Private