0% found this document useful (0 votes)
3 views

DrillNET Installation Guide

Installation guide

Uploaded by

Wilson Tay
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
3 views

DrillNET Installation Guide

Installation guide

Uploaded by

Wilson Tay
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 73

DrillNET

Version 2.0.2
Installation Guide
Rev. 12

© 2006-2012 Petris Technology, Inc.


PetrisWINDS DrillNET is a registered trademark of Petris Technology, Inc.
Portions of this software are covered under US Patent No. 6,792,431. Other patents pending.
Copyrights
Copyright ©2006-2012 Petris Technology, Inc. All rights reserved. The contents of this document and of the
software it describes are the property of Petris Technology, Inc., and are copyrighted. No part of this document may
be copied, distributed, transmitted, transcribed, stored in a retrieval system, disclosed to third parties, or translated
into any language, in any form, or by any means, electronic, magnetic, manual, or otherwise, without the express
written consent of Petris Technology, Inc.

Trademarks
PetrisWINDS® is a registered trademark of Petris Technology, Inc., in the United States and other countries. Other
parties’ trademarks or service marks are the property of their respective owners, and should be treated as such.

Disclaimer
The instructions and descriptions contained in this document are accurate as of the document’s first printing.
Succeeding products and documents are subject to change without notice. Petris Technology, Inc. assumes no
liability for damages incurred directly or indirectly from errors or omissions in this document, or from discrepancies
between the product and this document. Any parameters that the customer uses beyond those indicated in this
document may have unpredictable results.

Attributions and Third Party Software


Details of attributions and third party software can be found in the Third Party document included with the
PetrisWINDS DrillNET installation at:

<DrillNET_home>\Third_Party.pdf (e.g. C:\Program Files\Petris\DrillNET20\Third_Party.pdf)

Petris Technology, Inc.


Visit our websites at www.petris.com for more information regarding product sales and technical support.

Documentation
Samantha Royder
Alastair Doyle
Last Revision
August 29, 2012

ii DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
1. CONTENTS
1. INSTALLATION PROCEDURES .................................................................................................... 1

1.1 NEW FEATURES FOR VERSION 2.0 ..................................................................................................... 1


1.2 RECOMMENDED INSTALLATION CONFIGURATION .......................................................................... 1
1.3 INSTALLATION PREREQUISITES ........................................................................................................ 2
1.4 INSTALLING .NET FRAMEWORK 4 EXTENDED................................................................................. 3
1.5 INSTALLING SQL SERVER EXPRESS ................................................................................................. 7
1.6 INSTALLING DRILLNET ................................................................................................................... 15
1.7 UNINSTALLING DRILLNET .............................................................................................................. 33
1.8 DRILLNET DATABASE WIZARD ...................................................................................................... 37
1.9 DRILLNET DATABASE VERSIONING MECHANISM ........................................................................ 45
1.10 IMPORTING DATA FROM OLD RELEASES OF DRILLNET INTO V2.0.1............................................ 46

2. LICENSING DRILLNET ................................................................................................................. 49

2.1 LINKING DRILLNET TO A LICENSE SERVER .................................................................................. 49


2.1.1. OBTAINING YOUR LICENSE SERVER HOST NAME AND HOST ID ..................................................... 49
.................................................................................................................................................................... 51
2.1.2. INSTALLING A LICENSE KEY FOR STAND ALONE LICENSING ........................................................ 51
.................................................................................................................................................................... 52
2.1.3. LICENSE FILE SETUP – HINTS AND TIPS........................................................................................... 52
2.1.4. WINDOWS 7 LICENSE ERROR MESSAGE ........................................................................................ 55
2.1.5. UPDATING A LICENSE FILE WHEN IT HAS EXPIRED ......................................................................... 57

3. CONFIGURING A LICENSE SERVER SYSTEM ....................................................................... 61

3.1 CONFIGURATION OF THE LICENSE SERVER ................................................................................... 61


3.1.1. STARTING THE LICENSE SERVER ................................................................................................... 62
3.1.2. IDENTIFYING THE LICENSE SERVER STATUS CONNECTION NAME ................................................ 63
3.1.3. CONNECTING A DRILLNET CLIENT TO THE LICENSE MANAGER .................................................. 64
3.1.4. UPDATING A LICENSE SERVER LICENSE FILE ................................................................................ 65
3.1.5. USING AN EXISTING FLEXLM LICENSE OR LMTOOLS.EXE ............................................................ 65

4. FAQ ..................................................................................................................................................... 67

