LSPS documentation logo
LSPS Documentation
Model Execution

Once you have designed a module, you can upload it to an LSPS server and run it. Note that only a module that is executable can be used to create a model instance.

To upload modules from Designer, first connect Designer to a server with LSPS Application Once you have established the connection, you can upload a model to the server and execute it.

From Designer, you can run your model in debug mode on the server you are connecting to presuming the underlying JVM runs in debug mode and check performance using profiler.

You can use also the command-line console as well as the Management Console to deploy and instantiate your model. However, you need to export your Model as a deployable bundle first.

When you upload a module with a data model that contains persisted data structures (shared Records), the tables for the related data is created in the database. If you modify the shared Records and pertinent relationships, and upload the module with the same name and version again, the already existing tables need to be adjusted. Therefore, whenever you are uploading or running a module, you need to define, how such situations are handled:

  • Do not change: data-model tables remain unchanged.
  • Update by model: New tables, columns and relationships are added; no data is deleted.
  • Validate: data-model tables are validated against the new model. In case of inconsistencies, the model upload or launching fails.
  • Drop and create modeled DB tables: data-model tables are dropped and created anew.

Important: The Database Schema Update Strategy setting does not impact LSPS runtime information, such as, data on uploaded models, model instances in the current execution status, persons details, etc. and the data remains unchanged regardless of the setting. Only tables based on module data models are subject to the strategy.

Server Connection from Designer

Designer connections to LSPS servers are set under Server Connections > Server Connection Settings. The connections to Designer and SDK embedded servers are added automatically when the servers are generated: For the Designer Embedded Server, when first started and for the SDK Embedded Server, when the LSPS Application is generated. Other connections must be configured manually.

Connecting Designer to an LSPS Server

