Welcome Guest! Log in
Stambia versions 2.x, 3.x, S17, S18, S19 and S20 are reaching End of Support January, 15th, 2024. Please consider upgrading to the supported Semarchy xDI versions. See Global Policy Support and the Semarchy Documentation.

The Stambia User Community is moving to Semarchy! All the applicable resources have already been moved or are currently being moved to their new location. Read more…


This article is a Work In Progress. We might also change its structure and category soon.
Please feel free to suggest improvements at the bottom of the page.

 

This article provides a few ideas for controlling a Runtime's status.

Using the startcommand utility

The Runtime comes with a startcommand utility. It is a script (.bat for windows, .sh for Linux/Unix).

The idea is to check the Runtime's services status with this command:

D:\apps\stambia\stambiaRuntime_Service>startcommand "connect to localhost port 42070;get services"
D:\apps\stambia\stambiaRuntime_Service>echo off
Connecting to localhost on port 42070
Connected
Name      Status  Duration
rmi       Running 23:11:34.392
rdbms     Running 23:11:35.95
execution Running 23:11:34.548
soap      Running 23:11:32.847
listener  Running 23:11:34.548
scheduler Running 23:11:33.628
D:\apps\stambia\stambiaRuntime_Service>echo %ERRORLEVEL%
0

 

In this example, the output indicates that all the Runtime's services are "Running".

The return code (%ERRORLEVEL% in Windows, $? in Linux) of the startcommand script is 0 when the Runtime is up, or -1 when the Runtime is down.

You can also specify which service you want to check, and format the output:

D:\apps\stambia\stambiaRuntime_Service>startcommand "connect to localhost port 42070;get services name rmi format '%status'"
D:\apps\stambia\stambiaRuntime_Service>echo off
Connecting to localhost on port 42070
Connected
Running

Executing a specific process

It can be useful to develop a specific process which will check what is necessary in your very own use cases.

For example, you can design and execute a process which makes use of FTP actions, SendMail actions, Write files, SQL To Parameters... in order to check that the Runtime is able to work with the underlying servers in your architecture. And at the end of the process, you can imagine sending an email or update a flag somewhere to confirm that everything's up and running.

 

 

Articles

Suggest a new Article!