Dundas BI Linux services

Contents[Hide]

1. Overview

This article describes the Dundas BI services that run on Linux servers and how to control them. You can use this article for reference after installing Dundas BI on Linux.

2. Using systemd to control Dundas BI services

systemd is a system and service manager for Linux. All Dundas BI services that are created with the instance exist as systemd services.

When you create an instance, the following services are created:

ServiceDescriptionService Definition Path
Dundas BI website The Dundas BI website service runs the .NET Core Kestrel website for Dundas BI.
/etc/systemd/system/dundas-bi-website-{InstanceName}.service
Dundas BI scheduler The Dundas BI scheduler service runs the .NET Core scheduler for Dundas BI.
/etc/systemd/system/dundas-bi-scheduler-{InstanceName}.service
Dundas BI X Virtual Frame Buffer service The Dundas BI X Virtual Frame Buffer service is used to create images during export.
/etc/systemd/system/dundas-bi-xvirtualframebuffer.service

2.1. Commands to control Dundas BI services

2.1.1. Dundas BI website commands

Note
The systemctl command usually requires elevated privileges. In this case you would use the sudo command in front of the systemctl command or run as a user such as root.

The following table gives typical commands for controlling the website service:

CommandResult
systemctl stop dundas-bi-website-{InstanceName}.service
Stops the Dundas BI Kestrel website.
systemctl start dundas-bi-website-{InstanceName}.service
Starts the Dundas BI Kestrel website.
systemctl restart dundas-bi-website-{InstanceName}.service
Restarts the Dundas BI Kestrel website.
systemctl status dundas-bi-website-{InstanceName}.service
Get the Dundas BI Kestrel website status.

2.1.2. Dundas BI scheduler commands

The following table gives typical commands for controlling the scheduler service:

CommandResult
systemctl stop dundas-bi-scheduler-{InstanceName}.service
Stops the Dundas BI scheduler.
systemctl start dundas-bi-scheduler-{InstanceName}.service
Starts the Dundas BI scheduler.
systemctl restart dundas-bi-scheduler-{InstanceName}.service
Restarts the Dundas BI scheduler.
systemctl status dundas-bi-scheduler-{InstanceName}.service
Gets the Dundas BI scheduler status.

2.1.3. Dundas BI X Virtual Frame Buffer service

The following table gives typical commands for controlling the X Virtual Frame Buffer service:

CommandResult
systemctl stop dundas-bi-xvirtualframebuffer.service
Stops the Dundas BI X Virtual Frame Buffer Service.
systemctl start dundas-bi-xvirtualframebuffer.service
Starts the Dundas BI X Virtual Frame Buffer Service.
systemctl restart dundas-bi-xvirtualframebuffer}.service
Restarts the Dundas BI X Virtual Frame Buffer Service.
systemctl status dundas-bi-xvirtualframebuffer.service
Gets the Dundas BI X Virtual Frame Buffer Service status.

Tip
For more information about the systemctl command, see the systemctl manpage.

3. Troubleshooting Linux services

If the Dundas BI website is not serving content when you visit its URL, the first thing to check is whether the website service is running. To to this, you would execute the following command given as an example above:

systemctl status dundas-bi-website-{InstanceName}.service

Here you are expecting to see an active status as shown below:

Expected systemctl Dundas BI website status
Expected systemctl Dundas BI website status

If the website seems to be running, check the reverse proxy server that you configured. As Dundas BI allows for various reverse proxies to be used, it is best to check with the documentation for the particular reverse proxy you are using.

3.1. journalctl

If you would like to see more console logs from the Dundas BI services, you can use the journalctl command. The following example demonstrates how to get all the Dundas BI website service logs:

journalctl -u dundas-bi-website-{InstanceName}.service

Note
The journalctl command usually requires elevated privileges. In this case you would use the sudo command in front of the journalctl command or run as a user such as root.

4. See also

Dundas Data Visualization, Inc.
500-250 Ferrand Drive
Toronto, ON, Canada
M3C 3G8

North America: 1.800.463.1492
International: 1.416.467.5100

Dundas Support Hours:
Phone: 9am-6pm, ET, Mon-Fri
Email: 7am-6pm, ET, Mon-Fri