Manual

Protection

Scia Engineer

The information contained in this document is subject to modification without prior notice. No part of this document may be reproduced, transmitted or stored in a data retrieval system, in part or in total, in any form or by any means, electronic or mechanical, for any purpose without the express permission in written from the publisher. SCIA Software is not liable for any direct or indirect damages resulting from imperfections in the documentation and/or the software. Copyright 2009 SCIA Software. All right reserved.

Scia Engineer

Introduction ...................................................................................................................................3 Supported operation systems ............................................................................................... 3 Standalone protection ............................................................................................................ 3 Schema of standalone protection ........................................................................................ 3 FLEXnet protection ................................................................................................................. 4 Scheme of floating protection .............................................................................................. 4 Changes in Demo and Student mode .........................................................................................5 Demo / student version using dongle ................................................................................... 5 Demo / student version using floating.................................................................................. 5 Standalone (dongle) protection ...................................................................................................6 New user activity on users side ........................................................................................ 6 Installation of the Sentinel Protection Installer ..................................................................... 6 Attaching the Sentinel Dongle.............................................................................................. 6 Importing of new LIC file ...................................................................................................... 6 Checking the Sentinel Dongle ............................................................................................... 7 Upgrade of dongle existing user ........................................................................................ 8 Time limited dongle ................................................................................................................ 8 Using of more dongles together ............................................................................................ 9 FLEXnet protection .....................................................................................................................10 Trusted storage - overview .................................................................................................. 10 Installation of the FLEXnet anchor service and trusted storage ..................................... 11 Installation of the SCIA FLEXnet license server ................................................................ 11 Activation of SCIA licence server ........................................................................................ 12 Upgrade of users version .................................................................................................... 12 Configuration and start of SCIA licence server ................................................................. 13 Setting constant port for vendor daemon ........................................................................... 14 Configuration of SCIA licence server to provide licences for older versions of SCIA Engineer ................................................................................................................................. 15 Protection Settings of Scia Engineer on the client PCs ................................................... 16 Borrowing .............................................................................................................................. 16 List of tools ..................................................................................................................................19 Protection setup .................................................................................................................... 19 Activation utility .................................................................................................................... 20 Standard FLEXnet tools ....................................................................................................... 21 Error messages troubleshooting............................................................................................22 General problems .................................................................................................................. 22 Dongle protection ................................................................................................................. 22 Protection setup - Import licence file .................................................................................. 22 FLEXnet protection ............................................................................................................... 23 Activation utility .................................................................................................................. 23 Borrowing ........................................................................................................................... 23 Repair ................................................................................................................................. 24

Scia Engineer

Introduction

Supported operation systems

To run Scia Engineer with standalone protection your system must meet the following requirements: MS Windows XP / 2003 / Vista / XP 64 bit It is advised to install the latest Service Pack for these operating systems except SP3 for Win XP.

To run Scia Engineer with floating protection your system must meet the following requirements: MS Windows XP 32 bit/ Vista 32 bit It is advised to install the latest Service Pack for these operating systems except SP3 for Win XP.

Standalone protection
Starting from version 2010 the dongle does not contain the list of modules, but it contains only LockID. By this LockID it is bind with the LIC file which contains the list of modules which the user can use. The LIC file contains also number of version. This version is also stored in the dongle. The LIC file can be replaced only by the LIC file of the same or higher version number. (see later).

Schema of standalone protection

Scia Engineer

Compatibility with older versions

It is possible to store both (technical modules and LockID) in one dongle. Therefore the same dongle can be used to run EPW, older version of Scia Engineer (up to version 2009.0) and new version of Scia Engineer (from version 2010.0).

FLEXnet protection
FLEXnet protection is a new type of network protection based on technology of Acresso Company. This type of licensing stores commercial modules in Trusted storage on the Licence server. Those modules can be used (Checked out) by application (Scia Engineer) or borrowed. FLEXnet protection fully replaces FlexLM protection in new versions (from 2010.0). In case of FLEXnet protection the content of editions (if user has any) are stored directly in feature line of trusted storage. Regarding the limitation of FLEXnet technology the maximal number of commercial modules which can be assigned to one edition is limited to approx. 260.

