Lizenzmanagement

Die wesentlichen Features dieser opsi-Erweiterung sind:

Ein Lizenzmodell legt fest, wer eine Software in welcher Form nutzen darf (siehe Abschnitt Lizenzmodell konfigurieren). Dabei gibt es ganz unterschiedliche Ansätze, wie die Softwarehersteller das regeln:

Wenn der opsi-Server die Zuteilung der Lizenzen steuert, ist sichergestellt, dass die Lizenz und gegebenenfalls der Schlüssel bei der Deinstallation der Software auch wieder freigegeben werden. Die Zuordnung von Lizenzen kann darüber hinaus auch manuell oder sogar skriptgesteuert erfolgen, z. B. wenn eine Lizenz nicht mit opsi verteilt worden ist.

Lizenzverwaltung ist ein komplexes Thema. opsi setzt auf ein relativ komplexes Datenbankmodell, um die Lizenzen und ihre Schlüssel zu verwalten. Zur besseren Übersicht stellt das folgende Diagramm die beteiligten Tabellen dar. Die blaue Linie markiert die Abgrenzung von Tabellen, deren Inhalte automatisiert aus dem Software-Audit kommen, und Tabellen, deren Daten eigens zur Lizenzverwaltung erhoben oder zugeordnet werden. Nur die Lizenzpool-Datenbank hat Verbindungen zu beiden Bereichen, was auf die Bedeutung dieses Konstrukts hinweist.

Das Diagramm zeigt außerdem die Bedeutung der Lizenzpools (license pools), die der Abschnitt Lizenzpools ausführlich erklärt.

Die Management-Oberfläche opsi-configed bietet eine eigene Abteilung für das Lizenzmanagement an. Sie erreichen den Dialog über die Schaltfläche Lizenzen im Hauptfenster. Voraussetzung ist, dass das die Erweiterung installiert und aktiviert ist. Sie überprüfen das über das Menü Hilfe / Module im Hauptfenster.

Das Dialogfenster zur Lizenzverwaltung zeigt am oberen Rand sechs Reiter an:

Die folgenden Abschnitte erklären die einzelnen Dialoge und ihre Funktionen.

Für jede Art von Lizenz, die Sie mit dieser Erweiterung verwalten möchten, richten Sie einen eigenen Lizenzpool ein. Dieser beschreibt die Zusammenfassung von Berechtigungen, die benötigt werden, um eine bestimmte Art von Software legal zu installieren. Der Lizenzpool steht im Mittelpunkt aller Aktivitäten des opsi-Lizenzmanagements:

Ganz oben im Bereich Lizenzpools finden Sie eine zweispaltige Tabelle, die alle verfügbaren Lizenzpools auflistet. Das Feld description können Sie bearbeiten und dort eigene Beschreibungen eintragen.

Weitere Funktionen zum Bearbeiten erreichen Sie über das Kontextmenü der rechten Maustaste. Über die dort angezeigten Einträge legen Sie einen neuen Pool an, löschen einen vorhandenen, speichern oder verwerfen die Änderungen und laden die Daten neu.

Beim Erzeugen eines neuen Pools, also beim Anlegen einer neuen Zeile in der Tabelle, tragen Sie eine (eindeutige) licensePoolId in das entsprechende Feld ein, beispielsweise pool_fuer_x.

Anders als die Beschreibung, können Sie die Pool-ID nur bis zum ersten Speichervorgang bearbeiten. Danach ist sie als Schlüssel des Datensatzes unveränderlich. Das Löschen eines Eintrags ist nur dann möglich, wenn es keine Referenz auf diesen Schlüssel in anderen Tabellen gibt. Die rekursive Suche nach solchen Referenzen wird derzeit nicht unterstützt.

Jeder Bearbeitungsvorgang verändert die Statusanzeige der beiden Schaltflächen OK und Cancel. Das grüne Häkchen des OK-Buttons erscheint in Rot, und der Cancel-Button wird aktiviert. Betätigen Sie eine der beiden Schaltflächen oder wählen Sie den entsprechenden Eintrag aus dem Kontextmenü der rechten Maustaste aus, um Ihre Änderungen zu speichern oder zu widerrufen.

