Introduction | Your first interface | Building a model | Advanced features | Resources

4.9 Deploying simulations

This section describes how to deploy a model so that it can run on a web server.

By default, when you deploy a simulation to the web, then the resulitng applet will display a small message telling the user that the content they are viewing is a simulation developed using the JeLSIM tools. If you wish to remove this message or protect your models so that others can not use them without permission then you need to use deployment keys.

The deployment process takes your model and prepares it to run on one or more web servers. Deployment exists so that models cannot be copied and re-used from the web - if someone tries to copy your simulations to their own server, they will not be able to run them without a licensing error being displayed and a delay. There may be a charge for deploying a simulation, but once it has been deployed, any number of additional interfaces based on the same model can be deployed to the same web servers at no additional cost.

Your simulations are protected using a deployment key, which is generated by JeLSIM. There are two steps to deploying a simulation:

  1. Generate a deployment request to obtain a deployment key from JeLSIM.
  2. Load the deployment key to deploy your simulation.

Generate a deployment request

When your simulation is ready to go live on the web, you can use the Deployment Manager (which is integrated within the Interface Builder) to generate a deployment request. The deployment request identifies the servers that the simulation will be able to run on and is used to generate a deployment key that will prevent anyone from running your simulations on unauthorised servers. To open the Deployment Manager, open the File menu and select Key Management / Request Key.

This will display the Key Request Tool.

The key request tool has three tabs: User Info, Host Selection and Model Selection.

The User Info. tab records your name, organisation and email address and is used to personalise your key. The email address is used to send the key back to you once a deployment has been requested.

With the Host Selection tab, you can add hosts (servers) where you want your simulation to be deployed. Known hosts refer to the servers that are in the system, and deploy hosts refer to those that the simulation is validated to run on (if the interface has previously been deployed, both of these lists may already have items in them).

When you add a new host, it will automatically be added to both lists, but hosts can subsequently be removed and moved between lists. When new hosts are added to the deploy list, you must generate a deployment request to get deployment keys to allow the simulation to run on these hosts.

The Model Selection tab allows you to select the model that the key will be generated for. A checkbox further allows you to protect your interface from third party editing.

To generate a deployment request file, click Generate Key Request, and the request will be automatically sent to JeLSIM. You must be online to generate deployment requests as a connection to our server is needed. Your deployment keys will be generated and sent back to you.

Load the deployment key

You will receive a file containing a deployment key for that simulation (it will have extension .mdk). The first thing to do is to Import the Key into the Interface Builder. Open the File menu and select Key Management / Import Key. Use the file dialog box to find the key and click open - the key will be imported into the key database.

To use the key for deployment, you must set it as the active key. Open the File menu and select Key Management / Select Active Keys. Select the relevant key (checking it's restrictions using the info tab if necessary) and press OK.

Once you've loaded the key file, the known host list and deploy host list will be populated with the names of the web servers that you have chosen to deploy to, you can now chose to click the Save to Web button. Once you press the button, you will be prompted for the name of the html file and the directory to which the simulation will be deployed. From this point on, deploying is exactly the same as saving to web.