To connect Designer to a server with LSPS Application other than Designer or SDK Embedded Server, do the following:

  1. Set up the connection configuration:
    1. On the menu bar, under Server Connections, click Server Connection Settings.
    2. In the Server Connections part of the Preferences dialog box, click Add and define the connection settings:
      • Server name: arbitrary name of the connection
      • Server URL: URL of the server instance to connect to (for example, for the Designer Embedded server http://localhost:8080)
      • User and Password
      • Application URL: URL to the LSPS Application on the server
      • Default Database Schema Update Strategy: the strategy which is set by default on configurations of module upload and configuration of model run: The configurations are used when uploading and running modules from the Modeling perspective and are created when the module is run or uploaded for the first time from the Modeling perspective For further details, refer to database schema strategy description.
    3. Click Test Connection to make sure the settings are correct.
    4. Select the connection to connect to Designer to the server.
      remoteServerConfig.png
      The remote connection set as preferred
  2. If required, define a proxy server for your connection.
  3. To change the connection, go to Server Connections > Select.

Connecting Designer to an LSPS Server using a Proxy Server

To use a proxy server to connect from Designer to an LSPS Server, do the following:

  1. Go to Window > Preferences.
  2. In the Preferences dialog, go to General > Network Connections
  3. Set the Active Provider option:
    • Direct: no proxy server
    • Manual: as defined in Proxy entries below

      You can define in the Proxy bypass table, the hosts that should be excluded from the proxying.

    • Native: as defined by the operating system
  4. Click apply.
  5. To connect to the server, go to Runtime Connections > Select and select the connection.

Connecting Designer to Designer Embedded Server

The Designer Embedded Server is a locally running server installed in the current workspace with the LSPS Application already deployed and an embedded database.

To install and launch a Designer Embedded Server, and to connect Designer to it, do the following:

  1. Go to Server Connections -> LSPS Embedded Server.
  2. Select Start: Designer will install the server, run it, and connect to it.
    pdsEmbeddedConnection.png
    Server Connection page of the Preferences dialog box with connection to Designer Embedded Server as default
    Alternatively, click the Start Embedded Server ( ) button on the main toolbar.

The server is installed in the .LSPSEmbedded directory of your workspace. To reinstall it, delete the directory and start the server again.

Loading and Resetting Database of Designer Embedded Server

The content of the LSPS database includes the runtime information, such as uploaded models, model instances in the current execution status, persons details, etc. Before you reset the database consider exporting it so you can load it if necessary. When resetting the database, all data is lost.

To save, restore, or reset the LSPS Embedded Server database, do the following:

  1. Stop the Embedded Server.
  2. Under Server Connections, select LSPS Embedded Server and Database Management.
  3. In the Embedded Database Management dialog box:
    • Select a database name and click Load to restore a database.

      Important: If a database is restored, the current database goes lost.

    • Click Save and provide the database name in the displayed dialog box to save the current database.
    • Click Reset to erase the database.

Configuring Mail Server on Designer Embedded Server

For configuration of mail sessions for Designer Embedded Server, which is a WildFly server, use the server web console at localhost:9990/ (if you have not done so yet, create a user using add-user.sh or add-user.bat in <WORKSPACE>.LSPSEmbedded/wildfly-<VERSION>/bin).

How to configure mail servers for your deployment environment is documented in the Deployment and Configuration guide: locate the information within the section for your server and for your SDK Embedded Server in the LSPS Application Customization guide.

Model Upload

When you upload a module, the module and all its imported modules are uploaded to the LSPS Server of the server to which Designer is connected. An uploaded module is identified by its name and version and if a module with the given name and version is already present on the LSPS Server, its is replaced.

You can upload your modules to your LSPS Server from the Modeling perspective or from the Management Perspective. The upload is performed based on the upload configuration: when you are uploading a module for the first time, Designer automatically creates an upload configuration, which is then used for upload.

When uploading a Module from the Modeling Perspective, the target server is by default the Embedded LSPS Server. To change the target server, go to Server Connections > Server Connection Settings and in the dialog select the default LSPS Server.

Uploading a Module from the Modeling Perspective

Note: Ensure that the server with LSPS Server is running and your Designer is connected to it (Information on the current connection is in the line at the bottom of Designer).

addresslineWithConnection.png
Address line with connection established
To upload a module for the first time, do the following:

  1. In GO-BPMN Explorer, right-click the module.
  2. In the context menu, click Upload As > Model.

This creates an upload and run configuration, which is used for the next upload and run of the module from the Modeling perspective: To adjust the configuration, do the following:

  1. Go to Run > Run Configuration or Upload Configuration.
  2. Select the configuration under Model.
  3. Adjust the properties of the configuration in the tabs on the right.
runuploadconfiguration.png
Run and upload configuration for the main module

Uploading a Module from the Management Perspective

Note: Ensure that the server with LSPS Server is running and your Designer is connected to it (Information on the current connection is in the line at the bottom of Designer).

addresslineWithConnection.png
Address line with connection established
To upload a module to the LSPS Server to which your Designer is connected, do the following:

  1. Display the Module Management view (in the toolbar, click the Management Views button ( ) and click Module Management).
  2. In Module Management view, click the Upload ( ) button.
  3. In the Model Upload dialog box define the model details. Every model has to be valid (the system validates it on upload); otherwise uploading fails.
  4. Click OK. The selected Model is uploaded to the current LSPS Server.
  5. If you selected the Do not execute schema update scripts flag, the scripts are available in the Schema Update Scripts tab of the Module Management view. Double-click the respective row to have the script displayed.

You can check the list of uploaded Modules in the Module Management view.

Model Instantiation

Once you uploaded an executable module with its module imports to an LSPS Server, you can run it as a model instance.

Typically, you will create model instances from Management Console or the Management perspective, but Designer allows you to upload and create model instances directly from your workspace.

When you create a model instance, the LSPS Server creates a runtime version of the model. Each model instance is created with a unique ID and optionally a set of initialization properties in the form of key-value pairs. These can include a special property, process entity, which is an id of a shared record and represents the data that the model instance works with.

For information on Model instance lifecycle, refer to the GO-BPMN Modeling Language User Guide.

Creating a Model Instance from the Management Perspective

To create a model instance of an uploaded Model from the Management perspective, do the following:

  1. In the main toolbar, click the arrow in the Management Views ( ) button and select Model Instances.
  2. In the toolbar of the displayed Model Instances view, click Create ( ).
  3. In the Model drop-down box of the Model Instance Creation dialog box, choose a model, and click OK.
  4. If necessary, in the Properties table, edit the key-value pairs attached to the model instance.

Note: If a Model instance remains in the status Created, check the Error Log for errors. Error Log may contain also error entries of the server if these were caused by a Designer feature, which appear primarily in the Console view.

errorlogview.png
Error Log with error entries
creatingModelInstance.png
Creating a model instance based on an uploaded executable module

Creating a Model Instance from the Modeling Perspective

Note: Ensure that the server with LSPS Server is running and your Designer is connected to it (Information on the current connection is in the line at the bottom of Designer).

addresslineWithConnection.png
Address line with connection established
To instantiate a model of a module for the first time, do the following:

  1. In GO-BPMN Explorer, right-click the module.
  2. In the context menu, click Run As > Model.

This creates an upload and run configuration, and instantiates the module. Next time you run the module from the Modeling perspective, the created configuration is used.

To adjust the configuration, do the following:

  1. Go to Run > Run Configuration or Upload Configuration.
  2. Select the configuration under Model.
  3. Adjust the properties of the configuration in the tabs on the right.
runuploadconfiguration.png
Run and upload configuration for the main module