Funktionsweise

Damit Advoware und seine verschiedenen Module verwendet werden können, müssen entsprechende Lizenzen erworben werden. Diese Lizenzen werden vom Advoware Manager zentral verwaltet. Beim Start von Advoware wird z.B. versucht, eine Arbeitsplatzlizenz für das Produkt "advoware Kanzleisoftware" zu reservieren. Nur wenn eine Lizenz erfolgreich reserviert werden konnte, kann das entsprechende Advoware Modul auch verwendet werden. Es existieren unterschiedliche Arten von Lizenzen. Die wichtigsten sind Arbeitsplatzlizenzen und Netzwerklizenzen. Die erworbenen Lizenzen werden pro Kundennummer zu einer Lizenzdatei zusammengefasst. Diese Lizenzdateien werden von der advoware GmbH erzeugt und zur Verfügung gestellt und sind jeweils für einen Zeitraum von einem Monat gültig. Damit die Lizenzen verwendet werden können, muss die entsprechende Lizenzdatei im Advoware Manager eingespielt werden.

Advoware Manager

Der Advoware Manager ist als Windows Dienst umgesetzt und wird vom Advoware 6 Setup automatisch mit installiert. Falls eine manuelle Installation nötig sein sollte, so sollte diese möglichst an dem Computer erfolgen, auf dem auch der Advoware Datenbankserver (SQLBase 12.3.0) läuft. Der Advoware Manager macht sich im Kanzleinetzwerk per SSDP bekannt, so dass die verschiedenen Advoware Arbeitsplätze den Advoware Manager im Normalfall automatisch finden und verwenden können.

Arbeitsplatzlizenzen

Die Anzahl an Arbeitsplatzlizenzen gibt vor, an wie vielen unterschiedlichen Arbeitsplätzen gleichzeitig ein bestimmtes Modul verwendet werden kann. Wurden z.B. 3 Arbeitsplatzlizenzen "advoware Kanzleisoftware" erworben, so kann Advoware an 3 verschiedenen Arbeitsplätzen gleichzeitig verwendet werden. An diesen 3 Arbeitsplätzen kann Advoware  jeweils beliebig oft gestartet werden, z.B. um komfortabel in mehreren Datenpools zu arbeiten.

Zu den Arbeitsplatzlizenzen zählen folgende Module:

• advoware Kanzleisoftware
• advoware digitales Diktat
• advoware Notariat
• advoware Viewer

Netzwerklizenzen

Netzwerklizenzen sind bei der gleichzeitigen Nutzung von verschiedenen Arbeitsplätzen nicht beschränkt. Liegt eine Netzwerklizenz für ein bestimmtes Modul vor, so kann dieses Modul an beliebig vielen Arbeitsplätzen gleichzeitig verwendet werden. Eine Besonderheit bei Netzwerklizenzen gibt es im Zusammenhang mit Bürogemeinschaften.

Zu den Netzwerklizenzen zählen folgende Module:

• advoware Toolbox
• advoware online Akte
• advoware Inkasso

Einspielen einer Lizenzdatei

Um den Benutzer beim Einspielen einer Lizenzdatei in den Advoware Manager zu unterstützen, gibt es in der Advoware Kanzleisoftware den Lizenz-Assistenten. Dieser wird entweder automatisch beim Start von Advoware geöffnet, falls keine gültige Lizenzdatei gefunden werden konnte oder er kann manuell über das Advoware Hauptmenü → ? → Lizenzverwaltung → Lizenz-Assistent geöffnet werden. Der Lizenz-Assistent ist selbsterklärend gestaltet. Grundsätzlich werden 2 verschiedene Methoden zur Einspielung einer Lizenzdatei unterschieden.

Lizenzdatei anhand von Rechnungsdaten automatisch anfordern

Diese Methode funktioniert, wenn ein Update auf advoware 6 installiert wurde oder generell bei allen Kunden, die bereits eine Rechnung erhalten haben.

Manuelles Einspielen der Lizenzdatei

Ist bereits eine Lizenzdatei vorhanden, so kann diese auch direkt und ohne die Eingabe von Rechnungsdaten in den Advoware Manager eingespielt werden. Lizenzdateien sind nach folgendem Schema benannt: [Kundennummer].json wobei [Kundennummer] die 10-stellige Kundennummer ist. Ist keine Lizenzdatei vorhanden und kann auch die automatische Anforderung nicht durchgeführt werden, so kann eine Lizenzdatei vom Support angefordert werden. Dazu muss die Registrierungs-ID über die entsprechende Schaltfläche im Lizenz-Assistenten ausgegeben und an den Support übermittelt werden.

Löschen einer Lizenzdatei

