Services - Unix Systems

The following describes how to set up Karaf and OpenSearch as systemd services.

Preparation

In the BPC installation directory, create the subdirectory systemd and change to it
Copy the following scripts and templates from Download - Virtimo File Server to this directory:
- opensearch-systemd-generate.sh
- opensearch-systemd.template
- karaf-systemd-generate.sh
- karaf-systemd.template
Make the two scripts executable
- chmod +x opensearch-systemd-generate.sh
- chmod +x karaf-systemd-generate.sh

Generate systemd scripts (one-time)

We generate these for Karaf and OpenSearch . For both generation scripts, you can get a list of available Parameters by running them without or with the '-h' parameter .

Example

$ ./opensearch-systemd-generate.sh -k /<BPC-INSTALL-DIR>/opensearch -j /<BPC-INSTALL-DIR>/_jvm -n bpc-opensearch -u bpc -g bpc

$ ./karaf-systemd-generate.sh -k /<BPC-INSTALL-DIR>/karaf -j /<BPC-INSTALL-DIR>/_jvm -n bpc-karaf -u bpc -g bpc -a bpc-opensearch.service

This generates the systemd scripts BPC-opensearch.service and BPC-karaf.service in the same directory.

Parameters used

k: Application installation directory (required)
j: Java Home directory (required)
n: Service name
a: Start after this service. The name of the OpenSearch service should be specified here. (Karaf only)
u: Service user
g: Service group

Set up the systemd service (one-time)

$ sudo systemctl enable /<BPC-INSTALL-DIR>/systemd/bpc-opensearch.service
$ sudo systemctl enable /<BPC-INSTALL-DIR>/systemd/bpc-karaf.service

Verify

$ systemctl --type=service -a | grep -i bpc
UNIT                                       LOAD      ACTIVE   SUB     DESCRIPTION
bpc-opensearch.service                loaded    inactive dead    OpenSearch - bpc-opensearch
bpc-karaf.service                        loaded    inactive dead    Karaf - bpc-karaf

Start

$ sudo systemctl start bpc-opensearch.service
$ sudo systemctl start bpc-karaf.service

Stop

$ sudo systemctl stop bpc-karaf.service
$ sudo systemctl stop bpc-opensearch.service

Remove Services

$ sudo systemctl disable bpc-opensearch.service
$ sudo systemctl disable bpc-karaf.service

Keywords: