Software License Manager (SLM) Installation and Reference Guide

Sftware License Manager (SLM) Installatin and Reference Guide

Versin Number: V8.6 May 2014 Cpyright (c) 2008 2014 by Aspen Technlgy, Inc. All rights reserved. Aspen HYSYS Dynamics, Aspen HYSYS Upstream, Aspen HYSYS, Aspen Orin XT, Aspen PIMS, Aspen Plus, aspenone, SLM, SLM Cmmute, SLM Cnfig Wizard, and the Aspen leaf lg are trademarks r registered trademarks f Aspen Technlgy, Inc., Burlingtn, MA. All ther brand and prduct names are trademarks r registered trademarks f their respective cmpanies. This dcument is intended as a guide t using AspenTech's sftware. This dcumentatin cntains AspenTech prprietary and cnfidential infrmatin and may nt be disclsed, used, r cpied withut the prir cnsent f AspenTech r as set frth in the applicable license agreement. Users are slely respnsible fr the prper use f the sftware and the applicatin f the results btained. Althugh AspenTech has tested the sftware and reviewed the dcumentatin, the sle warranty fr the sftware may be fund in the applicable license agreement between AspenTech and the user. ASPENTECH MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THIS DOCUMENTATION, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. Aspen Technlgy, Inc. 200 Wheeler Rad Burlingtn, MA 01803-5501 USA Phne: (1) (781) 221-6400 Tll Free: (1) (888) 996-7100 URL: http://www.aspentech.cm

Cntents Abut This Dcument...1 Wh Shuld Read This Guide...1 Technical Supprt...1 1 Quick Guide t Installing and Cnfiguring the SLM...3 Prerequisites...4 Step 1: Obtaining License Files frm AspenTech...6 Step 2: Installing AspenTech SLM Netwrk License Server...7 Installing the Sentinel System Drivers (hardware-key drivers)...10 Step 3: Installing aspenone prducts...12 Installing a new Stand-alne License file...12 Installing a Netwrk License file...13 Step 4: Test the SLM Installatin...13 Run-time Licensing...13 Mnitring the Netwrk License Server...14 Step 5: Cnfiguring the SLM and Advanced Features...15 2 SLM Overview...17 Benefits f SLM...17 SLM Primer...18 License Terminlgy...19 SLM Cmpnents...19 SLM System Requirements...20 License Lcking Criteria...20 License Files...21 License Mdes...22 Installatin Mdes...22 Obtaining License Files...24 SLM Dngles (Hardware-Keys)...25 Sentinel System Driver...26 Netwrk Requirements...26 Features and Limitatins f SLM...27 License Manager Prgram and Files...28 SLM Cnfiguratin Wizard...28 SLM Cmmute...28 Envirnment Variables...28 User Optins...28 Base Lad Tken Service...29 3 Installing Stand-Alne License Files...33 Yur License Package...33 New AspenTech prducts...33 Cntents i

Upgraded AspenTech prducts...33 Installing the License File...33 Installing Stand-alne Mde License Files...34 Installing the SLM Dngle...35 4 Installing and Cnfiguring the License Server...37 Installing and Cnfiguring a Netwrk License Server...37 Step 1: Installing the Netwrk License Server...38 Step 2: Installing the License File...39 Checking SLM Dngle...39 Checking that the License Server has been prperly initialized...41 Table f Required Services n SLM Server...48 Netwrk Prblems...48 Lg Files...50 Checking the Client t Server Cnnectin...51 5 Cnfiguring SLM...53 Cnfiguring SLM using the SLM Cnfiguratin Wizard...53 Accessing the SLM Cnfiguratin Wizard and Online Help...53 Cnfiguring SLM using Envirnment Variables...54 Cnfiguring the Envirnment Variables...54 LSDefaultDir Envirnment Variable...56 LServOpts Envirnment Variable...56 LServrcCNF Envirnment Variable...59 LSHst Envirnment Variable...59 LSHst Envirnment Variable...60 LSFrceHst Envirnment Variable...61 6 Advanced Licensing Functins...63 Using Alternate License Cnfiguratins...63 Pling SLM Dngles...63 Mixing Stand-alne and Netwrk Mdes...64 Cnfiguring the SLM using Registry Variables...64 Cmmuting Licenses...64 Checking Out Cmmuter Licenses...65 Returning Cmmuter Licenses...69 Recmmended Practices...70 License and Prduct Names...70 Cmmuting the Licenses frm a Remte Lcatin...71 Stpping r Changing the License Server...71 Setting User Optins...71 User Alerts...71 Grup Reservatins...74 7 Trubleshting SLM Prblems...81 Intrductin...81 Dngle Prblems...82 Check Dngle Attachment...82 Check that there is n prblem with yur netwrk...83 Check if license server is utside f yur sub netwrk...83 Check the hst name r IP address...84 ii Cntents

Check if the license server has been reladed after installing the licenses n the server...84 Check yur netwrk cnnectin system...84 Cmmn Errr Messages...85 8 Frequently Asked Questins...87 General SLM...87 Hw d I fix my SLM installatin?...87 Why are the SLM dngle (Sentinel Hardlck) and its lck cde missing when I run the Cnfiguratin Wizard?...88 I am trying t install an SLM applicatin using netwrk security. Why am I getting errrs?...88 Extra digits are added t license file name and it will nt wrk. Why?...89 Where is the Sentinel System Driver installed?...89 The cmputer was a server, but nw I want t delete its licenses and stp it frm being a server. Hw d I d this?...89 I have many stand-alne dngles. Hw d I manage the license files?...90 Can I switch a stand-alne SLM dngle between multiple cmputers?...90 What is the Cmmuter Optin?...91 Why d I get the errr message "Required Cmpnent Missing" when trying t run an AspenTech prduct?...91 Why is the AspenTech prduct telling me that I d nt have the apprpriate licenses t run my prduct?...91 Hw can I run an AspenTech prduct lcally n the same cmputer that has the netwrk license and the dngle?...92 Can I use SLM-enabled prducts with a Windws/Citrix Terminal Server?...92 The lgin page fr the Enterprise Update Center fails t appear. Hw d I reslve this issue?...93 Prduct Specific...93 HTFS Prducts dn't display the standard SLM errr handles. Hw d I trublesht licensing prblems?...93 Guidelines fr SLM Features...94 Hw d I get lgging t wrk prperly n my server?...94 Hw d I set up Grup Reservatins?...94 SLM Administratr Tls...94 My WLMAdmin preferences aren't saving. Why is that?...94 I have shut dwn the AspenTech prduct and the WLMadmin tl still states I have licenses checked ut. Why?...95 Abut Tkens...95 What are SLM tkens?...95 Time Tamper Check...95 Hw t fix the prblem with initializing licenses?...96 Hw can I fix the prblem?...96 Hw can I avid getting this errr in the future?...97 I ran timefix.exe. Why did I get the errr message "Errr getting time frm license file."?...97 I ran the timefix.exe successfully, but when I run the AspenTech prduct, I still get the errr message 26. Why?...98 What is the netwrk packet size requirement fr Sftware License Manager (SLM)?...98 What is the purpse f "n-net" n the list f cnfigured SLM Servers in the SLM Cnfiguratin Wizard?...98 Cntents iii

iv Cntents

Cntents v

Abut This Dcument This chapter includes the fllwing infrmatin: Wh Shuld Read This Guide Technical Supprt Wh Shuld Read This Guide This guide describes the Aspen Sftware License Manager (SLM) installatin and cnfiguratin. It als describes hw t administer and manage the SLM. Read this guide if yu are invlved with the planning, implementatin, installatin, r maintenance f the license management system fr AspenTech prducts fr yur cmpany. Technical Supprt AspenTech custmers with a valid license and sftware maintenance agreement can register t access the nline AspenTech Supprt Center at: http://supprt.aspentech.cm. This Web supprt site allws yu t: Access current prduct dcumentatin Search fr tech tips, slutins, and frequently asked questins (FAQs) Search fr and dwnlad service packs and prduct updates Submit and track technical issues Send suggestins Reprt prduct defects Review lists f knwn deficiencies and defects Registered users can als subscribe t ur Technical Supprt e-bulletins. These are used t alert users t imprtant technical supprt infrmatin such as: Technical advisries Prduct updates and releases Abut This Dcument 1

Custmer supprt is als available by phne, fax, and email. The mst up-tdate cntact infrmatin is available at the AspenTech Supprt Center at http://supprt.aspentech.cm. 2 Abut This Dcument

1 Quick Guide t Installing and Cnfiguring the SLM This chapter prvides abbreviated instructins n hw t install and cnfigure the SLM. It is intended fr users that have a general understanding f license managers and wh d nt intend t use the advanced features f the SLM as described in this installatin guide. Fr mre detailed infrmatin abut installing and cnfiguring the SLM, see chapters 3 thrugh 6. All aspenone V8.6 prducts use the SLM licensing system. The SLM allws tw types f licensing: stand-alne and netwrk. Stand-alne licensing btains licenses frm the same cmputer n which the AspenTech prducts are installed. Netwrk licensing is similar t stand-alne licensing, but the applicatin licenses are btained acrss a netwrk cnnectin frm a netwrk-license-server cmputer. In instances where the AspenTech prducts are installed with a stand-alne license, nly the SLM Client cmpnent is required. When using netwrk licensing, the SLM Netwrk license server shuld be installed and cnfigured n a netwrk server cmputer prir t installing any AspenTech prducts n the client cmputers. T install any AspenTech V8.6 prducts, yu will require either a stand-alne license file r access t a netwrk license server prir t prceeding with the installatin. Every SLM license file is lcked t sme lcking criteria. This can be as specific as a piece f hardware (such as a dngle hardware-key r a Hard-disk id), r it can be as liberal as the TCP/IP dmain. T btain a license file, cmplete the steps described belw in Obtaining New License Files. Nte: Yu must have a stand-alne SLM license file r access t an SLM netwrk license server prir t installing aspenone V8.6 prducts. 1 Quick Guide t Installing and Cnfiguring the SLM 3

Prerequisites Befre yu install any aspenone V8.6 prducts, ensure that yu are running a supprted perating system and have the aspenone V8.6 installatin discs available. Nte: SLM Client Tls 8.4 and SLM Server 8.5 are delivered with aspenone. aspenone V8.6 prducts require SLM Server 8.4 r higher and SLM Client Tls 8.4. Hwever, we recmmend that yu upgrade t SLM Server 8.5 t take advantage f the latest imprvements. SLM Client Tls 7.x and SLM Server 7.x are nt cmpatible with aspenone V8.6. The SLM supprts the fllwing perating systems: Desktp Windws 7 Enterprise SP1 (32-bit, 64-bit) Windws 7 Prfessinal SP1 (32-bit, 64-bit) Windws 8.1 Enterprise (64-bit) Windws 8.1 Prfessinal (64-bit) Server Windws Server 2008 R2 SP 1 (64-bit) Windws Server 2012 R2 (64-bit) Nte: Windws XP is n lnger supprted. SLM Tls and SLM Server als require: Micrsft.NET Framewrk 3.5 -and- Micrsft.NET Framewrk 4.0 r Micrsft.NET Framewrk 4.5 4 1 Quick Guide t Installing and Cnfiguring the SLM

Micrsft.NET Framewrk 3.5 Prerequisites On Windws Server 2008 R2 SP1, if yu select all.net Framewrk 3.5.1 Features using the Add Features Wizard, yu must install the IIS Web Server as well, as shwn belw. 1 Quick Guide t Installing and Cnfiguring the SLM 5

Hwever, if yu clear the HTTP Activatin check bx under.net Framewrk 3.5.1 Features within the Add Features Wizard, the IIS Web Server is nt required (as shwn belw). AspenTech Prduct Installatin Prcess: 1 Obtain license file(s) frm AspenTech. 2 If yu are using a netwrk license file, install and cnfigure SLM Netwrk License Server. 3 Install the AspenTech prducts frm the aspenone V8.6 installatin disks. Yu will be prmpted t specify either a stand-alne license file r a netwrk license server during the installatin prcess. 4 Test the prducts t ensure license system functinality. 5 Optinally cnfigure the SLM advanced features. Step 1: Obtaining License Files frm AspenTech Yu can btain license files frm the AspenTech Custmer Supprt website. Fr instructins abut btaining license files, g t the AspenTech Custmer Supprt website at http://supprt.aspentech.cm, and then click Upgrade Requests. Fr netwrk licensing, yu will btain a single license file t be installed n the netwrk license server cmputer. 6 1 Quick Guide t Installing and Cnfiguring the SLM

Fr stand-alne licensing, yu may receive either a single license file r many files (ne fr each stand-alne client cmputer). If yu are upgrading frm a previus SLM server versin t SLM Server 8.5, yu d nt need t request a new license file. Yur existing license file is cmpatible with SLM server versin 8.5. Step 2: Installing AspenTech SLM Netwrk License Server If yu will be using netwrk licensing, yu will need t install and cnfigure a netwrk license server. SLM Server 8.5, which is based n Sentinel RMS License Manager versin 8.5, is delivered with aspenonev8.6. aspenone V8.6 requires SLM Server 8.4 r higher; hwever, we recmmend that yu upgrade t SLM Server 8.5 t take advantage f the latest imprvements. Nte: AspenTech recmmends that yu leave yur legacy netwrk licensing system, such as ALM 2.2, running until all AspenTech prducts have been successfully upgraded t versin 2006 r later. Yu may already have a Sentinel RMS License Manager versin 8.5 server installed n yur netwrk license server machine. If this is the case, yu can skip the installatin f the netwrk license server and prceed t installing the netwrk license file and cnfiguring the netwrk license server ptins. T install the netwrk license server: 1 Back up the license file lservrc frm the flder: SLM Server 7.2: <rt>\prgram Files\Rainbw Technlgies\SentinelLM 7.2.0.1 Server\English. SLM Server 8.x: <rt>\prgram Files {(x86)}\cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT\ 2 Befre installing the 8.5 versin f the Sentinal RMS License Manager license server, shut dwn and uninstall any existing SentinelLM (r Rainbw Technlgies-SentinelLM) netwrk license server. T d this, click Cntrl Panel Add r Remve Prgrams and remve any prgram named SentinelLM X.X.X.X Server. Make sure that n users are lgged n t the server. If any licenses are cmmuted by users, thse licenses must be returned back t the server befre upgrading. 3 Restart the cmputer. 4 Make sure that n Windws prgrams are running n the cmputer befre starting the netwrk license server installatin prcess. 5 Insert any aspenone prduct disc int the DVD drive f the cmputer. Nte: Fr cmputers that have the DVD Autrun feature enabled, steps #6 and #7 are autmatically perfrmed. 6 Frm the Start menu, select Run. 7 In the Run view, type: d:\setup.exe and click OK (where d: crrespnds t the drive letter f the DVD drive). 1 Quick Guide t Installing and Cnfiguring the SLM 7

The Welcme dialg bx appears. 8 On the Welcme dialg bx, select the Install and cnfigure SLM (Sftware License Manager) sftware. 8 1 Quick Guide t Installing and Cnfiguring the SLM

9 On the Read aspenone Sftware License Terms dialg bx, review the license agreement and select the I accept the terms in the license agreement check bx. 10 Click Next. On the Chse the aspenone licensing prduct yu want t install dialg bx, select SLM License Server. 1 Quick Guide t Installing and Cnfiguring the SLM 9

11. Click Next. If yu have a netwrk license file, click Brwse n the Specify License File dialg bx and select it. If yu d nt have a license file, click Next t install the SLM server. 12. Cmplete the screens in the Wizard. The SLM Server is nw installed. Nte: If yu intend t use Advanced Netwrk Server Features such as Usage lgging r Grup License Reservatin, details n these features can be fund in Chapter 6: Advanced Licensing Functins. Installing the Sentinel System Drivers (hardware-key drivers) If yu are using an SLM license file (stand-alne r netwrk) which is lcked t a dngle (hardware-key), yu must install Sentinel System Drivers t supprt cmmunicatins with the device. Sentinel System Drivers can be installed by selecting the Dngle Driver ptin under SLM Tls. Fr a netwrk license server, the Sentinel System Drivers will be installed as part f the server installatin prcess. Prerequisite: Discnnect any USB r parallel dngle cnnected t the cmputer. 1 Insert any aspenone prduct disc int the DVD drive f the cmputer. Nte: Fr cmputers that have the DVD Autrun feature enabled, steps #2 and #3 are autmatically perfrmed. 2 Frm the Start menu, select Run. 10 1 Quick Guide t Installing and Cnfiguring the SLM

