Real-Time Workshop

Licensing Protocols for Simulink Solvers in Executables

The Rapid Simulation target supports variable step solvers by linking the generated code with the Simulink solver module (a shared library). When this rsim executable is run, it accesses proprietary Simulink variable step solver technology. In order to do so, the executable needs to check out a Simulink license for the duration of its execution.

Rapid Simulation executables that do not use Simulink solver module (for example, rsim executable built for a fixed-step model using the Real-Time Workshop fixed-step solvers) do not require any license when they run.

Note    The default setting of auto for the Solver selection option in the rsim code generation options page configures rsim to use the Simulink solver module only when needed (i.e., when the model uses a variable step solver).

The rsim executable will look in the default locations for the license file

• Unix: matlabroot/etc/license.dat
• PC: matlabroot/bin/win32/license.dat,

where matlabroot is the one use when building the rsim executable. If the rsim executable is unable to locate the license file (this may happen, for example,

if you run this executable on another machine, where matlabroot is no longer valid), it will print the following error message and exit:

• Error checking out SIMULINK license.
  
  Cannot find license file
  The license files (or server network addresses) attempted are
  listed below.  Use LM_LICENSE_FILE to use a different license 
  file, or contact your software provider for a license file.
  Feature:       SIMULINK
  Filename:      /apps/matlab/etc/license.dat
  License path:  /abbs/matlab/etc/license.dat
  FLEXlm error:  -1,359.  System Error: 2 "No such file or directory"
  For further information, refer to the FLEXlm End User Manual,
  available at "www.globetrotter.com".
  Error: Unable to checkout Simulink license
  Error terminating RSIM Engine: License check failed
  

Note    You can point the rsim executable to a different license file by setting the environment variable LM_LICENSE_FILE. The location pointed to by that variable will override the default location compiled into the rsim executable.

If the rsim executable is unable to check out a Simulink license (this would happen, for example, if all Simulink licenses are currently checked out), or has other errors when checking out a Simulink license it will display a detailed error message (similar to the one above) returned by the FLEXlm API and exit.

Introduction

Building for the Rapid Simulation Target