Covcheck Applicaton Server

Inhaltsverzeichnis

1 Introduction
2 Installation of Covcheck Application Server
3 Configuration of Covcheck Application Server
- 3.1 Change Default Password
- 3.2 Managing Rulesets
4 Configuration of Galaxy Gate
- 4.1 Dispatcher
- 4.2 Display

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), which is by default
Archive covid-installer.tar.gz with the files listed in 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

.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.

Dispatcher

Open the URL of the gate, login with user wanzl and navigate to the Configuration page. Select tab Dispatchers and click Add:

In the combo box under the title Dispatcher select Covcheck, modify the following properties if needed and click Save:

URL: Base URL of Covcheck's API
Ruleset: Ruleset for validating COVID certificates and tests
COVID Test timeout, ms: When a COVID test is required, specifies the timeout of waiting for it