WOLFRAM

Wolfram Language & System Documentation Center
Running WSMLink in a Server Environment

Running WSMLink in a Server Environment

As of Version 11.3, most of the functionality of the WSMLink package is being phased out in favor of experimentally introduced functionality in the Wolfram System. »

It is possible to run WSMLink in a server environment or an environment without a graphical desktop environment like X. This can be used to deploy System Modeler on Linux machines running, for example, in a cloud or server environment.

Installation

To install System Modeler, execute the installer from a command line, the same way as in a desktop environment.

Configuration of WSMLink

The Wolfram Language package for System Modeler, WSMLink, can be set up to work with the Wolfram Language by changing into the binary directory for System Modeler, which might look like the following.

cd /usr/local/Wolfram/SystemModeler/5.0/bin

Then run the following command to configure WSMLink.

./SessionManager --configure

The command outputs a log with details on the configuration process in the terminal.

Activation of System Modeler

To activate System Modeler through a command line, start a WolframKernel.

WolframKernel

Then evaluate the following command.

In[1]:= WSMSimulate

The result will be something similar to the following.

WSMLink::kna: System Modeler kernel initialization error: License Error: 
    Invalid license or no license for System Modeler Link.
    Use WSMLink`Library`ActivateWSM["activation_key"] to activate. Your MathID is 1234-12345-12345.

WSMLink::mmna: Unable to start or establish a connection to the System Modeler kernel.

Out[1]= $Aborted

You can then evaluate the activation command to activate with online activation (using an activation key).

In[2]:= WSMLink`Library`ActivateWSM["1234-1234-123456"]

You can also do offline activation (using an activation key and a password).

In[2]:= WSMLink`Library`ActivateWSM["1234-1234-123456","1234-123-123"]

If you have a MathLM server, you can activate against that instead.

In[2]:= WSMLink`Library`ActivateWSM["my.mathlm.server.com"]

Upon successful activation, the output should be similar to the following.

WSMLink::restart: Activation successful. Restart WolframKernel and 
    load the package again to start using WSMLink.

Out[2]= True

You can now evaluate Quit[] to close the WolframKernel.

System Modeler is now successfully activated and the installation is ready for use. Any new WolframKernel should now be able to use WSMLink functionality.