HowTo: Deploying a Workflow-based Application

Official Content
This documentation is valid for:

To deploy a Workflow-based application, you need to deploy it from the IDE as any other GeneXus application and export the set of business process diagrams.
The complete process consists of three components: the binary files, the database/metadata, and the protection.

Deploy binary application files

GeneXus provides a simple mechanism to package the generated files and deploy the application.

  1. Go to Build > Deploy application on the toolbar. This action will display a contextual window in the main section of the IDE.
  2. Drag every BPDiagram from the KB Explorer and drop them inside the "objects to deploy" form.
    It is not necessary to include every dependency of the BPDiagram (such as Web Panel, Procedures, etc.), GeneXus will include them on the package without showing them on the dialog.
  3. Set your preferred options and deploy it.
    Refer to this document for detailed information.

Note: If you want not to include the GXflow backoffice you can use the Include GXflow backoffice property.

Update application database and metadata files

GeneXus's Business Process Deployer tool makes it possible to impact the production database with the new workflow processes or with the changes made to the existing ones.

  1. Go to Tools menu > Workflow > Create business process deploy file to export the BPDiagrams.
  2. Open the BPDeployer and import the generated file.
    Refer to this document for detailed information.

In the production environment, workflow processes are always impacted by new processes. This fact means that the process instances that were still running will be based on the definition of the process previous to the impact. In other words, the changes made in the impact won't take effect to the running processes, only processes created after the impact is made will have the new definition.

Protection settings

When the application is ready to be deployed in a server, the protection must be updated with it.

GeneXus 15 Upgrade 8 or higher

Since the introduction of the new GXflow license scheme in GeneXus 15 Upgrade 8, the license setup becomes a very simple task. Use the GXflow license manager to install the licenses. The process is the same for any platform.

GeneXus 15 Upgrade 7 or lower

The instructions to achieve the licenses set up depends on the platform that will be executed.

Windows platform

  1. Install GXflow Production Environment.
  2. Go to Start > All Programs > GXflow GeneXus 15 > License Manager and install licenses.
  3. Copy the "protect.ini" file that resides in C:\Program Files (x86)\GeneXus\GXflow\GXflowGx15\LicMgr to:                                                                      "C:\Windows\System32"   folder and    "C:\Windows\SysWOW64"    folder.
  4. Install GeneXus Protection Server.
  5. (Only for Java) Copy and extract this file to the Tomcat´s lib directory (by default in C:\Program Files\Apache Software Foundation\Tomcat X.Y\lib).
  6. Go to Start > All Programs > GeneXus 15 Business Process Deployer and deploy the processes.
  7. Refer to this document for the instructions.

Linux platform

Follow these steps: HowTo: Configuring Protection for GXflow Installed on Linux, AIX and OS400 to install the licenses on the same server as the application.
Or please follow these steps: GXflow centralized licenses configuration (GXflow on Linux) when the licenses will be installed on a remote server (if the licenses are installed remotely, the server must be Windows).

IBM iSeries (AS400) platform

Follow these steps: HowTo: Configuring Protection for GXflow Installed on Linux, AIX and OS400 to install the licenses when will be installed on the same server as the application at an AS400 server.