Konfiguration Lizenzmanagment. Swissmem ebook App

Transkript

1 Konfiguration Lizenzmanagment Swissmem ebook App Version 1, : Erstellung Version 1.1, : kleinere Korrekturen Version 1.2, : Anpassungen Version 1.3, : kleinere Korrekturen (installation.properties) Version 1.4, : Erweiterung: Proxy-Einstellungen Version 1.5, , Proxy Einstellungen Copyright ionesoft GmbH, 2014 Seite 1

2 1 Einleitung 3 2 Übersicht Konventionen Verzeichnisse Backup 5 3 Fall A: Personal License Beschrieb Personal License einrichten 7 4 Fall B: Group License Beschrieb Group License einrichten 10 5 Fall C: Site License Beschrieb Site License einrichten Erläuterungen 15 6 Proxy Server-Einstellungen 15 Copyright ionesoft GmbH, 2014 Seite 2

3 1 Einleitung Dieses Dokument stellt die verschiedenen Lizenzkonfigurationen vor, die für die Swissmem ebook App gewählt werden können. Das Dokument hat Gültigkeit für die Windows- und Mac OS X Plattform der App. 2 Übersicht Neben dem Normalfall (Personal License, siehe Fall A), bei dem die App, die persönlichen Daten (Markierungen, Notizen, Lösungen der Übungen) sowie der Lizenzcode lokal auf dem Gerät abgespeichert sind, besteht auch die Möglichkeit einer Group License (Fall B) oder einer Site License (Fall C). Die zwei letzten Varianten sind besonders attraktiv für Benutzer, die an verschiedenen Geräten arbeiten. Die folgende Tabelle bietet einen Überblick über die verfügbaren Varianten. Eine ausführlichere Beschreibung, sowie die technischen Details können den nachfolgenden Kapiteln entnommen werden. Lizenzvariante Eigenschaften Geeignet für/zielgruppe Fall A: Personal License - Das Programm ist in einem lokalen Verzeichnis abgelegt - Persönliche Daten sind lokal gespeichert - Der Lizenzcode ist lokal gespeichert Jeder Lizenzcode hat eine gewisse Anzahl zugelassene Geräte. Die Lizenz ist an die Geräte-ID (Device ID) gekoppelt. Für Benutzer, die über ein persönliches Gerät verfügen (e.g. Lernende/Lehrpersonen mit persönlichem Tablet oder Computer) Fall B: Group License - Das Programm ist auf einem Gruppen- Benutzer, die von verschiedenen Geräten aus arbeiten möchten /Netzlaufwerk abgelegt. Es (e.g. Lehrerpersonen in kann von dort auf Schulhäusern mit fix verschiedenen Computern installierten Computern) im selben Netzwerk gestartet werden. Virtuelle Umgebungen - Persönliche Daten werden auf einem separaten Copyright ionesoft GmbH, 2014 Seite 3

4 Fall C: Site License Laufwerk gespeichert. - Der Benutzer kann von verschiedenen Geräten darauf zugreifen. (e.g. P:\\{AppName}\\data) - Nur ein Lizenzcode für alle benutzten Geräte X 1, X 2, X 3,... X N (Anzahl wird vorgängig festgelegt). Der Lizenzcode ist abgelegt in einem Gruppen-/Netzlaufwerk (e.g. G:\\{AppName}\\X i\\.store; i=1..n) Für diesen Lizenzcode können N Geräte freigeschaltet werden - Das Programm ist in einem Gruppen-/Netzlaufwerk abgelegt. Kann von dort aus auf verschiedenen Geräten gestartet werden. - Persönliche Daten werden auf einem separatem Laufwerk gespeichert. - Der Benutzer kann von verschiedenen Geräten darauf zugreifen. (e.g. P:\\{AppName}\\data) Zugriffserlaubnis erfolgt durch Abgleich mit einer fixen IP- Adresse. Die erlaubte Geräteanzahl wird vorgängig vereinbart. Es braucht für den Programmstart zwingend eine aktive Internetverbindung. Benutzer/Schulen welche auf allen Geräten mit allen Schülern und Lehrpersonen die App nutzen möchten. 2.1 Konventionen {AppName} {Benutzer} Der Name der Applikation des Kunden Der Login-Name des Benutzers auf dem Computer Copyright ionesoft GmbH, 2014 Seite 4

