#rev 2020-08-31 alders

= How to debug licensing problems =

== Make sure that the license server is actually running. ==
See [[https://ueberwachung.ethz.ch/skoor-dashboard-viewer/#/dashboards/flat_service?service=1404&serviceName=Lizenzen&logKey=LIZENZ|ID License Server Status]] to get an overview all license servers hosted by ID.

== What licensing mechanism is used for your problematic software? ==
A lot of software you can order via IDES use a network licensing mechanism. That means that a client that wants to use some software first needs to ask the license server if there is a free license available. There are several software implementations for network licensing. The most prominent one is '''FLEXnet'''. If you ordered a license via IDES and the license email from IDES states that you have to enter some '''port''' and '''license server''' information during installation, the licensing system used is probably FLEXnet. An example is '''MATLAB'''.

== FLEXnet license debugging ==
What you need:

 * The name and port of the license server.
 * The `lmutil` command line tool.

== Port and license server name ==
You will find these information in the email you got from IDES after ordering the software. If you did not order the software by yourself (e.g. if you work on a machine not managed by you), you might find that information
 * through a menu entry of the application
 * in the installation folder of the software
 * in the registry (if you are running a Microsoft product)
 * in an environment variable

== lmutil ==
This software is installed on any Linux workstation (tardis-whatever). So please just log in to on of these in order to debug FLEXnet licensing problems.

== Usage of lmutil ==
If you run `lmutil help` it will print out a list of options. If you want to know the details of, e.g., the `lmstat` option, just run `lmutil lmstat help`. Here are some examples (just replace PORT and SERVER with the corresponding information for your software):

 * lmutil lmstat -c PORT@SERVER -a
 * lmutil lmstat -c PORT@SERVER -i
 * lmutil lmstat -c PORT@SERVER -f
 * lmutil lmdiag -c PORT@SERVER -n
----
[[CategoryLICS]]