Deploying Workflow Models

The Stardust Portal allows to deploy and overwrite models from the Model Management View. Models are deployed via the Deploy Model Wizard that is launched via the Deploy Model icon in the table toolbar and Actions column of the Model Management table.

Figure: Deploy Model

Note
In case you use non-ASCII characters in model element names, you have to add the property carnot.engine.xml.encoding to your carnot.properties file and set it to UTF-8. Otherwise you get an exception during the deployment.

Required Permissions

Note that if the requiredRoles attribute is not set to "Administrator" and you have no administrator rights, but have the permission to modify and deploy models, you also need the permission to manage daemons to be able to deploy models from the Model Management view. Refer to chapter Authorization Manager view for details on how to set this permission.

Deploying New Version

When launched via the Deploy Model icon in the table toolbar, the model or models deployed are deployed as new versions using current semantics.

To deploy the new version of the model:

Click the Deploy Model icon in the table toolbar. The Deploy New Model wizard gets displayed.

Figure: Deploy New Model

Click the Browse button and select the model you want to upload. Once the model is uploaded, following details of the uploaded model are provided:

• File - Provides the name of the uploaded model file.
• Deployment Action - Specifies the deployment action as Create New Version.
• Delete - Delete icon is provided if you choose to delete the uploaded file.

Figure: Deploy New Model Details

Note that administrator can upload a single file or zip file that contains multiple XPDL files. Deploying zip files is strongly recommended when referencing is used. In that case, references are automatically established.

You can also specify following deployment options:

• Valid From - The date from which the model is valid
• Ignore Warnings - Select the checkbox if you want to ignore warnings from server
• Deployment Comments - Add deployment comments

Click Deploy if you want to proceed with deployment or else click Cancel to cancel the deployment.

Figure: Deploy New Model

If the deployment is successful then the Deployment Status and warnings are displayed. In this case, if any of the models to be deployed do not have default values for any configuration variables, the Deploy Model (continued)- Missing Configuration Values dialog is displayed.

Figure: Missing Configuration Values

You can specify the values in the Value column for each missing configuration variable. This creates a consistent value set for Configuration Variables. Alternatively, an appropriate Preferences set can be uploaded prior to Model Deployment via the Configuration Variables View. For more information, please refer to the Viewing and Editing Configuration Variables chapter.

The Validate Variables dialog contains warnings for the default values. It also displays the validation warning for the wrong value of variable provided in the Missing Configuration Values dialog. Click Finish to proceed with warnings.

Figure: Validate Variables

If the deployment fails then the Deployment Status is displayed as icon along with errors and warnings. In this case, the model does not get deployed.

Figure: Deploy New Model - Errors and Warnings