5 2.2 Verzeichnisse In allen drei Varianten werden diese zwei Verzeichnisse von der App verwendet: 1. installdir: Das Verzeichnis, in dem das Programm installiert ist Win: C:\...\{AppName}\{AppName}.exe \plugins \configuration\installation.properties etc. Mac: /Applications/{AppName}.app 2. workspacedir: Das Verzeichnis, in dem die digitalen Lehrmittel und alle persönlichen Daten (Annotationen, Lizenzcode, etc.) gespeichert werden Win: C:\Users\{Benutzer}\Appdata\Roaming\{AppName} \data \.store \.log \synch etc. Mac: /Users/{Benutzer}/{AppName} /data /.store /.log /synch etc. 2.3 Backup Der Workspace unter workspacedir muss regelmässig durch einen Backup gesichert werden, damit die eigenen Annotationen wiederhergestellt werden können. Das \data Verzeichnis enthält die Datenbank mir den geladenen Lehrmitteln und den eigenen Annotationen. Im Verzeichnis \synch befinden sich nur die Annotationen. Dieses Verzeichnis genügt zu sichern. Die anderen Daten können nachträglich durch ein erneutes Laden der ebooks wieder hergestellt werden. Copyright ionesoft GmbH, 2014 Seite 5

6 3 Fall A: Personal License 3.1 Beschrieb Diese Lizenzvariante ist der Normalfall. Sie eignet sich für alle Benutzer, die über ein persönliches Gerät verfügen und die Swissmem ebook App ausschliesslich auf diesem benutzen werden. Alle Daten werden auf diesem Gerät gespeichert. Der Benutzer installiert die App auf der jeweiligen Plattform und erhält nach dem Erwerb der digitalen Lehrmittel einen Lizenzcode (in Form eines Aktivierungscodes). Mit diesem kann er sich in der App anmelden. Damit sind die erworbenen Lehrmittel freigeschaltet, können heruntergeladen und genutzt werden. Schema Personal License Zwei Verzeichnisse werden dabei auf dem Gerät erstellt: installdir und workspacedir (siehe 2.2). Copyright ionesoft GmbH, 2014 Seite 6

7 Sobald der Benutzer sich in der App anmeldet, wird aus den Geräte-Parametern des Computers eine Device-ID erstellt und diese mit dem benutzten Lizenzcode gekoppelt. Diese Daten werden verschlüsselt in der \.store Datei im workspacedir gespeichert. Bemerkung: Zumeist erlauben die Anbieter der Software zwei Geräte mit demselben Lizenzcode freizuschalten. Dies ist so gewählt, damit eine Person auf zwei Geräten, z.b. auf dem Tablet und auf dem Computer arbeiten kann oder nach Verlust bzw. Ersetzen eines Geräts die Lehrmittel erneut freigeschaltet kann. Wichtig: Wenn die Person mit zwei Geräten arbeitet, besteht momentan mit dieser Lizenzvariante keine Möglichkeit, die persönlichen Annotationen zwischen den beiden Geräten zu synchronisieren. 3.2 Personal License einrichten Eine Personal License ist der Standard, und benötigt keine spezielle Vorgehensweise. Copyright ionesoft GmbH, 2014 Seite 7

8 4 Fall B: Group License 4.1 Beschrieb Der Lizenzabgleich bzw. die App und die zugehörigen persönlichen Daten sind bei der Group License entkoppelt (d.h. nicht am selben Ort abgespeichert, siehe Schema), was eine Verwendung der Daten auf mehreren Geräten ermöglicht. Diese Variante eignet sich demnach für Personen, die auf verschiedenen Geräten arbeiten. Die Anzahl Geräte ist beschränkt und wird vorhergehend festgelegt. Damit die Swissmem ebook App von verschiedenen Geräten ( Shared Device im Schema) aus gestartet werden kann, wird der Lizenzcode sowie die App in einem Verzeichnis auf einem Gruppen-/Netzlaufwerk ( Network Group Drive G: im Schema) gespeichert. Der Lizenzcode ist für alle Geräte der Gleiche. Wenn die App auf dem Gerät X 1 ( Shared Device ) vom Gruppenlaufwerk aus gestartet wird und man sich anschliessend anmeldet, wird die Device-ID und der Lizenzcode gekoppelt. Gleichzeitig wird im Gruppenlaufwerk ein Unterverzeichnis erstellt ( machinelicensedir : G:\\{AppName}\\${hostname}\\; hier ${hostname}=x 1), in dem diese Kopplung abgelegt ist (G:\\{AppName}\\${hostname}\\.store). Dieser Vorgang kann so oft auf allen Shared Devices wiederholt werden, bis die maximale Anzahl zugelassener Geräte erreicht ist. Die persönlichen Daten werden in einem separaten Verzeichnis ( WorkspaceDir ) abgelegt (auf einem File-Server; Network Home Drive P: im Schema). Der entsprechende Pfad wird wie unten beschrieben in der Konfigurations-Datei ( Config ) auf dem Gruppenlaufwerk definiert. Copyright ionesoft GmbH, 2014 Seite 8