4.1 THE SYSTEM ADMINISTRATOR HAS SET POLICIES TO PREVENT THIS INSTALLATION. ................ 67
4.2 WHEN I RUN DRILLNET, I GET A MESSAGE “CANNOT CONNECT TO THE LICENSE SERVER
SYSTEM.” OR “ERROR IN FLEXLM - -1.” ................................................................................................ 67
4.3 EXCEEDING THE NUMBER OF LICENSES FOR MODEL .................................................................... 67
4.4 EXCEED THE NUMBER OF DRILLNET LICENSES ............................................................................ 68
4.5 NOT LICENSED TO USE A PARTICULAR DRILLNET MODEL ........................................................... 68
4.6 UNABLE TO OPEN FILES ON NON-ENGLISH INSTALLATIONS .......................................................... 69

DrillNet 2.0 Installation Guide, r. 11 iii


Copyright © 2006-2012 Petris Technology, Inc.
CONTENTS

Revision History
Rev. Date Of Issue Author Scope
12 29-Aug-2012 David Jones Added 3rd-party attributions.
11 5-Jul-2012 Alastair Doyle Update for v2.0.1
10 15-Mar-2012 Alastair Doyle More 2.0 updates
09 12-Jan-2012 Alastair Doyle More 2.0 updates.
08 17-Nov-2011 Alastair Doyle Update for v2.0
07 12-Jul-2010 Samantha Royder Version change to encompass all 1.7
releases.
06 30-Mar-2010 Samantha Royder Framework requirements update.
05 18-Mar-2010 Alastair Doyle Screenshot changes and adjustments to
installation procedure.
04 2010/03/15 Samantha Royder Formatting.
03 2010/03/05 Alastair Doyle Updates to procedure.
02 2009/12/09 Samantha Royder Screenshot replacements for FLEXlm
and LMTools. Removal of Setup.ini
file reference.
01 2009/10/23 Samantha Royder Addition of XP instructions and
Borrowing License Key sections.
00 2009/10/21 Samantha Royder Initial Creation from previous docs.

Installation Guide Conventions


 Names belonging to features of the interface are written in Bold Type or are identified by
‘Single Quotes’.
 Any text that must be entered by the user, whether in the application or in another context
such as a DOS prompt or terminal window, appears in Courier font.
 Do to frequent product updates, screenshots in this guide are intended to be examples and
may not accurately represent your installation

iv DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
1. INSTALLATION PROCEDURES 1
1.1 New Features for Version 2.0
DrillNET v2 uses InstallAnywhere as the installation tool. This offers a simple to use and
intuitive interface for the software installation.
You must have the program installation privilege to install DrillNET, otherwise ask your system
administrators to install DrillNET.
The delivery package consists of a installation requirements guide, installation guide and user’s
manual in PDF format, and the following installation file.
File Note
DrillNET.exe Double-click DrillNET.Exe to start the installation.

1.2 Recommended Installation Configuration


DrillNET is a Workstation product and has to be installed on each machine that will be required
to run the software. The following are some examples of installation scenarios.
 DrillNET installed on a standalone PC which will host the software application,
FLEXlm license file and SQL database locally.
 DrillNET installed on a standalone PC which will host the software application and
SQL database locally, but access the FLEXlm license from a different license server.
 DrillNET installed on a number of client PCs which each host the software
application, but access the FLEXlm license and SQL database from different server
nodes. These server nodes could be the same or different machines, but all machines
must be on the same network

DrillNet 2.0 Installation Guide, r. 11 1


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
The following diagram illustrates a typical DrillNET installation in this configuration is
accessing the FLEXlm licenses and SQL database from two different server nodes.
NETWORK

DrillNET application

DrillNET application

FlexLM License Server

DrillNET application

DrillNET application

Database Server

DrillNET application

1.3 Installation Prerequisites


In order to install DrillNET on your PC the following third party software will already need to be
installed. Requirements will depend on the OS that you are using on the PC where DrillNET will
be installed. If any of these software products are found not to be installed during the DrillNET
installation process, prompts and appropriate web links where you can download the software
will in most case be displayed to allow you to download and install any missing software.

2 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
Installing these third party products during the DrillNET installation may in some cases require a
reboot of your PC and also restarting the DrillNET installation process. If all of these third party
products are already installed before starting the DrillNET installation the process of installing
DrillNET will be much easier.

Windows XP 32 Bit
 .NET 3.5, SP1
 .NET 4 (Extended)
 Microsoft Installer 4.5
 Microsoft PowerShell
 SQL Server Express 2008, R2
 SQL Server System CLR
 SQL Management Objects (SMO)

Windows 7, 32 Bit
 .NET 4 (Extended)
 SQL Server Express 2008, R2
 SQL Server System CLR
 SQL Management Objects (SMO)

