On this page

If you work with Teamwork Cloud projects, you can simulate them on the server without using a modeling tool. You can execute your models using REST API, or the Cameo Collaborator for Teamwork Cloud user interface (if there are Cameo Collaborator documents published from those models). You can also run your models using the Resources application and Python client (pyST.py).

The following demo shows the server-side simulation in action:

System requirements

The following Web Application Platform system requirements apply to a single server-side simulation. If you set up an environment where you can run concurrent server-side simulations, different system requirements will apply.

Web Application Platform system requirements for server-side simulation:

  • Simple non-iterative simulation:
    • 1-core CPU
    • 1GB of RAM
  • Simple iterative simulation:
    • 2-core CPU
    • 1GB of RAM
  • Complex, time-consuming simulation:
    • 4-core CPU
    • 2GB of RAM

Installation information

The server-side simulation service is installed automatically alongside Web Application Platform while using Teamwork Cloud or Magic Collaboration Studio installer. If you install Web Application Platform on a separate machine and use the Advanced Install option, select the server-side simulation service during installation. To learn more, refer to Web Application Platform Installation on a separate machine. 

The server-side simulation service is one of many Web Application Platform services provided as a separate application.

To install the Server-side simulation

  1. Install Web Application Platform.
  2. Open the <wap_install_root>\apache-tomcat\shared\conf\webappplatform.properties file and set the sim.license.checkout property to true.
  3. If the Web Application Platform is installed on a separate machine, set the portfolio.name property to Magic Collaboration Studio in the webappplatform.properties file.
  4. Restart Web Application Platform.

Licensing information

The server-side simulation functionality only works with a floating Magic Model Analyst license managed by the FlexNet license server.

Preparing projects for server-side simulation

To simulate a project on the server, it must meet the following criteria:

  • A project has to be added to Teamwork Cloud.
  • For simulation results to be saved, you need to specify the Result Location property of a Simulation Configuration.

Required permissions

To perform server-side simulation, you need to have the following Teamwork Cloud permissions:

  • Read Resources - allows you to simulate resources.
  • Edit Resources - allows you to commit the simulation results to a resource.

  • Manage Simulations - allows you to manage all simulations, including the ability to get and review simulation results and terminate simulations executed by other users.

If you want to be able to manage all simulations, in addition to the Manage Simulations permission, you also need to have the Read Resources permission for the related resources.

Server-side simulation limitations

There are several limitations related to server-side simulation:

  • Project options cannot be read, so default option values are always used instead of the actual ones.
  • Math engine integrations (Matlab, Mathematica, etc.) are not available.
  • FMU/FMU co-simulation with Windows binaries is not available.
  • UseCase Execution is not available.
  • DSL stereotypes are not applied to created Slot and InstanceSpecification elements.
  • Finding elements by Name (e.g Signals, Operations with ALH, mapping with ExcelHelper) is not available.

Related pages