Um eine Lizenzdatei zu löschen, muss der Advoware Manager angehalten werden, die entsprechende Lizenzdatei [Kundennummer].json aus %PROGRAMDATA%\Advo-web GmbH\advoware.manager\Lizenzdateien gelöscht und anschließend der Advoware Manager neu gestartet werden.

Advoware Manager im Kanzleinetzwerk

Automatisches Auffinden

Damit die Advoware Arbeitsplätze den Advoware Manager automatisch finden und verwenden können, müssen Manager und die Arbeitsplätze im gleichen Subnetzwerk miteinander verbunden sein. Weiterhin muss sichergestellt werden, dass  SSDP in diesem Subnetzwerk funktioniert und nicht von einer Firewall oder anderen Systemen unterbunden wird.

Falls die Suche per SSDP keinen oder mehr als einen Advoware Manager findet, so wird zusätzlich die sql.ini Konfigurationsdatei ausgewertet. Wird darin ein SQLBase-Server für die gewünschte Datenbank gefunden, so wird dessen IP-Adresse und der Standard TCP Port 8300 für die Verbindung zum Advoware Manager verwendet. Bei Installationen, in denen der Standard TCP Port des Advoware Manager geändert wurde, funktioniert dieser Mechanismus nicht mehr.

Adresse des Advoware Manager manuell konfigurieren

Unter bestimmten Bedingungen kann es notwendig sein, die IP-Adresse, unter der der Advoware Manager von den Arbeitsplätzen aus erreichbar ist, manuell zu konfigurieren. Dies kann u.a. in folgenden Fällen notwendig sein:

• SSDP funktioniert nicht
• Es gibt mehrere Advoware Manager im gleichen Subnetzwerk
• Ein Advoware Arbeitsplatz verbindet sich über einen VPN Tunnel in das Kanzlei Netzwerk

Die IP Adresse des Advoware Manager kann über einen bestimmten Eintrag vom Typ "Zeichenfolge" in der Windows Registrierungseditor vorgegeben werden. Dieser Eintrag ist im Standardlieferumfang nicht enthalten und muss manuell angelegt werden:

Schlüssel Windows Registrierung

Computer\HKEY_CURRENT_USER\SOFTWARE\Advo-ware\advowareManagerAddress

Der Wert dieses Eintrages muss derart gestaltet sein, das die IP Adresse und die Portnummer des Advoware Manager getrennt durch einen Doppelpunkt angegeben werden (ip:port).

Beispiel

192.168.99.1:8300

VPN Arbeitsplätze

Falls ein Arbeitsplatz per VPN auf den Datenbankserver und/oder den Advoware Manager zugreifen soll und an diesem Arbeitsplatz eine lokale Advoware-Installation existiert, so ist an diesem Arbeitspatz der Dienst "Advoware Manager" (sofern vorhanden) zu deaktivieren oder zu deinstallieren. Mehrere Advoware Manager im gleichen Netzwerk können zu Problemen führen und erfordern üblicherweise die manuelle Konfiguration der Advoware Manager Adresse.

Es sollte nur auf ausdrückliche Anweisung des Support eine Lizenzdatei an einem VPN Arbeitsplatz mit lokal installiertem und aktivem Advoware Manager eingespielt werden.

Bürogemeinschaften

In so genannten "Bürogemeinschaften" teilen sich mehrere Kunden einen Advoware Manager und oft auch einen Datenbankserver. Für diesen Fall können im Advoware Manager mehrere Lizenzdateien eingespielt werden.

Arbeitsplatzlizenzen

Die Anzahl der Arbeitsplatzlizenzen in Bürogemeinschaften ergibt sich aus der Summe der jeweiligen Lizenzen aller eingespielter Lizenzdateien. Wenn z.B. eine Bürogemeinschaft aus drei Kunden besteht, die jeweils drei Arbeitsplatzlizenzen für Advoware Kanzleisoftware erworben haben, so kann an neun verschiedenen Arbeitsplätzen gleichzeitig mit Advoware gearbeitet werden.

Netzwerklizenzen

Die Nutzung von Netzwerklizenzen in Bürogemeinschaften stellt einen Sonderfall dar. Siehe Zuordnung eines Datenpools zu einer Kundennummer

Zuordnung eines Datenpools zu einer Kundennummer

Damit geprüft werden kann, ob ein bestimmter Kunde einer Bürogemeinschaft eine bestimmte Netzwerklizenz erworben hat, müssen alle Datenpools einer Kundennummer zugeordnet werden. Die Zuordnung eines Datenpools zu einer Kundennummer wird bei der Anmeldung in Advoware erzwungen, sofern es sich um eine Bürogemeinschaft handelt bzw. mehr als eine Lizenzdatei vom advoware Manager verwendet wird.