Windows 7, 64 Bit
 .NET 4 (Extended)
 SQL Server Express 2008, R2
 SQL Server Compact Edition SP2 – x86
 SQL Server Compact Edition SP2 – x64
 SQL Server System CLR
 SQL Management Objects (SMO)

1.4 Installing .NET Framework 4 Extended


When installing DrillNET 2.x, .NET Framework 4 Extended is required. The sources of .NET
Framework 4 are:
 May already be installed on the machine.

DrillNet 2.0 Installation Guide, r. 10 3


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
 Download via Internet.
 Download from a local network server.
You will only be prompted to install .NET Framework 4 if InstallAnywhere cannot detect it on
your computer.
1. When you initially start the DrillNET installation by running DrillNET.exe, if .NET
Framework 4 is not detected the following message is displayed

2. Click Continue to launch a web browser with the correct URL to download .NET
Framework from the Microsoft Download site. A second small popup will also be
displayed which prompts you to click on Continue once .NET has been installed which
will then continue through the rest of the DrillNET installation.

4 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
3. Click on the download link to launch the download dialog.

4. From the File Download popup you can either run the exe directly or save the file to a
local folder. In case the exe is needed again at a later date, use the save option and once
saved, run the exe to install .NET Framework 4.

5. To install double click on the downloaded dotNetFx40_Full_x86_x64.exe file

6. Accept the terms of the License Agreement.

DrillNet 2.0 Installation Guide, r. 10 5


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

7. Which will be followed by a number of installation screens.

Click Finish on completion.

Click Continue on the dialog box launched by the DrillNET installation to continue with the
installation process.

6 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

1.5 Installing SQL Server Express


When installing DrillNET 2.x, an SQL Server installation is required. If no Microsoft SQL
server is detected then you will be prompted to install Microsoft SQL Server Express R2008 R2.
The following message will be displayed.

1. Click Install Sql Express to launch a web browser with the correct URL to download
SQL Server Express R2008 R2 from the Microsoft Download site for the OS that you
are using. In the example below, this version of SQL is for 32 bit Windows XP. You can
either run the SQL install directly or save to disk in case it is required at some future
date.

DrillNet 2.0 Installation Guide, r. 10 7


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

Note : You will need to have installed .NET Framework 3.5 SPI, Windows Installer 4.5 and
Windows Powershell if installing on Windows XP. If .NET and Installer are not detected you
will get the following message displayed.

2. A second small popup will also be displayed which prompts you to click Continue after
the SQL Server installation has completed.

3. In this example we have downloaded SQLEXPRWT_x86.exe for a 32 bit Windows XP


node. From the File Download popup you can either run the exe directly or save the file
to a local folder. In case the exe is needed again at a later date, use the save option and
once saved, run the exe to install SQL Server Express 2008 R2

8 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
4. To install double click on the downloaded SQLEXPRWT_x86_ENU.exe file or appropriate
downloaded exe.

5. The following images show most of the typical screen you will see during the software
installation.

DrillNet 2.0 Installation Guide, r. 10 9


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

6. Accept the terms of the License Agreement …

10 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

DrillNet 2.0 Installation Guide, r. 10 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

12 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
7. Choose the option NT AUTHORITY\SYSTEM as the Account Name

DrillNet 2.0 Installation Guide, r. 10 13


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

14 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
8. Click Close on completion.

9. Next click Continue on the dialog box launched by the DrillNET installation to continue
with the DrillNET installation.

1.6 Installing DrillNET


DrillNET 2.0 can co-exist on a PC with an existing v1.7.6 installation still installed, but unless
there is a need to retain the old installation we would recommend that you uninstall any old
installations before installing v2.

DrillNet 2.0 Installation Guide, r. 10 15


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

Installing DrillNET v2 on XP
Having installed .NET Framework 4 and SQL Server Express Server 2008 R2 plus its associated
pre-requisites, when you launch or continue the DrillNET installation you will initially be
prompted to install Microsoft SQL Server System CLR Types and SQL Management
Objects (SMO).

When you click on install a link to the required file is launched where you can click on Run to
install the software.

16 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

DrillNet 2.0 Installation Guide, r. 10 17


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

18 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

Click Continue once finished

You will then be prompted to install the SQL Management Objects (SMO). Click on Install to
install this product.

DrillNet 2.0 Installation Guide, r. 10 19


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

20 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

DrillNet 2.0 Installation Guide, r. 10 21


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

Click Continue once finished

22 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

1. After all required software has been installed the InstallAnywhere Introduction screen is
displayed. Click Next to continue with the installation.

DrillNet 2.0 Installation Guide, r. 10 23


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
2. The License Agreement screen will appear. Select the “I accept the terms of the License
Agreement” radio button and click Next.

