Getting started

This is a quick guide to installing a standalone instance of BeyondCron on a single server.

Install BeyondCron packages

  1. install bc-server
  2. install bc-agent
  3. install bc-cli
  4. install bc-web

Configure sudo

In order to execute jobs as users other than the bc-server operating system user bc-daemon, ensure that sudo is configured to allow bc-daemon to command execute jobs for other users.

Configure ssh

If you wish to have BeyondCron execute jobs on other servers, ensure that bc-daemon has passwordless ssh access to those servers, including other BeyondCron servers.

Setting yourself up as the admin user

LDAP user directory

BeyondCron will automatically use the Unix user service, if the server is configured to use LDAP for user authentication.

To designate yourself as a BeyondCron administrator in your LDAP directory service:

  1. create the group bc_admin
  2. add yourself to the new bc_admin group
Internal user directory

If BeyondCron is not configured with a user service, then it will manage users internally using the user & role commands.

To create yourself as a BeyondCron administrator:

username@server% sudo -u bc-daemon /opt/bc-cli/bin/bc-cli --admin
BeyondCron % user add username
BeyondCron % user password username secret
BeyondCron % user role add username admin
BeyondCron % exit

Login to BeyondCron

Login to BeyondCron using bc-web or bc-cli, using your LDAP user name/password, or new BeyondCron user name/password.

Import the example jobs

Using the BeyondCron command line, or bc-web terminal, import the BeyondCron examples.

BeyondCron % import all / /opt/bc-cli/share/root.yaml
BeyondCron % import all /examples /opt/bc-cli/share/examples.yaml

if using the bc-web terminal, append confirm the import commands.