3 In the Run view, type: d:\setup.exe and click OK (where d: crrespnds t the drive letter f the DVD drive). AspenONE Installer is launched. 4 On the Welcme dialg bx, select Install and Cnfigure SLM (Sftware License Manager) sftware. 5 One the License Agreement dialg bx, review the license agreement and click Yes, I accept the terms in the license agreement. 6 Click Next. The Chse the aspenone licensing prducts yu want t install dialg bx appears. 7 Expand the SLM Tls ptin and make sure that the Dngle Driver ptin is selected. Click Next, and finish the screens. When the installatin is cmplete, click Finish. 8 Verify that the Sentinel System driver was installed. In Windws Explrer, brwse t the Sentinel system driver and verify that the SetupSysDriver.exe file exists. The SetupSysDriver.exe file is installed t: <rt>\prgram Files {(x86)}\cmmn Files\SafeNet Sentinel\Sentinel System Driver\ Nte: It is nt necessary t run the SetupSysDriver.exe. 9 Install the SLM dngle int the USB prt f yur cmputer. 10 G t Step 3: Installing aspenone prducts. 1 Quick Guide t Installing and Cnfiguring the SLM 11

Step 3: Installing aspenone prducts aspenone V8.6 prducts require licenses t run. During the installatin prcess, the user will be prmpted t prvide a stand-alne license file r the IP r Name f a netwrk license server cmputer. The installer autmatically installs the license file and/r cnfigure the SLM server cnnectins while perfrming the prduct installatin. Nrmally, this shuld be all that is required t start using the AspenTech prduct(s). In the event that the license-file needs t be changed, use the fllwing prcedure. Nte: SLM Client Tls 8.4 and SLM Server 8.5 are delivered with aspenone V8.6. aspenone V8.6 prducts require SLM Server 8.4 r higher and SLM Client Tls 8.4. Hwever, we recmmend that yu upgrade t SLM Server 8.5 t take advantage f the latest imprvements. SLM Client Tls 7.x and SLM Server 7.x are nt cmpatible with aspenone V8.6. Installing a new Stand-alne License file Nte: A stand-alne license file must be installed n the same cmputer as the AspenTech prduct(s). 1 Cpy the new license file frm the disk (r e-mail) t a temprary lcal flder. If yur license files are lcked t the client cmputer disk id, there will be a unique license file fr each client cmputer. If yur license files lck t a netwrk dmain, there will be a single, shared, license file that must be cpied t each client cmputer n that dmain. 2 Duble-click the license file. If SLM Client cmpnent is already installed n the cmputer, the file will autmatically rename and install itself t the apprpriate directry: <rt>\prgram Files {(x86)}\cmmn Files\AspenTech Shared Where <rt> is the installatin path fr Micrsft Windws n yur cmputer. 3 After the stand-alne license file is installed, the license file extensin is renamed frm.slf t.lic. Fr example, if the license file sent t yu is named lservrc_xxx_xxxxx.slf, rename it t lservrc_xxx_xxxxx.lic. Ntes: With aspenone V8.6, standalne license files are cpied t <rt>\prgram Files {(x86)}\cmmn Files\AspenTech Shared\ and nt <rt>\prgram Files {(x86)}\cmmn Files\Hyprtech\Shared\ Make sure that yur system settings are set t display file extensins. If the file icn changes frm the Aspen lg t an unknwn file type, then the installatin r renaming f the license file has been successful. 12 1 Quick Guide t Installing and Cnfiguring the SLM

If this license file replaces an existing license file with the same name, yu must manually delete the lservrc_xxx_xxxxx file frm the directry specified in step 2 abve. (It is a gd idea t remve all lservrc files frm yur cmputer befre installing the new license file t make sure that nly the new license exists n yur cmputer.) 4 G t Step 4: Test the SLM Installatin. Installing a Netwrk License file Fr netwrk licensing, the Sentinel RMS License Manager 8.5, the netwrk license file, and, if yu use ne, the SLM dngle must all be installed n the SLM license server cmputer. The AspenTech prducts are installed n individual client cmputers r ther applicatin servers. T install the license file fr the Netwrk license server 1 Lcate the ladls.exe executable file in the license server directry: <rt>\prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT Run ladls.exe and select Remve t stp the license server service. 2 Cpy the license file t the Sentinel RMS License Manager license server directry. The default SLM license server directry is: <rt>\prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT 3 Rename r delete any pre-existing license file(s). 4 Rename the new license file t LSERVRC (n file extensin). 5 Run ladls.exe again and select Add t start the license server. 6 G t Step 4: Test the SLM Installatin. Nte: Make sure that yu relad the license server whenever yu change yur license file. All users shuld exit any sftware using the netwrk license server and return any cmmuted licenses befre the relad is perfrmed. If yu are lading a license file that cntains a large number f licenses, it may take sme time fr the server t cmplete the prcess. Step 4: Test the SLM Installatin T verify that the SLM cntinues t functin prperly, the fllwing tests can be perfrmed: Run-time Licensing AspenTech prducts require that the SLM prvide licensing when they are used. These prducts are called run-time licensed. 1 Quick Guide t Installing and Cnfiguring the SLM 13

