Handleiding 2 · Hoofdstuk 2
KoonScan installeren
Doe dit op de Windows-computer waar KoonScan komt te staan. Reken op 10 tot 20 minuten. Dit hoofdstuk gebruikt het installatieprogramma: de manier voor iedereen. Installeer je met een script? Lees dan Installeren met PowerShell (voor IT) onderaan.
Het installatieprogramma downloaden#
- Open op de server het klantportaal portal.koonsystems.com en log in.
- Klik links op Downloads.
- Klik bij Windows-installatie op het bestand
KoonScan-Setup-<versie>.exe. Je browser zet het in de map Downloads.
Het installatieprogramma starten#
- Open de map Downloads.
- Dubbelklik op
KoonScan-Setup-<versie>.exe. - Verschijnt er een blauw venster "Windows heeft uw pc beschermd"? Klik dan op Meer info 3. (Zie je dit venster niet, ga dan door naar stap 5.)
- Klik op Toch uitvoeren 4. Dit venster komt omdat KoonScan nog geen digitale handtekening heeft; het programma is veilig.
- Windows vraagt: "Wilt u toestaan dat deze app wijzigingen aanbrengt op uw apparaat?" Klik op Ja 5.
- Het installatieprogramma start in de taal van Windows. Lees de algemene voorwaarden, kies Ik accepteer de licentieovereenkomst 6 en klik op Volgende 7.
- Kies de doelmap: laat
C:\KoonScanstaan en klik op Volgende 8. - Poort voor scanners en telefoons: laat 5443 staan en klik op Volgende 9. (Alleen als je IT-leverancier zegt dat 5443 al bezet is, kies je een ander nummer.)
- Database: laat het bovenste rondje Geen SQL Server nodig: KoonScan gebruikt een eigen databasebestand (aanbevolen) aangevinkt 10. Klik op Volgende. (Meer dan 50 scanners tegelijk? Kies dan SQL Server Express (instantie KSCAN) installeren; zie de tip hieronder.)
- Klik op Installeren 11.
- Wacht tot de balk vol is. Dit duurt een minuut of twee; met SQL Server Express 5 tot 15 minuten, en de balk staat dan soms een tijd stil. Niet afsluiten.
- Op het laatste scherm staat een vinkje bij Inrichtingswizard openen in de browser 13. Laat dat aan staan.
- Klik op Voltooien 14.
Installeren met PowerShell (voor IT)#
Voor IT-leveranciers die met een script of op meer servers installeren. Het resultaat is hetzelfde als met het installatieprogramma: de Windows-service KoonScan, de map C:\KoonScan en de inrichtingswizard. Geen IT'er? Gebruik het installatieprogramma hierboven.
Manier 1: het zip-pakket
-
Download in het klantportaal → Downloads het Zip-bestand
koonscan-<versie>.zipen pak het uit, bijvoorbeeld naarC:\Temp\koonscan. -
Open PowerShell als administrator (rechtermuisknop → Als administrator uitvoeren) in die map en typ:
Set-ExecutionPolicy -Scope Process Bypass .\Install-KoonScan.ps1 -
Het script kopieert de app naar
C:\KoonScan\app, maakt de Windows-service, de firewallregel en het instellingenbestand, start de service en opent de inrichtingswizard. Ga verder met hoofdstuk 3.
| Optie | Wat het doet |
|---|---|
-InstallDir D:\KoonScan |
Een andere map (standaard C:\KoonScan). |
-HttpsPort 5443 |
Poort voor de toestellen (standaard 5443; niet 5080). |
-NoBrowser |
De wizard niet openen; het script toont alleen het adres (voor een server zonder bureaublad). |
Het script nog een keer uitvoeren kan geen kwaad: instellingen, certificaten en de database blijven staan. In de zip zitten ook Update-KoonScan.ps1 voor updates (hoofdstuk 10) en appsettings.Local.example.json, een voorbeeld van de instellingen voor wie KoonScan zonder de wizard inricht (bijlage B).
Manier 2: het installatieprogramma zonder vragen
KoonScan-Setup-<versie>.exe /VERYSILENT /SUPPRESSMSGBOXES /DIR=C:\KoonScan /PORT=5443
Alle opties van de stille installatie staan in bijlage B. Stil installeren geldt als het accepteren van de algemene voorwaarden. De wizard opent niet vanzelf: open op de server Startmenu → KoonScan → KoonScan inrichten (de inrichtcode staat dan al ingevuld).