9 Schema Group License Achtung: Der Zugriff auf das Gruppen-Laufwerk ermöglicht das Benutzen der App. Dieses Laufwerk soll nur für die berechtigten Personen zugänglich gemacht werden. Copyright ionesoft GmbH, 2014 Seite 9

10 4.2 Group License einrichten Befolgen Sie diese Schritte, um eine Group License einzurichten: 1. Sie benötigen, wie oben erwähnt, ein Gruppen-/Netzlaufwerk, auf das nur die berechtigten Personen Zugriff haben dürfen (z.b. G: ). Zudem brauchen Sie ein Laufwerk, auf dem die persönlichen Daten gespeichert werden können (z.b. P: ) 2. Installieren Sie die App auf dem Gruppen-Laufwerk (z.b. G: ) Dieses Laufwerk soll für die Benutzer nur read-only sein. 3. Lösen Sie eine Group License beim Anbieter der Software, geben Sie dabei die Anzahl benötigte Geräte an. 4. Öffnen Sie das File installation.properties unter G:\{AppName}\configuration\ und fügen Sie auf einer separaten Zeile folgendes ein: machinelicense = true 5. In der Zeile machinelicensedir geben Sie den Pfad an, wo die Lizenzschlüssel für jedes Gerät geschrieben werden sollen. Dort muss bei der Aktivierung des Geräts eine Schreibberechtigung vorliegen. 6. Tragen Sie die Angaben für licenseprincipal und licensecredentials in der Konfigurationsdatei ein. Dies sind die Anmeldetaten für den Lizenzcode. Somit müssen die Nutzer keine Anmeldung mehr durchführen, da dies die App so automatisch vornimmt. Die Angabe für licensecredentials erhalten Sie von ionesoft GmbH. 7. Schlussendlich können Sie unter workspacedir den Pfad zum Workspace (wo die digitalen Lehrmittel und Ihre persönlichen Daten gespeichert werden) angeben. Achtung: Verwenden Sie für jeden Backslash einen zusätzlichen Backslash. Jede Zeile muss durch einen Zeilenumbruch getrennt werden. Beispiel: # installation.properties # Installation properties for {AppName} # This property file has to be stored in the configuration # directory of the application # when true, the license will be per machine, otherwise per # Benutzer. Default is false machinelicense = true # the directory where the license files are stored. You can use # ${hostname} as a placeholder of this machine name # Backslash must be escaped with another backslash machinelicensedir = \\\\filer12\\licensedir\\${hostname} Copyright ionesoft GmbH, 2014 Seite 10

11 # specify the principal for the login to the licensemanager licenseprincipal = AppName@school.ch # specify the credentials for the login to the licensemanager licensecredentials = <xxxxxx> # Directory for the workspace. Has to be writable, and will contain # the database and User settings. # When not defined, it will be in the location of the APPDATA # environment variable, or the Benutzer.home defined by java # Backslash must be escaped with another backslash # Use the following placeholders to define the directory: # ${APPDATA} -> APPDATA environment variable # ${USERPROFILE} -> USERPROFILE environment variable # ${HOMEDRIVE} -> HOMEDRIVE environment variable workspacedir = ${HOMEDRIVE}\\{AppName} Copyright ionesoft GmbH, 2014 Seite 11

12 5 Fall C: Site License 5.1 Beschrieb Diese Variante eignet sich speziell für grosse Schulen welche für alle Lernenden und Lehrpersonen eine Lizenz nutzen. Alle Netzwerkverbindungen (e.g. Internetverbindung) erfolgen über eine oder wenige IP-Adressen. Mit der Site License haben alle Geräte mit einer bestimmten IP-Adresse Zugang zu den ebooks. Die App ist nur auf einem Gruppenverzeichnis gespeichert ( Network Group Drive G: im Schema) und kann von dort aus von alle Usern gestartet werden. Der Workspace ( WorkspaceDir ), wo u.a. die digitalen Lehrmittel und die persönlichen Daten (Markierungen, Notizen, Lösungen der Übungen, etc.; Database im Schema) gespeichert sind, ist auf einem separaten Laufwerk gespeichert ( Network Home Drive P: im Schema). Somit können alle Benutzer von einem beliebigen Gerät aus die Swissmem ebook App und ihre zugehörigen persönlichen Daten nutzen. Achtung: Diese Lizenzvariante benötigt eine stabile und kontinuierliche Internetverbindung, da bei jedem Programmstart ein Abgleich mit dem Lizenzserver stattfindet, ohne welche die App nicht genutzt werden kann. Copyright ionesoft GmbH, 2014 Seite 12