Die Zuordnung ist endgültig und kann später nur noch durch den Support in begründeten Ausnahmefällen geändert werden!

1. Die gewünschte Kundennummer im Auswahlfeld unter "Lizenzdateien" auswählen.
2. Auf die Schaltfläche "Datenpool zuordnen" klicken.

Häufige Probleme

Zuordnung von Datenpools zu einer Kundennummer

Lösung: Siehe Zuordnung eines Datenpools zu einer Kundennummer

Die Lizenzverwaltung konnte nicht initialisiert werden

Lösung:

1. Prüfen ob der Advoware Manager fehlerfrei im gleichen Subnetzwerk läuft
2. Ist das der Fall, kann es helfen, die IP Adresse des advoware Manager manuell zu konfigurieren

Von der Lizenz *** wird bereits die maximale Anzahl verwendet

Dieser Fehler tritt auf, wenn von einer Arbeitsplatzlizenz bereits die maximal erlaubte Anzahl gleichzeitiger Nutzung erreicht ist. Mögliche Lösungen sind:

• Lizenzen an anderen Arbeitsplätzen frei geben z.B. in dem Advoware beendet wird
• Zusätzliche Lizenzen erwerben
• In Umgebungen, in denen mehr als ein Advoware Manager pro Subnetzwerk verwendet wird, kann es auch sein, dass versucht wird, vom falschen Manager Lizenzen zu reservieren. In dem Fall kann es helfen, die IP Adresse des advoware Manager manuell zu konfigurieren

Die Lizenz *** wurde nicht erworben!

Lösung:

• Lizenz erwerben
• In Umgebungen, in denen mehr als ein Advoware Manager pro Subnetzwerk verwendet wird, kann es auch sein, dass versucht wird, vom falschen Manager Lizenzen zu reservieren. In dem Fall kann es helfen, die IP Adresse des advoware Manager manuell zu konfigurieren

Bei der Anforderung der Lizenzdatei ist ein Fehler aufgetreten!

Das passiert u.a., wenn die Uhrzeit am Kunden-Server um mehr als 3 Minuten abweicht.

Kunde fällt in Notbetrieb

In der Logdatei steht:

2023-04-22 23:09:36.384 [ERR] (Renowin.AdvoNet.Advoware.Manager.Services.LicenseFileManager) HTTP Fehler beim Abrufen der Lizenzdatei für Kundennummer XXXXXXXXXX!
System.Net.Http.HttpRequestException: Response status code does not indicate success: 400 (Bad Request).
at System.Net.Http.HttpResponseMessage.EnsureSuccessStatusCode()
at Renowin.AdvoNet.ClientServer.Services.RestClient.GetToken(IdentityHMAC identityHMAC, CancellationToken cancellationToken) in D:\Work\renowin\OnlineTools\renowin.advonet\Renowin.AdvoNet.ClientServer\Services\RestClient.cs:line 143
at Renowin.AdvoNet.Advoware.Manager.Services.LicenseFileManager.DownloadLicense(Lizenzdatei lizenzdatei, CancellationToken stoppingToken) in D:\Work\renowin\OnlineTools\renowin.advonet\Renowin.AdvoNet.Advoware.Manager\Services\LicenseFileManager.cs:line 187
2023-04-22 23:09:36.394 [INF] (Renowin.AdvoNet.Advoware.Manager.Services.AdvowareSessionManager) Lizenzdatei wurde aktiviert, Kundennnummer XXXXXXXXXX.

Lösung: Serverzeit synchronisieren. Die Uhrzeit darf nicht mehr als 3 Minuten abweichen.

Die Lizenz advoware Inkasso konnte nicht reserviert werden

Betrifft Advoware Inkasso und andere zusätzliche Module.

Lösung: Hotline kontaktieren. Diese kann per SQL-Talk die Lizenzdatei der Kanzlei korrekt zuordnen.

Was ist zu prüfen, wenn die Lizenzverwaltung nicht aktiv ist?

Ein Problem ist, dass bei vielen der betroffenen Kanzleien das automatische Abrufen der verlängerten Lizenzdatei vom Lizenzserver durch den advoware Manager nicht klappt. Hierfür gibt es verschiedene Gründe:

1. Uhrzeit des Arbeitsplatzes mit Advoware Manager weicht um mehr als 2 Minuten ab
2. Firewall verhindert das Aufrufen von https://security.advo-net.net (intern)
3. Arbeitsplatz mit advoware Manager verfügt generell über keine Internetverbindung
4. unbekannte Probleme (Hotline)