Scheme of floating protection Compatibility with older versions

Older versions of Scia Engineer (FlexLM protection) can be run with new FLEXnet licence server. In this case the modules are provided by the licence server only if the FlexID dongle is attached.

Scia Engineer

Changes in Demo and Student mode

From the version 2010 it is not able to run SCIA Engineer without protection. It will not run even in Demo mode as it was in the past. In versions starting from 2010 the user must to have a dongle with TRIAL or STUDENT module or to have TRIAL or STUDENT module in local trusted storage.

Demo / student version using dongle

1. 2. 3. 4. Receive dongle and LIC file from SCIA support Import LIC file in the Protection setup dialog Switch protection to Standalone in the Protection setup dialog Start SCIAL Engineer

For more details see chapters related to standalone protection.

Demo / student version using floating

1. 2. 3. 4. 5. Install Licence server and activation utility on users local computer. Activate LockID using LID file from SCIA support Start licence server (if it is not running) In the Protection setup dialog select Trial / Student version Start Scia Engineer

For more details see chapter related to Floating (FLEXnet) protection

Scia Engineer

Standalone (dongle) protection

New user activity on users side

When a hardware lock is used for the protection, the following procedure needs to be followed: - Installation of the Sentinel Protection Installer - Attaching the Sentinel Dongle - Import LIC file in Protection setup utility (see above)

Installation of the Sentinel Protection Installer

The Sentinel Protection Installer provides for communication between Scia Engineer and the Sentinel dongle. In the Installation & Software menu of the installation DVD choose the option Install Sentinel Driver. Follow the installation instructions on the screen. The Sentinel Protection Installer can also be installed manually by executing the file X:\Tools\Sentinel\Sentinel Protection Installer 7.* .exe where X represents the DVD drive and * the version number.
Note:

When an older version of the Sentinel System Driver or the Sentinel Protection Installer has already been installed on the computer, this older version must first be de-installed through the Control Panel before installing the new Sentinel Protection Installer.

Attaching the Sentinel Dongle

The Sentinel hardware locks are available for USB ports. Attach the dongle to a free port of the computer.

Importing of new LIC file

When user receives the new LIC file then he can store the file to arbitrary folder in his computer except ESA\Licence directory. Then user needs to launch Protection setup (Lockman.exe) and import the LIC file to Scia Engineer [Import licence file] button. (see chapter about tools for user) Then the user is asked to select new LIC file. Finally the LockID of selected LIC file is compared with the LockID of dongle attached to the machine and also counter of selected LIC file is compared with counter of current LIC file and counter stored in the dongle. If the Lock ID and counter number are valid then the dongle is updated and LIC file is stored in ESA\Licence directory. The following message will appear after successful import of licence file

Once the LIC file is successfully imported, user can see the list of his commercial modules in the Expand mode of Protection setup dialog.

Scia Engineer

Note:

Import of new LIC file can be done only with the dongle with the same LockID as is in the LIC file. Import of LIC file can be done only if the user is logged with the rights to write into directory with installation of Scia Engineer. If it is not possible to import LIC file then verify that dongle is correctly attached and correctly installed (see next chapter).

Checking the Sentinel Dongle

To make sure the Sentinel Dongle has been installed correctly the Sentinel SuperPro Medic can be used. Installation of Sentinel SuperPro Medic 1. Using Windows Explorer go to X:\Tools\Sentinel\ where X represents the DVD drive. 2. Execute the file SuperproMedic.exe and follow the instructions on the screen. 3. By default the SuperPro Medic is installed in the folder C:\Program Files\Rainbow Technologies\SuperPro\Medic Checking the Sentinel Dongle 1. Using Windows Explorer go to C:\Program Files\Rainbow Technologies\SuperPro\Medic 2. Execute the file SuperproMedic.exe The SuperPro Medic appears on the screen. 3. In the upper right corner of the SuperPro Medic the version of the installed Sentinel Driver is shown. When no version is shown then the Sentinel Protection Installer needs to be installed as described earlier.

