You are on page 1of 25

Table of contents

i (25)

Tekla Structures
FLEXnet Licensing User Guide

Contents

Tekla Structures 14.0 beta 4 phase documentation. Further installation and usability improvements will be implemented during later phases. This document contains instructions on features released in Tekla Structures 14 beta 4.

Change History
Date 17.10.2007 23.10.2007 19.11.2007 07.12.2007 31.01.2008 06.02.2008

Changed by

Issue License borrow and return instructions included Added instructions on how to use activation with proxy. Beta modifications: User Interfaces TS license server installer added. Updated the activation and borrowing procedures. Added information of new features in the User Interface. Updated the installation procedure.

Table of contents

ii (25)

Table of contents
1. Getting started with FLEXnet licensing.............................................................................................................................3 1.1 What is FLEXnet licensing?.....................................................................................................................................3 1.2 Items provided by Tekla...........................................................................................................................................4 1.3 Check list for you and your IT department...............................................................................................................4 1.4 License server administrator....................................................................................................................................7 Installing Tekla Structures License Server .......................................................................................................................7 2.1 Modifying the license file (optional)..........................................................................................................................7 2.2 Saving the entitlement certificate.............................................................................................................................8 2.3 Starting Tekla Structures License Administration Tool ............................................................................................9 2.4 Using a proxy server...............................................................................................................................................9 2.5 Activating licenses .................................................................................................................................................11 2.6 Notifying the license server about new licenses ....................................................................................................12 Starting Tekla Structures 14.0 with FLEXnet licensing...................................................................................................13 Checking the license server status and license information ...........................................................................................14 4.1 License server information on LMTOOLS .............................................................................................................14 4.2 License information on Tekla Structures License Administration Tool...................................................................14 License deactivation.......................................................................................................................................................16 5.1 Stopping the server................................................................................................................................................16 5.2 Deactivating licenses .............................................................................................................................................17 5.3 Restarting the server .............................................................................................................................................18 License borrow ...............................................................................................................................................................18 6.1 Pointing the license server to licenseclient.ini........................................................................................................18 6.2 Saving the entitlement certificate for license borrow..............................................................................................19 6.3 Borrowing a license from license server to your laptop .........................................................................................19 6.4 Returning a borrowed license ................................................................................................................................20 Configuring Tekla Structures license server manually....................................................................................................21 Managing license access rights......................................................................................................................................25

2.

3. 4. 5.

6.

7. 8.

Updating and renewing of licenses is easier. 1.1 Getting started with FLEXnet licensing 3 (25) 1.com. need to have and need to do to get started with the Tekla Structures FLEXnet licensing system. You can. Point each client computer with Tekla Structures on them to the license server.1 What is FLEXnet licensing? From version 14 onwards Tekla Structures uses a new licensing system: FLEXnet Publisher Licensing (further FLEXnet). Users can be guaranteed access or denied access to certain Tekla Structures configurations. • • • Hardware locks and password files are no longer needed. Activation based licensing differs slightly from traditional license file based licensing. You can easily change the location of the licenses by returning the licenses and then activating them on another computer. When users leave the office and have no connection to the license server. You can create user groups with different access rights. • • • • . When the user no longer needs the license. • FLEXnet licensing provides new functionalities for license handling. Handling of licenses is more efficient. they can borrow licenses for a limited time for offline use. For more information on Macrovision. When a user starts Tekla Structures. FLEXnet is an activation based licensing system provided by a company called Macrovision. it automatically obtains a license from the server. for example. In activation based licensing you will need to • Install and set up a license server either o o • at your company to serve multiple users or on a single computer to serve a single user. The borrowed license is reserved for the user until it expires or it is returned. Activate your licenses by contacting the activation server at Tekla HQ. the license is returned to the license server and it is available to another user. During the activation the license rights are transferred from Tekla to your company and the licenses become enabled. You do not have to install all of your licenses on the same server. The licenses can be installed on a server in a local area network. see http://www. Getting started with FLEXnet licensing This section describes the things you need to know. activate half of your licenses on a common server and the rest of the licenses locally on each user's laptop.macrovision.

