Licensing

Licensing Merak 2007.1

December, 2007

COPYRIGHT Copyright 2007 Schlumberger. All rights reserved.

The information in this document is subject to change without notice. The software described in this document is furnished under a license agreement. This software may be used or copied only in accordance with the terms of such agreement. It is against the law to copy the software on any medium except as specifically allowed in the license agreement. No part of this document may be reproduced or transmitted in any form, or by any means, electronic or mechanical, including photocopying and recording, for any purpose without the express written permission of Schlumberger.

Merak is a trademark of Schlumberger.

Merak Peep, Merak PetroDesk, Merak Portfolio, Merak Decision Tool Kit, Merak VOLTS, Merak Capital Planning, Merak Petroleum Financials, Merak DBTools, Avocet Data Manager, Avocet Capture, Avocet Allocation, Avocet Nomination, Avocet Mobile, Avocet Exchange, Avocet Import/Export, Avocet Integrated Asset Modeler, OFM, FieldBA, and FieldViz are marks of Schlumberger.

Microsoft is a registered trademark of Microsoft Corporation.

BackOffice, Internet Explorer, Windows, Windows 98, Windows NT, Windows 2000, Windows XP, MS-DOS, Word, Excel, ActiveX, ODBC, OLE, COM, Terminal Server, Microsoft Access, Visual C++, and Microsoft SQL Server are registered trademarks of Microsoft Corporation.

Oracle is a registered trademark of Oracle Corporation.

Crystal Reports is a trademark of Business Objects.

All other names and trademarks are the property of their respective owners.

Contents

Licensing ........................................................................................................................... 1 About FLEXlm Licensing.................................................................................................................1 Network installations .......................................................................................................................1 Setting up the FLEXlm service........................................................................................................2 FLEXlm and laptop computers........................................................................................................7 Borrowing licenses..........................................................................................................................8

How to reach us ................................................................................................................ 12


Licensing

About FLEXlm Licensing The Merak Suite supports only one type of licensing beginning with the 2002 release. If you have not already converted your current licensing method to FLEXlm, please contact Schlumberger Information Solutions Global Help Desk for information about switching to FLEXlm licensing. DO NOT upgrade to 2007.1 Merak products until the licensing conversion is complete. These releases will not run with any other licensing method (Rainbow sentinels/bitlocks, Merak License Server, or CrypKey). Like CrypKey, FLEXlm is a software-based licensing tool that does not require any hardware be added to your PC or server. Once installed, FLEXlm keeps track of the system it was loaded to by attaching to either the hard disk ID, the physical address of your network card, the IP address, or the name of your system. As some of these items may change during the life of your PC, SIS recommends using either the hard disk ID, or the physical address of your network card. To determine which option to use, we recommend the following guidelines: If you are running from a standalone desktop PC, or setting up a license on a server with only

one network card, use the physical address of the network card. Note: if your network card is replaced, you will be required to re-license the software.

If you are running from a standalone notebook PC, or setting up a license on a server with more than one network card, use the hard disk ID.

SIS must authorize all applications protected with FLEXlm. However, unlike CrypKey, all Merak applications can be protected with a single license file. If the need to change your license count arises (adding a new product, for example), the new license file can simply replace the existing one, resulting in almost no downtime.

Network installations If you are installing FLEXlm to secure software that is to be shared across the network, there are several additional steps that must be completed before the license will be recognized. 1. Once the Merak software is installed, run the LMUTIL executable to obtain either the hard

disk ID or the network card physical address. The LMUTIL executable will be located in a FLEXLM directory on the Release CDs. To run the LMUTIL command, open the Command Prompt and execute the command: ?:\FLEXLM\LMUTIL.EXE lmhostid vsn Where ?: is your CD-ROM drive. You will receive a response similar to this: lmutil - Copyright (C) 1989-2005 Macrovision Europe Ltd. and/or Macrovision Corporation. All Rights Reserved. The FLEXlm host ID of this machine is DISK_SERIAL_NUM=78e0c336

2. If you want to retrieve the Network Adapter ID, open the Command Prompt and execute the command: ?:\FLEXLM\LMUTIL.EXE lmhostid ether Where ?: is your CD-ROM drive. You will receive a response similar to this: lmutil - Copyright (C) 1989-2005 Macrovision Europe Ltd. and/or Macrovision Corporation. All Rights Reserved. The FLEXlm host ID of this machine is 00d0b73feb3d

www.sis.slb.com 1


3. In addition to the hard disk ID or Network Adapter ID, you need to know the name of the server you want to load FLEXlm on.

4. Once you have the information, contact the SIS Help Desk for the creation of a license file. This file may take some time to create, as your contract will be reviewed to confirm the products for which you are licensed.

5. When you have received the license file, copy it to a location on your server. We recommend copying the license file to your \Program Files\Merak directory to which you installed the Merak products.

