altova stylevision server · das produkt fungiert als modul von flowforce server von altova und ist...

Altova StyleVision Server

Benutzer- und Referenzhandbuch

All rights reserved. No parts of this work may be reproduced in any form or by anymeans - graphic, electronic, or mechanical, including photocopying, recording, taping, orinformation storage and retrieval systems - without the written permission of thepublisher.

Products that are referred to in this document may be either trademarks and/orregistered trademarks of the respective owners. The publisher and the author make noclaim to these trademarks.

While every precaution has been taken in the preparation of this document, thepublisher and the author assume no responsibility for errors or omissions, or fordamages resulting from the use of information contained in this document or from theuse of programs and source code that may accompany it. In no event shall the publisherand the author be liable for any loss of profit or any other commercial damage caused oralleged to have been caused directly or indirectly by this document.

Published: 2017

© 2017 Altova GmbH

Altova StyleVision Server Benutzer- undReferenzhandbuch

1Altova StyleVision Server

Inhaltsverzeichnis

1 Altova StyleVision Server 2017 3

................................................................................................................................... 61.1 Funktionalität

..................................................................................................................... 7Im FlowForce Workflow 1.1.1

..................................................................................................................... 8Als eigenständiger Server 1.1.2

................................................................................................................................... 91.2 Einrichten unter Windows

..................................................................................................................... 10Installation unter Windows 1.2.1

..................................................................................................................... 13Lizenzierung unter Windows 1.2.2

................................................................................................................................... 161.3 Einrichten unter Linux

..................................................................................................................... 17Installation unter Linux 1.3.1

..................................................................................................................... 22Lizenzierung unter Linux 1.3.2

..................................................................................................................... 24Anmerkungen zur Umgebung 1.3.3

................................................................................................................................... 251.4 Einrichten auf Mac OS X

..................................................................................................................... 26Installation auf Mac OS X 1.4.1

..................................................................................................................... 29Lizenzierung auf Mac OS X 1.4.2

..................................................................................................................... 31Anmerkungen zur Umgebung 1.4.3

................................................................................................................................... 321.5 Verwendung über die Befehlszeile

..................................................................................................................... 34licenseserver 1.5.1

..................................................................................................................... 36assignlicense (nur Windows) 1.5.2

..................................................................................................................... 38verifylicense (nur Windows) 1.5.3

..................................................................................................................... 40generate 1.5.4

..................................................................................................................... 43setfopath 1.5.5

..................................................................................................................... 45pdfdata 1.5.6

..................................................................................................................... 47exportresourcestrings 1.5.7

..................................................................................................................... 49setdeflang 1.5.8

..................................................................................................................... 51help 1.5.9

................................................................................................................................... 531.6 StyleVision Server API

..................................................................................................................... 54Informationen zur .NET-Schnittstelle 1.6.1

..................................................................................................................... 55Informationen zur COM-Schnittstelle 1.6.2

..................................................................................................................... 56Informationen zur Java-Schnittstelle 1.6.3

..................................................................................................................... 57Codebeispiele 1.6.4

........................................................................................................... 57C++

........................................................................................................... 58C#

........................................................................................................... 59VBScript

........................................................................................................... 60Visual Basic

Altova StyleVision Server2

........................................................................................................... 61Java

..................................................................................................................... 63API-Referenz 1.6.5

........................................................................................................... 63COM und .NET

........................................................................................................... 69Java

................................................................................................................................... 731.7 Altova LicenseServer

..................................................................................................................... 75Informationen zum Netzwerk 1.7.1

..................................................................................................................... 76Installation (Windows) 1.7.2

..................................................................................................................... 78Installation (Linux) 1.7.3

..................................................................................................................... 82Installation (Mac OS X) 1.7.4

..................................................................................................................... 83Altova ServiceController 1.7.5

..................................................................................................................... 84Zuweisen von Lizenzen 1.7.6

........................................................................................................... 85Starten von LicenseServer

........................................................................................................... 86Öffnen der LicenseServer-Konfigurationsseite(Windows)

........................................................................................................... 89Öffnen der LicenseServer-Konfigurationsseite (Linux)

........................................................................................................... 91Öffnen der LicenseServer-Konfigurationsseite (Mac OSX)

........................................................................................................... 94Laden von Lizenzen in LicenseServer

........................................................................................................... 97Registrieren von Produkten......................................................................................................................................... 97Registrieren von Altova Desktop-Produkten......................................................................................................................................... 98Registrieren von FlowForce Server

......................................................................................................................................... 103Registrieren von MapForce Server

......................................................................................................................................... 104Registrieren von MobileTogether Server

......................................................................................................................................... 105Registrieren von RaptorXML(+XBRL) Server

......................................................................................................................................... 107Registrieren von StyleVision Server

........................................................................................................... 108Zuweisen von Lizenzen zu registrierten Produkten

..................................................................................................................... 115Referenz zur Konfigurationsseite 1.7.7

........................................................................................................... 115License Pool

........................................................................................................... 122Client Management

........................................................................................................... 127Client Monitoring

........................................................................................................... 128Settings

........................................................................................................... 135Messages, Log Out

..................................................................................................................... 136Passwort zurücksetzen 1.7.8

Index

Kapitel 1

Altova StyleVision Server 2017

© 2017 Altova GmbH

3Altova StyleVision Server 2017


1 Altova StyleVision Server 2017

Altova StyleVision Server ist eine Implementierung des Built-in-Ausführungsprozessors vonAltova StyleVision. Das Produkt fungiert als Modul von FlowForce Server von Altova und ist auchals eigenständiges Server-Produkt erhältlich.

StyleVision Server führt Transformationspakete aus, die auf einem FlowForce Server bereitgestelltwurden. Diese Transformationen werden auf Basis verschiedener programmierbarer Zeit-Trigger,Datei-Trigger oder Remote Trigger von FlowForce Server gestartet. Zusätzlich dazu könnenStyleVision Server-Funktionen über die Befehlszeile aufgerufen werden.

Systemanforderungen, Installation und LizenzierungStyleVision Server läuft auf den folgenden Betriebssystemen:

Windows

Windows Vista, Windows 7/8/10

Windows Server

Windows Server 2008 R2 oder höher

Linux

CentOS 6 oder neuerRedHat 6 oder neuerDebian 7 oder neuerUbuntu 12.04 oder neuer

Um die Applikation installieren und ausführen zu können, werden die folgenden Bibliothekenbenötigt. Falls die unten angeführten Pakete auf Ihrem Linux-Rechner noch nicht zurVerfügung stehen, führen Sie die Befehl yum (oder ggf. apt-get) aus, um sie zu installieren.

Erforderlich für CentOS, RedHat Debian Ubuntu

LicenseServer krb5-libs libgssapi-krb5-2 libgssap

http://www.altova.com/de/stylevision.html

http://www.altova.com/de/flowforce.html



4 Altova StyleVision Server 2017

© 2017 Altova GmbHAltova StyleVision Server


i-krb5-2

StyleVision Server qt4, krb5-libs, qt-x11 libqtcore4, libqtgui4,libgssapi-krb5-2

libqtcore4,libqtgui4,libgssapi-krb5-

© 2017 Altova GmbH

5Altova StyleVision Server 2017



2

(Mac) OS X, macOS

OS X 10.10, 10.11, 10.12 oder neuer

StyleVision Server steht sowohl für 32-Bit als auch 64-Bit-Windows-Rechner zur Verfügung.

Nähere Informationen zur Installation und Lizenzierung finden Sie in den Abschnitten "Einrichtenvon..." für Windows, Linux und Mac OS X.

Letzte Aktualisierung: 02.05.2017

6 Altova StyleVision Server 2017 Funktionalität


1.1 Funktionalität

StyleVision Server transformiert XML-Dateien mit Hilfe von XSLT-Stylesheets in HTML-, PDF-,RTF- und DOCX-Ausgabedokumente. Diese XSLT-Stylesheets sind in PXF-Dateien enthalten, diemit Altova StyleVision, der Altova-Applikation zur Erstellung von Stylesheets, erstellt wurden.

StyleVision Server kann auf zwei Arten verwendet werden:

als Teil des Altova Altova FlowForce Workflow. Nähere Informationen zu Altova FlowForcefinden Sie auf der Altova Website.als eigenständiges Server-Produkt, das über die Befehlszeile (CLI) aufgerufen wird

Eine XML-Input-Datei und eine PXF-Datei werden an StyleVision Server übergeben, der das/dieerforderliche(n) Ausgabedokument(e) erzeugt.

http://www.altova.com/de/stylevision.html



© 2017 Altova GmbH

Funktionalität 7Altova StyleVision Server 2017


1.1.1 Im FlowForce Workflow

Ein FlowForce Server-Auftrag wird in Altova FlowForce Server erstellt. Im FlowForce Server-Auftrag ist Folgendes definiert: (i) die Inputs und Outputs einer StyleVision Server Transformation;und (ii) die Trigger, wann der Auftrag ausgeführt werden soll, z.B. jeden Tag zu einer bestimmtenZeit. Bei der Ausführung übergibt Altova FlowForce Server die Transformationsanweisungen anStyleVision Server, der dann die Transformation ausführt.

Im unten gezeigten Diagramm sehen Sie die Rolle von StyleVision Server im FlowForce ServerWorkflow. (Im Diagramm sehen Sie auch die Rolle von MapForce Server im Workflow, daFlowForce Server-Aufträge erstellt werden können, die Altova MapForce Mappings zur Ausführungan den Altova MapForce Server senden.)

StyleVision Server kann nicht nur über einen FlowForce Server-Auftrag, sondern auch über dieBefehlszeile aufgerufen werden. Eine Beschreibung dazu finden Sie im Abschnitt Verwendungüber die Befehlszeile.


http://www.altova.com/de/mapforce.html

http://www.altova.com/de/mapforce/mapforce-server.html

8 Altova StyleVision Server 2017 Funktionalität


1.1.2 Als eigenständiger Server

StyleVision Server kann auf Windows-, Linux- und Mac OS X-Systemen als eigenständigesProdukt installiert werden. In dieser Version werden seine Funktionalitäten nur über dieBefehlszeile aufgerufen. Eine Beschreibung dazu finden Sie im Abschnitt Verwendung über dieBefehlszeile.

© 2017 Altova GmbH

Einrichten unter Windows 9Altova StyleVision Server 2017


1.2 Einrichten unter Windows

In diesem Abschnitt werden die Installation und Lizenzierung von StyleVision Server auf Windows-Systemen beschrieben.

Installation unter WindowsSystemanforderungenInstallation von StyleVision Server Altova LicenseServer LicenseServer-VersionenTestlizenzPfad des Applikationsordners

Lizenzierung unter WindowsStarten von ServiceController Starten von LicenseServer Registrieren von StyleVision ServerZuweisen einer Lizenz

10 Altova StyleVision Server 2017 Einrichten unter Windows


1.2.1 Installation unter Windows

Altova StyleVision Server ist für die Installation auf Windows-Systemen verfügbar. Im Folgendenfinden Sie eine Anleitung zur Installation und Konfiguration.

Systemanforderungen

Windows


Windows Server


Installation von StyleVision Server

StyleVision Server kann folgendermaßen auf Windows-Systemen installiert werden:

als separates, eigenständiges Server-Produkt namens StyleVision Server. UmStyleVision Server zu installieren, laden Sie den StyleVision Server Installer herunterund installieren Sie das Programm. Befolgen Sie die Anweisungen auf demBildschirm.Als Teil des Altova FlowForce Server Installationspakets[[ FlowForce Server ist eineApplikation zur Planung und zeitlichen Festsetzung verschiedener Arten vonAufträgen für Altova-Server-Produkte. Daher bietet das FlowForce Server-PaketOptionen, Altove Server-Produkte (wie <%APPNAME%>)zusammen mit FlowForceServer zu installieren. Jedes Server-Produkt wird in einem separatenProgrammordner installiert. ]]. Um StyleVision Server als Teil des FlowForce Server-Pakets zu installieren, laden Sie den FlowForce Server Installer herunter undinstallieren Sie das Programm. Befolgen Sie die Anweisungen auf dem Bildschirmund stellen Sie sicher, dass Sie die Option zur Installation von StyleVision Serveraktiviert haben.

