Installing the Scheduler Service on Linux (v2019.1+)

In order to allow systemd compatibility and customization of service names, the Exago Linux installer has been updated. With these enhancements come a few changes in behavior for Scheduler installation.

Updated Installer

The startService.sh, stopService.sh, and checkService.sh scripts of the previous versions have been replaced. These scripts, however, have not been actively removed and will still be available for use in previous Scheduler installse.g., for use as a part of external scripts or management logic.

The new installer will not remove any files the old scripts may be referencing including the eWebReportsScheduler executable. Instead the installer creates a uniquely named link to that file so any future installs can simply overwrite the eWebReportsScheduler.exe without having to manage it with previously created service scripts.

As a replacement to the service scripts, the Scheduler is now managed by a single script that handles the start, stop, restart and status checks. This new script is named exago-scheduler.sh by default, but it is customizable via the installer through the -r option.

The installer now has two new flags:

The new service should start automatically when the system boots, and can be managed with the service command in the following ways:

When the scheduler is not installed as a systemd service, it is not possible to know if another service with the same name exists on the same server. When a service with the same name is installed, only one can be used at a time. This is due to the fact that the lock files used by the service are based on the service name. Collisions of these type are not allowed as they will prevent the second process from starting. In this scenario, the -r flag should be used and additional schedulers should given different names.

When a second scheduler is installed on the same server, the default service name will increment begin to increment: exago-scheduler2, exago-scheduler3, and so on.

Installer Help Dialog

The following information is prompted by the -h (help) flag

Usage: ./installExago.sh [-d <Install Path>] 
[-m <TRUE|FALSE>]
[-i <WEBAPP|WEBAPI|SCHEDULER>]
[-y]
[-h]

-d <Install Path> Set the install location to use
-m <TRUE|FALSE> Set whether or not to install Mono
-i <WEBAPP|WEBAPI|SCHEDULER> Set the component to install
-a <Web App Apache Alias> Default is set to '/Exago'
-s <WebService Apache Alias> Default is set to '/ExagoWebApi'
-r <Scheduler Service Name> Service name to use for scheduler service
-R Configure the scheduler as a systemd service
-y Do not prompt for final verification before installing
-h Show this help screen

Examples

Install the Exago Web Application and Web Service API into /opt/Exago:

./installExago.sh -d /opt/Exago -m TRUE -i WEBAPP -i WEBAPI

Install Everything without prompting before starting the install:

./installExago.sh -d /opt/Exago -m TRUE -i WEBAPP -i WEBAPI -i SCHEDULER -y