Windows versions Vista (Business. Entitlement certificate lists all the Tekla Structures licenses you are entitled to use and includes the activation IDs for those licenses. Enterprise. contact local Tekla Structures reseller. A general end user guide provided by Macrovision.pdf. You can download the installation package from Tekla Extranet.pdf. For entitlement requests. connections and protections: • Windows operating system The FLEXnet licensing server supports Windows as operating system. Tekla Structures supports the following Windows versions: Vista (Starter. o User instructions are installed in the . Home . More detailed information is in the FAQ and the following two documents: o TeklaStructuresFLEXnetLicensingUserGuide. Contains.1 Getting started with FLEXnet licensing 4 (25) 1. By default the tools will be installed in the folder C:\TeklaStructures\License.0 beta installation package Tekla Structures installation includes the tools for license client use.3 Check list for you and your IT department To get started with FLEXnet licensing you need to clarify the following things about IT resources. • Tekla Structures license server installation package Tekla Structures license server installation package installs the licensing system tools.TeklaStructures\License\Server folder. Ultimate). 1. for example. • User instructions Tekla Structures Quick Guide to FLEXnet Licensing instructs you how to install the license server. By default the tools will be installed in the folder C:\TeklaStructures\License\Server. Server 2003 and Server 2000 are supported. You can download the installation package from Tekla Extranet. LicensingEndUserGuide.2 Items provided by Tekla To get started with FLEXnet licensing you need to have following items provided by Tekla: • Entitlement certificate Entitlement certificate has been sent to you via email from Tekla.. Contains specific instructions on installing and configuring of the Tekla Structures license server. the instructions for user group creation and user rights handling. • Tekla Structures 14.

. In Windows Vista you need to log in as administrator and in some cases separately run applications as administrator. right-clicking and clicking Run as administrator on the menu. clicking Run as… and clearing the Run this program with restricted access check box.1 Getting started with FLEXnet licensing 5 (25) Basic. Enterprise. 2000 SP4 and NT SP6a. XP. In Windows XP you need to log in as administrator. In Windows Server 2003 you need to login as administrator and in some cases separately run applications with unlimited rights. This can be done by selecting the application. • Administrator rights You need to have administrator user rights to install the license server. right-clicking. This can be done by selecting the application. Business. Home Premium. Ultimate).

The activation communication is done using SOAP protocol over HTTP protocol on TCP/IP port 80. • Direct communication to internet Direct communication from the server computer to the internet needs to be allowed while the license server at your company contacts the activation server at Tekla. The port number can be any free port between numbers 102464000. Macrovision recommends using ports in the range 27000-27009.1 Getting started with FLEXnet licensing 6 (25) • Free TCP/IP port for license server You can run the Tekla Structures license server on the same computer as other software license servers or the Tekla Structures multi-user server but you need to dedicate one TCP/IP port only for the Tekla Structures licensing service. Firewall should not block any incoming or outgoing information. • Local area network The license server and the client computers with Tekla Structures installation need to be in the same local area network.lic file. . The clients need to be able to contact the license server through the selected port. The system will automatically search for the available TCP/IP port and by default the first available port will be used. If there is no local area network in your company. If you want to set the port by yourself. we recommend that you activate one license on each computer with Tekla Structures and install the license server locally on each computer. you can define it in the tekla.

1 Modifying the license file (optional) The license file tekla. If the default settings are OK for you. The Tekla Structures license server installation includes the license server files. In that case. In most of the cases the default settings are OK but you may want to manually give the TCP/IP port as it speeds up the communication between Tekla Structures and the license server. The Tekla Structures License Server administrator’s primary responsibilities are: • • • • Installing and maintaining the Tekla Structures License Server. and also the user name and password if needed. Run Control Panel on Windows and click Add or Remove Programs. go to 2.\TeklaStructures\License\Server folder is needed to run the Tekla Structures license server.2 Installing Tekla Structures License Server 7 (25) Proxy server Some companies use proxy servers as a way through the firewall. Before the activation you need to know whether your company has a proxy server. 2. If direct internet communication cannot be allowed and if there is no proxy in use at your company. please contact local Tekla Structures support. then the licenses can be activated manually. If you have the proxy.2. Activating licenses on the server to make licenses available for Tekla Structures users.4 License server administrator When you set up a Tekla Structures license server at your company. Installing Tekla Structures License Server Run TsLicSrvSetup102. you need to uninstall that: 1. To set the TCP/IP port manually: .. 2. 3. applications for license handling and user guides. Informing users of the license server machine name and port number so that they can connect to the server in Tekla Structures. click Tekla Structures License Server. you need to assign a person to set up and configure the license server. You must have administrator rights. 2. • 1. Saving the Entitlement Certificate. you need to know the address and the port of the proxy server. Click Remove to uninstall the license server. On the list of programs.exe to install the Tekla Structures license server. Monitoring the product license usage.lic in the . If you have installed a previous version of Tekla Structures license server.