3. On the DrillNET Install Folder screen either accept the default directory (recommended) or
use the Choose option to browse to an alternative folder. Once selected click Install.

DrillNET is then installed …

24 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

4. Enter the instance name of the SQL Server Express and the database name in the Database
Wizard. Click Next to accept the defaults or continue after making your selection.

The DB configuration information is now stored in an XML file e.g.


C:\users\username\AppData\Roaming\Petris\DrillNet and not in the file MTI2.INI which was
previously stored beneath C:\Windows on earlier v2 releases of DrillNET. The current file is
called config.xml and typical details would look like :
<Config>
<Databases currentConnection="Local">
<CentralDatabase serverName="" databaseName="" userName="" userPassword=""
authenticationType="WindowsAuthentication" />
<LocalDatabase serverName="DTTWAS47\SQLEXPRESS"
databaseName="DrillNet" userName="" userPassword=""
authenticationType="WindowsAuthentication" />
</Databases>

DrillNet 2.0 Installation Guide, r. 10 25


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
</Config>

5. Accept the default to Use Windows authentication for the User and click Next.

The DrillNET database is then installed.

26 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

If the database is successfully installed the Database Wizard indicates this with green text to
say that the Database installation succeeded. If there are any issues the error message will be
displayed in red text. Click Finish to complete the DrillNET installation.

Installing DrillNET v2 on Windows 7, 64 bit


 The basic installation process on Windows 7, 64 bit is the same as on XP (apart from the
base SQL file which for the 64 bit OS is called SQLEXPRWT_x64_ENU), plus in
addition you will need to also install SQL Server Compact Edition SP2 – x64. During
the installation process the following message will be displayed if this required software
is not installed.

DrillNet 2.0 Installation Guide, r. 10 27


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

Click install to access the Microsoft Download Center where the required software can be
downloaded.

Click on the Run option

28 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
The following warning message will be displayed concerning the need to install both the 32 and
64 bit MSI files. Answer Yes to this and you will next be prompted to browse to a folder where
you can save the software.

Save the software to a temporary folder unless you wish to retain it for a future installation.

Navigate to the location where the software was stored where you will find files for 32 (x86) and
64 (x64) bit OS’s.

If you run the 32 bit file SSCERuntime_x86-ENU you will usually only get options to either
Repair or Remove which suggests that the software is already installed on 64 bit Windows and
there will be no need to proceed further with the x86 process so you can cancel from that part of
the installation.

DrillNet 2.0 Installation Guide, r. 10 29


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

When you run the 64 bit version SSCERuntime_x64-ENU follow the prompts as detailed to
install this software.

30 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

DrillNet 2.0 Installation Guide, r. 10 31


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

On completion click Continue to proceed with the DrillNET installation.

32 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

1.7 Uninstalling DrillNET


To uninstall DrillNET:
1. Select the start  Control Panel windows option

2. Click Add or Remove Programs

DrillNet 2.0 Installation Guide, r. 10 33


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
3. Select the DrillNET20 application and then click on the Change/Remove button.

4. An initial splash screen is displayed

34 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
5. Click on Uninstall to uninstall the software or Cancel if you do not wish to continue with
the process.

6. Files, shortcuts, folders and registry entries are then removed.

DrillNet 2.0 Installation Guide, r. 10 35


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
7. Click Done on completion

If you also want to remove .NET Framework 3.5, SP1 and SQL Server Express R2008 R2 then
these can be removed using the Add or Remove Programs option.

36 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

1.8 DrillNET Database Wizard


The DrillNET DatabaseWizard.exe is a standalone application used to install or upgrade
DrillNET databases. It can be found in the DrillNET installation folder.

When launched, the “Database” dialog is shown.

The “Database server” field is initialized with the list of SQL Server instances in the local
machine, defaulting to the “SQLEXPRESS” instance if it exists; otherwise, the first instance in
alphabetical order is selected.

The database server has the syntax “ServerName”\”InstanceName”. The previous image shows
the “SQLEXPRESS” instance in the “DSEGURA” server. If no instance is created, that part can
be ignored, leaving only the server name. That is called the default instance. The “DSEGURA”
items is an example of such an instance in this image.

To connect to a remote server and instance, it must be entered in the “Database server” field.
The next image shows the DatabaseWizard pointing to a remote database which in this example
is on the node vtdwdb39.

DrillNet 2.0 Installation Guide, r. 10 37


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

DrillNET makes a distinction between a “Local” and “Central” database. The DatabaseWizard
determines that a database is local if it is located on a machine whose name is the same as the
local machine name. If the machine name is not the same as the local machine then the database
is considered to be central.

The “Database name” field is initialized with the string “DrillNet”, but it can be any database
name.