Normalerweise gehört zu einem opsi-Produkt, das eine lizenzpflichtige Software installiert und dabei das Lizenzmanagement nutzen soll, genau ein Lizenzpool, aus dem die benötigten Lizenzen geschöpft werden. Es ist möglich, dass mehrere Produkte auf denselben Lizenzpool verweisen, wenn es sich z. B. um Varianten desselben Produktes handelt. So nutzen beispielsweise die Produkte win10-x64 und opsi-local-image-win10-x64 beide den Pool p_win10-x64.

Weniger übersichtlich ist die Situation, wenn ein opsi-Produkt mehrere lizenzpflichtige Software-Produkte installiert und daher Lizenzen von mehreren Pools benötigt. Angenommen, zu einem Paket namens Designprogramme gehören Adobe Photoshop und Adobe Writer, muss das opsi-Produkt Lizenzen aus zwei unterschiedlichen Pools anfordern. Im Prinzip liegt diesen Zuordnungen ein n:m-Schema zugrunde.

Die zweite Tabelle von oben im Dialog Lizenzpools (siehe [licensemanagement-licensepools.png]) zeigt alle Zuordnungen zwischen den Lizenzpools und den Produkt-IDs der opsi-Produkte. Klicken Sie auf den Spaltentitel licensePoolId bzw. productId, um die Ansicht zu sortieren. So können Sie alle Zuordnungen von opsi-Produkten zu einem Lizenzpool bzw. alle einem opsi-Produkt zugewiesenen Lizenzpools zusammenhängend darstellen.

Einen neuen Eintrag, also eine neue Zuordnung eines Lizenzpools zu einer Produkt-ID, erstellen Sie über das Kontextmenü der rechten Maustaste. Nach einem Klick ins Tabellenfeld sehen Sie die Liste der verfügbaren Werte.

Die untere Hälfte des Lizenzpools-Dialogs (siehe [licensemanagement-licensepools.png]) stellt die Beziehungen zwischen Lizenzpools und der installierten Software auf den opsi-Clients dar — egal, ob diese mit opsi-Werkzeugen oder auf einem anderen Weg installiert wurde. In den einzelnen Spalten sehen Sie zunächst eine eindeutige ID, die aus einer Kombination aller Attribute konstruiert ist und als eindeutiger Schlüssel fungiert. Es folgen Informationen zur Software, darunter den Namen, die Versionsnummer, das Betriebssystem, die Architektur usw.

Die Werte ermittelt das opsi-Software-Audit (siehe Abschnitt Hard- und Software-Inventarisierung mit hwaudit und swaudit); es liest Informationen aus der Registry aus und meldet diese an den opsi-Server zurück. Die Tabelle SOFTWARE_CONFIG der opsi-Datenbank speichert die Werte für jeden Client. Sofern noch nicht vorhanden, werden sie in die Tabelle SOFTWARE aufgenommen. Diese bildet die Grundlage für die im Lizenzmanagement angezeigte Tabelle.

Welche Daten Sie in der Tabelle unten im Lizenzpools-Dialogs sehen, bestimmen zwei verschiedene Ansichten:

Sie sehen hier also alle Zuweisungen von Software-Items (aus der Datenbanktabelle SOFTWARE) zu einem Lizenzpool (Tabelle LICENSE_POOL). Sämtliche Einträge, die zum in der oberen Tabelle ausgewählten Lizenzpool gehören, erscheinen als farblich hinterlegte, markierte Zeilen. Alle Zuordnungen von Pools und Software entsprechen der Datenbanktabelle AUDIT_SOFTWARE_TO_LICENSE_POOL.

Eine Veränderung bei den blau unterlegten Zeilen bedeutet eine Datenänderung. Daher verhalten sich die Funktionen zur Navigation in der Tabelle anders als sonst. Ein rotes Sternchen am Zeilenanfang markiert den Ort, an dem der Cursor steht.

Um den Cursor neu zu platzieren, stehen Ihnen folgende Möglichkeiten zur Verfügung:

