http://ebook.swissmem.ch http://ionesoft.ch Konfiguration Lizenzmanagment Swissmem ebook App Version 1, 09.09.2013: Erstellung Version 1.1, 11.09.2013: kleinere Korrekturen Version 1.2, 17.09.2013: Anpassungen Version 1.3, 18.09.2013: kleinere Korrekturen (installation.properties) Version 1.4, 18.10.2013: Erweiterung: Proxy-Einstellungen Version 1.5, 18.06.2014, Proxy Einstellungen Version 1.6, 25.09.2014, neue Platzhalter für Pfade Version 1.7, 11.06.2015, Properties, neue Lizenztypen Copyright ionesoft GmbH, 2015 Seite 1
1 Einleitung 3 2 Übersicht 3 2.1 Lizenzcode 3 2.2 Couponcode 3 2.3 Konzept Lizenzierung 4 3 Installationsverzeichnisse 6 3.1 Installation der App 6 3.2 Arbeitsverzeichnis 6 3.3 Cloud Synchronisation 7 3.4 Backup 7 4 Lizenzarten 8 4.1 Übersicht 8 4.1.1 Konventionen 10 4.2 Personal License 10 4.2.1 Beschrieb 10 4.2.2 Personal License einrichten 12 4.3 Floating Device License 12 4.3.1 Beschrieb 12 4.3.2 Floating Device License einrichten 12 4.4 Group License 13 4.4.1 Beschrieb 13 4.4.2 Group License einrichten 15 4.5 User Domain License 16 4.5.1 Beschrieb 16 4.5.2 User Domain License einrichten 17 4.6 Site License 17 4.6.1 Beschrieb 17 4.6.2 Site License einrichten 18 4.6.3 Erläuterungen 20 5 Weitere Konfigurationen 21 5.1 Terminal Server 21 5.2 Netzwerkinstallation 21 5.3 Fehler Mozilla 21 5.4 Proxy Server-Einstellungen 22 Copyright ionesoft GmbH, 2015 Seite 2
1 Einleitung Dieses Dokument stellt die verschiedenen Lizenzkonfigurationen vor, welche für alle ebook Apps der Firma ionesoft basierend auf der beook Technologie verwendet werden können. Dazu gehören die beook Plattform, die Swissmem ebook App, IHK Lernen mobil und die elehrmittel App. Die in diesem Dokument vorgestellten technischen Lösungen sind losgelöst von der kommerziellen Sicht des Inhalts-Anbieters. Das bedeutet, um eine Menge von Lizenzen zu erwerben müssen keine Gruppen- oder Server Lizenzen konfiguriert werden, sondern ein möglicher Mengenrabatt kann auch auf Einzelplatzlizenzen gegeben werden. In der folgenden Übersicht werden zuerst die Begriffe Lizenzcode, Couponcode und der Ablauf der Lizenzierung aufgezeigt. Die Lizenzarten sind im Kapitel 3 zu finden. Das Kapitel 3 beschreibt die Installationsverzeichnisse. 2 Übersicht 2.1 Lizenzcode Die digitalen Inhalte (ebooks) können von den Benutzern auf ihr Gerät geladen werden und fortan offline genutzt werden. Die Berechtigung für den Download und die Nutzung der digitalen Inhalte wird über einen Lizenzcode geprüft. Damit wird sichergestellt, dass nur eine definierte Anzahl Personen und Geräte die Lehrmittel nutzen können. Auch eine zeitliche Einschränkung der Nutzung ist so möglich. Der Lizenzcode wird bei der Anmeldung mit dem Gerät und dem Benutzeraccount gekoppelt. 2.2 Couponcode Couponcodes erlauben die Verteilung von Lizenzcodes ohne dass bereits die Benutzeridentifikation bekannt sein muss. Jeder Couponcode (auch Aktivierungscode genannt) kann einen oder mehrere Lizenzcodes enthalten. So kann der Benutzer ein Bundle von ebooks gesamthaft freischalten, oder auch mehrmals hintereinander wieder ebooks freischalten. Couponcodes werden in der Regel über ein Lizenzblatt verteilt. Copyright ionesoft GmbH, 2015 Seite 3
2.3 Konzept Lizenzierung Das obenstehende Diagramm zeigt den Ablauf für die Lizenzprüfung und Freischaltung. 1. Die App wird im entsprechenden Store oder von der Webseite des Auftraggebers auf das Gerät des Benutzers geladen. 2. Der Benutzer erwirbt eine digitales Produkt im Shop des Auftraggebers oder über einen anderen Kanal. Er erhält dazu ein Lizenzblatt mit einem Aktivierungscode für die erworbenen Produkte (auch Coupon genannt). Solche Lizenzblätter wurden zuvor vom Bestellsystem generiert. 3. Der Benutzer gibt den Aktivierungscode und eine eigene Benutzeridentifikation in der App ein. Die App übermittelt dazu den Aktivierungscode zusammen mit der Benutzeridentifikation und der Geräte- ID an den Lizenzserver a. Wenn der Benutzer noch nicht vorhanden ist so wird ein neuer mit diesen Kenndaten angelegt. b. Die mit dem Aktivierungscode verknüpften Produkte werden dem Benutzer zugeordnet und Lizenzcodes generiert. c. Nun prüft der Lizenzserver die verfügbare Anzahl registrierbarer Geräte für diesen Lizenzcode und registriert das neue Gerät (sofern verfügbar). d. Die App erhält als Antwort die Lizenzcodes mit dem Status ob diese gültig sind. Copyright ionesoft GmbH, 2015 Seite 4
Der Zugang zum Lehrmittel/den Lehrmitteln ist nun in der App freigeschaltet und kann auf diesem Gerät genutzt werden. 4. Die App lädt auf Wunsch des Benutzers das digitale Lehrmittel und die zugehörigen Medien vom Assetserver in die Datenbank der App. a. Der Assetserver prüft den Zugriff auf die Dateien mittels eines Berechtigungssystems und dem Lizenzcode auf dem Lizenzserver. Copyright ionesoft GmbH, 2015 Seite 5
3 Installationsverzeichnisse Es wird unterschieden zwischen Programm und Daten. Dies wird konsequent getrennt. 3.1 Installation der App Die App wird auf einem Gerät installiert und enthält in der Regel noch keine digitalen Inhalte. Die App kann so unabhängig von den Daten aktualisiert werden. Bei PC und Mac Betriebssystemen kann die App sogar gelöscht und neu installiert werden, ohne dass die Daten verloren gehen. Bei Tablet Betriebssystemen erfolgt die Aktualisierung der App über den Apple AppStore bzw. Google PlayStore. Bei PC und Mac prüft die App beim Programmstart ob es eine Aktualisierung gibt und ermöglichst so den automatischen Upgrade der Software. Unter Windows und Mac befinden sich im Installationsverzeichnis folgende wichtige Dateien, welche in den nachfolgenden Kapiteln erwähnt werden: Win: C:\...\{AppName}\{AppName}.exe \plugins \configuration\installation.properties \configuraiton\config.ini etc. Mac: /Applications/{AppName}.app 3.2 Arbeitsverzeichnis Im Arbeitsverzeichnis (Workspace) befinden sich die heruntergeladenen digitalen Inhalte (ebooks). Dazu kommen eigene Inhalte wie Anmerkungen, Lesezeichen, Notizen, Leuchtmarkierungen, Lösungen der Übungen, eigene Seiten und verknüpfte Zusätze. All diese Daten werden gemeinsam im Arbeitsverzeichnis gespeichert. Auf PC und Mac Betriebssystemen liegt dieses Arbeitsverzeichnis standardmässig im Benutzer Ordner. Es kann durch eine Konfiguration in der App oder in einer Konfigurationsdatei auch an einen anderen Ort verschoben werden, zum Beispiel in einen Netzwerkordner. Bei den Tablet Betriebssystemen ist das Arbeitsverzeichnis immer fix gekoppelt an die App. Copyright ionesoft GmbH, 2015 Seite 6
Die digitalen Inhalte des Anbieters (ebooks) können unabhängig von den eigenen Inhalten gelöscht oder aktualisiert werden. Das Arbeitsverzeichnis kann gesichert werden. Auf Tablets mit itunes/icloud oder Google Backup. Auf PC/Mac durch eine Menufunktion der App. Unter Windows und Mac befinden sich im Arbeitsverzeichnis folgende wichtige Dateien, welche in den nachfolgenden Kapiteln erwähnt werden: Win: C:\Users\{Benutzer}\Appdata\Roaming\{AppName} \data \.store \.log \synch etc. Mac: /Users/{Benutzer}/{AppName} /data /.store /.log /synch etc. 3.3 Cloud Synchronisation Mit der App Version ab Sommer 2015 steht ausserdem eine Cloud Synchronisation der eigenen Inhalte zur Verfügung. Damit wird es möglich sein die eigenen Inhalte auf mehrere Geräte des selben Benutzeraccounts zu synchronisieren. Auch ein Backup der Daten ist so automatisch gewährleistet. 3.4 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, 2015 Seite 7
4 Lizenzarten 4.1 Übersicht Die digitalen Lehrmittel können mit den folgenden Lizenzarten freigeschaltet werden: 1. Personal License 2. Floating Device License 3. Group License 4. User Domain License 5. Site License Die Personal License ist der Normalfall. Jeder Nutzer hat seine eigene Lizenz, welche er auf seinen Geräten verwenden kann. Nach der Freischaltung seines Gerätes kann die App auch ohne Internet verwendet werden. Für Tablet- Betriebssysteme ios und Android ist dies die einzige Lizenzart. Die Floating Device License wird in besonderen Fällen verwendet, nämlich dann wenn ein Benutzer kein persönliches Gerät verwendet, sondern mehrere Arbeitsplätze nutzen muss. Dabei wird ein Gerät mit dem Schliessen der App jeweils entkoppelt und beim nächsten Starten der App wieder registriert. Eine paralelle Nutzung ist nicht möglich. Auch wird eine Internetverbindung beim Starten benötigt. Die Group License ist dazu gedacht dass mehrere Benutzer zusammen eine definierte Anzahl von Arbeitsplätzen teilen und das selbe Login verwenden. Dies wird vor allem bei Lehrpersonen mit mehreren Schulzimmern verwendet. Die neue Floating Device License ist dieser Lizenzart vorzuziehen, da sie flexibler eingesetzt werden kann. Die User Domain License verwendet den Windows Login Namen als Identifikation anstelle der Geräte-ID. Sie kann in Spezialfällen im Intranet eines Unternehmens genutzt werden. Eine Nutzung ausserhalb des Netzwerkes ist nicht möglich. Die Site License kann dann eingesetzt werden, wenn alle Personen in einer Unternehmung oder Schule vollen Zugang zu bestimmten digitalen Inhalten erhalten sollen. Hier wird nicht mehr ein persönliches Login verwendet, sondern ein unpersönliches welches auf einen IP-Range gebunden ist. Alle Personen innerhalb einer bestimmten IP-Adresse können so die Inhalte nutzen. Die folgende Tabelle bietet einen Überblick über die verfügbaren Varianten. Copyright ionesoft GmbH, 2015 Seite 8
http://ebook.swissmem.ch http://ionesoft.ch Lizenzvarian te Eigenschaften Vorteile Nachteile Geeignet für/zielgruppe 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 gekoppelt. Programm, Daten und Lizenz auf dem selben Gerät Vollständige Offline-Nutzung möglich Lizenz ist auf ein bestimmtes Gerät des Benutzers gebunden. Für Benutzer, die über ein persönliches Gerät verfügen (e.g. Lernende/Lehrpersonen mit persönlichem Tablet oder Computer) *) Je nach Lizenz kann auch mehr als ein Gerät mit einer Personal License freigeschaltet werden (oft 2). Floating Device License Das Programm ist in einem lokalen oder Netzwerkverzeichnis abgelegt. Persönliche Daten sind lokal gespeichert Beim Starten der App wird das Gerät auf dem Lizenzserver registriert Beim Verlassen der App wird das Gerät wieder freigegeben Mehrere Geräte können nacheinander genutzt werden Beim Starten ist Für Benutzer welche auf eine verschiedenen, meist Internetverbindu unpersönlichen Geräten ng notwendig. arbeiten wollen. Die persönlichen (z.b. Lehrerpersonen in Daten müssen Schulhäusern mit fix transferiert installierten Computern) werden, auf einem Netzlaufwerk abgelegt oder über eine Cloud synchronisiert werden. Group License Das Programm ist auf einem Gruppen- /Netzlaufwerk abgelegt. Es kann von dort auf verschiedenen Computern im selben Netzwerk gestartet werden. Persönliche Daten werden auf einem separaten Netzwerklaufwerk gespeichert (Home Drive im Netz) und Zentrale Installation Lizenz kann auf mehreren Geräten genutzt werden. Unabhängig auf welchem Gerät gearbeitet wird. Daten von allen Geräten aus verfügbar. Netzwerkverbind ung notwendig um auf die Inhalte Für Benutzer welche auf verschiedenen, meist unpersönlichen Geräten arbeiten wollen. zuzugreifen. (z.b. Lehrerpersonen in VPN oder Remote Desktop Schulhäusern mit fix installierten Computern) notwendig um von aussen die Virtuelle Umgebungen Inhalte nutzen zu können. Copyright ionesoft GmbH, 2015 Seite 9
sind so an jedem Arbeitsplatz verfügbar. User Domain License Der Login Name wird als Identifikation verwendet. Nutzung der App ohne Gerätefreischalt ung möglich Kann auf mehreren unpersönlichen Geräten verwendet werden. Einsatz in Schulungsräumen möglich Nur in einem Netzwerk verwendbar. Internet notwendig zum Starten der App Nur in speziellen Fällen in Unternehmen im Angebot. Site License - 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. Zugriffserlaubnis erfolgt durch Abgleich mit einer fixen IP- Adresse. Benutzer benötigen keine Freischaltung und können die Inhalte direkt nutzen. Internetverbindun g bei jedem Programmstart notwendig um die Lizenz zu verifizieren. Ohne Verbindung fällt die App in den Auszugsmodus zurück Alle Geräte müssen die selbe externe IP Adresse nutzen. Grosse Anzahl Benutzer/Schulen/Mitarbeite r welche auf allen Geräten die App nutzen möchten. 4.1.1 Konventionen {AppName} {Benutzer} Der Name der Applikation des Kunden Der Login-Name des Benutzers auf dem Computer 4.2 Personal License 4.2.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 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 Copyright ionesoft GmbH, 2015 Seite 10
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 Fehler! Verweisquelle konnte nicht gefunden werden.). 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 Copyright ionesoft GmbH, 2015 Seite 11
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. 4.2.2 Personal License einrichten Eine Personal License ist der Standard, und benötigt keine spezielle Vorgehensweise. 4.3 Floating Device License 4.3.1 Beschrieb Die Floating Device License wird in besonderen Fällen verwendet, nämlich dann wenn ein Benutzer kein persönliches Gerät verwendet, sondern mehrere Arbeitsplätze nutzen muss. Dabei wird ein Gerät mit dem Schliessen der App jeweils entkoppelt und beim nächsten Starten der App wieder registriert. Eine paralelle Nutzung ist nicht möglich. Auch wird eine Internetverbindung beim Starten benötigt. Ohne Validierung der Lizenz kann das ebook nicht genutzt werden. Die Lizenz fällt in den Auszugsmodus zurück womit nur eine beschränkte Anzahl Seiten genutzt werden können. Nach der Validierung ist wieder der gesamte Inhalt zugänglich. 4.3.2 Floating Device License einrichten Der Lizenztyp wird vom Anbieter konfiguriert. Es sind keine besonderen Einstellungen oder Konfigurationen auf dem Gerät notwendig. Copyright ionesoft GmbH, 2015 Seite 12
4.4 Group License 4.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 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, 2015 Seite 13
Schema Group License Copyright ionesoft GmbH, 2015 Seite 14
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. 4.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 oder einen Forward Slash. Jede Zeile muss durch einen Zeilenumbruch getrennt werden. Beachten Sie die unterstützten Placeholders (siehe Kommentar in der Datei) Beispiel: # installation.properties # Installation properties for {AppName} Copyright ionesoft GmbH, 2015 Seite 15
# This property file has to be stored in the configuration # directory of the application # Placeholders: # The following placeholders are supported for machinelicensedir and workspacedir # ${APPDATA} -> APPDATA environment variable # ${USERPROFILE} -> USERPROFILE environment variable # ${HOMEDRIVE} -> HOMEDRIVE environment variable # ${hostname} -> the machine name # ${username} -> the username of the operating system # Example: workspacedir = ${APPDATA}/eBook # Backslash must be escaped with another backslash, or use a single forward slash # i.e. \\\\filer12\\licensedir\\${hostname} # when true, the license will be per machine, otherwise per # User. Default is false machinelicense = true # the directory where the license files are stored. See remark for placeholders above. machinelicensedir = \\\\filer12\\licensedir\\${hostname} # 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 user.home defined by java # See remark for placeholders above. workspacedir = ${HOMEDRIVE}\\{AppName} 4.5 User Domain License 4.5.1 Beschrieb Die User Domain License verwendet den Windows Login Namen als Identifikation anstelle der Geräte-ID. Sie kann in Spezialfällen im Intranet eines Unternehmens genutzt werden. Eine Nutzung ausserhalb des Netzwerkes ist nicht möglich. Es wird zwingend eine Internetverbindung beim Starten benötigt. Ohne Validierung der Lizenz kann das ebook nicht genutzt werden. Die Lizenz fällt in den Auszugsmodus zurück womit nur eine beschränkte Anzahl Seiten genutzt werden können. Nach der Validierung ist wieder der gesamte Inhalt zugänglich. Copyright ionesoft GmbH, 2015 Seite 16
4.5.2 User Domain License einrichten Der Lizenztyp wird vom Anbieter konfiguriert. Es sind keine besonderen Einstellungen oder Konfigurationen auf dem Gerät notwendig. 4.6 Site License 4.6.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 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, 2015 Seite 17
Schema Site License 4.6.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: ) Copyright ionesoft GmbH, 2015 Seite 18
2. Installieren Sie die App auf diesem Laufwerk G: Dieses Laufwerk soll für die Benutzer nur read-only sein. 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 und licenseprincipal erhalten Sie vom Hersteller. 6. Setzen Sie den Wert ipvalidation auf true Beispiel: # installation.properties # Installation properties for {AppName} @ {school} # This property file has to be stored in the configuration directory # of the application # Placeholders: # The following placeholders are supported for machinelicensedir and workspacedir # ${APPDATA} -> APPDATA environment variable # ${USERPROFILE} -> USERPROFILE environment variable # ${HOMEDRIVE} -> HOMEDRIVE environment variable # ${hostname} -> the machine name # ${username} -> the username # Example: workspacedir = ${APPDATA}/eBook # Backslash must be escaped with another backslash, or use a single forward slash # i.e. \\\\filer12\\licensedir\\${hostname} # 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 user.home defined by java # See remark for placeholders above. workspacedir = ${HOMEDRIVE}\\{AppName} Copyright ionesoft GmbH, 2015 Seite 19
# 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 4.6.3 Erläuterungen 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. Copyright ionesoft GmbH, 2015 Seite 20
5 Weitere Konfigurationen 5.1 Terminal Server Wenn die App auf einem Terminal Server betrieben wird, muss jede Instanz einen anderen Port für den internen HTTP-Server nutzen. Dieser Port kann in den Einstellungen der App festgelegt werden 5.2 Netzwerkinstallation Bei Netzewerkinstallationen der App ist darauf zu achten dass der Benutzer keine Schreibrechte im Installations-Ordner hat. Folgender Parameter ist einzutragen Hinzufügen dieser Zeile in<installdir>\{appname}\configuration\config.ini osgi.configuration.area=<benutzerordner> Siehe hier für mögliche Variabeln für <Benutzerordner> http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/reference/misc/ runtimeoptions.html?resultof=%22%6f%73%67%69%2e%63%6f%6e%66%69%67%75%72%6 1%74%69%6f%6e%2e%61%72%65%61%22%20#locations z.b. osgi.configuration.area=@user.home/beook 5.3 Fehler Mozilla In seltenen Fällen kann beim Starten der App der folgende Fehler eintreten: Could not initialize the application s security component Grund ist eine korrupte Datei des eingebetteten Mozilla Firefox Browser. Dazu ist die folgende Datei zu löschen: cert8.db Sie befindet sich im Benutzerverzeichnis unter AppData/Roaming/Mozilla oder AppData/Local/Mozilla. Copyright ionesoft GmbH, 2015 Seite 21
Siehe http://kb.mozillazine.org/could_not_initialize_the_browser_security_component 5.4 Proxy Server-Einstellungen Die 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 https://license.ioneaccess.ch für den Zugriff zum Lizenz- und Assetserver, sowie Copyright ionesoft GmbH, 2015 Seite 22
http://www.google.com 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 auf der Webseite. 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, 2015 Seite 23