Installing the Runtime - in a CentOS 7 server

Installing Java 8

[support@centos7vm ~]$ sudo yum install java
...
[support@centos7vm ~]$ java -version
openjdk version "1.8.0_191"
OpenJDK Runtime Environment (build 1.8.0_191-b12)
OpenJDK 64-Bit Server VM (build 25.191-b12, mixed mode)

Installing the Runtime

[support@centos7vm opt]$ ls -l
total 46348
-rw-r--r--.  1 root root 47454806 Dec 21 16:16 stambiaRuntime_S17.6.3_20181220_113216.zip
[support@centos7vm opt]$
[support@centos7vm opt]$ sudo unzip stambiaRuntime_S17.6.3_20181220_113216.zip
inflating...
[support@centos7vm opt]$
[root@centos7vm opt]# ls -l
total 46348
drwxr-xr-x. 13 root    root   4096 Jan  8 10:51 stambiaRuntime
-rw-r--r--.  1 root    root    47454806 Dec 21 16:16 stambiaRuntime_S17.6.3_20181220_113216.zip

You can adjust the file owner and permission to your security policy, for example :

[support@centos7vm opt]$ sudo chown -R stambia:stambia stambiaRuntime
[support@centos7vm opt]$ sudo chmod 755 stambiaRuntime/*.sh

At this point, take the time to configure your Runtime (ports, log database, security options...) in /opt/stambiaRuntime/properties/engineParameters.xml.

Also add your JDBC drivers and addons to /opt/stambiaRuntime/lib

Declaring the Runtime service in systemd

Create a systemctl service file, for example /etc/systemd/system/stambiaRuntime.service :

[Unit]
Description=Stambia Runtime
After=network.target

[Service]
Type=simple
Restart=always
RestartSec=5
User=support
WorkingDirectory=/opt/stambiaRuntime
Environment=STAMBIA_JAVA_HOME=/home/stambia/java/jre1.8.0_151
Environment="STAMBIA_HOME=/opt/stambiaRuntime"
ExecStart=/opt/stambiaRuntime/startengine.sh

[Install]
WantedBy=multi-user.target

 Please consult your Linux Distribution documentation for more information on systemd and how to configure this file to match your needs and requirements.

Operating the service

[support@centos7vm stambiaRuntime]$ sudo systemctl start stambiaRuntime
[support@centos7vm stambiaRuntime]$ sudo systemctl restart stambiaRuntime
[support@centos7vm stambiaRuntime]$ sudo systemctl stop stambiaRuntime
[support@centos7vm stambiaRuntime]$ sudo systemctl status stambiaRuntime

 

Checking the Linux service status

[support@centos7vm log]$ sudo systemctl status stambiaRuntime
[sudo] password for support:
● stambiaRuntime.service - Stambia Runtime
   Loaded: loaded (/etc/systemd/system/stambiaRuntime.service; disabled; vendor preset: disabled)
   Active: active (running) since Fri 2018-12-28 13:50:42 CET; 11min ago
 Main PID: 3630 (startengine.sh)
   CGroup: /system.slice/stambiaRuntime.service
           ├─3630 /bin/sh /opt/stambiaRuntime/startengine.sh
           └─3633 java -Xms32m -Xmx512m -Xss256k -Dstambia.classpath.v1.root= -classpath /opt/stambiaRuntime/.:/opt/stambiaRuntime/lib/comdcom:/opt/stamb...

Dec 28 13:50:46 centos7vm startengine.sh[3630]: 28/12/2018 13:50:46,380 - Runtime version: s17.6.3_20181220
Dec 28 13:50:46 centos7vm startengine.sh[3630]: 28/12/2018 13:50:46,381 - Java version: 1.8.0_191 vendor: Oracle Corporation home: /usr/lib/jvm/j...6_64/jre
Dec 28 13:50:47 centos7vm startengine.sh[3630]: 28/12/2018 13:50:47,287 - Internal Database is started: 192.168.75.134:42100
Dec 28 13:50:47 centos7vm startengine.sh[3630]: 28/12/2018 13:50:47,350 - Internal Database Web Server is started: http://192.168.75.134:42101
Dec 28 13:50:50 centos7vm startengine.sh[3630]: 28/12/2018 13:50:50,902 - RMI server is started: rmi://192.168.75.134:42000
Dec 28 13:50:54 centos7vm startengine.sh[3630]: 28/12/2018 13:50:54,129 - Scheduler is started
Dec 28 13:50:55 centos7vm startengine.sh[3630]: 28/12/2018 13:50:55,797 - SOAP Endpoint: http://centos7vm:42200/wsi/DeliverableService?WSDL
Dec 28 13:50:55 centos7vm startengine.sh[3630]: 28/12/2018 13:50:55,798 - SOAP Legacy "Non WSI-Compliant" Endpoint: http://centos7vm:42200/Stambi...ice?WSDL
Dec 28 13:50:55 centos7vm startengine.sh[3630]: 28/12/2018 13:50:55,798 - HTTP Rest Endpoint v2: http://centos7vm:42200/rest/StambiaDeliveryServi...eryName>
Dec 28 13:50:55 centos7vm startengine.sh[3630]: 28/12/2018 13:50:55,798 - HTTP Rest Endpoint v1: http://centos7vm:42200/rest/StambiaDeliveryServi...eryName>
Hint: Some lines were ellipsized, use -l to show in full.

 

Checking the Runtime state

See this article: http://www.stambia.org/doc/58-stambia-di-software/runtime/how-to/64-checking-that-the-runtime-is-up-and-running

[support@centos7vm stambiaRuntime]$ ./startcommand.sh "connect to localhost port 42000;get services"
Connecting to localhost on port 42000
Connected
Name      Status  Duration
rmi       Running 0:14:36.715
soap      Running 0:14:31.819
listener  Running 0:14:36.928
rdbms     Running 0:14:40.266
execution Running 0:14:36.927
scheduler Running 0:14:33.487