Save the changes. Select the .html attachment in the . Click Save. click File > Save Attachment > EntitlementCertificate.mycompany.com). Go to . replace localhost with the hostname address of the server computer (for example. quantities and activation IDs of available licenses.\TeklaStructures\License\Server folder 2. Open tekla. on Microsoft Outlook.html.lic file with a text editor 3. Save the attached EntitlementCertificate.. servername.\TeklaStructures\License\Server folder for saving destination.mycompany. Enter the TCP/IP port number after text SERVER servername. As a preliminary action for transferring the license rights from Tekla HQ to your license server. you need to save the entitlement certificate in a format which the Tekla Structures License Administration Tool is able to read. 4. The certificate states the configurations. The port number can be any free port between numbers 1024-64000. To do this. If you installed the license server on some other computer. For example. This step depends on the email application used. 1.2 Installing Tekla Structures License Server 8 (25) 1.html 3. • • If you installed the license server on your own computer. 2. After the modifications your license file may look like this: 4. enter the TCP/IP port number after text SERVER localhost ANY. Open the email with the entitlement certificate in your mail box 2.2 Saving the entitlement certificate You have been provided with a Tekla Structures entitlement certificate in an email..com ANY.\TeklaStructures\License\Server folder. Enter the TCP/IP port number. . Macrovision recommends using ports in the range 27000-27009.. Save the EntitlementCertificate.

If you do not use a proxy server.5 Activating licenses. To be more specific. The Options dialog box opens. Tekla Structures License Administration Tool is the application for activating the licenses. 2. 2.2 Installing Tekla Structures License Server 9 (25) Now you can activate your licenses with Tekla Structures License Administration Tool. click Start > All Programs > Tekla Structures Licensing > Tekla Structures License Administration Tool. . you can activate them partially. all the licenses can be activated on the same license server or on a couple of server computers. on your computer. To run Tekla Structures License Administration Tool. you need to know if direct communication to the internet by using the SOAP protocol over HTTP protocol on TCP/IP port 80 is allowed. The Tekla Structures License Administration Tool dialog box opens. go to 2. Something between these examples can be done as well.3 Starting Tekla Structures License Administration Tool The licenses need to be activated on the license server to use them. To use a proxy server: 1. If you have several licenses in the same entitlement. If the port is allowed. One option is to activate one license on each user's work station. in the case of a single user.5 Activating licenses. Activating the licenses transfers the license rights from the activation server at Tekla to the license server at your company or. Click Actions > Options. go to 2.4 Using a proxy server Your company may have a proxy server. which prevents the direct communication between your computer and the internet. For example.

select Proxy server requires username and password. 3. 5. If your proxy server needs either user name or both user name and password. 6. Click the Port box. Click OK when the settings are correct. Select the Use proxy server check box. Enter the user name and the password. . Enter the name of the proxy in the Address box.2 Installing Tekla Structures License Server 10 (25) 2. and enter the TCP/IP port of your proxy. 4.

. Tekla Structures License Administration Tool displays the license information under the Entitled Licenses area. Click the Activate box and select the number of licenses for activation from the list. you need to open the entitlement certification.2 Installing Tekla Structures License Server 11 (25) Please note that all values.5 Activating licenses To activate licenses: 1. If you did not save the EntitlementCertificate. If you do not want the password to be included in the file.\TeklaStructures\License\Server folder. The password is deleted from the file. clear the password box after activation and then click OK.html you saved earlier on your email application.ini file.html in the . 2.. Click File > Open and open the EntitlementCertificate. You can also enter the number in the box. including the password will be written in the licensemanager. 2.

2.2 Installing Tekla Structures License Server 12 (25) Please note that you do not need to activate all the licences at once. You have now completed the installation of Tekla Structures license server. Different configurations and different versions need to be selected for activation separately. Click the Start/Stop/Reread tab. 3. but when selected. 2. To open LMTOOLS. 3. 1. You must have administrator rights. they can be activated all at once. You can activate part of your licenses now and part of the licenses later on some other computer.6 Notifying the license server about new licenses The license server must be notified about activated licenses. After successful activation the activated licenses are displayed under the Activated Licenses area. Click Activate button. Your license server contacts the activation server at Tekla. click Start > All Programs > Tekla Structures Licensing > LMTOOLS. . Click ReRead License File. for example.

• • If you have activated your license on your own PC or laptop. servername.com). you can enter the server hostname (for example. the system asks you to define the license server you want to use. If you want to check which licenses are available on the server. Enter the name of the license server. If the licenses are activated on a separate license server. You can also enter the TCP/IP port (for example.0 with FLEXnet licensing 13 (25) 3. @servername) or the complete hostname address (for example.com).0 with FLEXnet licensing When you start Tekla Structures 14. click Check licenses.3 Starting Tekla Structures 14. Starting Tekla Structures 14. Click OK. 27000@servername. To define the license server 1.mycompany. 3. 2. you can enter localhost and the system will automatically use your computer. Tekla Structures now starts.mycompany. .0 for the first time.

Please note that there is a buffer in the amount of text displayed in the window.2 License information on Tekla Structures License Administration Tool After the Entitlement Certificate has been loaded on Tekla Structures License Administration Tool. Please note that server status and license usage information does not update automatically. the Entitled Licenses area displays information about the licenses.4 Checking the license server status and license information 14 (25) 4. . click Start > All Programs > Tekla Structures Licensing > LMTOOLS 2. 4.1 License server information on LMTOOLS If you want to see what licenses are currently in use. 4. Checking the license server status and license information License server status and license usage information can be checked with the LMTOOLS application. Tekla Structures License Administration Tool also displays some information of licenses. you can do it in LMTOOLS: 1. To open LMTOOLS. Click Perform Status Enquiry to see the license server status and license usage information. click Edit > Clear Window. To clear the window. Click the Server Status tab. You always need to click Perform Status Enquiry button to get the status on a certain moment. 3.

If licenses are activated on several license servers the information here may be incorrect. Version -The version number of the configuration. The following information is displayed: • • Deactivate – Is used for deactivating licenses. o Host indicates whether the server has been moved from one computer to another or the computer hardware has radically changed. Quantity .The name of the configuration. Start Date . If the license is permanent. Product ID – Configuration name and version number. . Description – The description or a short name of the configuration. the license can not be used. no date is shown.The date when the license expires. Trust Status – Host (H). o o • • Quantity – The number of activated licenses for that configuration.The number of available licenses for activation.The number of total licenses for that configuration. The Activated Licenses area displays information about activated licenses. Restore indicates whether the license is obtained from a backup copy. Time (T) and Restore (R) Trust Status. Configuration . Free . Red symbol indicates that information is not trusted. If any of these is not trusted. Time indicates whether the system clock has been tampered with. Expiration Date .The date when the license came into effect. Green symbol indicates that information is trusted.4 Checking the license server status and license information 15 (25) The following information is displayed: • • • • • • • • Activate – The number of licenses to be activated.

5. you need to deactivate all the licenses that are displayed on the same row under the Activated Licenses area. . Click the Server Status tab. Before deactivating a license.5 License deactivation 16 (25) • • • Expiration Date – The date when the license expires. You must have administrator rights. 1. Do not deactivate licenses without a reason. Deactivating licenses is also needed before rehosting the license server. After deactivation you or some other user can reactivate the license(s) on the same or some other server. run LMTOOLS. Click Perform Status Enquiry to get license server status and license usage information. 3. ensure that nobody uses Tekla Structures. Disabled – Indicates whether the license is disabled. When you deactivate licenses. for example. 5. Click Start > All Programs > Tekla Structures Licensing > LMTOOLS. License Lifecycle Policy of Tekla restricts the number of deactivations per month.1 Stopping the server To stop the server. A disabled license can not be used. no date is shown. A license may be disabled if there is a disconnection during the activation. 2. before changing hardware on the license server or before formatting your server computer. If the license is permanent. There should be zero licenses in use. Borrowed – The number of borrowed licenses. License deactivation Deactivating licenses is needed if you have by mistake activated a wrong configuration or too many configurations.

Click the Start/Stop/Reread tab. Click the Deactivate button. 5.5 License deactivation 17 (25) 4. To select the license for deactivation. 5. The license server contacts the activation server at Tekla.2 Deactivating licenses To deactivate the licenses: 1. Tekla Structures License Administration Tool opens. select the Deactivate check box. Click Start > All Programs > Tekla Structures Licensing > Tekla Structures License Administration Tool. 2. Click Stop Server. You can see the activated licenses under the Activated Licences area. . After successful deactivation the Tekla Structures License Administration Tool dialog box is updated.

3. Before borrowing a license close all Tekla Structures sessions on your laptop. Click the ReRead License File button. A borrowed license is decreased from the total amount of activated licenses on the license server. You must have administrator rights.1 Pointing the license server to licenseclient. Click the Start/Stop/Reread tab. Open licenseclient. 2.ini In order to enable borrowing. 1. License borrow You can borrow a license from the license server to work offline. you need to point your license server to your borrow application.\TeklaStructures\License folder.3 Restarting the server Remember to restart the license server and reread the license file if you did not return all of your licenses at once. 6.. 1. To do this.6 License borrow 18 (25) 5. 2. 6. Enter the address of your Tekla Structures license server in the file. Previous Tekla Structures versions do not support borrowing. 4. Click Start > All Programs > Tekla Structures Licensing > LMTOOLS. Click the Start Server button. .0.ini with a text editor in the . Note that you do not need to borrow a license if you run the license server locally on your laptop. License borrow is enabled only in Tekla Structures 14.

\TeklaStructures\License folder. 3.ini should look like this: 3. 6. double-click licenseclient.6 License borrow 19 (25) If your Tekla Structures license server is 27000@servername. 6. Click Save. To save the mail: 1..\TeklaStructures\License\Server folder. Set the Save as type to Text Only (*. Save the mail in the . 2. Select File > Save as… 3..3 Borrowing a license from license server to your laptop 1.ini. You must have domain administrator rights. . Save the changes and close licenseclient.txt). 4. Click the Borrow until box and select the borrow expiration date on the calendar. Click File > Open and open the entitlement certificate text file. Open the entitlement certificate email in your mail box.com licenseserver.2 Saving the entitlement certificate for license borrow Current version of the License Client license borrow application requires that the entitlement certificate mail is saved as a text file.mycompany.exe in the . 2. To open License Client.

After successful borrow the License Borrowed Successfully dialog box opens.6 License borrow 20 (25) 4. However. You can also return the borrowed license back to server before the expiration date.4 Returning a borrowed license The borrowed license will automatically be available on the license server on the expiration date. Click the Borrow button. you need to be connected in the same local area network with the license server. Before returning a borrowed license. . disconnect your computer from the local area network and try to start Tekla Structures to ensure that the borrowed license works. all Tekla Structures sessions on your laptop needs to be closed. you still need to return the expired license to clean the Borrowed Licenses area. 5. 6. To do that. Before going out of the office with the borrowed license. You can now see the borrowed licenses under the Borrowed Licenses area. Click OK.

You must have domain administrator rights. 3. 2. you need to run LMTOOLS with administrator rights.7 Configuring Tekla Structures license server manually 21 (25) 1. 7. Click Start > All Programs > Tekla Structures Licensing > LMTOOLS to open LMTOOLS and click the Service/License File tab. In this case you need to configure the license server settings manually. Configuring Tekla Structures license server manually If you encounter problems during the Tekla Structures license server installation it is possible that Tekla Structures license server does not start automatically.exe in the .. After a successful return the Borrowed Licenses area is updated. 1. 4. select the Return check box. Double-click licenseclient.\TeklaStructures\License folder. . To configure the settings. Click the Return button. To select a borrowed license. Select Configuration using Services. 2.

5. . Click the Config Services tab.7 Configuring Tekla Structures license server manually 22 (25) 3. Click the Service Name box and enter the name of the service. 4.log files. for example. tekla.exe. Use the Browse buttons to locate the lmgrd. Tekla Structures Licensing Service.lic and the tekla_debug.

Click the Start/Stop/Reread tab.7 Configuring Tekla Structures license server manually 23 (25) 6. Select Use Services to set up the licensing as a Windows service. 8. Select Start Server at Power Up to start the licensing service automatically after powering up the computer. Click Save Services to save these settings. 7. 10. Click Start Server. 9. . The status bar should indicate that server start was successful.

. The line License server status in the Status list displays the TCP/IP port and hostname of the license server.7 Configuring Tekla Structures license server manually 24 (25) 11. 12. The Status list should state that License Server is up and Vendor daemon tekla is up. Click Perform Status Enquiry. Finally it should list all the activated licenses on the server. Click the Server Status tab.

TeklaStructures\License\ folder. Managing license access rights License server administrator can define user groups with different access rights by creating an Options file. For more information on how to define user groups with options file. Tekla. The file is in the .8 Managing license access rights 25 (25) 8...\TeklaStructures\License\Server folder. see FLEXnet Licensing End User Guide in your . For instance. administrator can allow or block certain configurations for certain users or allow or deny the license borrow functionality.opt file includes some examples of definitions of user groups and access rights. .