CanDo System Information

This document is intended for IT/technical staff at CanDo Project sites. It is assumed that the audience is familiar with system administration and that adding a host (network configuration, DNS, etc.) is a familiar activity. Familiarity with Linux is not assumed, though the reader will be expected to read and digest some of the official Ubuntu Linux documentation along the way.

Technology Stack

CanDo runs on the Ubuntu Linux operating system, currently Ubuntu 18.04 LTS, and for the 2019-2020 school year uses a Docker container. Deploying CanDo in a Docker container allows the OS to be upgraded from 14.04 LTS to 18.04 LTS without the need to revise the CanDo application. All software is free and open source.

Hardware Requirements

  • You’ll need a server to run Cando, either on a virtual machine or on bare metal.
  • If you’re installing as a virtual machine, you will need the ISO of the install CD mounted to the virtual machine.
  • If you are installing onto bare metal, you will need a physical copy of the Ubuntu Server LTS 18.04 CD or some way of booting onto a USB flash drive containing the installation media.
  • For drive space, you will need at least 6GB just for the base Ubuntu install, approximately 1GB for each year of data, and approximately 1GB for schooltool/cando and related files.

Firewall Settings

If your system will not be made accessible outside of your school or division, Docker will handle the firewall and no other changes need to be made.

If your system will be made accessible outside of your school or division, ports 22, 80, and 443 will need to be open to your CanDo server.

Proxy Server

Although it is possible, we do not recommend proxying requests to CanDo. Larger divisions, with many simultaneous users, may experience poor performance as a result of the proxy server. If you must use a proxy, bear this in mind should you need to troubleshoot performance issues.

Installation Directions

Initial Ubuntu Server Installation with Docker

Existing Ubuntu Server Migration to Docker