Installeren van OnsDB 5

Installatie OnsDB

1. Download de OnsDB 5-release via deze handleiding op het supportportaal of gebruik het door Nedap verstrekte releasebestand onsdb-<versie>-release-binaries.zip. Controleer het versienummer: voor OnsDB 5.0.0 heet dit bestand onsdb-5.0.0-release-binaries.zip. Gebruik je al OnsDB 4, volg dan eerst de migratiegids.
2. Pak het ZIP-bestand uit in de gewenste locatie op de machine waarop OnsDB gaat draaien. Maak hiervoor zelf een map aan op de gewenste locatie, welke volledig vrij te kiezen is. Gebruik de executable en het voorbeeld configuratiebestand uit de submap die bij het besturingsysteem en architectuur past. De map documentatie bevat deze handleiding; open documentatie/index.html om deze offline te lezen.
   
   Voor SQL Server via ODBC op Linux is de ondersteunde configuratie Debian 13 amd64 met Microsoft ODBC Driver 18. Debian 12 en FreeTDS worden voor deze Linux-binaries niet ondersteund. Voor MySQL en SQLite is geen ODBC-driver nodig. De macOS-binaries ondersteunen MySQL/MariaDB en SQLite; SQL Server via ODBC is daar niet beschikbaar.
   
   
   Gebruik voor de Windows-binary Windows 10 of Windows Server 2016 of nieuwer. De macOS-binaries vereisen macOS 13 Ventura of nieuwer. Zie de minimum platformversies.
   
   

3. Open een terminal en ga naar de map met de executable. Op Linux en macOS gebruik je ./onsdb; maak het bestand zo nodig uitvoerbaar met chmod +x onsdb. Op Windows gebruik je onsdb.exe. amd64 is bedoeld voor 64-bits Intel/AMD-processors; arm64 voor ARM-processors, waaronder Apple Silicon.

4. OnsDB schrijft certificaten en sleutels in ssl en logbestanden in de huidige werkmap. Relatieve paden naar de configuratie, het rapport en het SQLite-bestand worden ook vanuit die werkmap gebruikt. De gebruiker die OnsDB start moet daar kunnen lezen en schrijven. Het meegeven van een volledig pad aan --config verandert de werkmap niet.

5. Indien gebruik wordt gemaakt van een firewall, kan dit tot gevolg hebben dat er geen verbinding gemaakt kan worden. Zorg er in dat geval voor dat de volgende URL's door de firewall doorgelaten worden:

   • https://api-dashboard.ons.io
   • Development-omgevingen: https://api-development.ons.io
   • Test-omgevingen: https://api-staging.ons.io
   • Productie-omgevingen: https://api.ons.io

De machine moet daarnaast de lokale databaseserver kunnen bereiken als je MySQL of SQL Server gebruikt. Een HTTP-proxy kan met [onsdb] proxy worden ingesteld. Zie Configuratiebestand voor OnsDB.

Updates OnsDB

Zorg ervoor dat je de meest recente versie van OnsDB gebruikt. OnsDB kan als volgt handmatig bijgewerkt worden:

1. Download het bestand onsdb-<versie>-release-binaries.zip van de gewenste OnsDB 5-release. Controleer dat het om een OnsDB 5-release gaat, niet de stabiele OnsDB 4-client.
2. Pak het gedownloade ZIP-bestand uit.
3. Wacht totdat een lopende download klaar is. Plaats het bestand onsdb.exe (Windows) of onsdb (Unix) uit de passende submap in de map van waaruit OnsDB draait. Je vervangt hiermee de oude executable. Bewaar je eigen configuratie en de map ssl; overschrijf ze niet met het voorbeeldconfiguratiebestand uit de release.