Configuring the Scheduler in JBoss

<< Click to Display Table of Contents >>

Navigation:  Bizagi Engine > Bizagi system administration > Bizagi server configuration > Bizagi Engine JEE platform configuration > Configuring a JEE application server to work with Bizagi > JBoss configuration > Clustered JBoss configuration >

Configuring the Scheduler in JBoss

Overview

In environments with high availability is demanded, and where the solution is set up in a cluster, Bizagi offers the possibility of a manual Scheduler service configuration in order to:

Have this service rely on fault tolerance (so that the service can be executed on any node of the cluster).

Have management options to start, stop or restart the service in an independent manner (possible anytime).

 

 

Prerequisites

To configure the Scheduler service in JBoss, ensure you meet the following prerequisites:

Have already configured Bizagi in JBoss.

For more information about this, refer to Clustered JBoss configuration.

Have at hand the configuration files (used to deploy Bizagi) which are required for the JEE edition (BizAgi-ear-JBoss-dist.zip). These files need to be unzipped in a local path, as referred to in the steps describing how to configure JBoss to work with Bizagi. This path will be referenced as <CONFIGURATION_INPUTS> from this point on.

 

 

Configuration

Locate the <CONFIGURATION_INPUTS>/BizagiSchedulerService/ path in which configuration files where configured.

 

1. In this path, and inside the bin folder, configure the following properties file scheduler_configuration.properties

For this, consider:

 

bizagi.scheduler.timer: Property used to indicate timer the time interval in which the scheduler should run in Bizagi. The default value is 30 seconds.

bizagi.scheduler.connection.port: The port number assigned to the service by which requests are received. By default the value assigned is 5681.

bizagi.scheduler.remote.connection.retries: property that defines the maximum number of retries to establish communication with the application server ,in case of a connection problem. By default the assigned value is 3.

 

 

2. Configure the properties file custom_jndi.properties

java.naming.factory.url.pkgs: property for Bizagi exclusive use that defines the context of the client component (jboss-client) that will be used to communicate with the application server. The value of this property is:
org.jboss.ejb.client.naming

ejb.remote.jndi: property for Bizagi exclusive use to specify the address (JNDI) is used to access remote Scheduler service on the JBoss application server. The value of this property is:
ejb:BizAgi-ear-JBoss/bizagi-scheduler//BizAgiSchedulerBean!com.vision.bizagi.scheduler.BizAgiSchedulerRemote

 

3. Configure the custom properties file custom-jboss-ejb-client.properties:

endpoint.name: property for Bizagi exclusive use, must take the value "client-endpoint".

remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED: property for Bizagi exclusive use and must take the value "false".

remote.connections: Connection name. By default the assigned value is "default".

remote.connection.default.host: Name or IP address of the application server.

remote.connection.default.port: Port number assigned to the application server to handle RMI requests.

remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS: property for Bizagi exclusive use and must take the value "false".

 

Properties required in the configuration of a distributed environment: This set of default properties are disabled (#).

 

remote.clusters: Name used in the configuration of the domain controller to specify the EJB cluster. By default the value assigned is "EJB".

remote.cluster.ejb.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS: property for Bizagi exclusive use and must take the value "false".

remote.cluster.ejb.connect.options.org.xnio.Options.SSL_ENABLED: property for Bizagi exclusive use and must take the value "false".

remote.cluster.ejb.username:  If the application server has application-level security configured for communication with external components, specify the name for the user created.

remote.cluster.ejb.password:  If the application server has application-level security configured for communication with external components, specify the name for the user created.

 

 

Service operation

Keep in mind that for the Scheduler's execution, you need to have previously defined these required environment variables: bizagi.cache.multicast.enabled, bizagi.cache.multicast.address, bizagi.cache.multicast.port, and bizagi.cache.multicast.type (as described under the environment variable configuration section when configuring WebSphere to work with Bizagi in a cluster).

 

To start the service, run the start-service as an administrator.

 

In a Unix-like OS such as Linux, this file is located as:

<CONFIGURATION_INPUTS>/BizagiSchedulerService/bin/start-service.sh

In a Windows OS, this file is located as:

<CONFIGURATION_INPUTS>\BizagiSchedulerService\bin\start-service.bat

 

This operation creates a javaw.exe process which keeps running using the port (by default 5681), as configured in the scheduler_configuration.properties.

 

 

To stop the service, run the shutdown-service as an administrator.

 

In a Unix-like OS such as Linux, this file is located as:

<CONFIGURATION_INPUTS>/BizagiSchedulerService/bin/shutdown-service.sh

 

In a Windows OS, this file is located as:

<CONFIGURATION_INPUTS>\BizagiSchedulerService\bin\shutdown-service.bat