T test run-time licensing with stand-alne licenses 1 Install the AspenTech prduct fllwing the installatin instructins fr that prduct. 2 Run the SLM Cnfiguratin Wizard. Click Start Prgrams AspenTech Cmmn Utilities SLM Cnfiguratin Wizard. 3 On the Intrductin dialg bx, select N t the prmpt, Will yu be cnnecting t an SLM server ver the netwrk? This ensures yu are using nly the lcal stand-alne license file. If the prduct is unable t accept a license, there may be a prblem with the license file. Nte: If yu will be using a cmbinatin f netwrk and stand-alne licenses, yu can switch this setting back t Yes after testing the standalne licensing. 4 On the Cnfigure Advanced Settings dialg bx, select Yes t the prmpt, Wuld yu like t cnfigure the Advanced Settings? 5 On the Lcking dialg bx, select the Lck Mechanism t which yur license lcks. Click Next thrugh the wizard t exit the wizard. Yu can leave Lck Mechanism as Default in case yu are nt sure what ptin t chse. SLM has the ability t autmatically cllect the crrect lcking mechanism. Nte: Fr mre infrmatin abut the SLM Cnfiguratin Wizard, see the SLM Cnfiguratin Wizard Help. 6 Launch the AspenTech prduct. If the AspenTech prduct launches, SLM was installed crrectly. If the AspenTech prduct is unable t btain a license when yu start it, there may be a prblem with the license file. If the prduct fails t run, verify that each step fr installing SLM and each step fr installing the AspenTech prduct was prperly perfrmed. If yu suspect a prblem with the license file, cntact Technical Supprt (http://supprt.aspentech.cm). T test run-time licensing with a netwrk license server If the aspenone V8.6 prduct was installed using a netwrk license server, the installatin prcess shuld have cnfigured the SLM t cntact the specified server(s) fr run-time licensing. T cnfirm that the servers have been cnfigured in the SLM, run the SLM Cnfiguratin Wizard as described abve and select Yes when asked if yu will be cnnecting t a license server f the netwrk. Verify that the netwrk license server(s) that were specified during installatin appear in the Cnfigured Servers list. The SLM Cnfiguratin Wizard can be used t mdify and cntrl the client cnnectins t multiple license servers. Fr mre infrmatin abut the SLM Cnfiguratin Wizard, see the SLM Cnfiguratin Wizard Help. Mnitring the Netwrk License Server The WLMAdmin.exe is the primary tl fr mnitring and administering the Sentinel RMS Netwrk License Server. The fllwing prcedure describes hw t install and launch this administratin tl. Fr mre infrmatin n using WLMAdmin.exe, see the sectin Checking that the License Server has been prperly initialized belw. 14 1 Quick Guide t Installing and Cnfiguring the SLM

1 Insert any aspenone prduct disc int the DVD drive f the cmputer. Nte: Fr cmputers that have the DVD Autrun feature enabled, steps #2 and #3 are autmatically perfrmed. 2 Frm the Start menu, select Run. 3 In the Run view, type: d:\setup.exe and click OK (where d: crrespnds t the drive letter f the DVD drive). 4 On the aspenone Installer, select Install and Cnfigure SLM (Sftware License Manager) Sftware. 5 Click Next. The License Agreement dialg bx appears. Review the license agreement and click Yes, I accept the terms in the license agreement. 6 Click Next. The Chse the aspenone licensing prducts yu want t install dialg bx appears. 7 Expand the SLM Tls ptin and select SLM Server Admin Tls. 8 Click Next, and then click Install t begin the installatin. 9 When the installatin is cmplete, pen the WLMAdmin utility by clicking Start Prgrams AspenTech Cmmn Utilities WLMAdmin 10 Cnfigure the WLMAdmin utility t cmmunicate with a netwrk license server. Frm the Edit menu, select Defined Server List and add yur server name. Depending n hw many licenses are in yur file, it may take a while fr the licenses t appear. Imprtant: When installing AspenTech prducts, yu will be prmpted t type the name f this license server during the install. AspenTech recmmends that yu type the fully qualified dmain name, such as licenseservername.netwrkdmain.cm. Step 5: Cnfiguring the SLM and Advanced Features The SLM may be cnfigured t fit yur particular needs and has several advanced features yu may chse t use. Fr infrmatin abut cnfiguring the SLM, such as accessing the netwrk server, what t display in lg files, hw lng t wait between bradcasts fr licenses, and jb tracking ptins, see Chapter 5: Cnfiguring SLM. Fr infrmatin abut advanced licensing functins, such as alternate licensing cnfiguratins, cmmuting licenses, and stpping r changing the license server, see Chapter 6: Advanced Licensing Functins. 1 Quick Guide t Installing and Cnfiguring the SLM 15

16 1 Quick Guide t Installing and Cnfiguring the SLM

2 SLM Overview AspenTech cntrls the use f AspenTech prducts thrugh the SLM. SLM is a sftware-based security system that cntrls and tracks the usage f AspenTech sftware, cmpnents, and features as well as certain third-party sftware. Nte: SLM is required t install r run aspenone V8.6 prducts r t upgrade t an aspenone V8.6 prduct. SLM Client Tls 8.4 and SLM Server 8.5 are delivered with aspenone V8.6. aspenone V8.6 prducts require SLM Server 8.4 r higher and SLM Client Tls 8.4. Hwever, we recmmend that yu upgrade t SLM Server 8.5 t take advantage f the latest imprvements. SLM Client Tls 7.x and SLM Server 7.x are nt cmpatible with aspenone V8.6. aspenone V8.6 is nt cmpatible with previus license managers, such as Aspen License Manager (ALM) 2.2 r 3.0. Benefits f SLM All aspenone V8.6 prducts use the SLM licensing system. SLM prvides equivalent functinality t previus AspenTech license managers, while adding many f the features requested by clients. Sme f the majr capabilities and benefits ffered by SLM are listed belw: Greater return n sftware investment thrugh imprved prductivity Maximizes crprate-wide access t sftware Leverages investment ver multiple time znes Imprved perfrmance thrugh access t a larger technlgy tlkit Ability t access and evaluate new sftware technlgies utside f cre departments Supprts adptin f the mdel-centric, lifecycle apprach Supprt f a standardized tlkit fr better quality cntrl Reduced administratin and ttal cst f wnership (TCO) Reduce r eliminate stand-alne user key tracking and administratin Maintain sftware n central servers, significantly reducing IT time / csts Imprved mnitring f sftware usage Track current and histrical individual, departmental and rganizatinal use 2 SLM Overview 17

Budget / allcate, manage deplyment and assess training needs Enhanced perfrmance and reliability Spread licenses acrss license servers t ensure access t critical sftware Optimized fr client Netwrks SLM technlgy requires less netwrk bandwidth and cmputing pwer. The netwrk speed fr SLM has been rigrusly tested and ptimized. Tls are prvided t enable clients t test and ptimize their netwrks. License Splitting Splits license pl ver multiple Netwrk License Servers Splits licenses ver tw (2) r mre Netwrk License Servers Transparent t standard users. Imprves license access speed by reducing netwrk latency. Users access servers based n netwrk prximity. Ensures access t critical sftware if a server ges dwn; any Prducts in use will shut dwn gracefully. When user starts prduct it will autmatically switch t an available Netwrk License Server (if licenses are still available). Cmmuting Optin Enables ff-netwrk prduct usage, fr example, remte plant site, hme, client site. SLM Primer This sectin describes the general cncepts f SLM, including: License Terminlgy SLM Cmpnents SLM System Requirements License Lcking Criteria License Files License Mdes Installatin Mdes Obtaining License Files SLM Dngles Sentinel System Driver Netwrk Requirements 18 2 SLM Overview

License Terminlgy The fllwing table describes the license terminlgy used within this manual: Term License License string License File SLM Dngle Stand-alne License Netwrk License Netwrk License Server SLM Cmmuted License Descriptin Permissin granted t the AspenTech prduct/prgram/applicatin/cmpnent t use a specific feature. An encrypted alphanumeric text string used t define a single licensed feature. File cntaining license strings fr the specific features licensed t the user. Physical hardware device used t secure licenses. License granted is lcal t the user cmputer. License granted/btained is frm a netwrk license server. Prgram r service running n a cmputer that is attached t the Netwrk (LAN r WAN). This grants licenses t the AspenTech prduct that is running n netwrk user cmputers. Sftware License Manager, the AspenTech sftware security system. Cmmuting r brrwing is the prcess f temprarily mving a license frm a license server t a stand-alne cmputer, such as a laptp. SLM Cmpnents This sectin describes the cmpnents that cmprise SLM. These cmpnents are typically predetermined during the rder administratin prcess and are included in yur shipment. The basic SLM requirements include the fllwing: SLM license file SLM lcking criterin SLM client (included with all AspenTech prduct installatins) SLM license server Additinally, sme users will require: SLM dngles Sentinel System Drivers 2 SLM Overview 19

SLM System Requirements Supprted Operating Systems Fr supprted perating systems, see the Prerequisites sectin in this dcument. If yu are using an SLM dngle, Sentinel drivers are required. Minimum System Requirements A cmputer with a Pentium 4 r faster prcessr and 1 GB f RAM is recmmended t avid cnflicts with ther applicatins. License Lcking Criteria SLM uses license files that must be lcked t sme lcking criterin. The lcking criterin can be as specific as a piece f hardware (such as a dngle r a disk id), r the TCP/IP dmain. The lcking criteria can be divided int tw general ptins: dngle-free and dngle-lcked. Dngle-free. The license file cntains a lcking cde that is lcked t sme cmpnent f the target cmputer (fr example, disk id) r a cmpany s netwrk (fr example, TCP/IP dmain). The license will nly wrk if the lcking criterin and license file are bth available t the user PC (standalne) r license server (netwrk). Dngle-lcked. The license file cntains a lcking cde that is lcked t a dngle and will nly wrk if the dngle is attached t the cmputer n which the license manager is run. This may be a netwrk license server r a standalne prduct installatin. Dngles are available t all custmers upn request. If a dngle is requested, it will be delivered t yur system administratr with the sftware package. If yu selected the dngle-less licensing ptin during rder administratin, the license file yu receive will have a lcking cde assciated with sme lcking criterin that was prvided during the rder administratin prcess. If yu are unsure f whether yu need a dngle t use the AspenTech sftware, cntact yur system administratr. 20 2 SLM Overview

AspenTech uses the fllwing delivery mechanisms: Dnglefree delivery Dnglelcked Site-based license Delivered as a stand-alne license lcked t: NT Dmain and TCP/IP Dmain in general Lgn Dmain and TCP/IP Dmain fr Nvell netwrks nly Delivered as a netwrk license lcked t a dngle, which must be attached t the license server. User-based license Delivered as stand-alne r netwrk as per the custmer s sftware license agreement: Netwrk licenses are lcked t the netwrk card f the license server, r anther mechanism as apprpriate. Stand-alne licenses are lcked t PCI Hardware, Netwrk Card, and Physical Disk Layut, machine plus IP address, r anther mechanism as apprpriate. Delivered as stand-alne r netwrk as per the custmer s sftware license agreement and lcked t a dngle. License Files SLM uses license files t cntrl access t AspenTech prducts. License files are btained during the rder administratin prcess and are delivered with yur shipment. Fr mre infrmatin abut btaining licenses, see Obtaining License Files in this chapter. The license files must be installed n each client cmputer r n the server where the SLM License Server cmpnent is installed. Each license file cntains the fllwing cmpnents: A lck cde A start date An end date Prduct license strings Nte: In rder fr the license t be valid, the System clck time must fall between the start and end dates f the license file. Fr hardware lcked stand-alne license files (thse license files lcked t a disk id r netwrk card), there is a separate stand-alne license file required fr each user cmputer r netwrk license file required fr each server. Make sure that the license file cpied t the target cmputer is the license file specifically intended fr that cmputer. Fr dngle lcked license files, there is a separate license file required fr each dngle. If yu are using a dngle, cnnect the dngle t the apprpriate USB r parallel prt. Only ne netwrk license file may be installed n a netwrk server at ne time, but any number f stand-alne, dngle-lcked license files may be installed n a single user PC. SLM will autmatically lcate the apprpriate ne, based n the dngle it detects. Cautin: D nt plug this dngle int the serial prt, because it will damage yur cmputer. 2 SLM Overview 21

Fr a netwrk lcked license files (thse license files lcked t a netwrk dmain), there is a single, shared, license file fr each netwrk dmain that must be cpied t each cmputer n the dmain. Make sure that the license file cpied t the dmain cmputers is the crrect license file fr that dmain. License Mdes There are tw mdes fr AspenTech licensing: site-based and user-based. The type f mde used fr yur lcatin is determined during the sales and cntracting prcess. T determine the type f licensing mde specific t yur rganizatin, cntact yur System Administratr. Site-based and user-based licensing mdes may be installed as a stand-alne installatin (directly n each user s cmputer) r as a netwrk installatin using a netwrk license server. Site-based Site-based sftware can be used by any individual within a licensed site with n restrictins n the number f users r time in use. A site may cntractually be defined as an actual custmer site, a business department, r sme ther rganizatinal cmpnent. It may even be defined as wrldwide. SLM des nt cunt users with site-based licenses. Site-based licenses may als be referred t as unlimited. User-based Any individual can use user-based sftware licensing as lng as the number f purchased license units is nt exceeded. SLM cunts the sftware in use and limits the number f units that can be accessed at ne time t the number f units purchased. Mst ften, sftware is sld in tkens, but it may als be sld in seats r simultaneus users, bundles, r ther units f measure. Installatin Mdes SLM may be installed in a Stand-alne mde r Netwrk mde. Stand-alne Mde In the Stand-alne license mde, the AspenTech prducts and license file are installed n a single cmputer that includes the lcking criterin. This cnfiguratin is mst ften used when the AspenTech prduct uses a sitebased, dngle-free license, r when the user-based AspenTech prduct is nly used by ne individual r is nly installed n a particular cmputer. The installatin rutines f all AspenTech prducts include the SLM client. If yu are using a dngle, yu als must have a USB prt available n yur cmputer. If yu are using yur AspenTech prduct n an applicatin server, the SLM client must be installed n the lcal, end-user cmputer. 22 2 SLM Overview

Ntes: SLM checks fr a stand-alne license first. If the license is nt fund r the lcal security SLM dngle is nt installed, SLM searches fr an available netwrk license. Yu can install the Sentinel dngle drivers fr SLM by selecting the Sentinel System Drivers ptin frm any aspenone prduct disc. SLM may require full write access t the registry n the client cmputer while certain AspenTech prducts are running (fr example, when cmmuting). Netwrk Mde The Netwrk license mde is cnfigured s the AspenTech prduct is executed n yur cmputer, but the licenses are installed n a netwrk license server, s they can be shared with ther users. The license server cnsists f: A file f netwrk license strings. The license server applicatin. The license server issues the licenses t all users n the netwrk. Each License Server must be running a supprted Server Side Operating System. If yur license uses a dngle, yu must have an available parallel r USB prt. It is recmmended that the server have a static IP Address. AspenTech recmmends that each License Server be a dedicated server (AspenTech prducts nly). 2 SLM Overview 23

Nte: The Sentinel dngle drivers fr SLM may be installed by selecting the Sentinel System Drivers ptin frm any aspenone prduct disc. Obtaining License Files There a tw times when new license files may be required: when a cntract changes r is created, r when there are changes t the sftware. In any case, the licenses yu need shuld be delivered with yur sftware package. Sftware Updates If new license files are required, yu will be asked t prvide lcking infrmatin during the shipping cnfirmatin r request prcess. Fr instructins abut btaining license files, g t the AspenTech Custmer Supprt website at http://supprt.aspentech.cm, and then click Upgrade Requests. Cntract Changes, including new Cntracts If yu are receiving new sftware r additinal licenses fr existing sftware, the cnfiguratin f the licenses will be specified in the cntract. Yu will be cntacted by AspenTech s Distributin department t prvide the lcking infrmatin they require t ship yur licenses. In sme cases, yu may receive yur sftware with a dngle and dngle-lcked license. In ther cases, yu may receive yur sftware with a dngle-less license and n dngle is necessary. T btain license files frm AspenTech License files are btained frm the AspenTech Custmer Supprt website. Fr instructins abut btaining license files, g t the AspenTech Custmer Supprt website at http://supprt.aspentech.cm, and then click Upgrade Requests. SLM License String Prefixes Defined New license files will have the prefix SLM_ n each license string. Hwever, ther prefixes may als appear. This prefix AEA (Aspen Engineering Applicatin) AET (Aspen Engineering Tken) applies t this type f license Standard Tken descriptin Each license string defines the number f seats yu are licensed fr (in ther wrds, cpies available fr use). Mst licenses will have a standard AEA_ license prefix. This license string tracks the tkens in use and defines any hard limit placed n the number f tkens available. example AEA_AspenPlus AET_HYSYS_Prcess SLM Unified Yu can use SLM licenses t SLM_Aspen_Retail 24 2 SLM Overview

This prefix applies t this type f license descriptin example (Sftware License Manager) switch between Bundle, Standard, and Tken mdes, r t use AEA, AET, and SLM licenses simultaneusly. This prefix is the nly ptin available in many cases, and is recmmended in all cases. Nte: If yu want t upgrade yur existing license t a Unified license, cntact Technical Supprt: esupprt@aspentech.cm. SLM Dngles (Hardware-Keys) SLM requires that license files be lcked t sme lcking criterin. As stated previusly, this can be a disk id r dngle, r the TCP/IP dmain. Sme clients will receive ne r mre SLM dngles with their licensing package. A dngle is a piece f hardware that plugs int a USB, parallel, r serial prt n a cmputer. The dngle and license file cntain a set f matching cdes. The cde n the dngle must match the cde in the license file in rder fr yu t access the applicatins licensed t yu. If the cdes d nt match, the applicatins are unable t run. This prevents unauthrized users frm running the sftware applicatins. SLM USB dngles require the Sentinel System Driver. Dngle Driver needs t be installed befre plugging in the dngle. Cautin: D nt plug a USB dngle int the serial prt because it will damage yur cmputer. Ntes: In mst cases, dngles are nt required fr aspenone V8.6 prducts. If yu have nt used dngles fr previus versins f AspenTech prducts, yu will nt receive dngles with yur aspenone V8.6 license. If yu previusly used dngles with yur AspenTech prducts, yu will cntinue t receive dngles with yur prduct shipment. If yu did nt receive a dngle with yur shipment, yu can ignre the sectins f this manual describing dngles. Serial prt dngles are legacy hardware and are n lnger available and supprted. Fr mre infrmatin abut serial prt dngles, see the sectin Hyprtech Green Dngles in Chapter 3, Installing Stand-alne License Files. Parallel prt dngles cannt be stacked in parallel r in series. Security dngles previusly used by AspenTech and Hyprtech prir t SLM, except fr the Hyprtech green dngles, are incmpatible with SLM. AspenTech requests that yu return yur ld dngles when yu n lnger need them. 2 SLM Overview 25

Sentinel System Driver If yu are using dngles as yur lcking device, the Sentinel System Driver is required t cmmunicate with the dngle. The Sentinel System Driver can be installed frm any aspenone prduct disc. Refer t Chapter 1 fr the installatin steps. T check that the Sentinel System Driver is installed Verify that the Sentinel System driver was installed. In Windws Explrer, brwse t the Sentinel system driver and verify that the SetupSysDriver.exe file exists. The SetupSysDriver.exe file is installed t: <rt>\prgram Files {(x86)}\cmmn Files\SafeNet Sentinel\Sentinel System Driver\ Nte: It is nt necessary t run the SetupSysDriver.exe. Netwrk Requirements Netwrk Cnnectivity Requirements SLM is designed fr use n private netwrks (LAN r WAN), but nt n public netwrks (Internet). In cases where the Internet is the nly cnnectivity available, yu can establish a VPN (Virtual Private Netwrk) between tw endpints n the netwrk. This bth enables the SLM t functin prperly and prvides yu with netwrk security. The minimum cnnectin speed is 128 kbps, and the cnnectin must be reliable. Dial-up cnnectins (remte access services) are nt recmmended due t pr reliability. This is especially true if yu attempt t cmmute licenses ver these cnnectins, as reliability is crucial fr cmmuting licenses. By default, the Sentinel RMS License Manager service runs at prt number 5093. Nte: The packet size required fr SLM is 7512 bytes. If yu are cnnecting t the license server thrugh VPN, VPN might add additinal bandwidth verhead. Supprt fr Previus Licensing Systems Cautin: SLM netwrk license server and Hyprtech security systems are NOT cmpatible. D nt install the SLM security system n the same cmputer as a Hyprtech netwrk security system. If yu are running an AspenTech prduct versin that uses the Aspen License Manager (ALM), the ALM and SLM license servers may be installed and running at the same time. Hwever, yu are respnsible fr ensuring that yu d nt exceed the terms f yur license agreement when the tw servers are running simultaneusly. If yu want t reduce the number f users n either 26 2 SLM Overview

f yur netwrk servers t help ensure that yu remain within yur cntractual limits, cntact yur sales representative r Technical Supprt at http://supprt.aspentech.cm. Features and Limitatins f SLM The fllwing lists sme f the basic features and limitatins f the SLM: Once the SLM dngle and licenses are installed n the license server, any user wh has the Aspen prducts n his cmputer can run the AspenTech prduct as lng as he has a netwrk cnnectin t that license server. If the client cmputer resides n a different sub-netwrk, r a particular server is desired (if there are multiple servers), the client can direct its license requests t a particular server thrugh the use f: SLM Cnfiguratin Wizard. AspenTech recmmends using this methd t set up the server license request. The LSHst envirnment variable. The envirnment variable (r its text file equivalent) lists the license server names and the rder in which they are called when a license request is made. If all license servers are unavailable r cannt grant a license request n start-up f the AspenTech prduct, access t the AspenTech prduct is denied. Once the AspenTech prduct has started, the client-side sftware intermittently checks t ensure that the SLM server is available. If the server is nt available (in ther wrds, lss f access t the server while the prduct is pen), the user will experience different behavirs depending n the prduct in use. In mst cases, the user is prmpted t save his wrk, the license is checked back in, and the AspenTech prduct is shut dwn. The user can then attempt t start the prduct again. The amunt f time allwed fr shut-dwn f the sftware varies frm a few secnds fr design tls t several days fr critical prductin sftware. During start-up, license servers are checked fr availability again, accrding t the cnfiguratin f the client cmputer. If ne f the servers is able t grant the requested license, the user is allwed t cntinue. Licenses that are in use cannt be terminated remtely (in ther wrds, the administratr cannt bump r terminate users). Nte: The cmmuter ptin can nly be used with sftware frm ne server at a time. Sftware frm tw r mre servers cannt be cmmuted simultaneusly. SLM can be laded n multiple license servers. In this case, the licenses r tkens must be divided between servers. 2 SLM Overview 27

License Manager Prgram and Files SLM cntains many ptins that can be set t cntrl the behavir f the Licensing System. Yu can set r cnfigure these ptins: By using the SLM Cnfiguratin Wizard. By setting the envirnment variables f the perating system. AspenTech recmmends using the SLM Cnfiguratin Wizard t set the ptins. SLM Cnfiguratin Wizard The SLM Cnfiguratin Wizard is a user-friendly client-side tl used t set the relevant keys in the registry t the user-specified values. Fr infrmatin abut the SLM Cnfiguratin Wizard, see Chapter 5: Cnfiguring SLM. SLM Cmmute Use SLM Cmmute t manage cmmuted licenses. Cmmuting is allwed nly if permissin t cmmute has been activated in the feature's license string (cntact yur AspenTech Sales representative fr mre details). Fr detailed infrmatin abut SLM Cmmute, see Cmmuting Licenses in Chapter 6. Envirnment Variables Yu can use envirnment variables f the perating system t cnfigure the ptins available in SLM. AspenTech recmmends using the SLM Cnfiguratin Wizard t set SLM peratin variables. Fr mre infrmatin, see Cnfiguring SLM using Envirnment Variables in Chapter 6. User Optins SLM als cntains ther ptins that are set by using specific cnfiguratin files: User Alerts Grup Reservatins User Alerts Alerts let yu knw abut certain license events. Fr detailed infrmatin abut user alerts, see User Alerts in Chapter 6. 28 2 SLM Overview

Setting the Grup Reservatins Grup reservatins let yu assciate user grups with each feature. Each f these user grups is then reserved in a pl cntaining a certain number f licenses fr that feature. Any licenses nt specifically reserved fall in the general pl. Fr detailed infrmatin abut grup reservatins, see Grup Reservatins in Chapter 6. Base Lad Tken Service Fr sme custmers, sme prducts are priced using methds such as per server r per site in place f r in additin t dynamic user charges. Fr these situatins, the Base Lad Tken Service prvides a way t track and reprt n the prduct tken cnsumptin. The Base Lad Tken Service cnsumes tkens when yu use any f the fllwing prducts: Aspen PIMS Aspen Supply Chain Planner Aspen Petrleum Supply Chain Planner (DPO) Aspen Inventry Management and Inventry Scheduling (IMOS) Aspen Fleet Optimizer (Retail) T install the Base Lad Tken Service: During the SLM install prgress described in the Installing AspenTech SLM Netwrk License Server sectin n page 7, Aspen Base Lad Tken Service is autmatically installed when yu select SLM License Server. The fllwing prerequisites apply: The license key(s) must be cnfigured befrehand t cnsume the crrect number f tkens. Fr any questins regarding license files, cntact AspenTech Supprt. The SLM Server must be installed and running with the crrect license file. The Aspen Base Lad Tken Service will be installed n the same cmputer as the SLM Server. 2 SLM Overview 29

T view the base lad tken usage: On the license server cmputer, select Start Prgrams AspenTech Cmmn Utilities Base Lad Tken Usage Reprt. The Base Lad Service Reprt dialg bx appears. 30 2 SLM Overview

The clumns in the dialg bx are described belw: Issued Time Time license was checked ut frm the SLM server Validatin Time Last time license was validated against the SLM server fr cnfiguratin changes License Name License key that is checked ut frm the SLM server License Cunt Number f licenses t be checked ut fr the given license Tkens Cnsumed Number f tkens cnsumed n the SLM server Expected Tkens The expected number f tkens t be cnsumed if there are n errrs, such as sufficient tkens available Status Status f checking ut the given license 2 SLM Overview 31

32 2 SLM Overview

3 Installing Stand-Alne License Files This chapter describes hw t install SLM in Stand-alne mde and Netwrk mde. Specifically, this chapter cvers the fllwing tpics: Prerequisites Installing the License files Installing dngles Yur License Package New AspenTech prducts If yu have newly leased r purchased yur AspenTech prduct, yu may receive an SLM dngle in additin t the AspenTech prduct DVD and the CD cntaining yur license file. Upgraded AspenTech prducts If yu are upgrading yur AspenTech prduct, yu will find included in yur package the AspenTech prduct DVD and a disk cntaining an upgraded license file lcked t either yur existing SLM dngle r lcking infrmatin prvided by yu during the shipping cnfirmatin r update request prcesses. The license file may als be sent by email. Installing the License File There are tw types f license mdes, Stand-alne and Netwrk. The methd fr installatin f the License File depends n the type f license mde yu have. Fllw the instructins fr the type f license mde yu are installing. 3 Installing Stand-Alne License Files 33

Installing Stand-alne Mde License Files In Stand-alne mde, the license file must be installed n the same cmputer as the AspenTech prduct(s) and, if yu have ne, the SLM dngle. T install license files fr stand-alne mde autmatically: 1 Insert the CD cntaining the license files int a drive n yur cmputer. -r- 2 If yu already have an SLM versin f an AspenTech prduct installed n the cmputer, navigate t the drive where yu inserted the CD. Dubleclick the license file icn autmatically.. The file will install itself If yu d nt have an SLM versin installed, save the license file t a lcal disk/hard drive. Yu will be asked fr the lcatin f the file when yu install the prduct. When given the ptin, click Yes t install the file lcally. T install license files fr stand-alne mde manually 1 Insert the CD cntaining the license files int a drive n yur cmputer. 2 Cpy the license file t <ROOT>\prgram files {(x86)}\cmmn files\aspentech Shared\ 3 Rename the license file s extensin as fllws: The file sent t yu is named lservrc_xxx_xxxxx.aealic r lservrc_xxx_xxxxx.slf. Rename it lservrc_xxx_xxxxx.lic. 4 Click Start Prgrams AspenTech Cmmn Utilities SLM Cnfiguratin Wizard and g thrugh the cnfiguratin prcess. Ntes: If yu manually install standalne licenses, yu must run the SLM Cnfiguratin Wizard again t initialize all the standalne licenses befre using them. If errr cde 26 time temper errr appears when yu run the prduct, see the sectin n time tamper check in the Frequently Asked Questins chapter f this dcument. Only the file extensin is changed. Make sure that n the Windws Explrer Tls Flder Optin View page, the Hide file extensins fr knwn file types check bx is cleared. If this license file replaces an existing license file with the same name, yu must manually delete the ld lservrc_xxx_xxxxx file frm the shared flder. It is a gd idea t remve all lservrc files frm yur cmputer befre installing the new license file t ensure that nly the new license exists n yur cmputer. 34 3 Installing Stand-Alne License Files

Installing the SLM Dngle T run the AspenTech prduct, yu need the license files and yu may als require an SLM dngle. SLM reads a unique lcking identity frm an SLM dngle r ther hardware device. This identity lcks the licenses t the hardware. When the AspenTech prduct runs, the lcking cdes must then match the hardware identifier fr the licenses t be valid. SLM Dngle Types There are tw types f SLM dngles: SLM parallel prt dngles SLM USB prt dngles SLM Dngles SLM dngles are Sentinel SuperPr - Cmputer ID dngles, manufactured by Rainbw Technlgies. SLM dngle is installed n the USB prt f yur cmputer. USB prt cnnectin SLM dngles can be used fr bth Stand-alne and Netwrk license mdes, althugh each licensing mde requires separately generated license files. If yu are licensing AspenTech prducts in Stand-alne license mde, the SLM dngle must be installed n the cmputer(s) running the AspenTech prduct. If yu are licensing AspenTech prducts in Netwrk license mde, install an SLM dngle n each cmputer that will be used as license servers. Cautin: D nt plug the Cmputer ID dngle in the serial prt because it culd damage yur cmputer. Nte: Any cmputer using the SLM dngle requires certain drivers t cmmunicate with the SLM dngle. Fr infrmatin abut installing the Sentinel System drivers, see the sectin, Sentinel System Driver in the SLM Overview chapter f this guide. 3 Installing Stand-Alne License Files 35

Alternate Cnfiguratins f Stand-alne License Mde Pled Dngle Cnfiguratin Yu can cnfigure the cmputers s that a pl f stand-alne SLM dngles can be shared. Fr example, if yu will be using SLM dngles A and B t run prduct A r B, respectively, ensure that license files fr bth prduct A and B are installed n yur cmputer. Then, t run prduct A, cnnect SLM dngle A t yur cmputer. T run prduct B, cnnect SLM dngle B t yur cmputer. SLM autmatically determines which license file t use. Stand-alne and Netwrk Cmbined Cnfiguratin Yu can als cnfigure user cmputers t use bth stand-alne and netwrk mdes. Fr example, if yu must run bth prducts A and B, yu can install the required SLM dngle and license fr prduct A n yur cmputer. Then yu can install the required SLM dngle and license fr prduct B n the netwrk. When yu run prduct B, SLM will first check yur cmputer fr stand-alne licenses. If the required SLM dngle and licenses are nt fund, SLM will lk fr an available SLM dngle and license n the netwrk. Hyprtech Green Dngles Hyprtech green dngles are legacy hardware. These dngles are n lnger supprted. If yu have ne f thse dngles, yu shuld cntact the AspenTech Custmer Care Team t request an updated license file and dngle. 36 3 Installing Stand-Alne License Files

4 Installing and Cnfiguring the License Server A Netwrk license server cmputer is made up f the fllwing cmpnents: License Server sftware Netwrk license file (cntaining netwrk license strings) License Server Tls SLM dngle (if yu are using dngles) Tip: Multiple license server cmputers can be cnfigured t spread the licensing lad. This can als be used as a simple and effective frm f redundancy. The best chice fr the license server cmputer is ne that is always running, because the netwrk license server cmputer must be peratinal fr the netwrk users t run the AspenTech prducts. The mst truble-free installatin will result frm a license server cmputer used nly fr the license server functin. This avids cnflicts with ther sftware. Installing and Cnfiguring a Netwrk License Server The fllwing summarizes the steps required t install and cnfigure a Netwrk license server: 1 Install the license server sftware, and install the SLM dngle (if required). 2 Install the license tls. 3 Install the license file. 4 Installing and Cnfiguring the License Server 37

Step 1: Installing the Netwrk License Server T install the license server, SLM dngle and yur SLM Administratin Tls 1 Befre installing the SLM License Server, shut dwn and uninstall the ld netwrk security server. Make sure that n users are lgged n the server. 2 Restart the cmputer. 3 Make sure that n Windws prgrams are running n the cmputer befre starting the netwrk license server installatin prcess. 4 Insert any aspenone prduct disc int the DVD drive f the cmputer. Nte: Fr the cmputers that have the DVD Autrun feature enabled, steps #5 and #6 are autmatically perfrmed. Sme Aspen prducts have variants n the way the installatin f Netwrk License Server sftware is initiated. 5 Frm the Start menu, select Run. 6 In the Run view, type: d:\setup.exe and click OK (where d: crrespnds t the drive letter f the DVD drive). The Welcme dialg bx appears. 7 On the Welcme dialg bx, select Install and Cnfigure SLM (Sftware License Manager) sftware. The License Agreement dialg bx appears. Review the license agreement and click Yes, I accept the terms in the license agreement. 8 Click Next. The Chse the aspenone licensing Prducts yu want t install dialg bx appears. Select SLM License Server, SLM Server Admin Tl and Dngle Driver t install. 9 Finish the screens. SLM Server is nw installed. Cmplete steps 16 and 17 if yur SLM license is lcked t a dngle. Nte: If yu want t recrd yur usage, yu must cnfigure the LServOpts envirnment variables, which are described in the sectin, Cnfiguring SLM using Envirnment Variables. This may require that yu restart the cmputer. 10 When yu have cmpleted installing the netwrk license server sftware, install the Sentinel System drivers. Fr infrmatin abut installing the Sentinel System drivers, see the sectin Sentinel System Driver. 11 Install the SLM dngle int the parallel prt (printer prt) r the USB prt f yur cmputer. The SLM dngle has an arrw that indicates which end is plugged in. Cautin: D nt plug this dngle int the serial prt, because it will damage yur cmputer. 38 4 Installing and Cnfiguring the License Server

Nte: Make sure that the server date and time are crrect befre attempting t use the license server. If the server platfrm time and date are set incrrectly, then the license server might nt issue any licenses because it is perfrming TimeTamper checks. Step 2: Installing the License File T install the license file fr the Netwrk license server 1 Cpy the license file t the SLM license server directry. The default SLM license server directry is: <rt>\prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT 2 Rename r delete any pre-existing license file(s). 3 Rename the new license file t LSERVRC (n file extensin). 4 Lcate the ladls.exe executable file in the license server directry: <rt>\prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT 5 Run ladls.exe and select Remve t stp the license server. 6 Run ladls.exe again and select Add t start the license server. Nte: Make sure that yu relad the license server whenever yu change yur license file. All users must exit any sftware using SLM befre the relad is perfrmed. Checking SLM Dngle The first test yu can perfrm is t check if the SLM dngle is cmmunicating with the SLM system. Use the SLM Cnfiguratin Wizard t perfrm this test. T start the SLM Cnfiguratin Wizard 1 On the Windws desktp, click Start Prgrams AspenTech SLM Cnfiguratin Wizard. The Intrductin dialg bx appears. When the SLM Cnfiguratin Wizard starts, it reads the current settings that already exist in the registry. If these settings d nt exist, they are set t the default, r, in sme cases, left blank. 2 Click Cnfig. The SLM & System Cnfiguratin view appears. 4 Installing and Cnfiguring the License Server 39

On this view, yu can see yur license settings. This view displays, amng ther things: The Sentinel Hardlck (Dngle) number The Hst name The serial number and lcking cde f the IP Address The Disk ID The Ethernet Address If the Sentinel Hardlck (Dngle) number fr the SLM dngle des nt appear: On the SLM & System Cnfiguratin view, click OK. The Intrductin dialg bx appears again. 3 Make sure that the SLM dngle is prperly installed n yur cmputer. The SLM dngle is installed n the parallel prt (printer prt) r the USB prt f yur cmputer with an arrw indicating which end is plugged in. Nte: D nt plug the parallel prt dngle int the serial prt, because it culd damage yur cmputer. 4 Click Cnfig. 5 See whether the Sentinel Hardlck (Dngle) number fr SLM dngle nw appears. 6 If yur SLM dngle is prperly attached t the server and n lck cde is appears, make sure that yu have installed the Sentinel system drivers used by the server t cmmunicate with SLM dngle. 40 4 Installing and Cnfiguring the License Server

Install the Sentinel System Drivers by fllwing the prcedure described in Sentinel System Driver in Chapter 2. T check that the Sentinel system Driver is installed Using Windws Explrer, brwse t the Sentinel System Driver flder and verify that the SetupSysDriver.exe file exists. The SetupSysDriver.exe is lcated at, <rt>\prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel System Driver\ Checking that the License Server has been prperly initialized After cnfirming that SLM dngle is cmmunicating with the system, check that the license server has been prperly initialized by using the WLMAdmin.exe prgram t cnfirm that the licenses are available. The WLMAdmin.exe prgram is nt installed with the prduct, but is accessible frm the DVD and added t the flder if yu install the Admin tls frm the DVD. WLMAdmin WLMAdmin is the primary netwrk license administratin tl. It is designed t prvide access t mst f the SLM licensing features and full infrmatin n licensing activities at three levels. This level Server Feature/License User Displays basic details n the active license servers detected n the netwrk. greater detail n the licenses available n each server. further infrmatin n the users currently using the licenses. Cautin: Due t the capabilities f the WLMAdmin, it is recmmended that nly administratrs have access t this tl. It must nt be installed with AspenTech prducts. Running WLMAdmin T run WLMAdmin, click Start Prgrams AspenTech Cmmn Utilities WLMAdmin. 4 Installing and Cnfiguring the License Server 41

The WLMAdmin view appears. When yu first pen WLMAdmin, a blank screen appears. After yu have set yur preferences, WLMAdmin starts in the view mde that was last used prvided that this was set up in yur preferences. T set yur preferences On the Edit menu, click Preferences. The Preferences view appears. 42 4 Installing and Cnfiguring the License Server

This table describes the ptins available. Object Timeut interval Bradcast interval Discver subnet servers n start up Discver defined servers n start up Shw client library errr handler messages Save these preferences t file Descriptin The time interval (in secnds) given fr a license server t respnd with license infrmatin fllwing a query frm WLMAdmin. If nly partial infrmatin is being returned frm the server, try increasing this interval. Partial infrmatin returned may indicate netwrk cmmunicatin prblems (see Chapter 7 Trubleshting SLM Prblems ). The time interval (in secnds) between WLMAdmin bradcasts. Updates server infrmatin fr the subnet server list n WLMAdmin start-up. Nt recmmended, as WLMAdmin will be slw t start-up if it des a netwrk bradcast. Updates server infrmatin fr the defined server list n WLMAdmin start-up. T retain yur defined server list when WLMAdmin is clsed, yu must select this ptin. Causes errr handler messages t appear. In rder t keep any f yur preferences, including yur defined server list, yu must select this ptin. Nte: Preferences are saved t the WLMAdmin.ini file. The WLMAdmin view is split int tw panes: Navigatin Infrmatin The Navigatin pane (lcated n the left side f the WLMAdmin view) cntains a tree brwser that lets yu access the different levels f licensing infrmatin. There are tw server lists available: 4 Installing and Cnfiguring the License Server 43

Server Defined Servers Subnet Servers Descriptin This is a user-defined list f license servers. License infrmatin is updated quickly because WLMAdmin is directed t a specific list f servers. This list is empty when WLMAdmin is first run. Yu can add servers t the defined server list using the Edit Defined Server List menu item. This list will be filled after perfrming a netwrk bradcast t lcate all active license servers (in ther wrds, cmputers running the Sentinel RMS License Manager service) n the same netwrk subnet as the cmputer frm which the query was launched. It can take sme time t perfrm the netwrk bradcast s we recmmend that yu generally use a defined server list. Accessing license infrmatin via the subnet server list is useful if yu d nt knw the name f the license server frm which yu are accessing licenses. Nte: The Subnet Servers ptin des nt search acrss netwrk Dmains r yur lcal Area Segment. S if yur netwrk server is lcated in a different ffice, WLMAdmin requires the Server name t be specified t brwse license features. Yu can als manage certain licensing activities by using the Object Inspect menu f items in the Navigatin pane. 44 4 Installing and Cnfiguring the License Server

The Object Inspect menus in the Navigatin pane are accessed by selecting an item (Server, Feature, r User) in the Navigatin pane and rightclicking. Nte: AspenTech recmmends that the ptins in the Object Inspect menu be used nly under the directin f yur AspenTech agent. The fllwing table describes the ptins available at all three different levels: Object Inspect Menu Server Server Level Add Feature Remve all Features Add t Defined List Remve frm Defined List Change Lg Filename Attempts t add licenses t the license file in use by the server. Yu cannt add features withut license strings frm AspenTech. Because AspenTech will supply yu with cmplete license files, there is n reasn t use this ptin. Attempts t remve licenses frm the license server. The server will be added t the defined server list. The server will be remved frm the defined server list. Used t change the lg filename; verrides the name set in the LServOpts envirnment variable. Stpping and relading the Sentinel RMS License Manager service will cause the lg filename t revert 4 Installing and Cnfiguring the License Server 45

Object Inspect Menu Shutdwn Server Refresh Feature Level Remve Feature Refresh User Level Refresh Server t that listed in the envirnment variable. Used t stp the Sentinel RMS License Manager service n that server. Updates licensing infrmatin fr this server nly. Attempts t remve a license frm the license file in use by the server. Updates licensing infrmatin fr this feature nly. Updates licensing infrmatin fr this user nly. The Infrmatin pane (lcated n the right side f the WLMAdmin view) displays varying amunts f infrmatin depending n the level highlighted in the Navigatin pane. The next three views shw the infrmatin available at the Server level, the Feature/License level, and the User level, respectively. Server Level 46 4 Installing and Cnfiguring the License Server

Feature/License Level User Level 4 Installing and Cnfiguring the License Server 47

WLMAdmin Menu Bar Optins The fllwing table describes the cmmands available n the WLMAdmin menu bar. Menu-Cmmand File-Exit Edit-Defined Server List Edit-Reservatin File Edit-Redundant License File Edit-Preferences View-Status Bar View-Refresh All Help- L WlmAdmin Descriptin Exits the WLMAdmin applicatin and clses the WLMAdmin view. Adds/remves/changes server infrmatin in the defined server list. This ptin will start the Grup Reservatin Editr (if available); reservatin files can als be edited using a standard text editr. See Grup Reservatins fr mre details n making reservatins. This ptin will start the WRLFTl (if available). Prvides access t the Preferences dialg bx, n which yu can specify preferences fr hw SLM perates. Displays r hides the status bar f the WLMAdmin applicatin. A checkmark indicates the status bar appears. N checkmark indicates the status bar is hidden. Updates licensing infrmatin fr all servers currently displayed in the Navigatin pane. Displays the versin number f the active WLMAdmin applicatin. Table f Required Services n SLM Server Services ALC Usage Lg Checksum Service Aspen ALC Autuplad schedule service Aspen Base Lad Service Sentinel RMS License Manager Descriptin Service t generate the checksum f the license usage data Service t autmatically transmit the usage data t AspenTech Service t accunt fr base lad tkens fr the fllwing prducts, which make use f the base lad tken cntract mdel: Aspen PIMS, Aspen Supply Chain Planner, Aspen Petrleum Supply Chain Planner (DPO), Aspen Inventry Management and Inventry Scheduling (IMOS), and Aspen Fleet Optimizer (Retail). Fr mre infrmatin, refer t the Base Lad Tken Service sectin n page 29. Service fr SLM Server Netwrk Prblems If yur license server cannt be lcated using the WLMAdmin tl, review the fllwing sectins. 48 4 Installing and Cnfiguring the License Server

Check if yu have installed the license server sftware n the server Use the fllwing steps cnfirm installatin f the SLM license server sftware. 1 Frm the Start menu, click Settings Cntrl Panel. 2 Open Add r Remve Prgrams. 3 Check the list f currently installed prgrams and make sure that Sentinel RMS License Manager 8.4 r 8.5 is present. If it is nt present, fllw the instructins in Step 1: Installing the Netwrk License Server fund earlier in this chapter. Check if the Sentinel RMS License Manager service is running If the server is nt running, start the server as described belw: 1 Open yur license tls flder: <Rt>\Prgram Files\Cmmn Files\AspenTech Shared\ 2 Check cmmunicatin with yur SLM dngle by running the Cnfiguratin Wizard. On the Cnfiguratin Wizard, click Cnfig t display yur SLM and System cnfiguratin infrmatin. This view displays the serial number and lcking cde f yur IP Address, Disk ID, Hst Name, Ethernet Address, and the Sentinel Cmputer ID number. If yur SLM dngle is prperly attached t the server, and the lck cde still des nt appear, install the Sentinel System Driver by fllwing the prcedure described in the Sentinel System Driver sectin f Chapter 2. T check that the driver is installed, using Windws Explrer, brwse t the Sentinel System Driver flder and verify that the SetupSysDriver.exe file exists. The SetupSysDriver.exe is lcated at: <rt>\prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel System Driver\ 3 Check that the license server has been prperly initialized by running the WLMAdmin prgram and checking that the licenses are available. Start Prgrams AspenTech Cmmn Utilities WLMAdmin The WLMAdmin view is split int tw panes: The Navigatin pane is lcated n the left side f the view. It cntains a tree structure that lets yu access the different levels f licensing infrmatin. There are tw server lists available: Defined Servers. This is a user defined list f license servers. License infrmatin is updated quickly because WLMAdmin is directed t a specific list f servers. This list will be empty when WLMAdmin is first run. Yu can add servers t the defined server list using the Edit Defined Server List menu item. Subnet Servers. This list will be filled after perfrming a netwrk bradcast t lcate all active license servers (in ther wrds, cmputers running the Sentinel RMS License Manager service) n the netwrk. 4 Installing and Cnfiguring the License Server 49

It can take sme time t perfrm the netwrk bradcast, s it is recmmended that yu generally use a defined server list. Accessing license infrmatin via the subnet server list is useful if yu d nt knw the name f the license server frm which yu are accessing licenses. Nte: The Subnet Server ptin des nt search acrss netwrk Dmains r yur Lcal Area Segment. S if yur netwrk server is lcated in a different ffice, WLMAdmin requires the Server name t be specified t brwse license features. The Infrmatin pane is lcated n the right side f the view. It displays varying amunts f infrmatin depending what level is highlighted in the Navigatin pane. Nw that yu have the prper license files in place, the next step is t cnfigure yur netwrk user cmputer t pint t yur license server. Fr cnfiguratin infrmatin, see Chapter 5 Cnfiguring SLM. Check the LSHst r LServOpts envirnment variables r files Are the LSHst r LServOpts values set t N_Net? 1 On yur cmputer, click Start Settings Cntrl Panel. 2 Duble-click the System icn t pen the System Prperties view. 3 Click the Advanced tab. On the Advanced tab, click Envirnment Variables. The Envirnment Variables view appears. The variable values fr lshst r lservpts are lcated in the Value clumns. 4 Make any necessary changes/mdificatin by selecting the variable and clicking the apprpriate Edit buttn. 5 Clse the Envirnment Variables and System Prperties views by clicking the OK buttns. 6 Rebt the cmputer t make sure these envirnment variables take effect. Lg Files The Sftware License Manager can be cnfigured (via administratr ptins) t capture the usage fr all f the Aspen prducts in a lg file. The infrmatin stred includes the User ID, cmputer name, date and time f each license taken and returned. The lg file can be used t display histrical infrmatin f the license usage fr individual r all users. The lg file has a maximum file size that is set by the administratr. The file is saved when it is full, and a new file is autmatically created. The license server lg file is set up using the LServOpts envirnment variable. 50 4 Installing and Cnfiguring the License Server

Checking the Client t Server Cnnectin Once yu have cnfirmed that the prper license strings are in place, the next step is t check that yur netwrk cmputers pints t yur license server. 1 Click Start Prgrams AspenTech Cmmn Utilities SLM Cnfiguratin Wizard. The SLM Cnfiguratin Wizard Intrductin dialg bx appears. 2 Select Yes t the questin Will yu be cnnecting t an SLM server ver the netwrk? and then click Next. 3 On the Server dialg bx, check the Cnfigured Servers list fr the crrect license server name r IP address: T add a server, type the IP address r the name f the server in the Server field, and then click Add. T remve a server, select the server yu want t remve frm the Cnfigured Servers list, and then click Remve. 4 Exit the SLM Cnfiguratin Wizard using ne f these tw methds. If the list cntains the crrect license servers and yu have nt made any changes t the SLM Cnfiguratin Wizard settings, r if yu d nt want t save yur changes, yu can exit the SLM Cnfiguratin Wizard by clicking Cancel. 4 Installing and Cnfiguring the License Server 51

If yu made any changes in the SLM Cnfiguratin Wizard, keep clicking Next until yu reach the Summary page. Then click Finish t save the changes and exit the SLM Cnfiguratin Wizard. 52 4 Installing and Cnfiguring the License Server

5 Cnfiguring SLM Cnfiguring SLM using the SLM Cnfiguratin Wizard The SLM Cnfiguratin Wizard guides yu thrugh a series f steps that cnfigures the SLM t generate license keys. The SLM Cnfiguratin Wizard is used t cnfigure the SLM n all cmputers cnnecting t an SLM server n a netwrk r running SLM lcally. Instructins fr using the SLM Cnfiguratin Wizard are prvided in the SLM Cnfiguratin Wizard Help. Ntes: The SLM Cnfiguratin Wizard makes changes t the registry. Therefre, t use the SLM Cnfiguratin Wizard, yu must have permissin t write t the registry. If yu d nt have permissin t write t the registry, cntact yur system administratr. If yu are using SLM tls versin 8.4 n Windws 7 r Windws 2008, the first time yu use the SLM Cnfiguratin Wizard t initialize netwrk license keys r a lcal license file, the initializatin may take a few minutes, especially if there are a large number f licenses in the license file. Accessing the SLM Cnfiguratin Wizard and Online Help T start the SLM Cnfiguratin Wizard On the Windws desktp, click Start Prgrams AspenTech Cmmn Files SLM Cnfiguratin Wizard. T access the SLM Cnfiguratin Wizard Help Frm the SLM Cnfiguratin Wizard, click Help in the lwer left-hand crner f the windw. 5 Cnfiguring SLM 53

Cnfiguring SLM using Envirnment Variables The envirnment variables can be used t cntrl sme f the peratins f SLM. The primary envirnment variables are: LSHst is used t direct the search fr a netwrk license t a list f preferred servers. LServOpts is used t set License Server Optins including cnfiguratin infrmatin, usage lgging, and errr lgging. Alternatively, sme f these ptins can be set thrugh their wn envirnment variable (in ther wrds, LSReserv and LServrcCnf. Where available, it is generally recmmended t use these specific envirnment variables). Nte: If the user s cmputer cntains bth the registry and the LSHst envirnment variables cnfiguratins, SLM checks the LSHst envirnment variables first. Cnfiguring the Envirnment Variables T cnfigure the envirnment variables in the System Prperties view 1 On yur cmputer, click the Start Settings Cntrl Panel. 2 Duble-click the System icn t pen the System Prperties view. 3 Click the Advanced tab, and then click Envirnment Variables. The Envirnment Variables view appears. 4 In the User r System Variables grup, click New. The New User r System Variable view appears. 5 In the Variable Name field, type the name f the envirnment variable as lshst. 6 In the Variable Value field, type the IP address r hstname f the server(s). 7 Click OK. The New User r System Variable view clses, and the new envirnment variable and value is added in the Envirnment Variables view. 8 If yu d nt need t set any mre variables, click the OK buttns t clse bth Envirnment Variables and System Prperties views. 9 Rebt the cmputer t make sure these envirnment variables take effect. 54 5 Cnfiguring SLM

Cnfiguring the LSHst File r Envirnment Variable Fr an SLM Tken system, all envirnment variables must be cnfigured as system variables. The envirnment variable r LSHst file is used t instruct the applicatin where t search fr the Tken server(s): The LSHst file cntains a list f the IP address r cmputer names fr each f the Tken servers. When the applicatin searches fr the license infrmatin, it prceeds using the fllwing steps: 1 The applicatin starts with the first address n the list f the LSHst file. 2 If the IP address is nt available, the server des nt prvide the license requested. The applicatin s search engine then mves t the next server n the list. 3 The applicatin s search engine repeats the previus step until it finds a server that prvides the license requested. The LSHst file must be placed in the applicatin rt directry fr each SLM-prtected applicatin. If the applicatin is installed n an applicatin server, the LSHst file resides n that server. The LSHst envirnment variable cntains an IP address r cmputer name fr a Tken server. The envirnment variable is set n the user s cmputer. Fr mre infrmatin, see Cnfiguring SLM using Envirnment Variables. Nte: The LSHst envirnment variable verrides any LSHst files n the cmputer. Nrmally, it is recmmended t use LSHst files t avid interference with any ther vendr security that may als be using LSHst. Cautin: If yu have ther vendr securities already using the LSHst envirnment variable, then cnsider using an LSHst file fr each AspenTech prduct r a master LSHst envirnment variable, which lists the license servers fr bth yur Aspen and ther vendr prducts. Stand-alne and Mixed Licensing Schemes fr Tken Fr an SLM Tken system, the use f stand-alne license mde is mre restricted, since Standard license requests must be made when a stand-alne SLM dngle is in use and Tken license requests when the Tken License Server is in use. Yu cannt use bth Tken licenses and stand-alne licenses simultaneusly. Hwever, it is pssible t tggle between the Standard and Tken licensing mdes by changing the LicenseMde envirnment variable in the user s perating system: When using the stand-alne license mde, LicenseMde must be set t False r 0 n the lcal cmputer. When using the Tken netwrk, LicenseMde must be set t True r 1 n the lcal cmputer. 5 Cnfiguring SLM 55

Nte: If all licenses are Unified (in ther wrds, licenses with an SLM_ prefix), yu can tggle between the Standard and Tken licensing mdes withut changing the license type. LSDefaultDir Envirnment Variable Yu can use the LSDefaultDir envirnment variable t set the default lcatin f the license file. AspenTech recmmends that the license server default directry nt be changed. The default directry is in the same directry as the license server executable. LServOpts Envirnment Variable The LServOpts envirnment variable is used t set netwrk license server ptins. Ntes: This variable is set as a system variable and nt a lcal user envirnment variable. Sme f the ptins that can be set with LServOpts can als be set with a specific envirnment variable (which is recmmended t be used whenever pssible). T set up the LServOpts envirnment variable 1 On yur cmputer, click the Start Settings Cntrl Panel. 2 Duble-click the System icn t pen the System Prperties view. 3 Click the Advanced tab, and then click Envirnment Variables. The Envirnment Variables view appears. 4 In the User r System Variables grup, click New. The New User r System Variable view appears. 5 In the Variable Name field, type the name f the envirnment variable as LServOpts. 56 5 Cnfiguring SLM

6 In the Variable Value field, type the required infrmatin fr the fllwing ptins: Optin Descriptin -s license file Specifies the name and lcatin f the license file. By default, the license server uses the file, lservrc, in the lcal directry. This can als be specified with the LServrc envirnment variable. -e license cnfiguratin file Specifies the name and lcatin f the ptinal license cnfiguratin file. This can als be specified with the LServrcCNF envirnment variable. -l usage lg file Enables usage lgging by specifying the name and lcatin f the usage lg file (yu can nt include any spaces in the path name). A typical lg file name is lserv.lg. (This is limited t eight characters.) By default, usage lgging is disabled. -z usage lg file size Specifies the maximum size f the usage file. The default value fr the maximum size f the lg file is 1 megabyte. The size can be specified in bytes, kilbytes, r megabytes. Fr example, -z 2000 means 2000 bytes, - z 2k means 2 kilbytes and -z 2m means 2 megabytes. Once the maximum size f the file is reached, the license server creates a backup lg file (unless the -x ptin has been used). The maximum number f backup files is 99. Hwever yu can mve existing backup lg files t anther directry and the license server begins lgging again. -x By default, n verflw f the usage lg file, the file cntents are mved in t a backup file. New usage recrds are then written t the riginal file until it verflws again. If the -x ptin is specified, the file will nt be backed up n verflw. Instead the license server will simply stp writing further recrds t the file. -cm percentage Cmmuter licensing uses the same license strings as ther netwrk licenses. T ensure that nt all licenses are used up by cmmuters, set this ptin t the percentage f licenses yu want used fr cmmuter licensing. Once that prprtin f license are used up, n mre will be made available t cmmuters until cmmuter licenses are returned. 5 Cnfiguring SLM 57

Optin Descriptin -lfe encryptin level -u grup reservatins file 7 Click OK. Specifies the level f encryptin that license transactins are written t in the licenses server lg file. The levels are 1 t 4: 1 - N encryptin. 2 - N encryptin. Transactin data is readable, but tampering with r deleting an entry can be detected. This is the default encryptin level. 3 - Encrypt usage nly. Transactin data is readable except fr license usage data. 4 - Encrypt entire recrd. All transactin data fr the license s is encrypted. Level 2 is recmmended if yu wish t generate any reprts n the usage data. If yur cntract requires that lg files t be sent t AspenTech, level 2 must be used. Specifies the name and lcatin f the ptinal grup reservatins file. By default, the license server uses the LSReserv file in the current directry. This can als be specified by the LSReserv envirnment variable. The New System Variable view clses, and the new variable appears in the System Variable grup n the Envirnment Variables view. 8 If yu d nt need t set any mre variables, click the OK buttns t save the changes and clse bth Envirnment Variables and System Prperties views. 9 Rebt the cmputer t make sure these envirnment variables take effect. Setting the Usage Lgging The fllwing figure displays the New System Variable view cntaining the infrmatin fr a usage lg file with a maximum size f 2 megabytes and level 2 encryptin. When typing the path and name f the lg file, there can be NO spaces and qutes are nt required. 58 5 Cnfiguring SLM

If yu activate the usage lgging ptin, the netwrk license server recrds all license requests and writes t this file. The generated usage lg file may be sent t AspenTech using the Aut Uplad Tl, and custmer can dwnlad varius usage reprts frm AspenTech custmer supprt web site. Nte: If yu have a large user base, it is advisable t cnfigure the maximum lg file size t a higher value. Fr example, set it t 4m r 6m instead f 2m. Once this set file size is reached, SLM Server backs up the current usage lg file t anther file in the same flder and starts a new lg file. If the ttal number f files reaches 99, server will stp lgging the usage. Yu must mve the lder files t anther lcatin fr the server t cntinue t lg the usage. Aut Uplad Tl has the ability t autmatically mve the files t anther lcatin, and transmit the lg files t AspenTech. LServrcCNF Envirnment Variable The LServrcCNF envirnment variable can be used t set the name and lcatin f the netwrk license server cnfiguratin file. This file is used in setting up user alerts and ther ptins. If LServrcCNF is nt used t specify the cnfiguratin file, then the cnfiguratin file resides in the same directry as the license file and has the same base name as the license cde file but with the extensin *.cnf. It is recmmended that the default name and lcatin be used fr this file. In mst installatins, this file is called lservc.cnf. It resides in the license server default directry. LSHst Envirnment Variable This variable is set n the user s cmputer. When the applicatin is activated, it first tries t identify a stand-alne license. If there is n stand-alne license, it will then attempt t btain a license by searching fr license servers ver the netwrk. This bradcast search is limited t the user s lcal netwrk subnet. If the License Server is lcated utside the user s lcal subnet, then the IP address/hstname f the server must be specified t the remte netwrk license server fr the Aspen (AspenTech) applicatin(s) t establish a cnnectin. Fr envirnment variables, there are three ways yu can specify the cnnectin t the prper license server. The fllwing lists the steps AspenTech applicatins take t lk fr a license server: If the LSFrceHst envirnment variable is set, the applicatin lks fr the specific license server hst listed in that variable. If it cannt find that cmputer, an errr message appears, and the applicatin clses. Nte: AspenTech des nt recmmend using the LSFrceHst envirnment variable, as it has been prven unreliable during testing. 5 Cnfiguring SLM 59

If there is n LSFrceHst envirnment variable, then the applicatin lks fr. If the LSFrceHst envirnment variable has been set, then the applicatin lks fr any f the license server hsts listed. If the LSFrceHst and LSHst envirnment variables are nt set, then a check is made fr a file with the name lshst in the applicatin rt directry. If this file is fund, then the applicatin lks fr any f the license server hsts listed in the file. The LSHst envirnment variable naming cnventins are: Any valid hstname recgnized by yur netwrk. Numeric names (IP address). Nte: If yu are using a netwrk system where the DNS is variable, then yu cannt use the IP address fr this purpse. NO_NET t disable the default netwrk bradcast mechanism frm searching the netwrk fr a netwrk license server. With this setting, the applicatin will nly lk fr a stand-alne license file. LSHst Envirnment Variable The LSHst envirnment variable is used t tell the applicatin t search fr ne r mre license servers. Nte: When using multiple server names n the same line yu need t separate the names, in bth the envirnment variable string and lshst file, with a cln (:). When this variable is set, the applicatin attempts t cntact each server in the list beginning with the first license server in the list. If nne f the specified license servers is fund, the applicatin stps searching and returns an errr. LSHst disables the netwrk bradcast search fr servers. The lshst file wrks the same way as the LSHst envirnment variable. Tip: The lshst file des nt have a file name extensin attached t it. The lshst file must be placed in the applicatin rt directry. The fllwing is an example f an lshst file. This file searches fr TESTSERV_1, TESTSERV_2, TESTSERV_3, and TESTSERV_5, in that rder. Ntice that TESTSERV_4 has been cmmented ut. Anything that fllws a pund symbl (#) is treated as a cmment. 60 5 Cnfiguring SLM

LSFrceHst Envirnment Variable The LSFrceHst envirnment variable is used t frce the applicatin t lk fr a single license server cmputer. LSFrceHst verrides an LSHst envirnment variable r an lshst file, and disables the netwrk bradcast search fr servers. Nte: LSFrceHst is used by all Sentinel License Manager prtected prducts. Therefre, its use culd interfere with the security used by ther applicatins als prtected using Sentinel Cmputer ID dngles. Use LSFrceHst nly as a last resrt. 5 Cnfiguring SLM 61

62 5 Cnfiguring SLM

6 Advanced Licensing Functins Netwrk licenses prvide the administratr with access t many advanced licensing functins. These are primarily: Using Alternate Licensing Cnfiguratins. Cmmuting licenses fr use when n netwrk cnnectin t a license server is available. This is an ptinal feature at additinal cst. Fr specific details n the usage f this feature, see Cmmuting Licenses. Fr mre infrmatin, cntact yur AspenTech sales representative. Stpping r Changing the License Server. Fr specific details, see Stpping r Changing the License Server. Setting user ptins. The tw types f user ptins yu can set are: User Alerts. User Alerts let yu knw abut certain license events. There are seven alert types that can be generated using tw different reprting types. Fr specific infrmatin, see User Alerts. Grup Reservatins. Grup Reservatins reserve licenses fr particular users. Grup Reservatins can als exclude particular users frm license access. Fr specific infrmatin, see Grup Reservatins. Using Alternate License Cnfiguratins Pling SLM Dngles It is pssible t cnfigure the user cmputers s that a pl f stand-alne SLM dngles can be shared. Fr example, if yu want t use 10 different AspenTech prducts, and each prduct has its wn license file and SLM dngle, yu must install all 10 different license files n yur cmputer. When yu run the varius AspenTech prducts, yu can just switch between the 10 SLM dngles, withut the need t recnfigure yur cmputer each time a different license file is required. 6 Advanced Licensing Functins 63

Mixing Stand-alne and Netwrk Mdes Yu can cnfigure cmputers t have bth stand-alne and netwrk mdes. Fr example, if yu need t run tw AspenTech prducts: prduct A is n a stand-alne license and prduct B can be accessed frm the netwrk. T achieve this cnfiguratin, yu must install the SLM dngle and license file fr prduct A n yur cmputer, while the SLM dngle and license file fr prduct B is installed n the netwrk cmputer server. When yu run either prduct A r B, SLM will lcate the required SLM dngle and license file. Cnfiguring the SLM using Registry Variables Yu can cnfigure the SLM peratin ptins and registry variables directly instead f using the SLM Cnfig Wizard. The table belw describes the SLM registry variables. The settings are under HKEY_LOCAL_MACHINE\SOFTWARE\AspenTech\SLM\Cnfiguratin. Parameter Range Default Descriptin N-Net 0, 1 0 Disables the default netwrk bradcast mechanism frm searching the netwrk fr a netwrk license server. With this parameter set t 1, the applicatin will nly lk fr a stand-alne license file. SuppressBradcasts 0, 1 0 When set t 1, the SLM will attempt t check each server in the cnfigured server list until it finds a license. If it is unsuccessful, the applicatin will exit with errr. The benefits f this are that it limits the netwrk bradcast fr license servers and keeps the amunt f netwrk traffic t bare minimum. This feature nly applies t the Unified license. SLMMAXCOMMUTERL ICNUM 1 t the maximum available n server Maximum available n server This setting lets yu specify the maximum number f cpies f a license yu can cmmute, s as t supprt running multiple instances f an applicatin using cmmuted licenses. Cmmuting Licenses Use Aspen SLM Cmmute (SLMCmmute.exe) t brrw licenses frm a netwrk server. These brrwed, r cmmuted, licenses allw a client cmputer t run the licensed prduct while discnnected frm the netwrk withut the use f a SLM dngle. 64 6 Advanced Licensing Functins

Nte: Yu must run Aspen SLM Cmmute when the user is cnnected t the License Server netwrk t btain and verify the licenses required. The cmmuted time is specified in days, with a maximum f 30 days. The licenses can be returned prir t their expiratin date. In rder t successfully cmmute a license, the cmmutable feature must be activated in the license file. Checking Out Cmmuter Licenses 1 Make sure yu have an AspenTech prduct pen befre yu cmmute. Otherwise, the cmmuting facility can take a lng time t start up. 2 Run the cmmute prgram by selecting Start Prgrams AspenTech Cmmn Utilities SLMCmmute cmmand frm the desktp menu. The Aspen SLM Cmmute dialg bx appears. 6 Advanced Licensing Functins 65

Aspen SLM Cmmute displays the servers yu have cnfigured using the SLM Cnfiguratin Wizard and enables the user t check ut licenses frm thse servers. Cmmuter Optin Add Server Scan Sub-Net Cmmute Return Return All Descriptin Server searches fr and displays a specified license server. Requires yu t specify the license server's cmputer hstname, IP address, r IPX address in the field prvided. Searches fr and displays all f the license servers n yur subnet. Checks ut the licenses selected. Returns the specified licenses. Returns all licenses. 3 When the prgram lads, if the server frm which yu want t cmmute licenses is nt shwn: Type in the Add Server field either: The Server name. The IP Address. Click OK. This causes SLM Cmmute t display the licenses n the server yu specified. Imprtant: Make a nte f the server yu are using, because yu must return the cmmuted licenses t the same server. Nte: T find a server frm which t cmmute licenses, click Sub-Net. 66 6 Advanced Licensing Functins

Once the server has been lcated, all the available cmmuter licenses are listed. The license list may take sme time t appear. Nte: If yu want t see mre licenses, resize the windw by pulling n its bttm edge. 4 Yu can view licenses by prduct r by server. Click Licenses by Prducts. Yu can select ne r mre licenses under the prduct. Click n License By Server. Yu chse ne r mre licenses and the number f licenses yu want t check ut. 6 Advanced Licensing Functins 67

Nte: It is recmmended that yu select nly the licenses yu will need. Fr example, if yu are cmmuting licenses fr HYSYS and are unsure f which licenses yu will need t run yur case, yu can use a capability in HYSYS t display the licenses that are in use in the case that is laded. In HYSYS, select Simulatin Main Prperties frm the menu bar, and then click the Licenses tab. 5 In the Days t check ut license(s) frm server field, type the number f days yu require the license(s).the number f days can be any integer frm 1 thrugh 30. 6 Click Cmmute. If the cmmute is successful, SLMCmmute displays the list f cmmuted licenses. 68 6 Advanced Licensing Functins

The license r licenses are temprarily released frm the server t yur hard drive. 7. Clse Aspen SLM Cmmute by clicking Clse r Exit n the SLM Cmmute tl. Yu can nw run yur licensed prduct away frm the netwrk. Yur license autmatically expires at midnight n the last day f yur license perid. If yu return t the netwrk, yu can return the license t the netwrk befre the expiry date using Aspen SLM Cmmute, as described belw. Returning Cmmuter Licenses AspenTech recmmends that yu return Cmmuter licenses as sn as yu recnnect t the netwrk after yur perid away. Yu can have nly ne instance f cmmuting per cmputer, s if yu need additinal licenses, yu must return all the licenses yu currently have cmmuted, and then re-check ut all the licenses yu require. 1 Run the cmmute prgram by selecting Start Prgrams AspenTech Cmmn Files SLMCmmute cmmand frm the desktp menu. 6 Advanced Licensing Functins 69

2. T return the cmmuted licenses, click the licenses yu will be returning. 2 Click Return. All the licenses yu selected are returned. Yu can click Return All t return all licenses t server. Recmmended Practices T maximize the efficiency f yur netwrk licenses when cmmuting: D nt take any mre licenses than yu need. Take the licenses nly fr the perid that yu require. Always check licenses back in when yu recnnect t the netwrk. Make a nte f the server names r IP addresses. Tip: If yu find Aspen SLM Cmmute is slw, pen a licensed prduct befre running Aspen SLM Cmmute. License and Prduct Names In rder t cmmute the crrect licenses when the AspenTech prduct is used ffline, the user needs t be familiar with the list f licenses that their AspenTech prduct uses. 70 6 Advanced Licensing Functins

Cmmuting the Licenses frm a Remte Lcatin As lng as yu can cmmunicate with the License Server, yu can cmmute licenses frm that server. Any prgram that allws remte access t yur netwrk can be used. Nte: Cmmuting frm a remte lcatin requires a very stable cnnectin. If the cnnectin is lst at any time during a cmmuter transactin when taking r returning licenses, the cmmuted license may becme crrupted n either yur wrkstatin r the license server. Stpping r Changing the License Server If there is n substantial change t the license server, stpping and restarting the Sentinel RMS License Manager service, including pwering dwn and restarting the cmputer, has n effect n actively cmmuted licenses. Examples f changes requiring a rebt include an unrecverable hardware failure, a refrmat f hard drive, r the installatin f a new perating system. Any additin r upgrade t a license file (fr example, changing the expiry date) has n effect n cmmuted licenses. Hwever, if there are actively cmmuted licenses and a fundamental characteristic (fr example, the number f tkens it requires) f a license is changed n the server, it is pssible that the cmmuted license will nt return itself prperly. In this case it must be left t expire. Nte: AspenTech recmmends that yu return all cmmuted licenses befre upgrading the license server prgram. Setting User Optins SLM als cntains ther ptins that are set by using specific cnfiguratin files: User Alerts and Grup Reservatins. User Alerts User Alerts let yu knw abut certain license events. There are seven alert types that can be generated using tw different reprting types. Cnfiguring User Alerts T enable alerts, yu need a cnfiguratin file with infrmatin n the license strings in the license file. The cnfiguratin file, lservrc.cnf, is a general purpse cnfiguratin file assciated with a particular license file. 6 Advanced Licensing Functins 71

The LServrcCNF envirnment variable can be used t set the name and lcatin f the netwrk license server cnfiguratin file. This file is used in setting up user alerts and ther ptins. If LServrcCNF is nt used t specify the cnfiguratin file, then the cnfiguratin file resides in the same directry as the license file and has the same base name as the license file but with the extensin *.cnf. It is recmmended that the default name and lcatin are used fr this file. Cnfiguring the LServrcCNF Envirnment Variable T cnfigure the LServrcCNF envirnment variable 1 On yur cmputer, click Start Settings Cntrl Panel. 2 Duble-click the System icn view. 3 Click the Advanced tab. On the Advanced tab, click Envirnment Variables. t pen the System Prperties The Envirnment Variables view appears. Nte: Windws Administratr privileges are needed t change these settings. 4 On the Envirnment Variables view in the System Variables grup, click New. The New System Variable view appears. 5 In the Variable Name field, type the name f the envirnment variable as LServrcCNF. 6 In the Variable Value field, type the file directry/lcatin fr the *.cnf file. 7 Click OK. The New System Variable view clses and the new variable and value is added in the Envirnment Variables view. 72 8 If yu d nt need t set any mre variables, click OK t clse the Envirnment Variables view and exit the System Prperties view. 9 Rebt the cmputer t ensure the new envirnment variable takes effect. 6 Advanced Licensing Functins

Defining the Alert Types Each alert actin has the fllwing frmat: <alert-type> = <reprting-type1> ON/OFF <reprting-type2> ON/OFF where alert-type can be: hardlimit. Hardlimit exceeded. appstart. License issued. appstp. License returned. denied. License denied. apptimeut. License time-ut. expired. License expiratin date. and reprting-type can be: email. E-mail will be sent t recipients given after EMAIL=. Nte: Line cntinuatin is nt supprted, s all e-mail addresses must fit n ne line. The maximum line length is 512 characters. script. The script given after SCRIPT= will be invked. Nte: In rder t use e-mail alert, yu must cnfigure the license server using lsmail.exe. Yu must cnfigure the Sentinel RMS License Manager 8.5 t autmatically install lsmail.exe. The default lcatin fr lsmail.exe is: <ROOT>:\Prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT Run the lsmail.exe applicatin. At the prmpt, type the hst name r IP address f an MS Exchange server. This is an sample cnfiguratin file f 'lservrc.cnf', nrmally placed in the directry where the license server is installed: [AEA_HYSYS_Prcess *] sftlimit = SCRIPT OFF EMAIL OFF hardlimit = SCRIPT OFF EMAIL OFF appstart = SCRIPT OFF EMAIL OFF appstp = SCRIPT OFF EMAIL OFF denied = SCRIPT OFF EMAIL ON apptimeut = SCRIPT OFF EMAIL OFF expired = SCRIPT OFF EMAIL OFF EMAIL= Administratr@hyprtech.cm [AEA_HYSYS_Dynamic *] sftlimit = SCRIPT OFF EMAIL OFF hardlimit = SCRIPT OFF EMAIL OFF appstart = SCRIPT OFF EMAIL OFF appstp = SCRIPT OFF EMAIL OFF denied = SCRIPT OFF EMAIL ON apptimeut = SCRIPT OFF EMAIL ON expired = SCRIPT OFF EMAIL OFF EMAIL= Administratr@hyprtech.cm [* *] sftlimit = SCRIPT OFF EMAIL ON hardlimit = SCRIPT OFF EMAIL OFF appstart = SCRIPT OFF EMAIL OFF 6 Advanced Licensing Functins 73

appstp = SCRIPT OFF EMAIL OFF denied = SCRIPT OFF EMAIL OFF apptimeut = SCRIPT OFF EMAIL OFF expired = SCRIPT OFF EMAIL OFF EMAIL=Administratr@hyprtech.cm This cnfiguratin file requests the license server t send an e-mail thrugh lsmail.exe if: A license is denied fr HYSYS r HYSYS Dynamics. A license times ut fr HYSYS Dynamics. The sftlimit is exceeded fr all the features available in the license file ([* *]). Grup Reservatins Grup reservatins let yu assciate user grups with each feature. A certain number f licenses fr that feature are then reserved in a pl fr these user grups. Any licenses nt specifically reserved remain in the general pl. A grup specificatin cnsists f the fllwing: Name f the feature fr which the reservatin applies. Name f the grup. Number f licenses reserved fr that grup. Lgin names f users/hst IDs f cmputers belnging t that grup. The fllwing restrictins apply: The grups must be mutually exclusive. Different grups using the same feature cannt have cmmn users r cmputers. The number f licenses reserved fr a feature cannt exceed the number f cncurrent cpies specified in the license string fr that feature. When the license server receives a request, it checks whether the user making the request belngs t a grup. If this is the case then the license server issues the license(s) and remves it frm that grup s pl the user making the request belngs t a grup -and- licenses are available fr that grup the user making the request des nt belng t a grup the license server issues the license(s) frm the general pl until n licenses are available the license server issues the license(s) frm the general pl until n licenses are available the user making the request belngs t a grup -but- 74 licenses are NOT available fr that grup 6 Advanced Licensing Functins

Cnfiguring a Grup Reservatin File Grup reservatin infrmatin is nrmally held in a text file called lsreserv (n extensin). By default, this file is placed in the Sentinel server directry: <ROOT>:\Prgram Files {(x86)}\cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT This is the same lcatin as the server prgram (usually lservnt.exe) and the license file (lservrc). Tip: If yu want, the LSReserv envirnment variable can be used t set a different file name r path t the reservatin file. Fr mre infrmatin abut envirnment variables, see Cnfiguring SLM using Envirnment Variables. Grup reservatins are entered accrding t the fllwing frmat, with ne grup per line: feature_name[,ver ]:grup_name:num_f_licenses:{user_name cmputer} One r mre user names and/r cmputer names can be specified, but at least ne value must be specified in the last field. User and cmputer names must be separated by a space. The versin number is ptinal. Ntes: Sentinel RMS License Manager is nt case sensitive. Therefre, the reservatin specificatins (fr example, User Name and Cmputer Name) are nt case sensitive. Hwever, the License Feature Name is case sensitive (it must match the case as shwn in the license). ver refers t the bucket number in the license file. Sample Grup Reservatin File: ## This is a sample Grup Reservatin file ## File name: lsreserv ## In this sample there are 3 Dynamics licenses being reserved fr ## the user grup Dynamics_Experts which cntains 4 individuals; ## if there are mre than 3 Dynamics licenses available ## n the server the remainder will be available fr general use. ## Additinally anyne lgging in t the cmputer named Cntrl ## may access Dynamics. Michael is nt allwed t access Dynamics ## at all (even via Cntrl ). SLM_HYSYS_Dynamics:Dynamics_Experts:3:Bb Jhn Mary Dug $Cntrl!Michael $10.32.53.21 $12.34.5.* Nte: The characters $ and! have special meaning. $ indicates the name is a cmputer name, and! indicates a lgical NOT. Excluding Users r Cmputers frm Using a Feature Specifying a user/cmputer in a grup using the lgical NOT (!) excludes that user/cmputer frm any use f that feature. This means that the user/cmputer is prevented frm using that feature, even if there are licenses available in the general pl. 6 Advanced Licensing Functins 75

Guidelines fr writing a reservatin file: Once the reservatin file has been created, stp and start the SLM service using ladls.exe. There is n need t re-start the cmputer. Make sure yu press Enter after the last line in the reservatin file; therwise, the last line in the reservatin file is nt taken int accunt. There is n cmment in the SLM lg file shwing that the server is using a reservatin file. WlmAdmin will shw the current number f users fr each license, the maximum number f users, and the number f reserved licenses. Cmment lines start with ##. There is n entry in the SLM lg file shwing that a reservatin is used. Use the nne keywrd in rder t prevent anyne frm using certain licenses, fr example, SLM_AspenPrperties: 76 Grp2:2: user1 $machine1 Use!<username> t prevent a user frm using a specific license, even if a license is available and nt reserved. The line will prevent user2 frm using Aspen Prperties: SLM_AspenPrperties: nne Use $<cmputer name> t allw any user lgged n a specific cmputer t use the license. The line belw will reserve 2 Aspen Prperties licenses t user1 and any user lgged n t the cmputer machine1: SLM_AspenPrperties: Grp2:2: Grp2:2: user1 $machine1!user2 When a license key is refused t the user, the fllwing errr message appears n the client cmputer. This is a standard message that als appears when there are n mre licenses available n the cmputer. 6 Advanced Licensing Functins

License versin The license versin shuld nly be used if several buckets are used in the license key file. A bucket is a set f licenses, using ne r several licensing techniques (standard, tken r bundle). The license versin can be fund by lking at WlmAdmin. Fr mre infrmatin abut licenses and versins, see the sectin, Determining the number f licenses available in a file and their versins at the end f this chapter. License versin number is same as the bucket number. If several buckets are available, the fllwing syntax can be used: SLM_AspenCustmMdeler: Grp1:5: SLM_AspenCustmMdeler,1: Grp2:4: SLM_AspenCustmMdeler,2: Grp3:3: user1 user2 user3 user 4 user5 user6 user7 The first line is fr the default bucket, the secnd fr the Aspen Custm Mdeler license in bucket 1, the third line fr the Aspen Custm Mdeler License in bucket 2. Reservatin file fr standard licenses In a standard license file, a maximum number f simultaneus users is set fr each prduct. A reservatin allws reserving a certain number f licenses f each prduct t different grups f users. Fr example, SLM_AspenPlus: Grp1:10: user1 user2 user3 SLM_AspenCustmMdeler: Grp2:5: user1 user2 user4 SLM_AspenPrperties: Grp3:2: user1 $machine1!user2 The first line will reserve 10 Aspen Plus licenses t user1, user2, and user3. The secnd line will reserve 5 Aspen Custm Mdeler licenses t user1, user2, and user4. The last line will reserve 2 Aspen Prperties licenses fr user1 and any user lgging nt the cmputer machine1. The last line als prevents user2 frm using Aspen Prperties. Reservatin file fr tken licenses With a tken license key, the reservatin can be made n the ttal number f tkens but als n each individual prduct. In a versin 4 license file, the ttal number f tkens is set in feature SLM_Pl. In additin, a maximum number f users is set fr each prduct (fr example, SLM_AspenCustmMdeler). Bth the SLM_Pl feature and the individual prduct feature can be used in the reservatin file. Fr example: SLM_Tken:Grp1:100: user1 user2 user3 Will reserve 100 tkens t the three users listed, regardless f the prduct they use. Simultaneusly, a reservatin can be made n each prduct: SLM_AspenPlus:Grp2:10: user1 user2 user3 6 Advanced Licensing Functins 77

This will reserve 10 Aspen Plus licenses t the grup f three users. Typically, the maximum number f users is set t 32766 users fr each prduct, except special license agreements. The fllwing cde sample is an example f a reservatin file fr a versin 4 tken license. In this case, we assume nly ne bucket is available in the license file. Hence, there is n versin number. user1, user2 and user3 have 60 tkens and all f the AspenCustmMdeler licenses reserved and 150 tkens are reserved fr user4 and user5. SLM_AspenCustmMdeler:Grp1:32766: user1 user2 user3 SLM_Pl:Grp2:60: user1 user2 user3 SLM_Pl:Grp3:150: user4 user5 Reservatin File Characteristics A maximum f 256 grups, each with 1000 members user names, hst IDs, IP addresses (IPv4 and IP v6) are supprted. Grups must be mutually exclusive. Different grups fr the same feature shuld nt have cmmn users r cmputers. Grup names and member names cannt exceed 64 characters each. The number f license tkens reserved fr a feature cannt exceed the number f cncurrent cpies specified in the license cde fr that feature. If yu want t exclude all members f a grup frm using license tkens fr a feature, yu can specify 0 tkens. If the number f license tkens reserved is greater than the number f cncurrent cpies specified fr the feature in the license cde, the number f tkens specified in the license cde will be used. Determining the number f licenses available in a file and their versins Once the license file has been installed and the SLM server started, pen WlmAdmin. Select a specific license by clicking n it. In the right hand side panel, it will shw the ttal number f licenses available, the name and the versin. See the screen captures belw. 78 6 Advanced Licensing Functins

Case 1: standard license Aspen Custm Mdeler License Max. number f users N license reserved Case 2: tken license Aspen Custm Mdeler License N versin Max. number f users Number f users reserved 6 Advanced Licensing Functins 79

Max number f tkens Number f tkens reserved Number f tkens 80 6 Advanced Licensing Functins

7 Trubleshting SLM Prblems Intrductin This chapter is designed t give yu answers t sme f the cmmn prblems encuntered when setting up yur licensing sftware. The cmmn prblems are gruped int the fllwing sectins: Dngle Prblems Netwrk Prblems Envirnment Variables Cmmn Errr Messages Wrk thrugh the fllwing checklists if yu encunter any prblems. Nte: Additinal trubleshting infrmatin is available at http://supprt.aspentech.cm. If yu have gne thrugh the checklist and yu still have prblems, cntact yur lcal Technical Supprt center. Befre cntacting Technical Supprt, make sure that yu have checked that yur: System clck is crrect. Yur licenses have a start date and end date. Yur clck must be crrect fr the licenses t functin. SLM is prperly installed. Licenses are prperly installed. When cntacting Technical Supprt, yu will be asked t supply five pieces f infrmatin: 1 Prduct name(s) with which yu are having prblems (fr example, HYSYS). 2 System Cnfiguratin: 3 Licensing mde. Stand-alne, Standard netwrk, Tken netwrk, r bundle netwrk. Fr Netwrk licensing, whether the applicatin is installed lcally r n an applicatin server. An exact descriptin f the errr encuntered, in ther wrds: 7 Trubleshting SLM Prblems 81

What happened? When did the errr happen (during installatin, startup, when pening a case, and s frth). Mst imprtantly, the specific text r screen shts (preferred) f the errr message(s). Nte: The errr message is the mst imprtant piece f infrmatin required t trublesht yur prblem. 4 A cpy f yur license file. 5 A cpy f yur cnfiguratin infrmatin. T get this, start the Cnfiguratin Wizard and click Cnfig. The SLM & System Cnfiguratin page appears, shwing yur cnfiguratin infrmatin. Click Cpy t Clipbard, and then paste that infrmatin frm the clipbard t a Ntepad r ther blank dcument. Dngle Prblems Check Dngle Attachment T check dngle attachment 1 Check that the dngle is prperly attached t the cmputer. Sftware License Manager (SLM) dngles are Sentinel SuperPr Cmputer ID keys, manufactured by Rainbw Technlgies. The SLM dngle is installed n the parallel prt (printer prt) r USB prt f yur cmputer with an arrw indicating which end is plugged in. Nte: D nt plug the parallel prt dngle in the serial prt, because it may damage yur cmputer. T test if the prt is wrking prperly 1 Try cnnecting a printer r ther device t the prt. If yu d nt have a device t attach t the prt, yu can als try installing the Hyprtech green dngle n anther cmputer. 2 Run the SLM Cnfiguratin Wizard. On the Intrductin dialg bx, click Cnfig t display yur SLM and System cnfiguratin infrmatin. If yur dngle is prperly attached t the server and the lck cde still des nt appear, the next step is t make sure that yu have installed the Sentinel system drivers used by the server t cmmunicate with the SLM dngle. T install the Sentinel System Driver T install the Sentinel System Driver, fllw the prcedure described in the sectin, Sentinel System Driver in the SLM Overview chapter. 82 7 Trubleshting SLM Prblems

T check that the Sentinel System Driver is Installed Using Windws Explrer, brwse t the Sentinel System Driver flder and verify that the SetupSysDriver.exe file exists. The SetupSysDriver.exe is lcated at: <rt>\prgram Files {(x86)}\cmmn Files\SafeNet Sentinel\Sentinel System Driver\ Check that there is n prblem with yur netwrk Make sure that yur wrkstatin and server cmputers can cmmunicate prperly. Fr example, use the ping cmmand t test cmmunicatin between client and server. If yu can see the licenses n the server using WLMAdmin, but yu cannt cnnect t the server with the applicatin, then review the fllwing checklist: Check if license server is utside f yur sub netwrk If the server is utside yur subnetwrk, yu need t set the LSHst envirnment variable r file n the client s cmputer t pint t that server. Fr the client s cmputer, set LSHst using the SLM Cnfiguratin Wizard. Fr cnfiguratin infrmatin, see Chapter 5 Cnfiguring SLM. Fr the SLM server, set LSHst using the perating system s envirnment variable. T set LSHst using the perating system s envirnment variable 1 On yur cmputer, click Start Settings Cntrl Panel. 2 Duble-click the System icn view. 3 Click the Advanced tab. On the Advanced tab, click Envirnment Variables. t pen the System Prperties The Envirnment Variables view appears. 4 In the System Variables grup, click New. The New System Variable view appears. 5 In the Variable Name field, type the name f the envirnment variable as LSHst. 6 In the Variable Value field, type the IP address r hstname f the server(s). The LSHst variable naming cnventins are: Any valid hstname recgnized by yur netwrk. Numeric names (IP address). 7 Trubleshting SLM Prblems 83

Nte: If yu are using a netwrk system where the DNS is variable, then yu cannt use the IP address fr this purpse. 7 Click OK. The New System Variable view clses, and the new variable and value is added in the System Variables grup f the Envirnment Variables view. 8 Rebt the cmputer t make sure these envirnment variables take effect. Check the hst name r IP address Is the hst name r IP address yu specified fr the LSHst r LServOpts envirnment variable crrect? 1 On yur cmputer, click Start Settings Cntrl Panel. 2 Duble-click the System icn view. 3 Click the Advanced tab. On the Advanced tab, click Envirnment Variables. t pen the System Prperties The Envirnment Variables view appears. 4 The variable values fr lshst r lservpts are lcated in the Value clumn. 5 Make any necessary changes/mdificatin by selecting the variable and clicking the Edit buttn. 6 Clse the Envirnment Variables and System Prperties views by clicking the OK buttns. Tip: Rebt the cmputer t make sure these envirnment variables take effect. If the license server can be lcated using WLMAdmin and the license file is in the crrect place but yu d nt see any licenses, r yu see the wrng licenses, then review the fllwing checklist: Check if the license server has been reladed after installing the licenses n the server Use WLMAdmin t verify that the license server has been reladed. Fllw the instructins in the Checking that the License Server has been prperly initialized sectin in Chapter 4 f this manual. Check yur netwrk cnnectin system Yu may be experiencing netwrk prblems. 84 7 Trubleshting SLM Prblems

If yu still cannt see the licenses yu require, yu may nt have purchased thse licenses. If this is the case, g t the AspenTech Web site r cntact yur sales representative abut purchasing the needed prducts. Cmmn Errr Messages 6. This feature is nde lcked but the request fr a key came frm a cmputer ther than the hst running the Sentinel RMS server usually ccurs with Unable t check ut license. Meaning The license fr this prduct r feature was fund but the lcking infrmatin culdn't be authenticated; r t put it simply, the license file was lcated but the lck cde in the file culdn't match any f the lck ndes (security dngle r ther hardware cntaining lck cde) available. Pssible Causes The SLM dngle r the prt is nt functining. Either the SLM dngle r the lck cde in the license file is wrng (in ther wrds, the tw are nt matched). The license file was generated fr a stand-alne installatin and is being used n a key server cmputer. 18. N such feature recgnized by server. Meaning License fr this prduct r feature culd nt be fund. Pssible Causes Either the license file culd nt be lcated r the license file des nt cntain authrizatin fr the required prduct r feature. If this is a netwrk installatin, this culd be cnfirmed by running WLMAdmin and checking which licenses are available frm the key server. 7 Trubleshting SLM Prblems 85

86 7 Trubleshting SLM Prblems

8 Frequently Asked Questins General SLM Hw d I fix my SLM installatin? Occasinally AspenTech prducts fail t start because they can't get a license. This can be because SLM is nt cnfigured prperly. Licenses n the license server have changed. The Netwrk r license server is very busy. The license server has crashed. Here are sme simple steps t fllw: 1 Make sure that yu are running the latest versin f the SLM. Aspen SLM *.dll file is lcated in: <Rt>:\Prgram Files\Cmmn Files\AspenTech shared\strgxi2.dll Nte: The abve path may be different fr different language versins f the perating system. 2 Make sure the crrect SLM is installed. Open a DOS prmpt and type: regsvr32 <ROOT>:\Prgram Files\Cmmn Files\ AspenTech Shared\strgxi2.dll 3 Clean up yur SLM cnfiguratin: Remve yur lshst envirnment variable. Remve yur AEATkenmde envirnment variable. Remve yur LicenseMde variable. If yu are using an lshst file, remve it. Remve all registry entries under: HKEY_LOCAL_MACHINE/Sftware/AspenTech/SLM/ 4 Install the latest SLM cnfiguratin using the SLM Cnfiguratin Wizard. 8 Frequently Asked Questins 87

Fr mre infrmatin, see Chapter 5, Cnfiguring SLM. Why are the SLM dngle (Sentinel Hardlck) and its lck cde missing when I run the Cnfiguratin Wizard? There are tw pssible slutins t this prblem: Check if the Sentinel System Driver exists. 1 On the perating system desktp, pen the Add/Remve Prgrams view by selecting Start Settings Cntrl Panel Add r Remve Prgrams. 2 If the Sentinel System Driver exists, remve it. 3 Reinstall the Sentinel System Driver, fllwing the prcedure described in the sectin, Sentinel System Driver in the SLM Overview chapter. 4 Return t the Add r Remve Prgrams view t check that driver is installed. If yu nw run the Cnfiguratin Wizard, the SLM dngle is reprted as Sentinel Hardlck. Prblem with either the prt r the dngle. Try installing the dngle and drivers n anther cmputer. If the Cnfiguratin Wizard als fails t reprt the dngle n this cmputer, yu likely need a dngle replacement. In this case, cntact yur lcal AspenTech ffice t arrange fr a dngle replacement. I am trying t install an SLM applicatin using netwrk security. Why am I getting errrs? Make sure that the Sentinel System Driver is installed crrectly. Symptms: Running the Cnfiguratin Wizard des nt shw an entry fr the SLM dngle. Nrmally there is a Sentinel Hardlck entry. Sentinel System Driver is absent in the Add/Remve Prgrams view (select Start Settings Cntrl Panel Add r Remve Prgrams). Remedy: Install the driver manually frm the AspenTech prduct installatin DVD: 1 Install the Sentinel System Driver fllwing the prcedure described in the sectin, Sentinel System Driver in the SLM Overview chapter. 2 Check that driver is installed. Sentinel System Driver appears in the Add r Remve Prgrams view. Open the Add/Remve Prgrams view by clicking Start Settings Cntrl Panel Add r Remve Prgrams n the main desktp. 88 8 Frequently Asked Questins

3 If yu nw run the Cnfiguratin Wizard, the SLM parallel dngle is reprted as Sentinel Cmputer ID. Cntinue with regular trubleshting if this is nt the prblem. Extra digits are added t license file name and it will nt wrk. Why? When yu start an applicatin data file frm an email, very ften a temprary cpy f the file is made in a temp directry used by Windws r the email sftware. If there is already a cpy f the file in this temp directry, it des nt verwrite the ld ne. Instead, it creates a new temp file with a number appended t it. Fr example, duble-clicking file name lservrca.aealic causes a cpy f lservrca.aealic t be created in the temp directry and then activates it. If yu receive anther email with the same license file name in it, when yu duble-click it, the license file will save t the temp directry as lservrca1.aealic, and the next time lservrca2.aealic, and s frth. Use the Save As ptin t save the file t yur hard drive befre starting the license file installer. Where is the Sentinel System Driver installed? The driver is installed in: C:\WINNT\System32\snti386.dll If yu pen the Add/Remve Prgrams view (select Start Settings Cntrl Panel Add/Remve Prgrams), yu will see an entry fr Sentinel System Driver. The cmputer was a server, but nw I want t delete its licenses and stp it frm being a server. Hw d I d this? T remve the server feature n a cmputer 1 Remve the dngle cnnected t the cmputer. 2 Run the prgram ladls.exe, and click Remve. 3 Run Add/Remve Prgrams. Click Start Settings Cntrl Panel Add/Remve Prgrams. 4 Click Sentinel RMS Server, and then click Remve. 5 Run WLMAdmin. In WLMAdmin, try t view the server t verify yu are n lnger functining as a server. 8 Frequently Asked Questins 89

I have many stand-alne dngles. Hw d I manage the license files? The easiest way t manage many stand-alne dngles is t install all f the stand-alne license files n each user s cmputer. Each license file wrks with nly ne dngle; hwever, the SLM can detect which dngle is n the back f the user's cmputer and select the crrect license file frm the Shared flder fr use. The default lcatin f the Shared flder is: <ROOT>:\Prgram Files\Cmmn Files\AspenTech Shared By installing all f the license files n each cmputer yu dn t need t keep track f which user needs which license file. Yu als create the ability t swap dngles frm cmputer t cmputer by ding this. 1 Rename the extensin f all f yur stand-alne license files frm *.AEALIC r *.SLF t *.LIC. 2 Then, n each user's cmputer: Install the prduct (fr example, HYSYS). Cpy all f the *.LIC files t the Shared directry <ROOT>:\Prgram Files\Cmmn Files\AspenTech Shared If yu upgrade an existing stand-alne license file r add a new ne (in ther wrds, add a new key) yu can simply email all users the new license file (leave the extensin as.aealic r.slf, as it was delivered). Dubleclicking the license file will add it t their *.LIC license file list in the Shared flder. Nte: Yu will als need write access t the applicatin directry n yur cmputer because when yu run the applicatin the SLM will cpy the apprpriate *.LIC file, depending n the key, t the applicatin directry and then rename it t lservrc. If yu manually install the standalne license file, yu must run the SLM Cnfiguratin Wizard t initialize all the licenses n yur lcal machine. Can I switch a stand-alne SLM dngle between multiple cmputers? Yes. AspenTech cntinues t supprt the ability t mve yur stand-alne dngle frm ne cmputer t anther and run yur licensed sftware frm any cmputer, s lng as the SLM dngle attached. This is stand-alne dngle interchangeability. T d this under SLM, simply install the license file lcked t the SLM dngle n every cmputer that will be using the SLM dngle. If yu will be using a pl f stand-alne dngles, then t ensure interchangeability, the license file fr each and every stand-alne dngle yu have will need t be stred n the cmputer. 90 8 Frequently Asked Questins

When an applicatin starts, SLM will identify the stand-alne dngle being used and will attempt t find the license file fr that SLM dngle. If it des, the applicatin will run. If nt, an errr will be generated. Nte: It is recmmended that the cmputer be shut dwn befre adding r remving a dngle. The cmputer can be safely restarted after the dngle is added r remved. What is the Cmmuter Optin? The cmmuter ptin enables laptp users t check-ut the licenses required t run an AspenTech prduct t a specific cmputer frm a netwrk license server. The licenses expire a set perid f time fllwing check-ut. The maximum check-ut perid is 30 calendar days (ne mnth). The licenses can be checked-in t the netwrk license server when the cmputer is recnnected t the netwrk. Why d I get the errr message "Required Cmpnent Missing" when trying t run an AspenTech prduct? The Required Cmpnent Missing message indicates that sme file did nt register itself prperly during the installatin. A likely candidate is the strgxi2.dll, which must be installed and registered n each client cmputer. The default lcatin fr the strgxi2.dll file is in: <ROOT>:\Prgram Files\Cmmn Files\AspenTech shared Use a prgram like regsvr32.exe (fund in yur AspenTech prduct prgram flder) t register the strgxi2.dll n the client cmputer. 1 Cpy Regsvr32 int the same flder as the strgxi2.dll. 2 G t a DOS prmpt. 3 Change the active directry t the Shared flder: CD <ROOT>:\Prgram Files\Cmmn Files\AspenTech shared 4 Run the regsvr32 prgram: regsvr32 strgxi2.dll Why is the AspenTech prduct telling me that I d nt have the apprpriate licenses t run my prduct? Lcate yur license file and pen it in Ntepad. Check t see that yu are licensed fr the ptins that the case requires n pen. 8 Frequently Asked Questins 91

Hw can I run an AspenTech prduct lcally n the same cmputer that has the netwrk license and the dngle? Fllw these steps t use the netwrk license in "lcal" mde n the user's cmputer: 1 Install the License Server and license file n the user's cmputer. Ensure that the license file is installed in the crrect Sentinel RMS Server directry: <Rt>\Prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT (NOT in the Hyprtech/Shared r AspenTech/Shared flders). 2 Attach yur SLM dngle t the USB prt f the cmputer. 5 Lad the license server using the ladls.exe tl. As utlined in the instructins, use the License Tls t check the installatin. Use WLMAdmin.exe t check fr prper server set up. Use the Cnfiguratin Wizard t check that the SLM dngle and drivers are prperly installed. Nte: Install the Sentinel System Driver fllwing the prcedure described in the sectin, Sentinel System Driver in the SLM Overview chapter. 6 Install the AspenTech prduct n the user's cmputer as per the install instructins. Ensure that yu chse t use netwrk licensing. During the AspenTech prduct install yu will be asked whether yu wuld like t install lcal license files; chse NO t installing lcal files. 7 Use the SLM Cnfiguratin Wizard t set the registry. Or set lshst = the cmputer name (r fixed IP address) f the user's cmputer. Yu can either set this as an LSHst registry entry (preferred) r in the envirnment variable LSHOST. If yu chse t create an lshst file, it must reside in the directry cntaining the AspenTech prduct executable file (fr example, HYSYS.exe). Fr details n creating an lshst file r envirnment variable, see Cnfiguring SLM using Envirnment Variables. Nte: D nt set lshst = NO_NET because this will frce the AspenTech applicatin t lk fr a stand-alne license; the license server will nt be detected. 8 Open the AspenTech prduct. Can I use SLM-enabled prducts with a Windws/Citrix Terminal Server? In general, AspenTech applicatins can be run frm a terminal server using a SLM Netwrk License Server n anther cmputer. Depending n yur 92 8 Frequently Asked Questins

cntract terms, yu might r might nt be able t use a standalne license n Citrix r Windws Terminal Server. The lgin page fr the Enterprise Update Center fails t appear. Hw d I reslve this issue? Prblems may ccur if yu attempt t access the Enterprise Update Center using Internet Explrer 11 n Windws 8.1 r Windws Server 2012 R2. T reslve the issue: 1 Using Internet Explrer, select Internet Optins. 2 Select the Security tab. 3 Select the Lcal intranet ptin. 4 Clear the Enable Prtected Mde check bx. 5 Click the Apply buttn t apply yur changes. 6 Re-pen the Update Center Lgn page in a new Internet Explrer windw. Prduct Specific HTFS Prducts dn't display the standard SLM errr handles. Hw d I trublesht licensing prblems? Unfrtunately, with HTFS prducts released prir t March 2002, sftware prducts did nt display the descriptive SLM errr messages. This makes it very difficult t trublesht installatin prblems. The fllwing are a few cmmn prcedures used t trublesht licensing prblems: Run the SLM Cnfiguratin Wizard t check fr the SLM dngle and lck cde. Make sure the license file cntent and installatin are crrect. Make sure that yur system clck is up t date and that yur netwrk administratr has nt triggered a time tamper errr by changing dates n yur system clck. Check the license file t ensure that it has nt expired. Mst licensing prblems are related t prblems with either the license file cntents, license file installatin, r prblems cmmunicating with the SLM dngle. Treat these as yu wuld errr cdes 6. r 18. Fr mre infrmatin, see Cmmn Errr Messages. 8 Frequently Asked Questins 93

Guidelines fr SLM Features Hw d I get lgging t wrk prperly n my server? There are tw majr prcedures: 1 Set the lservpts envirnment variable with the -l switch as utlined in this dcument. 2 Perfrm a hard rebt f the server. The lgging may nt set prperly withut this secnd step. 3 Make sure that the directry specified fr the lg file exists. The lgging file must always be checked after the rebt t ensure that it is lgging crrectly. Hw d I set up Grup Reservatins? Fr instructins, see Grup Reservatins. If the Reservatin file is nt wrking prperly, here are sme trubleshting steps: 1 Make sure that SLM can lcate grup reservatin file: Use the default path and file name: C:\Prgram Files\Cmmn Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT Make sure that bth the file path AND name are prperly set in the LSRESERV envirnment variable. 2 Make sure yu hard rebt the cmputer after changing yur envirnment variables t ensure that they take effect. 3 Make sure that the crrect case is being used fr all f the names in use in the file (set up a lg file, the crrect case as read by SLM will shw fr all names in the lg file). SLM Administratr Tls My WLMAdmin preferences aren't saving. Why is that? The WLMAdmin preferences usually write t a file named WLMAdmin.ini. If the preferences are nt saving, the prblem may be that yu d nt have write privileges t yur hard disk drive. Nte: This particular prblem ccurs if yu dn't have Administratr rights. 94 8 Frequently Asked Questins

I have shut dwn the AspenTech prduct and the WLMadmin tl still states I have licenses checked ut. Why? The WLMadmin tl needs t be refreshed. In WLMadmin, in the Navigatin pane (left side f the view), click the server name. Right-click and select Refresh n the Object Inspect menu. It might take a few mments, since the tl has t interrgate the netwrk. The licenses will nt shw yu as a user f the AspenTech prduct if yu have shut it dwn and then WLMadmin is refreshed. Abut Tkens What are SLM tkens? A tken is a licensing mdel where users pay fr aggregated usage rather than prduct by prduct. A tken can be thught f as a basic unit f currency, like ne dllar. Each AspenTech prduct and its ptins have a set a number f tkens they require t run. When a user starts an AspenTech prduct (and ne r mre f its ptins), the number f tkens required is checked ut frm the SLM netwrk license server, which lgs the usage. Additinally, if the client has a fixed maximum number f tkens, a check is made t ensure that the ttal number f tkens currently checked-ut des nt exceed that limit. If the limit is exceeded an errr is generated and the applicatin r ptin des nt start. The tkens are released when the user clses the applicatin r ptin. The tken-based aspenone Licensing Mdel gives custmers the flexibility t access and use any aspenone prduct at precisely the time it is needed. This is especially critical in the dynamic market cnditins f the prcess industries whether during dwn ecnmies r in high-grwth perids. This enables custmers t lwer their risk while maximizing the return n their sftware investment. If yu are interested in licensing a tken system fr yur cmpany, cntact yur accunt manager. Time Tamper Check While using a standalne license file r cmmuted license, the license checkut may fail and return an errr cde 26 time tamper errr. If this message appears after installing a license with aspenone V8.6, then yur license may nt be initialized prperly. In ther cases, the server may have fund evidence f tampering f the system clck, and it cannt service the request since the license fr this feature has been set t be time tamper prf. 8 Frequently Asked Questins 95

Hw t fix the prblem with initializing licenses? aspenone V8.6 requires that all license keys be initialized befre they are used by an applicatin. aspenone installatin autmatically des this initializatin by executing the cmmand line utility SLMLicenseInit.exe frm the flder <Cmmn Files>\AspenTech Shared\. Once the applicatin is laded, run the Cnfiguratin Wizard until finished. Nte that the license initializatin may take several minutes nce SLMLicenseInit.exe has been replaced. Why am I still getting the time tamper errr after applying the initializatin fix? Yur AspenTech prduct is disabled when yur licenses expire r are therwise invalidated. T prevent users frm circumventing the expiry date by changing their system clck, SLM establishes time stamps n yur cmputer system and uses them t detect time tampering. In the eyes f the security system, it has determined that there has been sme srt f time tampering n yur system. This can be fr valid reasns, which can be avided. Hw can I fix the prblem? Depending n what has changed in yur system, smetimes simply reinstalling either the applicatin (stand-alne systems) r the license server (netwrk systems) will remedy this errr. Often, hwever, it is necessary fr AspenTech t send yu a timefix prgram t clean yur cmputer f remnants f the time stamping. Instructins fr running the Time Fix prgram n yur cmputer Yu will receive the Time Fix prgram file (timefix.exe) and a "time fix license. Fr example, fixdec7 is a license t d a time fix n December 7. T clean yur cmputer with this prgram: 1 Uninstall the AspenTech prduct r license server. 2 Cpy bth f the attached files t the C:\ drive f the cmputer, and then frm a DOS prmpt, run them as fllws: time fix Imprtant: Include a space between the tw wrds. 3 Reinstall the AspenTech prduct r license server. Imprtant: This "time fix license file" will nly functin fr ne day, n the date fr which it is set by AspenTech. This date will be in the name. Fr example, fixdec7 will nly functin n December 7. 96 8 Frequently Asked Questins

Nte: This "time fix file" is NOT a license t use prducts. D nt cnfuse this file with yur prduct licenses. If running this Time Fix des nt slve yur prblem, cntact AspenTech and Technical Supprt will cntinue trubleshting. Hw can I avid getting this errr in the future? SLM security incrprates sftware frm SafeNet, inc.; this includes the time checking. SafeNet cnsiders their time checking technlgy t be prprietary and as such we are nt privy t its wrkings; hwever, AspenTech des knw abut the fllwing at this time: D nt perfrm any manual registry editing, unless yu knw exactly what the impact will be. It can create a crss-link errr which can trigger time-tampering. Avid mving, renaming, r deleting *.dll files; sme f the "persistence" infrmatin (fr example, expiry dates) tracked by the security is cntained in such files, and any f these peratins culd create a time tamper in eyes f the security. D nt change the system clck (yu can change the time-zne setting, but nt the date r time independently f time zne changes). Nte: If this prblem becmes a repeated event, cntact AspenTech s we can ffer alternate slutins. I ran timefix.exe. Why did I get the errr message "Errr getting time frm license file."? The timefix.exe prgram cannt read the time fix license needed t clean yur cmputer f remnants f the time stamping. T slve this prblem Make sure that: The system clck (bth time and date) n yur cmputer is crrect befre running the timefix prgram. The "time fix license file" des nt have an extensin t its name (in ther wrds, *.dat), as email prgrams smetimes will add an extensin t the file. Make sure t save the file t disk withut an extensin and run the prgram frm that disk. 8 Frequently Asked Questins 97

I ran the timefix.exe successfully, but when I run the AspenTech prduct, I still get the errr message 26. Why? Delete all license files n yur cmputer (search fr all files named lservrc*.*) and then reinstall them. If yu are still getting errr 26, cntact AspenTech Supprt at http://supprt.aspentech.cm fr further assistance. What is the netwrk packet size requirement fr Sftware License Manager (SLM)? The netwrk packet size requirement fr SLM is 7512 bytes. This is the amunt f data per packet that yur netwrk must supprt in rder fr license transactins t ccur between the SLM Server and the SLM Client. If yur netwrk adds additinal verhead t the packet size (fr example, data encryptin), then any additinal specific netwrk verhead shuld be added. What is the purpse f "n-net" n the list f cnfigured SLM Servers in the SLM Cnfiguratin Wizard? The "n-net" entry is required fr cmmuting t wrk prperly when a license is checked ut frm nn-default bucket using the SLM Cmmute tl. The "n-net" entry is autmatically added t the list f Cnfigured Servers in the SLM Cnfiguratin Wizard tl after the license is cmmuted frm a nndefault license bucket. 98 8 Frequently Asked Questins