The “Make this the default database” check box is checked by default. This means that DrillNET
will connect to this database automatically. If this box is cleared, the database can be
created/updated, but the name of the database DrillNET connects to automatically will not be
changed.

DrillNET keeps the database information in the file


“%APPDATA%\Petris\DrillNET\Config.xml”. The content of this file looks like this:

<Config>
<Databases currentConnection="Local">
<CentralDatabase authenticationType="WindowsAuthentication” userPassword=""
userName="" databaseName=DrillNET20” serverName=”vtdwdb39"/>
<LocalDatabase authenticationType="WindowsAuthentication” userPassword=""
userName="" databaseName=DrillNet205_1”
serverName=”DSEGURA\SQLSRV2K8"/>
</Databases>

The “Databases” node contains two children: “CentralDatabase” and “LocalDatabase”, with the
necessary information to connect to either database.

38 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

The attribute “currentConnection” of the “Databases” node indicates what database to connect to
when DrillNET is started. In this case, it reads

currentConnection="Local"

so DrillNET is connecting to the ="DrillNet205_1" database automatically.

Clicking “Next” shows the “User” dialog where the user authenticates to the Sql server.
The “Use Windows authentication” box is selected by default. This indicates that the account
used to log in to Windows will be passed to Sql server to authenticate the user.

Unchecking that box will enable the “User name” and “Password” fields where a sql account can
be entered to authenticate the user.

Sql server defaults to allow only Windows authentication when being installed; it can be changed
to allow both “Sql server” and “Windows” authentications during the installation or at a later
point.

Clicking “Next” attempts to connect to that server with the given credentials to retrieve the path
where the databases are usually stored in that server.

DrillNet 2.0 Installation Guide, r. 10 39


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
SQL server creates a Windows service for each instance installed in a computer. In the
“Services” snap-in (run Services.msc) like so:

The first three items in the list below show the default, the “SQLEXPRESS” and the
“SQLSRV2K8” instances in this machine.

They are all started. If the “SQLEXPRESS” instance is stopped while DatabaseWizard attempts
to connect to it, the following message is displayed …

40 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

and the wizard will not proceed. On some occasions the user authenticated to the server may not
have all of the necessary rights to access the objects needed by the wizard, which will result in
the following message being displayed.

In that case, the wizard continues, but tries to use the temporary folder “%TEMP%” to store the
database in the server. In the image below, note that the path to the temporary folder contains the
user name “dsegura” in this case, so it is user specific.

The DrillNet.mdf file is known as the database data file. The “DrillNet.ldf” is the log file. These
files can be renamed and placed in any folder in the server.

DrillNet 2.0 Installation Guide, r. 10 41


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

If the path could be retrieved successfully, it is shown as follows:

The path for the new database can be changed if its data and log files are desired in a different
location. It is important to note that these paths are relative to the machine hosting the sql server,
which might not be the local machine. A path that exists in the local machine might not exist in a
remote server. If the DatabaseWizard can obtain those paths from the server, then they actually
exist.

If the database already exists in the server, the “Data file” and “Log file” fields are disabled and
shown as grey text as shown below, since their name and location cannot be changed once the
database is created. In this case an upgrade operation is performed instead.

Clicking “Install” starts the creation or upgrade of the database.

42 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

Once the installation has concluded, a green message informs of the success of the operation.

The deployment script mentioned (C:\Users\dsegura\AppData\Local\Temp\DrillNet20105.sql)


is a sql script created on the fly to create the database. Following is a snippet of that file, showing
the creation of the “DrillNet2010” database.

DrillNet 2.0 Installation Guide, r. 10 43


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

If the database operation fails, a red message informs of the failure. This image shows a failure
due to the lack of memory in the machine. A minimum of 2 GB of RAM are needed for
DatabaseWizard to work successfully.

44 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
Clicking “Finish” closes the wizard. Clicking “Previous” allows creating/upgrading more
databases.

1.9 DrillNET Database Versioning Mechanism


DrillNET uses a database which structure is being modified as needed. When looking for a table
or column in the database, if it does not exist, DrillNET will fail, so it tries to make sure the
database has the objects it needs to run correctly (tables, columns, stored procedures, and views)
and warns the user if that is not the case, with the message below:

DrillNET contains the CurrentValue for the DBVersion it can work successfully with, and it
checks it when a connection is opened to the database.

When a database change is introduced, the DBVersion is updated to match the DrillNET file
version when the change was made. This file version can be seen in the “File Version” column in
Windows Explorer. The following image shows the 2.0.1.5 file version.

DrillNet 2.0 Installation Guide, r. 10 45


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES

