OC-Manager 3.0

Install

The installation process is really simple.

OC-Manager 3.0 works fine on a 'Raspberry Pi 4' with 4Gb RAM memory and Ubuntu 20.04 installed on it.
During and after the development phase, we used Ubuntu 20.04 LTS, for which security updates are available until April 2025. The long-term service (LTS) can be extended by 5 years after registering at Ubuntu and is free for personal use on three machines.

Newer releases of Ubuntu unfortunately do not support the raspistill command to capture plate images.

0. Install git

Before we begin with the installation, we need to install git.

sudo apt-get update && sudo apt-get -y upgrade
sudo apt-get install git

1. Clone the git repository

The simplest way to clone a git repository is opening a Terminal (Ctrl+t), then go to the directory where you would like to have the folder that contains all the configuration files of your OC-LAB (and between those, it is included the OC-Manager files too)

E.g.

cd ~/Desktop

Finally, copy and paste the next command and press enter.

git clone https://github.com/OfficeChromatography/OC-Manager3.git

2. Execute 'install.py'

The next step is to execute a bash script which contains, the necessary softwares to run the OC-Manager. If you close the Terminal open it again (remember, Ctrl+t). Now go to the folder that contains the OC-Lab files, it is

cd follow by the path to the folder.

cd /path/to/your/OC-files

Then execute,

python3 install.py

this will install:

docker
docker-compose

Now OC-Manager it's installed in your device.

3.Before the first execution

With Raspberry Pi

Depending on the OS change on the docker_compose.yml file:

For a 64bits OS:

    image: ocmanager/ocmanager:arm64

To activate the camera, follow the corresponding instruction:

Activate the PiCamera in Ubuntu distributions

Activate the PiCamera in Raspbian distributions

With Linux-PC (No Pi-Camera, instead uses the pc-webcam)

If you want to run OC-Manager with a PC running a Linux instance, you can download the docker image for it by changing the docker-compose.yml file.

    image: ocmanager/ocmanager:amd64

4.OC Manager execution

Navigate to the path where OC-Manager was installed and execute ./run.py file.

python3 run.py 

OC-Manager supports at the moment only linux/amd64, linux/arm/v7 and linux/arm64 architecutes.

OC-Manager3 was intensively tested with Chromium as browser. Therefore, it is recommended to install this browser:

sudo apt install chromium-browser

FIRMWARE

Firmware installation OcLab3Firmware

Useful guides

Docker Commands

Remove Migrations

All commands must be executed inside the docker-compose. To enter to the docker-compose running instance:

In a running container:

sudo docker-compose exec -ti app bash

To initialize and enter the terminal

sudo docker-compose run -ti app bash