Mit der Zuordnung von Software-Items zu Lizenzpools haben Sie bereits die Grundlage für den von Microsoft geforderten Compliance-Check geschaffen. Das Prinzip ist einfach: Mit ein paar Mausklicks markieren Sie die Software-Items in einem bestimmten Pool. Um die Gesamtzahl der einem Pool zugeordneten Installationen zu ermitteln, öffnen Sie den Reiter Statistik (siehe Abschnitt Statistik).

Über das Kontextmenü der rechten Maustaste erreichen Sie Funktionen zum Filtern der zugeordneten Software-Items. Sie können entweder alle oder nur die markierten Einträge anzeigen.

Das ist hilfreich, da die Zeilen der zugeordneten Software-Items nicht unbedingt aufeinanderfolgen in der Software-Tabelle. Nachdem Sie Nur markierte Einträge zeigen ausgewählt haben, verändert sich die Anzeige:

Alternativ verwenden Sie das Filter-Icon neben dem Suchfeld. Wenn ein Filter aktiv ist, erscheint das Symbol durchgestrichen.

Wenn der Hersteller einer Software eine neue Version, ein Update oder einen Patch verteilt, erhält die neue Variante auch eine neue Windows-Software-ID. Daher gibt es danach auch einen neuen Eintrag in der Software-Tabelle mit einer neuen ID. Was die Lizenz betrifft, ist die neue Version in der Regel genauso zu behandeln wie die alte — wenn es einen Lizenzvertrag für die Vorgängerversion gab, existiert wahrscheinlich auch einer für den Nachfolger. Das heißt, dass der Bedarf für eine Lizenzierung für beide Ausgaben in demselben Lizenzpool angemeldet werden muss. Eine Abdeckung wird dann über den gemeinsamen Lizenzpool organisiert.

Beim Ausrollen neuer Versionen sollten Sie daher daran denken, eine Zuordnung zum richtigen Lizenzpool hinzuzufügen. Natürlich gibt es auch Software, die Updates ohne Ihr Zutun einspielt — dann fehlt nach der Aktualisierung eventuell die korrekte Zuordnung. Für diese Fällte bietet die Management-Oberfläche opsi-configed ab Version 4.1.9.8 einen eigenen Dialog, der die Vervollständigung erleichtert. Sie öffnen das Fenster per Klick auf die Schaltfläche Name → Pool in der unteren Hälfte des Lizenzpools-Reiters.

Der Dialog zeigt zwei weitere Tabellen an. Wenn Sie vor dem Öffnen die Standardeinstellung Alle Software-Namenseinträge anzeigen aktiviert haben, zeigt die erste Spalte der ersten Tabelle die Softwarenamen alphabetisch sortiert an. Die zweite Spalte listet alle IDs auf, die mit dem jeweiligen Namen verbunden sind (wobei der Name als eigentlich erster ID-Bestandteil nicht wiederholt wird).

Die zweite Tabelle listet zum in der ersten Tabelle ausgewählten Namen die IDs einzeln auf. Für jede ID zeigt sie an, ob eine Zuordnung zu einem Lizenzpool besteht und wie dieser heißt. Die Lizenzpool-Zuordnungen können Sie so vereinheitlichen:

Wenn Sie systematisch die Lizenzpool-Zuordnungen überprüfen möchten, sollten Sie vor dem Klick auf die Schaltfläche Name → Pool im Hauptfenster die Option Nur Namen mit varianter Zuordnung zu Lizenzpool aktivieren. Die Tabelle im sich öffnenden Dialog zeigt nun nur die Softwarenamen an, zu denen es mehrere IDs gibt und für die unterschiedliche Lizenzpool-Zuordnungen existieren.

Die dritte Option (Nur Namen ganz ohne Lizenzpoolzuordnung) ermöglicht Ihnen, nach eventuell vergessenen Zuordnungen von Lizenzen zu suchen.

Selbstverständlich ist es möglich, sämtliche installierten Anwendungen einem Lizenzpool zuzuweisen — auch freie Software. Wenn Sie dann eine neue Software bzw. eine neue Version einer vorhandenen installieren, sind bisher nicht zugeordnete Software-Items gut identifizierbar.

