Testumgebung
Client-Einrichtung unter Windows
Programme für Windows 10 und 11 – je ein Installationspaket (MSI), ohne zusätzliche Laufzeitumgebung.
Zunächst steht die Administrationskonsole bereit. Weitere Programme (Arbeitsplatz-Client, Remotedienste) erscheinen hier, sobald auf dem Server eine Lizenz eingespielt ist.
1. Herunterladen
dj client für Windows …
Installationspaket laden Prüfsummendatei (.sha256) Zertifikat (.cer)
Prüfsumme (SHA-256): …
Das Paket ist mit einem eigenen Zertifikat von documentjoe signiert, das Windows nicht von sich aus kennt. Meldet der Browser beim Herunterladen
deshalb eine Gefahr, belegt die Prüfsumme, dass die Datei unverändert ist.
Dieser Befehl in der PowerShell vergleicht sie selbst und antwortet mit True (in Ordnung) oder False:
Nur die Prüfsumme anzeigen: Get-FileHash … -Algorithm SHA256
dj adminconsole für Windows …
Die Administrationskonsole für Global- und Domain-Admins. Gleiches Zertifikat, gleicher Ablauf wie beim Client.
Installationspaket laden Prüfsummendatei (.sha256)
Prüfsumme (SHA-256): …
2. Zertifikat einmalig importieren
Damit Windows documentjoe als Herausgeber anerkennt, das Zertifikat einmal importieren – in „Vertrauenswürdige Stammzertifizierungsstellen“ und „Vertrauenswürdige Herausgeber“. Es taugt nur zum Signieren von Programmen, nicht für Webseiten oder E-Mail.
Zertifikat „…“, gültig bis …,
Fingerabdruck (SHA-1): …
Beide Befehle prüfen zuerst den Fingerabdruck und importieren nur, wenn er stimmt. Die Datei liegt nach dem Herunterladen im Ordner „Downloads“.
a) Für alle Benutzer des Rechners
PowerShell als Administrator öffnen und einfügen:
b) Nur für den angemeldeten Benutzer
Ohne Administratorrechte, in einer normalen PowerShell. Windows fragt beim Stammzertifikat einmal nach; mit Ja bestätigen. Gilt nur für diesen Benutzer – andere Benutzer des Rechners sehen weiter die Warnung.
Von Hand: Die Datei doppelklicken, unter Details den Fingerabdruck vergleichen, dann Zertifikat installieren – je einmal in beide Speicher. In einer Domäne lässt es sich per Gruppenrichtlinie verteilen (Computerkonfiguration → Richtlinien → Windows-Einstellungen → Sicherheitseinstellungen → Richtlinien für öffentliche Schlüssel, dort in beide Speicher).
3. Installieren
- Die heruntergeladene Datei doppelklicken.
- Zeigt Windows trotzdem „Der Computer wurde durch Windows geschützt“ (das kann vorkommen, solange das Zertifikat nicht importiert ist oder Windows die Datei noch nicht kennt): auf Weitere Informationen und dann Trotzdem ausführen klicken. Als Herausgeber muss dort documentjoe stehen.
- Die Installation läuft für den angemeldeten Benutzer; mit Administratorrechten auch für alle Benutzer des Rechners.
Start: Startmenü „dj admin“ (und „dj client“, sobald es bereitsteht).
4. Anmelden
- Beim ersten Start die Server-Adresse eintragen:
- Benutzername und Passwort eingeben und auf „Anmelden“ klicken.
- Den Mandanten wählen und „Öffnen“. Über Datei → Mandant wechseln kannst du jederzeit zu einem anderen Mandanten wechseln.
5. Aktualisieren
Die Programme fragen den Server selbst nach neuen Versionen und bieten sie zum Installieren an. Du kannst auch jederzeit das neueste Paket hier herunterladen und darüber installieren; deine Einstellungen bleiben erhalten.
6. Lokale Updateverteilung
Statt vom Server können die Clients ihre Updates aus einem freigegebenen Ordner im eigenen Netz holen. In den Ordner gehören genau drei Dateien:
- Installationspaket (.msi)
- Prüfsummendatei (.sha256) – der Client prüft das Paket damit und bricht ab, wenn sie nicht stimmt
- latest – enthält nur die Versionsangabe, z. B.
v0.x.y
latest immer zuletzt in den Ordner legen: Erst dann bieten die Clients die neue Version an. Diese PowerShell-Befehle laden alle drei Dateien
in der richtigen Reihenfolge in den Ordner (Pfad vorher anpassen):
Im Client unter Einstellungen → Updates als Update-Quelle den Ordner eintragen, z. B. \\dateiserver\software\dj-msclient
(auch ein Laufwerk wie D:\software\dj-msclient oder eine eigene https://-Adresse). Leer bedeutet: direkt von diesem Server.
Die Benutzer brauchen auf den Ordner nur Leserechte.
Handbuch
Das Anwenderhandbuch beschreibt Anmelden, Suchen, Ansehen, Bearbeiten, Erfassen und Scannen, Weitergeben und die Kurzprozesse – mit Bildschirmfotos und allen Tastenkürzeln. Es gehört zur jeweils neuesten Programmversion und enthält am Ende die Lizenzhinweise.
Handbuch Client für Windows (PDF) Handbuch Administrationskonsole (PDF)
7. Remotedienste (Serverinstallation)
Für einen entfernten Windows Server, nicht für Arbeitsplätze: dj printservice, der Druckdienst, stellt Archivdrucker bereit (gedruckt wird als PDF in den Mandanten), dj fetchservice, der Dateiabholer, holt Dateien aus freigegebenen Ordnern ab. Beide laufen als Windows-Dienst und verbinden sich von sich aus mit diesem Server. Gleiches Zertifikat wie oben.
dj printservice (Druckdienst) …
Installationspaket laden Prüfsummendatei (.sha256)
Prüfsumme (SHA-256): …
dj fetchservice (Dateiabholer) …
Installationspaket laden Prüfsummendatei (.sha256)
Prüfsumme (SHA-256): …
dj Remotedienste (Bedienfenster) …
Installationspaket laden Prüfsummendatei (.sha256)
Prüfsumme (SHA-256): …
Eine kleine Oberfläche für beide Dienste auf demselben Rechner: Zustand (Dienst, Verbindung, Server, Version), die vom Server angelegten Drucker bzw. Abholer, das Protokoll (mit „Nur Probleme“ und „Protokoll kopieren“) und die Kopplung („Koppeln …“ mit Server-Adresse und Code, „Kopplung lösen …“). Das Protokoll darf jeder angemeldete Benutzer lesen; Koppeln und Lösen fragen als Administrator nach (Benutzerkontensteuerung). Das Paket installiert pro Benutzer oder pro Rechner, im Startmenü erscheint „dj Remotedienste“. Es ersetzt nicht die Dienste: erst dj printservice bzw. dj fetchservice installieren.
Mit Doppelklick: Das Installationspaket (ab dj printservice 0.2.4 und dj fetchservice 0.1.3) fragt in einem Schritt „Mit dem Server koppeln“ nach der Server-Adresse und dem Kopplungscode. Beide Felder leer lassen heißt: nur installieren. Den Code erzeugt die Administrationskonsole unter Grundsystem › Remotedienste › „Remotedienst koppeln …“ (er gilt 15 Minuten und nur einmal).
Koppeln auf der Befehlszeile: In der Administrationskonsole unter Grundsystem › Remotedienste › „Remotedienst koppeln …“ einen Code erzeugen, dann in einer PowerShell als Administrator (Dateiname anpassen):
Ohne CODE wird nur installiert; der Dienst startet erst nach der Kopplung. Bei dj fetchservice nach der Installation die Wurzelordner
freigeben (gilt sofort): & "C:\Program Files\documentjoe\dj-fetchservice\dj-fetchservice.exe" roots add D:\Scans – nur darunter darf abgeholt werden.