Studio Techlog 2018 1 Installation Configuration Guide
Studio Techlog 2018 1 Installation Configuration Guide
Version 2013.5
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.
2 Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Studio Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Configuring Studio Techlog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Installation and Configuration Workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Studio Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Studio Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Studio Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Version Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Studio Manager 2018 Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Contents v
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Downloading the Installation Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
Installing Studio Server 2018 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
Studio Service Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
Studio Server Config File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Studio Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
Installing the Database on a Fresh Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Upgrading Studio Database from 2016.x and 2017.x to 2018.1 . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
Upgrading Repositories from 2016.x and 2017.x to 2018.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11
Setting Default Studio Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13
Running the Windows PowerShell Script for Database Configuration . . . . . . . . . . . . . . . . . . 7-14
Running the ValidationManager Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14
List of Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17
Validation Manager Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21
8 Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
Studio Database Accounts Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2
Fixed Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .D-2
Variable Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2
Studio Database Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-4
STUDIO_SYS_ ADMINISTRATOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-4
STUDIO_SYS_
UPGRADE_ROLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-4
Contents vii
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1
Characters Restricted for Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-2
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-2
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-1
Glossary Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Data Pump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Default Tablespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Keytab File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Local Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
ORACLE_HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Oracle Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
Oracle SYS Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
Remote Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
STUDIO_SERVICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
STUDIO_SYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
Temporary Tablespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
TNS_Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
TNS Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-4
In This Section
About Schlumberger is the leading oilfield services provider, trusted to deliver superior
Schlumberger results and improved E&P performance for oil and gas companies around the world.
Through our well site operations and in our research and engineering facilities, we
develop products, services, and solutions that optimize customer performance in a
safe and environmentally sound manner.
Alert Statements The alerting statements are Notes, Cautions, and Warnings. These statements are
formatted in the following style:
• • • • • •
Note: Information that is incidental to the main text flow, or to an important
point or tip provided in addition to the previous statement or instruction.
• • • • • •
Caution: Advises of machine or data error that could occur should the user fail
to take or avoid a specified action.
• • • • • •
Warning: Requires immediate action by the user to prevent actual loss of data
or where an action is irreversible, or when physical damage to the
machine or devices is possible.
Contacting Schlumberger
Technical Support Schlumberger has sales and support offices around the world. For information on
contacting Schlumberger, please refer to the information below.
In This Chapter
Introduction............................................................................................... 2-2
Audience ............................................................................................. 2-2
Studio Overview ......................................................................................... 2-3
Studio 2-1
Schlumberger Private - Customer Use
Introduction
Introduction
This chapter provides a quick view of Studio and its capabilities.
Audience This chapter is intended for the user who wants to learn more about Studio. It
describes the Studio environment and the general functionalities.
Studio Overview
The Studio E&P environment empowers a level of usability and productivity that
supports an E&P organization’s quest to streamline and optimize its workflow across
the asset lifecycle, while also capturing vital knowledge to maximize personal and
team productivity. It features a powerful set of tools that allow geoscientists and
engineers to access, review, and use information in the context of their workflows,
providing three key capabilities that increase productivity.
• Find Your Information
Studio provides a fast, powerful and intuitive way to search, identify and consume
information in the context of your project and workflows. Filter multiple
information sources on any value of metadata, display results in a variety of ways,
and either consume the information directly into your working environment or
share your results with others. Find empowers a new level of data discovery,
putting the information you need right where you need it.
• Collaborate with Your Team
Studio promotes collaboration by enabling team members to promote those
elements of their project that are of relevance to the rest of the team or business.
Capturing the status and quality of interpretation as it is published to Studio
ensures integrity and reliability for other team members both now and into the
future. Subscribing to notifications on data of interest, team members can receive
alerts on the work of others that is relevant to their current workflow.
• Manage Your Knowledge
Studio provides a proven, scalable database supported by industry standard
technology (Oracle® and Microsoft® SQL Server®). It is specifically designed to
handle E&P project data as well as the knowledge related to that data, all stored
together in context. This allows users to obtain better retention and reuse of the
generated knowledge.
Studio 2-3
Schlumberger Private - Customer Use
Studio Overview
In This Section
Introduction............................................................................................... 3-2
Audience ............................................................................................. 3-2
Configuring Studio Techlog ......................................................................... 3-3
Installation and Configuration Workflows ..................................................... 3-5
Introduction
This chapter provides a quick view of the different workflows covered in this
document. See “Installation and Configuration Workflows” on page 3-5 for
information showing where you can find more details related to each step required
in the workflows.
Audience This chapter is intended for the data manager or data administrator who installs and
maintains Studio in a system environment. It describes the workflows for installation
and uninstallation of Studio.
The following shows the general workflow for configuring Studio Techlog.
Prerequisites
• Windows Server (IIS) (Details in Appendix C)
In This Chapter
Introduction............................................................................................... 4-2
Audience ............................................................................................. 4-2
Studio Manager .......................................................................................... 4-3
Studio Database ......................................................................................... 4-4
Oracle ................................................................................................. 4-4
SQL Server........................................................................................... 4-5
Studio Server ............................................................................................. 4-6
Introduction
This chapter provides details of the different system requirements needed to install
and configure the Studio products.
Audience This chapter is intended for the administrator and user who need to know the
different system requirements needed for the Studio products.
Studio Manager
Table 4-1 and Table list the minimum and recommended system requirements for
Studio Manager. Any systems not mentioned within the scope of this document will
not be officially supported for use.
Recommended
Operating system Windows Server 2016 SP1 Standard (64-bit)
Windows 10 Pro or Enterprise (64-bit)
Processor Dual quad-core/six-core processor (quad-core processor
minimum) (best with a fast clock speed and high cache)
Memory 48 GB DDR3 SDRAM (16 GB minimum)
Display Quality of the viewing experience increases with size and
number of monitors
Graphics NVIDIA® Quadro® 6000 (NVIDIA Quadro 4000 minimum)
Primary storage • Fast rotational speed HDD (10K, 15K)
• SSD
Secondary storage Optional
Studio Database
Oracle
Operating Environment Studio Database is certified for use with a Red Hat® Enterprise Linux® (RHEL)
operating system and must be used with the Oracle® Database Enterprise Edition
12.2.0.1 database.
• • • • • •
Note: Linux is the only commercially supported operating system for Studio
Database on Oracle.
System Hardware Studio Database should be installed on a computer with the appropriate hardware
Requirements resources in order to maximize software performance. Table 4-3 contains guidelines
for both minimum and recommended system hardware levels. The Oracle server
may require significant resources, depending on the number and size of the
databases, and the number of simultaneous users. The amount of RAM should be
sized accordingly.
Table 4-3 System Hardware Requirements
Recommended
Processor x64 processor (dual six-core) (x64 processor [dual quad-core]
minimum)
Memory 64 GB or greater (32 GB minimum)
SQL Server
Operating Environment Studio Database for SQL Server is certified for use with SQL Server 2016 SP1
Standard Edition, on Windows Server 2016 Standard (64-bit), and Windows Server
2012 R2 Standard (64-bit).
System Hardware Studio Database should be installed on a computer with the appropriate hardware
Requirements resources to maximize software performance. Table 4-4 contains guidelines for both
minimum and recommended system hardware levels. SQL Server may require
significant resources, depending on the number and size of the databases, and the
number of simultaneous users. The amount of RAM should be sized accordingly.
Table 4-4 System Hardware Requirements
Recommended
Processor x64 processor (dual quad-core) (x64 processor [quad-core]
minimum)
Memory 64 GB or greater (32 minimum)
• • • • • •
Note: Information on memory limitations for Windows Server 2016 can be found
at the following link:
https://msdn.microsoft.com/en-us/library/windows/desktop/
aa366778(v=vs.85).aspx
Studio Server
Studio Server should be installed on a computer with the appropriate hardware
resources to maximize software performance. Table 4-5 contains guidelines for both
minimum and recommended system requirements.
Table 4-5 Studio Server System Requirements
Recommended
Operating system Windows Server 2016 Standard (64-bit)
Windows Server 2012 R2 Standard (64-bit)
Processor x64 processor (dual six-core) (x64 processor [dual quad-
core] minimum)
Memory 64 GB or greater (48 GB minimum)
Web Server IIS 10
Disk Space† 50 GB
• • • • • •
Note: The number formats that Windows uses to display information (Region
and Language settings) between the Studio Server machine and client
machines must be the same; different number formats between the Studio
Server and client machines can prevent data transfer. Specifically, the
“Decimal symbol” and the “Digit grouping” settings must be the same
between the Studio Server machine and client machines. In addition, the
language for the Operating System must be English (US) on both the
Studio Server machine and client machines.
Introduction
Studio Manager comprises a suite of tools for effectively managing the Studio
environment. It consolidates administrative and core data management workflows
supporting Studio Techlog. Using Studio Manager, data managers quickly
understand the state of their Studio environment by using cutting-edge applications
("apps") to ascertain the status of repositories, identify tasks that need to be
performed, and perform the workflows surrounding those tasks.
Studio Manager also shows high-level information in “widgets”, which you can
display or hide.
Studio Manager includes the following key workflows and capabilities:
• Clean and streamlined app-based interface in which all apps are accessible from a
centralized App Gallery that is organized into categories (Browse, Correct,
Administer, and Organize)
• Message Center that keeps data managers informed of data administration and
data transfer issues
• Ability to use match rules, and configure the Studio Database in Oracle and
Microsoft SQL Server
• Administer and centrally manage coordinate systems, unit aliases, users, and
Techlog data
Version The following shows which versions of Studio Database and Techlog are compatible
Compatibility with Studio Manager 2018.1
• Studio Database 2018.1
• Techlog 2018.1
• Studio Server 2018.1
Audience This chapter is intended for the data manager or data administrator who installs and
maintains Studio Manager in a system environment. It describes the requirements
and procedures for installation and configuration of Studio Manager. You must be a
Windows® Administrator to install Studio Manager.
Licensing
To run Studio Manager 2018, you need valid licenses for this release. The licenses
can be configured either locally on your computer or on a central license server.
Studio Manager 2018 requires Schlumberger Licensing 2018, which is distributed on
the Techlog DVD. Studio Manager version 2018 will not work with Schlumberger
Licensing 2015. The 2018 version of the Schlumberger Licensing tool is backward
compatible with all previous release versions. Schlumberger Licensing 2018 is based
on Flexera™ FlexNet Publisher® to provide a secure licensing solution. See
“Updating Studio Manager from 2016.x and 2017.x to 2018.1” on page 5-13.
Accessing Licenses Studio Manager is a licensed application and has two associated licenses, depending
on features that are intended to be used in your organization:
• License for connection of Studio Manager to Studio Database running on Oracle
• License for connection of Studio Manager to Studio Database running on Microsoft
SQL Server
A suitable database license is checked out upon connecting to a database. To order
licenses, please visit the Ocean store at www.ocean.slb.com.
• • • • • •
Note: For information about the Schlumberger Licensing tool, see the
Schlumberger Licensing User Guide, which can be accessed through the
online Help for the Schlumberger Licensing tool.
• • • • • •
Note: If you are a new user of the Software Download Center, you must register
before you can download the Studio Techlog installer.
To Download the Studio Techlog installer from the Software Download
Center
1 Go to www.sdc.oilfield.slb.com.
2 Click SIS Software Download Center.
3 Log in to the site.
4 On the Welcome Message page, click Continue.
5 In the Product Group Name list (in the upper-left corner), click Techlog.
6 In the table of Techlog downloads, click the Download icon for the
Techlog20181_Studio2018_x64.zip file.
Installation This section covers the installation process for Studio Manager, which is installed
using the Studio Techlog installer. The requirement for running the Studio Techlog
installer is Microsoft .NET Framework 4.6.1.
• • • • • •
Note: If you obtained the software from the Software Download Center, you
must unzip the Techlog20181_Studio2018_x64.zip file before being
able to use the Studio Techlog installer.
• • • • • •
Note: All users who run Studio Manager on their workstations must have
read/write permissions to the %ProgramData% folder, usually
C:\ProgramData (used by internal application components).
• • • • • •
Note: Only a Windows Administrator can run the installer program.
• • • • • •
Note: If you click Documentation, you can view the available release
documents found in the Documentation folder on the Techlog DVD.
A check is done to make sure all the prerequisites meet the recommended
requirements for a successful installation. The prerequisite check is done for
the Operating System, Microsoft .NET Framework, Microsoft Visual C++
Runtime, and Microsoft System CLR Types For Microsoft SQL Server.
• • • • • •
Note: Studio Server requires .NET 4.6.1 or higher.
• • • • • •
Note: Visual C++ Runtime and System CLR Types for SQL Server are installed
silently on a non-Windows Server machine and with a prompt on a
Windows Server machine.
• - Warning
• - Error
• • • • • •
Note: During the prerequisite check, if any prerequisite is identified as being
different than what is recommended, but will not cause the installation to
fail, a warning will display and you will still be able to proceed with the
installation. However, if an error displays for a prerequisite, you will not be
able to proceed with the installation. You can hover over any icon to
display a tooltip, which gives you additional information.
• • • • • •
Note: If the installed .NET version is older than the required version, an error
displays during the prerequisite check, and you cannot proceed with the
installation. We recommend that you install the required .NET version,
which is available in the installation package.
4 If the requirements for the prerequisites have been met, click Next.
The Install Studio Manager to panel displays.
5 Do the following:
a. Accept the default folder, or click to select the folder where you want to
install Studio Manager.
b. To add a shortcut for Studio Manager 2018 to the desktop, select Add
desktop shortcut.
6 Click Next.
The Ready to install Studio Manager 2018 panel displays.
7 Click Install.
After the Studio Manager installation is finished, the Setup Successful panel
displays.
8 Do the following:
a. If you do not want to install the plug-in or you want to install it later, click
Close.
b. If you want to proceed with the plug-in installation, click Plug-ins.
The Select Plug-In Source Location panel displays.
• • • • • •
Note: You can view the plug-ins and extensions that are currently installed by
selecting Show currently installed Plug-ins and Extensions.
• • • • • •
Note: Required plug-ins are selected by default; however, you have the option to
clear the check box for any plug-in you do not want installed.
11 Click Next.
The Ready to install Studio Manager Plug-ins and Extensions panel displays.
12 Click Install.
During the installation of a plug-in, the installer gives you status updates. After
the plug-in is installed, a confirmation panel displays, showing how many files
were unzipped during the installation and confirming that the plug-in is
registered. This process is repeated for each plug-in that is installed.
When the installation of the plug-in is finished, you will see a confirmation that
the plug-in has been installed.
13 Click Back if you want to install any plug-ins from other folders or click Close
to exit.
• • • • • •
Note: Only a Windows Administrator can run the installer program.
Updating and To Update Studio Manager Plug-ins from the Studio Techlog installer
Managing Plug-ins
1 From the Select Studio Component panel, select Studio Manager 2018.
2 Click Plug-ins.
The Select Plug-in Source Location panel displays.
• • • • • •
Note: You can view the plug-ins and extensions that are currently installed by
selecting Show currently installed Plug-ins and Extensions.
• • • • • •
Note: Required plug-ins are selected by default; however, you have the option to
clear the check box for any plug-in you do not want updated.
5 Click Next.
The Ready to install Studio Manager Plug-ins and Extensions panel displays.
6 Click Install.
When the update of the plug-in is finished, you will see a confirmation that the
plug-in has been updated.
7 Click Back if you want to update any plug-ins from other folders or click Close
to exit.
CodeMeter Studio Manager 2017 uses the CodeMeter dongle for license authentication. Before
you insert your CodeMeter dongle into a USB port on your local workstation or on a
central license server, you must install the CodeMeter software. You should use
CodeMeter in the following circumstances:
• If you use a local license (that is, your local workstation is your local license
server), install the CodeMeter dongle, appropriate CodeMeter driver, and the
Schlumberger Licensing tool on your computer.
Installing these licensing tools on your computer is also helpful if your company is
using enterprise license mobility.
• If you use a license on a central license server, the Administrator installs
the CodeMeter dongle, CodeMeter driver, and the Schlumberger Licensing tool on
the server. Individual users do not need to install any licensing hardware or
software on their computers.
Installing Follow the steps in this section to install the CodeMeter version required for this
CodeMeter Studio Manager release, and uninstall previous versions.
To Install CodeMeter
• • • • • •
Note: CodeMeter automatically installs in your default Program Files directory:
%programfiles%\CodeMeter (usually C:\Program Files).
1 On the Techlog DVD, in the root folder, open the Licensing folder and run
CodeMeterRuntime.exe.
Alternatively, go to the CodeMeter Web site (www.codemeter.com) and
download CodeMeter 6.3 from the web site.
The CodeMeter installation wizard opens.
2 On the Welcome panel, click Next.
3 On the License Agreement panel, read the agreement, select I accept the
license agreement, and then click Next.
4 On the User Information panel, enter your name, your company’s name, and
who will use CodeMeter on your computer, and then click Next.
5 On the Select Features panel, select the features you want to install and then
click Next.
Schlumberger recommends that you accept the default settings.
6 On the Ready to Install panel, click Next to begin the installation.
7 When the installation is complete, on the last panel click Finish.
8 Restart your computer.
The CodeMeter icon appears in your Windows taskbar. When you insert
your CodeMeter dongle into the USB port, the icon changes to show that
your computer recognizes the dongle. If you double-click the icon, you can
view information about the dongle.
You are ready to install the Schlumberger Licensing tool.
Schlumberger Studio Manager uses FlexNet for licensing. The Schlumberger Licensing tool is a
Licensing Tool simple interface for FlexNet. Using the Schlumberger Licensing Tool to configure and
manage your Studio Manager license is recommended, but you may use FlexNet
tools instead.
After you install CodeMeter on your computer, you must install the Schlumberger
Licensing tool. You will use the Schlumberger Licensing tool to configure your Studio
Manager license. This version of the Schlumberger Licensing tool uses FlexNet.
Install the Schlumberger Licensing tool as follows:
• If you use a local license (that is, your local workstation is your local license
server), install the licensing tool on your computer.
• If you use a license on a central license server, the Administrator installs the
licensing tool on the server. The Schlumberger Licensing tool is not required for
the Administrator to install, configure, and manage the Studio Manager license.
The Administrator may choose to manage Studio Manager licenses with FlexNet
native tools.
• If you use enterprise license mobility, the Administrator must install the
licensing tool on your server for when you are in your office. You must also install
the licensing tool on your laptop for the times you are out of the office.
• • • • • •
Important: Even if you connect to a central license server to run Studio
Manager in the office, you must install the Schlumberger Licensing
tool and a local license on your laptop to run Studio Manager from
your laptop while traveling.
Installing the Follow the steps in this section to install the Schlumberger Licensing tool. If you
Schlumberger have a previous version of the licensing tool and want the latest version, uninstall
Licensing Tool the older version and then install the latest version.
• • • • • •
Note: If you use the 2015 version of the Schlumberger Licensing tool when
connecting to Studio Manager 2018, you will receive the following error
message: "License checkout failed. Make sure you're connecting to 2018
license server. 2015 license servers are not supported."
Configuring the For information on configuring the Studio Manager license, see the online Help for
Studio Manager the Schlumberger Licensing tool.
License
• • • • • •
Note: Studio Manager uses the SLBSLS_LICENSE_FILE license server
environment variable. Other Schlumberger applications may also use this
variable.
The first time that you launch Studio Manager 2018, you may see a message
stating that Studio Manager finds no licenses or that license checkout failed.
The message appears under the following circumstances:
• SLBSLS_LICENSE_FILE variable has not yet been defined.
• The license server contains no Studio Manager licenses.
• The Studio Manager license is not valid.
• You are connecting to a 2015 or older license server. Only a 2018 license
server is supported.
• • • • • •
Note: If the message appears after the first time you open Studio Manager and
have already defined the license server, there may be a problem in
connecting to the license server.
In This Chapter
Introduction............................................................................................... 6-2
Audience ............................................................................................. 6-2
Downloading the Installation Package .......................................................... 6-3
Installing Studio Server 2018....................................................................... 6-4
Installation........................................................................................... 6-4
Studio Service Account ..............................................................................6-10
Studio Server Config File ............................................................................6-11
Introduction
Studio Server is the web-service middle tier that bridges the communication
between client applications and the Studio Database.
Audience This chapter is intended for the web server administrator who installs and maintains
Studio Server in a system environment. It describes the requirements and
procedures for installation and configuration of Studio Server.
• • • • • •
Note: If you are a new user of the Software Download Center, you must register
before you can download the Studio Techlog installer.
• • • • • •
Note: You may already have this package, if you have installed Studio Manager
2018.
To Download the Studio Techlog installer from the Software Download
Center
1 Go to www.sdc.oilfield.slb.com.
2 Click SIS Software Download Center.
3 Log in to the site.
4 On the Welcome Message page, click Continue.
5 In the Product Group Name list (in the upper-left corner), click Techlog.
6 In the table of Techlog downloads, click the Download icon for the
Techlog20181_Studio2018_x64.zip file.
Installation This section covers the installation process for Studio Server, which is installed using
the Studio Techlog installer. The requirement for running the Studio Techlog installer
is Microsoft .NET Framework 3.5.
• • • • • •
Note: If you obtained the software from the Software Download Center, you
must unzip the Techlog20181_Studio2018_x64.zip file before being
able to use the Studio Techlog installer.
• • • • • •
Note: Only a Windows Administrator can run the installer program.
• • • • • •
Note: For Windows Server 2016, if not installed, the .NET Framework 3.5 must
be installed.
• • • • • •
Important: If you have already a Studio server installed from a previous
version, make sure that the physical path is different, and copy the
ConfigOverride folder (and content) from the 2016.x or 2017.x
installation in the root folder of the 2018.1 Studio server.
The following lists the prerequisites that are validated during the Studio Server
installation process:
• Windows Server 2016 Standard edition (64-bit) with IIS 10 installed.
- See “Configuring IIS 10 with the Recommended Features” on page C-2
- ASP.NET 4.5
- Common HTTP Features->Static Content = "On"
• Microsoft. NET 4.6.1 and higher
• Microsoft Visual C++ 2010 SP1 (x64) Redistributable Package (will be installed if
not on the machine and the user chooses to install)
• Microsoft Visual C++ 2012 Update 4 (x64) Redistributable Package (will be
installed if not on the machine and the user chooses to install)
• Microsoft Visual C++ 2013 Update 2 (x64) Redistributable Package (will be
installed if not on the machine and the user chooses to install)
• Microsoft Visual C++ 2015 Update (x64) Redistributable Package (will be installed
if not on the machine and the user chooses to install)
• Database client dependent on Studio Database; either:
• • • • • •
Note: If you click Documentation, you can view the available release
documents found in the Documentation folder on the Techlog DVD.
A check is done to make sure all the prerequisites meet the recommended
requirements for a successful installation. The prerequisite check is done for
the required Operating System, the required versions of Microsoft .NET
Framework and Microsoft Visual C++ Runtime, and the correct configuration of
Internet Information Services (IIS).
During the prerequisite check, a prerequisite is verified by one of the following:
• - Warning
• - Error
• • • • • •
Note: During the prerequisite check, if any prerequisite is identified as being
different than what is recommended, but will not cause the installation to
fail, a warning will display and you will still be able to proceed with the
installation. However, if an error displays for a prerequisite, you will not be
Studio Server 6-7
able to proceed with the installation. You can hover over either a warning
icon or an error icon to display a tooltip, which gives you information
about the warning or error condition.
• • • • • •
Note: If the installed .NET version is older than the required version, an error
displays during the prerequisite check, and you cannot proceed with the
installation. We recommend that you install the required .NET version,
which is available in the installation package.
4 If the requirements for the prerequisites have been met, click Next.
The Studio Techlog Server options panel displays.
5 Do the following:
a. Enter the name of the website to be created.
b. Enter the port number to be used.
c. Enter the folder location for the log files.
• • • • • •
Important: Studio Server is installed on a specific port (default=50231) on the
web server. The port number is incremented if the default port is
already in use. For users to access this server, this port must be
added to the Firewall Inbound/Outbound Exception Rules on the
web server in accordance with your security constraints. Failure to
do so will render your Studio Server inaccessible to clients.
6 Click Next.
The Install Studio Techlog Server to panel displays.
7 Select the location where you want to install Studio Server and click Next.
The Database connection information panel displays.
8 Do the following:
a. In the Provider: field, enter the type of database (Oracle or SQL Server) to
be connected.
b. In the Host: field, enter the host name or the IP address of the database
host.
c. In the Port: field, enter the database port number.
d. In the Database name: field, enter the name of the instance.
9 Click Next.
The Database Client Prerequisite check panel displays. A check is done for the
existence of either an Oracle or SQL Server Client.
The database client prerequisite is related to the database selected on the previous
page.
Studio Server supports SQL Server 2016, therefore the prerequisites will only check
for the presence of SQL Server 2016.
If this is not the case, an error is shown and you must manually install SQL Server
2016.
10 Click Next.
The Ready to install Studio Techlog Server 2018 panel displays.
11 Click Install.
12 When the installation is finished, a link to Studio Server displays. You can click
this link to verify the Server is accessible.
This page shows various pieces of information on product versions and other
version numbers for Studio Server, as well as important information for the
Oracle/SQL Server Database that can be used for maintenance and monitoring
purposes.
This includes:
• Database — The database for which the corresponding tablespace/file group
listed is for (SQL Server)
• Tablespace/File Group — Name of the tablespace (Oracle) or file group (SQL
Server) being used
• Current Size (GB) — Current size (in GB) of the tablespace/file group
• Max Size (GB) — Maximum size (in GB) of the tablespace/file group
• Free Space (GB) — The amount of the free space (in GB) in a tablespace/file
group
• % Free — The percentage of the free space in a tablespace/file group
• Auto Extend — Indicates if the tablespace/file group is auto extensible
• Data Files — Data files constituting the storage for a tablespace/file group (file
names only)
13 Click Close.
• • • • • •
Note: Since the STUDIO_SERVICE account is the default account, if you
defined a different Studio Service account name, then use that account
name instead of STUDIO_SERVICE.
• • • • • •
Important: Making changes to the StudioSettings.Techlog.json file while
IIS is running may cause the server to hang or crash.
[
{
"Name": "DatabaseUserId",
"Value":
"R8W3emIHEaQiJrZ3xU/4eIPskW2woV+2uwUwffc/rxMVRDRjQ2r/SFeEqvc33G7kY1qY
OdyV/WfXLKy4a2RrJw==",
"IsSecure": true
},
{
"Name": "DatabasePassword",
"Value":
"7jJDUGOLRbOZsYY34J63UlV2dRNptG28N6eJoINO977U2xL8+0MD2qJ8Y+xf3LP2LVK
m83Nq2HIUh1dZSZhJPA==",
"IsSecure": true
}
7 Studio Database
In This Chapter
Introduction............................................................................................... 7-2
Audience ............................................................................................. 7-2
Studio Database ......................................................................................... 7-3
Compatibility .............................................................................................. 7-4
Installing the Database on a Fresh Server Installation ................................... 7-5
Upgrading Studio Database from 2016.x and 2017.x to 2018.1 ...................... 7-8
Upgrading Repositories from 2016.x and 2017.x to 2018.1 ...........................7-11
Setting Default Studio Validation Rules........................................................7-13
Setting Default Studio Validation Rules........................................................7-13
Prerequisites .......................................................................................7-13
Running the Windows PowerShell Script for Database Configuration .......7-14
Running the ValidationManager Script ...................................................7-14
List of Validation Rules.........................................................................7-17
Validation Manager Report .........................................................................7-21
Introduction
Studio Database includes all the database schema required to cover the data model
for the different data types covered by Studio, the database functions, and the
procedures associated with the schema. This chapter provides the different
workflows to configure the Studio Database and the compatibility between the
different versions of Studio Database and Studio Manager.
Audience This chapter is intended for the data administrator or system administrator who
installs and maintains the Studio Database in a system environment.
Studio Database
The workflows for installing and configuring the Oracle and SQL Server databases
are shown in this section. For information on configuring Studio Database using
Studio Manager, see the Studio Manager online Help. The following workflow
describes the steps to install or upgrade/update your Studio Database.
Compatibility
The following chart shows which versions of Studio Manager/Studio Server and
Studio Database repositories are compatible.
Table 7-1 Version Compatibility Matrix
Studio
Database 2015.1 2015.2 2015.3 2016.1 2016.2 2017.1 2017.2 2018.2
Studio Manager/
Studio Server
2015.2 Full No No No No No No No
2015.3 Update Full No No No No No No
2015.4 Update Update Full No No No No No
2015.5 Update Update Full No No No No No
4 Once the server is listed, use the “test connection” . At this step, the
connection test fails as there is not database installed.
For Oracle database, the service account and the studio_sys are used with their
associated passwords.
• • • • • •
Note: The Backup/Recover folder depends on the installation of Oracle on Linux.
8 For SQL database, the SuperAdmin account is user-defined during the SQL
database creation. Studio_service and the associated passwords are used the
same way as for Oracle.
9 Provide all SQL server database locations which have been set up during SQL
Database creation.
It can take some time to install the database. When it is done, the following
message displays:
Server information is updated in the same Connections dialog box and it is not
possible to install the database. Only the uninstallation is available.
Application log confirms information on the newly installed database and the logs
are available from this window.
• • • • • •
Note: For the two Oracle database administrator user accounts, SYSTEM and
SYS, only the SYSTEM user can perform the database upgrade.
• • • • • •
Note: If you try to log in to this server without upgrading the database, you will
receive the following error message: “Server is incompatible with
database. Use database configurator to perform required ‘Upgrade’
operation.”
• • • • • •
Note: IIS needs to be restarted after a database upgrade, especially if the
database credentials are changed.
3 After you have created the connection, click to return to the newly
created connection in the Connections dialog box and click Connect and get
4 Enter the user name and password for your System Account and click OK.
If the connection is successful, Connect and get database
• • • • • •
Note: These Studio Service Account values must match the same values used for
the 2016/2017 Studio Service Account.
• • • • • •
Note: These Studio Service Account values are explained in Appendix D.
8 In the Studio Service Account password: field, enter the 2016/2017 Studio
Service Account password.
• • • • • •
Note: These Studio Service Account values must match the same values used for
the 2016/2017 Studio Service Account.
3 Click Repositories.
The Repositories app displays, showing the available 2015.x or 2016.x
repositories (in italics) and the 2017 repositories.
• • • • • •
Note: You only need to select one repository to upgrade all the 2015.x or 2016.x
repositories.
• • • • • •
Note: If the validation rules need to be updated, changes made through the
ValidationManager script should be done first and then, the Studio for
Techlog repositories should be created.
• • • • • •
Note: The script is only available through the Studio Manager installation. It is
not available through the Studio Server installation.
Prerequisites Before running the script, you need to confirm that you have the correct Windows
PowerShell version installed and the correct settings set. Make sure you have the
following:
• Windows PowerShell version 3.0 or higher
• Windows PowerShell execution policy is RemoteSigned
• The administrator is added as SuperAdmin or Admin into the Studio Techlog
database
• Access to Studio Server
The default for the Windows PowerShell settings for Windows Server 2012 R2 is
version 4.0 and for Windows Server 2016 is version 5.0 and the execution policy is
RemoteSigned. Windows 7 provides Windows PowerShell 2.0 by default.To obtain
PowerShell 3.0 or higher, you can install Windows Management Framework 3.0 or
higher. The Windows Management Framework 3.0 download can be found at the
following link:
https://www.microsoft.com/en-us/download/details.aspx?id=34595
Running the To run the Windows PowerShell script for database configuation, do the following:
Windows
1 Enter Windows PowerShell in the Search box on the Start menu.
PowerShell Script
for Database 2 Type $PSVersionTable.PSVersion to see the Windows PowerShell
Configuration version.
3 Make sure the number in the Major column is 3 or higher.
Running the Make sure your login account has Studio administrator rights (SuperAdmin or
ValidationManager Admin). The ValidationManager script, a file named ValidationManager.ps1, is
Script available on the Techlog DVD and in the DBScripts folder, found in the Studio
Manager installation folder, for example, C:\Program
Files\Schlumberger\Studio Manager 2017\Plugins\Techlog\DBScripts.
• • • • • •
Note: The script is only available through the Studio Manager installation. It is
not available through the Studio Server installation.
2 In ServerUri:, type the Studio Server path and the API path, making sure
that you use techlog/2018 as the API path, for example, http://
localhost:50231/techlog/2018.
3 Type the validation rule number to turn the rule on or off and then, press
Enter.
Enter validation rule number to toggle on/off displays.
4 Press Enter to confirm the change you made and the script finishes with the
change.
5 If you type QUIT, the script finishes without any change.
6 Run the script again.
The validation rule that was turned off now becomes red.
List of Validation The available validation rules for the customization are shown in the following table.
Rules The long messages are shown in the Techlog Transfer status window when the data
are invalid. They describe what users need to do to fix the invalid data. The Default
Setting On means the rule is applied when the data are sent to Studio by default.
Table 7-2 Validation Rules
5 Error Total depth of the well must have a Well {1} has values for Total_depth, On
defined unit. but has invalid units.Must be an unit
compatible with the length
dimension (M, FT).
6 Error Water depth of the well must have a Well {1} has values for On
defined unit. Water_depth, but has invalid units.
Must be an unit compatible with the
length dimension (M, FT).
7 Error Well reference must be correctly Well {1} must have a CRS that On
defined (CRS). exists in the CRS Studio catalog and
correctly defined.
8 Error Wellhead location must have Wellhead of Well {1} must be On
correctly defined (X,Y) units. correctly defined. X,Y properties
need to be correctly defined and
with the right units.
2 In ServerUri: enter the Studio Server URL for which you want to obtain the
validation report (see the following example).
3 In OutputFile: enter the output file location and file name. The output file
can be either a .txt or .csv file type (see the following example).
4 If the report run is completed without errors, a group of validation rules listed
by repository in the PowerShell output displays and the report file is created in
the file location that you designated (see the following example).
In This Chapter
Introduction............................................................................................... 8-2
Audience ............................................................................................. 8-2
Uninstalling Studio Manager ........................................................................ 8-3
Uninstalling Studio Server ........................................................................... 8-4
Uninstallation 8-1
Introduction
This chapter describes the different workflows used to uninstall the Studio products.
Audience This chapter is intended for the administrator who needs to uninstall any of the
different Studio products.
• • • • • •
Note: Before uninstalling Studio Manager, make sure that it is not open.
• • • • • •
Note: A User Account Control message might display. Click Yes to continue.
Uninstallation 8-3
• • • • • •
Note: A User Account Control message might display. Click Yes to continue.
Licensing Issues Studio Manager does not detect license dongle after removal and
and Solutions reinsertion or after the computer wakes from sleep or hibernation
Do the following:
1 As a prerequisite, ensure that this software is installed on your system:
a. Schlumberger Licensing 2018 tool
b. Latest CodeMeter driver
c. Updated dongle firmware
2 Start the Schlumberger Licensing tool.
3 Stop any license server that is running.
4 In Windows, click Start automatically.
5 Click Apply.
6 In the Schlumberger Licensing tool, click File > Advanced options.
7 Make sure that Install CodeMeter detector is enabled.
• • • • • •
Note: If you switch between wireless and cable-based connections while Studio
Manager is running or after hibernation, a reconnection with the license
server may fail because of a network conflict.
Studio Manager disconnects from the license server or loses the license on
a regular basis.
Do the following:
1 Upgrade CodeMeter to the latest version (6.60).
2 Swap a new Studio Manager dongle.
3 Update the Studio Manager dongle’s Certified Time.
In This Appendix
Configuring Oracle
Introduction This section explains how to configure your system to install Studio Database
supporting Techlog in an Oracle environment. Studio Database provides the back-
end infrastructure that allows Techlog users to collaborate and work with very large
amounts of data in a single location, regardless of the data source.
Oracle 12.2.0.1 If you are installing Oracle 12.2.0.1 as a fresh installation in your environment, you
should follow this basic workflow:
1 Install Oracle 12.2.0.1 without creating a database.
2 Create an Oracle database using the parameters and tablespace
recommendations noted in “Storage Configuration” on page B-4.
• • • • • •
Note: For complete details on installing Oracle, refer to the documentation
resources provided with your Oracle software.
Oracle Environment After you have installed Oracle, for the successful installation of Studio Database,
Variables you must set the following Oracle environment variables:
• ORACLE_HOME
• TNS_ADMIN
• PATH
• LD_LIBRARY_PATH
These variables must be set according to Oracle installation procedures so the
database server installation process can access your Oracle home directory and your
TNS configuration.
Disconnecting Make sure that no Database Administrator (DBA) activity, for example, database
Database Connections backup, is conducted at the installation time. You can check the Oracle SYS account
view, V$SESSION, to verify that all users and applications are disconnected. Other
than the connection for the session you use to query V$SESSION, V$SESSION
should show only database background sessions (identified by AUDSID=0 and a
USERNAME of blank).
Oracle
Configuration
Key Configuration Data This section presents a high-level view of the computers involved in local and
Items remote configurations, and correlates key data items from the configuration
program to the physical installation environment.
When configuring, you must specify the following information in the configuration
program:
• Oracle Home — Home directory where the Oracle software is installed.
• TNS Alias — The entry in the tnsnames.ora file that enables the Studio to
connect to the Oracle database. The location of the tnsnames.ora file is
indicated by the TNS Admin directory.
Tablespaces In addition to the default tablespaces that come with your Oracle installation, Studio
Database requires you to create a tablespace called STUDIO_TABLE and a
temporary tablespace called TEMP.
• • • • • •
Note: You may not need to create the temporary tablespace, TEMP, as it may
already exist.
Database Maintenance When you perform maintenance on the database, access to the database and
tablespace might be blocked during the maintenance. During this period, the home
page for the server might be blank or unresponsive. This is normal behavior, and the
server will be responsive when the database becomes available again.
Storage Configuration The following tablespace configurations are recommended for Studio Database.
Tablespace Configured with Unlimited MAXSIZE
The tablespace example shown below will create one data file and extend it with an
unlimited maxsize for the file. This means the tablespace will grow until it has
reached the maximum size of disk storage available.
Table B-1 Tablespace Configurationswith Unlimited Maxsize
The following are examples of what the parameters for Small, Medium, and Large
Tablespace could start with.
Table B-2 Tablespace and Data File Sizes (Examples with MAXSIZE Limited)
To create the tablespaces, you can use the following SQL commands (ALTER
TABLESPACE SQL Statement needs to be used multiple times, depending on the
number of files that need to be created for disk storage allocated at the beginning of
tablespace creation):
CREATE TABLESPACE STUDIO_TABLE DATAFILE '/oradata/
studio_table1.dbf' SIZE 4000M AUTOEXTEND ON NEXT 40M MAXSIZE
16000M LOGGING ONLINE EXTENT MANAGEMENT LOCAL AUTOALLOCATE
BLOCKSIZE 8K SEGMENT SPACE MANAGEMENT AUTO;
ALTER TABLESPACE STUDIO_TABLE ADD DATAFILE '/oradata/
studio_table2.dbf' SIZE 4000M AUTOEXTEND ON NEXT 40M MAXSIZE
16000M;
Where oradata is the directory where you want to put the data files. To create the
Small, Medium, and Large tablespaces, change the SIZE, AUTOEXTEND ON NEXT,
and MAXSIZE parameters in the SQL command above to the respective parameters
in Table B-2.
Temporary Tablespace
The following are examples of the minimum size a DBA could start with. Typically, a
DBA would alter the temporary tablespace size based on how much the workload is
on the server over a certain period of time.
Table B-3 Temporary Tablespace and Data File Sizes
Network File System For purposes of repository backup and recovery, during Studio Database
Mounting configuration, you can specify a directory local to the Oracle server, or you can
Specifications mount an external network file system (NFS) directory.
Oracle requires these mount options to ensure that the volume is safe to use, as
incorrectly mounted NFS volumes can result in data corruption issues. In general,
the following conditions are required:
• The mount table can be read to check the mount options.
• The NFS mount is mounted with the "hard" option.
• The mount options include rsize>=32768 and wsize>=32768.
• • • • • •
Note: Studio Database has not been certified on Oracle hardware technologies
such as EXADATA or ASM mounts.
Privileges The privileged account used to install the database via the configurator needs to
have DBA privileges, as well as grant privileges to execute the dbms_lock package.
The following is an example of the commands used in creating a privileged account
(OraStudioAdmin):
create user OraStudioAdmin identified by sft;
grant dba to OraStudioAdmin;
grant execute on dbms_lock to OraStudioAdmin with grant
option;
Accounts The database standard accounts that are created during the installation of Studio
Database are the following: studio_sys, STUDIO DD 2018, and
studio_service. For more information about these accounts, see Appendix D.
Other database accounts, such as the ones created for repositories, are created by
Studio Manager after the database installation is completed.
Introduction This section explains how to configure your system to install Studio Database in a
SQL Server environment. Studio Database provides the back-end infrastructure that
allows Techlog users to collaborate and work with very large amounts of data in a
single location, regardless of the data source.
Prerequisites Before installing Studio Database 2018.1 on a SQL Server database, you must
configure and complete the installation of a Windows Server 2016 or Windows
Server 2012 R2. Some configuration is required and recommended.
Administrators are responsible for monitoring performance relative to the operating
system database and repository. Performance recommendations are addressed in
“Performance Considerations” on page B-10. Review and configure as needed for
your hardware, software, and network environments. None of the performance
considerations are mandatory to use Studio.
Windows Server
Customizations
Windows Firewall The Windows Firewall must be configured properly to allow remote access to SQL
Server 2016. Ensure that the appropriate ports are open to enable remote access.
See the Microsoft rules documentation at http://go.microsoft.com/fwlink/
?LinkId=94001 for information about ports to open for each feature.
SQL Server 2016 To properly support Studio Database, during the installation of SQL Server 2016
Standard Standard Edition, ensure that you do the following:
• During the feature selection, include the following:
- Database Engine Services
- Client tools connectivity
- Management tools - Basic
- Management tools - Complete (recommended)
• • • • • •
Note: The optional features below Database Engine services (replication, full-
text search, and data quality services) are not required.
• • • • • •
Note: SQL_Latin1_General_CP1_CI_AS is the only Collation that is supported.
• • • • • •
Note: The maximum value allowed for the .mdb datafile of the modeldb is 20
MB. The installation of Studio Database will fail if you enter a value greater
than 20 MB.
• • • • • •
Note: For complete details on installing SQL Server 2012 Standard Edition SP2,
refer to the documentation resources provided with your SQL Server
software.
Settings
Studio Database requires the following settings in your SQL Server installation to be
enabled before the Studio Database installation:
• Enabling remote connections.
For details on enabling these settings, see the following sections.
Enabling Remote To enable remote connections you need to enable the "Allow remote connections"
Connections parameter in your server properties and to enable TCP/IP protocol for the server
instance.
The Max Degree of Parallelism option can be used to limit the number of
processors to use in parallel plan execution. Setting this option to a larger value
often causes unwanted resource consumption and performance degradation.
a. Using SQL Server Management Studio, connect to your database engine
service.
b. Right-click on your instance and select Properties.
c. Select Advanced properties.
d. Set the value for Max Degree of Parallelism based on the number of
cores in your server, with a maximum value of 8.
• Presize Database Temporary Data and Log Files
Presize according to the data and size of transactions. The suggested size below
should work for most reasonable transactions sizes.
a. Using SQL Server Management Studio, connect to your database.
b. Expand Database.
c. Expand System Databases.
d. Right-click on the tempdb database and select Properties.
e. Select Files.
f. Set the Initial Size value for tempdev to 5120 with 10 percent of
increment, and the Initial Size value for templog to 1024 with 10 percent
of increment.
• Memory per Query
This controls how much memory is available for each query. Studio Database
makes extensive use of large queries.
a. Using SQL Server Management Studio, connect to your database.
b. Right-click on your instance and select Properties.
c. Select Memory.
d. Set Minimum memory per query to 4 MB.
• Default Fill Factor
Studio Database makes extensive use of indexing in the database. This option
controls how the index grows as amount indexed data increases.
a. Using SQL Server Management Studio, connect to your database.
b. Right-click on your instance and select Properties.
c. Select Database settings.
d. Set Default index fill factor to at least 70.
• Maximum Server Memory
This controls how much overall memory is available for each SQL Server instance.
Settings are suggested, based on a system RAM amount of 64 GB and a single
SQL Server instance in use.
a. Using SQL Server Management Studio, connect to your database.
b. Right-click on your instance and select Properties.
c. Select Memory.
d. Set Maximum server memory to 54000 MB.
Repository Customizations
These performance considerations need to be applied to the repository.
Administrators will need to use Studio Manager to create the repository before to
applying these customizations.
The database files and log files must be large enough so that any file growth that
occurs during normal execution doesn't impact the performance of the database. By
default, all newly created repositories will be at the small size of the table below.
The database administrator should adjust the size to match the expected data
volume in the repository. This must be done for each created repository.
1 Using SQL Server Management Studio, connect to your database.
2 Expand the Database folder, right-click on your repository and select
Properties.
3 Select Files, and change the value of the Initial Size parameter according to
the following table. The following settings are suggested for the different
amounts of data. For all cases, it is recommended that you choose an
increment size of 10%.
• Performance
• Static Content Compression
• Dynamic Content Compression
• Security
• Request Filtering
• Basic Authentication – not needed and a warning will occur
• Windows Authentication
• Application Development
• .NET Extensibility 4.5 – a false warning will occur even if .NET
Extensibility 4.5 exists. Do not install .NET Extensibility 3.5 to
fix the issue.
• ASP.NET 4.5
• ISAPI Extensions
• ISAPI Filters
• Management Tools
• IIS Management Console
• IIS Management Script and Tools
• Management Service
C-2 Studio Installation and Configuration Guide
• • • • • •
Note: In IIS 8.5, the default value for the Idle Time-out Action setting is set
to Terminate and Studio has been tested on IIS with this default value.
Changing this setting to Suspend may cause problems in Studio Server
and has not been tested. Studio does not recommend changing this
setting.
• • • • • •
Note: As part of the threat modeling process to reduce the risk of security
issues, we recommend following Microsoft’s Security Best Practices for IIS
8, which can be found at the following link:
https://technet.microsoft.com/en-us/library/jj635855.aspx
• Performance
• Static Content Compression
• Dynamic Content Compression
• Security
• Request Filtering
• Basic Authentication – not needed and a warning will occur
• Windows Authentication
• Application Development
• .NET Extensibility 4.5 – a false warning will occur even if .NET
Extensibility 4.5 exists. Do not install .NET Extensibility 3.5 to
fix the issue.
• ASP.NET 4.5
• ISAPI Extensions
• ISAPI Filters
• Management Tools
• IIS Management Console
• IIS Management Script and Tools
• Management Service
Configuring IIS 10 C-5
• • • • • •
Note: In IIS 10, the default value for the Idle Time-out Action setting is set to
Terminate and Studio has been tested on IIS with this default value.
Changing this setting to Suspend may cause problems in Studio Server
and has not been tested. Studio does not recommend changing this
setting.
• • • • • •
Note: As part of the threat modeling process to reduce the risk of security
issues, we recommend following Microsoft’s Security Best Practices for IIS
10, which can be found at the following link:
https://technet.microsoft.com/en-us/library/jj635855.aspx
• • • • • •
Note: There might be other HTTP response headers, such as X-Powered-By, that
have already been added to the Studio Server website.
In the Internet Information Services Manager, use the HTTP Response Headers
view to add the following HTTP Response Headers:
• Content-Security-Policy => .default-src ‘self’
• X-Content-Type-Options => nosniff
• X-XSS-Protection => 1; mode=block
• • • • • •
Note: Before Studio Server is installed, make sure that Static Content
Compression and Dynamic Content Compression roles are selected,
as they must be turned on when IIS is installed.
5 Click Compression.
The Compression screen displays.
Obtaining a A certificate for the server machine is required to enable SSL. You will need a
Certificate certificate issued by a known certificate authority (CA) or the company’s internal CA
The following IIS manager options can be used to request, install, or create a
certificate:
• To create a request that can be used to request a certificate from a CA, click
Server > Server Certificates > Create Certificate Request
• To install a newly acquired certificate, click Server > Server Certificates >
Complete Certificate Request
If the server is configured with a self-signed certificate, then, a client application,
such as Studio Manager and Techlog will not work and you will receive the following
error message, “Could not establish trust relationship for the SSL/TLS secure
channel. The remote certificate is invalid according to the validation procedure.”
IIS 8.5 also provides the ability to manage certificates in a centralized certificate
store. Refer to the Centralized SSL Certificate Support feature documentation for
details.
Creating HTTPS In IIS Manager, select the Studio site and from the Actions menu, click
Binding Bindings > Add and do the following:
1 For Type, enter https.
2 For Port, use the default 443 port or assign a different unused port number.
3 For SSL certificate, select the required server certificate from the list.
Using the SSL Only To restrict the Studio site to SSL connections only, select the Studio site by clicking
Option (Optional) IIS Manager > SSL Settings > Require SSL.
Specifying a URL in To use SSL connections to the server, specify an https URL in client applications in
Client Applications the following format:
https://server.domain[:port]
• • • • • •
Note: After Studio Server is installed, it may be necessary to increase the IIS
Ping Maximum Response Time setting from the default value of 90
seconds. Studio Server will periodically manage the memory usage on the
server. In certain Studio usage scenarios with a significant number of
simultaneous data transfers, during this memory management operation,
there may be a delay in Studio Server responsiveness. On servers with
higher amounts of RAM installed, this process may cause IIS to reset the
active Studio client connections. To improve the ability of Studio to retain
connectivity during this process, you may need to increase the IIS Ping
Maximum Response Time setting, which controls how long IIS will wait
before resetting the active Studio connections.
Overview This appendix describes the privileges provided with all standard accounts for Studio
Database on Oracle databases. This information will enable the Database
Administrator or System Administrator to evaluate potential security threats with
respect to any of the standard accounts (for example, threats due to improper
granting of DBA privileges). Access to those accounts can then be limited to selected
privileged users in the organization.
Fixed Accounts
STUDIO_SYS • An internal, or root account created during installation. This account has many
bootstrap procedures to create other accounts and perform administrative
functions, such as managing data dictionaries, repositories, users, and repository
access.
• Should never be used for general data access.
• Password should be kept highly secure.
• Can read and modify data in repository and data dictionary accounts.
STUDIO_DD_2018 • Contains Meta tables that contain data used to generate repositories.
• Contains one version of the database server data model.
• Contains reference tables and some common entities shared by all repositories
created from that data dictionary.
• The data dictionary contains:
- Metadata - Describes the data model used by Repository accounts
- Reference data - For example, Units and Enumerations
- Shared data - Exploration and Production data shared between repositories
Variable Accounts
STUDIO_SERVICE In Studio Manager, the installation of Studio Database supporting Techlog requires
providing account information for the “Studio Service Account name” and “Studio
Service Account password”. This database level account is created during the Studio
Database installation and is the account that is used by Studio Server to connect to
and communicate with Studio Database. The default account name for this is
STUDIO_SERVICE. If this account is deleted or Studio Server is unable to connect to
the database using this account, all Studio functionality will no longer be accessible
from Studio Manager and Techlog.
Repository This type of account is an organized collection of Exploration and Production (E&P)
related data contained in the database server repository.
• Serves as the main data store for E&P data.
• Users should not log in with this database account, but instead, should log in
using the User account that has been granted access to the repository.
Roles STUDIO_SYS_ADMINISTRATOR
STUDIO_SERVICE • CONNECT
• DBA
Overview This appendix lists codes that are either unusable or not recommended for
passwords.
Description Many European characters are multiple-byte, and in order to have access to the
greatest possible set of European characters, it is recommended that your Oracle
instance be configured to use the Latin-1 character encoding.
Studio Manager can create and use passwords that have US-ASCII letters and
numerals and some punctuation characters. Studio Manager can also support non-
US-ASCII character codes 161 to 180, and 182 to 254.
The following codes are either unusable or not recommended for passwords.
Table E-1 Codes Not Usuable or Recommended for Passwords
Overview This glossary primarily contains definitions for items that you will encounter during
the installation of Studio Database.
Glossary F-1
Glossary Entries
Data Pump Data Pump is a new Oracle option that is faster and more flexible than the "exp"
(export) and "imp" (import) utilities used in previous Oracle versions. Data Pump
uses Oracle directories on the Oracle server to log Data Pump-related files.
Default Tablespace This is a permanent tablespace from the Oracle database that is used as the default
tablespace for user accounts.
If a default tablespace is not specified during database server installation, the Oracle
default tablespace, SYSTEM, is used. However, Oracle recommends that you not use
SYSTEM as the default, so you should specify another option during database server
installation. The Studio Database account STUDIO_SYS and all data dictionaries
always use STUDIO_TABLE as the permanent tablespace.
• • • • • •
Important: Check with your Oracle DBA regarding which tablespace to select
during database server installation.
Keytab File On the Active Directory Enabled Database panel of the installation program,
enter the absolute path to the keytab file on the Oracle server. This should be what
is used for the SQLNET.KERBEROS5_KEYTAB parameter in sqlnet.ora.
Local Installation The process of installing the database server directly to the Oracle server by running
the installation program on the Oracle server.
ORACLE_HOME In the installation program, this is the Oracle home directory location where your
Oracle software is installed. It is not necessarily the location on your Oracle
database server.
For remote installations, this is the value you observe when logged in to the
database server as the UserID under which the Oracle database executes.
Oracle Instance In the installation program, this is where you specify an Oracle database instance
based on the tnsnames.ora alias. During the database server installation, you will
need to include the following information for the Oracle instance:
• Host—IP address or host name of the computer acting as the host for the Oracle
database
• Port—Assigned port number on the host computer that the database server will
use to communicate with the Oracle database
• Instance—Instance name given to the Oracle database
• TNS Alias—Name used to access the Oracle database. This name can be the
same or different than the database instance name.
When you use SQL*Plus to connect to the database, use the following command
format:
sqlplus <Oracle account>/<password>@tnsalias
Oracle SYS Account This is a database administrator account created during Oracle database creation
(the other is SYSTEM). The SYS account owns most of the data dictionary tables,
while SYSTEM owns the views created on those base tables.
Remote The process of installing the database server to an Oracle server from a remote
Installation workstation.
STUDIO_SERVICE This database level account is created during the Studio Database installation and is
the account that is used by Studio Server to connect to and communicate with
Studio Database. This is the default name for this account, but can be changed
during installation.
STUDIO_SYS An internal, or root account created during installation. This account has many
bootstrap procedures to create other accounts and perform administrative functions,
such as managing data dictionaries, repositories, users, and repository access.
Temporary Oracle uses the temporary tablespace to store transient data that persists only for
Tablespace the duration of a given user session (for example, during a data sorting operation).
The temporary tablespace specified during database server installation is the
temporary tablespace used for all user accounts by default.
TNS_Admin This directory contains the tnsnames.ora file, which contains information (such as
IP address, port number, and service ID) that the database server uses to
communicate with the Oracle database. Although TNS_ADMIN can be placed in any
file location, it typically points to the $ORACLE_HOME/NETWORK/ADMIN directory,
which is maintained by the Oracle DBA.
Glossary F-3
TNS Alias This is the identifier used by Oracle to identify a particular database instance. The
TNS alias is resolved using the tnsnames.ora file.