Setting up the FLEXlm service You must now set up the FLEXlm service. You can set this Service up on any Windows 32-bit operating system-based PC, and it is not essential that the service be running on the same server to which you have installed the Merak software.

To setup the FLEXlm service: 1. Copy the following files from the FLEXlm directory of your Merak CD to a directory named

FLEXlm (highly recommended) on your hard disk: LMGRD.EXE LMTOOLS.EXE LMGRD.SLB.EXE LMGRDSLB.EXE All four files must be copied across and be in the same directory before the FLEXlm Service will function.

2. Once the files have been copied to your hard disk, double-click on lmtools.exe to launch the application. The LMTOOLS application window opens.

3. Select the Configuration Using Services option. 4. Click the Configure Services tab.

www.sis.slb.com 2


5. Enter a Service Name for this FLEXlm Service. As there may be multiple software packages

using FLEXlm for Security, it is recommended that you name this service Merak Licensing to eliminate confusion.

6. Type the path to the LMGRD.EXE file, including the file name, or click Browse next to the Path to the lmgrd.exe file field and browse to the directory where you stored the four files in step 1 above.

7. Type the path to the license file you received from Merak, including the file name, or click Browse next to the Path to the license file field and select the license file for the Merak applications.

8. Type the path to the Log file, including the file name, that FLEXlm will use or click Browse next to the Path to the debug log file field and select the directory you want to place the log file in. FLEXlm will automatically create this log file the first time it is used. If a log file does not yet exist, you are required to enter the name of the log file you wish to create, and it will be automatically created for you.

www.sis.slb.com 3


Generally speaking, you will want to run FLEXlm as a service, and have the service start when the system powers up. This will prevent you from having to manually start FLEXlm each time the PC restarts.

9. Select the Use Services checkbox at the bottom of this tab to run FLEXlm as a service. Once this check box is selected, the Start Server at Power Up checkbox will become active.

10. Select the Start Server at Power Up check box. Note: if you are running LMTools on a Windows 98 or Windows ME system, the Use Services checkbox will not be selected. Select the Start Server at Power Up checkbox and continue.

11. Once all the information has been entered, click Save Service to save the information. 12. Click the Start/Stop/Reread tab. The Service Name you just created is listed in the FLEXlm

License Services list.

www.sis.slb.com 4


13. Click Start Server to start the FLEXlm service. 14. If you want to view the current status of the Service, click the Server status tab.

15. If you want to look at all of the licenses that are available on your server, select the Display

Everything option and click Perform Status Enquiry. A list of the applications you are licensed for, the number of concurrent copies, and the licenses currently in use is displayed.

www.sis.slb.com 5


Note: in this example that the server has 100 licenses of U.S. Peep, and currently one user has signed out a license (starting at 11:40 on June 10th).

16. If you want to quickly view a list of the licenses in use, select List All Active Licenses and click Perform Status Enquiry button. A list of only those licenses currently in use is displayed.

In this example, only those licenses currently in use are displayed. Since there is only one user in both situations, both screens are identical. When the Merak applications are launched from a workstation, the user will see the FLEXlm License Finder dialog box.

www.sis.slb.com 6


17. Select the Specify the License Server option and click Next. A prompt requesting the

address of the server running FLEXlm opens.

18. You may type either an IP Address or DNS Name for this value. 19. Click Next. A confirmation dialog box opens, informing you that the licensing process is

complete:

Notes: this dialog box does not ensure that a license for your application was located, only

that a valid FLEXlm Server was found.

if you are accessing a FLEXlm server on a network with Windows XP, you must use Windows XP Professional. Windows XP Home may not be able to access the server properly.

FLEXlm and laptop computers By default, all licenses for the Merak Suite are designed to look for a PCs network card. If you use a laptop PC and docking station to connect to the network, the applications may have difficulties validating the license if you are not connected to your docking station, since the network card that the license file uses for validation is either not active or no longer present.

www.sis.slb.com 7


To alleviate this issue, a change must be made to your system registry to allow the PC to recognize the network card even when the docking station is not present.

To enable this, please perform the following steps: 1. From the Start menu, choose Run. 2. Type regedit in the Open dialog box and click OK. The registry opens, and is divided into

5 sections. 3. Expand the HKEY_LOCAL_MACHINE section 4. Expand each of the following sub-levels:

System CurrentControlSet Services TCPIP Parameters

5. Once you are in the Parameters key, choose Edit menu > New > DWORD Value. A New Value is added to the list in the right-side pane and is hlighted.

6. Type DisableDHCPMediaSense as the name of the new value. 7. Double-click on the new DisableDHCPMediaSense value you just created. The Edit