Beide Produkte, FlowForce Server und StyleVision Server, können vom Altova DownloadCenter (http://www.altova.com/dedownload.html) heruntergeladen werden.

Nach der Installation befindet sich die ausführbare %APPNAME%>-Datei im folgendenOrdner:

<ProgramFilesFolder>\Altova\StyleVisionServer2017\bin

\StyleVisionServer.exe

Altova LicenseServer

Damit StyleVision Server ausgeführt werden kann, muss das Programm auf einem AltovaLicenseServer auf Ihrem Netzwerk registriert sein.Wenn Sie StyleVision Server oder FlowForce Server [[ Nähere Informationen zu FlowForce Server finden Sie unter dem vorherigen Punkt, 'Installation von <%APPNAME%>' ]] auf Windows-Systemen installieren, steht eine Option zur Verfügung, mit der AltovaLicenseServer zusammen mit StyleVision Server oder FlowForce Server [[ NähereInformationen zu FlowForce Server finden Sie unter dem vorherigen Punkt, 'Installation von<%APPNAME%>' ]] heruntergeladen und installiert werden kann.Wenn in Ihrem Netzwerk bereits ein Altova LicenseServer installiert ist, müssen Sie



http://www.altova.com/dedownload.html

© 2017 Altova GmbH



keinen weiteren installieren, es sei denn, es wird eine neuere Version von AltovaLicenseServer benötigt (Siehe nächster Punkt LicenseServer-Versionen.)Aktivieren oder deaktivieren Sie bei der Installation von StyleVision Server oder FlowForceServer [[ Nähere Informationen zu FlowForce Server finden Sie unter dem vorherigenPunkt, 'Installation von <%APPNAME%>' ]] je nach Bedarf die Option zur Installation vonAltova LicenseServer.

Nähere Informationen zum Registrieren und Lizenzieren von StyleVision Server auf dem Altova LicenseServer und zur Lizenzierung finden Sie im Abschnitt Lizenzierung unterWindows.

LicenseServer-Versionen

Altova Server-Produkte müssen entweder mit der zum Zeitpunkt der Release vonStyleVision Server aktuellen Version von LicenseServer oder einer späteren Versionvon LicenseServer lizenziert werden.Welche Version von LicenseServer für eine bestimmte Version von StyleVisionServer geeignet ist, wird während der Installation von StyleVision Server angezeigt.Sie können diese Version von LicenseServer zusammen mit StyleVision Serverinstallieren oder Sie können LicenseServer separat installieren.Bevor Sie eine neuere Version von LicenseServer installieren, muss eine eventuellvorhandene ältere Version deinstalliert werden. Das Installationsprogramm vonLicenseServer führt dies bei Vorhandensein einer älteren Version automatisch durch.LicenseServer-Versionen sind rückwärts kompatibel. Sie funktionieren auch mitälteren Versionen von StyleVision Server.Wenn Sie eine neue Version von StyleVision Server installieren und Ihre installierteVersion von LicenseServer älter als der dafür vorgesehene LicenseServer ist,installieren Sie die neueste auf der Altova Website verfügbare Version.Bei der Deinstallation werden alle Registrierungs- und Lizenzierungsinformationenaus der älteren LicenseServer-Version in einer Datenbank auf Ihrem Servergespeichert. Diese Daten werden automatisch in die neuere Version importiert.Sie finden die Versionsnummer des aktuell installierten LicenseServer am unterenRand der LicenseServer Konfigurationsseite (alle Register).

Aktuelle Version: 2.3

Testlizenz

Bei der Installation haben Sie die Option, eine 30-Tage-Testlizenz für StyleVision Serveranzufordern. Nach Absendung der Anforderung erhalten Sie an die von Ihnen registrierte E-Mail-Adresse eine Testlizenz zugesandt.

Pfad des Applikationsordners

Die Applikation wird im folgenden Ordner installiert:

Windows Vista, Windows 7, 8, 10 C:\Programme\Altova\

32-Bit-Version auf 64-Bit OS C:\Programme (x86)\Altova\

© 2017 Altova GmbH



1.2.2 Lizenzierung unter Windows

Damit StyleVision Server ausgeführt werden kann, muss das Programm auf einem LicenseServerlizenziert werden. Eine Anleitung zur Lizenzierung von StyleVision Server finden Sie weiter unten.

1. Registrieren von StyleVision Server auf LicenseServer. Die Registrierung erfolgt überStyleVision Server.

2. Zuweisen einer Lizenz zu StyleVision Server. Die Zuweisung der Lizenz erfolgt überLicenseServer.

Im Folgenden sind die einzelnen Schritte beschrieben.

Starten von ServiceController

Der ServiceController wird gestartet, damit Sie damit LicenseServer starten können.

Der Altova ServiceController (in der Folge ServiceController genannt) ist eine Applikation, mitder Sie Altova-Dienste auf Windows-Systemen starten, beenden und konfigurieren können.

ServiceController wird mit Altova LicenseServer und jedem Altova Server-Produkt, dasServiceController verwendet (FlowForce Server, RaptorXML(+XBRL) Server und MobileTogether Server), installiert und kann durch Klicken auf Start | Altova LicenseServer |Altova ServiceController gestartet werden. (Dieser Befehl steht auch in denStartmenüordnern der Altova Server-Produkten, die als Dienst installiert wurden(FlowForce Server, RaptorXML(+XBRL) Server und Mobile Together Server), zur Verfügung).Nachdem der ServiceController gestartet wurde, kann er über die Task-Leiste aufgerufenwerden (Abbildung unten).

Damit der ServiceController automatisch ausgeführt wird, nachdem sich der Benutzer imSystem angemeldet hat, klicken Sie in der Task-Leiste auf das ServiceController-Symbol,um das ServiceController-Menü (Abbildung unten) aufzurufen und aktivieren Sieanschließend den Befehl Run Altova ServiceController at Startup. (Dieser Befehl iststandardmäßig aktiv). Um den ServiceController zu beenden, klicken Sie in der Task-Leisteauf das ServiceController-Symbol und klicken Sie im Menü, das daraufhin angezeigt wird(Abbildung unten) auf Exit Altova ServiceController.



Starten von LicenseServer

Um LicenseServer zu starten, klicken Sie in der Task-Leiste auf das AltovaServiceController-Symbol und platzieren Sie den Mauszeiger im angezeigten Menü überAltova LicenseServer (Abbildung unten) und wählen Sie im Untermenü von AltovaLicenseServer den Befehl Start Service. Wenn LicenseServer bereits ausgeführt wird, istdie Option Start Service deaktiviert.

Registrieren von StyleVision Server

Um StyleVision Server über die Befehlszeilenschnittstelle zu registrieren, verwenden Sie denBefehl licenseserver:

StyleVisionServer licenseserver [options] ServerName-Or-IP-Address

Wenn z.B. localhost der Name des Servers ist, auf dem LicenseServer installiert ist:StyleVisionServer licenseserver localhost

Wenn StyleVision Server im Rahmen der FlowForce Server Installation installiert wurde, wirdbei der Registrierung von FlowForce Server auch StyleVision Server automatisch aufLicenseServer registriert: (i) Starten Sie Altova FlowForce Web über den ServiceController(siehe vorheriger Punkt); (ii) Geben Sie Ihr Passwort für den Zugriff auf die Setup-Seite ein;(iii) Wählen Sie den LicenseServer-Namen oder die Adresse aus und klicken Sie auf AufLicenseServer registrieren. Nähere Informationen dazu finden Sie unter Registrieren von


© 2017 Altova GmbH



FlowForce Server.

Nachdem Sie das Produkt registriert haben, können Sie StyleVision Server über dieKonfigurationsseite von LicenseServer über das Register Server Management eine Lizenzzuweisen.

Zuweisen einer Lizenz

Nachdem Sie StyleVision Server erfolgreich registriert haben, wird die Applikation auf derKonfigurationsseite von LicenseServer auf dem Register "Server Management" aufgelistet.Sie können nun zu LicenseServer wechseln und StyleVision Server eine Lizenz zuweisen.

Anmerkung zu Prozessorkernen und LizenzenDie Lizenzierung von Altova Server-Produkten basiert auf der Anzahl der auf demProduktrechner verfügbaren Prozessorkerne. So hat z.B. ein Dual-Core-Prozessor zweiProzessorkerne, ein Quad-Core-Prozessor hat vier Kerne, ein Hexa-Core-Prozessor hatsechs Kerne, usw. Die Anzahl der für ein Produkt lizenzierten Kerne muss größer odergleich der Anzahl der auf diesem Serverrechner verfügbaren Kerne sein, unabhängig davon,ob es sich um einen physischen Rechner oder eine Virtual Machine handelt. Wenn einServer z.B. acht Kerne hat (ein Octa-Core-Prozessor), müssen Sie mindestens eine Lizenzfür acht Kerne erwerben. Sie können Lizenzen auch kombinieren, um das Produkt für dieentsprechende Anzahl von Kernen zu lizenzieren. So können z.B. anstelle einer Lizenz für 8Kerne auch zwei Lizenzen für 4 Kerne für einen 8-Kern-Prozessor verwendet werden.

Wenn Sie einen Server-Rechner mit einer großen Anzahl von CPU-Kernen verwenden, abernur geringe Datenmengen verarbeiten müssen, können Sie auch eine Virtual Machineerstellen, der eine geringere Anzahl an Kernen zugewiesen ist und eine Lizenz für dieseAnzahl an Kernen erwerben. In diesem Fall ist die Verarbeitungsgeschwindigkeit natürlichgeringer als bei Verwendung aller Kerne des Rechners.

Anmerkung: Jede Altova Server-Produktlizenz kann immer nur für einen Client-Rechnergleichzeitig verwendet werden, selbst wenn die Lizenzkapazität dieser Lizenz nochnicht ausgeschöpft ist. Wenn z.B. eine 10-Kern-Lizenz für einen Client-Rechner mit6 CPU-Kernen verwendet wird, so können die verbleibenden Lizenzen für dierestlichen 4 Kerne nicht gleichzeitig für einen anderen Client-Rechner verwendetwerden.

MobileTogether Server-LizenzenMobileTogether Server-Lizenzen basieren auf der Anzahl der CPU-Kerne auf demMobileTogether Serverrechner. Bei diesem Modell können unbegrenzt viele MobileTogetherClient-Geräte mit dem Server verbunden werden. Wenn Sie jedoch das Kontrollkästchen Limit to single thread execution aktivieren, so kann immer nur ein Mobilgerät mit demMobileTogether Server verbunden werden. Dies ist für die Evaluierung und für Tests imkleinen Rahmen nützlich. Beachten Sie Folgendes: Wenn in diesem Fall ein zweites Gerätmit MobileTogether Sever verbunden wird, so übernimmt dieses die Lizenz. Das erste Gerätkann daraufhin keine Verbindung mehr herstellen und erhält eine entsprechendeFehlermeldung.

16 Altova StyleVision Server 2017 Einrichten unter Linux


1.3 Einrichten unter Linux

In diesem Abschnitt werden die Installation und Lizenzierung von StyleVision Server auf Linux-Systemen (Debian, Ubuntu, CentOS, RedHat) beschrieben.

Installation unter LinuxSystemanforderungen Deinstallieren alter Versionen von Altova Server-ProduktenHerunterladen des Linux-PaketsInstallieren von StyleVision Server Altova LicenseServer LicenseServer-VersionenTestlizenz

Lizenzierung unter LinuxStarten von LicenseServer Registrieren von StyleVision Server Zuweisen einer Lizenz

Anmerkungen zur Umgebung

© 2017 Altova GmbH

Einrichten unter Linux 17Altova StyleVision Server 2017


1.3.1 Installation unter Linux

StyleVision Server steht für die Installation auf Linux-Systemen zur Verfügung. Im Folgendenfinden Sie eine Beschreibung der Installation und Konfiguration des Produkts.

Systemanforderungen

Linux


Um die Applikation installieren und ausführen zu können, werden die folgendenBibliotheken benötigt. Falls die unten angeführten Pakete auf Ihrem Linux-Rechnernoch nicht zur Verfügung stehen, führen Sie die Befehl yum (oder ggf. apt-get) aus, umsie zu installieren.


LicenseServer krb5-libs libgssapi-krb5-2 libgssapi-krb5-2


libqtcore4




,libqtgui4,libgssapi-krb5-2

FlowForce Server-Integration

Wenn Sie StyleVision Server zusammen mit FlowForce Server installieren, sollten Siezuerst FlowForce Server installieren. Führen Sie andernfalls nach Installation von sowohlStyleVision Server als auch FlowForce Server den folgenden Befehl aus:

cp /opt/Altova/StyleVisionServer2017/etc/*.tool /opt/Altova/FlowForceServer2017/tools

Dieser Befehl kopiert die .tool-Datei aus dem Verzeichnis /etc von StyleVision Server in dasFlowForce Server /tools-Verzeichnis. Die Datei .tool wird von FlowForce Server benötigt; sieenthält den Pfad zur ausführbaren StyleVision Server Datei. Sie müssen diesen Befehl nichtausführen, wenn Sie FlowForce Server vor StyleVision Server installieren.

© 2017 Altova GmbH



Deinstallieren einer alten Version von Altova Server-Produkten

Wenn Sie eine Vorgängerversion deinstallieren müssen, gehen Sie folgendermaßen vor.Überprüfen Sie in der Linux-Befehlszeile (Command Line Interface = CLI), welche AltovaServer-Produkte installiert sind. Verwenden Sie dazu den Befehl:[Debian, Ubuntu]: dpkg --list | grep Altova

[CentOS, RedHat]: rpm -qa | grep server

Falls StyleVision Server nicht installiert ist, beginnen Sie mit der Installation, wie dies weiterunten unter Installieren von StyleVision Server dokumentiert ist.

Falls StyleVision Server installiert ist und Sie eine neuere Version von StyleVision Serverinstallieren möchten, deinstallieren Sie die alte Version mit dem Befehl:[Debian, Ubuntu]: sudo dpkg --remove stylevisionserver

[CentOS, RedHat]: sudo rpm -e stylevisionserver

Falls Sie eine neuere Version von Altova LicenseServer installieren möchten, deinstallierenSie die alte Version mit dem Befehl:[Debian, Ubuntu]: sudo dpkg --remove licenseserver

[CentOS, RedHat]: sudo rpm -e licenseserver

Herunterladen des Linux-Pakets

Auf der Altova Website stehen StyleVision Server-Installationspakete für die folgenden Linux-Systeme zur Verfügung.

Distribution Paketerweiterung

Debian 7 und höher .deb

Ubuntu12.04 und höher .deb

CentOS 6 und höher .rpm

RedHat 6 und höher .rpm

Nachdem Sie das Linux-Paket von der Altova Website heruntergeladen haben, kopieren Siedas Paket in ein beliebiges Verzeichnis auf dem Linux-System. Da Sie zum Ausführen vonStyleVision Server einen Altova LicenseServer benötigen, sollten Sie gleichzeitig mitStyleVision Server auch LicenseServer von der Altova Website herunterladen, anstattLicenseServer erst später herunterzuladen.

Installieren von StyleVision Server

Wechseln Sie in einem Terminal-Fenster zu dem Verzeichnis, in das Sie das Linux-Paketkopiert haben. Wenn Sie es z.B. in ein Benutzerverzeichnis namens MyAltova (das sichz.B. im Verzeichnis /home/User befindet) kopiert haben, dann wechseln Siefolgendermaßen zu diesem Verzeichnis:cd /home/User/MyAltova

http://www.altova.com/de/download.html

http://www.altova.com/de/




Installieren Sie StyleVision Server mit dem folgenden Befehl:[Debian]: sudo dpkg --install stylevisionserver-2017-debian.deb

[Ubuntu]: sudo dpkg --install stylevisionserver-2017-ubuntu.deb

[CentOS]: sudo rpm -ivh stylevisionserver-2017-1.x86_64.rpm

[RedHat]: sudo rpm -ivh stylevisionserver-2017-1.x86_64.rpm

Das StyleVision Server-Paket wird im folgenden Ordner installiert:/opt/Altova/StyleVisionServer2017


Damit ein Altova Server-Produkt - darunter auch StyleVision Server - ausgeführt werdenkann, muss es auf einem Altova LicenseServer auf Ihrem Netzwerk registriert sein.

Auf Linux-Systemen muss Altova LicenseServer separat installiert werden. Laden Sie AltovaLicenseServer von der Altova Website herunter und kopieren Sie das Paket in ein beliebigesVerzeichnis auf dem Linux-System. Installieren Sie es genau wie StyleVision Server (siehevorheriger Schritt). [Debian]: sudo dpkg --install licenseserver-2.3-debian.deb

[Ubuntu]: sudo dpkg --install licenseserver-2.3-ubuntu.deb

[CentOS]: sudo rpm -ivh licenseserver-2.3-1.x86_64.rpm

[RedHat]: sudo rpm -ivh licenseserver-2.3-1.x86_64.rpm

Das LicenseServer-Paket wird im folgenden Ordner installiert:

/opt/Altova/LicenseServer

Eine Anleitung, wie Sie StyleVision Server auf dem Altova LicenseServer registrieren undlizenzieren, finden Sie im Abschnitt Lizenzierung unter Linux.


Altova Server-Produkte müssen entweder mit der zum Zeitpunkt der Release vonStyleVision Server aktuellen Version von LicenseServer oder einer späteren Versionvon LicenseServer lizenziert werden.Welche Version von LicenseServer für eine bestimmte Version von StyleVisionServer geeignet ist, wird während der Installation von StyleVision Server angezeigt.Sie können diese Version von LicenseServer zusammen mit StyleVision Serverinstallieren oder Sie können LicenseServer separat installieren.Bevor Sie eine neuere Version von LicenseServer installieren, muss eine eventuellvorhandene ältere Version deinstalliert werden. Das Installationsprogramm vonLicenseServer führt dies bei Vorhandensein einer älteren Version automatisch durch.LicenseServer-Versionen sind rückwärts kompatibel. Sie funktionieren auch mitälteren Versionen von StyleVision Server.Wenn Sie eine neue Version von StyleVision Server installieren und Ihre installierteVersion von LicenseServer älter als der dafür vorgesehene LicenseServer ist,installieren Sie die neueste auf der Altova Website verfügbare Version.Bei der Deinstallation werden alle Registrierungs- und Lizenzierungsinformationenaus der älteren LicenseServer-Version in einer Datenbank auf Ihrem Servergespeichert. Diese Daten werden automatisch in die neuere Version importiert.


© 2017 Altova GmbH



Sie finden die Versionsnummer des aktuell installierten LicenseServer am unterenRand der LicenseServer Konfigurationsseite (alle Register).


Testlizenz




1.3.2 Lizenzierung unter Linux

Damit StyleVision Server ausgeführt werden kann, muss das Programm auf einem AltovaLicenseServer lizenziert werden. Die Lizenzierung erfolgt in zwei Schritten:





Damit StyleVision Server auf dem LicenseServer korrekt registriert und lizenziert werdenkann, muss LicenseServer als Daemon im Netzwerk ausgeführt werden. Starten Sie LicenseServer mit dem folgenden Befehl als Daemon:

[< Debian 8] sudo /etc/init.d/licenseserver start

sudo systemctl start licenseserver

[< CentOS 7] sudo initctl start licenseserver


[< Ubuntu 15] sudo initctl start licenseserver


[RedHat] sudo initctl start licenseserver

Um LicenseServer zu beenden, ersetzen Sie start in den obigen Befehlen durch stop.

Beispiel:sudo /etc/init.d/licenseserver stop



sudo /opt/Altova/StyleVisionServer2017/bin/stylevisionserver

licenseserver [options] ServerName-Or-IP-Address

Wenn z.B. localhost der Name des Servers ist, auf dem LicenseServer installiert ist:sudo /opt/Altova/StyleVisionServer2017/bin/stylevisionserver

licenseserver localhost

Im obigen Befehl ist localhost der Name des Servers, auf dem LicenseServer installiert ist.Beachten Sie außerdem, dass der Pfad der ausführbaren StyleVision Server Dateifolgendermaßen lautet:

/opt/Altova/StyleVisionServer2017/bin/

Nachdem Sie StyleVision Server erfolgreich registriert haben, gehen Sie zum Register

© 2017 Altova GmbH



"Server Management" der LicenseServer-Konfigurationsseite, um StyleVision Server eineLizenz zuzuweisen.


Nachdem Sie StyleVision Server erfolgreich registriert haben, wird das Produkt auf derKonfigurationsseite von LicenseServer auf dem Register Server Management aufgelistet. Siekönnen LicenseServer nun aufrufen und StyleVision Server eine Lizenz zuweisen.







1.3.3 Anmerkungen zur Umgebung

OrdnerIm Folgenden finden Sie eine Liste wichtiger Ordner in Ihrer StyleVision Server-Installation.

Root-Ordner der Installation

/opt/Altova/StyleVisionServer2017/

Datenbank-, Lizenz- und Lösungsdateien

/var/opt/Altova/StyleVisionServer

Umgebungseinstellungen

/etc/profile.d/jdbc.sh

Die Datei für die Umgebungseinstellungen muss entsprechend Ihrer jeweiligen Umgebungkonfiguriert sein. Der obige Pfad dient nur als allgemeines Beispiel.Anmerkung: Die Datei für die Umgebungseinstellungen definiert die Variablen für alle

Benutzer auf dem System.

JDBC-VerbindungenBeachten Sie die folgenden Punkte:

• Das Java Runtime Environment oder SDK muss installiert sein• Die JDBC-Treiber für die Zieldatenbank müssen installiert sein• Die folgenden Umgebungsvariablen müssen für Ihre Umgebung richtig konfiguriert werden:

o CLASSPATH: Um die jar-Dateien zu finden

o PATH: Um die JRE zu finden. Nicht unbedingt erforderlich, hängt von der Installation

abo JAVA_HOME: Falls nötig - abhängig von der Installation.

AnmerkungAuf Linux-Servern werden nur JDBC-Datenbankverbindungen unterstützt.

© 2017 Altova GmbH

Einrichten auf Mac OS X 25Altova StyleVision Server 2017


1.4 Einrichten auf Mac OS X

In diesem Abschnitt werden die Installation und Lizenzierung von StyleVision Server auf Mac OSX-Systemen beschrieben.

Installation unter Mac OS XSystemanforderungen Deinstallieren alter Versionen von Altova Server-ProduktenHerunterladen des Mac OS X-PaketsInstallieren von StyleVision Server Altova LicenseServer LicenseServer-VersionenTestlizenz

Licenzierung unter Mac OS XStarten von LicenseServer Registrieren von StyleVision Server Zuweisen einer Lizenz

Anmerkungen zur Umgebung

26 Altova StyleVision Server 2017 Einrichten auf Mac OS X


1.4.1 Installation auf Mac OS X

StyleVision Server steht für die Installation auf Mac OS X-Systemen zur Verfügung. Im Folgendenfinden Sie eine Beschreibung der Installation und Konfiguration.

Systemanforderungen

(Mac) OS X, macOS

OS X 10.10, 10.11, 10.12 oder neuer

FlowForce Server-Integration

Wenn Sie StyleVision Server zusammen mit FlowForce Server installieren, sollten Siezuerst FlowForce Server installieren. Falls Sie APPNAME%> vor FlowForce Serverinstallieren, führen Sie nach Installation von sowohl StyleVision Server als auch FlowForceServer den folgenden Befehl aus:

cp /usr/local/Altova/StyleVisionServer2017/etc/*.tool /usr/local/Altova/FlowForceServer2017/tools

Dieser Befehl kopiert die .tool-Datei aus dem Verzeichnis /etc von StyleVision Server in dasFlowForce Server /tools-Verzeichnis. Die Datei .tool wird von FlowForce Server benötigt; sieenthält den Pfad zur ausführbaren StyleVision Server Datei. Sie müssen diesen Befehl nichtausführen, wenn Sie FlowForce Server vor StyleVision Server installieren.

Deinstallieren alter Versionen von Altova Server-Produken

Klicken Sie im Finder im Applikationsordner mit der rechten Maustaste auf das StyleVisionServer-Symbol und wählen Sie den Befehl Move to Trash. Die Applikation wird daraufhin inden Papierkorb verschoben. Sie müssen die Applikation jetzt noch aus dem Ordner usrentfernen. Verwenden Sie dazu den folgenden Befehl:sudo rm -rf /usr/local/Altova/StyleVisionServer2017/

Wenn Sie eine ältere Version von Altova LicenseServer deinstallieren müssen, stoppen Sieden Dienst zuerst mit dem folgenden Befehl:sudo launchctl unload /Library/LaunchDaemons/

com.altova.LicenseServer.plist

Um zu überprüfen, ob der Dienst gestoppt wurde, öffnen Sie den Activity Monitor im Finderund vergewissern Sie sich, dass sich LicenseServer nicht auf der Liste befindet. Fahren Sieanschließend mit der Deinstallation fort, wie oben für StyleVision Server beschrieben.

Herunterladen der Disk Image-Datei

Laden Sie die Disk Image (.dmg)-Datei von der Altova-Website herunter (http://www.altova.com/de/download.html).



© 2017 Altova GmbH



Installieren von StyleVision Server

Klicken Sie auf die heruntergeladene Disk Image (.dmg)-Datei, um sie zu öffnen. Dadurchwird der StyleVision Server-Installer als neues virtuelles Laufwerk auf Ihrem Computerangezeigt. Doppelklicken Sie auf diesem neuen virtuellen Laufwerk auf das Installer-Paket(.pkg). Befolgen Sie die selbsterklärenden Anweisungen des Installationsassistenten, in demSie auch die Lizenzvereinbarung akzeptieren müssen, bevor Sie mit der Installation fortfahrenkönnen. Um das Laufwerk nach der Installation wieder auszuwerfen, klicken Sie auf dierechte Maustaste und wählen Sie die Befehl Auswerfen.

Das StyleVision Server-Paket wird im folgenden Ordner installiert:/usr/local/Altova/StyleVisionServer2017 (Applikationsbinärdateien)

/var/Altova/StyleVisionServer (Datendateien: Datenbank und Logs)


Damit ein Altova Server-Produkt - darunter auch StyleVision Server - ausgeführt werdenkann, muss es auf einem Altova LicenseServer auf Ihrem Netzwerk lizenziert sein.

Das Altova LicenseServer-Installationspaket finden Sie auf dem virtuellen Laufwerk, das Sieim vorhergehenden Schritt angelegt haben. Um Altova LicenseServer zu installieren,doppelklicken Sie auf das Installer-Paket auf dem virtuellen Laufwerk und befolgen Sie dieAnweisungen auf dem Bildschirm. Damit die Installation fortgesetzt wird, müssen Sie dieLizenzvereinbarung akzeptieren.

Altova LicenseServer kann auch separat von der Altova Website heruntergeladen undinstalliert werden (http://www.altova.com/de/download.html).


/usr/local/Altova/LicenseServer

Informationen zum Registrieren von StyleVision Server auf dem Altova LicenseServer undzum Lizenzieren des Produkts finden Sie im Abschnitt Lizenzierung unter Mac OS X.


Altova Server-Produkte müssen entweder mit der zum Zeitpunkt der Release vonStyleVision Server aktuellen Version von LicenseServer oder einer späteren Versionvon LicenseServer lizenziert werden.Welche Version von LicenseServer für eine bestimmte Version von StyleVisionServer geeignet ist, wird während der Installation von StyleVision Server angezeigt.Sie können diese Version von LicenseServer zusammen mit StyleVision Serverinstallieren oder Sie können LicenseServer separat installieren.Bevor Sie eine neuere Version von LicenseServer installieren, muss eine eventuellvorhandene ältere Version deinstalliert werden. Das Installationsprogramm vonLicenseServer führt dies bei Vorhandensein einer älteren Version automatisch durch.LicenseServer-Versionen sind rückwärts kompatibel. Sie funktionieren auch mitälteren Versionen von StyleVision Server.Wenn Sie eine neue Version von StyleVision Server installieren und Ihre installierteVersion von LicenseServer älter als der dafür vorgesehene LicenseServer ist,




installieren Sie die neueste auf der Altova Website verfügbare Version.Bei der Deinstallation werden alle Registrierungs- und Lizenzierungsinformationenaus der älteren LicenseServer-Version in einer Datenbank auf Ihrem Servergespeichert. Diese Daten werden automatisch in die neuere Version importiert.Sie finden die Versionsnummer des aktuell installierten LicenseServer am unterenRand der LicenseServer Konfigurationsseite (alle Register).


Testlizenz


© 2017 Altova GmbH



1.4.2 Lizenzierung auf Mac OS X

Damit StyleVision Server ausgeführt werden kann, muss das Programm auf einem AltovaLicenseServer lizenziert werden. Die Lizenzierung erfolgt in zwei Schritten:





Damit StyleVision Server auf dem LicenseServer korrekt registriert und lizenziert werdenkann, muss LicenseServer als Daemon im Netzwerk ausgeführt werden. Starten Sie LicenseServer mit dem folgenden Befehl als Daemon:

sudo launchctl load /Library/LaunchDaemons/com.altova.LicenseServer.plist

Um LicenseServer zu beenden, ersetzen Sie load im obigen Befehl durch unload. Beispiel:sudo launchctl unload /Library/LaunchDaemons/

com.altova.LicenseServer.plist



sudo /opt/Altova/StyleVisionServer2017/bin/stylevisionserver

licenseserver [options] ServerName-Oder-IP-Adresse

Wenn z.B. localhost der Name des Servers ist, auf dem LicenseServer installiert ist:sudo /opt/Altova/StyleVisionServer2017/bin/stylevisionserver

licenseserver localhost

Im obigen Befehl ist localhost der Name des Servers, auf dem LicenseServer installiertist. Beachten Sie außerdem, dass der Pfad der ausführbaren StyleVision Server Dateifolgendermaßen lautet:

/opt/Altova/StyleVisionServer2017/bin/

Nachdem Sie StyleVision Server erfolgreich registriert haben, können Sie dem Produkt nunüber das Register "Server Management" der LicenseServer-Konfigurationsseite eine Lizenzzuweisen.


Nachdem Sie StyleVision Server erfolgreich registriert haben, wird das Produkt auf derKonfigurationsseite von LicenseServer auf dem Register "Server Management" aufgelistet.



Sie können LicenseServer nun aufrufen und StyleVision Server eine Lizenz zuweisen.





© 2017 Altova GmbH



1.4.3 Anmerkungen zur Umgebung

OrdnerIm Folgenden finden Sie eine Liste wichtiger Ordner in Ihrer StyleVision Server-Installation.

Root-Ordner der Installation

/usr/local/Altova/StyleVisionServer2017/

Datenbank-, Lizenz- und Lösungsdateien

/var/Altova/StyleVisionServer

Umgebungseinstellungen

/Library/LaunchDaemons/com.altova.MobileTogetherServer.plist

Die Datei für die Umgebungseinstellungen muss entsprechend Ihrer jeweiligen Umgebungkonfiguriert sein. Der obige Pfad dient nur als allgemeines Beispiel.Anmerkung: Diese Umgebungsvariablen sind nur für den StyleVision Server Prozess

definiert und haben keine Auswirkung auf andere Benutzer.

JDBC-VerbindungenBeachten Sie die folgenden Punkte:

• Das Java Runtime Environment oder SDK muss installiert sein• Die JDBC-Treiber für die Zieldatenbank müssen installiert sein• Die folgenden Umgebungsvariablen müssen für Ihre Umgebung richtig konfiguriert werden:

o CLASSPATH: Um die jar-Dateien zu finden

o PATH: Um die JRE zu finden. Nicht unbedingt erforderlich, hängt von der Installation

abo JAVA_HOME: Falls nötig - abhängig von der Installation.

AnmerkungAuf Mac OS X-Servern werden nur JDBC-Datenbankverbindungen unterstützt.

32 Altova StyleVision Server 2017 Verwendung über die Befehlszeile


1.5 Verwendung über die Befehlszeile

In diesem Abschnitt werden folgende Punkte beschrieben:

Standardpfad der ausführbaren StyleVision Server-DateiVerwendung und Liste der CLI-Befehle

Standardpfad der ausführbaren StyleVision Server-DateiIm Folgenden finden Sie die jeweiligen Standardpfade der ausführbaren StyleVision Server-Datei:

Windows <ProgramFilesFolder>\Altova\StyleVisionServer2017\bin

\StyleVisionServer.exe

Linux /opt/Altova/StyleVisionServer2017/bin/stylevisionserver

Mac /usr/local/Altova/StyleVisionServer2017/bin/stylevisionserver

Verwendung und Liste der CLI-BefehleAllgemeine Befehlszeilensyntax für StyleVisionServer:

Windows StyleVisionServer --h | --help | --version | <command> [options]

[arguments]

Linux stylevisionserver --h | --help | --version | <command> [options]

[arguments]

Mac stylevisionserver --h | --help | --version | <command> [options]

[arguments]

Groß- und Kleinschreibung und Schrägstriche in der Befehlszeile

StyleVisionServer unter Windows

stylevisionserver unter Unix (Linux, Mac)

* Beachten Sie, dass klein geschriebene Befehle (stylevisionserver) auf allen Plattformen(Windows, Linux und Mac) funktionieren, während großgeschriebene Befehle(StyleVisionServer) nur unter Windows und Mac ausgeführt werden.*Verwenden Sie auf Linux und Mac-Systemen Schrägstriche und auf Windows-Systemenumgekehrte Schrägstriche.

wobei

--h | --help den Hilfetext anzeigt.

--version die Version von StyleVision Server anzeigt.

© 2017 Altova GmbH

Verwendung über die Befehlszeile 33Altova StyleVision Server 2017


Im Folgenden sind gültige CLI-Befehle aufgelistet, die in den Unterabschnitten dieses Abschnittsnäher beschrieben werden.

licenseserver Registriert StyleVision Server auf dem Altova LicenseServerim lokalen Netzwerk.

assignlicense Lädt eine Lizenz in LicenseServer hoch und weist sieStyleVision Server auf diesem Rechner zu.

verifylicense Überprüft, ob der aktuelle StyleVision Server lizenziert ist;optional dazu können Sie überprüfen, ob ein bestimmterLizenzschlüssel zugewiesen ist.

generate | gen Generiert ein oder mehrere Dokumente.

setfopath | sfp Wählt eine FO-Prozessor für die anschließende PDF-Generierung aus.

pdfdata Generiert in einer FDF- oder XML-Datei anhand einer PDF-Datei Formulardaten.

exportresourcestrings Exportiert alle Applikationsressourcenstrings in eine XML-Datei.

setdeflang | sdl Definiert die Standardsprache.

help Zeigt die Hilfe zu einem bestimmten Befehl an. z.B.: help generate



1.5.1 licenseserver


BefehlssyntaxBeschreibung des BefehlsBeispieleBefehlsoptionen

Befehlssyntax

Windows StyleVisionServer licenseserver [options] Server-Or-IP-Address

Linux stylevisionserver licenseserver [options] Server-Or-IP-Address

Mac stylevisionserver licenseserver [options] Server-Or-IP-Address

Beschreibung des BefehlsBei Ausführung des Befehls licenseserver wird StyleVision Server auf dem durch dasArgument Server-Or-IP-Address definierten LicenseServer registriert. Server-Or-IP-Address

identifiziert den Rechner oder das Netzwerk, auf dem Altova LicenseServer installiert ist undausgeführt wird. Es kann sich hierbei um den Namen oder die IP-Adresse des Rechners handeln.

Damit der Befehl licenseserver erfolgreich ausgeführt werden kann, müssen die beiden Serverim Netzwerk miteinander verbunden sein und LicenseServer muss ausgeführt werden. Siebenötigen zum Registrieren von StyleVision Server auf dem LicenseServer Administratorrechte.

Sobald StyleVision Server erfolgreich auf dem LicenseServer registriert wurde, erhalten Sie eineentsprechende Meldung. Darin wird auch die URL des LicenseServer angezeigt. Sie können nunzu LicenseServer wechseln und StyleVision Server eine Lizenz zuweisen. Nähere Informationendazu finden Sie in der Dokumentation zu LicenseServer.

BeispieleBeispiel für den Befehl licenseserver:

StyleVisionServer licenseserver DOC.altova.com

StyleVisionServer licenseserver localhost

StyleVisionServer licenseserver 127.0.0.1

Die Befehle oben definieren den Rechner namens DOC.altova.com und den Rechner desBenutzers (localhost bzw. 127.0.0.1) als den Rechner, auf dem Altova LicenseServer

© 2017 Altova GmbH



ausgeführt wird. In jedem dieser Fälle wird StyleVision Server auf dem LicenseServer auf demangegebenen Rechner registriert.





BefehlsoptionenOptionen werden zusammen mit ihrer Beschreibung (in der dritten Spalte) (in der ersten Spalte) inihrer kurzen Form und (in der zweiten Spalte) in ihrer langen Form aufgelistet. In der Befehlszeilekönnen ein oder zwei Bindestriche für die kurze und die lange Form verwendet werden.

--j --json Druckt das Ergebnis des Registrierungsversuchs als maschinenlesbaresJSON-Objekt. Form: --json=true|false



1.5.2 assignlicense (nur Windows)



Befehlssyntax

Windows StyleVisionServer assignlicense [options] FILE

Anmerkung: Dieser Befehl wird nur auf Windows-Systemen, nicht aber auf Linux- oder Mac-Systemen unterstützt.

Beschreibung des BefehlsBei Ausführung lädt der Befehl assignlicense die vom Argument FILE definierte Lizenzdatei auf

den registrierten LicenseServer hoch und weist die Lizenz StyleVision Server auf diesem Rechnerzu. Das Argument FILE erhält den Dateipfad der Lizenzdatei.

Mit der Option --test-only können Sie die Lizenz auf LicenseServer hochladen und validieren,ohne sie StyleVision Server zuzuweisen. Nähere Informationen zur Lizenzierung finden Sie in derLicenseServer-Dokumentation.

BeispieleBeispiele für den Befehl assignlicense:

stylevisionserver assignlicense C:\StyleVision Server12345.altova_licenses

stylevisionserver assignlicense --test-only=true C:\StyleVision

Server12345.altova_licenses

Der erste Befehl oben lädt die definierte Lizenz auf LicenseServer hoch und weist sie StyleVisionServer zu.Der zweite Befehl lädt die definierte Lizenz auf LicenseServer hoch und validiert sie, ohne sieStyleVision Server zuzuweisen.



© 2017 Altova GmbH






--t --test-only Die Werte sind true|false. Bei true wird die Lizenzdatei nur aufLicenseServer hochgeladen und validiert. Sie wird StyleVisionServer nicht zugewiesen. Form: --test-only=true|false. Wenndie Option ohne einen Wert angegeben wird, ist sie auf truegesetzt.



1.5.3 verifylicense (nur Windows)



Befehlssyntax

Windows StyleVisionServer verifylicense [options]

Anmerkung: Dieser Befehl wird nur auf Windows-Systemen, nicht aber auf Linux- oder Mac-Systemen unterstützt.

Beschreibung des BefehlsÜberprüft, ob das aktuelle Produkt lizenziert ist. Zusätzlich können Sie mit der Option --license-key überprüfen, ob dem Produkt bereits ein bestimmter Lizenzschlüssel zugewiesenwurde. Nähere Informationen zur Lizenzierung finden Sie in der LicenseServer-Dokumentation.

BeispieleBeispiele für den Befehl verifylicense:

stylevisionserver verifylicense stylevisionserver verifylicense --license-key=ABCDEFG-HIJKLMN-OPQRSTU-VWXYZ12-

3456789

Mit den Befehlen oben wird überprüft, ob das Produkt lizenziert wurde bzw. ob das Produkt mitdem Lizenzschlüssel lizenziert wurde, der als Wert der Option --license-key angegeben wurde.





© 2017 Altova GmbH




--l --license-key Überprüft, ob der angegebene Lizenzschlüssel dem Produkt bereitszugewiesen wurde. Form: --license-key=VALUE



1.5.4 generate



Befehlssyntax

Windows StyleVisionServer generate | gen [options] --inputxml=Filename

InputPXF

Linux stylevisionserver generate | gen [options] --inputxml=Filename

InputPXF

Mac stylevisionserver generate | gen [options] --inputxml=Filename

InputPXF

Anmerkung: Auf Linux-Systemen wird die ausführbare Datei in Kleinbuchstaben aufgerufen:stylevisionserver.

Beschreibung des BefehlsDer Befehl generate (Kurzform ist gen) hat:

eine XML-Input-Datei (--inputxml) als obligatorische Option undeine PXF-Input-Datei (InputPXF) als sein Argument.

Der Befehl generiert durch Transformieren der XML-Input-Datei mit Hilfe des in der PXF-Input-Dateienthaltenen XSLT-Dokuments eine oder mehrere Ausgabedateien (HTML, PDF, RTF und/oderDOCX). Es muss mindestens eine Option zur Ausgabeerstellung angegeben werden.

Anmerkung: StyleVision Server verwendet Apache FOP, den FO-Prozessor des ApacheProject zur Generierung von PDF-Dateien anhand von FO. Apache FOP wird zusammenmit StyleVision Server unter dem folgenden Pfad installiert: Auf Windows-Systemen, ProgramData\Altova\SharedBetweenVersions; auf Linux- und Mac OS X-Systemen ineinem Ordner unterhalb des Ordners StyleVisionServer2017. Beachten Sie, dass fürApache FOP Java Runtime Environment 1.6 oder höher auf dem StyleVision Server-Rechner installiert sein muss. Installieren Sie für die 32-Bit-Version von StyleVisionServer die Java-32-Bit-Version und für die 64-Bit-Version von StyleVision Server die Java-64-Bit-Version.

Beispiele

https://xmlgraphics.apache.org/fop/

© 2017 Altova GmbH



Beispiel für den Befehl generate:

stylevisionserver generate --inputxml=altova:\\packagedfile\ExpReport.xml --

html=Test.html ExpReport.pxf

stylevisionserver generate --inputxml=C:\ExpReport.pxf|zip\ExpReport.xml --

html=Test.html ExpReport.pxf

stylevisionserver generate --inputxml=ExternalXML.xml --html=Test.html

Test.pxf

Der obige Befehl enthält die obligatorische Option --inputxml option, das Argument InputPXF(Test.pxf) sowie mindestens eine Option zur Ausgabeerstellung (--html). Die verwendete XML-Input-Datei kann sich innerhalb der PXF-Datei (siehe erstes und zweites Beispiel oben) befindenoder eine externe XML-Datei sein (die sich außerhalb der PXF-Datei befindet; siehe drittesBeispiel oben). Der --inputxml Switch wird ignoriert, wenn die Hauptschemaquelle eineDatenbank oder DB-XML ist, muss aber aus syntaktischen Gründen vorhanden sein und Siesollten z.B. --inputxml=database verwenden. Wenn die Option --html zur Erstellung desOutput wie im Beispiel einen relativen Pfad erhält, so wird die Output-Datei unter einem Pfadrelativ zum Ordner, in dem sich die PXF-Datei befindet, erstellt.






--xml --inputxml Die zu verarbeitende XML-Input-Datei. Diese Option ist obligatorisch.Die XML-Datei kann sich innerhalb oder außerhalb der PXF-Dateibefinden. Das Protokoll zu XML-Zieldateien innerhalb einer PXF-Dateisehen Sie in den markierten Teilen der obigen Beispiele. Wenn essich bei der Hauptschemaquelle um eine Datenbank oder DB-XMLhandelt, wird die Option ignoriert. Form: --inputxml=Filename

--dbw --dbwhere Eine einfache WHERE-Klausel, die festlegt, welche Zeilen einer DB-XML-Quelldatei verarbeitet werden sollen. Form: --dbwhere=WHEREClause

--p --param Weist einem in der PXF-Datei definierten Parameter einen Wert zu. Form: --param=$ParamName:ParamValue. Die Option --param muss

vor jedem Parameter verwendet werden. Verwenden SieAnführungszeichen, wenn ParamName oder ParamValue ein



Leerzeichen enthält. Beispiel: --p=$company:"Nanonull Inc".

--prohibit-output-outside-target-folder

Erhält den Wert true oder false. Bei Auswahl von true könnenAusgabedokumente nur in dem Ordner erstellt werden, in dem dieHauptausgabedatei (HTML, PDF, RTF, DOCX, FO) erstellt wird.Dadurch werden andere Ordner, falls nötig, geschützt. DieStandardeinstellung ist false.

--html --outhtml Die zu erstellende HTML-Ausgabedatei. Form: --outhtml=Filename

--pdf --outpdf Die zu erstellende PDF-Ausgabedatei. Form: --outpdf=Filename

--rtf --outrtf Die zu erstellende RTF-Ausgabedatei. Form: --outrtf=Filename

--docx --outdocx Die zu erstellende DOCX-Ausgabedatei. Form: --outdocx=Filename

--fo --fo Die zu erstellende FO-Datei. Form: --outfo=Filename

--v --verbose Mittels --verbose=true bzw. --verbose=false kann die Anzeige aller Meldungen aktiviert bzw. deaktiviert werden. Der Standardwert ist false, wenn die Option nicht angegeben wird, true, wenn die Optionohne einen Wert angegeben wird.

--l --lang Die zur Anzeige der Meldung verwendete Sprache. Form: --lang=languagecode. Bei der Installation unterstützte Sprachen: en,

de, fr, es, ja

--h --help Zeigt den Hilfetext zum Befehl generate an.

Anmerkung: Wenn die Optionen zur Erstellung eines Output ( --html , --pdf, --rtf, --docx, --fo) einen relativen Pfad erhalten, ist der Pfad der Outputp-Datei relativ zu demOrdner, in dem sich die PXF-Datei befindet.

© 2017 Altova GmbH



1.5.5 setfopath


BefehlssyntaxBeschreibung des BefehlsBeispiele

Befehlssyntax

Windows StyleVisionServer setfopath | sfp [options] Path

Linux stylevisionserver setfopath | sfp [options] Path

Mac stylevisionserver setfopath | sfp [options] Path

Beschreibung des BefehlsDer Befehl setfopath (Kurzform ist sfp) definiert den Pfad zu einem anderen Apache-FOP-Prozessor als dem im StyleVision Server-Paket inkludierten.

Standardmäßig wird zum Verarbeiten von FO-Dokumenten und Generieren von PDF-Ausgabedokumenten der in StyleVision Server inkludierte FOP-Prozessor verwendet. Wenn eineandere Apache FOP-Prozessorinstanz als die mit StyleVision Server installierte verwendetwerden soll, verwenden Sie den Befehl setfopath.

Nachdem mit dem Befehl setfopath ein FOP-Prozessor definiert wurde, wird bei Verwendungnachfolgender generate Befehle dieser Prozessor für die PDF-Generierung verwendet. Um denProzessor wieder zu wechseln, verwenden Sie wieder den Befehl setfopath. Um zurück zum FOP-Prozessor von StyleVision Server zu wechseln, navigieren Sie zum FOP-Ordner auf IhremSystem und verwenden Sie diesen Pfad als Argument von setfopath.

Auf Windows-Systemen befindet sich der Ordner FOP unter ProgramData\Altova\SharedBetweenVersions; auf Linux- und Mac OS X-Systemen befindet er sich in einemuntergeordnete Ordner des Ordners StyleVisionServer2017.

BeispieleNach Ausführung des Befehls setfopath können Sie mit Hilfe des Befehls generate und unterVerwendung des soeben definierten FO-Prozessors eine PDF-Ausgabedatei generieren.

StyleVisionServer setfopath C:\FOP\FOP.bat

StyleVisionServer generate --inputxml=Test.xml --pdf=Test.pdf Test.pxf



Die oben aufgelisteten Befehle führen folgende Schritte aus:

1. Der Befehl setfopath definiert, dass der FOP-Prozessor unter dem Pfad C:\FOP

\FOP.bat verwendet werden soll, um die PDF-Datei zu generieren, die mit dem

nachfolgenden Befehl generiert wird.2. Der Befehl generate generiert anhand der definierten XML-Input-Datei eine PDF-Datei und

verwendet in der PXF-Datei enthaltene Transformationsdateien. Zum Generieren der PDF-Datei wird der im vorherigen Befehl definierte FOP-Prozessor verwendet.





© 2017 Altova GmbH



1.5.6 pdfdata


BefehlssyntaxBeschreibung des BefehlsBefehlsoptionenBeispiele

Befehlssyntax

Windows StyleVisionServer pdfdata [options] InputPDF

Linux stylevisionserver pdfdata [options] InputPDF

Mac stylevisionserver pdfdata [options] InputPDF

Beschreibung des BefehlsDer Befehl pdfdata generiert anhand der als InputPDF-Argument bereitgestellten PDF-Datei eine

FDF- oder XML-Datei. Mit Hilfe der Option --outfdf können Sie den Pfad der generierten FDF-

Datei bzw. mit der Option --outxml den Pfad der generierten XML-Datei definieren. Wenn die

PDF-Datei keine Formulardaten enthält, so enthält auch die generierte XML-Datei keineFormulardaten.

Nähere Informationen zum Erstellen ausfüllbarer PDF-Formulare finden Sie in der Dokumentationzu Altova StyleVision (Enterprise Edition).


--outfdf Definiert den absoluten Pfad zur generierten FDF-Datei. Form: --outfdf=FILE

--outxml Definiert den absoluten Pfad zur generierten XML-Datei. Form: --outxml=FILE

Anmerkung zu Windows-Systemen:Vermeiden Sie in der Befehlszeile die Verwendung eines umgekehrten Schrägstrichs und einesschließenden Anführungszeichens \" z.B. "C:\My directory\". Diese beiden Zeichen werdenvom Befehlszeilenparser als Literal für ein doppeltes Anführungszeichen interpretiert. Verwenden

http://manual.altova.com/de/Stylevision/stylevisionenterprise/



Sie den doppelten umgekehrten Schrägstrich \\, falls in der Befehlszeile Leerzeichen vorkommenund Sie die Anführungszeichen benötigen ( "C:\My Directory\\") oder vermeiden Sie dieVerwendung von Leerzeichen und Anführungszeichen überhaupt.

BeispieleBeispiele für den Befehl pdfdata:

stylevisionserver pdfdata --outfdf=C:\test\forms\FDFData.fdf C:\test\forms

\TestForm.pdf stylevisionserver pdfdata --outxml=C:\test\forms\XMLData.xml C:\test\forms

\TestForm.pdf





© 2017 Altova GmbH



1.5.7 exportresourcestrings


BefehlssyntaxArgumente Beschreibung des BefehlsBeispieleErstellung lokalisierter Versionen von StyleVision Server

Befehlssyntax

Windows StyleVisionServer exportresourcestrings LanguageCode XMLOutputFile

Linux stylevisionserver exportresourcestrings LanguageCode XMLOutputFile

Mac stylevisionserver exportresourcestrings LanguageCode XMLOutputFile


ArgumenteDer Befehl exportresourcestrings kann die folgenden Argumente haben:

LanguageCode Definiert die Sprache der Ressourcenstrings in der exportierten XML-Datei.Unterstützte Sprachen sind: en, de, es, fr, ja

XMLOutput Definiert den Namen und Pfad der exportierten XML-Datei.

Beschreibung des BefehlsDer Befehl exportresourcestrings gibt eine XML-Datei aus, die die Ressourcenstrings der

StyleVision Server-Applikation enthält. Der Befehl kann zwei Argumente haben: (i) die Spracheder Ressourcenstrings in der XML-Ausgabedatei und (ii) den Namen und Pfad der XML-Ausgabedatei. Derzeit unterstützte Exportsprachen sind (mit den Sprachcodes in Klammern):Englisch (en), Deutsch, (de), Spanisch (es), Französisch (fr) und Japanisch (ja).

Beispiele



Hier ein Beispiel für den Befehl exportresourcestrings:

StyleVisionServer exportresourcestrings de c:\Strings.xml

Mit diesem Befehl wird unter c:\ eine Datei namens Strings.xml erstellt, die alleRessourcenstrings der StyleVision Server Applikation in deutscher Sprache enthält.





Erstellen lokalisierter Versionen von StyleVision ServerSie können für jede Sprache Ihrer Wahl eine lokalisierte Version von StyleVision Server erstellen.Im Ordner C:\Program Files (x86)\Altova\StyleVisionServer2017\bin stehen fünflokalisierte Versionen (Englisch, Deutsch, Französisch, Spanisch und Japanisch) bereits zurVerfügung. Eine Lokalisierung für diese Sprache ist daher nicht mehr notwendig.

1. Generieren Sie mit Hilfe des Befehls exportresourcestrings (siehe Befehlssyntaxoben) eine XML-Datei, die die Ressourcenstrings enthält. Die Ressourcenstrings in dieserXML-Datei sind in einer der fünf unterstützten Sprachen: je nachdem, welches Argumentmit dem Befehl verwendet wird, in Englisch (en), Deutsch (de), Spanisch (es),Französisch (fr) oder Japanisch (ja).

2. Übersetzen Sie die Ressourcenstrings aus einer der fünf unterstützten Sprachen in dieZielsprache. Die Ressourcenstrings bilden den Inhalt der <string> Elemente in der XML-Datei. Übersetzen Sie keine Variablen in geschweiften Klammern wie z.B. {option} oder{product}.

3. Wenden Sie sich an den Altova Support, um anhand Ihrer übersetzten XML-Datei einelokalisierte StyleVision Server DLL-Datei zu generieren.

4. Nachdem Sie Ihre lokalisierte DLL-Datei vom Altova Support erhalten haben, speichernSie diese unter C:\Program Files (x86)\Altova\<%APPFOLDER\bin. Ihre DLL-Dateiwird einen Namen in der Form StyleVisionServer2017_lc.dll haben. Der lc Teil desNamens enthält den Sprachencode. So steht z.B. in StyleVisionServer2017_de.dllder Teil de für Deutsch.

5. Führen Sie den Befehl setdeflang aus, um Ihre lokalisierte DLL als die zu verwendende StyleVision Server Applikation zu definieren. Verwenden Sie den Sprachencode, der Teildes DLL-Namens ist, als Argument des Befehls setdeflang.

Anmerkung: Altova StyleVision Server ist mit Unterstützung für fünf Sprachen erhältlich:Englisch, Deutsch, Spanisch, Französisch (fr) und Japanisch. Sie müssen daher keinelokalisierte Version dieser Sprachen erstellen. Um eine dieser Sprachen alsStandardsprache festzulegen, verwenden Sie den StyleVision Server Befehl setdeflang.

http://www.altova.com/de/support


© 2017 Altova GmbH



1.5.8 setdeflang


BefehlssyntaxBeschreibung des BefehlsBeispieleUnterstützte Sprachen

Befehlssyntax

Windows StyleVisionServer setdeflang | sdl LangaugeCode

Linux stylevisionserver setdeflang | sdl LangaugeCode

Mac stylevisionserver setdeflang | sdl LangaugeCode


Beschreibung des BefehlsDer Befehl setdeflang (Kurzform ist sdl) definiert die Standardsprache von StyleVision Server.Er akzeptiert ein obligatorisches Argument LanguageCode.

BeispieleHier sehen Sie ein Beispiel für den Befehl setdeflang:

StyleVisionServer setdeflang DE

Der obige Befehl definiert Deutsch als Standardsprache für Meldungen.







Unterstützte SprachenIn der nachstehenden Tabelle sind die derzeit unterstützten Sprachen zusammen mit ihrenSprachencodes aufgelistet.

EN Englisch

DE Deutsch

ES Spanisch

FR Französisch

JA Japanisch

© 2017 Altova GmbH



1.5.9 help


BefehlssyntaxBeschreibung des BefehlsBeispieleDie Option --help

Befehlssyntax

Windows StyleVisionServer help Command

Linux stylevisionserver help Command

Mac stylevisionserver help Command


Beschreibung des BefehlsDer Befehl help hat ein einziges Argument (Command): den Namen des Befehls, für den die Hilfe

benötigt wird. Er zeigt die korrekte Syntax des Befehls sowie andere Informationen zur richtigenAusführung des Befehls an.

BeispieleHier sehen Sie ein Beispiel für den Befehl help:

StyleVisionServer help exportresourcestrings

Der obige Befehl enthält ein Argument: den Befehl exportresourcestrings, zu dem die Hilfeaufgerufen werden soll. Bei Ausführung dieses Befehls werden Informationen zum Befehl exportresourcestrings angezeigt.




* Beachten Sie, dass klein geschriebene Befehle (stylevisionserver) auf allen Plattformen(Windows, Linux und Mac) funktionieren, während großgeschriebene Befehle



(StyleVisionServer) nur unter Windows und Mac ausgeführt werden.*Verwenden Sie auf Linux und Mac-Systemen Schrägstriche und auf Windows-Systemenumgekehrte Schrägstriche.

Die Option --help

Die Hilfe zu einem Befehl kann durch über die Option --help im Anschluss an diesen Befehlaufgerufen werden. Wenn Sie z.B. die Option --help mit dem Befehl exportresourcestringsverwenden:

StyleVisionServer exportresourcestrings --help

erhalten Sie dasselbe Ergebnis, wie mit dem Befehl help mit dem Argumentexportresourcestrings:

StyleVisionServer help exportresourcestrings

In beiden Fällen wird die Hilfe zum Befehl exportresourcestrings angezeigt.

© 2017 Altova GmbH

StyleVision Server API 53Altova StyleVision Server 2017


1.6 StyleVision Server API

StyleVision Server enthält eine API (Application Programming Interface), die Sie von Ihrem .NET-,COM- oder Java-basierten Code aus programmatisch aufrufen können.

Dieser Abschnitt ist in die folgenden Unterabschnitte gegliedert:

Informationen zur .NET-SchnittstelleInformationen zur COM-SchnittstelleInformationen zur Java-SchnittstelleCodebeispieleAPI-Referenz

54 Altova StyleVision Server 2017 StyleVision Server API


1.6.1 Informationen zur .NET-Schnittstelle

Die .NET-Schnittstelle bildet einen Wrapper rund um die COM-Schnittstelle. Sie dient als primäre,von Altova signierte Interop Assembly und verwendet den Namespace Altova.StyleVisionServer.

StyleVision Server wird bei der Installation automatisch als COM-Serverobjekt registriert undmuss daher nicht manuell registriert werden. Wenn Sie einen Zugriffsfehler erhalten, öffnen Sie dieKomponentendienste und räumen Sie dem Konto, auf dem der Applikationspool, der StyleVisionServer enthält, ausgeführt wird, Zugriffsrechte ein.

Um StyleVision Server in Ihrem .NET-Projekt verwenden zu können, fügen Sie eine Referenz zurAltova.StyleVisionServer.dll Datei hinzu (siehe Anleitung unten). Die DateiAltova.StyleVisionServer.dll befindet sich im Ordner bin des StyleVision ServerInstallationsordners. Diese .dll-Datei wird bei der Installation von StyleVision Server automatischzum GAC (Global Assembly Cache (GAC) hinzugefügt (der GAC befindet sich normalerweise imOrdner C:\WINDOWS\assembly).

Sobald StyleVision Server als COM-Serverobjekt registriert wurde und die Datei Altova.StyleVisionServer.dll der .NET-Schnittstelle zur Verfügung steht, stehen dieStyleVision Server AP-Funktionen in Ihrem .NET-Projekt zur Verfügung.

So fügen Sie in einem Visual Studio .NET-Projekt eine Referenz zur StyleVisionServer-DLL hinzu

1. Klicken Sie, während das .NET-Projekt in Visual Studio geöffnet ist, auf Project | AddReference. Daraufhin wird das Dialogfeld "Add Reference" geöffnet.

2. Suchen Sie auf dem Register "Browse" nach dem Ordner <StyleVisionServer

application folder>/bin, wählen Sie Altova.StyleVisionServer.dll aus und

klicken Sie auf OK.

Sie können die Struktur der Altova.StyleVisionServer Assembly mit dem Visual StudioObject Browser anzeigen (um den Object Browser aufzurufen, klicken Sie im Menü View aufObject Browser).

© 2017 Altova GmbH



1.6.2 Informationen zur COM-Schnittstelle

StyleVision Server wird bei der Installation automatisch als COM-Serverobjekt registriert. Um zuüberprüfen, ob die Registrierung erfolgreich war, öffnen Sie den Registry Editor (z.B. durchEingabe des Befehls regedit.exe in der Befehlszeile). Wenn die Registrierung erfolgreich war,enthält die Registry die Klassen StyleVision.Server. Diese beiden Klassen befinden sichnormalerweise unter HKEY_LOCAL_MACHINE\SOFTWARE\Classes.

Sobald das COM-Serverobjekt registriert ist, können Sie es über Applikationen undProgrammiersprachen mit Programmierunterstützung für COM-Aufrufe aufrufen. Wenn Sie denPfad des StyleVision Server Installationspakets ändern möchten, sollten Sie StyleVision Serveram besten deinstallieren und anschließend im gewünschten Ordner installieren. Auf diese Art wirddie nötige Deregistrierung und Registrierung bei der Installation durchgeführt.



1.6.3 Informationen zur Java-Schnittstelle

Um die StyleVision Server API über Java-Code aufrufen zu können, fügen Sie die folgendenReferenzen zur .classpath-Datei Ihres Java-Projekts hinzu.

StyleVisionServer.jar Die Bibliothek, die mit StyleVision Server kommuniziertStyleVisionServer_JavaDoc.zip Die Dokumentation zur StyleVision Server API

Beide Dateien befinden sich im Ordner bin des StyleVision Server Installationsordners. Siekönnen die Dateien entweder über ihren Originalordner referenzieren oder sie in einen anderenOrdner kopieren, falls Ihr Projekt dies erfordert.

Hinzufügen der Bibliotheksreferenzen in EclipseSie können die classpath-Referenzen in Eclipse durch Bearbeiten der Eigenschaften des Java-Projekts hinzufügen. Die Beispielanleitung unten gilt für Eclipse 4.4.

1. Klicken Sie, während das Projekt in Eclipse geöffnet ist, auf das Menü Project undanschließend auf Properties.

2. Klicken Sie auf dem Register "Libraries" auf Add External JARs und navigieren Sie zurDatei StyleVisionServer.jar im StyleVision Server Installationsordner.

3. Erweitern Sie unter JARs and class folders on the build path den EintragStyleVisionServer.jar und doppelklicken Sie anschließend auf den Eintrag Javadoclocation: (None).

4. Stellen Sie sicher, dass die Optionen Javadoc in archive und External file aktiviert sindund navigieren Sie anschließend zur Datei StyleVisionServer_JavaDoc.zip imStyleVision Server Installationsordner.

5. Klicken Sie auf OK. Die Referenz zur StyleVision Server Bibliothek und zum Javadoc-Archiv wird zur .classpath-Datei des Projekts hinzugefügt.

© 2017 Altova GmbH



1.6.4 Codebeispiele

Dieser Abschnitt enthält Beispiele für die folgenden Programmiersprachen:

C++ C# VBScript Visual BasicJava

C++

Im Beispiel unten wird gezeigt, wie Sie über C++-Code anhand einer PXF-Datei und einer XML-Input-Datei eine RTF-Output-Datei generieren. Stellen Sie sicher, dass StyleVision Serverinstalliert und lizenziert ist und als COM-Servereobjekt zur Verfügung steht. Die Registrierung alsCOM-Serverobjekt erfolgt normalerweise während der Installation von StyleVision Server. EineAnleitung, wie Sie überprüfen, ob die Registrierung erfolgreich war, finden Sie unter Informationenzur COM-Schnittstelle.

// StyleVisionServerAPI_Sample.cpp : Defines the entry point for the console

application.

//

#include <iostream>

#include "atlbase.h"

// 32-bit StyleVision Server

#import "progid:StyleVision.Server"

// 64-bit StyleVision Server

//#import "progid:StyleVision_x64.Server"

int _tmain(int argc, _TCHAR* argv[])

{

CoInitialize( NULL );

try

{

StyleVisionServerLib::IServerPtr pSVS;

CoCreateInstance( __uuidof( StyleVisionServerLib::Server ), NULL,

CLSCTX_ALL, __uuidof( StyleVisionServerLib::IServer ), reinterpret_cast< void**

>( &pSVS ) );

//Set a working directory - used for output and for intermediate

files

pSVS->WorkingDirectory = "c:\\temp";

//Default path to the StyleVision Server executable is the

installation path (same dir with the StyleVisionServer.dll)

//In case you moved the binaries on the disk, you need to

explicitly set the path to the .exe file



//pSVS->ServerPath = "C:\\Program Files (x86)\\Altova\

\StyleVisionServer2017\\bin\\StyleVisionServer.exe";

//Prepare the name of the working XML

pSVS->InputXML = "ExpReport.xml";

//Add output paths (absolute or relative to WorkingDirectory) for

all formats that should be generated

pSVS->OutputRTF = "ExpReport.rtf";

//Prepare the parameters, if your design uses parameters

//pSVS->AddParameter( "testparam1", "value 1" );

//Run the transformation; the output will be stored at C:\temp

\ExpReport.rtf

// NOTE Please adapt the path to the input file in order to run the

sample

if (pSVS->Run("C:\\Program Files (x86)\\Altova\

\StyleVisionServer2017\\etc\\Examples\\ExpReport.pxf"))

std::cout << "Success - finished execution" << std::endl;

else

std::cout << pSVS->LastExecutionMessage << std::endl;

}

catch (_com_error& err )

{

BSTR bstrMessage;

(err).ErrorInfo()->GetDescription( &bstrMessage );

std::cout << "Exception occurred: " <<

_com_util::ConvertBSTRToString( bstrMessage ) << std::endl;

}

CoUninitialize();

return 0;

}

C#

Im Beispiel unten wird gezeigt, wie Sie über C#-Code anhand einer PXF-Datei und einer XML-Input-Datei eine RTF-Output-Datei generieren. Stellen Sie sicher, dass StyleVision Serverinstalliert und lizenziert ist und als COM-Servereobjekt zur Verfügung steht. Die Registrierung alsCOM-Serverobjekt erfolgt normalerweise während der Installation von StyleVision Server. EineAnleitung, wie Sie überprüfen, ob die Registrierung erfolgreich war, finden Sie unter Informationenzur COM-Schnittstelle.

??namespace StyleVisionServerAPI_sample

© 2017 Altova GmbH



{

class Program

{

static void Main(string[] args)

{

//Create a StyleVision Server object

Altova.StyleVisionServer.Server objSVS = new

Altova.StyleVisionServer.Server();

//Set a working directory - used for output and for intermediate

files

objSVS.WorkingDirectory = "c:\\temp";

//Default path to the StyleVision Server executable is the

installation path (same dir with the StyleVisionServer.dll)

//In case you moved the binaries on the disk, you need to

explicitly set the path to the .exe file

//objSVS.ServerPath = "C:\\Program Files (x86)\\Altova\

\StyleVisionServer2017\\bin\\StyleVisionServer.exe";

//Prepare the name of the working XML

objSVS.InputXML = "ExpReport.xml";

//Add output paths (absolute or relative to WorkingDirectory) for

all formats that should be generated

objSVS.OutputRTF = "ExpReport.rtf";

//Prepare the parameters, if your design uses parameters

//objSVS.AddParameter( "testparam1", "value 1" );

//Run the transformation; the output will be stored at C:\temp

\ExpReport.rtf

// NOTE Please adapt the path to the input file in order to run the

sample

if (objSVS.Run("C:\\Program Files (x86)\\Altova\

\StyleVisionServer2017\\etc\\Examples\\ExpReport.pxf"))

System.Console.WriteLine("Success - finished execution");

else

System.Console.WriteLine(objSVS.LastExecutionMessage);

}

}

}

VBScript

Im Beispiel unten wird gezeigt, wie Sie über VB Script-Code anhand einer PXF-Datei und einerXML-Input-Datei eine RTF-Output-Datei generieren. Stellen Sie sicher, dass StyleVision Serverinstalliert und lizenziert ist und als COM-Servereobjekt zur Verfügung steht. Die Registrierung alsCOM-Serverobjekt erfolgt normalerweise während der Installation von StyleVision Server. EineAnleitung, wie Sie überprüfen, ob die Registrierung erfolgreich war, finden Sie unter Informationenzur COM-Schnittstelle.



Option Explicit On

'Create a StyleVision Server object; use "StyleVision_x64.Server" if you want to

use the 64-bit installation

Dim objSVS

Set objSVS = WScript.GetObject( "", "StyleVision.Server" )

'Set a working directory - used for output and for intermediate files

objSVS.WorkingDirectory = "C:\temp"

'Default path to the StyleVision Server executable is the installation path

(same dir with the StyleVisionServer.dll)

'In case you moved the binaries on the disk, you need to explicitly set the path

to the .exe file

'objSVS.ServerPath = "C:\Program Files (x86)\Altova\StyleVisionServer2017\bin

\StyleVisionServer.exe"

'Prepare the name of the working XML

objSVS.InputXML = "ExpReport.xml"

'Add output paths (absolute or relative to WorkingDirectory) for all formats

that should be generated

objSVS.OutputRTF = "ExpReport.rtf"

'Prepare the parameters, if your design uses parameters

'Call objSVS.AddParameter( "testparam1", "value 1" )

' Run the transformation; the output will be stored at C:\temp\ExpReport.rtf

' NOTE Please adapt the path to the input file in order to run the sample

If ( objSVS.Run( "C:\Program Files (x86)\Altova\StyleVisionServer2017\etc

\Examples\ExpReport.pxf" ) ) Then

WScript.Echo( "Success - finished execution" )

Else

WScript.Echo( objSVS.LastExecutionMessage )

End If

Visual Basic

Im Beispiel unten wird gezeigt, wie Sie über C++-Code anhand einer PXF-Datei und einer XML-Input-Datei eine RTF-Output-Datei generieren. Stellen Sie sicher, dass StyleVision Serverinstalliert und lizenziert ist und als COM-Servereobjekt zur Verfügung steht. Die Registrierung alsCOM-Serverobjekt erfolgt normalerweise während der Installation von StyleVision Server. EineAnleitung, wie Sie überprüfen, ob die Registrierung erfolgreich war, finden Sie unter Informationenzur COM-Schnittstelle.

© 2017 Altova GmbH



Option Explicit On

Module Program

Sub Main()

'Create a StyleVision Server object

Dim objSVS As Altova.StyleVisionServer.Server = New

Altova.StyleVisionServer.Server

'Set a working directory - used for output and for intermediate files

objSVS.WorkingDirectory = "C:\temp"

'Default path to the StyleVision Server executable is the installation

path (same dir with the StyleVisionServer.dll)

'In case you moved the binaries on the disk, you need to explicitly set

the path to the .exe file

'objSVS.ServerPath = "C:\Program Files (x86)\Altova\StyleVisionServer2017

\bin\StyleVisionServer.exe"

'Prepare the name of the working XML

objSVS.InputXML = "ExpReport.xml"

'Add output paths (absolute or relative to WorkingDirectory) for all

formats that should be generated

objSVS.OutputRTF = "ExpReport.rtf"

'Prepare the parameters, if your design uses parameters

'Call objSVS.AddParameter( "testparam1", "value 1" )

' Run the transformation; the output will be stored at C:\temp

\ExpReport.rtf

' NOTE Please adapt the path to the input file in order to run the sample

If (objSVS.Run("C:\Program Files (x86)\Altova\StyleVisionServer2017\etc

\Examples\ExpReport.pxf")) Then

System.Console.WriteLine("Success - finished execution")

Else

System.Console.WriteLine(objSVS.LastExecutionMessage)

End If

End Sub

End Module

Java

Im Beispiel unten wird gezeigt, wie Sie über Java-Code anhand einer PXF-Datei und einer XML-Input-Datei eine RTF-Output-Datei generieren. Stellen Sie sicher, dass StyleVision Serverinstalliert und lizenziert ist und als Servereobjekt zur Verfügung steht. Die Registrierung alsServerobjekt erfolgt normalerweise während der Installation von StyleVision Server. EineAnleitung, wie Sie überprüfen, ob die Registrierung erfolgreich war, finden Sie unter Informationenzur Java-Schnittstelle.



public class Program

{

public static void main(String[] args)

{ try

{ //Create a StyleVision Server object com.altova.stylevisionserver.StyleVisionServer objSVS = new

com.altova.stylevisionserver.StyleVisionServer(); //Set a working directory - used for output and for intermediate files objSVS.setWorkingDirectory( "C:\\temp" ); //Default path to the StyleVision Server executable is theinstallation path (same dir with the StyleVisionServer.jar) //In case you copied the JAR file to a new location, you need toexplicitly set the path to the .exe file //objSVS.setServerPath( "C:\\Program Files (x86)\\Altova\\StyleVisionServer2017\\bin\\StyleVisionServer.exe" ); //Prepare the name of the working XML objSVS.setInputXML( "ExpReport.xml" ); //Add output paths (absolute or relative to WorkingDirectory) for allformats that should be generated objSVS.setOutputRTF( "ExpReport.rtf" ); //Prepare the parameters, if your design uses parameters //objSVS.AddParameter( "testparam1", "value 1" ); //Run the transformation; the output will be stored at C:\temp\ExpReport.rtf // NOTE Please adapt the path to the input file in order to run thesample if ( objSVS.generate( "C:\\Program Files (x86)\\Altova\

\StyleVisionServer2017\\etc\\Examples\\ExpReport.pxf" ) ) System.out.println( "Success - finished execution" );

else

System.out.println( objSVS.getLastExecutionMessage() );

} catch ( Exception e)

{ e.printStackTrace(); } }

}

© 2017 Altova GmbH



1.6.5 API-Referenz

Dieser Abschnitt ist eine Benutzerreferenz für die StyleVision Server API.

COM und .NETJava

COM und .NET

Die StyleVisionServer API stellt die Schnittstelle IServer, zur Verfügung, über die Sie eine neue

StyleVision Server-Objektinstanz erstellen und Zugriff auf StyleVision Server erhalten.

Die Schnittstelle IServer hat die folgenden Methoden und Parameter.

Methoden

AddParameter

Weist einem in der PXF-Datei definierten Parameter einen Wert zu.

C#

void AddParameter(string bstrName, string bstrValue)

C++

HRESULT AddParameter([in] BSTR bstrName, [in] BSTR bstrValue );

VB

Sub AddParameter(ByVal bstrName As String, ByVal bstrValue As String)

ClearParameterList

Löscht die Liste der Parameter.

C#

void ClearParameterList()

C++

HRESULT ClearParameterList();

VB

Sub ClearParameterList()

Generate

Generiert anhand der mit TransfPath definierten PXF-Datei eine oder mehrereAusgabedateien (HTML, PDF, RTF, und/oder DOCX). Der Befehl transformiert die XML-Input-Datei (in der PXF-Datei der XML-Arbeitsdatei) anhand des in der PXF-Datei enthaltenenXSLT-Dokuments. Gibt bei Erfolg TRUE, andernfalls FALSE zurück.



C#

bool Generate(string bstrTransfPath)

C++

HRESULT Generate( [in] BSTR bstrTransfPath, [out, retval] VARIANT_BOOL*pbSuccess );

VB

Function Generate(ByVal bstrTransfPath As String) As Boolean

Eigenschaften

APIMajorVersion

Ruft die Hauptversion der StyleVision Server API ab. Diese unterscheidet sich eventuell vonder Produktversion, wenn die API mit einem anderen Server verbunden ist.

C#

int APIMajorVersion { get; }

C++

HRESULT APIMajorVersion([out, retval] INT* pnVal);

VB

ReadOnly Property APIMajorVersion As Integer

APIMinorVersion

Ruft die Nebenversion der StyleVision Server API ab. Diese unterscheidet sich eventuell vonder Produktversion, wenn die API mit einem anderen Server verbunden ist.

C#

int APIMinorVersion { get; }

C++

HRESULT APIMinorVersion([out, retval] INT* pnVal);

VB

ReadOnly Property APIMinorVersion As Integer

APIServicePackVersion

Ruft die Service Pack-Version der StyleVision Server API ab. Diese unterscheidet sicheventuell von der Produktversion, wenn die API mit einem anderen Server verbunden ist.

© 2017 Altova GmbH



C#

int APIServicePackVersion { get; }

C++

HRESULT APIServicePackVersion([out, retval] INT* pnVal);

VB

ReadOnly Property APIServicePackVersion As Integer

InputXML

Definiert den Namen und Pfad der zu verarbeitenden XML-Datei (der XML-Arbeitsdatei in derPXF-Datei).

C#

string InputXML { set; }

C++

HRESULT InputXML([in] BSTR bstrPath );

VB

Property InputXML As String

Is64Bit

Gibt TRUE zurück, wenn der StyleVision Server-Prozessor eine ausführbare 64-Bit-Datei ist.

C#

bool Is64Bit { get; }

C++

HRESULT Is64Bit([out, retval] VARIANT_BOOL* pbVal);

VB

ReadOnly Property Is64Bit As Boolean

LastExecutionMessage

Ruft die beim letzten Generate-Befehl erhaltene Meldung auf.

C#

string LastExecutionMessage { get; }

C++

HRESULT LastExecutionMessage([out, retval] BSTR* pbstrResult );

VB

ReadOnly Property LastExecutionMessage As String



MajorVersion

Ruft die Hauptversion von StyleVision Server ab.

C#

int MajorVersion { get; }

C++

HRESULT MajorVersion([out, retval] INT* pnVal);

VB

ReadOnly Property MajorVersion As Integer

MinorVersion

Ruft die Nebenversion von StyleVision Server ab.

C#

int MinorVersion { get; }

C++

HRESULT MinorVersion([out, retval] INT* pnVal);

VB

ReadOnly Property MinorVersion As Integer

OutputDOCX

Definiert den Namen und Pfad der DOCX-Ausgabedatei.

C#

string OutputDOCX { set; }

C++

HRESULT OutputDOCX([in] BSTR bstrPath );

VB

Property OutputDOCX As String

OutputFO

Definiert den Namen und Pfad der FO-Ausgabedatei.

C#

string OutputFO { set; }

C++

HRESULT OutputFO([in] BSTR bstrPath );

© 2017 Altova GmbH



VB

Property OutputFO As String

OutputHTML

Definiert den Namen und Pfad der HTML-Ausgabedatei.

C#

string OutputHTML { set; }

C++

HRESULT OutputHTML([in] BSTR bstrPath );

VB

Property OutputHTML As String

OutputPDF

Definiert den Namen und Pfad der PDF-Ausgabedatei.

C#

string OutputPDF { set; }

C++

HRESULT OutputPDF([in] BSTR bstrPath );

VB

Property OutputPDF As String

OutputRTF

Definiert den Namen und Pfad der RTF-Ausgabedatei.

C#

string OutputRTF { set; }

C++

HRESULT OutputRTF([in] BSTR bstrPath );

VB

Property OutputRTF As String

ProductName

Ruft den Namen des Produkts ab: "StyleVision Server"

C#



string ProductName { get; }

C++

HHRESULT ProductName([out, retval] BSTR* pstrVal);

VB

ReadOnly Property ProductName As String

ProductNameAndVersion

Ruft den vollständigen Namen des Produkts einschließlich Versionsnummer ab: "StyleVision Server 2014r2 sp1 (x64)".

C#

string ProductNameAndVersion { get; }

C++

HHRESULT ProductNameAndVersion([out, retval] BSTR* pstrVal);

VB

ReadOnly Property ProductNameAndVersion As String

ServerPath

Ruft den Pfad zur ausführbaren StyleVision Server Datei ab oder definiert ihn.

C#

string ServerPath { set; get; }

C++

HRESULT ServerPath([in] BSTR bstrServerFile );HRESULT ServerPath([out, retval] BSTR* pbstrServerFile );

VB

Property ServerPath As String

ServicePackVersion

Ruft die Service Pack-Version von StyleVision Server ab (z.B.: 1 für Altova StyleVision

Server 2014 r2 sp1 (x64).)

C#

int ServicePackVersion { get; }

C++

HRESULT ServicePackVersion([out, retval] INT* pnVal);

VB

ReadOnly Property ServicePackVersion As Integer

© 2017 Altova GmbH



WhereClause

Definiert eine SQL WHERE-Klausel, die festlegt, welche Zeilen einer DB-XML-Schemaquelleverarbeitet werden sollen.

C#

string WhereClause { set; }

C++

HRESULT WhereClause([in] BSTR bstrPath );

VB

Property WhereClause As String

WorkingDirectory

Ruft das aktuelle Verzeichnis für laufende Aufträge ab oder definiert dieses. Relative Pfadewerden anhand der Arbeitsverzeichnisses ausgewertet.

C#

string WorkingDirectory { set; get; }

C++

HRESULT WorkingDirectory([in] BSTR bstrWorkingDirectory );HRESULT WorkingDirectory([out, retval] BSTR* pbstrWorkingDirectory );

VB

Property WorkingDirectory As String

Java

Das Paket com.altova.stylevisionserver besteht aus den folgenden Klassen:

public class StyleVisionServer (siehe Beschreibung unten)

public class StyleVisionServerException extends Exception

Die Klasse StyleVisionServer

Die Klasse StyleVisionServer erstellt eine neue StyleVision Server Objektinstanz und bietetZugriff auf StyleVision Server. Im Folgenden finden Sie eine Beschreibung der Methoden derSchnittstelle StyleVisionServer.



Methoden der Klasse StyleVisionServer

Im Folgenden finden Sie eine alphabetisch geordnete Liste der Methoden der Klasse StyleVisionServer.

addParameter

public void addParameter(String name, String value)

Fügt den Namen und Wert eines neuen Parameters hinzu. Jeder Parameter und sein Wertwerden in einem separaten Methodenaufruf definiert. Parameter müssen im XSLT-Dokumentdeklariert sein.Parameter: name: Enthält den Namen des Parameters als String.value: Enthält den Wert des Parameters als String.

clearParameterList

public void clearParameterList()

Löscht die Liste der Parameter.

generate

public boolean generate(String transfPath)

Verarbeitet die in transfPath definierte PXF-Datei. Löst StyleVisionServerExceptionaus.Parameter: transfPath: eine absolute URL, die den Pfad der PXF-Datei angibt.Rückgabe: true() bei erfolgreicher Ausführungfalse() wenn die Ausführung fehlschlägtVerwenden Sie bei einem Fehler getLastExecutionMessage()

getAPIMajorVersion

public int getAPIMajorVersion()

Ruft die Hauptversion der StyleVision Server API ab. Sie unterscheidet sich eventuell von derProduktversion, wenn die API mit einem anderen Server verbunden ist.

getAPIMinorVersion

public int getAPIMinorVersion()

Ruft die Nebenversion der StyleVision Server API ab. Sie unterscheidet sich eventuell vonder Produktversion, wenn die API mit einem anderen Server verbunden ist.

getAPIServicePackVersion

public int getAPIServicePackVersion()

Ruft die Service Pack-Version der StyleVision Server API ab. Sie unterscheidet sicheventuell von der Produktversion, wenn die API mit einem anderen Server verbunden ist.

getLastExecutionMessage

public String getLastExecutionMessage()

Ruft die beim letzten generate-Befehl erhaltene Meldung auf.

© 2017 Altova GmbH



getMajorVersion

public int getMajorVersion()

Ruft die Hauptversion der Applikation ab.

getMinorVersion

public int getMinorVersion()

Ruft die Nebenversion der Applikation ab.

getProductName

public String getProductName()

Ruft den Produktnamen ab.

getProductNameAndVersion

public String getProductNameAndVersion()

Ruft den vollständigen Namen und die Versionsnummer des Produkts ab.

getServicePackVersion

public int getServicePackVersion()

Ruft die Service Pack-Version von StyleVision Server ab.

is64bit

public boolean is64bit()

Überprüft, ob die ausführbare Datei eine 64-Bit-Datei ist.Rückgabe: true() für StyleVision Server (x64), andernfalls false().

setInputXML

public void setInputXML(String path)

Definiert die zu verarbeitende XML-Datei. Dabei muss es sich um den Pfad der in der PXF-Datei definierten XML-Arbeitsdatei handeln.Parameter: path: Enthält den Pfad der XML-Arbeitsdatei in der PXF-Datei.

setOutputDOCX

public void setOutputDOCX(String path)

Definiert den Namen und Pfad der zu generierenden DOCX-Datei.Parameter: path: Der Name und Pfad der zu generierenden DOCX-Datei.

setOutputFO

public void setOutputFO(String path)

Definiert den Namen und Pfad der zu generierenden FO-Datei.Parameter: path: Der Name und Pfad der zu generierenden FO-Datei



setOutputHTML

public void setOutputHTML(String path)

Definiert den Namen und Pfad der zu generierenden HTML-Datei.Parameter: path: Der Name und Pfad der zu generierenden HTML-Datei.

setOutputPDF

public void setOutputPDF(String path)

Definiert den Namen und Pfad der zu generierenden PDF-Datei.Parameter: path: Der Name und Pfad der zu generierenden PDF-Datei.

setOutputRTF

public void setOutputRTF(String path)

Definiert den Namen und Pfad der zu generierenden RTF-Datei.Parameter: path: Der Name und Pfad der zu generierenden RTF-Datei.

setServerPath

public void ssetServerPath(String serverFile)

Definiert den Pfad der ausführbaren StyleVisionServer Datei.Parameter: serverFile: Der Pfad der ausführbaren StyleVisionServer Datei.

setWhereClause

public void setWhereClause(String whereClause)

Definiert eine SQL WHERE-Klausel, mit der festgelegt wird, welche Zeilen einer DB-XML-Schemaquelle verarbeitet werden sollen.Parameter: whereClause: Die SQL Where-Klausel, die angibt, welche Zeilen einer DB-XML-Schemaquelle verarbeitet werden sollen.

setWorkingDirectory

public void setWorkingDirectory(String workingDirectory)

Definiert ein Standardverzeichnis. Relative Pfade werden relativ zum Verzeichnis aufgelöst.Parameter: workingDirectory: Der Pfad des Standard (Arbeits)-Verzeichnisses

© 2017 Altova GmbH

Altova LicenseServer 73Altova StyleVision Server 2017


1.7 Altova LicenseServer

Altova LicenseServer (in der Folge auch LicenseServer genannt) dient als Tool für die zentraleVerwaltung von Lizenzen für Altova-Produkte. Sie können in einem Netzwerk ausgeführten Altova-Applikationen über LicenseServer eine Lizenz zuweisen. Administratoren können dadurchLizenzen flexibel verwalten und überwachen.


Lizenzierungsverfahren auf Altova LicenseServerUm einem Altova-Produkt über Altova LicenseServer eine Lizenz zuzuweisen, gehen Siefolgendermaßen vor:

1. Starten Sie LicenseServer.2. Öffnen Sie die LicenseServer-Konfigurationsseite, d.h. die Administratorschnittstelle zu

LicenseServer unter Windows, Linux oder Mac OS X.3. Laden Sie die von Altova erhaltenen Produklizenz(en) über das Register "License Pool"

Ihrer Altova LicenseServer-Konfigurationsseite in den Lizenzpool. 4. Registrieren Sie das/die Altova-Produkt(e) auf dem LicenseServer. 5. Weisen Sie dem/den Altova Produkt(en) auf dem Register "Client Management" der

Konfigurationsseite Lizenzen zu.

Die Lizenzen können anschließend über LicenseServer zentral überwacht und verwaltet werden.Eine Beschreibung der verfügbaren Funktionen finden Sie unter Referenz zur Konfigurationsseite.

Anmerkung: Die LicenseServer-Konfigurationsseite unterstützt SSL nicht.

LicenseServer-Versionen und deren Kompatibilität mit Altova-Produkten

Neue Versionen von Altova-Produkten können nur mit der Version von LicenseServerlizenziert werden, die zum Zeitpunkt der Produkt-Release die neueste ist, jedochfunktionieren ältere Versionen von Altova-Produkten mit neueren Versionen desLicenseServer.

Wenn Sie daher eine neue Version eines Altova-Produkts installieren und Ihre aktuelleLicenseServer-Version nicht die neueste ist, deinstallieren Sie die ältere Version vonLicenseServer und installieren Sie die neueste auf der Altova-Website verfügbare Version.Alle Registrierungs- und Lizenzierungsdaten aus Ihrer alten Version von LicenseServerwerden bei der Deinstallation in einer Datenbank auf Ihrem Rechner gespeichert undautomatisch in die neuere Version von LicenseServer importiert. Wenn Sie eine neuereVersion von LicenseServer installieren, wird die ältere Version vorher deinstalliert.

Die Versionsnummer des aktuell installierten LicenseServer ist am unteren Rand der LicenseServer-Konfigurationseite (alle Register) vermerkt.


74 Altova StyleVision Server 2017 Altova LicenseServer


Informationen zu dieser DokumentationDiese Dokumentation ist in die folgenden Teile gegliedert:

Einführung zu Netzwerkanforderungen; Installation unter Windows, Linux und Mac OS Xund Altova ServiceController.Zuweisen von Lizenzen: Hier wird Schritt für Schritt beschrieben, wie Sie über den AltovaLicenseServer Lizenzen zuweisen.Referenz zur Konfigurationsseite: Hier finden Sie eine Beschreibung derAdministratorschnittstelle zu LicenseServer.

Letzte Aktualisierung: 02.05.2017

© 2017 Altova GmbH



1.7.1 Informationen zum Netzwerk

Altova LicenseServer muss auf einem Server-Rechner installiert sein, auf den alle Clients, aufdenen lizenzpflichtige Altova-Produkte ausgeführt werden, Zugriff haben. Eine Firewall, sei es aufdem Client als auch auf dem Server, muss den für den ordnungsgemäßen Betrieb desLicenseServers erforderlichen Netzwerkdatenverkehr vom und zum LicenseServer zulassen.

Zur Verteilung der Lizenzen wird auf dem LicenseServer-Rechner Port 35355 verwendet. Dahermuss dieser Port für den Netzwerkdatenverkehr mit Client-Rechnern offen sein.

Im Folgenden sind die Standardparameter für den Netzwerkverkehr und die Anforderungen fürLicenseServer aufgelistet:

Für die LicenseServer-Lizenzverteilung:Eine oder beide der folgenden VerbindungenIPv4 TCP-Verbindung auf Port 35355 IPv6 TCP-Verbindung auf Port 35355

Der LicenseServer kann zu Verwaltungszwecken über eine Webschnittstelle auf Port 8088aufgerufen werden. Der verwendete Port kann je nach Wunsch konfiguriert werden.

Verbindung zum Master Licensing Server unter altova.comAltova LicenseServer muss in Verbindung mit dem Master Licensing Server unter altova.com stehen, um Lizenzdaten überprüfen und authentifizieren und die Einhaltung derAltova-Lizenzverträge fortlaufend überwachen zu können. Diese Verbindung erfolgt überHTTPS über den Port 443. Wenn Altova LicenseServer nach dem ersten Herstellen einerVerbindung zum altova.com Master Licensing Server länger als 5 Tage (=120 Stunden)keine Verbindung mehr zum Master LicenseServer herstellen kann, lässt AltovaLicenseServer die Verwendung von Altova Software-Produkten, die mit Altova LicenseServerin Verbindung stehen, nicht mehr zu.

Wenn die Verbindung zum altova.com Master-Server verloren geht, wird dies auf demRegister "Messages" der Konfigurationsseite von LicenseServer protokolliert. Außerdem kannder Administrator den Altova LicenseServer so konfigurieren, dass automatisch eineentsprechende Benachrichtigung gesendet wird, wenn die Verbindung zu altova.comunterbrochen wird. Die Benachrichtigungseinstellungen werden auf der Seite "Configuration"auf dem Register "Settings" vorgenommen.



1.7.2 Installation (Windows)

Altova LicenseServer kann auf Windows-Systemen auf zwei verschiedene Arten installiert werden:

mit einem eigenen Installer für Altova LicenseServerals Teil des Altova Server-Installationspakets. (Die Altova Server-Produkte sind: AltovaFlowForce Server, Altova MapForce Server, Altova StyleVision Server, AltovaRaptorXML(+XBRL) und Altova MobileTogether Server.) Falls LicenseServer zu demZeitpunkt, zu dem Sie ein Altova Server-Produkt installieren, auf Ihrem System nichtinstalliert ist, ist die Option zum Installieren von LicenseServer standardmäßig im Installerautomatisch ausgewählt. Wenn auf Ihrem Netzwerk bereits ein Altova LicenseServerinstalliert ist, ist die Option zum Installieren von LicenseServer standardmäßig deaktiviert.Sie können diese Option bei der Installation ändern.

Nähere Informationen zum Zuweisen von Lizenzen finden Sie im Abschnitt Zuweisen vonLizenzen.

SystemanforderungenWindows


Windows Server







Welche LicenseServer-Version für eine bestimmte Version eines Server-Produkts benötigt wird,wird während der Installation dieser Version des Server-Produkts angezeigt. Sie können diese

© 2017 Altova GmbH



Version von LicenseServer zusammen mit dem Server-Produkt installieren oder die neuereVersion von LicenseServer separat installieren. In beiden Fällen wird zuerst die ältere Versiondeinstalliert, bevor die neue Version installiert wird.



1.7.3 Installation (Linux)

Altova LicenseServer kann auf Linux-Systemen (Debian, Ubuntu, CentOS, RedHat) installiertwerden.

SystemanforderungenLinux


Um die Applikation installieren und ausführen zu können, werden die folgenden Bibliothekenbenötigt. Falls die unten angeführten Pakete auf Ihrem Linux-Rechner noch nicht zurVerfügung stehen, führen Sie die Befehl yum (oder ggf. apt-get) aus, um sie zu installieren.


LicenseServer krb5-libs libgssapi-krb5-2 libgssapi-krb5-2


libqtcore

© 2017 Altova GmbH




4,libqtgui4,libgssapi-krb5-2

Deinstallieren einer alten Version von LicenseServerÜberprüfen Sie in der Linux-Befehlszeile (Command Line Interface = CLI), ob LicenseServerinstalliert ist. Verwenden Sie dazu den folgenden Befehl:

[Debian, Ubuntu]: dpkg --list | grep Altova

[CentOS, RedHat]: rpm -qa | grep server

Falls LicenseServer nicht installiert ist, beginnen Sie mit der Installation, wie dies in den nächstenSchritten dokumentiert ist. Falls LicenseServer installiert ist und Sie eine neuere Version vonLicenseServer installieren möchten, deinstallieren Sie die alte Version mit dem Befehl:

[Debian, Ubuntu]: sudo dpkg --remove licenseserver



[CentOS, RedHat]: sudo rpm -e licenseserver

Installation von Altova LicenseServerAuf Linux-Systemen muss LicenseServer separat von anderen Altova Server-Produkten installiertwerden. LicenseServer bildet nicht Teil der Altova Server-Produktinstallationspakete.Nachdem Sie das Linux-Paket von der Altova Website heruntergeladen haben, kopieren Sie dasPaket in ein beliebiges Verzeichnis auf dem Linux-System.

Distribution Installer-Erweiterung

Debian .deb

Ubuntu .deb

CentOS .rpm

RedHat .rpm

Wechseln Sie in einem Terminal-Fenster zu dem Verzeichnis, in das Sie das Linux-Paket kopierthaben. Wenn Sie es z.B. in ein Benutzerverzeichnis namens MyAltova (das sich z.B. imVerzeichnis /home/User befindet) kopiert haben, dann wechseln Sie folgendermaßen zu diesemVerzeichnis:

cd /home/User/MyAltova

Installieren Sie LicenseServer mit dem folgenden Befehl:

[Debian]: sudo dpkg --install licenseserver-2.3-debian.deb

[Ubuntu]: sudo dpkg --install licenseserver-2.3-ubuntu.deb

[CentOS]: sudo rpm -ivh licenseserver-2.3-1.x86_64.rpm

[RedHat]: sudo rpm -ivh licenseserver-2.3-1.x86_64.rpm


/opt/Altova/LicenseServer

Nähere Informationen zum Zuweisen von Lizenzen finden Sie im Abschnitt Zuweisen vonLizenzen.






1.7.4 Installation (Mac OS X)

Altova LicenseServer kann auf Mac OS X Systemen (Version 10.8 oder höher) installiert werden.Da Sie eventuell zuerst eine frühere Version deinstallieren müssen, wird zuerst die Deinstallationvon Altova LicenseServer beschrieben.

Systemanforderungen(Mac) OS X, macOS

OS X 10.10, 10.11, 10.12 oder neuer

Deinstallieren alter Versionen von LicenseServerBevor Sie LicenseServer deinstallieren, stoppen Sie den Dienst mit dem folgenden Befehl:

sudo launchctl unload /Library/LaunchDaemons/com.altova.LicenseServer.plist

Um zu überprüfen, ob der Dienst gestoppt wurde, öffnen Sie den Activity Monitor Terminal undvergewissern Sie sich, dass sich LicenseServer nicht auf der Liste befindet.

Klicken Sie unter Applications mit der rechten Maustaste auf das LicenseServer-Symbol undwählen Sie den Befehl Move to Trash. Die Applikation wird daraufhin in den Papierkorbverschoben. Sie müssen die Applikation jetzt noch aus dem Ordner usr entfernen. VerwendenSie dazu den folgenden Befehl:

sudo rm -rf /usr/local/Altova/LicenseServer

Installieren von Altova LicenseServerÖffnen Sie die Download-Seite http://www.altova.com/de/download.html und navigieren Sie unter"Server Software-Produkte" zum Altova LicenseServer Installer für Mac. Nachdem Sie die .dmg-Datei (Disk Image)-Datei heruntergeladen haben, klicken Sie darauf, um sie zu öffnen. Daraufhinwird auf Ihrem Computer ein neues virtuelles Laufwerk eingerichtet. Dopppelklicken Sie imvirtuellen Laufwerk auf die Paketdatei (.pkg) und befolgen Sie die Anweisungen auf demBildschirm. Damit die Installation fortgesetzt wird, müssen Sie die Lizenzvereinbarungakzeptieren.


/usr/local/Altova/LicenseServer

Um das virtuelle Laufwerk nach der Installation auszuwerfen, klicken Sie mit der rechtenMaustaste darauf und wählen Sie den Befehl Eject.


© 2017 Altova GmbH



1.7.5 Altova ServiceController

Der Altova ServiceController (in der Folge ServiceController genannt) ist eine Applikation, mit derSie Altova-Dienste auf Windows-Systemen starten, beenden und konfigurieren können.

ServiceController wird mit Altova LicenseServer und jedem Altova Server-Produkt, dasServiceController verwendet (FlowForce Server, RaptorXML(+XBRL) Server und Mobile TogetherServer), installiert und kann durch Klicken auf Start | Altova LicenseServer | AltovaServiceController gestartet werden. (Dieser Befehl steht auch in den Startmenüordnern derAltova Server-Produkten, die als Dienst installiert wurden (FlowForce Server, RaptorXML(+XBRL)Server und Mobile Together Server), zur Verfügung). Nachdem der ServiceController gestartetwurde, kann er über die Task-Leiste aufgerufen werden (Abbildung unten).

Damit der ServiceController automatisch ausgeführt wird, nachdem sich der Benutzer im Systemangemeldet hat, klicken Sie in der Task-Leiste auf das ServiceController-Symbol, um dasServiceController-Menü (Abbildung unten) aufzurufen und aktivieren Sie anschließend denBefehl Run Altova ServiceController at Startup. (Dieser Befehl ist standardmäßig aktiv). Umden ServiceController zu beenden, klicken Sie in der Task-Leiste auf das ServiceController-Symbol und klicken Sie im Menü, das daraufhin angezeigt wird (Abbildung unten) auf Exit AltovaServiceController.

Starten und Beenden von Altova-DienstenFür jede installierte Altova Dienstkomponente gibt es im Menü "ServiceController" (sieheAbbildung oben) einen Eintrag. Ein Altova-Dienst kann über einen Befehl im ServiceController-Untermenü gestartet oder beendet werden. Außerdem können über das Menü "ServiceController"wichtige Verwaltungsaufgabe einzelner Dienste aufgerufen werden. So hat z.B. der Dienst AltovaLicenseServer in der Abbildung oben ein Untermenü Configure, über das Sie dieKonfigurationsseite von LicenseServer aufrufen können.



1.7.6 Zuweisen von Lizenzen

Um einem Altova-Produkt über den Altova LicenseServer eine Lizenz zuzuweisen, gehen Siefolgendermaßen vor:

1. Starten Sie LicenseServer.2. Öffnen Sie die LicenseServer-Konfigurationsseite, d.h. die Administratorschnittstelle zu

LicenseServer unter Windows, Linux oder Mac OS X.3. Laden Sie die von Altova erhaltenen Lizenz(en) über das Register "License Pool" Ihres

Altova LicenseServers in den Lizenzpool. 4. Registrieren Sie das Altova-Produkt auf dem LicenseServer. Je nach Produkttyp erfolgt

die Registrierung beim LicenseServer auf unterschiedliche Art: entweder über dasDialogfeld "Software-Aktivierung", die Web-Benutzeroberfläche des Produkts oder überseine Befehlszeile. Nähere Informationen finden Sie in der Dokumentation zu IhremAltova-Produkt.

5. Weisen Sie dem Altova-Produkt auf dem Register "Client Management" derLicenseServer-Konfigurationsseite eine Lizenz zu.

Anmerkung zu Prozessorkernen und LizenzenDie Lizenzierung von Altova Server-Produkten basiert auf der Anzahl der auf dem Produktrechnerverfügbaren Prozessorkerne. So hat z.B. ein Dual-Core-Prozessor zwei Prozessorkerne, einQuad-Core-Prozessor hat vier Kerne, ein Hexa-Core-Prozessor hat sechs Kerne, usw. Die Anzahlder für ein Produkt lizenzierten Kerne muss größer oder gleich der Anzahl der auf diesemServerrechner verfügbaren Kerne sein, unabhängig davon, ob es sich um einen physischenRechner oder eine Virtual Machine handelt. Wenn ein Server z.B. acht Kerne hat (ein Octa-Core-Prozessor), müssen Sie mindestens eine Lizenz für acht Kerne erwerben. Sie können Lizenzenauch kombinieren, um das Produkt für die entsprechende Anzahl von Kernen zu lizenzieren. Sokönnen z.B. anstelle einer Lizenz für 8 Kerne auch zwei Lizenzen für 4 Kerne für einen 8-Kern-Prozessor verwendet werden.

Wenn Sie einen Server-Rechner mit einer großen Anzahl von CPU-Kernen verwenden, aber nurgeringe Datenmengen verarbeiten müssen, können Sie auch eine Virtual Machine erstellen, dereine geringere Anzahl an Kernen zugewiesen ist und eine Lizenz für diese Anzahl an Kernenerwerben. In diesem Fall ist die Verarbeitungsgeschwindigkeit natürlich geringer als beiVerwendung aller Kerne des Rechners.

Anmerkung: Jede Altova Server-Produktlizenz kann immer nur für einen Client-Rechnergleichzeitig verwendet werden, selbst wenn die Lizenzkapazität dieser Lizenz noch nichtausgeschöpft ist. Wenn z.B. eine 10-Kern-Lizenz für einen Client-Rechner mit 6 CPU-Kernen verwendet wird, so können die verbleibenden Lizenzen für die restlichen 4 Kernenicht gleichzeitig für einen anderen Client-Rechner verwendet werden.

MobileTogether Server-LizenzenMobileTogether Server-Lizenzen basieren auf der Anzahl der CPU-Kerne auf dem MobileTogetherServerrechner. Bei diesem Modell können unbegrenzt viele MobileTogether Client-Geräte mit demServer verbunden werden. Wenn Sie jedoch das Kontrollkästchen Limit to single thread executionaktivieren, so kann immer nur ein Mobilgerät mit dem MobileTogether Server verbunden werden.Dies ist für die Evaluierung und für Tests im kleinen Rahmen nützlich. Beachten Sie Folgendes:Wenn in diesem Fall ein zweites Gerät mit MobileTogether Sever verbunden wird, so übernimmtdieses die Lizenz. Das erste Gerät kann daraufhin keine Verbindung mehr herstellen und erhälteine entsprechende Fehlermeldung.

© 2017 Altova GmbH




In diesem Abschnitt werden folgende Schritte beschrieben:

Starten von LicenseServer auf Windows-SystemenStarten von LicenseServer auf Linux-SystemenStarten von LicenseServer auf Mac OS X-Systemen Anmerkung zur Verbindung zu altova.com

Windows-SystemeSie können LicenseServer über den Altova ServiceController, der in der Task-Leiste zur Verfügungsteht, starten.

Klicken Sie zuerst auf Start | Alle Programme | Altova LicenseServer | AltovaServiceController, um Altova ServiceController zu starten und sein Symbol in der Task-Leisteanzuzeigen (siehe Abbildung unten). Falls Sie die Option Run Altova ServiceController at Startupaktivieren, wird Altova ServiceController beim Systemstart gestartet, sodass sein Symbol abdiesem Zeitpunkt in der Task-Leiste zur Verfügung steht.

Um LicenseServer zu starten, klicken Sie in der Task-Leiste auf das Altova ServiceController-Symbol und platzieren Sie den Mauszeiger im angezeigten Menü über Altova LicenseServer(Abbildung oben) und wählen Sie im Untermenü von Altova LicenseServer den Befehl StartService. Wenn LicenseServer bereits ausgeführt wird, ist die Option Start Service deaktiviert.

Linux-SystemeUm LicenseServer auf Linux-Systemen als Dienst zu starten, führen Sie im Terminal-Fenster denfolgenden Befehl aus.

[Debian 7]: sudo /etc/init.d/licenseserver start [Debian 8]: sudo systemctl start licenseserver [Ubuntu <=14]: sudo initctl start licenseserver [Ubuntu 15]: sudo systemctl start licenseserver



[CentOS 6]: sudo initctl start licenseserver [CentOS 7]: sudo systemctl start licenseserver [RedHat]: sudo initctl start licenseserver

(Wenn Sie LicenseServer beenden möchten, ersetzen Sie den Befehl start im obigen Befehl

durch stop.)

Mac OS X-SystemeUm LicenseServer auf Mac OS X-Systemen als Dienst zu starten, führen Sie in einem Terminal-Fenster den folgenden Befehl aus:

sudo launchctl load /Library/LaunchDaemons/com.altova.LicenseServer.plist

Um LicenseServer zu beenden, verwenden Sie den folgenden Befehl:

sudo launchctl unload /Library/LaunchDaemons/com.altova.LicenseServer.plist



Öffnen der LicenseServer-Konfigurationsseite (Windows)


Öffnen der Konfigurationsseite, wenn LicenseServer auf demselben Rechner installiert istÖffnen der Konfigurationsseite, wenn LicenseServer auf einem anderen Rechner installiertistEinloggen mit dem AnfangspasswortDefinieren eines festgelegten Ports für die Konfigurationsseite

© 2017 Altova GmbH



Öffnen der Konfigurationsseite, wenn LicenseServer auf demselben Rechnerinstalliert istAuf Windows-Systemen können Sie die Konfigurationsseite von LicenseServer auf zwei Artenaufrufen, wenn LicenseServer auf demselben Rechner installiert ist:

Klicken Sie auf Start | Alle Programme | Altova LicenseServer | LicenseServer-Konfigurationsseite. Daraufhin wird die Konfigurationsseite auf einem neuen RegisterIhres Internet Browsers geöffnet.

Klicken Sie in der Task-Leiste auf das Altova ServiceController-Symbol und platzieren Sieden Mauszeiger im angezeigten Menü über Altova LicenseServer (Abbildung unten)und wählen Sie im Untermenü von Altova LicenseServer den Befehl Configure.

Daraufhin wird die Konfigurationsseite in einem neuen Browser-Fenster geöffnet und dieLogin-Maske wird angezeigt (siehe Abbildung unten).

Öffnen der Konfigurationsseite, wenn LicenseServer auf einem anderenRechner installiert istUm die Konfigurationsseite von LicenseServer von einem anderen Windows-Rechner im lokalenNetzwerk (als dem, auf dem LicenseServer installiert ist) zu öffnen, geben Sie die URL derLicenseServer Konfigurationsseite in die Adressleiste des Browsers ein und drücken Sie dieEingabetaste. Standardmäßig lautet die URL der Konfigurationsseite:

http://<serverIPAddressOrName>:8088/

Die URL ist im HTML-Code der Konfigurationsseite selbst enthalten. Der Name derKonfigurationsseite lautet WebUI.html und befindet sich unter:

C:/ProgramData/Altova/LicenseServer/WebUI.html

Wenn Sie (auf der Konfigurationsseite auf dem Register "Settings") für die URL derKonfigurationsseite eingestellt haben, dass sie dynamisch generiert wird, so wird bei jedem Startvon LicenseServer eine neue URL generiert. Sie müssen die aktuelle Version von WebUI.html

überprüfen, um die aktuelle URL der Konfigurationsseite zu ermitteln.

Die dynamisch in WebUI.html generierte URL sollte in etwa folgendermaßen lauten:

http://127.0.0.1:55541/optional-ein-weiterer-String und befindet sich in der Funktion

checkIfServiceRunning() in einem Script nahe dem Ende des Elements <head>. Während die



Port-Nummer in der URL dynamisch zugewiesen wird, identifiziert die IP-Adresse in der URL denServer, auf dem LicenseServer installiert wurde. Wenn Sie die LicenseServer-Konfigurationsseitevon einem anderen Rechner aus aufrufen möchten, stellen Sie sicher, dass der IP-Adressteil derURL die richtige IP-Adresse oder den richtigen Namen des Servers hat, auf dem LicenseServerinstalliert wurde. Die URL könnte z.B. lauten: http://SomeServer:55541.

Einloggen mit dem AnfangspasswortNachdem Sie die oben beschriebenen Schritte durchgeführt haben, wird die Konfigurationsseitemit der Login-Maske angezeigt (Abbildung unten). Sie können sich mit dem vorgegebenenAnfangspasswort default einloggen. Sie können Ihr Passwort nach dem Einloggen auf demRegister Settings ändern.

Definieren eines fixen oder dynamischen Ports für die KonfigurationsseiteDer Port für die Konfigurationsseite (Web-Benutzeroberfläche) (und somit seine Adresse) kann aufder Seite "Settings" definiert werden. Standardmäßig lautet der Port 8088. Sie können auf derKonfigurationsseite (siehe Abbildung unten) für den LicenseServer jeden beliebigen anderengewünschten Port definieren. Alternativ dazu können Sie auch festlegen, dass der Port bei jedemStart von LicenseServer dynamisch gewählt wird. In diesem Fall müssen Sie die URL derKonfigurationsseite in der Datei WebUI.html nachsehen (siehe Öffnen der LicenseServer-Konfigurationsseite (Windows), Öffnen der LicenseServer-Konfigurationsseite (Linux) und Öffnender LicenseServer-Konfigurationsseite (Mac OS X)).

© 2017 Altova GmbH



Der Vorteil eines fixen Ports ist, dass die Seiten-URL im Vorhinein bekannt ist und daherproblemlos aufgerufen werden kann. Wenn der Port dynamisch zugewiesen wird, muss der Portder URL bei jedem Start von LicenseServer zuerst in der Datei WebUI.html nachgeschlagenwerden.

Öffnen der LicenseServer-Konfigurationsseite (Linux)


Erstmaliges Öffnen der Konfigurationsseite über die zurückgegebene URLURL der LicenseServer-Konfigurationsseite Einloggen mit dem Anfangspasswort Definieren eines festgelegten Ports für die Konfigurationsseite

Erstmaliges Öffnen der Konfigurationsseite über die zurückgegebene URLWenn Sie Ihr Altova Server-Produkt auf Linux-Systemen über das CLI am LicenseServerregistrieren, wird die URL der LicenseServer-Konfigurationsseite zurückgegeben. Wenn Sie dieseURL in einem Browser öffnen, werden Sie aufgefordert, den Lizenzvertrag zu lesen und denBedingungen zuzustimmen. Nachdem Sie Ihre Zustimmung gegeben haben, wird die Login-Maskeder Konfigurationsseite angezeigt (Abbildung unten).

Anmerkung: Altova Desktop-Produkte stehen nur für Windows zur Verfügung.

URL der LicenseServer-KonfigurationsseiteUm die Konfigurationsseite von LicenseServer jederzeit aufrufen zu können, geben Sie die URL



der LicenseServer Konfigurationsseite in die Adressleiste des Browsers ein und drücken Sie die Eingabetaste. Standardmäßig lautet die URL der Konfigurationsseite:



/var/opt/Altova/LicenseServer/webUI.html




http://127.0.0.1:55541 und befindet sich in der Funktion checkIfServiceRunning() in einemScript nahe dem Ende des Elements <head>. Während die Port-Nummer in der URL dynamischzugewiesen wird, identifiziert die IP-Adresse in der URL den Server, auf dem LicenseServerinstalliert wurde. Wenn Sie die LicenseServer-Konfigurationsseite von einem anderen Rechner ausaufrufen möchten, stellen Sie sicher, dass der IP-Adressteil der URL die richtige IP-Adresse oderden richtigen Namen des Servers hat, auf dem LicenseServer installiert wurde. Die URL könntez.B. lauten: http://MyServer:55541.


© 2017 Altova GmbH





Öffnen der LicenseServer-Konfigurationsseite (Mac OS X)


Erstmaliges Öffnen der Konfigurationsseite über die zurückgegebene URLURL der LicenseServer-Konfigurationsseite Einloggen mit dem Anfangspasswort Definieren eines festgelegten Ports für die Konfigurationsseite

Erstmaliges Öffnen der Konfigurationsseite über die zurückgegebene URLWenn Sie Ihr Altova Server-Produkt auf Mac OS X-Systemen über das CLI am LicenseServerregistrieren, wird die URL der LicenseServer-Konfigurationsseite zurückgegeben. Wenn Sie dieseURL in einem Browser öffnen, werden Sie aufgefordert, den Lizenzvertrag zu lesen und denBedingungen zuzustimmen. Nachdem Sie Ihre Zustimmung gegeben haben, wird die Login-Maskeder Konfigurationsseite angezeigt (Abbildung unten).

Anmerkung: Altova Desktop-Produkte stehen nur für Windows zur Verfügung.



URL der LicenseServer-KonfigurationsseiteUm die Konfigurationsseite von LicenseServer jederzeit aufrufen zu können, geben Sie die URLder LicenseServer Konfigurationsseite in die Adressleiste des Browsers ein und drücken Sie die Eingabetaste. Standardmäßig lautet die URL der Konfigurationsseite:



/var/opt/Altova/LicenseServer/webUI.html




http://127.0.0.1:55541 und befindet sich in der Funktion checkIfServiceRunning() in einemScript nahe dem Ende des Elements <head>. Während die Port-Nummer in der URL dynamischzugewiesen wird, identifiziert die IP-Adresse in der URL den Server, auf dem LicenseServerinstalliert wurde. Wenn Sie die LicenseServer-Konfigurationsseite von einem anderen Rechner ausaufrufen möchten, stellen Sie sicher, dass der IP-Adressteil der URL die richtige IP-Adresse oderden richtigen Namen des Servers hat, auf dem LicenseServer installiert wurde. Die URL könntez.B. lauten: http://MyServer:55541.

Anmerkung: Die Konfigurationsseite kann auch direkt über das Symbol Suche |Anwendungen | Altova License Server aufgerufen werden.




Laden von Lizenzen in LicenseServer


Laden einer Lizenzdatei in den Lizenzpool von LicenseServer LizenzstatusAktivieren der gewünschten LizenzNächste Schritte

Laden einer Lizenzdatei in den Lizenzpool von LicenseServerNachdem Sie von Altova eine Lizenzdatei erhalten haben, müssen Sie diese im AltovaLicenseServer laden. Jede Lizenzdatei kann je nach Kauf eine oder mehrere Lizenzen enthalten.Wenn Sie eine Lizenzdatei laden, werden alle darin enthaltenen Lizenzen in den Lizenzpool aufdem Server geladen und können einem bei diesem LicenseServer registrierten Altova-Produktzugewiesen werden. Alle geladenen Lizenzen aus einer oder mehreren Lizenzdateien und für alleAltova-Produkte werden am LicenseServer in einem Lizenzpool gesammelt. Der Lizenzpool wirdauf der LicenseServer-Konfigurationsseite auf dem Register "License Pool" (Abbildung unten)angezeigt.

Lizenzdateien werden über die Funktion "Upload License File" auf dem Register "LicensePool" (siehe Abbildung oben) in den LicenseServer geladen. Klicken Sie auf die SchaltflächeBrowse und wählen Sie die gewünschte Lizenzdatei aus. Der Lizenzdateiname wird im Textfeld"Upload License File" angezeigt und die Schaltfläche Upload wird aktiv. Klicken Sie auf dieSchaltfläche Upload, um die Lizenzdatei zu laden. Alle Lizenzen in der Datei werden geladen undauf dem Register "License Pool" angezeigt. In der Abbildung oben sehen Sie mehrere Lizenzen,die aus mehreren Lizenzdateien geladen wurden.

Lizenzstatus

© 2017 Altova GmbH



Es gibt die folgenden Lizenzstatuswerte:

Activating: Nachdem eine Lizenz in den Lizenzpool von LicenseServer hochgeladenwurde, werden die Lizenzdaten dazu zur Überprüfung, Authentifizierung und Aktivierungder geladenen Lizenz an den Master Licensing Server unter altova.com weitergeleitet,um die Einhaltung des Altova Lizenzvertrags zu überwachen. Währenddessen - die Dauerkann je nach Verbindung und Netzwerkverkehr zwischen 30 Sekunden und einigenMinuten variieren - wird der Status als Activating....angezeigt.

Failed Verification: Falls keine Verbindung zum Master Licensing Server unteraltova.com hergestellt werden konnte, wird der Status der Lizenz im Pool als FailedVerification angezeigt. Überprüfen Sie in diesem Fall Ihre Internetverbindung und dieFirewall-Einstellungen, um sicherzustellen, dass LicenseServer eine Verbindung zumMaster Licensing Server unter altova.com herstellen kann.

Active: Sobald die Lizenz authentifiziert und aktiviert wurde, ändert sich der Status inActive.

Inactive: Wenn eine Lizenz überprüft wurde, aber auf einem anderen LicenseServer imNetzwerk vorhanden ist, wird der Status als Inactive angezeigt. Der Status Inactive kannauch zustande kommen, wenn eine Lizenz im Lizenzpool vom Administrator manuelldeaktiviert wurde.

Pending: Wenn eine Lizenz erst ab einem Datum in der Zukunft gültig ist, so wird dieLizenz als Pending angezeigt. Am ersten Gültigkeitstag ändert sich der Status in Active.Eine schwebende (pending) Lizenz wird einem Produkt zugewiesen, und dient dazu zugewährleisten, dass ein Produkt ohne Unterbrechung verwendet werden kann, bevor einevorhandene Lizenz abläuft. (Einem Produkt können gleichzeitig zwei aktive Lizenzenzugewiesen sein.)

Blocked: Eine Lizenz erscheint im Lizenzpool als Blocked, wenn es ein Problem mit derAuthentifizierung der Lizenz gab und der Master License Server unter altova.com dieVerwendung der Lizenz nicht gestattet. Dies kann der Fall sein, wenn der Lizenzvertragnicht eingehalten wurde, zu viele Lizenzen verwendet werden oder andereLizenzverletzungen festgestellt wurden. Wird eine Lizenz mit dem Status Blockedangezeigt, wenden Sie sich bitte mit Ihren Lizenzdaten und anderen relevanten Daten anden Altova Support.

Eine Übersicht über die Statuswerte finden Sie in der folgenden Tabelle:

Status Bedeutung

Activating... Nach dem Laden werden die Lizenzdaten zur Überprüfung an altova.comgesendet. Aktualisieren Sie den Browser, um den aktualisierten Status zusehen. Die Überprüfung und Aktivierung kann einige Minuten dauern.

Failed Verification Es konnte keine Verbindung zu altova.com hergestellt werden. Nachdemeine Verbindung hergestellt wurde, starten Sie den Dienst entweder neuoder aktivieren Sie die Lizenz (über die Schaltfläche Activate).

Active Die Überprüfung war erfolgreich, die Lizenz ist aktiv.

Inactive Die Überprüfung war erfolgreich, aber die Lizenz befindet sich auch aufeinem anderen LicenseServer im Netzwerk. Lizenzen können über die



Schaltfläche Deactivate deaktiviert werden.

Pending Eine Lizenz mit dem Status Pending (schwebend) hat ihr Beginndatum inder Zukunft. Ab dem Beginndatum ändert sich ihr Status in Active. Siekann einem Produkt zugewiesen werden und gewährleistet, dass dieLizenzierung eines Produkts noch vor dem Ablauf der alten Lizenzautomatisch verlängert wird.

Blocked Die Überprüfung war negativ. Die Lizenz ist ungültig und wurde blockiert.Wenden Sie sich an den Altova Support

Anmerkung: Nachdem die Lizenz zur Überprüfung an altova.com gesendet wurde, muss derBrowser aktualisiert werden, damit Sie den aktualisierten Status sehen. Die Überprüfungund Aktivierung kann einige Minuten dauern.

Anmerkung: Falls keine Verbindung zu altova.com hergestellt werden konnte, wird derStatus als Failed Verification angezeigt. Nachdem eine Verbindung hergestellt wurde,starten Sie den Dienst entweder neu oder versuchen Sie, die Lizenz (über dieSchaltfläche Activate) zu aktivieren.

Anmerkung: Wenn eine Lizenz den Status Inactive oder Blocked erhält, wird eine Meldungmit einer Erklärung dazu zum Meldungs-Log hinzugefügt.

Nur eine aktive oder schwebende (pending) Lizenz kann einem Produkt zugewiesen werden. Eineinaktive Lizenz kann aktiviert oder aus dem Lizenzpool gelöscht werden. Wenn eine Lizenz ausdem Lizenzpool gelöscht wurde, kann sie erneut durch Laden der darin enthaltenen Lizenzdatei inden Pool geladen werden. Wenn eine Lizenzdatei aktualisiert wird, werden nur die Lizenzen darin,die sich noch nicht im Pool befinden, in den Pool geladen. Um eine Lizenz zu aktivieren, zudeaktivieren oder zu löschen, wählen Sie sie aus und klicken Sie auf die Schaltfläche Activate,Deactivate bzw. Delete.

Aktivieren der gewünschten Lizenz(en)Damit Sie einem Altova-Produkt eine Lizenz zuweisen können, muss sie aktiv sein. Wenn sieinaktiv ist, wählen Sie sie aus und klicken Sie auf Activate.

Nächste SchritteNachdem Sie die Lizenzdatei in den LicenseServer geladen und sichergestellt haben, dass sieaktiv ist, gehen Sie folgendermaßen vor:

1. Registrieren Sie das Altova Server-Produkt (FlowForce Server, MapForce Server,StyleVision Server) auf dem LicenseServer. Wenn Sie dies bereits vor dem Laden derLizenz getan haben, können Sie nun damit beginnen, Lizenzen zuzuweisen.

2. Weisen Sie Ihrem beim LicenseServer registrierten Altova-Produkt eine Lizenz zu.


© 2017 Altova GmbH



Registrieren von Produkten

Bevor Sie einem Altova-Produkt eine Lizenz zuweisen können, müssen Sie die Produktinstallationam LicenseServer registrieren. Die Registrierung wird vom Altova-Produkt aus durchgeführt unddas Verfahren unterscheidet sich je nach Produktart.

Desktop-Produkte: Die Registrierung erfolgt über das Dialogfeld "Software-Aktivierung"des Dialogfelds.Server-Produkte mit Web-Benutzeroberflächen: Die Registrierung von FlowForce Serverund MobileTogether Server erfolgt über das Register Setup der Web-Benutzeroberflächeoder über die Befehlszeilenschnittstelle (CLI) des Produkts.Server-Produkte, die keine Web-Benutzeroberfläche haben: Die Registrierung vonMapForceServer, RaptorXML(+XBRL) Server und StyleVisionServer erfolgt über die CLIdieser Produkte. Sie benötigen den Server-Namen oder die IP-Adresse des Rechners, aufdem LicenseServer installiert ist, um die Registrierung durchführen zu können.

In diesem Abschnitt wird beschrieben, wie Sie die verschiedenen Altova Server-Produkteregistrieren:

Registrieren von Altova Desktop-ProduktenRegistrieren von FlowForce ServerRegistrieren von MapForce ServerRegistrieren von MobileTogether ServerRegistrieren von RaptorXML(+XBRL) ServerRegistrieren von StyleVision Server

Registrieren von Altova Desktop-Produkten

Um ein Altova Desktop-Produkt auf einem Altova LicenseServer zu registrieren, gehen Siefolgendermaßen vor:

1. Wählen Sie den Menübefehl Hilfe | Software-Aktivierung, um das Dialogfeld "Software-Aktivierung" des Produkts aufzurufen. Sie können Ihre Software entweder (i) über AltovaLicenseServer oder (ii) durch Eingabe der Keycode-Informationen Ihres Produktsaktivieren. In dieser Dokumentation wird nur die Lizenzierung über Altova LicenseServerbeschrieben.

2. Um Ihr Altova-Produkt über LicenseServer zu lizenzieren, klicken Sie am unteren Randdes Dialogfelds auf Altova LicenseServer verwenden (siehe Abbildung unten).

3. Daraufhin wechselt das Dialogfeld in den LicenseServer-Aktivierungsmodus (Abbildungunten). Wählen Sie in der Auswahlliste Altova LicenseServer einen LicenseServer aus derDropdown-Liste aus.



Sobald die Verbindung zum ausgewählten LicenseServer hergestellt ist, wird das Produktsofort auf dem ausgewählten LicenseServe registriert und das Produkt wird auf dem Register "Client Management" in der Produktliste dieses Client-Rechners angezeigt.

Aufhebung der Registrierung eines Desktop-ProduktsUm die Registrierung eines Desktop-Produkts zu entfernen, gehen Sie zum Register "ClientManagement" von LicenseServer und klicken Sie im rechten Fenster Product licensing auf dieSchaltfläche Unregister Product für das jeweilige Produkt.

Registrieren von FlowForce Server


Methoden, um FlowForce Server zu registrieren Aufrufen der FlowForce Server Setup-Seite (Windows) Aufrufen der FlowForce Server Setup-Seite (Linux) Registrieren von FlowForce Server über die Setup-SeiteRegistrieren von FlowForce Server über das FlowForce CLI (Windows) Registrieren von FlowForce Server über das FlowForce CLI (Linux) Nächste Schritte

Methoden, um FlowForce Server zu registrierenFlowForce Server kann auf folgende Arten auf dem LicenseServer registriert werden.

über die FlowForce Server Setup-Seiteüber das FlowForce CLI (Windows) über das FlowForce CLI (Linux)

Aufrufen der FlowForce Server Setup-Seite (Windows)Die FlowForce Server Setup-Seite kann auf zwei Arten aufgerufen werden:

Über das Menü Start:

© 2017 Altova GmbH



Start | Altova FlowForce Server 2017 | FlowForce Server Setup-Seite

Über Altova ServiceController: Klicken Sie in der Task-Leiste auf das ServiceController-Symbol und wählen Sie im angezeigten Menü den Eintrag Altova FlowForce Web |Setup.

Daraufhin wird die FlowForce Server Setup-Seite (Abbildung oben) aufgerufen.

Aufrufen der FlowForce Server Setup-Seite (Linux)Nachdem Sie FlowForce Server unter Linux installiert haben (eine Beschreibung dazu finden Siein der Benutzerdokumentation zu FlowForce Server), starten Sie FlowForce Web Server mit demfolgenden Befehl als Dienst:

sudo /etc/init.d/flowforcewebserver start

Im Terminal-Fenster wird eine Meldung, die die URL der FlowForce Server Setup-Seite enthält,angezeigt:

FlowForceWeb running on http://127.0.1.1:3459/setup?key=52239315203

Geben Sie die URl in die Adressleiste eines Browsers ein und drücken Sie die Eingabetaste, umdie FlowForce Server Setup-Seite aufzurufen (Abbildung unten).

Registrieren von FlowForce Server über die Setup-SeiteAuf der Setup-Seite (Abbildung unten) (Anleitung zum Aufruf siehe oben) wird Im FeldLicenseServer angegeben, bei welchem Altova LicenseServer der FlowForce Server registriertwerden soll.



Der gewünschte LicenseServer kann auf zwei verschiedene Arten definiert werden.

Sie können nach Altova LicenseServern suchen, die derzeit auf dem Netzwerk verfügbarsind, d.h. die gerade ausgeführt werden. Klicken Sie dazu auf die Schaltfläche Searchfor Altova LicenseServers (in der Abbildung unten gelb mark iert).

Daraufhin wird eine Liste aller auf dem Netzwerk verfügbaren Altova LicenseServerzurückgegeben. Ein LicenseServer ist ausgewählt (Abbildung unten) und die anderenstehen in der Dropdown-Liste der Auswahlliste zur Verfügung. Wählen Sie denLicenseServer aus, auf dem Ihre FlowForce Lizenz gespeichert ist.

© 2017 Altova GmbH



Alternativ dazu können Sie die Adresse des LicenseServers in das Feld LicenseServereingeben. Wenn die aktuell ausgeführten LicenseServer auch in Form einer Dropdown-Liste zur Verfügung stehen, klicken Sie auf die Schaltfläche Manually Enter Address,um eine Adresse in das Feld "LicenseServer" eingeben zu können.

Nachdem Sie den LicenseServer definiert haben, klicken Sie auf Register with LicenseServer.Die Altova Server-Applikation wird auf dem angegebenen LicenseServer registriert und die Konfigurationsseite dieses LicenseServers wird in einem Browser geöffnet, wobei das Register"Client Management" (Abbildung unten) aktiv ist.

Anmerkung: Sie müssen unter Umständen die Anzeige von Popup-Fenstern gestatten, damitdie LicenseServer Konfigurationsseite angezeigt wird.



In der Abbildung oben wurden drei Altova Produkte beim Altova LicenseServer unter DOC.altova.com registriert. Wie man eine Lizenz zuweist, ist im nächsten Abschnitt Zuweisenvon Lizenzen zu registrierten Produkten beschrieben.

Registrieren von FlowForce Server über das FlowForce CLI (Windows)Auf Windows-Rechnern, kann FlowForce Server auch über die Befehlszeile (CLI) auf einemLicenseServer in Ihrem Netzwerk registriert werden. Verwenden Sie dazu den Befehl licenseserver:

FlowForceServer licenseserver Server-Or-IP-Address

Wenn LicenseServer z.B. unter http://localhost:8088 ausgeführt wird, so registrieren SieFlowForce Server mit dem folgenden Befehl:

FlowForceServer licenseserver localhost

Wenn FlowForce Server zusammen im Paket mit anderen Altova Server-Produkten installiertwurde, werden bei der Registrierung von FlowForce Server automatisch auch die Altova Server-Produkte registriert. Nachdem Sie FlowForce Server erfolgreich registriert haben, können Sie zuLicenseServer wechseln und FlowForce Server eine Lizenz zuweisen. Eine Beschreibung dazufinden Sie im Abschnitt Zuweisen von Lizenzen zu registrierten Produkten.

Registrieren von FlowForce Server über das FlowForce CLI (Linux)Auf Linux-Rechnern kann FlowForce Server mit dem Befehl licenseserver des FlowForce ServerCLI am LicenseServer registriert werden. Beachten Sie, dass FlowForce Server mit root-Rechtengestartet werden muss.

sudo /opt/Altova/FlowForceServer2017/bin/flowforceserver licenseserver

localhost

In der Befehlszeile oben ist localhost der Name des Servers, auf dem LicenseServer installiertist. Beachten Sie, dass der Pfad der ausführbaren Datei von FlowForce Server der folgende ist:

/opt/Altova/FlowForceServer2017/bin

Nachdem Sie FlowForce Server erfolgreich registriert haben, können Sie zu LicenseServerwechseln und FlowForce Server eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie imAbschnitt Zuweisen von Lizenzen zu registrierten Produkten.

Nächste SchritteNachdem Sie Ihr Altova-Produkt am LicenseServer registriert haben, gehen Sie folgendermaßen

© 2017 Altova GmbH



vor:

1. Wenn Sie die Lizenzdatei(en) mit der/den Lizenzen noch nicht am LicenseServer geladenhaben (siehe vorheriger Abschnitt Laden von Lizenzen in LicenseServer), laden Sie siejetzt und überprüfen Sie, ob die gewünschte Lizenz aktiv ist. Falls Sie das bereits getanhaben, fahren Sie mit dem nächsten Schritt, der Zuweisung der Lizenzen fort.


Registrieren von MapForce Server


Registrieren von MapForce Server über FlowForce Server (Windows) Registrieren des eigenständigen MapForce Server-Produkts (Windows) Registrieren von MapForce Server (Linux) Nächste Schritte

MapForce Server kann als Teil des FlowForce Server Pakets oder als eigenständiges Server-Produkt installiert werden. In beiden Fällen muss es am Altova LicenseServer registriert werden.Erst dann können Sie dem Produkt über den LicenseServer eine Lizenz zuweisen. Auf Windows-Systemen können Sie MapForce Server als Teil der FlowForce-Installation installieren. WennMapForce Server auf Windows-Systemen im Rahmen des FlowForce Server-Pakets installiertwurde, wird das Produkt automatisch registriert, wenn FlowForce auf dem LicenseServerregistriert wird. Auf Linux-Systemen müssen die beiden Produkte separat installiert werden. WennMapForce Server nach FlowForce Server installiert wird, wird das Produkte automatischregistriert, wenn FlowForce Server registriert wird, doch wenn MapForce Server vor FlowForceServer installiert wird, müssen Sie beide Produkte separat registrieren.

Registrieren von MapForce Server über FlowForce Server (Windows)MapForce Server ist zusammen in einem Paket mit FlowForce Server enthalten. Wenn daherFlowForce Server auf einem Altova LicenseServer in Ihrem Netzwerk installiert wird, wird auchMapForce Server automatisch auf dem LicenseServer registriert. Eine Beschreibung zumRegistrieren von FlowForce Server finden Sie in der Dokumentation zu Altova FlowForce Serverund im Abschnitt Registrieren von FlowForce Server am LicenseServer.

Nachdem Sie das Produkt registriert haben, können Sie LicenseServer aufrufen und MapForceServer eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie im Abschnitt Zuweisen vonLizenzen zu registrierten Produkten.

Registrieren des eigenständigen MapForce Server-Produkts (Windows)Wenn Sie MapForce Server als eigenständiges Paket installiert haben, müssen Sie das Produktauf einem Altova LicenseServer in Ihrem Netzwerk registrieren und ihm über den AltovaLicenseServer eine Lizenz zuweisen. Sie können MapForce Server über seineBefehlszeilenschnittstelle (CLI) mit Hilfe des Befehls licenseserver registrieren.



MapForceServer licenseserver Server-Or-IP-Address

Wenn LicenseServer z.B. unter http://localhost:8088 ausgeführt wird, so registrieren SieMapForce Server mit dem folgenden Befehl:

MapForceServer licenseserver localhost

Nachdem Sie MapForce Server erfolgreich registriert haben, können Sie LicenseServer aufrufenund StyleVision Server eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie im AbschnittZuweisen von Lizenzen zu registrierten Produkten.

Registrieren von MapForce Server (Linux)Auf Linux-Rechnern kann MapForce Server mit dem Befehl licenseserver des MapForce ServerCLI am LicenseServer registriert werden. Beachten Sie, dass MapForce Server mit root-Rechtengestartet werden muss.

sudo /opt/Altova/MapForceServer2017/bin/mapforceserver licenseserver

localhost

In der Befehlszeile oben ist localhost der Name des Servers, auf dem LicenseServer installiertist. Beachten Sie, dass der Pfad der ausführbaren Datei von MapForce Server der folgende ist:

/opt/Altova/MapForceServer2017/bin

Nachdem Sie MapForce Server erfolgreich registriert haben, können Sie zu LicenseServerwechseln und MapForce Server eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie imAbschnitt Zuweisen von Lizenzen zu registrierten Produkten.

Nächste SchritteNachdem Sie Ihr Altova-Produkt am LicenseServer registriert haben, gehen Sie folgendermaßenvor:



Registrieren von MobileTogether Server

Um MobileTogether Server zu starten, klicken Sie in der Taskleiste auf das ServiceControllerSymbol, platzieren Sie den Mauszeiger im daraufhin angezeigten Menü (siehe Abbildung unten)über Altova MobileTogether Server und wählen Sie aus dem Untermenü den Befehl StartService aus. Wenn MobileTogether Server bereits ausgeführt wird, ist die Option Start Servicedeaktiviert.

© 2017 Altova GmbH



Registrieren von MobileTogether Server über:

das Register "Einstellungen" der MobileTogether Server Web-Schnittstelle: (i) Starten SieMobileTogether Server über den ServiceController (siehe vorhergehender Punkt); (ii)Geben Sie Ihr Passwort ein, um die Setup-Seite aufzurufen; (iii) Wählen Sie den Namenoder die Adresse des LicenseServers aus und klicken Sie auf Auf LicenseServerregistrieren.

das CLI (die Befehlszeilenschnittstelle) mit dem Befehl licenseserver:MobileTogetherServer licenseserver [options] ServerName-Or-IP-Address

Wenn z.B. localhost der Name des Servers ist, auf dem LicenseServer installiert ist:MobileTogetherServer licenseserver localhost

Nachdem Sie MobileTogether Server erfolgreich registriert haben, rufen Sie das Register "ServerManagement" der Konfigurationsseite von LicenseServer auf, um MobileTogether Server eineLizenz zuzuweisen.

Registrieren von RaptorXML(+XBRL) Server


Registrieren von RaptorXML(+XBRL) Server (Windows) Registrieren von RaptorXML(+XBRL) Server (Linux) Nächste Schritte

RaptorXML(+XBRL) Server muss auf dem Server-Rechner oder in dem Netzwerk installiert werden,mit dem LicenseServer verbunden ist, und anschließend als Dienst gestartet werden.Anschließend muss das Produkt auf dem LicenseServer registriert werden. Erst danach kanndem Produkt über LicenseServer eine Lizenz zugewiesen werden. In diesem Abschnitt wirdbeschrieben, wie Sie RaptorXML(+XBRL) Server auf dem LicenseServer registrieren.

Registrieren von RaptorXML(+XBRL) Server (Windows)



Sie können RaptorXML(+XBRL) Server mit dem Befehl licenseserver über seineBefehlszeilenschnittstelle (CLI) registrieren:

RaptorXML Server: RaptorXML licenseserver Server-Or-IP-Address

RaptorXML+XBRLServer:

RaptorXMLXBRL licenseserver Server-Or-IP-Address

Wenn LicenseServer z.B. unter http://localhost:8088 ausgeführt wird, so registrieren SieRaptorXML (+XBRL) Server mit dem folgenden Befehl:

RaptorXML Server: RaptorXML licenseserver localhost

RaptorXML+XBRLServer:

RaptorXMLXBRL licenseserver localhost

Nachdem Sie RaptorXML(+XBRL) Server registriert haben, können Sie LicenseServer aufrufen undRaptorXML(+XBRL) Server eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie imAbschnitt Zuweisen von Lizenzen zu registrierten Produkten.

Registrieren von RaptorXML(+XBRL) Server (Linux)Auf Linux-Rechnern kann RaptorXML(+XBRL) Server mit dem Befehl licenseserver desRaptorXML(+XBRL) Server CLI am LicenseServer registriert werden. Beachten Sie, dassRaptorXML(+XBRL) Server mit root-Rechten gestartet werden muss.

sudo /opt/Altova/RaptorXMLServer2017/bin/raptorxmlserver licenseserver

localhost sudo /opt/Altova/RaptorXMLXBRLServer2017/bin/raptorxmlxbrlserver licenseserver

localhost

In der Befehlszeile oben ist localhost der Name des Servers, auf dem LicenseServer installiertist. Beachten Sie, dass der Pfad der ausführbaren Datei von RaptorXML(+XBRL) Server derfolgende ist:

/opt/Altova/RaptorXMLServer2017/bin

/opt/Altova/RaptorXMLXBRLServer2017/bin

Nachdem Sie RaptorXML(+XBRL) Server erfolgreich registriert haben, können Sie zuLicenseServer wechseln und RaptorXML(+XBRL) Server eine Lizenz zuweisen. Eine Beschreibungdazu finden Sie im Abschnitt Zuweisen von Lizenzen zu registrierten Produkten.


1. Wenn Sie die Lizenzdatei(en) mit der/den Lizenzen noch nicht am LicenseServer geladenhaben (siehe vorheriger Abschnitt Laden von Lizenzen in LicenseServer), laden Sie sie

© 2017 Altova GmbH



jetzt und überprüfen Sie, ob die gewünschte Lizenz aktiv ist. Falls Sie das bereits getanhaben, fahren Sie mit dem nächsten Schritt, der Zuweisung der Lizenzen fort.




Registrieren von StyleVision Server über FlowForce (Windows) Registrieren des eigenständigen StyleVision Server-Produkts (Windows) Registrieren von StyleVision Server (Linux) Nächste Schritte

StyleVision Server kann als Teil des FlowForce Server Pakets oder als eigenständiges Server-Produkt installiert werden. In beiden Fällen muss es am Altova LicenseServer registriert werden.Erst dann können Sie dem Produkt über den LicenseServer eine Lizenz zuweisen. WennStyleVision Server auf Windows-Systemen im Rahmen des FlowForce Server-Pakets installiertwurde, wird das Produkt automatisch registriert, wenn FlowForce registriert wird. Auf Linux-Systemen wird StyleVision Server nur dann automatisch bei der Registrierung von FlowForceServer registriert, wenn es nach FlowForce Server installiert wurde.

Registrieren von StyleVision Server über FlowForce (Windows)StyleVision Server ist zusammen in einem Paket mit FlowForce Server enthalten. Wenn daherFlowForce Server auf einem Altova LicenseServer in Ihrem Netzwerk installiert wird, wird auchStyleVision Server automatisch auf dem LicenseServer registriert. Eine Beschreibung zumRegistrieren von FlowForce Server finden Sie in der Dokumentation zu Altova FlowForce Serverund im Abschnitt Registrieren von FlowForce Server am LicenseServer.

Nachdem Sie das Produkt registriert haben, können Sie LicenseServer aufrufen und StyleVisionServer eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie im Abschnitt Zuweisen vonLizenzen zu registrierten Produkten.

Registrieren des eigenständigen StyleVision Server-Produkts (Windows)Wenn Sie StyleVision Server als eigenständiges Paket unter Windows installiert haben, müssenSie das Produkt auf einem Altova LicenseServer in Ihrem Netzwerk registrieren und ihm über denAltova LicenseServer eine Lizenz zuweisen. Sie können StyleVision Server über seineBefehlszeilenschnittstelle (CLI) mit Hilfe des Befehls licenseserver registrieren.

StyleVisionServer licenseserver [options] Server-Or-IP-Address

Wenn LicenseServer z.B. unter http://localhost:8088 ausgeführt wird, so registrieren SieStyleVision Server mit dem folgenden Befehl:



StyleVisionServer licenseserver localhost

Nachdem Sie StyleVision Server erfolgreich registriert haben, können Sie LicenseServer aufrufenund StyleVision Server eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie im AbschnittZuweisen von Lizenzen zu registrierten Produkten.

Registrieren von StyleVision Server (Linux)Auf Linux-Rechnern kann StyleVision Server mit dem Befehl licenseserver des StyleVisionServer CLI am LicenseServer registriert werden. Beachten Sie, dass StyleVision Server mit root-Rechten gestartet werden muss.

sudo /opt/Altova/StyleVisionServer2017/bin/stylevisionserver licenseserver

localhost

In der Befehlszeile oben ist localhost der Name des Servers, auf dem LicenseServer installiertist. Beachten Sie, dass der Pfad der ausführbaren Datei von StyleVision Server der folgende ist:

/opt/Altova/StyleVisionServer2017/bin

Nachdem Sie StyleVision Server erfolgreich registriert haben, können Sie zu LicenseServerwechseln und StyleVision Server eine Lizenz zuweisen. Eine Beschreibung dazu finden Sie imAbschnitt Zuweisen von Lizenzen zu registrierten Produkten.




Zuweisen von Lizenzen zu registrierten Produkten


Vor dem Zuweisen einer LizenzDas Register "Client Management"Symbole auf dem Register "Client Management"Anmerkung zu Kernen und LizenzenZuweisen eine LizenzAufheben der Registrierung von Produkten am LicenseServer

Vor dem Zuweisen einer LizenzBevor Sie einem Altova-Produkt eine Lizenz zuweisen können, stellen Sie sicher, dass:

© 2017 Altova GmbH



die entsprechende Lizenz in den Lizenzpool von LicenseServer geladen wurde und dassdie Lizenz aktiv ist.Ihr Altova-Produkt beim LicenseServer registriert wurde.

Das Register "Client Management"Die Lizenzzuweisung erfolgt auf dem Register "Client Management" der LicenseServer-Konfigurationsseite (Abbildung unten). In der Abbildung sehen Sie, dass es im Fenster auf derlinken Seite einen Client-Rechner gibt, auf dem drei Altova-Produkte installiert sind, die aufLicenseServer registriert sind.

Beachten Sie zum Register "Client Management" die folgenden Punkte:

Im linken Bereich ist jedes Produkt unter dem Namen seines Client-Rechners aufgelistet.In der Abbildung oben ist ein Client-Rechner aufgelistet. Unter diesem Namen sind dreiAltova-Produkte auf dem LicenseServer registriert. Wenn ein auf einem anderen Client-Rechner installiertes Altova-Produkt auf diesem LicenseServer registriert ist, so wirddieser Client-Rechner mit seinen registrierten Produkten ebenfalls im linken Bereichaufgelistet.Wenn Sie im linken Bereich einen Client-Rechner auswählen, so werden dieLizenzinformationen zu diesem Rechner im Bereich auf der rechten Seite angezeigt. Hierkönnen Sie die Lizenzzuweisungen jedes einzelnen Produkts bearbeiten.Jedes registrierte Altova-Produkt auf einem Client-Rechner hat seinen eigenen KeycodeEintrag, d.h. den Keycode aus einer Lizenz. Ein registriertes Produkt erhält durch Klickenauf die Schaltfläche Edit assigned Licenses (siehe Symbolliste unten) und Auswahl dererforderlichen Lizenzen aus den im Lizenzpool für das Produkt verfügbaren Lizenzen eineLizenz zugewiesen. Eine ausführlichere Anleitung dazu finden Sie weiter unten.Für jedes Server-Produkt gibt es eine Zeile, in der angegeben wird, wie viele CPU-Kernefür dieses Produkt auf diesem Client lizenziert werden müssen. Wenn die Anzahl derlizenzierten Kerne kleiner als die erforderliche Anzahl ist, wird diese Information rot



markiert (siehe Abbildung unten). (Die Anzahl der zu lizenzierenden CPU-Kerneentspricht der Anzahl der CPU-Kerne auf diesem Client. Diese Zahl wird vonLicenseServer vom Client-Rechner abgerufen.)

Wenn auf demselben Rechner mehrere Versionen eines einzigen Produkts (z.B.StyleVision Server 2013 und StyleVision Server 2014) installiert wurden und wenn jededieser Installationen auf einem einzigen LicenseServer registriert wurde, so werden dieseMehrfachregistrierungen auf dem Register "Client Management" zu einer einzigenRegistrierung zusammengefasst und als nur eine Registrierung angezeigt. Wenn diesereinzigen Registrierung eine Lizenz zugewiesen wird, werden alle Installationen zu dieserRegistrierung lizenziert. Es können jedoch auf dem Client-Rechner nur mehrere Instanzeneiner einzigen Installation gleichzeitig ausgeführt werden. So können etwa mehrereInstanzen von StyleVision Server 2013 oder mehrere Instanzen von StyleVision Server2014 gleichzeitig ausgeführt werden, nicht aber eine Instanz von StyleVision Server 2013und eine Instanz von StyleVision Server 2014. Beachten Sie, dass neu installierteVersionen zuerst registriert werden müssen, bevor sie ausgeführt werden können.Neue Versionen von Altova Server-Produkten können nur mit der Version vonLicenseServer lizenziert werden, die zum Zeitpunkt der Produkt-Release die neueste ist,jedoch funktionieren ältere Versionen von Altova Server-Produkten mit neueren Versionendes LicenseServer. Wenn Sie daher eine neue Version eines Altova-Produkts installierenund Ihre aktuelle LicenseServer-Version nicht die neueste ist, deinstallieren Sie die ältereVersion von LicenseServer und installieren Sie die neueste Version. Alle Registrierungs-und Lizenzierungsdaten aus Ihrer alten Version von LicenseServer werden bei derDeinstallation in einer Datenbank auf dem Client-Rechner gespeichert und automatisch indie neuere Version importiert.) (Welche LicenseServer-Version für eine bestimmteVersion eines Server-Produkts benötigt wird, wird während der Installation des Server-Produkts angezeigt. Sie können diese Version von LicenseServer zusammen mit demServer-Produkt installieren. Die Nummer der aktuell installierten LicenseServer-Versionwird am unteren Rand der LicenseServer-Konfigurationsseite angezeigt.)

Symbole auf dem Register "Client Management"

© 2017 Altova GmbH



Edit Assigned Licenses. (Zugewiesene Lizenzen bearbeiten) Steht für jedes aufgelisteteProdukt zur Verfügung. Ruft das Dialogfeld "Edit Assigned Licenses" auf, in dem neueLizenzen zugewiesen und bereits zugewiesene bearbeitet werden können.

Show Licenses. (Lizenzen anzeigen) Wird zu jeder aufgelisteten Lizenz angezeigt.Damit wechseln Sie zum Register "License Pool", wo die ausgewählte Lizenz markiertwird. Hier finden Sie die Lizenzinformationen.

Unregister This Product. (Registrierung für dieses Produkt aufheben). Die Registrierungdes ausgewählten Produkts wird beim LicenseServer aufgehoben.



Anmerkung: Jede Altova Server-Produktlizenz kann immer nur für einen Client-Rechnergleichzeitig verwendet werden, selbst wenn die Lizenzkapazität dieser Lizenz noch nichtausgeschöpft ist. Wenn z.B. eine 10-Kern-Lizenz für einen Client-Rechner mit 6 CPU-Kernen verwendet wird, so können die verbleibenden Lizenzen für die restlichen 4 Kernenicht gleichzeitig für einen anderen Client-Rechner verwendet werden.


Zuweisen einer LizenzUm einem registrierten Produkt eine Lizenz zuzuweisen, klicken Sie auf die Schaltfläche EditAssigned Licenses dieses Produkts. Daraufhin wird das Dialogfeld "ManageLicenses" (Abbildung unten) aufgerufen.



Beachten Sie zu den im Dialogfeld "Manage Licenses" angezeigten Lizenzen die folgendenPunkte:

Das zu lizenzierende Produkt wird links oben im Dialogfeld angeführt. In der Abbildungoben ist dies Altova RaptorXML+XBRL Server.Als nächstes ist der Rechner, auf dem der Server installiert ist, aufgelistet (in derAbbildung oben doc-aab.Im Dialogfeld werden alle derzeit aktiven Lizenzen für dieses Produkt im Lizenzpoolangezeigt. In unserer Abbildung befindet sich eine derzeit aktive RaptorXML+XBRLServer-Lizenz im Lizenzpool. (LicenseServer erkennt automatisch anhand jeder Lizenz imPool, für welches Altova-Produkt sie ausgestellt wurde).Der Lizenztyp kann entweder Cores (Kerne) sein (alle Altova Server-Produkteeinschließlich MobileTogether Server) oder Users (Benutzer) (nur MobileTogether Server).Der Lizenztyp wird in der Spalte License Type angezeigt. Die Lizenz in der Abbildung oben gilt für 16 CPU-Kerne.Sie müssen die Anzahl der Prozessorkerne auf dem Server, auf dem das Altova Server-Produkt installiert wurde, kennen. Wenn der Rechner einen Dual-Core-Prozessor hat,benötigen Sie eine Lizenz für 2 Kerne (Anzahl der CPU-Kerne). Wie viele Kerne für dasregistrierte Server-Produkt erforderlich sind, ist unterhalb des Rechnernamens aufgelistet.Die Lizenz, die Sie diesem Server zuweisen, muss für genügend Kerne gültig sein. Siekönnen Lizenzen auch kombinieren, um die erforderliche Anzahl an Prozessorkernen zuerreichen. Wenn der Rechner z.B. einen Octa-Core-Prozessor hat (acht Kerne), könnenSie zwei Lizenzen für 4 Kerne kombinieren.Im Dialogfeld "Edit Assigned Licenses" werden nur aktive Lizenzen für dieses Produktaufgelistet. Lizenzen für andere Altova-Produkte werden nicht aufgelistet.Lizenzen, die bereits z.B. einer anderen Installation dieses Produkts im Netzwerkzugewiesen wurden, sind mit einem Häkchen versehen. Nur freie Lizenzen, die mitkeinem Häkchen versehen sind, können ausgewählt werden.In der Spalte CPU Cores (oder # for MobileTogether Server users) wird angegeben, für wieviele CPU-Kerne (oder MobileTogether Clients) eine Lizenz gültig ist.Wenn Sie am Lizenzpool Änderungen vornehmen möchten, z.B. um eine Lizenz zuladen, zu aktivieren, zu deaktivieren oder zu löschen, klicken Sie auf die Schaltfläche Goto License Pool.

© 2017 Altova GmbH



Wählen Sie die gewünschte Lizenz aus. Die Lizenz wird mit einem Häkchen versehen. DieGesamtanzahl der CPU-Kerne, für die diese Lizenz für dieses Produkt auf diesem Client gültig ist,wird im linken oberen Bereich des Dialogfelds als Max licensed CPU cores aufgelistet (sieheAbbildung oben). Sie können mehr Lizenzen auswählen, wenn das installierte Produkt auf diesemClient für mehr CPU-Kerne lizenziert werden soll. In diesem Fall wird unter Max licensed CPUcores die Summe aller CPU-Kerne aller ausgewählten Lizenzen angegeben.

Klicken Sie nach Auswahl der Lizenz(en) auf Apply Changes. Daraufhin wird/werden dieLizenz(en) diesem Produkt zugewiesen und auf dem Register "Client Management" angezeigt(siehe Abbildung unten). In der Abbildung sehen Sie, dass dem Client-Rechner eine 16-CPU-Kern-Lizenz für Altova RaptorXML+XBRL zugewiesen wurde.

Aufheben der Registrierung für ProdukteJedes auf LicenseServer registrierte Altova-Produkt wird im rechten Bereich (Product licensing)unter dem Namen seines Client-Rechners aufgelistet. Unterhalb des Eintrags befindet sich dieSchaltfläche Unregister (siehe Abbildung oben). Klicken Sie darauf, um die Registrierung für dasProdukt aufzuheben. Wenn dem Produkt eine Lizenz zugewiesen wurde, wird die Zuweisungbeendet, sobald die Registrierung für das Produkt aufgehoben wird. Um die Registrierung für alleProdukte aufzuheben, klicken Sie im rechten Bereich ganz oben (siehe erste Abbildung indiesem Abschnitt) auf die Schaltfläche Unregister client and all products.

Um ein Produkt erneut zu registrieren, gehen Sie gehen Sie folgendermaßen vor:

Server-Produkte: Gehen Sie auf der Web-Oberfläche des Server-Produkts zur Seite"Einstellungen". Wenn das Server-Produkt keine Web-Oberfläche hat, öffnen Sie einBefehlszeilenfenster und verwenden Sie die Befehlszeilenschnittstelle des Produkts, umes zu registrieren. Die Schritte für die einzelnen Server-Produkte sind in den folgendenKapiteln beschrieben: Registrieren von FlowForce Server, Registrieren von MapForceServer, Registrieren von MobileTogether Server, Registrieren von StyleVision Server undRegistrieren von RaptorXML(+XBRL) Server.



Desktop-Produkte: Öffnen Sie das Dialogfeld "Software-Aktivierung" des Produkts (Hilfe |Software-Aktivierung), wechseln Sie in den Modus zur Aktivierung über LicenseServerund wählen Sie im Feld Altova LicenseServer den LicenseServer aus, auf dem Sie dasProdukt registrieren möchten. Das Produkt wird registriert und auf dem Register "ClientManagement" von LicenseServer in der Liste der registrierten Produkte dieses Clientangezeigt.

© 2017 Altova GmbH



1.7.7 Referenz zur Konfigurationsseite

Die LicenseServer-Konfigurationsseite ist die Administratorschnittstelle zu LicenseServer (Web-Benutzeroberfläche). Sie dient zum Verwalten von LicenseServer und zum Lizenzieren von Altova-Produkten, die auf dem LicenseServer registriert wurden. Die LicenseServer-Konfigurationsseitewird über einen Webbrowser aufgerufen. Eine Beschreibung, wie Sie die Konfigurationsseiteaufrufen, finden Sie in den Abschnitten Öffnen der LicenseServer-Konfigurationsseite (Windows),Öffnen der LicenseServer-Konfigurationsseite (Linux) und Öffnen der LicenseServer-Konfigurationsseite (Mac OS X).

Dieser Abschnitt ist eine Benutzerreferenz zur Konfigurationsseite und ist nach den Registern derKonfigurationsseite gegliedert:

License Pool Client Management Client Monitoring Settings Messages, Log Out

Eine schrittweise Anleitung zum Zuweisen von Lizenzen über LicenseServer finden Sie imAbschnitt Zuweisen von Lizenzen.

License Pool


Laden einer LizenzLizenzstatusAktivieren, Deaktivieren und Löschen einer LizenzSymbole auf dem Register "License Pool" LizenzinformationenAnmerkung zu Desktop-ProduktlizenzenAnmerkung zu Prozessorkernen und Lizenzen

Auf dem Register License Pool werden Informationen über alle derzeit auf dem LicenseSerververfügbaren Lizenzen angezeigt (siehe Abbildung unten). Wenn eine Lizenzdatei über dieSchaltfläche Upload auf dieser Seite in LicenseServer geladen wird, werden alle in dieserLizenzdatei enthaltenen Lizenzen in den Lizenzpool auf dem Server aufgenommen. Die Seite"License Pool" zeigt somit einen Überblick über alle derzeit auf LicenseServer verfügbarenLizenzen zusammen mit den Informationen zu den einzelnen Lizenzen. Neben der MöglichkeitLizenzen auf dieser Seite hochzuladen, haben Sie auf dieser Seite auch die Möglichkeit,ausgewählte Lizenzen zu aktivieren, zu deaktivieren und zu löschen.



Laden einer LizenzUm eine Lizenzdatei (eine .altova_licenses-Datei, die Sie von der Altova GmbH für Ihr Altova-

Produkt erhalten haben), zu laden, klicken Sie auf die Schaltfläche Browse, navigieren Sie zurLizenzdatei und wählen Sie sie aus. Sobald Sie auf Upload klicken, werden alle in derLizenzdatei enthaltenen Lizenzen in den Lizenzpool platziert und auf der Seite "LicensePool" (Abbildung oben) angezeigt. Neu hochgeladene Lizenzen werden automatisch aktiviert undihr Status wird auf Active gesetzt.

LizenzstatusEs gibt die folgenden Lizenzstatuswerte:

Activating: Nachdem eine Lizenz in den Lizenzpool von LicenseServer hochgeladenwurde, werden die Lizenzdaten dazu zur Überprüfung, Authentifizierung und Aktivierungder geladenen Lizenz an den Master Licensing Server unter altova.com weitergeleitet,um die Einhaltung des Altova Lizenzvertrags zu überwachen. Währenddessen - die Dauerkann je nach Verbindung und Netzwerkverkehr zwischen 30 Sekunden und einigenMinuten variieren - wird der Status als Activating....angezeigt.

Failed Verification: Falls keine Verbindung zum Master Licensing Server unteraltova.com hergestellt werden konnte, wird der Status der Lizenz im Pool als FailedVerification angezeigt. Überprüfen Sie in diesem Fall Ihre Internetverbindung und dieFirewall-Einstellungen, um sicherzustellen, dass LicenseServer eine Verbindung zumMaster Licensing Server unter altova.com herstellen kann.

Active: Sobald die Lizenz authentifiziert und aktiviert wurde, ändert sich der Status inActive.

© 2017 Altova GmbH



Inactive: Wenn eine Lizenz überprüft wurde, aber auf einem anderen LicenseServer imNetzwerk vorhanden ist, wird der Status als Inactive angezeigt. Der Status Inactive kannauch zustande kommen, wenn eine Lizenz im Lizenzpool vom Administrator manuelldeaktiviert wurde.

Pending: Wenn eine Lizenz erst ab einem Datum in der Zukunft gültig ist, so wird dieLizenz als Pending angezeigt. Am ersten Gültigkeitstag ändert sich der Status in Active.Eine schwebende (pending) Lizenz wird einem Produkt zugewiesen, und dient dazu zugewährleisten, dass ein Produkt ohne Unterbrechung verwendet werden kann, bevor einevorhandene Lizenz abläuft. (Einem Produkt können gleichzeitig zwei aktive Lizenzenzugewiesen sein.)

Blocked: Eine Lizenz erscheint im Lizenzpool als Blocked, wenn es ein Problem mit derAuthentifizierung der Lizenz gab und der Master License Server unter altova.com dieVerwendung der Lizenz nicht gestattet. Dies kann der Fall sein, wenn der Lizenzvertragnicht eingehalten wurde, zu viele Lizenzen verwendet werden oder andereLizenzverletzungen festgestellt wurden. Wird eine Lizenz mit dem Status Blockedangezeigt, wenden Sie sich bitte mit Ihren Lizenzdaten und anderen relevanten Daten anden Altova Support.

Eine Übersicht über die Statuswerte finden Sie in der folgenden Tabelle:

Status Bedeutung

Activating... Nach dem Laden werden die Lizenzdaten zur Überprüfung an altova.comgesendet. Aktualisieren Sie den Browser, um den aktualisierten Status zusehen. Die Überprüfung und Aktivierung kann einige Minuten dauern.

Failed Verification Es konnte keine Verbindung zu altova.com hergestellt werden. Nachdemeine Verbindung hergestellt wurde, starten Sie den Dienst entweder neuoder aktivieren Sie die Lizenz (über die Schaltfläche Activate).

Active Die Überprüfung war erfolgreich, die Lizenz ist aktiv.

Inactive Die Überprüfung war erfolgreich, aber die Lizenz befindet sich auch aufeinem anderen LicenseServer im Netzwerk. Lizenzen können über dieSchaltfläche Deactivate deaktiviert werden.

Pending Eine Lizenz mit dem Status Pending (schwebend) hat ihr Beginndatum inder Zukunft. Ab dem Beginndatum ändert sich ihr Status in Active. Siekann einem Produkt zugewiesen werden und gewährleistet, dass dieLizenzierung eines Produkts noch vor dem Ablauf der alten Lizenzautomatisch verlängert wird.

Blocked Die Überprüfung war negativ. Die Lizenz ist ungültig und wurde blockiert.Wenden Sie sich an den Altova Support

Anmerkung: Nachdem die Lizenz zur Überprüfung an altova.com gesendet wurde, muss derBrowser aktualisiert werden, damit Sie den aktualisierten Status sehen. Die Überprüfungund Aktivierung kann einige Minuten dauern.

Anmerkung: Falls keine Verbindung zu altova.com hergestellt werden konnte, wird derStatus als Failed Verification angezeigt. Nachdem eine Verbindung hergestellt wurde,




starten Sie den Dienst entweder neu oder versuchen Sie, die Lizenz (über dieSchaltfläche Activate) zu aktivieren.

Anmerkung: Wenn eine Lizenz den Status Inactive oder Blocked erhält, wird eine Meldungmit einer Erklärung dazu zum Meldungs-Log hinzugefügt.

Nur eine aktive oder schwebende (pending) Lizenz kann einem Produkt zugewiesen werden. Eineinaktive Lizenz kann aktiviert oder aus dem Lizenzpool gelöscht werden. Wenn eine Lizenz ausdem Lizenzpool gelöscht wurde, kann sie erneut durch Laden der darin enthaltenen Lizenzdatei inden Pool geladen werden. Wenn eine Lizenzdatei aktualisiert wird, werden nur die Lizenzen darin,die sich noch nicht im Pool befinden, in den Pool geladen. Um eine Lizenz zu aktivieren, zudeaktivieren oder zu löschen, wählen Sie sie aus und klicken Sie auf die Schaltfläche Activate,Deactivate bzw. Delete.



Aktivieren, Deaktivieren und Löschen einer LizenzEine aktive Lizenz kann durch Auswahl der Lizenz und Klicken auf Deactivate deaktiviert werden.Eine inaktive Lizenz kann aktiviert (Schaltfläche Activate) oder gelöscht (Schaltfläche Delete)werden. Wenn eine Lizenz gelöscht wird, wird sie aus dem Lizenzpool entfernt. Eine gelöschteLizenz kann durch Laden der Lizenzdatei, die sie enthält, wieder zum Lizenzpool hinzugefügtwerden. Wenn eine Lizenzdatei erneut hochgeladen wird, werden nur Lizenzen, die sich nochnicht im Lizenzpool befinden, zum Lizenzpool hinzugefügt; Lizenzen, die sich bereits im Poolbefinden, werden nicht erneut hinzugefügt.

Symbole auf dem Register "License Pool"

Altova MissionKit-Logo. Wird neben einzelnen Altova Desktop-Produktnamen angezeigt,wenn die Desktop-Lizenz Teil einer MissionKit-Lizenz ist. Siehe Anmerkung zuDesktop-Produkten weiter unten.

© 2017 Altova GmbH



Show Assigned Client. Wird in der Spalte "Clients" einer zugewiesenen Lizenzangezeigt. Ruft das Register Client Management auf, auf dem Sie die Lizenzen derregistrierten Produkte eines Client verwalten können.

Show Running Client. Wird in der Spalte "Clients" einer Lizenz, die einer derzeitausgeführten Software zugewiesen wurde, angezeigt. Ruft das Register ClientMonitoring des Client-Rechners auf, auf dem die Software ausgeführt wird. Hier werdenInformationen zum ausgewählten Client und seiner registrierten Software angezeigt.

Show Info. Wird in der Spalte Clients einer noch nicht zugewiesenen Lizenz angezeigt.Hier werden Informationen zur Lizenz, wie Benutzeranzahl oder ob die Lizenz Teil einesLizenzpakets ist, angezeigt.

LizenzinformationenEs werden die folgenden Informationen zur Lizenz angezeigt:

Status: Es gibt die folgenden Werte: Activating | Failed Verification | Active | Inactive |Blocked. Siehe Lizenzstatus oben.Name, Company: Der Name und die Firma, die auf der Lizenz eingetragen sind. DieseInformationen wurden zum Zeitpunkt des Kaufs übermittelt.Product, Edition, Version: Die Version und Edition des lizenzierten Produkts. Am oberenRand jeder Spalte befindet sich eine Auswahlliste zum Filtern von Lizenzen nachKategorie.Key Code, Bundle ID: Der Lizenzschlüssel, mit dem das Produkt aktiviert wird. AlleProdukte in einem einzigen MissionKit-Paket haben dieselbe Bundle ID. Nicht gebündelteProdukte haben keine Bundle ID.Start Date, End Date: Geben den Gültigkeitszeitraum der Lizenz an. PermanenteLizenzen haben kein Enddatum.Expires in days, SMP (days left): Die Anzahl der verbleibenden Tage bis zum Ablauf derLizenz. Jedes lizenzierte Produkt wird mit einem Support- und Wartungspaket (SMP),das eine bestimmte Anzahl von Tagen gültig ist, geliefert. In der Spalte SMP wirdangegeben, wie lange das SMP noch gültig ist.#, License Type: Die Anzahl der Benutzer oder CPU-Kerne, für die die Lizenz ausgestelltwurde, wird in der Spalte # aufgelistet. Ob es sich um Benutzer oder Kerne handelt, fürdie die Lizenz ausgestellt wurde, wird in der Spalte License Type angegeben. Im Fall desAltova-Produkts MobileTogether Server werden die Lizenzen auch auf Basis der Anzahlder MobileTogether Client-Geräten, die mit MobileTogether Server verbunden werden,zugewiesen. Im Fall aller anderen Altova Server-Produkte werden die Lizenzen nur aufBasis der CPU-Kerne zugewiesen (siehe Anmerkung unten). Im Fall von Altova Desktop-Produkten werden Lizenzen auf Basis der Anzahl der Benutzer zugewiesen. SieheAnmerkung zu Desktop-Produktlizenzen weiter unten.Clients: Diese Spalte enthält nur Einträge für MobileTogether Server-Lizenzen undDesktop-Produktlizenzen. Sie enthält keine Einträge für Server-Produktlizenzen. FürMobileTogether Server-Gerätelizenzen wird in dieser Spalte angezeigt, ob die Lizenzzugewiesen wurde. Für Desktop-Produkte wird in dieser Spalte die Anzahl der Rechnerund Benutzer angezeigt (Beschreibung siehe unten).

Desktop-Produkte: Rechner- und BenutzeranzahlUnter machine count (Rechneranzahl) wird die Anzahl der Rechner angegeben, denenderzeit eine Lizenz zum Ausführen der Software mit einer bestimmten Lizenz zugewiesen



ist. So bedeutet z.B. 7/10 machines, dass die Lizenz für Software-Instanzen auf 10Rechnern verwendet werden kann und dass die Lizenz derzeit für Software-Instanzen auf7 Rechnern verwendet wird. Klicken Sie auf die Schaltfläche Show Assigned Client, umzum Register Client Management zu gelangen und die Informationen zu der/denLizenz(en) des Client-Rechners zu sehen.Unter user count (Benutzeranzahl) wird angegeben wie viele der insgesamt zugelassenenBenutzer im Moment eine Lizenz in Anspruch nehmen. Es werden nur lizenzierteSoftware-Installationen gezählt, die gerade ausgeführt werden. 3/10 users bedeutetetwa, dass die Lizenz derzeit von 3 von insgesamt 10 zugelassenen Benutzern inAnspruch genommen wird. Wenn gerade eine lizenzierte Software-Installation ausgeführtwird, können Sie auf die Schaltfläche Show Running Client klicken, um zum Register"Client Monitoring" zu gelangen und die Informationen zu Altova-Produkten, die auf Client-Rechnern im Netzwerk ausgeführt werden, zu sehen.user count und machine count zusammen geben Auskunft über die aktuelleLizenzkapazität und die Verwendung einer bestimmten Lizenz. Wenn die Rechneranzahl(machine count) einer installierten Benutzerlizenz 7/10 beträgt und die Benutzeranzahl(user count) 3/10, wissen wir, dass (i) die Produkt-Software für 10 Rechner lizenziertwurde, (ii) dass die Software auf 7 Rechnern lizenziert wurde, (iii) dass sich 3 der 7lizenzierten Software-Installationen derzeit in Ausführung befinden.

Aufheben der Zuweisung einer LizenzUm die Lizenzzuweisung einer Software-Installation auf einem Rechner aufzuheben, gehen Siezum Register Client Management. Wählen Sie den Rechner und anschließend die Software aus,deren Lizenzzuweisung aufgehoben werden soll. Klicken Sie anschließend auf die Schaltfläche Edit Assigned Licenses, heben Sie die Auswahl der Lizenz auf und klicken Sie auf ApplyChanges.

Anmerkung zu Desktop-ProduktlizenzenEs gibt drei Arten von Desktop-Benutzerlizenzen:

Installed User (Installierte Benutzer): Die Lizenzen werden für eine genau definierteAnzahl von Computern erworben, auf denen die Software installiert werden soll. Wenn Siez.B. eine 10-Installed-User-Lizenz erwerben, dürfen Sie die Software auf bis zu 10Computern installieren und verwenden. Sie können auf jedem lizenzierten Rechnerbeliebig viele gleichzeitig ausgeführte Software-Instanzen starten. Die Lizenz für jeden"installierten Benutzer" gestattet die Verwendung des Software-Produkts auf diesemRechner.Concurrent User (Parallellizenz): Mit dieser Lizenz dürfen Sie die Software auf bis zu 10mal so vielen Computern installieren, wie sie für Parallelbenutzer lizenziert ist. AlleInstallationen müssen sich im selben physischen Netzwerk befinden. Die Software darfdabei immer nur von der maximal zulässigen Anzahl von Parallelbenutzern gleichzeitigverwendet werden. Wenn Sie z.B. eine Parallellizenz für 20 Benutzer erwerben (20-Concurrent-User-Lizenz), darf die Software auf bis zu 200 Computern im selbenphysischen Netzwerk installiert werden und auf bis zu 20 Computern gleichzeitigverwendet werden. Wenn Sie Parallellizenzen in verschiedenen physischen Netzwerkenverwenden möchten, müssen Sie eine separate Lizenz für jedes Netzwerk erwerben.Beachten Sie, dass Sie nicht eine einzige Parallellizenz für mehrere Netzwerkeverwenden können.Named User (Benannter Benutzer): Sie dürfen die Software für jede Named-User-Lizenzauf bis zu 5 Computern installieren. Die Software darf jedoch nur von dem in der Lizenz

© 2017 Altova GmbH



genannten Benutzer verwendet werden. Mit dieser Lizenz kann ein Benutzer aufverschiedenen Computern arbeiten, vorausgesetzt es wird immer nur eine Instanz derSoftware gleichzeitig verwendet.

Anmerkung zu Altova MissionKit-LizenzenAltova MissionKit ist ein Paket von Altova Desktop-Produkten. Eine Altova MissionKit-Lizenzbesteht aus Einzellizenzen für die einzelnen Desktop-Produkte im MissionKit-Paket. Jede dieserProduktlizenzen hat einen anderen eindeutigen Keycode, aber dieselbe MissionKit Bundle ID.Wenn Sie eine Altova MissionKit-Lizenz in den Lizenzpool hochladen, so werden die einzelnenLizenzen für jedes Produkt des MissionKit im Lizenzpool aufgelistet (daneben wird das AltovaMissionKit Logo angezeigt). Wenn Sie einem bestimmten Benutzer eine dieser Produktlizenzenzuweisen, so werden diesem Benutzer auch die Lizenzen für alle anderen Produkte diesesMissionKit-Pakets zugewiesen. Folglich kann kein anderes Produkt in diesem MissionKit-Paketeinem anderen Benutzer zugewiesen werden.

Lizenz-Check-OutsÜber den Lizenzpool können Sie eine Lizenz für einen Zeitraum von bis zu 30 Tagen auschecken,sodass die Lizenz auf dem lokalen Rechner gespeichert wird. Dadurch können Sie offlinearbeiten, was nützlich ist, wenn Sie z.B. in einer Umgebung arbeiten möchten, in der Sie keinenZugriff auf Ihren Altova LicenseServer haben (z.B. wenn Ihr Altova-Produkt auf einem Laptopinstalliert ist und Sie gerade unterwegs sind). Solange die Lizenz ausgecheckt ist, zeigtLicenseServer die Lizenz als in Verwendung an. Diese Lizenz kann dann von keinem anderenRechner verwendet werden. Die Lizenz wird nach Ablauf des Check-Out-Zeitraums automatischwieder eingecheckt. Alternativ dazu kann eine ausgecheckte Lizenz jederzeit über dieSchaltfläche Einchecken des Dialogfelds "Software-Aktivierung" wieder eingecheckt werden. Umeine Lizenz über den Lizenzpool Ihres Produktrechners auszuchecken, gehen Sie zum Menü Hilfe Ihres Altova Desktop-Produkts und wählen Sie den Befehl Software-Aktivierung. NähereInformationen finden Sie im Benutzerhandbuch zu Ihrem Altova-Produkt.



Anmerkung: Jede Altova Server-Produktlizenz kann immer nur für einen Client-Rechnergleichzeitig verwendet werden, selbst wenn die Lizenzkapazität dieser Lizenz noch nicht

http://www.altova.com/missionkit.html



ausgeschöpft ist. Wenn z.B. eine 10-Kern-Lizenz für einen Client-Rechner mit 6 CPU-Kernen verwendet wird, so können die verbleibenden Lizenzen für die restlichen 4 Kernenicht gleichzeitig für einen anderen Client-Rechner verwendet werden.


Client Management


Symbole auf dem Register "Client Management" Verwalten von Lizenzen im Bereich "Product Licensing"Zuweisen von Lizenzen Single Thread-AusführungEin einziger Client, der unter verschiedenen Namen registriert ist Anfordern einer Testlizenz Aufheben der Registrierung für Produkte

Das Register Client Management (Abbildung unten) besteht aus zwei Bereichen:

Registered Clients: Im Bereich auf der linken Seite sehen Sie eine tabellarische Liste vonRechnern im Netzwerk, auf denen mindestens ein Altova-Produkt, das auf LicenseServer

© 2017 Altova GmbH



registriert ist installiert ist. Solche Rechner werden als registrierte Clients bezeichnet.Jeder registrierte Client wird im linken Bereich mit allen seinen registrierten Produktenaufgelistet. Unter Registrieren von Produkten wird beschrieben, wie Sie Produkte aufLicenseServer registrieren. Die Anzeige in diesem Bereich kann durch Auswahl oderEingabe eines Filters am oberen Rand der Spalte gefiltert werden.Product Licensing: Dies ist der Bereich auf der rechten Seite. Wenn ein registrierterClient im Bereich auf der linken Seite (Registered Clients) ausgewählt wird, so werden dieLizenzinformationen der registrierten Produkte dieses Client im Bereich auf der rechtenSeite angezeigt. Hier können Sie die Lizenzierung der einzelnen registrierten Produkteverwalten (Beschreibung siehe unten).

Symbole auf dem Register "Client Management"

Edit Assigned Licenses. (Zugewiesene Lizenzen bearbeiten) Steht für jedes Produkt zurVerfügung. Ruft das Dialogfeld "Edit Assigned Licenses" auf, in dem neue Lizenzenzugewiesen und bereits zugewiesene bearbeitet werden können.

Show Licenses. (Lizenzen anzeigen) Wird zu jeder Lizenz angezeigt. Damit wechselnSie zum Register "License Pool", wo die ausgewählte Lizenz markiert wird, damit Siedie Lizenzinformationen lesen können.

Unregister Product. (Registrierung für Produkt aufheben). Die Registrierung desausgewählten Produkts (auf dem ausgewählten Client-Rechner) wird beim LicenseServeraufgehoben. Siehe Aufhebung der Registrierung von Produkten weiter unten. Um dieRegistrierung für einen Client und all seine Produkte aufzuheben, klicken Sie am oberenRand des Bereichs auf Unregister client and all products.

Verwalten von Lizenzen im Bereich "Product Licensing"Im Bereich Product Licensing auf der rechten Seite haben Sie folgende Möglichkeiten:

Zuweisen der Lizenz eines Produkts, Aufheben der Zuweisung, Ändern der Lizenz einesProdukts: Klicken Sie dazu auf die Schaltfläche Edit Assigned Licenses für dasjeweilige Produkt. Siehe Zuweisen von Lizenzen weiter unten. Beachten Sie, dass es zujedem Server-Produkt eine Zeile gibt, in der angegeben ist, wie viele CPU-Kerne lizenziertwerden müssen, damit das Produkt auf diesem Client ausgeführt werden kann. Wenn dieAnzahl der lizenzierten Kerne geringer ist als die erforderliche Anzahl, so erscheint dieseInformation rot markiert. (Die Anzahl der zu lizenzierenden CPU-Kerne ist die Anzahl derCPU-Kerne auf diesem Client und wird von LicenseServer vom Client-Rechner abgerufen.)Einrichten einer Server-Produktlizenz für einen einzigen Kern, sodass nur ein Kern aufdem Client genutzt wird: Siehe Single-Thread-Ausführung weiter unten.Aufheben der Registrierung eines Produkts auf LicenseServer: Klicken Sie dazu auf dieSchaltfläche Unregister Product für das jeweilige Produkt. Siehe Aufhebung derRegistrierung von Produkten weiter unten.

Zuweisen von Lizenzen



Um einem registrierten Produkt eine Lizenz zuzuweisen, klicken Sie auf die Schaltfläche EditAssigned Licenses für dieses Produkt. Daraufhin wird das Dialogfeld "Edit AssignedLicenses" (Abbildung unten) angezeigt.

Wählen Sie die gewünschte(n) Lizenz(en) aus und klicken Sie anschließend auf Apply Changes.Die Lizenz(en) wird/werden diesem Produkt zugewiesen und auf dem Register Product licensingdes Registers "Client Management" angezeigt (siehe Abbildung unten).

Single-Thread-AusführungWenn im Lizenzpool eine Altova Serverproduktlizenz für nur einen Prozessorkern verfügbar

© 2017 Altova GmbH



ist, können Sie einem Rechner mit mehreren Kernen diese Lizenz für einen Kern zuweisen.In diesem Fall führt der Rechner das Produkt an einem einzigen Kern aus. Dadurchverlangsamt sich die Verarbeitungsgeschwindigkeit, da kein Multi-Threading (welches beimehreren Prozessorkernen möglich wäre) zur Verfügung steht. Das Produkt wird auf diesemRechner im Single Thread-Modus ausgeführt.

Um einem Mehrkernrechner eine Lizenz für nur einen Kern zuzuweisen, aktivieren Sie für dasentsprechende Produkt das Kontrollkästchen Limit to single thread execution.

Wenn im Fall von MobileTogether Server (MTS) eine Single-Thread-Ausführung für eineMTS-Kernlizenz ausgewählt ist, so kann immer nur ein Mobilgerät mit dem MobileTogetherServer verbunden werden. Wenn in diesem Fall ein zweites Gerät mit MobileTogether Seververbunden wird, so übernimmt dieses die Lizenz. Das erste Gerät kann daraufhin keineVerbindung mehr herstellen und erhält eine entsprechende Fehlermeldung.

Ein einziger Client, der unter verschiedenen Namen registriert istWenn ein Client-Rechner mehr als einmal auf dem LicenseServer registriert wurde, wird er unterUmständen auf dem Register "Client Management" in Form mehrerer Einträge unter mehrerenNamen aufgelistet. Dies kann z.B. vorkommen, wenn ein Rechner mit dem Host-Namen in eineranderen Form erneut registriert wurde.

Um sicherzustellen, dass demselben unter unterschiedlichen Namen registrierten Rechner nichtmehrere Lizenzen zugewiesen werden, sollten Sie die Registrierung für überflüssige Client-Rechner-Einträge aufheben. Klicken Sie dazu im rechten Bereich (Product licensing) ganz obenauf die Schaltfläche Unregister client and all products. Außerdem kann es zu Lizenzkonfliktenkommen, wenn dieselbe Lizenz demselben Rechner unter seinen verschiedenen Namenmehrmals zugewiesen ist. Um diese beiden Situationen zu vermeiden (überflüssige Lizenzen undMehrfachzuweisungen einer einzigen Lizenz), wird empfohlen, überzählige Registrierungen eineseinzigen Client-Rechners zu entfernen.

Im Folgenden sehen Sie, in welcher Form ein Rechnername auf dem Register "ClientManagement" aufgelistet werden kann:

Host-Name mit Domänenname (der vollqualifizierte Domänenname FQDN) wie z.B.:"win80-x64_1.my.domain.com" oder "Doc3.my.domain.com". Der Name wird in dieserForm aufgeführt, wenn der Host-Name des Rechners (mit oder ohne die Domänendaten)als Argument des CLI-Befehls licenseserver, mit dem das Serverprodukt auf demLicenseServer registriert wird, übergeben wird. Beispiel: <AltovaServerProduct>

licenseserver Doc3. Dabei wird ein FQDN wie z.B. der folgende erzeugt:Doc3.my.domain.com.

Ein FQDN wird auch erzeugt, wenn auf Windows 7 und 10-Systemen localhost alsHost-Name angegeben wird..

Host-Name ohne Domänenname. Beispiel: "win80-x64_1" oder "Doc3". In dieser Formwird der Name auf Windows 8-Systemen angeführt, wenn als Rechnername localhostverwendet wird..



localhost. In manchen Fällen wird auch localhost als Rechnername angezeigt.

Anmerkung: Wenn ein Rechner bei Installation eines Altova-Server-Produkts auf Windows-Rechnern automatisch auf dem LicenseServer registriert wird, verwendet dasInstallationsprogramm localhost als Rechnernamen.

Anfordern einer TestlizenzSie können für jedes der auf dem LicenseServer registrierten Altova-Produkte eine kostenlose 30-Tage-Testlizenz anfordern. Klicken Sie dazu am oberen Rand des Bereichs auf der rechten Seite(Product licensing) auf die Schaltfläche Request Evaluation Licenses. Daraufhin wird einDialogfeld mit einer Liste der auf dem LicenseServer registrierten Altova-Produkte (auf diesemClient-Rechner) angezeigt. Versehen Sie die Produkte, für die Sie eine Testlizenz anfordernmöchten, mit einem Häkchen, füllen Sie anschließend die Registrierungsfelder aus und sendenSie die Anfrage ab. Sie erhalten daraufhin eine E-Mail mit der/den 30-Tage-Testlizenzen vonAltova. Bei Server-Produkten entspricht die Anzahl der Prozessorkerne, für die die Lizenz proProdukt gültig ist, genau der Anzahl der für das zum Zeitpunkt der Anforderung für das Produktbenötigten. Speichern Sie die Lizenz(en) und laden Sie sie in den Lizenzpool.

Aufheben der Registrierung für ProdukteJedes auf dem LicenseServer registrierte Altova-Produkt wird im rechten Bereich (Productlicensing) unter dem Namen seines Client-Rechners aufgelistet. Unterhalb davon befindet sicheine Unregister Product-Schaltfläche. Klicken Sie darauf, um die Registrierung für das Produktauf LicenseServer aufzuheben. Wenn dem Produkt eine Lizenz zugewiesen wurde, wird dieZuweisung beendet, sobald die Registrierung für das Produkt aufgehoben wird. Um dieRegistrierung für alle Produkte aufzuheben, klicken Sie im rechten Bereich (Product licensing)ganz oben auf die Schaltfläche Unregister client and all Products (siehe erste Abbildung indiesem Abschnitt).

Um ein Produkt erneut zu registrieren, gehen Sie gehen Sie folgendermaßen vor:

Server-Produkte: Gehen Sie auf der Web-Oberfläche des Server-Produkts zur Seite"Einstellungen". Wenn das Server-Produkt keine Web-Oberfläche hat, öffnen Sie einBefehlszeilenfenster und verwenden Sie die Befehlszeilenschnittstelle des Produkts, umes zu registrieren. Die Schritte für die einzelnen Server-Produkte sind in den folgendenKapiteln beschrieben: Registrieren von FlowForce Server, Registrieren von MapForceServer, Registrieren von MobileTogether Server, Registrieren von StyleVision Server undRegistrieren von RaptorXML(+XBRL) Server.Desktop-Produkte: Öffnen Sie das Dialogfeld "Software-Aktivierung" des Produkts (Hilfe |Software-Aktivierung), wechseln Sie in den Modus zur Aktivierung über LicenseServerund wählen Sie im Feld Altova LicenseServer den LicenseServer aus, auf dem Sie dasProdukt registrieren möchten. Das Produkt wird registriert und auf dem Register "ClientManagement" von LicenseServer in der Liste der registrierten Produkte dieses Clientangezeigt.

Nähere Informationen dazu finden Sie im Abschnitt Zuweisen von Lizenzen zu registrierten

© 2017 Altova GmbH



Produkten.

Client Monitoring

Das Register Client Monitoring enthält eine Übersicht über den ausgewählten Client-Rechner.Sie sehen darauf eine Liste der derzeit auf dem Client ausgeführten Altova-Produkte.

Checked-out ClientsEndbenutzer eines Altova Desktop-Produkts (nicht eines Server-Produkts), wie z.B. XMLSpy oderMapForce, können eine auf LicenseServer registrierte Lizenz auschecken. Normalerweise gilt diesfür Situationen, in denen absehbar ist, dass der Rechner des Endbenutzers eine Zeit lang offlinesein wird. Die Lizenz kann für den Zeitraum, während dessen der Rechner offline sein wird, vomLicenseServer ausgecheckt werden. Während dieser Zeit kann der Endbenutzer auch ohneKontakt zum LicenseServer mit dem Altova Desktop-Produkt weiterarbeiten. Die derzeitausgecheckten Lizenzen und Benutzer sowie die Check-out-Periode werden unter dieserÜberschrift aufgelistet.

Anmerkung: Der Lizenz-Check-out wird vom Endbenutzer über das Dialogfeld "Software-Aktivierung" (Hilfe | Software-Aktivierung) des jeweiligen Altova Desktop-Produktsvorgenommen.

Running clientsWenn mehrere Instanzen eines Produkts ausgeführt werden, so wird jede dieser Instanzenaufgelistet.

Anmerkung: Failover LicenseServer arbeiten mit Client-Applikationen ab Version 2015r3 (bzw.im Fall von Altova MobileTogether Server mit Version 1.5 oder höher) ; ältere Clientswerden markiert angezeigt.

Anmerkung: Wenn eine Lizenz für ein Desktop-Produkt ausgecheckt wurde, so wird dies ineinem separaten Abschnitt Checked-out Clients des Registers "Client Monitoring"angezeigt. Die Lizenz wird als in Verwendung markiert und kann dadurch von keinemanderen Rechner im Netzwerk verwendet werden.

Symbole auf dem Register "Client Monitoring"

Show License(s). (Lizenzen anzeigen) Steht für jede Produktinstanz zur Verfügung.Damit gelangen Sie zum Register License Pool, auf dem die Lizenz der ausgewähltenProduktinstanz markiert erscheint.

Manage Client. (Client verwalten) Steht für jede Produktinstanz zur Verfügung. Damitgelangen Sie zum Register Client Management, auf dem der Client der ausgewähltenProduktinstanz markiert erscheint.



Settings


Failover LicenseServer-EinstellungenNetzwerkeinstellungenBenachrichtigungseinstellungenDiverse Einstellungen

Im Folgenden finden Sie eine Beschreibung des Registers Settings (Einstellungen). Daraufkönnen Sie die folgenden Einstellungen vornehmen:

eine Zeitspanne, die gewartet werden soll, bevor der LicenseServer beendetwird. Normalerweise muss der LicenseServer z.B. zu Server-Wartungszweckenabgeschaltet werden. Die Zeitspanne bis zum Shutdown kann genutzt werden, um Datenauf Clients, auf denen Altova Desktop-Produkte ausgeführt werden, zu speichern. Die vonIhnen ausgewählte Shutdown-Zeit ist die maximale Zeit, die bis zum Herunterfahrenverstreichen darf. LicenseServer wird beendet, sobald LicenseServer mit keinem Clientmehr verbunden ist, auf dem ein Desktop-Produkt ausgeführt wird. Der Countdownbeginnt, wenn Sie auf Shutdown klicken. Um den Vorgang abzubrechen, klicken Sie aufAbort Shutdown. Damit Clients auch während eines LicenseServer Shutdown weiterausgeführt werden können, konfigurieren Sie einen Failover LicenseServer.Sie können einen zweiten LicenseServer konfigurieren, der die Lizenzverwaltungübernehmen soll, wenn der primäre LicenseServer nicht zur Verfügung steht. Dieserzweite LicenseServer wird als Failover LicenseServer bezeichnet. Eine Anleitung, wieSie die Einstellungen dazu definieren, finden Sie hier. das Passwort, mit dem Sie sich auf dem LicenseServer einloggen. Geben Sie dasgewünschte Passwort ein und klicken Sie auf Change Password.Testen Sie die Verbindung durch Klicken auf Test Connection to Altova. Beachten Sie,dass neue Einstellungen vor Prüfen der Verbindung (durch Klicken auf die Schaltfläche Speichern) gespeichert werden müssen. Die Schaltfläche Test Connection to Altovaist während des Überprüfungsvorgangs deaktiviert und wird erst aktiv, sobald dieÜberprüfung beendet worden ist.die Netzwerkeinstellungen für die webbasierte Konfigurationsseite (Web UI), für einenetwaigen Proxy-Server, der für die Internetverbindung verwendet wird und für dieVerfügbarkeit von LicenseServer. Diese Einstellungen sind weiter unten unter Netzwerkeinstellungen beschrieben.Die E-Mail-Server-Einstellungen und die E-Mail-Adresse, an die bei Bedarf LicenseServer-Benachrichtigungen gesendet werden sollen. Diese Einstellungen sind weiter unten unter Benachrichtigungseinstellungen beschrieben.Nachdem Sie eine Einstellung geändert haben, kicken Sie am unteren Rand der Seiteauf Save. Beachten Sie, dass geänderte Einstellungen erst nach dem Speichern aktivwerden.

Failover LicenseServer-EinstellungenSie können einen zweiten LicenseServer konfigurieren, der einspringt, wenn der primäreLicenseServer nicht mehr zur Verfügung steht. Dieser zweite LicenseServer wird als Failover

© 2017 Altova GmbH



LicenseServer bezeichnet.

Um einen LicenseServer als Failover LicenseServer einzurichten, gehen Sie folgendermaßen vor:

1. Installieren Sie LicenseServer wie im Abschnitt "Installation" beschrieben.2. Aktivieren Sie den Modus Failover LicenseServer, indem Sie das entsprechende

Optionsfeld aktivieren (siehe Abbildung oben). (Standardmäßig ist der Modus PrimaryLicenseServer (primärer LicenseServer) eingestellt.)

3. Geben Sie im Dialogfeld "Find Primary LicenseServer", das daraufhin angezeigt wird(Abbildung unten), den primären LicenseServer ein, für den dieser Failover LicenseServerals Backup eingerichtet werden soll. Sie haben dazu zwei Möglichkeiten: (i) Klicken Sieauf Search for LicenseServers und wählen Sie anschließend in der Auswahlliste dengewünschten LicenseServer, für den ein Backup eingerichtet werden soll, aus der Listeder gefundenen LicenseServer aus; (ii) Klicken Sie auf Manually Enter Address undgeben Sie die Adresse des gewünschten LicenseServer manuell ein. Nachdem Sie denprimären LicenseServer eingegeben haben, klicken Sie auf Connect to PrimaryLicenseServer.



4. Daraufhin wird ein Dialogfeld angezeigt, in dem Sie aufgefordert werden, zu bestätigen,dass der aktuelle LicenseServer als Failover LicenseServer (des soeben ausgewähltenprimären LicenseServer) verwendet wird. Klicken Sie auf Yes, um dies zu bestätigen.Wenn Sie dies bestätigen, werden alle installierten Lizenzen und registrierten Clients vomaktuellen LicenseServer entfernt.

Sobald ein Failover LicenseServer konfiguriert wurde, wird am oberen Rand des primärenLicenseServer und des Failover LicenseServer eine Meldung über deren jeweiligen Modusangezeigt. In den beiden Abbildungen unten sehen Sie zuerst den Failover LicenseServer unddann den primären LicenseServer.

Beachten Sie die folgenden Punkte:

Nachdem ein Failover LicenseServer konfiguriert wurde, synchronisiert er in regelmäßigenAbständen alle Lizenzen, registrierten Clients und Lizenzvereinbarungen mit denen desprimären LicenseServer. Wenn der primäre LicenseServer ausfällt, übernimmt der FailoverLicenseServer die Rolle des LicenseServer. Sobald der primäre LicenseServer wieder zurVerfügung steht, übernimmt dieser wieder die Kontrolle. Alle Änderungen imZusammenhang mit Lizenzen, die während dieses Zeitraums vorgenommen wurden,gehen verloren, wenn der primäre LicenseServer wieder übernimmt.Der Failover LicenseServer stellt Lizenzen nur für Clients ab Version 2015 rel 3 (bzw. imFall von Altova MobileTogether Server für Version 1.5 oder höher) zur Verfügung. ÄltereClients werden auf dem Register Client Monitoring des primären LicenseServer(Abbildung unten) entsprechend gekennzeichnet. Wir empfehlen Ihnen, Ihre ClientApplikationen auf Version 2015 rel 3 oder höher (bzw. im Fall von Altova MobileTogetherServer auf Version 1.5 oder höher) zu aktualisieren, falls Sie die Failover LicenseServer-Funktion verwenden möchten.

© 2017 Altova GmbH



Lizenz-Check-OutSie können auswählen, ob Desktop-Lizenzen aus dem Lizenzpool an den Rechner, auf dem dasjeweilige Altova-Produkt installiert ist, ausgecheckt werden dürfen. Wenn Sie dies gestatten, sokann ein Client, der eine Lizenz von Ihrem LicenseServer erhalten hat, diese Lizenz auschecken.Die Lizenzüberwachung wird daraufhin für einen Zeitraum bis zu dem in dieser Einstellungmaximal definierten deaktiviert. Lizenzen können für maximal 30 Tage ausgecheckt werden.(Dadurch kann ein Desktop-Produkt auch dann auf einem Client verwendet werden, wenn keinZugriff auf LicenseServer besteht (z.B. unterwegs) bzw. ein Zugriff nicht erwünscht ist. Der Check-Out auf dem Client erfolgt über den Befehl Hilfe | Software-Aktivierung der Altova Desktop-Applikation.

Nachdem eine Lizenz ausgecheckt wurde, wird sie auf dem Register Client Monitoring in denAbschnitt Checked-out Clients verschoben. Sie gilt als in Verwendung und steht keinem anderenClient im Netzwerk zur Verfügung.

NetzwerkeinstellungenEin Administrator kann Netzwerkadressen für die LicenseServer-Konfigurationsseite undLicenseServer definieren:



Web UI: Als zulässige IP-Adressen können alle Schnittstellen und IP-Adressen aufdiesem Rechner oder nur eine fixe Adresse definiert werden. Die Ports können entwederdynamisch ermittelt werden oder fix sein. Dadurch können die verschiedensten IP-Adressen:Port-Einstellungen konfiguriert werden. Die Standardporteinstellung ist 8088.Proxy Server (verfügbar ab v1.3): Wenn für die Internetverbindung ein Proxy-Serververwendet wird, müssen die Informationen des Proxy-Servers im Bereich "ProxyServer" (siehe Abbildung oben) eingegeben werden. Andernfalls können die Proxy Server-Einstellungen leer bleiben. Um für LicenseServer einen Proxy-Server konfigurieren, gebenSie den Host-Namen des Proxy-Servers und, falls erforderlich, eine Port-Nummer ein.Falls für den Proxy-Server keine Authentifizierung benötigt wird, so können die Felder User Name und Password leer bleiben.License Service: Der Rechner, auf dem License Server installiert ist, kann über eine odermehrere Netzwerkschnittstellen mit mehreren Netzwerken verbunden werden. In jedemNetzwerk wird der License Server-Rechner an seinem Host-Namen und seiner IP-Adresseerkannt. In der Einstellung License Service können Sie einstellen, auf welchenNetzwerken der License Service zur Verfügung steht. Bei Auswahl der Option"localhost" steht der Service nur auf dem lokalen Rechner zur Verfügung. VerwendenSie bei Auflistung von Hostnamen und/oder IP-Adressen eine kommagetrennte Liste ohne

© 2017 Altova GmbH



Leerzeichen (z.B.: hostname1,IPAddress1,hostname2). Die Port-Nummer ist fix undlautet 35355.

Standardmäßig erlauben diese Einstellungen den unbeschränkten Zugriff auf LicenseServer undseine Konfigurationsseite über das Netzwerk, mit dem LicenseServer verbunden ist. Wenn Sieden Zugriff auf LicenseServer oder seine Konfigurationsseite einschränken möchten, geben Sie dieentsprechenden Einstellungen ein und klicken Sie auf Save.

Führen Sie einen Verbindungstest durch (siehe oben), um zu überprüfen, ob die Einstellungenkorrekt sind.

BenachrichtigungseinstellungenDer Altova License Server muss eine aufrechte Verbindung zum altova.com Server haben. Wenndie Verbindung länger als 24*5 Stunden (5 Tage) unterbrochen ist, vergibt der LicenseServer keineLizenzen mehr, sodass Arbeitssitzungen mit Altova-Produkten, die bei LicenseServer registriertsind, unterbrochen werden könnten.

Wenn die Verbindung unterbrochen wird, kann eine Warnungsnachricht an eine E-Mail-Adressegesendet werden. Die Einstellungen, um Benachrichtigungen an die E-Mail-Adresse desAdministrators zu senden, werden im Bereich "Alert Mail" (siehe Abbildung unten) vorgenommen.



SMTP Host und SMTP Port sind die Zugriffseinstellungen des E-Mail-Servers, von dem aus die E-Mail gesendet wird. User Authentication und User Password sind die Anmeldeinformationen desBenutzers, mit denen er auf den E-Mail-Server zugreift. In das Feld From wird die E-Mail-Adresseeingetragen, von der aus die E-Mail gesendet wird. In das Feld To wird die E-Mail-Adresse desEmpfängers eingetragen.

Klicken Sie, wenn Sie mit dem Konfigurieren fertig sind, auf Save. Nachdem Sie die Alert Mail-Einstellungen gespeichert haben, werden bei jedem wichtigen Ereignis, wie z.B. wenn eineVerbindung zu altova.com unterbrochen ist, E-Mail-Benachrichtigungen an den Administratorgesendet. Diese Ereignisse werden auch auf dem Register "Messages" protokolliert, wo Sie dasLog ansehen können.

Diverse Einstellungen

Show hints for receiving and deploying evaluation licenses Wenn Sie dieses Kontrollkästchen (siehe Abbildung oben) aktivieren, wird im oberen Bereich der

© 2017 Altova GmbH



Konfigurationsseite eine kurze Anleitung zum Testen und Bereitstellen von Evaluierungslizenzenangezeigt.

Send a warning email if contact with a running product is lost Wenn die Verbindung zu einem lizenzierten laufenden Produkt unterbrochen wird, wird von der Von-Adresse an die An-Adresse eine Warnungsmeldung gesendet.

Messages, Log Out

Auf dem Register Messages werden alle Meldungen, die die Lizenzen im Lizenzpool desLicenseServers betreffen, angezeigt. Zu jeder Meldung gibt es eine Löschen-Schaltfläche, überdie Sie diese Meldung löschen können.

Das Register Log Out dient als Schaltfläche zum Ausloggen. Wenn Sie darauf klicken, werdenSie sofort ausgeloggt. Anschließend wird die Login-Maske angezeigt.



1.7.8 Passwort zurücksetzen

Wenn Sie Ihr LicenseServer-Passwort vergessen haben, können Sie es über die CLI mit demBefehl passwordreset auf die Standardeinstellung default zurücksetzen.

1. Öffnen Sie ein Befehlszeilenfenster.2. Wechseln Sie in das Verzeichnis, in dem das LicenseServer-Applikationspaket oder die

ausführbare Datei installiert ist.3. Geben Sie den Befehl licenseserver passwordreset ein.

Daraufhin wird das LicenseServer-Administrator-Passwort auf default zurückgesetzt.4. Sie können sich nun auf der Web-Verwaltungsoberfläche mit dem Passwort default

einloggen.

© 2017 Altova GmbH

Index 137

Index

AAltova LicenseServer,

(siehe LicenseServer), 73

Altova ServiceController, 83

BBefehl,

generate, 40

licenseserver, 34

Befehle,

exportresourcestrings, 47

help, 51

pdfdata, 45

setdeflang, 49

setfopath, 43

CClient Management (Bereich), 122

DDesktop-Produkte,

auf LicenseServer registrieren, 97

EEinrichten,

auf Mac OS X, 25

unter Linux, 16

unter Windows, 9

E-Mail-Benachrichtigungen, 128

Evaluierungslizenzen, 122

exportresourcestrings-Befehl, 47

FFlowForce Server,

am License Server registrieren, 98

und StyleVision Server, 7

Ggenerate-Befehl, 40

Hhelp-Befehl, 51

IInformationen zum Netzwerk, 75

Insrtallation unter Windows, 10

Installation auf Mac OS X, 26

Installation unter Linux, 17

KKonfigurationsseite, 115

auf Mac OS X öffnen, 91

unter Linux öffnen, 89

unter Windows öffnen, 86

URL, 86

URL (Linux), 89

URL (Mac OS X), 91

LLicense Pool, 115

LicenseServer,

Desktop-Produkte registrieren, 97

Index

© 2017 Altova GmbH

138

LicenseServer,

Einstellungen, 128

FlowForce Server registrieren, 98

Installation auf Mac OS X, 82

Installation unter Linux, 78

Installation unter Windows, 76

Konfigurationsseite, 115

MapForce Server registrieren, 103

MobileTogether Server registrieren, 104

RaptorXML(+XBRL) Server registrieren, 105

Schnittstelle zu, 115

Schritte beim Zuweisen von Lizenzen, 84

starten, 85

StyleVision Server registrieren, 107

licenseserver-Befehl, 34

LicenseServer-Konfigurationsseite,

(siehe Konfigurationsseite), 86, 89, 91

Linux,

Installation unter, 17

Lizenzen,

laden, 94, 115

verwalten, 122

zuweisen, 108, 122

Lizenzen laden, 94, 115

Lizenzen zuweisen, 108

Lizenzierung auf Mac OS X, 29

Lizenzierung unter Windows, 13, 22

Lizenzpool, 94

Logout, 135

Lokalisierung, 47, 49

MMac OS X,

Installation, 26

Lizenzierung, 29

MapForce Server,


Messages, 135

MobileTogether Server,


NNetzwerkeinstellungen, 128

PPasswort,

Standardpasswort beim Start, 86

Passwort zurücksetzen, 136

pdfdata (Befehl), 45

RRaptorXML(+XBRL) Server,


Register "Server Management", 108

Registrieren von RaptorXML(+XBRL) Server amLicenseServer, 105

Registrieren von Desktop-Produkten auf LicenseServer,97

Registrieren von FlowForce Server am LIcenseServer,98

Registrieren von MapForce Server am LIcenseServer,103

Registrieren von MobileTogether Server amLicenseServer, 104

Registrieren von StyleVision Server am LIcenseServer,107

Registrierung von Produkten und Clients aufheben, 122

SServiceController, 83

setdeflang-Befehl, 49

setfopath-Befehl, 43

Settings, 128

Standardpasswort, 86

StyleVision Server,


Features, 6

Funktionalität, 6

© 2017 Altova GmbH

Index 139

StyleVision Server,

im FlowForce Workflow, 7

UÜberwachung des Client-Rechners, 127

VVerwaltungsschnittstelle, 115

Verwendung über die Befehlszeile, 32

WWindows,

Installation, 10

Lizenzieren unter, 13, 22

ZZurücksetzen des Passworts, 136

altova stylevision server · das produkt fungiert als modul von flowforce server von altova und ist...

Documents