Operating System

The recommended operating system for Xronos Scheduler is Debian GNU/Linux version 10 (Buster).

Download

Download the “Small CDs or USB sticks” image for amd64 (or i386 if you have only a 32-bit processor) for Debian GNU/Linux version 10.

Note

If you are doing a fresh installation of Debian GNU/Linux onto a normal PC or virtual machine, then you almost certainly want to choose the “amd64” version of the installer. This is the 64 bit version for both Intel and AMD processors. Use the “i386” version only for old processors which are restricted to 32 bit.

Install

If you are using a physical machine for your installation, you will need to write the image to a CD or USB stick. If you installing to a Virtual Machine, you should be able to use the image file directly as an emulated device.

Boot your machine (or VM) with the installation image and follow the instructions. At each choice, take the default offered except at the stage of choosing the packages to install. At that point, un-tick “Debian Desktop Environment” and tick “SSH Server”. There’s no point in having a graphical desktop environment on a headless server - it’s a waste of resources - but you will need to have an SSH server running in order to be able to connect to it.

Many VM providers will bootstrap your VM for you with the operating system of your choice. In this case, just ask for the current Debian GNU/Linux.

Initial packages

Once you have a running system, you will need some basic extra packages and a user account under which to run the application.

It is assumed you have root access to the system and are going to create a user called “scheduler” to run the software.

Note

You can call the user anything you want, but don’t try to run the application as root. These instructions assume that the user will be called “scheduler”.

As root, do the following:

# apt install sudo vim curl git libicu-dev memcached dirmngr libmagick++-dev
# apt install nodejs npm
# apt install mariadb-server mariadb-client libmariadbclient-dev
# adduser scheduler
# adduser scheduler sudo
# adduser scheduler staff

These lines install the necessary packages, add the scheduler user, and then put that user in a couple of necessary groups.

It’s a good idea to run the command:

# mysql_secure_installation

After installing mariadb above. Accept all the default options to tighten up your mariadb installation.

Log out as root and log back in as your chosen user.

Note

The following instructions frequently ask you to edit a file. To do this you need some sort of text editor, and as this is a headless server, it’s going to need to be a text-mode one, not a graphical one.

You may have noticed that vim was installed as one of the basic packages, so if you’re happy with vim then do use that. It’s a very powerful editor, but perhaps has a bit of a steep initial learning curve. For small edits, and if you don’t already have a preference for a particular editor, “nano” is an editor which is very easy to get started with.

If you’d like to learn vim, you’ll find an interactive tutorial on your system which can be invoked with the command “vimtutor”.