4. In the field Server Name/IP or Mode choose the option STANDALONE 5. Next press [Find SuperPro] to search for correctly installed Sentinel dongles. A dialog box appears showing the number of keys found. 6. When no Sentinel dongles are found, press [Medic Says] to receive extra information in order to find the cause of the problem. When the SuperPro Medic indicates that the Sentinel dongle has been found, then this means the dongle is attached correctly to a parallel or USB port and the Sentinel Protection Installer has been installed correctly.

Scia Engineer

Upgrade of dongle existing user

Activity on users side When user buys a new version of Scia Engineer or new modules, he will need to receive new LIC file from SCIA and perform Import of new LIC file in Protection setup see previous chapter. Following message will appear after successful update of Licence file.

When the user uses some predefined sets, he will need to update modules in those sets (add new modules). When upgrading to version 2010 (with new type of protection) user will need to get new LIC file and import it in Protection setup utility. No reprogramming of dongle is necessary. Older versions of Scia Engineer will remain functional. When upgrading from version 2010 to higher, the user will need to receive new LIC file from SCIA (with new commercial module for new version) and import it in Protection setup utility. No reprogramming of dongle is necessary. Older versions of Scia Engineer will remain functional.

Time limited dongle

Time limited licence is available also for dongles. It is possible to set different time limitation (different number of days) for each commercial module in the LIC file. The number of days is calculated from the moment of importing the LIC file by user in the protection setup utility. During the import of LIC file, the current date is written into the dongle (number of days is stored in the LIC file). The number of remaining days (excluding the current day) for time limited module is displayed in the list of modules. Once the time limitation is exceeded, the licence is displayed as Expired and will not be available during start of Scia Engineer.

Scia Engineer

Note

The date in the dongle is changed only if the counter of LIC file is higher that the counter in the dongle (to prevent prolonging of time limited version by repetitive Importing LIC file by the user). It is not necessary to send new dongle to the user to prolong is time limited version. Only the new LIC file is enough If there is 0 day(s) to expire it means that this is the last day the module can be used. In case of using more dongle, the number of available days is compared with the date written in the dongle linked with the LIC file.

Using of more dongles together

User can use as many dongles as he can attach to the computer. The LockID numbers of all attached dongles are displayed at the header of protection setup utility. In the list of available commercial modules is displayed the sum of modules from LIC files related to all attached dongles. Finally the sum of modules from LIC files related to all attached dongles can be used in Scia Engineer.
Note

[Import LIC file] can be done also with more attached dongles but it affects only the dongle with the same LockID as is the LockID of the LIC file. It is possible to use more dongles with different time limitation. In case that some commercial module is in all LIC files, the one with longer time limitation is taken into account.

Scia Engineer

FLEXnet protection
This chapter describes the procedure how to install a license server. Scia Engineer is installed locally on the client PC, only the protection is installed on the server. The network protection can be installed on each computer in the network. This means that it does not have to be the domain or file server. Each of the authorised modules can have a different amount of licenses, which can be started simultaneously. The user can determine which modules he wishes to use (via Protection setup - Lockman.exe) and which modules he wishes to remain available for other users. Commercial modules are on server side stored in trusted storage. The installation procedure consists of the following steps: - Installation of the FLEXnet anchor service and trusted storage and Installation of the SCIA licence server (both is part of installation DVD) - Receive LIC file from SCIA - Activation of SCIA licence server - Configuration and start of SCIA licence server - Protection Settings of Scia Engineer on the client PCs

Components of FLEXnet protection FLEXnet protection consists of following components: Application (Scia Engineer): Standard installation of the Scia Engineer. Setting of protection is done in Protection setup (lockman.exe). Trusted storage on End users machine (Application TS): It is Trusted storage on end users machine. Here are stored modules borrowed from clients licence server. There is no need of users actions to install and use application TS. Vendor (SCIA) daemon: It is in SCIA.exe file which must be installed on clients licence server machine. Vendor daemon is part of Licence server which communicates with application and administrates requests for modules. It must be running on clients server machine when trying to Check out / Check in any modules. It can be run in standard way (see help available for lmgrd.exe /?). Trusted storage on server machine (Server-side TS): It is trusted storage on users licence server machine. Here are stored modules which user has activated. Those modules are then enabled to users application via SCIA daemon. Administration of licenses stored in Server-side trusted storage can be done using Server Activation utility (see further). Server activation utility: see separate chapter SCIA activation server: This is the server which is operated by SCIA. It is located on our machine and communicates directly with Software installed database. It proceeds requests from users and send responses to them. The IP address of the activation server is: activation.scia-online.com

