Hilfen & Dokumentationen 1. WibuKey Konfiguration für camquix In dieser Anleitung erfahren Sie wie Sie Ihren WibuKey updaten und konfigurieren. 1.1. Was ist ein Wibu-Key und wozu wird er verwendet? WibuKey ist ein speziell programmierter USB-Stick, auch Dongle genannt, der zur Lizenzierung z.b. der camprox-software dient. Mittels einer Software auf dem Stick, werden dort Anzahl und Laufzeiten vorhandener Lizenzen in Form eines Schlüssels hinterlegt und verwaltet. Um zu gewährleisten, dass Sie parallel mehrere Versionen von camquix auf verschiedene Rechnern eines Netzwerkes verwenden können, sind die hier beschriebenen Einstellungen vorzunehmen. 1.2. WibuKey updaten Bevor Sie Einstellungen auf ihrem System für die Benutzung von WibuKey vornehmen, prüfen Sie zunächst, ob Sie auf allen Rechnern, auf denen Sie camquix verwenden, die aktuelle Version von WibuKey Installiert haben. Die aktuelle Version von Wibu für Ihren Windows-Rechner können Sie hier herunterladen: http://www.wibu.com/de/anwendersoftware.html oder auf unserer Website http://camprox.de/de/downloads.html. Achten Sie darauf, dass Sie die für Ihr System passende Version herunterladen. Um herauszufinden, um welches System es sich bei Ihrem Rechner handelt, folgen Sie auf Ihrem Rechner dem Pfad: Systemsteuerung\System und Sicherheit\System
Abbildung 1 Systeminformationen in Windows Abbildung 2 Systemtypinformationen in Windows Die Zeile Systemtyp zeigt Ihnen an, ob es sich bei Ihrer Windowsversion um ein 32- oder 64-Bit System handelt. ABBILDUNG 3 Laden Sie nun die passende Version von WibuKey herunter und folgen Sie nun den Installationsanweisungen. 2 von 21
Abbildung 3 Versionsauswahl von WibuKey Runtime auf der Wibu-Website 2. Verwendung von WibuKey Bei Start von camquix wird über die.exe-datei eine Suche nach Lizenzierungshardware, also z.b. dem Wibu Dongle durchgeführt. Zunächst werden alle Server gesucht, danach werden alle Ports nach Wibu-Dongles durchsucht. Wird ein sog. Slot, also ein Dongle auf irgendeinem Rechner im Netzwerk gefunden, wird im WibuKey Server Manager Studio eine Meldung folgender Art generiert: Connection L00020 ( camquix at Buero11) closed. Abbildung 4 Meldung im WibuKey Server Manager bei gefundenem Dongle 3 von 21
3. WibuKey-Einstellungen bei mehreren camquix-lizenzen Häufig kommt camquix auf mehrern Arbeitsplätzen zum Einsatz. Besitzen Sie mehrere Lizenzen von camquix werden in der Regel alle über einen Dongle verwaltet. Um eine problemlose Nutzung von camquix auf mehreren Rechnern sicherzustellen, nehmen Sie folgende Einstellungen vor. 3.1. Variante: 1 Dongle, 2 oder mehr Lizenzen von camquix Folgende Beschreibung gilt, wenn Sie mehrere Lizenzen von camquix auf mehreren Rechnern installiert haben. 3.1.1. Einstellungen in der Auswahl Computer der WibuKey Software Der Rechner in Ihrem Netzwerk, auf dem der Wibudongle steckt, muss die die WibuKey Serversoftware installiert haben. Informationen dazu finden Sie auf Seite 1. Damit alle weiteren Rechner auf diesen zugreifen können, sind nachfolgend beschriebene Einstellungen vorzunehmen. 3.1.1.1. Einstellungen in der Auswahl Computer des SERVERS Der Rechner im Netzwerk, in dem Ihr Dongle steckt, muss so eingestellt werden, dass alle anderen Rechner, auf denen camquix in der Vollversion laufen soll, darauf zugreifen können. Innerhalb der WibuKey-Software fungiert dieser Rechner daher als sog. Server. Ganz egal, ob dieser Rechner auch Ihr firmeninterner Server ist. Doch in den meisten Fällen ist der Firmenserver gleichzeitig der WibuKey-Server. 4 von 21
Auswahl Computer Wählen Sie Computer im Drop-Down-Menü und setzen Sie einen Haken im Feld WibuKey Subsysteme. bei WkLAN Tragen Sie im Feld WkLAN Serversuchliste Subsysteme localhost ein und bestätigen Sie Ihre Änderungen durch einen Klick auf Übernehmen. Abbildung 5 Einstellungen in der Auswahl Computer des Servers 5 von 21
3.1.1.2. Einstellungen in der Auswahl Computer des CLIENTS In der Registerkarte Computer des oder der Clients (Rechner im Netzwerk, die auf den entfernten Dongle zugreifen) sollten Sie folgende Benutzereinstellungen vornehmen. Auswahl Computer Setzen Sie einen Haken im Feld WibuKey Subsysteme bei WkLAN Tragen Sie im Feld WkLAN Serversuchliste Subsysteme die IP- Adresse des Servers ein und bestätigen Sie Ihre Änderungen durch einen Klick auf Übernehmen. Abbildung 6 Einstellungen in der Auswahl Computer des Clients, Mehrplatzlizenz Wie Sie Ihre IP ermitteln, lesen Sie in Abschnitt 5 IP-Adressen des Servers ermitteln nach. 6 von 21
3.1.2. Einstellungen in der Auswahl Benutzer der WibuKey Software In der Registerkarte Benutzer sowohl des Servers als auch des Clients sollten Sie folgende Einstellungen vornehmen: Auswahl Benutzer Entfernen Sie alle Haken im Feld WibuKey Subsysteme Eintragungen hier entfernen Entfernen Sie alle Eintragungen im Feld WkLAN Serversuchliste Subsysteme Abbildung 7 Einstellungen in der Auswahl Benutzer des Servers und Clients, Mehrplatzlizenz Für den unwahrscheinlichen Fall, dass in der Registerkarte Benutzer ein Eintrag vorgenommen wird, sollte dieser derselbe sein wie in der Registerkarte Computer. Wird keine IP angegeben, obwohl in der linken Spalte ein Haken gesetzt wurde, wird eine Suche nach dem Server ausgelöst, was zu Verzögerungen beim Programmstart führen kann. 7 von 21
3.2. Variante: 1 Dongle, 1 Lizenz von camquix 3.2.1. Einstellungen in der Auswahl Computer der WibuKey Software Mit diesen Einstellungen gewährleisten Sie, dass camquix von allen unter Windows angemeldeten Benutzern auf dem Computer, auf dem die Einstellungen vorgenommen werden, verwendet werden kann. Abbildung 8 Einstellungen in der Auswahl Computer des Clients, Einplatzelizenz 8 von 21
3.2.2. Einstellungen in der Auswahl Benutzer der WibuKey Software In der Registerkarte Benutzer sollten Sie folgende Einstellungen vornehmen. Entfernen Sie ggf. alle Haken im Feld WibuKey Subsysteme Entfernen Sie ggf. alle Eintragungen im Feld WkLAN Serversuchliste Subsysteme Eintragungen hier entfernen Abbildung 9 Einstellungen in der Auswahl Benutzer des Servers und Clients, Einplatzlizenz Werden benutzerspezifische Einstellungen vorgenommen, funktioniert camquix nur für den aktuell auf diesem PC unter Windws angemeldeten Benutzer. Da in der Praxis verschiedene Mitarbeiter mit jeweils einem eigenen Benutzerkonto in Microsoft auf die camquix-aufträge zugreifen, ist es sinnvoll die Wibu-Einstellungen immer computerbezogen -also benutzerübergreifend- vorzunehmen. Die notwendigen Einstellungen finden Sie in Abschnitt 5 IP-Adressen des Servers ermitteln. 9 von 21
3.3. Virtuelle Systeme Betreiben Sie WibuKeyRuntime auf einem virtuellen System, muss in der Konfiguration Ihrer Verwaltungssoftware dieser Systeme (z.b. Hyper-V, Oracle VirtualBox und VMware Player) die Freigabe des Dongles eingestellt werden, damit zwischen dem physikalischen Dongle auf dem Mutterbetriebssystem und der Verwaltungssoftware der virtuellen Maschinen eine Verbindung hergestellt werden kann. Sobald diese Einstellung erfolgt ist, können Sie ein beliebiges virtuelles System als Server oder Client für den WibuKey verwenden. Dabei ist lediglich darauf zu achten, dass alle Systeme, die WibuKey Runtime in der Clientversion betreiben bzw. als Client auf den Dongle zugreifen wollen, konsequent auf denselben physikalischen oder virtuellen Rechner verweisen, der als Server für den Dongle dient. Außerdem sollten alle virtuellen Rechner die aktuelle Version von WibuKey Runtime haben. Informationen zum Download finden Sie im Abschnitt 1.2WibuKey updaten. 10 von 21
4. Fehleranalyse & -dokumentation Kann camquix beim Programmstart keinen Dongle finden, erhalten Sie eine entsprechende Fehlermeldung s. Abbildung 10. Für den Fall, dass Sie eine gültige Lizenz besitzen, befolgen Sie die im Folgenden beschriebenen Schritte. Falls Ihre Lizenz abgelaufen ist oder Sie nicht sicher sind, ob diese noch gültig ist, rufen Sie uns unter +49 (0) 721 120 88 24 an. Zum Beheben dieses Fehlers müssen maximal folgende 4 Schritte ausgeführt werden: 1. WibuKey Software konfigurieren wie ab Kapitel 1 beschrieben 2. Wibu Server Manager Dienst neu starten 3. Dongle ziehen und wieder stecken 4. camquix im Debug-Modus starten Fehleranalyse für den Fall, dass trotz dieser Einstellungen camquix immer noch mit folgender Fehlermeldung gestartet wird: Abbildung 10 Fehlermeldung: camquix findet keinen Dongle 4.1. Wibu Server Manager Dienst neu starten Sollten trotz der o.g. Schritte weiterhin diese Fehlermeldung erscheinen, starten Sie den Wibu Server Manager Dienst neu. 11 von 21
Abbildung 11 Start der Systemsteuerung Abbildung 12 Start der Systemeinstellungen 12 von 21
Abbildung 13 Start der Verwaltung 13 von 21
Abbildung 14 Start der Dienste-Übersicht 14 von 21
Abbildung 15 Dienste Sollte auch danach camquix wieder mit der Fehlermeldung starten, ziehen Sie den Dongle aus dem Server oder dem lokalen Rechner und stecken Sie ihn wieder ein. 15 von 21
4.2. Starten von camquix im Debug-Modus Bitte beachten Sie, dass diese Funktion erst ab Version 1.43 verfügbar ist. Zusätzlich empfehlen wir Ihnen camquix im Debug-Modus zu starten. In diesem speziellen Modus wird automatisch ein Protokoll über verschiedene Systemvorgänge erzeugt. Dieses Protokoll ist für unsere Entwickler bei der Fehlersuche hilfreich. Um camquix im Debug-Modus zu starten, gibt es mehrere Varianten. 4.2.1. Hilfe-Modus im Ausführen-Dialog starten Für den Hilfedialog geben Sie "C:\[Dateipfad von camquix]" h "C:\Program Files (x86)\camquix\camquix143.exe" h ein und bestätigen mit OK. Abbildung 16 camquix im Hilfe-Modus im Ausführen-Dialog starten 16 von 21
4.2.2. Debug-Modus im Ausführen-Dialog starten Rufen Sie die Eingabeaufforderung durch gleichzeitiges Drücken der Windows-Taste + R auf und geben Sie folgenden Befehl ein: "C:\[Dateipfad von camquix]" d "C:\Program Files (x86)\camquix\camquix143.exe" d und bestätigen mit OK. Abbildung 17 camquix im Debug-Modus im Ausführen-Dialog starten 17 von 21
Die daraufhin erzeugte Datei CxDebugLog.txt liegt im Verzeichnis des beim Starten von camquix im Debug-Modus angemeldeten Benutzers. Abbildung 18 CxDebugLog.txt in den benutzerspezifischen Windowsdateien Abbildung 19 CxDebug.txt 18 von 21
Die Maßnahmen sind einzeln durchzugehen und nach jeder Änderung, die einer Maßnahme der unten stehenden Liste entspricht, ist der Wibu-Dienst neu zu starten und ggf. der Rechner. Achtung: Der Neustart Ihres Servers sollte nur von einem Netzwerkadministrator durchgeführt werden, da es sonst zu schwerwiegendem Datenverlust kommen kann: 1. Neustart des Wibu Dienstes 2. Hinzufügen der IP-Adresse Ihres Servers und Entfernen des Servernamens 5. IP-Adressen des Servers ermitteln Bei Mehrfachlizenzen von camquix, die zentral über einen Dongle verwaltet werden, ist auf der WibuServer-Konfiguration die Eingabe der entsprechenden IP-Adresse nötig. Sollten Sie die IP-Adresse Ihres Servers nicht kennen, rufen sie das Programm cmd.exe auf. Das Programm befindet sich bei der 64bit-Version von Windows 7 in diesem Verzeichnis: C:\Windows\System32\cmd.exe. Alternativ starten Sie das Programm, indem Sie cmd in die Windows-Suchleiste eingeben. 19 von 21
Abbildung 20 Daraufhin öffnet sich das Programmfenster. Abbildung 21 20 von 21
Geben Sie in an die Stelle des blinkenden Cursors den Befehl ipconfig ein. Daraufhin werden Ihnen alle wichtigen IP-Adressen angezeigt. Abbildung 22 In der Zeile IPv4-Adresse können Sie in der rechten Spalte die IP-Adresse Ihres lokalen Rechners ablesen. 6. IP-Adresse und Servernamen ermitteln Geben Sie in an die Stelle des blinkenden Cursors im Ausführen-Fenster (s. 5 IP-Adressen des Servers ermitteln) den Befehl nslookup ein. Wie Sie dieses öffnen, wird unter Punkt 4 beschrieben. Daraufhin werden Ihnen Name und IP- Adresse Ihres Servers angezeigt. Abbildung 23 21 von 21