If the database structure has not changed, its DBVersion does not change, even though the
DrillNET file version keeps changing as new builds are created. DrillNET 2.0.1.5 works with a
database whose DBVersion is 2.0.1.4 – the last time a change was introduced.

DatabaseWizard, as previously detailed, is a standalone application that allows the creation of a


DrillNET database and the upgrading of an existing database to the current version.

During the DrillNET installation, DatabaseWizard is launched to give the user a chance to create
or upgrade a database. If DatabaseWizard is closed without succeeding, the installation warns
about the possibility of DrillNET not working correctly with the following message:

If an already existing and updated database is going to be used by DrillNET, there is no need to
run DatabaseWizard. Nevertheless, if needed, it can be launched from the DrillNET installation
folder e.g. “C:\Program Files\Petris\DrillNET20” at any time. This application is the only
supported mechanism to create and upgrade DrillNET databases. No database scripts or separate
applications are supported at this time.

1.10 Importing data from old releases of DrillNET into v2.0.1


There is no mechanism available to migrate an old database from an earlier release of DrillNET
to the current release. If you have old data that you want to use in the current release of
DrillNET, the only mechanism that can be used to access this data is to first make sure that you
have the old data in XML file format, and then use the DrillNET v2 Project > Import option to
open the previously saved XML file into DrillNET.

46 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 1: INSTALLATION PROCEDURES
You then have the option to either Export so that the data will be in v2.0.1 format by using the
Project > Export option, or if you want to store this imported data into the DrillNET SQL
database, use the Project > Save option to write the data to a Well and Project of your choice.

DrillNet 2.0 Installation Guide, r. 10 47


Copyright © 2006-2012 Petris Technology, Inc.
2. LICENSING DRILLNET 2
DrillNET uses FlexLM as its license manager. Licenses can be installed on either a central
network server or on individual client machines. Below are 2 general technical guidelines:
Scenario 1: Client machines on a network --
Using FlexLM, a license file is provided for the license server that can be shared among many
client machines. This is known as a “floating” license. It is most appropriate when client
machines remain connected to the network.
Scenario 2: Client machines (e.g. laptops) disconnect for long periods of time –
When a client machine is going to disconnect from the network for long periods of time it is
recommended for customers to purchase individual (“local”) licenses for each client machine.
While scenario 2 may require more FlexLM licenses than scenario 1, it greatly reduces the
complexity of managing any licenses on the network, and avoids a great deal of synchronization
problems with field (rig-based) systems.
After DrillNET has been installed, you may not be able to run this application until you have
either connected your application to a License Server or obtained a stand alone license. You must
obtain this license from Petris. Please follow the steps below to get your license.
There are two ways to Run DrillNET, either by checking out a license from a License Server that
is running on your network or by obtaining a stand alone license on your computer.

2.1 Linking DrillNET to a License Server


2.1.1. Obtaining your license server host name and host ID
Whether you are network licensing or using a stand alone license, we need your computer
host name and ID.
FROM WINDOWS:
Go to StartRun and input CMD, click OK. In the command line, input IPCONFIG /ALL.
There you will find your computer Host Name and Physical Address (which will be
used as the license server). Send this information to Petris. It should look something like
this:

DrillNet 2.0 Installation Guide, r. 11 49


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 2: LICENSING DRILLNET

FROM LMTOOLS:
A graphical user interface to the license server manager tools is provided with this
installation called LMTOOLS. Some of the functions LMTOOLS performs include:
 Starting, stopping, and configuring FLEXnet License server systems.
 Setting system information, including host ids.
 Getting server status.
Run LMTOOLS.EXE (default path is C:\Program Files\Petris\DrillNET20). Click
the System Settings tab. There you will find your Computer/Hostname and Ethernet
Address. Send this information to Petris. It should look something like this:

50 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
SECTION 2: LICENSING DRILLNET

2.1.2. Installing a License Key for Stand Alone Licensing


1. When you have obtained the stand alone license file from Petris, if you copy
the new license file to the DrillNET installation folder there will be no need
to specify the license location as detailed below, as the license will be
automatically configured and you can run DrillNET without any additional
steps.
2. Should you however decide to place the license in a folder other than the
DrillNET installation folder, then you will need to follow the steps as
outlined to correctly license the DrillNET product.
3. When you have obtained the stand alone license from Petris and copied it to
your required location, run the DrillNET application. A FLEXlm License
Finder dialog box will appear. Select the Specify the License File radio
button and click Next.

4. You will then be asked to enter the full path where the license file is located.
You may use the browse button to navigate to the location of the DrillNET
license file. After entering the appropriate path click Next.

DrillNet 2.0 Installation Guide, r. 10 51


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 2: LICENSING DRILLNET

5. A confirmation dialog box will appear. Click Finish.