Den Abruf der Lizenzdatei durch den Manager, kann man testen, in dem man in Advoware die Lizenzverwaltung öffnet (? -> Lizenzen -> Lizenzverwaltung) und auf "Aktualisieren" klickt. Dadurch werden alle vorhandenen Lizenzdateien erneut vom Lizenzserver abgerufen. Läuft dies zügig und ohne Fehler durch, so können die Lizenzdateien automatisch erneuert werden. Dauert der Vorgang länger als neun Sekunden oder kommt eine entsprechende Fehlermeldung, so liegt ein Problem vor. 

Wenn das Problem nicht behoben werden kann, benötigen wir die Protokolldateien vom Server. Aus den Protokolldateien kann durch die Entwicklung ausgelesen werden, was den Fehler verursacht hat. 

Die Registrierungs-ID der Lizenzdatei ist ungültig. 

Nach einem Serverumzug erhalte ich nach einspielen der *.json-Datei in der Lizenzverwaltung folgende Meldung:

Details: An unexpected error occurred invoking 'ActivateLicenseFile' on the server. AggregateException: One or more errors occurred. (Die Registrierungs-ID der Lizenzdatei ist ungültig!)

Die in der Lizenzdatei eingetragene Registrierungs-ID weicht von der auf unserem Freischaltserver vergebenen Registrierungs-ID ab.

Lösung: Die Lizenzdatei muss mit der richtigen Registrierungs-ID erneut erstellt werden. Die Registrierungs-ID finden Sie über den Lizenz-Assistenten - "Ich benutze Advoware zum ersten Mal" - "Ich habe noch keine Lizenzdatei erhalten". Die 128-stellige Registrierungs-ID übermitteln Sie dem Advoware-Support. Durch den Support erhalten Sie im Anschluss eine neue Lizenzdatei, diese kann dann über "Lizenzdatei öffnen" eingepflegt werden. 

Lizenzdatei verlängert sich nicht automatisch jeden Monat

Falls sich die Lizenzdatei nicht automatisch verlängert oder auch Änderungen an den Lizenzen nicht innerhalb von einer Stunde beim Kunden sichtbar werden, ist die Kommunikation zwischen dem Advoware Manager und dem Lizenzserver gestört. Die Ursache hierfür liegt in jedem Fall in einer zu restriktiven Netzwerk-Konfiguration beim Kunden durch z.B. Firewalls und/oder Proxyserver.

Lösung: Das Aufrufen der Seite https://security.advo-net.net/ im Browser dient als Test, ob die Firewall des Kunden korrekt konfiguriert ist und diese URL erreichbar ist. Wichtig hierbei ist, dass das auf der Maschine getestet wird, auf der auch der Advoware Manager Dienst läuft. Wenn die Anmeldemaske erscheint, ist der Test erfolgreich, die Kunden müssen sich aber niemals wirklich dort mit einem Microsoft Account anmelden.

Es gibt noch eine weitere URL, die vom Advoware Manager aus erreichbar sein muss, damit die Lizenzverwaltung funktioniert: https://www2.advo-net.net

Zum testen kann man hier folgende URL im Browser verwenden: https://www2.advo-net.net/AdvonetConfigurator/api/Url?Kanzlei=default

Wenn der Test erfolgreich ist wird im Browser eine Zeichenkette angezeigt, die wie folgt oder ähnlich aussieht:

{"relayUrl":"https://www2.advo-net.net:90/","connectorUrl":null,"securityGateway":"https://security.advo-net.net/"}

Schlägt einer der beiden Tests fehl so muss der Netzwerkadministrator des Kunden aktiv werden und dafür sorgen, dass die beiden URL’s per HTTPS Protokoll auf Port 443

https://security.advo-net.net

https://www2.advo-net.net

vom Advoware Manager Dienst aus erreichbar sind.

Wenn das Problem nicht behoben werden kann, benötigen wir die Protokolldateien vom Server. Aus den Protokolldateien kann durch die Entwicklung ausgelesen werden, was den Fehler verursacht hat. 

Die Lizenz für die Kundennummer [...] wurde wegen Mehrfachverwendung deaktiviert. Wenden Sie sich bitte an den Support.

Die Fehlermeldung erscheint, wenn im Advoware-System der Kanzlei mehr als ein Advoware Manager läuft. Der Advoware Manager darf nur auf dem Server laufen. Falls der Advoware Manager auf einem weiteren PC installiert ist, muss dieser beendet und deaktiviert werden. Im Idealfall deinstalliert man den Advoware Manager vom Rechner, der nicht der Server ist. 

Danach kann die Lizenz erneut freigeschaltet werden. 

Sollte die Meldung weiterhin auftauchen, kann mit Hilfe der Kundennummer ausgelesen werden, von welchem PC die Lizenz abgerufen wird. Diese Info kann über die Entwicklung abgefragt werden.