Software License Manager (SLM) Installation and Reference Guide

Transcription

1 Sftware License Manager (SLM) Installatin and Reference Guide

2 Versin Number: V8.6 May 2014 Cpyright (c) 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 USA Phne: (1) (781) Tll Free: (1) (888) URL:

3 Cntents Abut This Dcument...1 Wh Shuld Read This Guide...1 Technical Supprt 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 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 Installing Stand-Alne License Files...33 Yur License Package...33 New AspenTech prducts...33 Cntents i

4 Upgraded AspenTech prducts...33 Installing the License File...33 Installing Stand-alne Mde License Files...34 Installing the SLM Dngle 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 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 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 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

5 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 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

6 iv Cntents

7 Cntents v

8

9 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: 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

10 Custmer supprt is als available by phne, fax, and . The mst up-tdate cntact infrmatin is available at the AspenTech Supprt Center at 2 Abut This Dcument

11 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

12 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 Quick Guide t Installing and Cnfiguring the SLM

13 Micrsft.NET Framewrk 3.5 Prerequisites On Windws Server 2008 R2 SP1, if yu select all.net Framewrk 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

14 Hwever, if yu clear the HTTP Activatin check bx under.net Framewrk 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 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

15 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 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

16 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

17 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

18 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 Quick Guide t Installing and Cnfiguring the SLM

19 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

20 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 ) 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 Quick Guide t Installing and Cnfiguring the SLM

21 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

22 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 ( 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 Quick Guide t Installing and Cnfiguring the SLM

23 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

24 16 1 Quick Guide t Installing and Cnfiguring the SLM

25 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

26 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

27 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

28 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 SLM Overview

29 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

30 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 SLM Overview

31 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

32 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 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 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

33 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

34 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 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

35 f yur netwrk servers t help ensure that yu remain within yur cntractual limits, cntact yur sales representative r Technical Supprt at 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

36 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 SLM Overview

37 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

38 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 SLM Overview

39 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

40 32 2 SLM Overview

41 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 . 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