A Dymola license can in some cases be used to run an exported model, this is referred to as the Dymola Runtime concept and is examined in this post. The information regarding setting up the Runtime license was obtained from the Dymola User Manual.
When would the Dymola Runtime concept be required?
Dymola can export models in a number of different ways, for example:
- A dymosim executable
- An FMU
- A DymolaBlock in Simulink®
If the model is exported with the Binary Model Export or the Source Code Generation license active, then the exported model can be simulated on any machine without a license (see Exporting Models & Licensing – Claytex and Dymola license server for novices – Claytex for more details). However, when a model is exported from Dymola without these licenses, then the Dymola Runtime concept is required to use the exported model on a PC that has a Dymola license.
Note: An FMU generated with a Dymola solver (i.e. DASSL, Radau, etc.) requires a Binary Model Export license to execute.
How do you know your model requires the Dymola Runtime concept
Trying to run exported models that require licensing will result in errors like the one below:
The license file was not found. Use the environment variable "DYMOLA_RUNTIME_LICENSE" to specify your Dymola license file.
The error message above is generated when a model exported as an FMU was simulated. Similar error messages are generated when a DymolaBlock or dymosim.exe is simulated.
Setting up the Dymola Runtime concept
All that is required is that an environment variable called DYMOLA_RUNTIME_LICENSE is created that points to the Dymola license if a node locked license is being used or to the license server if a FlexLM license server is being used. Note the DSLS (Dassault Systèmes License Server) does not currently support the Dymola Runtime concept.
Setting the DYMOLA_RUNTIME_LICENSE environment variable
To find the location of the Dymola license, go to Tools>License Setup>Setup and take note of the license location or the license server locations as in Figure 1:
Figure 1. Dymola License Setup with the node locked license location.
So, in this case the environment variable can be set using Windows “System Properties>Environmental Variables” or the Windows CMD window for example:
set DYMOLA_RUNTIME_LICENSE=C:/Users/<Username>/AppData/Roaming/DassaultSystemes/Dymola/dymola.lic
Where <Username> is the Windows username.
In the case where a FlexLM license is being used the environment variable could be set for example like this:
set DYMOLA_RUNTIME_LICENSE=27000@my.server.com
Where 27000 is the port number and my.server.com is the FlexLM server URL. Note that the Dassault System license server currently does not support the Dymola Runtime concept.
To set the DYMOLA_RUNTIME_LICENSE environment variables in Linux, see How to Set an Environment Variable in Linux for further details.
Please contact your Dymola reseller for further assistance if there are further issues with the Dymola Runtime concept.
Written by: Garron Fish – Chief Engineer
Please get in touch if you have any questions or have got a topic in mind that you would like us to write about. You can submit your questions / topics via: Tech Blog Questions / Topic Suggestion
