Covcheck: Unterschied zwischen den Versionen
(Markierung: 2017-Quelltext-Bearbeitung) |
(Markierung: 2017-Quelltext-Bearbeitung) |
| (16 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=== | ===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 55: | Zeile 60: | ||
*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: | 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> | <syntaxhighlight>curl https://covcheck.maxcrc.de/covcheck/status</syntaxhighlight> | ||
| + | <br /> | ||
The reply must be a JSON like as follows: | The reply must be a JSON like as follows: | ||
| − | + | <br /> | |
<syntaxhighlight>{ | <syntaxhighlight>{ | ||
"status":"ok", | "status":"ok", | ||
"last_update":"2022-07-04 12:06:34" | "last_update":"2022-07-04 12:06:34" | ||
}</syntaxhighlight> | }</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 | ;docker-compose.yml :docker compose file | ||
| − | ;install- | + | ;git-submodule-status:information about git submodules that comprise the Covcheck application server |
| + | ;install-covcheck.sh :primary installation script | ||
;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== | ==Configuration of Covcheck Application Server== | ||
| Zeile 89: | Zeile 98: | ||
===Change Default Password=== | ===Change Default Password=== | ||
| − | + | Open the address of the server in a browser and loging using the following default credentials: | |
{| class="wikitable" | {| class="wikitable" | ||
| Zeile 99: | Zeile 108: | ||
|} | |} | ||
| + | <br /> | ||
[[Datei:covcheck-login.png|ohne]] | [[Datei:covcheck-login.png|ohne]] | ||
| + | <br /> | ||
| − | + | Click the '''Administrator''' in the top right corner and then '''Preferences''': | |
| + | <br /> | ||
[[Datei:covcheck-admin.png|ohne]] | [[Datei:covcheck-admin.png|ohne]] | ||
| + | <br /> | ||
| − | + | In the opened window click '''Change password''': | |
| + | <br /> | ||
[[Datei:covcheck-change-password.png|ohne]] | [[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]] | [[Datei:covcheck-change-password2.png|ohne]] | ||
| + | |||
| + | <br /> | ||
===Managing Rulesets=== | ===Managing Rulesets=== | ||
| − | You can add, modify and delete rulesets on the '''Rulesets''' page. For example, let us create a ruleset '''3G+'''. | + | 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== | ==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=== | ===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=== | ===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“