You should now be able to launch and run DrillNET.

2.1.3. License file setup – hints and tips


After the installation of DrillNET, you will need to license the software for the
application to run. A valid license file for your server will be sent to you by the Petris
office in Houston. DrillNET uses FLEXlm licensing, and a section of a typical standalone
license file would look like …

52 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
SECTION 2: LICENSING DRILLNET

Some critical elements of the license file that would be worth being aware of are …

Once DrillNET has been installed, if you do not put a valid license file in place the model
options in the application will display as greyed out text strings when you attempt to run
the application.

DrillNet 2.0 Installation Guide, r. 10 53


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 2: LICENSING DRILLNET

You may also see the following error message if you attempt to run DrillNET without a
valid license file

After installing DrillNET we would recommend that the license file that you are sent by
the Petris Houston office is copied to the folder
C:\Program Files\Petris\DrillNET20
which will be the default location for your software installation. It makes it easier to
manage your system if you keep the files in one location and as previously detailed, if
you do copy your license file to this location you will not be prompted to specify the
location when you run the software for the first time.
The first time you run DrillNET or if this is an upgrade and the license file cannot be
found in the expected location which is stored in the PC’s Registry, a pop up dialog box
will appear which will allow you to browse to the location of your new license file (this
was illustrated earlier in this chapter). Once the correct license has been selected and you
have finished the license file selection dialog, when you start DrillNET it will show the
models with valid license keys in black text.

54 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
SECTION 2: LICENSING DRILLNET

2.1.4. Windows 7 License Error Message


On Windows 7 installations the following message may be displayed when you attempt
to run DrillNET …
Error in saving configuration settings: You are not a license administrator

To resolve this problem you need to setup the DrillNET executable to be run as an
administrator. Navigate to the DrillNET installation folder, right click on the DrillNET
executable and select Properties.

DrillNet 2.0 Installation Guide, r. 10 55


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 2: LICENSING DRILLNET

Choose the Compatibility tab and check the option “Run this program as an
administrator”. Restart DrillNET and the application should now run without an error
messages.

56 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
SECTION 2: LICENSING DRILLNET

2.1.5. Updating a license file when it has expired


When a customer is sent a new license file, one technique that can be used to activate the
new license is detailed below.
1. Copy the new license file on the C:\Program Files\Petris directory
2. Right click on the “My Computer” icon on the Desktop and select the Manage option.

3. Select the Action menu option and Properties from the pulldown list.

4. Select the Advanced tab and click on Settings beneath Environment variables

DrillNet 2.0 Installation Guide, r. 10 57


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 2: LICENSING DRILLNET

5. In the top section “User variables”, Click on “Edit”

58 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
SECTION 2: LICENSING DRILLNET
6. Input the Variable name of PETRIS_LICENSE_FILE and the Variable Value as the
fully pathed new license file. Click OK to save the changes.

7. Run DrillNET and confirm that the license key is being read correctly.

DrillNet 2.0 Installation Guide, r. 10 59


Copyright © 2006-2012 Petris Technology, Inc.
3. CONFIGURING A LICENSE SERVER SYSTEM 3
3.1 Configuration of the License Server
After you have received your license file from Petris Technology Inc. you need to configure the
license server to run DrillNET. In order to configure a license server as a service you must have
Administrator privileges.
A graphical user interface to the license server manager tools is provided and can be run
by selecting LMTOOLS.exe in the DrillNET directory.
Some of the functions LMTOOLS performs include:
 Starting, stopping, and configuring FLEXnet license server systems.
 Setting system information, including host ids.
 Getting server status.
In order to control the operation of licensing manager (lmgrd.exe) from the LMTOOLS
user interface, you first must configure it as a license server manager service. Follow the
procedure below before proceeding.
1. Run LMTOOLS.EXE (Default path is C:\Program Files\Petris\DrillNET20\)
2. Select the Service/License File tab and made sure the Configuration using
Services radio button is selected.

DrillNet 2.0 Installation Guide, r. 11 61


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 3: CONFIGURING A LICENSE SERVER SYSTEM
3. Next, select the Config Services tab and in the Service Name, type the name of
the service that you want to define.

4. In the Path to the lmgrd.exe file field, verify the license server system path. If
incorrect or blank, enter or browse to lmgrd.exe for this license server system.
(Default path is C:\Program Files\Petris\DrillNET20\)
5. In the Path to the license file field, verify the license file field path. If incorrect or
blank, enter or browse to the license file for this license server system. (Default
path is C:\Program Files\Petris\)
6. Leave the Path to the debug log file blank.
7. Check the Use Service check box first, then the Start Server at Power Up check
box to set the service to start when the computer powers up. When the machine is
rebooted, the license server manager will start automatically as a Windows
service.
8. To save the new Petris License Manager Service, click Save Service. Click Yes.

