bc-server installation

Requirements

  • Java 8

Installation

  1. download bc-agent distribution file

root# cd /downloads-directory
root# wget http://beyondcron.com/downloads/bc-server_version_all.deb

root# cd /downloads-directory
root# wget http://beyondcron.com/downloads/bc-server_version-0.noarch.rpm

user% cd /downloads-directory
user% wget http://beyondcron.com/downloads/bc-server-version.zip

  1. if it does not already exist, create /etc/apt/sources.list.d/beyondcron.list

root# echo 'deb https://beyondcron.com/dists/stable /' > /etc/apt/sources.list.d/beyondcron.list

the package apt-transport-https is required in order to use an https source. If you are unable to install this package, change the source entry to deb http://beyondcron.com/dists/stable /.

  1. if it does not already exist, download the BeyondCron signing key /etc/apt/trusted.gpg.d/beyondcron.gpg

root# cd /etc/apt/trusted.gpg.d
root# wget https://beyondcron.com/dists/stable/beyondcron.gpg

  1. update package index files

root# apt-get update

  1. if it does not already exist, create /etc/yum/repos.d/beyondcron.repo

root# cat > /etc/yum.repos.d/beydoncron.repo << EOF
[beyondcron]
name=BeyondCron packages
baseurl=http://beyondcron.com/dists/stable
gpgcheck=1
gpgkey=http://beyondcron.com/dists/stable/RPM-GPG-KEY-beyondcron
metadata_expire=300
enabled=1
EOF

  1. install package and start daemon
  1. install package and start daemon

root# dpkg -i bc-server_version_all.deb

root# rpm -i bc-server_version-0.noarch.rpm

root# apt-get install bc-server

root# yum install bc-server

If they do not already exist, installing this package will create the following:

  • operating system user bc-daemon to run bc-server;
  • directory /opt/bc-server containing this package;
  • configuration file /etc/default/bc-server;
  • data directory /var/opt/bc-server;
  • log file /var/log/bc-server.log on init systems;

It will also register and start bc-server as a service.

if the package cannot find a version of Java 8 already installed, the installation will fail.

Starting/stopping

On init systems, the bc-server service can be started and stopped using the service command. e.g.

root# service bc-server (start|stop)

On systemd systems, the bc-server service can be started and stopped using the systemctl command. e.g.

root# systemctl (start|stop) bc-server

Logging

On init systems, output is written to the file /var/log/bc-server.log.

On systemd systems, output is written to the systemd journal and can be viewed using journalctl. e.g.

root# journalctl -u bc-server

  1. move to the install directory

user% cd /install-directory

The distribution will will create the sub-directory bc-server.

  1. unzip distribution

user% unzip /downloads-directory/bc-server-version.zip

  1. confirm installation

user% ./bc-server/bin/bc-server --version

bc-server version

Services

See service overview, for information on connecting to a user name service, and persisting job status, history and output. In particular, a status service is required in order to view job status, history and output.

See also