Trusted storage - overview

The trusted storage is space on the licence server where information about activated modules is stored. This storage is secured against unauthorized use. Trusted storage contains license rights for FLEX enabled applications. To secure these license rights, the following security is provided for trusted storage: Encryption: the contents of trusted storage is encrypted to be protected against external modification. Restricted access: Access to trusted storage is restricted. Only the activation utility can access the trusted storage

10

Scia Engineer

System clock windback detection: Time stamps are placed in trusted storage each time it is accessed. When windback detection is required, the current system time is checked against the time stamp in the fulfilment record. System binding: license rights are locked to a system to prevent them being transferred illegally to another system. This is referred to as binding and the system characteristics used for the binding are referred to as binding identities. System anchoring: anchors are links to one or more system identifiers. They are used to identify if trusted storage has been deleted or overwritten. This is referred to as anchoring, and implies that one or more anchors are in use.

Important

Following identities are used as bindings. It is recommended to return licences to SCIA activation server before taking actions which can cause changing of those values: Machine Hard disk or file system Display or graphic card Bios serial number CPU information RAM size Network card address IP address Machine serial number

In some cases when security rules are violated the trusted storage can become untrusted. It can happen by legal action but also by illegal attempt to unauthorized usage of the licenses.

Installation of the FLEXnet anchor service and trusted storage

Installation of FLEXnet anchor service is part of installation DVD of Scia engineer.

Installation of the SCIA FLEXnet license server

Installation of FLEXnet anchor service is part of installation DVD of Scia engineer.

11

Scia Engineer

Activation of SCIA licence server

activation.scia-online.com

For activation of SCIA licence server, user needs to receive the LID file from SCIA and go through following steps: 1. Run Activation utility 2. Press [Read Lock ID] select the LID file in the Open file dialog 3. Press [Activate Licence]

4. This message informs that activation finished successfully 5. Activation utility can be closed now 6. The content of Trusted storage can be checked using tool sereveractutil.exe: serveractutil.exe -view If the activation process is finished without problems then the licence is activated and can be used with Licence server. Activated licence is indicated by green icon.

Upgrade of users version

When user buys new modules, it must be indicated in SCIA database and user (administrator) needs to update trusted storage of his licence server. The update consists of two steps: 1. Return current modules from users trusted storage to SCIA activation server (return request) 2. Activate modules from SCIA activation server (it will be activated including new modules) Those two steps can be done manually or at once by pressing [Reload licence].

12

Scia Engineer

activation.scia-online.com

Configuration and start of SCIA licence server

Note

The licence server is configured automatically within installation of SCIA FLEXnet licence server. In usual cases the following steps are done automatically. 1. Start the file lmtools.exe

2. On the tab Service/License File choose the option Configuration using Services 3. Go to the tab Config Services and in the field Service Name type a name for the new License Manager, for example FLEXnet SCIA 4. Press [Browse] on line Path to the lmgrd.exe file and change the path to the file C:\Program Files\SCIA\FLEXnet\lmgrd.exe 5. Press [Browse] on line Path to the license file and change the path to the file C:\Program Files\SCIA\FLEXnet\SCIA_software.LIC 6. Press [Browse] on line Path to the Debug log file and change the path to the file C:\Program Files\SCIA\FLEXnet\debug.log

13

Scia Engineer

This file does not yet exist so the name needs to be typed in. Should any problems occur with the License Manager, error messages will be written to the debug.log so the cause of the problems can be found. 7. Select both options Use Services and Start Server at Power Up at the bottom of the dialog box.

8. Save this configuration by pressing [Save Service] 9. Go to the tab Start/Stop/Reread 10. Select the newly created License Manager (FLEXnet SCIA) 11. Press [Start Server] The License Server has now been started and it provides for communication with the licenses.