3.1.1. Starting the License Server


After you configured your license system you will need to start the licensing server
manually. To start the service from the LMTOOLS interface:

62 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
SECTION 3: CONFIGURING A LICENSE SERVER SYSTEM
1. Select the Start/Stop/Reread tab and start Petris License Manager by
clicking the Start Server button.

2. Once the Server has started successfully you will see a Using License File
path at the bottom of that screen.
3. Petris License Manager License server system starts and writes its debug log
output to C:\Program Files\Petris\DrillNET\DrillNET.log.

3.1.2. Identifying the License Server Status Connection Name


After the Flexlm License Server is running, select the Server Status tab and click
Perform Status Enquiry. This will populate the bottom portion of the status box and
will display the License Server Status Name. In this example the License Server Status
Name is “27000@dttwas47”. This is the connection name that you will need to use when
connecting a client to the License Server.

DrillNet 2.0 Installation Guide, r. 10 63


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 3: CONFIGURING A LICENSE SERVER SYSTEM

3.1.3. Connecting a DrillNET Client to the License Manager


If you are running DrillNET as a client and want to access the corporate DrillNET license
Server to obtain a license to run one or several of the DrillNET modules, you need to
point your Client application to the License Server.
1. When you run DrillNET, you will be presented with a FLEXlm License Finder
dialog box. Select the Specify the License Server System radio button and then
click NEXT.

2. A dialog box will be displayed that will allow you to input the Computer name of the
License Server System. Enter the License Server Status name that was obtained in
section 3.4.5 above in the field provided and click Next.

3. A dialog box indicating that the License Finder was successful in finding the
Server and will launch the DrillNET application.

64 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
SECTION 3: CONFIGURING A LICENSE SERVER SYSTEM

3.1.4. Updating a License Server License File


If you have created, and are running, a License Server and you want to update the license
file you must change the configuration file and then stop and restart the License.
1. Change the configuration settings for the License Server by opening the
LMTOOLS application. Select the Config Services tab and in the Path to the
license file field, browse to the new license file as shown below.

2. After selecting the new path


to the updated License file,
select the Save Services
button.
3. Select the Start/Stop/Reread tab in the LMTOOLS application and first click
Stop Server and then to re-start the server click Start Server to force the new
license file to be read.

3.1.5. Using an Existing FlexLM License or Lmtools.exe


If you already have FlexLM licensing installed and are using it for another application,
you will need to copy the Petris.exe file from the C:\Program
Files\Petris\DrillNET20 directory to the directory where Lmtools.exe resides. In order
for LMtools to complete the installation of the Server License, it will look for that file in
the Lmtools directory.

DrillNet 2.0 Installation Guide, r. 10 65


Copyright © 2006-2012 Petris Technology, Inc.
4. FAQ 4
4.1 The system administrator has set policies to prevent this
installation.

Answer : You have no program installation privilege to install DrillNET, ask your system
administrators to install DrillNET.

4.2 When I run DrillNET, I get a message “Cannot connect to the


license server system.” Or “Error in FLEXlm - -1.”

Answer : License server has not started yet. You must start the license server to run DrillNET.
Contact you System Administrator to check the License Server.

4.3 Exceeding the number of Licenses for Model

Answer : If you run DrillNET and all the licenses for a particular module are in use, this error
will occur. Clicking OK will run the DrillNET application but will display only the Data Sheet
in the model area of the application. By selecting a different Model, one where the number of
licenses is not exceeded, that module will run properly.

DrillNet 2.0 Installation Guide, r. 11 67


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 4: FAQ

4.4 Exceed the number of DrillNET Licenses


Answer : If you exceed the number of DrillNET licenses, this error message will appear
indicating that you have run out of licenses and the application will not run on your computer
until someone releases one of the licenses currently in use.

4.5 Not licensed to use a particular DrillNET model


Answer : If you are not licensed to use a particular DrillNET model the model option will appear
in grey text in the Models listing.

68 DrillNet 2.0 Installation Guide, r. 11


Copyright © 2006-2012 Petris Technology, Inc.
CHAPTER 4: FAQ

4.6 Unable to open files on non-English installations


Answer : If you cannot open files, such as the Tubular Database, it is likely that your file
permissions are not allowing you to access files. If you have this problem, there are 2 solutions
available:
1. Run DrillNET as an Administrator.
2. or give the user modify permissions on the DrillNet20 installation folder, making sure it
is propagated to its child files.

DrillNet 2.0 Installation Guide, r. 10 69


Copyright © 2006-2012 Petris Technology, Inc.

You might also like