opsi-configed bietet für solche Szenarien zusätzliche Anzeigeoptionen an (siehe auch Software-Tabelle: Konfiguration der Anzeige):

Angenommen, Sie haben bisher sämtliche Software einem Lizenzpool zugeordnet, dann sehen die einzelnen Arbeitsschritte so aus:

Anders sehen die Arbeitsschritte aus, wenn Sie beliebige, noch nicht zugeordnete Software-Items auf Lizenzpools verteilen möchten:

Zunächst sollten einige wichtige Begriffe geklärt werden:

Lizenzierung (licensing) ist die faktische Zuweisung der Erlaubnis, eine Software zu nutzen. Dazu gehört auch die Installation. Oft, aber nicht immer, ist dafür ein Lizenzschlüssel (license key) erforderlich.

Das Lizenzierungsrecht ist die in ihrem Geltungsumfang definierte Erlaubnis, solche Zuweisungen durchführen zu dürfen. In der opsi-Datenbank entspricht die software license dem Lizenzierungsrecht. Der Datensatz heißt dementsprechend softwareLicenseId. Wie das Lizenzierungsrecht genau aussieht, also für wie viele Rechner und wie lange eine Lizenz gültig ist, beschreibt das Lizenzmodell (licensing model). Der Lizenzvertrag (license contract) stellt das Lizenzierungsrecht im juristischen Sinn fest und dokumentiert es.

Eine Lizenzierungsoption (licensing option) definiert die Möglichkeit, ein Lizenzierungsrecht für einen bestimmten Lizenzpool anzuwenden. Die Kombination aus softwareLicenseId und licensePoolId legt unter opsi diese Lizenzierungsoption fest. Zur Lizenzierungsoption gehört auch der Wert eines Lizenzschlüssels (licenseKey), sofern dieser für die Installation erforderlich ist.

Die Lizenznutzung (license usage) dokumentiert die Anwendung einer Lizenzierungsoption für einen Client, sie ist also die vollzogene und berechtigte Lizenzierung einer Software-Installation. Die Beschreibung setzt sich zusammen aus softwareLicenseId, licensePoolId und hostId (eindeutiger Name des opsi-Clients). Zusätzlich wird der verwendete Lizenzschlüssel notiert (licenseKey).

Nachdem Sie den Lizenzpool ausgewählt haben, für den Sie eine Lizenzierungsoption anlegen wollen, bestimmen Sie nun den Lizenzvertrag. In der Tabelle Lizenzvertrag auswählen oder erfassen können Sie einen vorhandenen Vertrag auswählen oder einen neuen Vertrags-Datensatz anlegen.

Die erste Spalte zeigt die licenseContractId, die zur Identifizierung des Lizenzvertrags in der Datenbank dient. Es folgen Angaben zum Vertragspartner (partner), zum Abschlussdatum (conclusionDate), zum Benachrichtigungsdatum (notificationDate) und zum Ablaufdatum (expirationDate). Das letzte Feld (notes) ist für Ihre eigenen Notizen gedacht. Hier können Sie beispielsweise den Aufbewahrungsort der zum Vertrag gehörenden Dokumente oder ein Aktenzeichen notieren.

Einen neuen Datensatz legen Sie über das Kontextmenü der rechten Maustaste an. Es wird automatisch eine neue eindeutige ID (basierend auf dem aktuellen Datum und Zeitstempel) erstellt. Sie können die Standardeinstellung verwenden, wenn der Kauf der Software den Lizenzvertrag impliziert oder wenn der Vertrag auf andere Weise dokumentiert und nachvollziehbar ist. Andernfalls können und sollten Sie die Daten bearbeiten, um den zugrundeliegenden Vertrag ordentlich nachverfolgen zu können. Tragen Sie dann beispielsweise ein Aktenzeichen ins Feld notes ein.

Im Abschnitt Lizenzmodell konfigurieren können Sie folgende vier Varianten über Schaltflächen einrichten:

In allen vier Fällen enthält das Feld ID jeweils einen Vorschlag, der sich aus Datum und Zeit zusammensetzt; Sie können den Vorschlag übernehmen oder abändern. Abhängig vom gewählten Lizenzmodell können Sie die anderen Felder anpassen oder nicht.

Betätigen Sie die Schaltfläche Abschicken, um die Daten an den opsi-Service zu übermitteln und in die Datenbank aufzunehmen. Dabei werden Datensätze für ein Lizenzierungsrecht basierend auf dem ausgewählten Vertrag und der Lizenzierungsoption erzeugt. Diese sehen Sie ganz unten auf dem Reiter im Bereich Verfügbare Lizenzoptionen. Nach dem Speichern wird diese Tabelle neu geladen und die neu erzeugte Option automatisch markiert.

Das folgende Beispiel zeigt, wie Sie eine Lizenz mit Downgrade-Option konfigurieren. Das bedeutet, dass anstelle der gekauften Software auch die entsprechende Vorgängerversion installiert werden darf. Ein vorhandener Lizenzschlüssel darf also für eine zusätzliche Installation verwendet werden, für die er ursprünglich nicht legitimiert war.

Das opsi-Modell bildet diese Konstruktion folgendermaßen ab: Auf dem Reiter Lizenz anlegen erfassen Sie die Lizenz regulär. Als Ergebnis erhalten Sie eine neue Lizenzoption (angezeigt in der unteren Tabelle), die auf einem gleichfalls neu angelegten Lizenzierungsrecht beruht (softwareLicenseId). Diesen Wert benötigen Sie für das weitere Vorgehen. Entweder kopieren Sie Sie den Wert in die Zwischenablage oder Sie suchen ihn in der zweiten Tabelle auf dem Reiter Lizenzen bearbeiten heraus.

Als Nächstes stellen Sie eine Verknüpfung des vorhandenen Lizenzierungsrechts mit einem weiteren Lizenzpool her:

Wenn Sie eine Downgrade-Option konfiguriert haben (siehe Abschnitt Beispiel: Downgrade-Option konfigurieren), stellt die Tabelle Übersicht Lizenzenverwendung das ebenfalls dar. Eine Downgrade-Lizenz räumt je eine Lizenzierungsoption für (mindestens) zwei Lizenzpools ein. Nur eine der beiden kann tatsächlich genutzt werden. Sobald daher eine Lizenzoption verwendet wird, verringert sich in der Spalte remaining_opsi in beiden Zeilen der Wert um 1. Scheinbar vermindert sich also die Zahl der verfügbaren Lizenzen um 2 — das ist aber völlig korrekt und spiegelt die tatsächliche Berechtigungs-Situation wider.

Es gibt zwei Funktionen für die Lizenzverwaltung (siehe (String-)Funktionen für die Lizenzverwaltung [W/L/M):

Anstelle der Lizenzpool-ID können Sie jeweils die Produkt-ID oder eine Windows-Software-ID als Parameter übergeben.

Die Service-Methoden rufen Sie z. B. über opsi-admin auf; mit \* gekennzeichnete Parameter sind optional:

Die Methode erstellt einen neuen Lizenzvertrags-Datensatz mit der ID licenseContractId bzw. bearbeitet einen bestehenden. Geben Sie die ID nicht an, wird sie automatisch generiert. Die beiden Parameter partner (Vertragspartner) und notes (Notizen zum Vertrag) sind frei wählbare Strings. conclusionDate (Datum des Vertragsabschlusses), notificationDate (Erinnerung) und expirationDate (Ablaufdatum) übergeben Sie im Format JJJJ-MM-TT, z. B. 2023-02-28.

Mit den String-Funktionen getLastServiceErrorClass und getLastServiceErrorMessage kann auf einen Fehler reagiert werden, wenn z. B. keine freie Lizenz mehr verfügbar ist:

Die Fehlerklasse LicenseMissingError wird zurückgegeben, falls eine Lizenz angefordert wird, aber nicht verfügbar ist. Die Fehlerklasse LicenseConfigurationError wird zurückgegeben, wenn die Konfiguration keine eindeutige Zuordnung eines Lizenzpools zu einer Software zulässt.