Setting constant port for vendor daemon

By default the vendor daemon uses random free ports for his communication with client machine, but it can be changed and constant part can be defined by the licence server administrator. a. open C:\Program Files\SCIA\FLEXnet\SCIA_Software.lic file for editing b. modify row VENDOR SCIA to e.g. VENDOR SCIA PORT=20563 c. restart the licence server Now the vendor daemon will use only the port 20563 for communication.
Note

Any other changes in SCIA_Software.lic file are protected by the sign of the file and will lead to damaging of the licence file.

14

Scia Engineer

Configuration of SCIA licence server to provide licences for older versions of SCIA Engineer
Licence server distributed with version 2010 (and later) can be also used with older versions of Scia Engineer (with floating licensing based on FlexLM technology). 1. Start the file lmtools.exe

2. Press [Browse] on line Path to the license file and change the path to the *.dat file which was used with previous versions of SCIA Engineer.

Note

The licence server will provide modules from DAT file only if the correct FlexID dongle is attached and his drivers are installed. Modules from DAT file cannot be used in new version of SCIA Engineer (version 2010 and newer). Modules from trusted storage cannot be used in older version (version 2009 and older).

15

Scia Engineer

Protection Settings of Scia Engineer on the client PCs

In Protection setup dialog the user needs to set protection type to Floating and fill in the correct path to Licence server. After pressing [Apply] the list with available commercial modules will be refreshed. It is also possible to prepare predefined Sets of modules. Modules stored in those sets will be used during next launch of Scia Engineer.
Note

In some cases FLEXnet client tries to connect to different licence server than is specified by user. It is special feature of FLEXnet. In such cases it is possible to force the IP address of licence server by modification of registry key:
HKEY_CURRENT_USER\Software\FLEXlm License Manager\SCIA_LICENSE_FILE

Borrowing
Borrowing enables to the end-user to take some modules from Licence server to his local computer and use them also offline. The borrowing is done for specified time (maximal one month). After this time the module is automatically returned back to licence server.
Note

If the user wants to use borrowing, it must be explicitly enabled by SCIA. The borrowing can be enabled for each separate commercial module (edition/ package). Borrowing of modules is controlled from Protection setup utility:

16

Scia Engineer

If the user wants to borrow modules, he needs to select (check) modules he wants to borrow and press [Borrow selected modules] button. Then he is asked for number of days (calendar). All modules that are currently selected (checked) are borrowed (if it is allowed for them). In case the borrowing is not possible for selected module the warning message is received.

Once the module is borrowed, it is indicated by changed button. Pressing this [Return borrowed modules] button will cause early return (before the date specified during borrowing) of borrowed modules.

If the user wants to borrow some more modules (or other selection of modules) then he must at first return currently borrowed modules. After returning he can make new selection of modules and perform Borrow action again.

17

Scia Engineer

Note

The early return is possible only if the end-user is connected to his licence server.
Note

Borrowing of modules can be also controlled using LMtools

18

Scia Engineer

List of tools Protection setup

The protection setup belongs to Scia Engineer. However it is a separate utility. It can be launched using Lockman.exe. This is basic tool for end-users to configure his licensing.

User can select one of the following protection types: 1. Trial it runs Scia Engineer in Trial mode if there is a TRIAL module in the local trusted storage 2. Only standalone reads modules only from the dongle and LIC file 3. Only floating reads modules only from the FLEXnet licence server 4. First standalone then floating try to reads modules from dongle, if it not present then it reads modules from FLEXnet licence server 5. First floating, then standalone try to read modules from FLEXnet licence server, if it is not accessible, then modules are taken from dongle 6. Student it runs Scia Engineer in Student mode if there is a STUDENT module in the local trusted storage If the dongle is attached then its LockID is displayed in the header of the dialog. When the floating protection is selected, then user must specify the path to his FLEXnet Licence server. At the bottom of the dialog there is the list with commercial modules which are available in the LIC file or in the Trusted storage. Here the user can select modules which he wants to use in Scia Engineer. The setting of modules also can be saved to Sets. Sets are predefined settings of commercial modules. They are stored in files in User\protection\Sets directory. In the Protection setup dialog the user can choose between existing sets of modules in the combobox. SETs are intended to be used for floating protection (to make selection of modules easier), however, it can be used also with standalone protection. [Save set of modules] saves the current selection of modules into defined set (the name of the set is according to file name specified by the user). [Import set of modules] modify the current setting of modules according to selected set, but does not change the name of the current set. It can be also used for importing SETs from another computer (e.g. if prepared by IT administrator on the server). After the import the SET is copied to USER\Protection\Sets directory and can be used. [Remove set of modules] deletes current set.

