Covcheck: Unterschied zwischen den Versionen
(Markierung: 2017-Quelltext-Bearbeitung) |
(Markierung: 2017-Quelltext-Bearbeitung) |
| (21 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| + | {{DISPLAYTITLE:Covcheck Applicaton Server}} | ||
__TOC__ | __TOC__ | ||
| Zeile 12: | Zeile 13: | ||
===Prerequisites=== | ===Prerequisites=== | ||
| − | * Ubuntu 22.04 | + | *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 '''covcheck-installer.tar.gz''' with the files listed in [[#Installation Files|Installation Files]]. The name '''covcheck-installer.tar.gz''' can include a version, e.g. '''covcheck-installer-v0.1.tar.gz''' |
| − | === | + | ===Installation Steps=== |
| − | * | + | *Connect with '''ssh''' to the Ubuntu server |
| − | * | + | *Copy '''covcheck-installer.tar.gz''' to the local directory |
| − | * | + | *Execute the following command: |
| + | <br /> | ||
<syntaxhighlight> | <syntaxhighlight> | ||
| − | tar xvf | + | tar xvf covcheck-installer.tar.gz && cd ./covcheck-installer |
</syntaxhighlight> | </syntaxhighlight> | ||
| + | <br /> | ||
| − | * Modify file '''.env''' and specify the database password ('''POSTGRES_PASSWORD''') and, if necessary, host name ('''ODOO_HOST_NAME''') and timezone ('''TZ'''): | + | *Modify file '''.env''' and specify the database password ('''POSTGRES_PASSWORD''') and, if necessary, host name ('''ODOO_HOST_NAME''') and timezone ('''TZ'''): |
| + | <br /> | ||
<syntaxhighlight>POSTGRES_PASSWORD=gR7K6GT8MvQHpvLs | <syntaxhighlight>POSTGRES_PASSWORD=gR7K6GT8MvQHpvLs | ||
ODOO_HOST_NAME=covcheck.maxcr.de | ODOO_HOST_NAME=covcheck.maxcr.de | ||
TZ=Europe/Berlin</syntaxhighlight> | TZ=Europe/Berlin</syntaxhighlight> | ||
| + | <br /> | ||
| − | * If SSL certificates are provided for domain name '''ODOO_HOST_NAME''' put them into directory '''/etc/nginx/certs''', e.g: | + | *If SSL certificates are provided for domain name '''ODOO_HOST_NAME''', put them into directory '''/etc/nginx/certs''', e.g: |
<syntaxhighlight> | <syntaxhighlight> | ||
| Zeile 41: | Zeile 46: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | * If SSL certificates are not available, HTTP connection will be used and you need to modify file **docker-compose** accordingly: | + | *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**: | ◦ Add this section to container **odoo**: | ||
| − | + | <syntaxhighlight> | |
ports: | ports: | ||
- 80:8069 </syntaxhighlight> | - 80:8069 </syntaxhighlight> | ||
◦ Comment out or remove port 80 for container **nginx_proxy**: | ◦ Comment out or remove port 80 for container **nginx_proxy**: | ||
| − | + | <syntaxhighlight> | |
ports: | ports: | ||
# - 80:80 | # - 80:80 | ||
- 443:443 </syntaxhighlight> | - 443:443 </syntaxhighlight> | ||
| − | * Run the installer script: | + | *Run the installer script: |
| + | <br /> | ||
<syntaxhighlight>script=install-covcheck.sh && chmod +x $script && ./$script -i</syntaxhighlight> | <syntaxhighlight>script=install-covcheck.sh && chmod +x $script && ./$script -i</syntaxhighlight> | ||
| + | <br /> | ||
| − | * The installation is finished successfully if you see this line in the shell: | + | *The installation is finished successfully if you see this line in the shell: |
| + | <br /> | ||
<syntaxhighlight>### Installation finished successfully</syntaxhighlight> | <syntaxhighlight>### Installation finished successfully</syntaxhighlight> | ||
| + | <br /> | ||
| + | |||
| + | You can make sure that the Covcheck is installed and running by executing the following command: | ||
| + | |||
| + | <br /> | ||
| + | <syntaxhighlight>curl https://covcheck.maxcrc.de/covcheck/status</syntaxhighlight> | ||
| + | <br /> | ||
| + | |||
| + | The reply must be a JSON like as follows: | ||
| + | <br /> | ||
| + | <syntaxhighlight>{ | ||
| + | "status":"ok", | ||
| + | "last_update":"2022-07-04 12:06:34" | ||
| + | }</syntaxhighlight> | ||
| + | <br /> | ||
===Installation Files=== | ===Installation Files=== | ||
| − | ;.env : environment variables | + | ;.env :environment variables |
| − | + | ;covcheck.tar.gz :archived covcheck and request_extension ODOO addons | |
| − | ;covcheck.tar.gz : archived covcheck and request_extension ODOO addons | + | ;docker-compose.yml :docker compose file |
| − | + | ;git-submodule-status:information about git submodules that comprise the Covcheck application server | |
| − | ;docker-compose.yml : docker compose file | + | ;install-covcheck.sh :primary installation script |
| − | ;install- | + | ;nginx-vhost :template vhost file for nginx |
| − | ;nginx-vhost : template vhost file for nginx | + | ;odoo.conf :configuration file for ODOO |
| − | ;odoo.conf : configuration file for ODOO | + | |
| − | ; | + | ==Configuration of Covcheck Application Server== |
| + | |||
| + | ===Change Default Password=== | ||
| + | |||
| + | Open the address of the server in a browser and loging using the following default credentials: | ||
| + | |||
| + | {| class="wikitable" | ||
| + | !Username | ||
| + | !Password | ||
| + | |- | ||
| + | |admin | ||
| + | |admin | ||
| + | |} | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-login.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | Click the '''Administrator''' in the top right corner and then '''Preferences''': | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-admin.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | In the opened window click '''Change password''': | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-change-password.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | Fill-in the following fields and then click '''Change Password''': | ||
| + | |||
| + | *Old Password | ||
| + | *New Password | ||
| + | *Confirm New Password | ||
| + | |||
| + | <br /> | ||
| + | |||
| + | [[Datei:covcheck-change-password2.png|ohne]] | ||
| + | |||
| + | <br /> | ||
| + | |||
| + | ===Managing Rulesets=== | ||
| + | |||
| + | You can add, modify and delete rulesets on the '''Rulesets''' page: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-rulesets.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | 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''': | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-3gp.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | The list now includesthe '''3G+'''ruleset: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-rulesets-with-3gp.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | ==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''': | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-dispatcher-add.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | 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 | ||
| + | |||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-dispatcher-covcheck.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | Restart the gate: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-dispatcher-restart.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | If the Covcheck server is available, the '''Error''' field is empty: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-dispatcher-connected.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | ===Display=== | ||
| + | |||
| + | Open the URL of the gate, login with user '''wanzl''' and navigate to the '''Configuration''' page. Select tab '''Displays''' and click '''Add''': | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-display-add.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | In the combo box under the title '''Display''' select '''Display Gate Covcheck''', modify the following properties if needed and click '''Save''': | ||
| + | |||
| + | ;Gate side :Side of the display, '''Entry''' or '''Exit''' | ||
| + | |||
| + | ;Name :User-friendly name | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-display-covcheck.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | Restart the gate: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-display-restart.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | Navigate to the '''Status''' page and open the link corresponding to the display: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-display-link.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | The following screen for the idle state invites to present a COVID certificate: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-display-scan-certificate.png|ohne]] | ||
| + | <br /> | ||
| + | |||
| + | When in addition a test certificate is required, the next screen asks to show it: | ||
| + | |||
| + | <br /> | ||
| + | [[Datei:covcheck-display-scan-test.png|ohne]] | ||
| + | <br /> | ||
Abgerufen von „https://docs.maxcrc.de/w/index.php?title=Covcheck&oldid=7522“