|
systemd is a replacement framework for the SystemV init scripts
to manage services and is used by contemporary Linux distributions.
Eloquence on the Linux platform preferably uses systemd to manage
services, where available.
The Linux systemd unit files provide a similar functionality as
the Eloquence SystemV start/stop scripts.
Eloquence B.08.20 uses systemd for new installations only.
When updating an existing installation the use of SystemV init
scripts is retained.
Each service type is defined by a unit file that
describes the service and its dependency to systemd.
The following systemd unit files are available with Eloquence:
-
eloquence82.target
-
The Eloquence target encloses any enabled or running Eloquence
B.08.20 services. The target may be used to start or shut down
all Eloquence B.08.20 services.
-
eloqdb82.service
-
The default Eloquence database instance.
-
eloqdb82@.service
-
Additional Eloquence database instances. The instance name is
specified after the @ sign and implies the database server
configuration file name.
For example, a service name eloqdb82@test.service would
use the eloqdb-test.cfg configuration file.
-
eloqsd82.service
-
The Eloquence eloqsd service
-
dbrepl82.service
-
The default Eloquence database replication instance
-
dbrepl82@.service
-
Additional Eloquence database replication instances. The
instance name is specified after the @ sign and implies
the dbrepl configuration file.
For example, a service name dbrepl82@test.service would use
the configuration file repl-test.cfg.
The unit file names are versioned to allow coexistence with other
Eloquence releases. Once enabled and started a service name without
a version number may be used as an alias.
The Eloquence services are not enabled by default. The systemctl
enable command is used to enable the services for autostart.
systemctl enable eloqsd82.service eloqdb82.service
The eloqdb82@ and dbrepl82@ instances must be enabled with an
additional instance name. The instance name also defines the name of
the associated configuration file.
systemctl enable eloqdb82@test.service
The eloqdb82@test.service describes an eloqdb instance using
the configuration file eloqdb-test.cfg.
The eloquence82.target may be used to specify any active or
enabled Eloquence service.
# start/stop any enabled Eloquence 8.2 services
systemctl start eloquence82.target
systemctl stop eloquence82.target
# list enabled Eloquence 8.2 services and status
systemctl list-dependencies eloquence82.target
# list Eloquence 8.2 unit files and status
systemctl list-unit-files "*82*"
The systemctl start command is used to start the enabled Eloquence
services (requires root).
systemctl start eloquence82.target
- or -
systemctl start eloqsd82.service eloqdb82.service
Changing system wide systemd services requires root permissions.
Using sudo (with an appropriate sudoers entry) may be used to
allow users to start/stop Eloquence services without unlimited
root access.
|
