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…


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

 

Articles

Suggest a new Article!