DWORD Value dialog box opens. 8. Type 1 in the Value data field and click OK. 9. Exit the Registry Editor. 10. Restart your system. More information on this feature is documented in Microsoft Knowledge Base article Q239924 at http://support.microsoft.com/default.aspx?scid=kb;en-us;Q239924.

Borrowing licenses The license borrowing feature allows users who travel to borrow a license from a corporate server for use on their system when not connected to the network. While that license is on loan from the server, the license count on the server is temporarily lowered by a count of 1. In order to use the Borrow feature, your license file must be configured to enable it. Generally speaking this will not be the default setting. If borrowing is enabled, you will see a BORROW entry in the Increment lines in your license file, as shown in the World Peep example below: INCREMENT World_PEEP lmgrd.slb 4.400 10-jun-2005 100 \ CB1EE0B1B242FABE50CC BORROW=8760 SIGN="00AC 4D64 C164 B94F \ C553 E4BB 557D 2100 E06E F741 8B34 FC3B 1FC8 6974 EC5D" \ SIGN2="00A3 2047 7982 E854 811A 3D3E 6AC1 6500 B0A5 68B2 5118 \ 8993 BAE2 36A7 1F4F" If the BORROW entry is not present, you will not be able to use the license borrowing feature. Please contact your local sales representative to have this entry added to your license file. If the BORROW entry is present, you are able to borrow licenses from the corporate server.

To borrow a license from the server: 1. On the computer that will borrow the licenses (this is the workstation that you will be

disconnecting from the network, not the corporate license server) launch the LMTOOLS.EXE application. You can obtain this application from either the FLEXlm directory on your corporate license server or the FLEXlm directory on the Merak 2007.1 Suite DVD.

2. Click the Borrowing tab.

www.sis.slb.com 8


3. Type lmgrd.slb" in the Vendor Name field. 4. In the Return Date field, type the date on which you want to return the license to the server,

using the format DD-MMM-YYYY. 5. In the Return Time field, type the time at which you want to return the license to the server,

using the format HH:MM.

Note: if you leave the Return Time field blank, or enter 00:00 to represent midnight,

the license will be returned to the corporate server at 23:59 the day BEFORE the date you entered in the Return Date field.

6. Click Set Borrow Expiration. The bottom pane of the dialog box shows that the LM_BORROW variable is set to the time and date you selected.

www.sis.slb.com 9


Do not close LMTools.

7. Launch and close ALL of the Merak applications for which you need to borrow licenses. For example, if you wish to borrow a license for Peep, Decision Tool Kit and VOLTS, start and close each of these applications. It is not required that you perform any task in the applications, simply that you successfully open the application, connect to a database (if applicable) and close the application normally.

8. In the LMTools application, click Dont Borrow Anymore Today. This will prevent LMTools from capturing any additional licenses. To confirm that the licenses have been borrowed, click List Currently Borrowed Features. A list of the borrowed licenses is displayed.

9. You can now disconnect from the network and use the programs listed until the Return Date. 10. If you need to return a license early, enter the name of the application license you want to

return in the Feature Name field and click Return Borrowed Licenses Early.

www.sis.slb.com 10


Note: the Feature Name field is case sensitive and must match the name of the

borrowed feature exactly. If you are uncertain of the capitalization or spelling of a particular feature, simply click List Currently Borrowed Features and confirm against the list of borrowed features.

you cannot return all of the features at the same time. To return all of the features early, each one must be entered in separately.

www.sis.slb.com 11


How to reach us

United States

E-mail: [email protected]

Houston Tel.: +1 713-621-1165

Canada


Calgary Tel.: +1-888-986-4357 (toll-free)

Europe and Africa


London Tel.: +44 (0)207 517 2626

Russia and Caspian


Moscow Tel.: 7 495 935 8200 Ext. 1218

South America

E-mail: [email protected] Offices Mexico Tel.: 001 866 326 0174

Argentina Tel.: 0 800 444 0919

Brazil Tel.: 000811 005 9068

Colombia Tel.: 980912 3029

Venezuela Tel.: 0800 1 00 3588

Middle East


Asia and Australia


Malaysia Tel.: +60-3-21694266

Indonesia Tel.: +62-21-5229343

Australia Tel.: +61-1800001112

Thailand Tel.: +66-2-9371300

China Tel.: +86-10-64746699 Ext. 2816

Schlumberger supplements the standard maintenance agreement by offering extended on-site support worldwide. This enhanced level of support includes on-site assistance, installation, troubleshooting, and maintenance services of licensed Schlumberger software. Merak is a product line of Schlumberger Information Solutions (SIS). For more information about SIS, please go to our Web site at http://www.sis.slb.com.

www.sis.slb.com 12

LicensingAbout FLEXlm LicensingNetwork installationsSetting up the FLEXlm serviceFLEXlm and laptop computersBorrowing licenses

How to reach us

Documents

Licensing