13 Schema Site License 5.2 Site License einrichten Befolgen Sie diese Schritte, um eine Site License einzurichten: 1. Sie benötigen, wie oben erwähnt ein Gruppen-/Netzlaufwerk (z.b. G: ) und ein Laufwerk, auf dem die persönlichen Daten gespeichert werden können (z.b. P: ) 2. Installieren Sie die Swissmem ebook App auf diesem Laufwerk G: Dieses Laufwerk soll für die Benutzer nur read-only sein. Copyright ionesoft GmbH, 2014 Seite 13

14 3. Lösen Sie eine Site License beim Anbieter der Software, geben Sie dabei die Anzahl benötigte Geräte bzw. Benutzer an 4. Öffnen Sie das File installation.properties unter G:\{AppName}\configuration\ und fügen Sie die Konfigurationen an, wie im Beispiel erläutert. Achtung: Verwenden Sie für jeden Backslash einen zusätzlichen Backslash. Jede Zeile muss durch einen Zeilenumbruch getrennt werden. 5. Tragen Sie die Angaben für licenseprincipal und licensecredentials in der Konfigurationsdatei ein. Dies sind die Anmeldetaten für den Lizenzcode. Somit müssen die Nutzer keine Anmeldung mehr durchführen, da dies die App so automatisch vornimmt. Die Angabe für licensecredentials erhalten Sie von ionesoft GmbH. 6. Setzen Sie den Wert ipvalidation auf true Beispiel: # installation.properties # Installation properties for {school} # This property file has to be stored in the configuration directory # of the application # Directory for the workspace. Has to be writable, and will contain # the database and User settings. # When not defined, it will be in the location of the APPDATA # environment variable, or the Benutzer.home defined by java # Use the following placeholders to define the directory: # ${APPDATA} -> APPDATA environment variable # ${USERPROFILE} -> USERPROFILE environment variable # ${HOMEDRIVE} -> HOMEDRIVE environment variable workspacedir = ${HOMEDRIVE}\\{AppName} # when true, ip-validation is used instead of device id. Default is # false ipvalidation = true # specify the principal for the login to the licensemanager licenseprincipal = AppName@school.ch # specify the credentials for the login to the licensemanager licensecredentials = <xxxxxx> # when false, no check for updates will be done at startup. Used for # managed environments with a central update strategy. Default is true checkforupdates = false Copyright ionesoft GmbH, 2014 Seite 14

15 5.2.1 Erläuterungen Den Wert für licenseprincipal und licensecredentials erhalten Sie vom Anbieter der Software. Wenn Sie checkforupdates auf false setzen, so prüft die App beim Programmstart nicht mehr auf Aktualisierungen (sinnvoll wenn der Benutzer keine Schreibrechte im installdir hat). Sie müssen die Software daher zentral regelmässig aktualisieren. 6 Proxy Server-Einstellungen Die Swissmem-App benötigt eine Netzwerkverbindung für den Download der ebooks und der Filme. Diese Netzwerkverbindung wird von der integrierten Java Umgebung aufgebaut. Sollte ein Proxy-Server oder eine Firewall diese Netzwerkverbindung unterbinden, so kommt es zu den folgenden Fehlermeldungen: 1. Die Anmeldung funktioniert nicht, «Nicht authorisiert/zugriff verboten» 2. Der Download der ebooks funktioniert nicht 3. Medien können nicht abgespielt werden Damit die App einwandfrei funktionieren kann, muss demzufolge ein allfälliger Proxy- Server so konfiguriert werden, dass die Adressen für den Zugriff zum Lizenz- und Assetserver, sowie für den Test der Netzwerkverbindung durchgelassen werden. In der Applikation muss sodann der Proxy-Server eingetragen werden. Siehe dazu unter Freischaltung mit Netzwerk-Proxy. Sie können diese Werte auch im installation.properties eintragen: # specify the proxy http host address as a default for all users proxyhttphost = # specify the proxy http port as a default for all users proxyhttpport = # specify the proxy http username as a default for all users proxyhttpusername = # specify the proxy http password as a default for all users proxyhttppassword = Copyright ionesoft GmbH, 2014 Seite 15