KoonSystemsKoonSystemsHelp
DE
ENNLDEESFR

Handbuch 2 · Kapitel 2

KoonScan installieren

Gilt für KoonScan Version 1.1.1Dieses Handbuch herunterladen (PDF)

Führen Sie dies auf dem Windows-Computer aus, auf dem KoonScan künftig laufen soll. Planen Sie 10 bis 20 Minuten ein. Dieses Kapitel verwendet das Installationsprogramm: der Weg für alle. Installieren Sie mit einem Skript? Dann lesen Sie unten Mit PowerShell installieren (für die IT).

Das Installationsprogramm herunterladen#

  1. Öffnen Sie auf dem Server das Kundenportal portal.koonsystems.com und melden Sie sich an.
  2. Klicken Sie links auf Downloads.
  3. Klicken Sie bei Windows-Installationsprogramm auf die Datei KoonScan-Setup-<version>.exe. Ihr Browser legt sie im Ordner Downloads ab.

Das Installationsprogramm ausführen#

  1. Öffnen Sie den Ordner Downloads.
  2. Doppelklicken Sie auf KoonScan-Setup-<version>.exe.
  3. Erscheint ein blaues Fenster „Windows protected your PC“? Dann klicken Sie auf More info 3. (Sehen Sie dieses Fenster nicht, machen Sie bei Schritt 5 weiter.)
  4. Klicken Sie auf Run anyway 4. Dieses Fenster erscheint, weil KoonScan noch keine digitale Signatur hat; das Programm ist sicher.
Windows protected your PCMicrosoft Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.3More info
Don't run
Windows protected your PCApp: KoonScan-Setup.exePublisher: Unknown publisher
4Run anywayDon't run
  1. Windows fragt: „Do you want to allow this app from an unknown publisher to make changes to your device?“ Klicken Sie auf Ja 5.
  2. Das Installationsprogramm startet in der Sprache von Windows. Lesen Sie die Geschäftsbedingungen, wählen Sie Ich akzeptiere die Vereinbarung 6 und klicken Sie auf Weiter 7.
User Account Control
Do you want to allow this app from an unknown publisher to make changes to your device?KoonScan-Setup.exe · Publisher: Unknown
5YesNo
Setup - KoonScan (for SAP B1)
LizenzvereinbarungAllgemeine Geschäftsbedingungen von KoonSystems …6Ich akzeptiere die VereinbarungIch lehne die Vereinbarung ab
< Zurück7Weiter >Abbrechen
  1. Ziel-Ordner wählen: Lassen Sie C:\KoonScan unverändert und klicken Sie auf Weiter 8.
  2. Port für Scanner und Telefone: Lassen Sie 5443 unverändert und klicken Sie auf Weiter 9. (Nur wenn Ihr IT-Dienstleister sagt, dass 5443 bereits belegt ist, wählen Sie eine andere Nummer.)
Setup - KoonScan (for SAP B1)
Ziel-Ordner wählenWohin soll KoonScan (for SAP B1) installiert werden?OrdnerC:\KoonScan
< Zurück8Weiter >Abbrechen
Setup - KoonScan (for SAP B1)
Port für Scanner und TelefoneÜber welchen Port erreichen die Geräte KoonScan (HTTPS)?Port:5443
< Zurück9Weiter >Abbrechen
  1. Datenbank: Lassen Sie die oberste Option Kein SQL Server nötig: KoonScan verwendet eine eigene Datenbankdatei (empfohlen) ausgewählt 10. Klicken Sie auf Weiter. (Mehr als 50 Scanner gleichzeitig? Dann wählen Sie SQL Server Express (Instanz KSCAN) installieren; siehe den Tipp unten.)
  2. Klicken Sie auf Installieren 11.
  3. Warten Sie, bis der Balken voll ist. Das dauert ein bis zwei Minuten; mit SQL Server Express 5 bis 15 Minuten, und der Balken steht zwischendurch manchmal still. Schließen Sie das Fenster nicht.
Setup - KoonScan (for SAP B1)
DatenbankWo speichert KoonScan seine Daten?10Kein SQL Server nötig: KoonScan verwendet eine eigene Datenbankdatei (empfohlen)SQL Server Express (Instanz KSCAN) installieren: empfohlen bei mehr als 50 Scannern gleichzeitig
< ZurückWeiter >Abbrechen
Setup - KoonScan (for SAP B1)
Bereit zur Installation.Das Setup ist jetzt bereit, KoonScan (for SAP B1) auf Ihrem Computer zu installieren.
< Zurück11InstallierenAbbrechen
  1. Auf dem letzten Bildschirm ist bei Einrichtungsassistenten im Browser öffnen 13 ein Häkchen gesetzt. Lassen Sie es aktiviert.
  2. Klicken Sie auf Fertigstellen 14.
Setup - KoonScan (for SAP B1)
Installiere … KoonScan (for SAP B1)
Abbrechen
Setup - KoonScan (for SAP B1)
Beenden des KoonScan (for SAP B1) Setup-AssistentenDas Setup hat die Installation von KoonScan (for SAP B1) auf Ihrem Computer abgeschlossen.13Einrichtungsassistenten im Browser öffnen
14Fertigstellen

Mit PowerShell installieren (für die IT)#

Für IT-Dienstleister, die mit einem Skript oder auf mehreren Servern installieren. Das Ergebnis ist dasselbe wie mit dem Installationsprogramm: der Windows-Dienst KoonScan, der Ordner C:\KoonScan und der Einrichtungsassistent. Kein IT-Profi? Verwenden Sie das Installationsprogramm oben.

Möglichkeit 1: das Zip-Paket

  1. Laden Sie im Kundenportal → Downloads die Zip-Datei koonscan-<version>.zip herunter und entpacken Sie sie, zum Beispiel nach C:\Temp\koonscan.

  2. Öffnen Sie in diesem Ordner PowerShell als Administrator (Rechtsklick → Als Administrator ausführen) und tippen Sie ein:

    Set-ExecutionPolicy -Scope Process Bypass
.\Install-KoonScan.ps1

  3. Das Skript kopiert die App nach C:\KoonScan\app, legt den Windows-Dienst, die Firewall-Regel und die Einstellungsdatei an, startet den Dienst und öffnet den Einrichtungsassistenten. Machen Sie weiter mit Kapitel 3.

Option Was sie bewirkt
-InstallDir D:\KoonScan Ein anderer Ordner (Standard C:\KoonScan).
-HttpsPort 5443 Port für die Geräte (Standard 5443; nicht 5080).
-NoBrowser Den Assistenten nicht öffnen; das Skript zeigt nur die Adresse (für einen Server ohne Desktop).

Das Skript erneut auszuführen ist sicher: Einstellungen, Zertifikate und die Datenbank bleiben erhalten. Das Zip enthält außerdem Update-KoonScan.ps1 für Updates (Kapitel 10) und appsettings.Local.example.json, ein Beispiel der Einstellungen für alle, die KoonScan ohne den Assistenten einrichten (Anhang B).

Möglichkeit 2: das Installationsprogramm ohne Rückfragen

KoonScan-Setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /DIR=C:\KoonScan /PORT=5443

Alle Optionen der stillen Installation stehen in Anhang B. Eine stille Installation gilt als Annahme der Geschäftsbedingungen. Der Assistent öffnet sich nicht von selbst: Öffnen Sie auf dem Server Startmenü → KoonScan → KoonScan einrichten (der Einrichtungscode ist dann bereits ausgefüllt).