License
EDEM 2.6 License Troubleshooting Guide
Copyrights and Trademarks
Copyright? 2014 DEM Solutions. All rights reserved.
Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or any means electronic or mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without written permission.
DEM Solutions
49 Queen Street
Edinburgh
EH2 3NH
UK
https://www.doczj.com/doc/6c16784097.html,
EDEM? incorporates CADfix translation technology. CADfix is owned, supplied by and Copyright?TranscenData Europe Limited, 2007. All Rights Reserved. This software is based in part on the work of the Independent JPEG Group. EDEM uses the Mersenne Twister random number generator, Copyright? 1997 - 2002, Makoto Matsumoto and Takuji Nishimura, All rights reserved. EDEM includes CGNS (CFD General Notation System) software. See the Online Help for full copyright notice.
EDEM?, EDEM Creator?, EDEM Simulator?, EDEM Analyst? and Particle Factory? are registered trademarks of DEM Solutions. EDEM Field Data Coupling TM, EDEM CFD Coupling Interface TM and EDEM Multibody Dynamics Coupling Interface TM are Trademarks of DEM Solutions. All other brands or product names are the property of the respective owners.
1
Contents
Contents
LICENSE OVERVIEW (3)
LICENSE REVOCATION (5)
1.1R EVOKING A L ICENSE ON A W INDOWS L ICENSE S ERVER (5)
1.2R EVOKING A L ICENSE ON A L INUX L ICENSE S ERVER (6)
TROUBLESHOOTING EDEM LICENSE PROBLEMS (7)
1.3T ROUBLESHOOTING A W INDOWS L ICENSE S ERVER (7)
1.3.1Verify the License Server (7)
1.3.2Troubleshoot the Windows License Server (8)
1.4T ROUBLESHOOTING A L INUX L ICENSE S ERVER (9)
1.5T ROUBLESHOOTING A W INDOWS C LIENT (10)
1.6T ROUBLESHOOTING A L INUX C LIENT (11)
1.7R ECLAIMING L ICENSES A FTER A F AILURE (11)
LICENSE ERROR MESSAGES (12)
2
License Overview
EDEM? licensing uses Sentinel TM RMS, a software license management system developed by SafeNet Inc.
As part of the EDEM installation process, licensing software will have been installed either on the same machine as EDEM or on a license server machine on your network. License Code
EDEM licenses are generated based on a code unique to the machine where the license server is installed. Consequently, renaming the license server machine or moving the license server to a different machine requires new EDEM license keys.
License Components
EDEM licensing is provided by license components enabled in the license manager. To view your available components, in EDEM select Tools > License Manager.
The default license components for standard and academic licenses are:
Component Type Description
EDEMCore, EDEMAcademicCore Core The core EDEM user license. The total number of core licenses depends on how many user
licenses (also known as keys or seats) were
purchased. Client machines automatically locate
the license server to get a core license
whenever EDEM is started.
EDEMCPU, EDEMAcademicCPU Core EDEM processor keys. EDEM requires at least one of these to run a simulation. Starting an
EDEM simulation allocates the chosen number
from the pool of processor keys.
EDEMDefaultCAD CAD Enables import of IGES, STEP and STL
geometry files.
Optional licensing components are:
Component Type Description
EDEMCoupling Add-on License for EDEM’s Coupling Interfaces EDEMElectrostatics Add-on License for Electrostatics model EDEMHeatTransfer Add-on License for Heat Transfer model
EDEMACIS Add-on CAD Enables import of ACIS geometry files. EDEMAutoCAD Add-on CAD Enables import of DXF and DWG AutoCAD files. EDEMCatia Add-on CAD Enables import of Catia geometry files. EDEMMesh Add-on CAD Enables import of FLUENT Mesh files.
3
Component Type Description EDEMParasolid CAD Enables import of Parasolid geometry files. EDEMProE Add-on CAD Enables import of Pro/E geometry files.
Specifying the License Server
When you start EDEM for the first time, a pop-up window is displayed for you to specify which license server to use. Unlike previous versions of EDEM, you do not need to set or check any LSHOST or LSFORCEHOST environment variable.
To change to a different license server, start EDEM using the License Server Reset option from the Start menu.
You can also specify the license server to use from the command line. For example, to start EDEM and use a license server called HERACLES, type the following command: edem.exe –-server HERACLES
To view the pop-up window with the list of license servers, from the command line type: edem.exe –-server
You can also specify the license server when using EDEM’s command line interface (the –console option). For full details, use the –h flag to display the EDEM command line help.
4
5
License Revocation
If you are upgrading from a previous version of EDEM, or are moving your license server to a new machine, you may need to revoke your existing license before installing the new license. Refer to the Installation Guide for more details.
1.1 Revoking a License on a Windows License Server Before you begin, be sure there are no licenses currently in use or checked-out as commuter licenses.
1. Log-on to the license server as Administrator or as a user with Administrator
permissions.
2. Start LM Admin from All Programs > DEM Solutions > EDEM > LM Admin.
3. From the LM Admin window, select Tools > Generate Revocation Password.
4. Enter a password of at least 8 characters. Keep a note of the password as you
will need it again later.
5. Click Generate to create a revocation password file. Save the file
(sntlPassword.dat ) to a directory of your choice.
6. Copy sntlPassword.dat to the license server directory:
C:\Program Files\DEM Solutions\EDEM 2.6\bin\LicenseManager 7. Select your license server from the list in the LM Admin window, then double-
click to view the license components.
8. Select and right-click the relevant component that you wish to revoke (e.g.
EDEMCore or EDEMAcademicCore ) then select Revoke License from the popup
menu.
9. Type the total number of EDEM licenses you have (as specified in the Maximum
Licenses Available field) as the Number of Licenses to Revoke .
10. Type your password (from Step 4 above) in the Revocation Password field. If you
have forgotten the password, click Close then restart the revocation process from the beginning.
11. Click Revoke then click Yes to confirm you want to revoke all licenses. A License
Revocation Ticket is generated.
12. Click the Save button then save the file as your_company_name-CORE.lrt
13. If you have to revoke all your license components, do the following steps,
otherwise go to Step 14:
a. Refer to the License Components table on page 3 to help determine
which other components you have.
b. For each component, repeat Steps 8 though 12. Save each ticket as
your_company_name-
14. Email the .lrt files to support@https://www.doczj.com/doc/6c16784097.html,
DEM Solutions will reply with your new licenses.
6
1.2 Revoking a License on a Linux License Server If you are revoking a license for EDEM
2.0 or earlier, refer to the instructions in the customer area of the DEM Solutions website. Otherwise, follow the instructions below.
1. Be sure you are logged in as root.
2. Change directory to the license server binary directory:
cd /opt/SentinelLM/bin
3. Add the required libraries to the environment:
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/opt/SentinelLM/lib/
4. Run the script to generate a revocation password:
./lsgenrvkpwd
5. When prompted, enter a password of at least 8 characters.
6. Save the password file (sntlPassword.dat ) to the current directory by entering
a single dot “.” when prompted for a directory location.
7. Run the script to revoke a license:
./lsrevoke
8. Type the name of your license server when prompted for the server name.
9. Type the name of relevant component that you wish to revoke (e.g. EDEMCore or
EDEMAcademicCore ) when prompted for the component name.
10. Type the version number to revoke when prompted for the component version.
For example, type 2.0
11. Type the total number of EDEM licenses you have as the number of licenses to
revoke. A License Revocation Ticket is generated.
12. Save the file as your_company_name-CORE.lrt
13. If you have to revoke all your license components, do the following steps,
otherwise go to Step 14:
a. Refer to the License Components table on page 3 to help determine
which other components you have.
b. For each component, repeat Steps 8 through 12. Save each ticket as
your_company_name-
14. Email the .lrt files to support@https://www.doczj.com/doc/6c16784097.html,
DEM Solutions will reply with your new license.
7
Troubleshooting EDEM License Problems
1.3 Troubleshooting a Windows License Server
1.3.1 Verify the License Server
To verify the license server is running correctly:
1. Start LM Admin: Start > Programs > DEM Solutions > EDEM
2.6 > LM Admin.
2. Select View > Refresh all.
3. Expand the subnet server display to view the license server on the local machine.
4. Verify the license details are as expected.
If your server is not listed in LM Admin:
1. Be sure the license service is running:
a) Select Start > Control Panel > Administrative Tools > Services.
b) Locate the EDEM License Server service in the Services window.
c) If the service status is not Started , right-click on EDEM License Server then
select Restart.
2. If the service is running and you are not using Windows Firewall, check your
firewall rules. Be sure your firewall is configured to accept UDP connections on port 5093 (even if both EDEM and the license server are on the same machine). Refer to your firewall documentation for details.
3. If the service is running, try adding it manually using Edit > Defined Server List.
4. If the service is not listed at all, re-install the license manager software:
a) Open the Add or Remove Programs window (Start > Control Panel >
Add/Remove programs).
b) Locate EDEM 2.6 then click Change.
c) Click Modify then select “Entire feature will be unavailable” for the License
Manager and License Tools.
d) Click Next to remove the license manager software.
e) Repeat the above steps, this time selecting the License Manager and License
Tools to be installed.
If the server is running but there are no license components listed, either the license file has not installed properly or the license server has not picked up the new components. If you still cannot see the license components, refer to the following troubleshooting sections.
8
1.3.2 Troubleshoot the Windows License Server
Unable to Add License File to Server
Check the license file formatting hasn’t been altered by your email client, the license file is a text based file so open it in a text editor (notepad.exe):
? Each license feature in the file should be on a single line, if they have been wrapped to shorter lines remove the extra spacing
? Copy a single license feature description from the file and add it to the server manually; Add Feature > From a String > To Server and its File
Missing or Incorrectly Named Files
Check that the following files exist:
C:\Program Files\DEM Solutions\EDEM 2.6\bin\LicenseManager\lservnt.exe
C:\Program Files\DEM Solutions\EDEM 2.6\bin\LicenseManager\lsmail.exe C:\Program Files\DEM Solutions\EDEM 2.6\bin\LicenseManager\md5chap.dll If any of these files are missing, re-install the EDEM License Manager.
Check the License Components Available
Verify that the license components are correct:
1. On the license server machine, start LM Admin: Start > Programs > DEM
Solutions > EDEM 2.6 > LM Admin.
2. Expand the License Server details then select EDEMCore or
EDEMAcademicCore . If neither of these components is listed, either an incorrect license file has been installed or the license file has been installed incorrectly.
3. Verify that the number of licenses and license start and end dates are correct:
If these details are correct and the problem persists, or if you are attempting
to run EDEM on a separate client machine, see
Troubleshooting a Windows Client
on page 10.
9
4. Repeat the above step for the EDEMCPU (or EDEMAcademicCPU ) component.
Usually, the number of CPU components should be at least as many as the
number of EDEMCore or EDEMAcademicCore components.
1.4 Troubleshooting a Linux License Server
Using the lsverify Troubleshooting Tool
Use the lsverify troubleshooting tool to resolve any license problems. As root, type:
# /opt/DEMSolutions/EDEM_2.6/bin/lsverify
Phase 1 - Checking EDEM/SentinelLM License installation...OK Phase 2 - Checking Installed License File...OK
Phase 3 - Checking server is running...OK
Phase 4 - Checking server visibility...OK
Phase 5 - Checking server details...OK
If you receive error messages, the lsverify script will suggest possible solutions. If none of the suggestions made by the script are effective, see Troubleshooting a Linux Client on page 11.
Note : You may need to set the LSHOST environment variable to run lsverify as root. If lsverify does not start, be sure it is installed and has execute permissions. If lsverify cannot detect any error, run the script with the debug logging option:
# /opt/DEMSolutions/EDEM_2.6/bin/lsverify -f
Send the created file (/tmp/edemlm_verify ) to EDEM Technical Support.
If you are unable to run EDEM from a client machine, see Troubleshooting a Linux Client on page 11.
Using Other License Troubleshooting Tools
There are two other license troubleshooting tools you may find useful, both in the bin directory:
lswhere – lists all license servers on the subnet.
lsmon [servername] – displays detail on all the licenses on the server indicated.
10
1.5 Troubleshooting a Windows Client
If the server is functioning correctly but you cannot retrieve a license to a Windows client: Check you are Connected to the Network
Be sure that you are connected to the LAN where the license server resides.
Check the License Server is Visible
Verify that you have a route to the license server machine by using a generic network utility such as ping .
Check you can Connect to the License Server
Use the LM Admin tool to verify that you can both see and connect to the license server.
1. Start LM Admin: Start > Programs > DEM Solutions > EDEM
2.6 > LM Admin.
2. Expand the Subnet Servers tree then select your server. If your server is on a
separate subnet:
a. Select Edit > Defined Server List.
b. Type your server name then click Add. Click OK.
c. Select View > Refresh all. Check your server is in the Defined Server list.
3. If your server is still not listed, be sure it is working correctly as described in the
server troubleshooting section.
Check you can Connect Using --server Option
Use the following command to start EDEM from the command line, replacing
edem.exe --server
This will start EDEM and it will attempt to connect to the specified machine and look for a running license server.
If you still receive an error message, contact EDEM Technical Support.
11
1.6 Troubleshooting a Linux Client
Check you can Connect Using --server Option
Use the following command to start EDEM from the command line, replacing
$ edem-2.6 --server
This will start EDEM and it will attempt to connect to the specified machine and look for a running license server.
Using the lsverify Troubleshooting Tool
If you are running your license server on a Linux system, use the lsverify
troubleshooting tool with the –c (for client) switch. As root, type:
# /opt/DEMSolutions/EDEM_2.6/bin/lsverify -c
If lsverify does not start, be sure it is installed and has execute permissions. If you need a copy of the tool, contact DEM Solutions technical support.
If lsverify cannot detect any error, run the script with debug logging:
# /opt/DEMSolutions/EDEM_2.6/bin/lsverify –c -f
Send the created file (/tmp/edemlm_verify ) to EDEM Technical Support.
1.7 Reclaiming Licenses After a Failure
If while running EDEM you have a power outage or your computer crashes
unexpectedly, a checked-out license may not be checked back in correctly.
Consequently, the license may be temporarily unavailable when you restart your computer.
To reclaim a license after a failure, either:
Wait for the license “heartbeat” to time-out (typically 15 minutes after the failure), or
Restart the license server. Do this only if you have a single-instance license. If you have multiple licenses in use, restarting the license server may cause
problems for other users as it will automatically reclaim all licenses. Check with your license users if you cannot wait for the heartbeat to time-out and need to restart the license server.
License Error Messages
Error Title Description and Solution
[3] Unknown license Server
Host The license server cannot be found on the current network. Check that the license server is available. See Specifying the License Server on page 4.
[5] Cannot talk to the
license server. Verify
license server is running There does not appear to be a license server running. Check that the license server is running and accessible. See Specifying the License Server on page 4.
[14] License server not
Responding Check that the network connection between the EDEM client the license server is available and that the License Server is running and accessible.
[17] No license servers found
on subnet No license servers have been detected. If the license server is on the local subnet, make sure that it is available.
[18] Feature not found on
license Server If there is more than one Sentinel LM server on your network, use the LM Admin tool to check you are using the correct license server. If there is only one license server, check it has the necessary EDEM components. Perform Server and then Client troubleshooting as described in this document.
[19] Failed to add license
code The code in the license component you are adding does not match the code expected for the license server. This may be because the license server machine was renamed or the license server was moved to a different machine (in other words, the host ID has changed). Reset the host ID back to what it was then add the component again.
[26] Request denied due to
clock tamper detection The system clock of the license server has been changed by an excessively large amount. Contact EDEM support.
[37] Trial license exhausted The duration or usage of a trial license is exhausted. If it is the
usage, try again later when a license may be available. If the
duration has expired, the license is no longer usable.
[79] Client already exists on
Server The server has a record of a commuter license already checked out to this client. This is probably due to a change in the system’s registry. To reclaim the license, wait for the commuter license to expire on the server (monitor using the LM Admin tool).
[109] Error in executing the
authentication plugin When revoking a license, be sure to save the password to the correct location. Refer to steps detailing where to save the password file in License Revocation on page 5.
This error can also be triggered by certain passwords, try a different password of a different length.
12