Covcheck

Introduction

The document describes how to install the Covcheck application server and configure a Galaxy Gate so that COVID certificates and tests presented at the gate can be validated through the server's REST API.

Installation of Covcheck Application Server

Prerequisites

• Ubuntu 22.04 with Internet access
• User with sudo permissions and availability of a user with ID 1000 (cat /etc/passwd | grep 1000)
• Archive covid-installer.tar.gz with the files listed in [Installation Files](#installation-files)

Installation Steps

• Connect with ssh to the Ubuntu server

• Copy covid-installer.tar.gz to the local directory

• Execute the following command:

tar xvf covid-installer.tar.gz && cd ./covid-installer

• Modify file .env and specify the database password (POSTGRES_PASSWORD) and, if necessary, host name (ODOO_HOST_NAME) and timezone (TZ):

POSTGRES_PASSWORD=gR7K6GT8MvQHpvLs
ODOO_HOST_NAME=covcheck.maxcr.de
TZ=Europe/Berlin

• If SSL certificates are provided for domain name ODOO_HOST_NAME put them into directory /etc/nginx/certs, e.g:

sudo mkdir -p /etc/nginx/certs
sudo tar xvf certs.tar.gz -C /

• If SSL certificates are not available, HTTP connection will be used and you need to modify file **docker-compose** accordingly:

          ◦ Add this section to container **odoo**:

       ports:
      - 80:8069

          ◦ Comment out or remove port 80 for container **nginx_proxy**:

       ports:
    #  - 80:80
       - 443:443

• Run the installer script:

script=install-covcheck.sh && chmod +x $script && ./$script -i

• The installation is finished successfully if you see this line in the shell:

### Installation finished successfully

You can make sure that the Covcheck is installed and running by executing the following command:

curl https://covcheck.maxcrc.de/covcheck/status

The reply must be a JSON like as follows:

{
   "status":"ok",
   "last_update":"2022-07-04 12:06:34"
}

#installation_files

Installation Files

.env 

environment variables

boot-covid-install.sh 

development script

covcheck.tar.gz 

archived covcheck and request_extension ODOO addons

covid-installer.tar.gz 

archive of other files from this list

docker-compose.yml 

docker compose file

install-covid.sh 

primary installation script

nginx-vhost 

template vhost file for nginx

odoo.conf 

configuration file for ODOO

README.md 

this file

Configuration of Covcheck Application Server

Change Default Password

Open the address of the server in a browser and loging using the following default credentials:

Username	Password
admin	admin

Click the Administrator in the top right corner and then Preferences:

In the opened window click Change password:

Fill-in the following fields and then click Change Password:

• • Old Password
  • New Password
  • Confirm New Password

Managing Rulesets

You can add, modify and delete rulesets on the Rulesets page:

For example, let us create a ruleset 3G+, which requires an additional test. Click Create fill-in the fields Name and Unique Name, check Additional Test Required and click Save:

The list now includesthe 3G+ruleset:

Configuration of Galaxy Gate

In order COVID certificates and tests can be validated against the Covcheck server the proper dispatcher and display must be selected and configured.