19

Scia Engineer

Note

Files with Sets can be manipulated (copy, delete, edit) also manually. Numbers next to commercial module are valid only for floating licensing and mean: total number of modules on the server / available number of modules at the moment. Each commercial module in the list can be expanded (by double-click). Then the technical modules contained in the commercial module are listed.

Activation utility

activation.scia-online.com

This utility needs to be installed on users licence server. The utility is intended for users licence administrator. It enables to administrate the server-side trusted storage. Following actions are available: Add new licence (one licence represents one LockID) in the list Delete licence from the list

And also perform transactions with SCIA Activation server - Activate a licence - Return a licence to SCIA server - Repair damaged trusted storage

20

Scia Engineer

Standard FLEXnet tools

lmgrd.exe: command line-based tool for administration of FLEXnet licence server. lmtools.exe: configure licence server as a service lmdiag: to diagnose license checkout problems. lmdown: Not normally required. lmhostid: Required for determining the hostids of client systems. lmreread: Not normally required. serveractutil: Command tool for administration of trusted storage (e.g. servertactutil view ) shows the content of trusted storage

For more detailed description of mentioned tools se License Administration Guide from Acresso company.

21

Scia Engineer

Error messages troubleshooting

General problems
Missing c2t in the main directory with Scia Engineer Reinstall the Scia Engineer

Scia Engineer run in Demo mode

Necessary commercial modules are not selected in the protection setup Necessary commercial modules has expired

Verify that all necessary commercial modules are selected. Especially modules for version of Scia engineer Check the list of modules in protection setup and contact your regional sales or support

Dongle protection
Scia Engineer run in Demo mode no number is displayed in the header of Protection setup utility Scia Engineer run in Demo mode no modules listed in Protection setup utility Dongle is not attached Dongle drivers are missing Attach the dongle Install drivers see special chapter Dongle is not attached Dongle drivers are missing *.LIC file is missing Attach the dongle Install drivers see special chapter Do Import licence file

Protection setup - Import licence file

*.LIC file cannot be copied to Licence directory defined in Setup / Options / Directories 1) ensure that source *.LIC file used for [Import LIC file] is not stored in Licence directory 2) ensure that user has write-access to Licence directory It is not possible to import LIC file with lower counter than was the counter of previously imported LIC file Possibly user has selected wrong LIC file. Select the latest LIC file or ask for the assistance from SCIA support.

22

Scia Engineer

FLEXnet protection
Activation utility
Unspecified error during communication with SCIA activation server Contact SCIA support

Problem with ID in SCIA database

Contact SCIA support

All modules of this user (LockID) has been already activated

Contact SCIA support

It is not possible to connect to Activation server

Check your internet connection or verify the correct value of SCIA Activation server URL:

Activation bez pripojeni k netu Discrepancy between modules in users trusted storage and SCIA database Contact SCIA support

Too long time between sending request and receiving response.

Check internet connection. It is probably not working or too slow

return request bez pripojeni k netu Wrong licence name was sent to SCIA activation server Contact SCIA support

Borrowing
Some of selected modules cannot be borrowed. The borrowing must be explicitly allowed by SCIA Modify selection or contact SCIA for enabling of borrowing for necessary modules

23

Scia Engineer

Not possible to connect to licence server from which the modules were borrowed

Check that licence server is running and check your network connection

Repair
Repair transaction was not previously approved by SCIA Contact SCIA support with explanation how the trusted storage became un-trusted

24