Scripts to run the Application

In this section scripts to manage the Web Application will be explained.

Prerequisites:

  • GemStone/S installed and running

  • BPM application installed.

For more technical information about Gem processes used in these scripts see:

https://github.com/GsDevKit/gsApplicationTools/blob/master/docs/gettingStarted.md

Prerequisites:

The scripts/shell commands can be found in $GS_HOME/shared/repos/BpmFlow directory.

In order to use these scritps the Shell session must have defined the environment variable [GS_HOME]. To set this variable the following bash code can be executed:

export GS_HOME=/home/gemstone/GsDevKit_home
export PATH=$GS_HOME/bin:$PATH

Where [gemstone] is the name of the Linux user and [GsDevKit_home] is where GemStone/S DevKit has been installed.

List of Scripts

The whole project is installed at: /home/linux-user-name/GsDevKit_home/shared/repos/BpmFlow

There are six scripts or shell command in order to manage the Web Application:

register-application.sh To register the application to run, this shell command has to be executed only once. This script read data in ports-all.ini file and register all ports in this file. For example if ports-all.ini has the following content: 8787,8888,8989

This will register the Web Application to be used in ports: 8787,8888,8989. Comma is used to separate ports. The ini's files are in the same directory as the scripts.

unregister-application.sh To unregister application, this shell command has to be executed only once. And is used if you want to uninstall the Web Application.

start-all.sh This command will start a multi-thread Web Application Server where each port will be attended by a different (Gem) process. Following the previous example three Gem processes will be created to attend each port. The ports to be attended are defined in ports-all.ini. At registration time (register-application.sh) there is a list of ports in ports-all.ini and each will be active when this script is executed. After executing this script some pid and log files will be create at $GS_HOME/server/stones/devKit_34/logs/. In this case is the path includes devKit_34 because the Stone was created with that name. The pid and log files will be like BPM_server-8787.log and BPM_server-8787.pid. A pair of these file will be create per each port defined in ports-all.ini.

stop-all.sh This command will stop all Gem processes serving the Web Application on all ports. The Web Application will no longer answer http requests.

start-zn.sh This command is similar to [start-all.sh] but instead of starting a Gem Process for each port it only start a subset of all ports. The subset is defined in [zn-ports.ini] file.

stop-zn.sh This command is similar to [stop-all.sh] but instead of stop all Gem Process in each port it only stop a subset of all ports. The subset is defined in [zn-ports.ini] file.

start-timers-loop.sh This command will start a Gem Process to process all Timers in the system and should be execute only once.

start-deferred-scripts-loop.sh This command will start a Gem Process to process all deferred Scripts in the system and should be execute only once.

More about Timers here: Timers