Operating systems have service management subsystems that support starting and stopping services when the host operating system
is booted and shut down. StreamBase supports the Linux service management subsystem using
This page assumes familiarity with
systemd concepts and general architecture; sudo access is required to install new services.
systemd unit file is shipped as:
The standard and recommended INSTALLROOT is
/opt, which is shown on the rest of this page.
This file defines a service named
tibco-ep that can manage a single node. Multiple nodes can be started on a single machine by installing multiple copies of the shipped unit file, each with a different
systemd file as follows. These instructions install the service with the default name and configure a service to manage a single
Install into the required
systemddirectory using the default service name. Run this command in one line, substituting your installation location. The example below wraps to the next line for clarity:
sudo cp -p /opt/tibco/str/11.0/distrib/tibco/dtm/services/linux/tibco-ep.service \ /usr/lib/systemd/system
Do not use a symbolic link to install the file;
systemddoes not fully support symbolic links.
systemdmanager configuration to detect the newly installed service.
sudo systemctl daemon-reload
Enable the service so that Linux can automatically manage it.
sudo systemctl enable tibco-ep
Manually start the service.
sudo systemctl start tibco-ep
Multiple nodes can be installed on the same machine by installing multiple copies of the unit file with different names. Run
the following to install another service named
my-application on the same machine:
sudo cp /opt/tibco/str/11.0/distrib/tibco/dtm/services/linux/tibco-ep.service \ /usr/lib/systemd/system/my-application.service sudo systemctl daemon-reload sudo systemctl enable my-application sudo systemctl start my-application
systemd file supports configuration using
systemd environment configuration variables. You can change these configuration values directly in the
systemd file after it is installed.
||Java installation.||Yes. Default value is
||Absolute path to the application archive to install on the node.||No. If not used, the node is installed without an application.|
||Absolute path to the TIBCO Streaming product installation.||Yes. Default value is
||Node name.||Yes. Default value is
||Absolute path to a node deploy configuration file to configure node during installation.||No. If not used, the node is installed using default configuration.|
||Absolute path to the run directory where nodes are to be installed.||Yes. Default value is
||Absolute path to a substitution variable file.||No. If not used, no substitution variables are specified during node install.|
In addition to these supported configuration variables, you can specify standard
systemd configuration values in unit file overrides using
systemctl edit. See the
systemd documentation for complete details on the unit file supported configuration variables.
The shipped unit file has these behaviors for managing services using
start — install the node if not installed, then start the node.
stop — stop and quiesce the node.
reload — not supported. Use standard node configuration mechanisms to change node configuration.
The Restart=on-failure configuration is enabled. When a node fails, it is automatically restarted after taking these actions:
Creating a snapshot of the failed node.
Removing the node.
Re-installing the node.
For a restart on failure, all user data stored in the failed node is lost. TIBCO recommends replicating your data to another node as needed.
Use these steps to completely remove an installed service. These steps use the default shipped service name,
Stop the service.
sudo systemctl stop tibco-ep
Remove the service from management by the operating system.
sudo systemctl disable tibco-ep
sudo rm /usr/lib/systemd/system/tibco-ep.service
Remove any configuration overrides.
sudo rm -rf /etc/systemd/system/tibco-ep.service.d
systemdmanager to update its configuration.
sudo systemctl daemon-reload
Reset all failed messages.
sudo systemctl reset-failed