Installieren und Bereitstellen von LiveCycle ES für JBoss

bc
Installieren und Bereitstellen
von LiveCycle® ES für JBoss®
Adobe® LiveCycle® ES
Februar 2008
Version 8.0
© 2008 Adobe Systems Incorporated. Alle Rechte vorbehalten.
Adobe® LiveCycle® ES (8.0) – Installieren und Bereitstellen von LiveCycle ES für Microsoft® Windows®, UNIX® und Linux
Ausgabe 1.2, Februar 2008
Sofern dieses Handbuch zusammen mit einer Software geliefert wird, die ein Endbenutzerlizenzabkommen enthält, werden dieses
Handbuch sowie die darin beschriebene Software unter Lizenz zur Verfügung gestellt und dürfen nur in Übereinstimmung mit den
Lizenzbedingungen verwendet oder kopiert werden. Kein Teil dieses Handbuchs darf, außer durch das Lizenzabkommen ausdrücklich
erlaubt, ohne vorherige schriftliche Genehmigung von Adobe Systems Incorporated reproduziert, in Datenbanken gespeichert oder
in irgendeiner Form – elektronisch, mechanisch, auf Tonträger oder auf irgendeine andere Weise – übertragen werden. Beachten Sie,
dass der Inhalt dieses Handbuchs auch dann urheberrechtlich geschützt ist, wenn es nicht zusammen mit einer Software geliefert wird,
die ein Endbenutzerlizenzabkommen enthält.
Der Inhalt dieses Handbuchs dient ausschließlich Informationszwecken, kann ohne Vorankündigung geändert werden und ist nicht als
Verpflichtung von Adobe Systems Incorporated anzusehen. Adobe Systems Incorporated gibt keine Gewähr oder Garantie hinsichtlich
der Richtigkeit oder Genauigkeit der in diesem Handbuch enthaltenen Informationen.
Bedenken Sie, dass bestehende Grafiken oder Bilder, die Sie für Ihr Projekt verwenden möchten, urheberrechtlich geschützt sein können.
Die unberechtigte Nutzung solcher Bilder für Ihre Arbeit kann eine Verletzung der Rechte des Autors darstellen. Achten Sie darauf, alle
notwendigen Genehmigungen von den entsprechenden Autoren einzuholen.
Verweise auf Firmennamen, Firmenlogos sowie Benutzernamen in Beispielvorlagen oder -formularen, die im Lieferumfang dieser
Dokumentation bzw. Software enthalten sind, dienen nur zur Veranschaulichung und sollen nicht auf tatsächliche Unternehmen
oder Personen hinweisen.
Adobe, das Adobe-Logo, Acrobat, FrameMaker, LiveCycle, PageMaker, PhotoShop, Reader und PostScript sind in den USA und/oder
anderen Ländern eingetragene Markenzeichen oder Markenzeichen von Adobe Systems Incorporated.
JBoss ist eine Marke oder eingetragene Marke von Red Hat, Inc. in den USA und anderen Ländern.
Linux ist eine eingetragene Marke von Linus Torvalds in den USA und anderen Ländern.
Microsoft und Windows sind eingetragene Marken oder Marken der Microsoft Corporation in den USA und/oder anderen Ländern.
Oracle ist eine Marke der Oracle Corporation, die in bestimmten Rechtsgebieten möglicherweise eingetragen ist.
Sun, Java, Solaris und SunOS sind Marken oder eingetragene Marken von Sun Microsystems, Inc. in den USA und anderen Ländern.
UNIX ist eine eingetragene Marke von The Open Group in den USA und anderen Ländern.
Alle anderen Marken sind Eigentum ihrer jeweiligen Inhaber.
Dieses Produkt enthält BISAFE- und/oder TIPEM-Software von RSA Data Security, Inc.
Dieses Produkt enthält Software, die von der Apache Software Foundation (http://www.apache.org/) entwickelt wurde.
Dieses Produkt enthält Code, der von RSA Data Security lizenziert wurde.
Dieses Produkt enthält Software, die vom JDOM Project (http://www.jdom.org/) entwickelt wurde.
Macromedia Flash 8-Video basiert auf On2 TrueMotion-Videotechnologie. © 1992 – 2005 On2 Technologies, Inc. Alle Rechte vorbehalten.
http://www.on2.com.
Dieses Produkt enthält Software, die von der OpenSymphony Group (http://www.opensymphony.com/) entwickelt wurde.
Teile dieses Codes sind von Nellymoser (www.nellymoser.com) lizenziert.
Die MPEG Layer-3-Audiokomprimierungstechnologie ist von Fraunhofer IIS und THOMSON Multimedia (http://www.iis.fhg.de/amm/)
lizenziert.
Dieses Produkt enthält Software, die von L2FProd.com (http://www.L2FProd.com/) entwickelt wurde.
Die JBoss-Bibliothek wird gemäß der GNU Library General Public License lizenziert, von der eine Kopie zum Lieferumfang dieser
Software gehört.
Die BeanShell-Bibliothek ist unter der GNU Library General Public License lizenziert. Eine Kopie der Lizenz liegt dieser Software bei.
Dieses Produkt enthält Software, die von The Werken Company entwickelt wurde.
Dieses Produkt enthält Software, die vom IronSmith Project (http://www.ironsmith.org/) entwickelt wurde.
Die OpenOffice.org-Bibliothek wird gemäß der GNU Library General Public License lizenziert, von der eine Kopie zum Lieferumfang dieser
Software gehört.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Hinweis für Endbenutzer im Dienste der US-Regierung. Die vorliegende Software und die dazugehörige Dokumentation sind „Commercial
Items“ (kommerzielle Güter), wie in 48 C.F.R. §2.101 definiert, und umfassen die Bestandteile „Commercial Computer Software“ (kommerzielle
Computersoftware) und „Commercial Computer Software Documentation“ (kommerzielle Computersoftware-Dokumentation) entsprechend
der Verwendung dieser Begriffe in 48 C.F.R. §12.212 oder 48 C.F.R. §227.7202, falls anwendbar. In Übereinstimmung mit 48 C.F.R. §12.212 oder
48 C.F.R. §§227.7202-1 bis 227.7202-4, falls anwendbar, werden „Commercial Computer Software“ und „Commercial Computer Software
Documentation“ den Endbenutzern im Dienste der US-Regierung (a) nur als „Commercial Items“ und (b) nur mit den Rechten ausgestattet
zur Verfügung gestellt, die allen anderen Endbenutzern gemäß den hier vorliegenden Bedingungen zukommen. Nicht veröffentlichte Rechte
sind unter den Urheberrechtsgesetzen der USA vorbehalten. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA.
Für Endbenutzer im Dienste der US-Regierung: Adobe verpflichtet sich, alle anwendbaren Gesetze zur Chancengleichheit einzuhalten,
einschließlich, falls zutreffend, der Bestimmungen von Executive Order 11246 in aktueller Fassung, des Abschnitts 402 des Vietnam Era
Veterans Readjustment Assistance Act von 1974 (38 USC 4212), des Abschnitts 503 des Rehabilitation Act von 1973 in aktueller Fassung
und der Bestimmungen in 41 C.F.R., Teile 60-1 bis 60-60, 60-250 und 60-741. Die Antidiskriminierungsklausel und Bestimmungen aus dem
vorangehenden Satz werden durch Verweis berücksichtigt.
Inhaltsverzeichnis
Informationen zu diesem Dokument ......................................................................................... 6
Inhalt dieses Dokuments ............................................................................................................................................................. 6
Zielgruppe des Dokuments........................................................................................................................................................ 6
Konventionen in diesem Handbuch ....................................................................................................................................... 7
Zusätzliche Informationen.......................................................................................................................................................... 7
1
Einführung ................................................................................................................................... 9
Informationen zur Installation, Konfiguration und Bereitstellung............................................................................... 9
Auswählen von Aufgaben für das Konfigurieren und Bereitstellen von LiveCycle ES........................................10
Aktualisieren auf LiveCycle ES .................................................................................................................................................10
Checkliste für die manuelle Installation und Bereitstellung.........................................................................................10
2
Installation der Dateien für Lösungskomponenten ............................................................... 12
Installieren der Produktdateien ..............................................................................................................................................12
Installation auf einer Windows-Testplattform für die Bereitstellung unter Linux..........................................13
Installieren von LiveCycle ES..............................................................................................................................................13
Anzeigen des Fehlerprotokolls................................................................................................................................................15
Nächste Schritte............................................................................................................................................................................15
3
Konfigurieren von LiveCycle ES für die Bereitstellung........................................................... 16
Informationen zu LiveCycle Configuration Manager......................................................................................................16
Konfigurationsaufgaben: ....................................................................................................................................................16
Ausführen von LiveCycle Configuration Manager zum Konfigurieren und Bereitstellen
von LiveCycle ES.....................................................................................................................................................................17
Speichern von Konfigurationen in LiveCycle Configuration Manager...............................................................19
Nächste Schritte............................................................................................................................................................................19
4
Bereitstellen von LiveCycle ES unter JBoss Application Server............................................. 20
Bereitstellen von LiveCycle ES-Lösungskomponenten ..................................................................................................20
Übersicht der bereitstellbaren Komponenten ..................................................................................................................20
Bereitstellen unter JBoss Application Server......................................................................................................................21
Nächste Schritte............................................................................................................................................................................21
5
Aktivitäten nach der Bereitstellung......................................................................................... 22
Konfigurieren von Acrobat 8.1 für PDF Generator ES .....................................................................................................22
Abschließende Einrichtung für LiveCycle Rights Management ES ............................................................................23
Überprüfen der Bereitstellung und Zugreifen auf LiveCycle-Verwaltungskonsole.............................................23
Zugreifen auf LiveCycle-Verwaltungskonsole.............................................................................................................23
Anzeigen der Protokolldateien.........................................................................................................................................24
Zugriff auf die Webanwendungen der Lösungskomponente.....................................................................................24
Zugreifen auf Rights Management ES:...........................................................................................................................25
Zugreifen auf User Management ...........................................................................................................................................25
Konfigurieren von LiveCycle ES fur den LDAP-Zugriff....................................................................................................26
Leistungsparameter für überwachte Ordner in PDF Generator ES............................................................................27
Konfigurieren des FIPS-Modus ................................................................................................................................................27
Konfigurieren von Einstellungen für eine digitale HTML-Signatur............................................................................28
Konfigurieren des Connector für EMC Documentum-Dienstes ..................................................................................28
Erstellen des XDP MIME-Formats im Documentum-Repository...........................................................................31
4
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBoss
5
Inhaltsverzeichnis
5
Aktivitäten nach der Bereitstellung (Fortsetzung)
Konfigurieren des Connector für IBM FileNet-Dienstes .................................................................................................33
Deinstallieren von LiveCycle ES ..............................................................................................................................................36
6
Manuelles Konfigurieren von BAM Server für LiveCycle ES................................................... 37
Erstellen und Konfigurieren der BAM Server-Metadaten-Datenbank ......................................................................37
Benutzerkonten ......................................................................................................................................................................38
Konfigurieren der Datenbankumgebung .....................................................................................................................38
Erstellen der BAM Server-Metadaten-Datenbank......................................................................................................39
Installieren von JBoss Application Server............................................................................................................................40
Installieren der Datenbanktreiber für JBoss Application Server für BAM Server ..................................................40
Konfigurieren der BAM Server-Metadaten-Datenbank..................................................................................................41
Herstellen einer Verbindung zwischen JBoss Application Server für BAM Server und
der LiveCycle ES-Datenbank........................................................................................................................................42
Konfigurieren erforderlicher JVM-Optionen für JBoss Application Server .......................................................44
Optionale JVM-Parameter für JBoss Application Server..........................................................................................45
Konfigurieren von Process Management ES für BAM Server .......................................................................................48
Bereitstellen der EAR-Datei von BAM Server für LiveCycle ES .....................................................................................48
Konfigurieren von Business Activity Monitoring ES ........................................................................................................49
Konfigurieren von LDAP-Einstellungen für BAM Server ................................................................................................51
Einschränkungen für LDAP-Verbindungen von BAM Server .................................................................................51
Richtlinien für LDAP-Verbindungen von BAM Server...............................................................................................52
Konfigurieren der automatischen LDAP-Synchronisierung...................................................................................52
Konfigurieren der LDAP-Benutzerzuordnung.............................................................................................................54
Konfigurieren der LDAP-Rollenzuordnung ..................................................................................................................55
Manuelles Synchronisieren mit dem LDAP-Server ....................................................................................................56
Verwendung von BAM Dashboard ........................................................................................................................................56
Herunterfahren des BAM Server .............................................................................................................................................57
Zusätzliche Dokumentation.....................................................................................................................................................57
Deinstallation... Business Activity Monitoring ES..............................................................................................................58
7
Erweiterte Konfiguration für Produktionssysteme ................................................................ 59
LiveCycle Output ES und LiveCycle Forms ES....................................................................................................................59
LiveCycle PDF Generator ES .....................................................................................................................................................59
Konfiguration der Größe des EJB-Pools .........................................................................................................................59
A
Fehlerbehebung ........................................................................................................................ 62
Anfordern von Hilfe .....................................................................................................................................................................62
Installationseinstellungen ..................................................................................................................................................62
Anwendungsservereinstellungen....................................................................................................................................62
Datenbankinitialisierungseinstellungen .......................................................................................................................63
Probleme beim Zugreifen auf die Seite „Dienste“ innerhalb der LiveCycle-Verwaltungskonsole...........63
Fehlerbehebung mit Protokolldateien.................................................................................................................................63
Protokolldatei von LiveCycle Configuration Manager .............................................................................................63
JBoss-Protokolldatei..............................................................................................................................................................63
Konfigurieren des Scheduler-Dienstes für nicht standardmäßige JNDI-URLs .......................................................64
Umgebungen ohne Cluster................................................................................................................................................64
Fehlermeldungen.........................................................................................................................................................................64
Beim Konvertieren nativer Dateien schlägt PDF Generator ES unter Windows fehl.....................................64
Klasse nicht gefunden ..........................................................................................................................................................65
JNDI-Name nicht gefunden................................................................................................................................................65
Ausnahmen beim mehrfachen Initialisieren der LiveCycle ES-Datenbank ......................................................66
Informationen zu diesem Dokument
Dieses Handbuch ist eine von mehreren verfügbaren Informationsquellen für die Verwendung von
Adobe® LiveCycle® ES (Enterprise Suite). LiveCycle ES ist eine flexible, erweiterbare Plattform, die zur
Automatisierung und Beschleunigung der Übermittlung geschäftswichtiger Informationen von und
zu Kunden, Partnern, Auftraggebern und Mitarbeitern beiträgt.
Inhalt dieses Dokuments
In diesem Handbuch finden Sie Informationen zum Installieren und Konfigurieren der folgenden
Lösungskomponenten unter Microsoft® Windows® und Linux® und erfahren darüber hinaus, wie
die Lösungskomponenten auf einem JBoss® Application Server bereitgestellt werden:
G
Adobe LiveCycle Barcoded Forms ES
G
Adobe LiveCycle Business Activity Monitoring ES
G
Adobe LiveCycle ES Connector für EMC Documentum
G
Adobe LiveCycle ES Connector für IBM FileNet
G
Adobe LiveCycle Digital Signatures ES
G
Adobe LiveCycle Forms ES
G
Adobe LiveCycle Foundation
G
Adobe LiveCycle Output ES
G
Adobe LiveCycle PDF Generator ES
G
Adobe LiveCycle Process Management ES
G
Adobe LiveCycle Reader Extensions ES
G
Adobe LiveCycle Rights Management ES
Zielgruppe des Dokuments
Dieses Handbuch richtet sich an Administratoren oder Entwickler, die für die Installation, Konfiguration,
Verwaltung oder Bereitstellung von LiveCycle ES-Komponenten zuständig sind. Benutzer dieses
Handbuchs sollten mit J2EE-Anwendungsservern, den Betriebssystemen Linux und Microsoft Windows,
Datenbankservern im Format MySQL, Oracle®, DB2® oder SQL Server sowie Webumgebungen vertraut sein.
6
Adobe LiveCycle ES
Informationen zu diesem Dokument
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konventionen in diesem Handbuch
Konventionen in diesem Handbuch
In diesem Handbuch werden die folgenden Benennungskonventionen für allgemeine Dateipfade
verwendet.
Name
Standardwert
Beschreibung
[LiveCycle
Windows:
ES-Stammverzeichnis] C:\Adobe\LiveCycle8\
Das Installationsverzeichnis für alle
LiveCycle ES-Lösungskomponenten. Das
Installationsverzeichnis enthält Unterordner
für Adobe LiveCycle Configuration Manager,
das LiveCycle ES SDK und die einzelnen
installierten LiveCycle ES-Lösungskomponenten
(einschließlich der Produktdokumentation).
Dieses Verzeichnis enthält außerdem
Verzeichnisse im Zusammenhang mit
Drittanbietertechnologien.
Linux:
/opt/adobe/livecycle8/
[AnwendungsserverStammverzeichnis]
[DatenbankserverStammverzeichnis]
Das Basisverzeichnis des
Anwendungsservers, auf
dem die LiveCycle ES-Dienste
ausgeführt werden.
JBoss Application Server unter Windows:
C:\jboss
Der Speicherort, an dem der
LiveCycle ES-Datenbankserver
installiert wird.
Hängt vom Datenbanktyp und Ihrer Angabe
bei der Installation ab.
JBoss Application Server unter Linux:
/opt/jboss
Die meisten Informationen zu Verzeichnissen in diesem Handbuch gelten plattformübergreifend
(unter Linux wird bei allen Dateinamen und Pfadangaben die Groß- und Kleinschreibung beachtet).
Plattformspezifische Informationen werden bei Bedarf aufgeführt.
Zusätzliche Informationen
In der folgenden Tabelle finden Sie Hinweise auf weiterführende Informationen zu LiveCycle ES.
Gewünschte Informationen
Siehe
Allgemeine Informationen zu LiveCycle ES
und den Lösungskomponenten
Übersicht über LiveCycle ES unter
www.adobe.com/go/learn_lc_overview_de
Neues in der Adobe LiveCycle ES
(Enterprise Suite)-Version
www.adobe.com/go/learn_lc_whatsNew_de
LiveCycle ES-Terminologie
www.adobe.com/go/learn_lc_glossary_de
Weitere Dienste und Produkte, die in
LiveCycle ES integriert werden können
www.adobe.com/de/products/livecycle/
Andere Adobe
LiveCycle ES-Lösungskomponenten
www.adobe.com/de/devnet/
7
Adobe LiveCycle ES
Informationen zu diesem Dokument
Installieren und Bereitstellen von LiveCycle ES für JBoss
Zusätzliche Informationen
Gewünschte Informationen
Siehe
Installieren von Adobe LiveCycle
Workbench ES
Installieren der Entwicklungsumgebung unter
www.adobe.com/go/learn_lc_installWorkbench
Aktualisieren auf LiveCycle ES von einer
früheren Version
Vorbereiten der Aktualisierung auf LiveCycle ES unter
www.adobe.com/go/learn_lc_upgradePreparation_de
Aktualisieren auf LiveCycle ES für JBoss unter
www.adobe.com/go/learn_lc_upgradeJBoss_de
Ausführen von Verwaltungsaufgaben für
LiveCycle ES
Verwalten von LiveCycle ES unter
www.adobe.com/go/learn_lc_administration_de
Die gesamte Dokumentation zu LiveCycle ES www.adobe.com/go/learn_lc_documentation_de
LiveCycle ES-Versionsinformationen und in
letzter Minute am Produkt vorgenommene
Änderungen
www.adobe.com/go/learn_lc_releaseNotes_de
Patch-Updates, technische Hinweise und
zusätzliche Informationen zu dieser
Produktversion
www.adobe.com/support/products/enterprise/
index.html
8
1
Einführung
In diesem Kapitel erhalten Sie Informationen zu verschiedenen Typen von Installation und Bereitstellung,
die durchgeführt werden können, sowie Informationen zum Installations-, Konfiguration- und
Bereitstellungsprozess.
G
„Informationen zur Installation, Konfiguration und Bereitstellung“ auf Seite 9
G
„Checkliste für die manuelle Installation und Bereitstellung“ auf Seite 10
Informationen zum Vorbereiten Ihres Systems für die Installation von LiveCycle ES, einschließlich der
Systemvoraussetzungen, finden Sie im Handbuch Vorbereiten der LiveCycle ES-Installation.
Informationen zur Installation, Konfiguration und Bereitstellung
Die Installation, Konfiguration und Bereitstellung von LiveCycle ES besteht aus den folgenden Prozessen:
Installieren: Die Installation von LiveCycle ES erfolgt durch Ausführen des Installationsprogramms.
Bei der Installation von LiveCycle ES werden alle erforderlichen Dateien in eine
Installationsverzeichnisstruktur auf dem Computer kopiert. Das Standardverzeichnis für die Installation
ist „C:\Adobe\LiveCycle8“ (Windows) bzw. „/opt/adobe/LiveCycle8“ (Linux). Sie können die Dateien
jedoch auch in ein anderes Verzeichnis installieren. In diesem Handbuch wird das Standardverzeichnis
für die Installation als [LiveCycle ES-Stammverzeichnis] bezeichnet. (Siehe „Installation der Dateien für
Lösungskomponenten“ auf Seite 12.)
Konfigurieren und Assemblieren: Beim Konfigurieren von LiveCycle ES wird eine Reihe von
Einstellungen geändert, die bestimmen, wie LiveCycle ES funktioniert. Beim Assemblieren des
Produkts werden alle installierten Komponenten gemäß Ihren Konfigurationsanweisungen zu
bereitstellbaren EAR- und JAR-Dateien zusammengefügt. Sie konfigurieren und assemblieren
die Komponenten für die Bereitstellung, indem Sie LiveCycle Configuration Manager ausführen.
(Siehe „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 16.) Sie können mehrere
LiveCycle ES-Lösungskomponenten gleichzeitig konfigurieren und assemblieren.
Bereitstellen: Das Bereitstellen des Produkts besteht aus der Bereitstellung der assemblierten
EAR-Dateien und unterstützender Dateien auf dem JBoss-Anwendungsserver, auf dem Sie die
LiveCycle ES-Lösung ausführen möchten. Wenn Sie mehrere Lösungskomponenten konfiguriert und
assembliert haben, werden die bereitstellbaren Komponenten in den bereitstellbaren EAR-Dateien
zusammengefasst. Komponenten und LiveCycle ES-Archivdateien (LCAs) werden als JAR-Dateien
zusammengefasst.
Initialisieren der LiveCycle ES-Datenbank: Beim Initialisieren der mit LiveCycle ES zu verwendenden
Datenbank werden Tabellen für die Verwendung mit Adobe User Management und anderen
Lösungskomponenten erstellt. Wenn Sie eine Lösungskomponente bereitstellen, die eine Verbindung
mit der LiveCycle ES-Datenbank herstellt, müssen Sie die LiveCycle ES-Datenbank nach der
Bereitstellung initialisieren. (Siehe „Konfigurationsaufgaben:“ auf Seite 16.)
9
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Einführung
Auswählen von Aufgaben für das Konfigurieren und Bereitstellen von
LiveCycle ES 10
Auswählen von Aufgaben für das Konfigurieren und Bereitstellen
von LiveCycle ES
Im Anschluss an eine Installation können Sie LiveCycle Configuration Manager ausführen, um eine Reihe
von Aufgaben durchzuführen:
G
Konfigurieren von LiveCycle ES-Lösungskomponenten in einer EAR-Datei zum Bereitstellen auf dem
Anwendungsserver
G
Bereitstellen von LiveCycle ES-EAR-Dateien
G
Initialisieren der LiveCycle ES-Datenbank
G
Bereitstellen der LiveCycle ES-Komponenten
G
Überprüfen der Bereitstellung von LiveCycle ES-Komponenten
G
Konfigurieren der Berechtigung fur Rechte von LiveCycle Reader Extensions ES
G
Importieren der LiveCycle ES-Beispiele
Wenn Sie Reader Extensions ES installieren, können Sie ebenfalls die Berechtigung für Rechte von
Reader Extensions ES angeben und importieren, die für das Anwenden von Verwendungsrechten
auf PDF-Dokumente erforderlich ist.
Wenn Sie eine Turnkey-Installation und -Bereitstellung durchführen möchten (bei der LiveCycle ES
zusammen mit JBoss und MySQL installiert, konfiguriert und bereitgestellt wird), lesen Sie das Handbuch
Installieren und Konfigurieren von LiveCycle ES für JBoss® mithilfe der Turnkey-Methode.
Aktualisieren auf LiveCycle ES
Vor der Installation von LiveCycle ES zur Aktualisierung von LiveCycle 7.x und höher müssen
Sie die Aufgaben im Dokument Vorbereiten der Aktualisierung von LiveCycle ES unter
www.adobe.com/go/learn_lc_upgradePreparation_de ausgeführt haben.
Checkliste für die manuelle Installation und Bereitstellung
Die folgende Liste enthält die Schritte, die für die Installation von LiveCycle ES mit der manuellen Methode
erforderlich sind. Der Anwendungsserver muss bereits installiert und konfiguriert sein, bevor Sie die
Installation durchführen.
G
Vergewissern Sie sich, dass die erforderliche Software in der Zielumgebung installiert und konfiguriert
ist. Weitere Informationen finden Sie unter Vorbereiten der LiveCycle ES-Installation auf der Website
www.adobe.com/go/learn_lc_prepareInstall_de.
G
Führen Sie das Installationsprogramm aus. (Siehe „Installation der Dateien für Lösungskomponenten“
auf Seite 12.)
G
Führen Sie LiveCycle Configuration Manager aus und wählen Sie die Aufgabe „LiveCycle ES EARs
konfigurieren“ aus. Dadurch wird LiveCycle ES konfiguriert und assembliert. Weitere Informationen
finden Sie unter „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 16.
G
Stellen Sie die EAR-Dateien auf dem Anwendungsserver bereit. Sie können dies manuell oder
mithilfe von LiveCycle Configuration Manager tun. (Siehe „Bereitstellen von LiveCycle ES unter
JBoss Application Server“ auf Seite 20.)
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Einführung
Checkliste für die manuelle Installation und Bereitstellung
11
G
Führen Sie LiveCycle Configuration Manager aus, um LiveCycle ES-Komponentendateien bereitzustellen
und stellen Sie optional Produktbeispiele bereit. (Siehe „Konfigurieren von LiveCycle ES für die
Bereitstellung“ auf Seite 16.)
G
Greifen Sie auf LiveCycle-Verwaltungskonsole und User Management zu. (Siehe „Zugreifen auf
LiveCycle-Verwaltungskonsole“ auf Seite 23.)
G
Konfigurieren Sie den LDAP-Zugriff. (Siehe „Konfigurieren von LiveCycle ES fur den LDAP-Zugriff“ auf
Seite 26.) Wenn Sie eine Turnkey-Installation und -Bereitstellung durchführen möchten (bei der
LiveCycle ES zusammen mit JBoss und MySQL installiert, konfiguriert und bereitgestellt wird), lesen Sie
Installieren und Konfigurieren von LiveCycle ES für JBoss mithilfe der Turnkey-Methode.
2
Installation der Dateien für Lösungskomponenten
In diesem Kapitel wird die Verwendung des Installationsprogramms zur Installation von LiveCycle ES unter
einem Windows-, Linux- oder UNIX-Betriebssystem beschrieben.
Vor der Installation der Lösungskomponenten müssen Sie sicherstellen, dass die Umgebung über die zum
Ausführen von LiveCycle ES-Produkten erforderliche Software und Hardware verfügt. Außerdem sollten
Sie mit den Installationsoptionen vertraut sein und die Umgebung entsprechend vorbereitet haben.
(Weitere Informationen finden Sie im Dokument Vorbereiten der LiveCycle ES-Installation.)
In diesem Kapitel werden die folgenden Themen behandelt:
G
„Installieren der Produktdateien“ auf Seite 12
G
„Anzeigen des Fehlerprotokolls“ auf Seite 15
Installieren der Produktdateien
Für die Ausführung des Installationsprogramms benötigen Sie die folgenden Informationen:
G
Seriennummer der zu installierenden Lösungskomponente(n)
G
Typ der durchzuführenden Installation und Konfiguration (siehe „Konfigurieren von JBoss Application
Server“ in Vorbereiten der LiveCycle ES-Installation unter
http://www.adobe.com/go/learn_lc_prepareInstall_de.)
Hinweis: Eine erfolgreiche Installation setzt voraus, dass Sie über Lese- und Schreibberechtigungen für
das Installationsverzeichnis verfügen. Bei den folgenden Verzeichnissen handelt es sich um die
standardmäßigen Installationsverzeichnisse. Sie können jedoch bei Bedarf auch ein anderes
Verzeichnis festlegen:
G
(Windows) C:\Adobe\LiveCycle8\
G
(Linux) /opt/adobe/livecycle8/
Das Installationsprogramm verwendet bei der Installation unter Linux das Basisverzeichnis des
angemeldeten Benutzers als temporäres Verzeichnis zum Speichern von Dateien. Daher werden in
der Konsole möglicherweise solche Meldungen angezeigt:
WARNING: could not delete temporary file
/home/<Benutzername>/ismp001/1556006
Sie müssen nach Abschluss der Installation die temporären Dateien manuell löschen.
Vorsicht: Stellen Sie sicher, dass das temporäre Verzeichnis Ihres Betriebssystems die Mindestanforderungen
erfüllt, die im Handbuch Vorbereiten der LiveCycle ES-Installation beschrieben werden. Das temporäre
Verzeichnis befindet sich an einem der folgenden Speicherorte:
G
(Windows) TMP oder TEMP gemäß Einstellung in den Umgebungsvariablen
G
(Linux) Basisverzeichnis des angemeldeten Benutzers
Der InstallShield-Befehlszeilenparameter -is:tempdir wird vom
LiveCycle ES-Installationsprogramm nicht unterstützt. Um dieses Problem zu umgehen,
verweisen Sie mithilfe der Umgebungsvariablen TMP auf einen Datenträger mit ausreichend
freiem Speicherplatz.
12
Adobe LiveCycle ES
Installation der Dateien für Lösungskomponenten
Installieren und Bereitstellen von LiveCycle ES für JBoss
Installation auf einer Windows-Testplattform für die Bereitstellung
unter Linux 13
Auf Linux-Systemen können Sie Lösungskomponenten auch installieren, konfigurieren und bereitstellen,
wenn Sie nicht als Root-Benutzer angemeldet sind:
Hinweis: Wenn Sie die Lösungskomponenten unter dem Betriebssystem Linux installieren, müssen Sie als
Root-Benutzer angemeldet sein, um das Produkt erfolgreich im Standard-Installationsverzeichnis
„/opt/adobe/LiveCycle8/“ installieren zu können. Wenn Sie nicht als Root-Benutzer angemeldet
sind, ändern Sie das Installationsverzeichnis in ein Verzeichnis, für das Sie Lese-, Schreib- und
Ausführungsberechtigungen besitzen. Sie können das Verzeichnis beispielsweise in
„home/adobe/livecycle8“ ändern.
Installation auf einer Windows-Testplattform für die Bereitstellung
unter Linux
LiveCycle ES kann unter Windows für eine Bereitstellung auf einer Linux-Plattform installiert und konfiguriert
werden. Sie können diese Funktionalität für die Installation in einer gesperrten Linux-Umgebung verwenden.
So ist in einer gesperrten Umgebung beispielsweise XWindows nicht installiert. Wenn Sie das
Installationsprogramm unter Windows ausführen, können Sie ein Linux-Betriebssystem als Zielplattform für
die Bereitstellung von LiveCycle ES auswählen. Das Installationsprogramm installiert Binärdateien für Linux,
die auch von LiveCycle Configuration Manager verwendet werden, wenn Sie das Produkt konfigurieren.
Der Windows-Computer kann anschließend als Testspeicherort für die bereitstellbaren Objekte genutzt
werden, die auf einen Linux-Computer für die Bereitstellung auf dem Anwendungsserver kopiert werden
können. Der gewünschte Anwendungsserver muss der Auswahl während der Installation und
Konfiguration ungeachtet des Betriebssystems entsprechen.
Hinweis: Falls Ihre Installation LiveCycle PDF Generator ES umfasst und Sie die Funktion zur Konvertierung
nativer Anwendungsformate verwenden möchten, muss das Host- und Zielbetriebssystem
Windows sein.
Installieren von LiveCycle ES
In diesem Abschnitt wird die Erstinstallation von LiveCycle ES beschrieben. Informationen zu Konfiguration
und Bereitstellung finden Sie unter „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 16.
Hinweis: Um Berechtigungsprobleme bei der Bereitstellung zu vermeiden, sollten Sie sich
unbedingt als der Benutzer anmelden, der den JBoss-Prozess ausführt, wenn Sie das
LiveCycle ES-Installationsprogramm und LiveCycle Configuration Manager ausführen.
® So installieren Sie LiveCycle ES:
1. Wechseln Sie zum Verzeichnis „/livecycle_server/8.0“ auf dem Installationsmedium.
2. Starten Sie das Installationsprogramm:
G
(Windows) Doppelklicken Sie auf die Datei „win_livecycle8_setup.exe“.
G
(Linux) Geben Sie an einer Eingabeaufforderung den folgenden Befehl ein:
./linux_livecycle8_setup.bin
3. Wählen Sie bei der Aufforderung eine Sprache für die Installation und klicken Sie auf OK.
4. Klicken Sie im Begrüßungsbildschirm auf Weiter.
Adobe LiveCycle ES
Installation der Dateien für Lösungskomponenten
Installieren und Bereitstellen von LiveCycle ES für JBoss
Installieren von LiveCycle ES
14
5. Akzeptieren Sie auf dem Zielbildschirm das angegebene Standardverzeichnis oder klicken Sie auf
Durchsuchen und wechseln Sie zu dem Verzeichnis, in dem Sie die Lösungskomponente installieren
mochten. Klicken Sie dann auf Weiter.
Hinweis: Wenn Sie den Namen eines nicht vorhandenen Verzeichnisses eingeben, wird dieses
Verzeichnis erstellt.
Vorsicht: Bei der Installation der Lösungskomponente können Sie ein anderes Installationsverzeichnis
angeben. Wenn Sie die Lösungskomponente unter Linux installieren, darf das angegebene
Verzeichnis keine Leerzeichen enthalten, da die Installation sonst nicht durchgeführt wird.
6. Geben Sie die Seriennummer in das Textfeld ein und klicken Sie auf Hinzufügen. Wenn Sie mehrere
Lösungskomponenten lizenziert haben, wiederholen Sie diesen Schritt für jede vorhandene
Seriennummer. Klicken Sie, nachdem alle Seriennummern der Liste hinzugefügt wurden, auf Weiter.
Tipp: Klicken Sie zum Zurücksetzen der Seriennummer auf Löschen.
7. Wahlen Sie im Bildschirm Installationstyp die Option Manuell aus und klicken Sie auf Weiter.
Hinweis: Wenn Sie eine Turnkey-Installation ausführen möchten, können Sie die Option Automatisch
konfigurieren und bereitstellen auswählen. Die Turnkey-Methode der Installation wird
in diesem Dokument nicht beschrieben. Informationen finden Sie in Installieren und
Konfigurieren von LiveCycle ES für JBoss® mithilfe der Turnkey-Methode.
8. Lesen Sie die Produktlizenzvereinbarung. Wenn Sie mit den Bedingungen einverstanden sind, wählen
Sie Ich akzeptiere die Bedingungen der Lizenzvereinbarung aus und klicken auf Weiter.
9. (Nur Windows-Testplattform) Wählen Sie das Betriebssystem aus, für das LiveCycle ES konfiguriert
werden soll, und klicken Sie auf Weiter.
Hinweis: An dieser Stelle können Sie festlegen, dass Windows als Testplattform für Ihre Bereitstellung
verwendet werden soll. Sie können Linux oder ein UNIX-Betriebssystem als Ziel der
Bereitstellung auswählen, auch wenn Sie die Installation unter Windows ausführen. Weitere
Informationen finden Sie unter „Installation auf einer Windows-Testplattform für die
Bereitstellung unter Linux“ auf Seite 13.
10. (Nur PDF Generator ES für Windows) Wahlen Sie die entsprechende Option im
PDF Generator ES-Bildschirm aus:
G
Wenn Sie Ja, die Unterstutzung nativer Anwendungen für PDF Generator ES aktivieren
auswählen, uberpruft die Software die installierte Version von Adobe Acrobat®. Wenn Acrobat
nicht installiert ist, akzeptieren Sie die Aufforderung, Acrobat 8.1 jetzt zu installieren.
Wenn eine nicht unterstützte Version von Acrobat installiert ist, schließen Sie die Installation
von LiveCycle ES ab, deinstallieren Acrobat und installieren anschließend Acrobat 8.1 vom
LiveCycle ES-Installationsmedium gemäß den Anweisungen im Verfahren „Konfigurieren von
Acrobat 8.1 für PDF Generator ES“ auf Seite 22.
G
Wenn Sie die Installation in einer Clusterumgebung durchfuhren, aktivieren Sie Nein, keine
Unterstutzung nativer Anwendungen fur PDF Generator ES aktivieren und fahren mit
Schritt 12 fort.
11. (Nur PDF Generator ES für Windows) Bestätigen Sie, dass Acrobat installiert ist und klicken Sie
auf Weiter.
Adobe LiveCycle ES
Installation der Dateien für Lösungskomponenten
Installieren und Bereitstellen von LiveCycle ES für JBoss
Anzeigen des Fehlerprotokolls
15
12. Überprüfen Sie die Installationsdetails und klicken Sie auf Installieren. Das Installationsprogramm
zeigt den Status der Installation an. Im Anschluss an die Installation der Lösungskomponente wird
eine Zusammenfassung angezeigt.
13. Überprüfen Sie die angezeigten Anmerkungen zu dieser Version und klicken Sie auf Weiter.
14. Aktivieren Sie LiveCycle Configuration Manager starten und klicken Sie auf Fertig stellen.
Hinweis: Durch das Aktivieren der Startoption wird LiveCycle Configuration Manager gestartet, mit dem
Sie die Konfiguration und Bereitstellung sofort abschließen können. Wenn Sie nicht bereit sind,
LiveCycle Configuration Manager sofort auszuführen, vergewissern Sie sich, dass die Option
LiveCycle Configuration Manager starten nicht aktiviert ist, wenn Sie auf Fertig stellen
klicken. Sie können LiveCycle Configuration Manager später starten, wenn Sie bereit sind. (Siehe
„Ausführen von LiveCycle Configuration Manager zum Konfigurieren und Bereitstellen von
LiveCycle ES“ auf Seite 17.)
Wenn Sie bereit sind, mit der Konfiguration und Bereitstellung fortzufahren, finden Sie weitere
Informationen unter „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 16.
Hinweis: (Nur PDF Generator ES für Windows) Wenn Sie Acrobat 8.1 nicht mithilfe des
LiveCycle ES-Installationsprogramms installiert haben, müssen Sie die unter „Konfigurieren von
Acrobat 8.1 für PDF Generator ES“ auf Seite 22 beschrieben Schritte ausführen.
Anzeigen des Fehlerprotokolls
Falls bei der Installation Fehler auftreten, wird eine Protokolldatei namens „log.txt“ erstellt, in der
die entsprechenden Fehlermeldungen enthalten sind. Die Protokolldatei befindet sich im
[LiveCycle ES-Stammverzeichnis].
Informationen zu Fehlern, die während der Installation ggf. auftreten, finden Sie unter „Fehlerbehebung“
auf Seite 62.
Nächste Schritte
Sie müssen LiveCycle ES jetzt für die Bereitstellung konfigurieren. (Siehe „Konfigurieren von LiveCycle ES
für die Bereitstellung“ auf Seite 16.)
3
Konfigurieren von LiveCycle ES für die Bereitstellung
In diesem Kapitel wird beschrieben, wie Sie mit LiveCycle Configuration Manager die folgenden Aufgaben
durchführen:
G
Konfigurieren von LiveCycle ES-Lösungskomponenten in einer EAR-Datei zum Bereitstellen auf dem
Anwendungsserver
G
Bereitstellen von LiveCycle ES-EAR-Dateien
G
Initialisieren der LiveCycle ES-Datenbank
G
Bereitstellen von LiveCycle ES-Komponenten
G
Überprüfen der Bereitstellung von LiveCycle ES-Komponenten
G
Konfigurieren der Berechtigung fur Rechte von LiveCycle Reader Extensions ES
G
Importieren der LiveCycle ES-Beispiele
Dieses Kapitel enthält folgende Abschnitte:
G
„Informationen zu LiveCycle Configuration Manager“ auf Seite 16
G
„Ausführen von LiveCycle Configuration Manager zum Konfigurieren und Bereitstellen von
LiveCycle ES“ auf Seite 17
In diesem Kapitel wird davon ausgegangen, dass Sie die Umgebung für das Hosten von LiveCycle ES
vorbereitet und die Dateien der Lösungskomponenten bereits installiert haben. Ist dies nicht der Fall,
finden Sie Informationen im Handbuch Vorbereiten der LiveCycle ES-Installation und unter „Installation der
Dateien für Lösungskomponenten“ auf Seite 12.
Informationen zu LiveCycle Configuration Manager
LiveCycle Configuration Manager ist ein einem Assistenten ähnliches Tool zum Konfigurieren, Bereitstellen
und Überprüfen von LiveCycle ES-Komponenten für die Bereitstellung auf dem Anwendungsserver.
LiveCycle Configuration Manager wird mit den Lösungskomponentendateien installiert, wenn Sie das
Installationsprogramm von LiveCycle ES ausführen. Wenn Sie LiveCycle Configuration Manager ausführen,
geben Sie die zu konfigurierenden LiveCycle ES-Lösungskomponenten sowie alle von
LiveCycle Configuration Manager auszuführenden Aufgaben an.
Sie können LiveCycle Configuration Manager über das Installationsprogramm starten, wenn Sie die
Lösungskomponenten noch während der Installation konfigurieren möchten. Andernfalls können Sie
LiveCycle Configuration Manager später zu einem beliebigen Zeitpunkt ausführen.
Konfigurationsaufgaben:
Um den Anwendungsserver manuell zu konfigurieren und die EAR-Dateien bereitzustellen, führen Sie
die folgenden Aufgaben durch:
1. Führen Sie LiveCycle Configuration Manager aus und wählen Sie die Aufgabe zum Konfigurieren und
Assemblieren der Eigenschaften von LiveCycle ES-Lösungskomponenten und zum Assemblieren der
Komponenten in EAR-Dateien für die Bereitstellung auf dem Anwendungsserver.
16
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Ausführen von LiveCycle Configuration Manager zum Konfigurieren
und Bereitstellen von LiveCycle ES 17
2. Stellen Sie die LiveCycle ES-EAR-Dateien gemäß den Anweisungen in diesem Dokument bereit.
(Siehe „Bereitstellen unter JBoss Application Server“ auf Seite 21.)
3. Führen Sie LiveCycle Configuration Manager aus und wählen Sie die Aufgaben zum Initialisieren der
Datenbank, Bereitstellen von Komponenten und Archiven und Überprüfen der Bereitstellung von
Komponenten und Archiven aus.
4. Überprüfen Sie die bereitgestellten LiveCycle ES-Dienste- und -Lösungskomponenten auf Verfügbarkeit
und Betriebsfähigkeit, indem Sie sich an LiveCycle-Verwaltungskonsole anmelden.
Ausführen von LiveCycle Configuration Manager zum
Konfigurieren und Bereitstellen von LiveCycle ES
Beim Ausführen von LiveCycle Configuration Manager können Sie die Aufgaben auswählen, die von dem
Programm automatisch durchgeführt werden sollen.
Tipp: LiveCycle Configuration Manager überprüft die in den einzelnen Bildschirmen angegebenen Werte,
wenn Sie auf „Weiter“ klicken. Wenn ein Wert nicht überprüft werden kann, wird eine Warnmeldung
angezeigt, die entsprechende Eigenschaft wird auf dem Bildschirm rot angezeigt und der Vorgang
kann erst fortgesetzt werden, nachdem Sie einen gültigen Wert eingegeben haben.
Wenn LiveCycle Configuration Manager die Konfiguration abschließt, werden die bereitzustellenden
Dateien auf den Anwendungsserver (adobe-livecycle-native-[BS].ear, adobe-livecycle.ear, and
adobe-workspace-client.ear) in das folgende Verzeichnis kopiert:
G
(Windows) [LiveCycle ES-Stammverzeichnis]\configurationManager\export
G
(Linux) [LiveCycle ES-Stammverzeichnis]/configurationManager/export
Wenn Sie LiveCycle ES manuell auf dem Anwendungsserver bereitstellen wollen, finden Sie die Dateien im
entsprechenden Verzeichnis.
® So führen Sie Konfigurations- oder Bereitstellungsaufgaben mithilfe von
LiveCycle Configuration Manager durch:
1. Starten Sie den Anwendungsserver.
2. Starten Sie LiveCycle Configuration Manager, indem Sie zum Verzeichnis
„[LiveCycle ES-Stammverzeichnis]/configurationManager/bin“ wechseln und den folgenden
Befehl eingeben:
G
(Windows) ConfigurationManager.bat
G
(Linux) ./ConfigurationManager.sh
3. Klicken Sie im Begrüßungsbildschirm auf Weiter.
4. Vergewissern Sie sich im Bildschirm Auswahl der Aktualisierungsaufgaben, dass Von LiveCycle 7.x
aktualisieren nicht aktiviert ist, und klicken Sie dann auf Weiter.
5. Wählen Sie im Bildschirm Auswahl von Lösungskomponenten die LiveCycle ES-Lösungskomponenten
aus, die Sie konfigurieren und bereitstellen möchten, und klicken Sie auf Weiter.
6. Wählen Sie im Bildschirm Taskauswahl alle Aufgaben aus, die durchgeführt werden sollen, und klicken
Sie auf Weiter.
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Ausführen von LiveCycle Configuration Manager zum Konfigurieren
und Bereitstellen von LiveCycle ES 18
Hinweis: Wenn Sie LiveCycle ES nicht mit LiveCycle Configuration Manager bereitstellen möchten,
wählen Sie nur die Aufgabe LiveCycle ES konfigurieren aus. Wenn Sie diese Aufgabe in
LiveCycle Configuration Manager abgeschlossen haben, stellen Sie die konfigurierten
EAR-Dateien gemäß den Anweisungen in „Bereitstellen unter JBoss Application Server“ auf
Seite 21 bereit. Kehren Sie dann zu LiveCycle Configuration Manager zurück, um die
Datenbank zu initialisieren und die Komponentendateien bereitzustellen und zu überprüfen.
(Siehe „Nächste Schritte“ auf Seite 19.)
Vorsicht: Importieren Sie nicht die LiveCycle ES-Beispiele, wenn Sie eine der folgenden Aufgaben
ausführen:
G
LiveCycle ES auf einem Produktionssystem bereitstellen. Beim Importieren der Beispiele
werden Benutzer mit Standardkennwörtern erstellt, die ein Sicherheitsrisiko für Ihre
Produktionsumgebung darstellen können.
G
Wenn Sie den Dienst Connector für EMC Documentum oder Connector für IBM FileNet
bereitstellen und LiveCycle ES-Beispiele in das Documentum-Repository oder den
FileNet-Objektspeicher importieren möchten, müssen Sie diesen Schritt überspringen.
Sie können die Beispiele importieren, nachdem Sie das Enterprise Content
Management-System (ECM) mithilfe von LiveCycle-Verwaltungskonsole als
Repository-Provider konfiguriert und aktiviert haben. Weitere Informationen finden Sie
unter „Konfigurieren des Connector für EMC Documentum-Dienstes“ auf Seite 28 oder
„Konfigurieren des Connector für IBM FileNet-Dienstes“ auf Seite 33.
7. Befolgen Sie die Anweisungen, die in den Bildschirmen von LiveCycle Configuration Manager
angezeigt werden. Weitere Informationen zum Inhalt oder den erforderlichen Eingaben für die
Bildschirme erhalten Sie, indem Sie F1 auf der Tastatur drücken, um die Hilfe zum jeweiligen
Bildschirm anzuzeigen.
Hinweis: In LiveCycle Configuration Manager müssen Sie die IP-Adresse oder den qualifizierten
Hostnamen des Servers angeben, auf dem der Anwendungsserver ausgeführt wird.
Der Standardwert localhost kann nicht verwendet werden.
Vorsicht: LiveCycle Configuration Manager kann WebSphere Application Server nicht konfigurieren,
wenn die globale Sicherheit aktiviert ist – Sie müssen dies manuell tun (siehe „Konfigurieren von
WebSphere Application Server bei aktivierter globaler Sicherheit“ auf Seite 26).
Im Verlauf der Konfiguration müssen Sie den Speicherort der JDBC-Treiber für Ihre Datenbank angeben.
In den folgenden Abschnitten werden die Speicherorte dieser Treiber angegeben. Die Oracle-, MySQLund DB2-Treiber befinden sich im Verzeichnis [LiveCycle ES-Stammverzeichnis]/lib/db/[Datenbank].
Installieren Sie den SQL Server-Datenbanktreiber, falls noch nicht erfolgt.
® So installieren Sie den SQL Server-Datenbanktreiber:
1. Laden Sie den Datenbanktreiber SQL Server 2005 JDBC 1.1 von der Microsoft-Website ab.
2. (Windows) Führen Sie die Datei aus. Extrahieren Sie die Dateien in ein temporäres Verzeichnis (das im
Rest dieses Abschnitts als [SQL Server-Stammverzeichnis] bezeichnet wird).
3. (Linux) Extrahieren Sie die Dateien mit der Erweiterung „*.tar.gz“ in ein temporäres Verzeichnis (das im
Rest dieses Abschnitts als [SQL Server-Stammverzeichnis] bezeichnet wird). Die JDBC-Treiberdatei heißt
„[SQL-Stammverzeichnis]/sqljdbc_1.1/enu/sqljdbc.jar“.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren von LiveCycle ES für die Bereitstellung
Speichern von Konfigurationen in LiveCycle Configuration Manager
19
Speichern von Konfigurationen in LiveCycle Configuration Manager
Wenn Sie in LiveCycle Configuration Manager eine Folge von Konfigurationsoptionen festgelegt haben,
können Sie die Konfigurationsinformationen so speichern, dass Sie bei erneuter Ausführung von
LiveCycle Configuration Manager dieselben Konfigurationseinstellungen verwenden können. Wenn Sie
LiveCycle Configuration Manager erneut ausführen, können Sie die gespeicherte Konfiguration auswählen,
woraufhin die Felder mit den gespeicherten Informationen ausgefüllt werden.
Konfigurationsinformationen werden mit der Dateinamenerweiterung „.properties“ gespeichert.
In LiveCycle Configuration Manager können Sie alle aktuellen Werte auf die Standardwerte zurücksetzen.
® So speichern Sie eine Konfiguration:
1. Wählen Sie in LiveCycle Configuration Manager unten im Bildschirm Menü anzeigen aus.
2. Wählen Sie Konfigurationen > Speichern unter aus.
3. Wechseln Sie zum Verzeichnis, in dem Sie die Konfiguration speichern möchten, geben Sie einen
Namen für die Konfiguration ein und klicken Sie auf Speichern.
® So öffnen Sie eine gespeicherte Konfiguration:
1. Wählen Sie in LiveCycle Configuration Manager unten im Bildschirm Menü anzeigen aus, falls nicht
bereits ausgewählt.
2. Wählen Sie Konfigurationen > Öffnen aus.
3. Wählen Sie die gewünschte Konfiguration aus und klicken Sie auf Öffnen.
® So stellen Sie Standardwerte wieder her:
1. Wählen Sie in LiveCycle Configuration Manager unten im Bildschirm Menü anzeigen aus, falls nicht
bereits ausgewählt.
2. Wählen Sie Konfigurationen > Auf Standardeinstellungen zurücksetzen aus.
Nächste Schritte
Wenn Sie LiveCycle ES mithilfe von LiveCycle Configuration Manager konfiguriert und bereitgestellt
haben, können Sie jetzt wie folgt vorgehen:
G
Überprüfen Sie die Bereitstellung. (Siehe „Abschließende Einrichtung für LiveCycle
Rights Management ES“ auf Seite 23.)
G
Greifen Sie auf die LiveCycle-Verwaltungskonsole zu. (Siehe „Zugreifen auf
LiveCycle-Verwaltungskonsole“ auf Seite 23.)
G
Konfigurieren Sie LiveCycle-Lösungskomponenten für den Zugriff auf LDAP. (Siehe „Konfigurieren von
LiveCycle ES fur den LDAP-Zugriff“ auf Seite 26.)
G
Deinstallieren Sie LiveCycle ES. (Siehe „Deinstallieren von LiveCycle ES“ auf Seite 36.)
4
Bereitstellen von LiveCycle ES unter JBoss Application Server
Dieses Kapitel beschreibt die Bereitstellung von LiveCycle ES unter JBoss Application Server:
G
„Bereitstellen von LiveCycle ES-Lösungskomponenten“ auf Seite 20
G
„Übersicht der bereitstellbaren Komponenten“ auf Seite 20
G
„Bereitstellen unter JBoss Application Server“ auf Seite 21
Bereitstellen von LiveCycle ES-Lösungskomponenten
Bevor Sie LiveCycle ES bereitstellen, vergewissern Sie sich, dass Sie die folgenden Aufgaben ausgeführt
haben:
G
Sie haben die erforderliche Software und die notwendigen Dateien installiert und kennen die
Verzeichnispfade, die Sie zur Arbeit benötigen. Falls Sie diese Aufgabe nicht ausgeführt haben,
finden Sie weitere Informationen unter Vorbereiten der LiveCycle ES-Installation unter
http://www.adobe.com/go/learn_lc_prepareInstall_de.
G
Sie haben LiveCycle Configuration Manager ausgeführt und die LiveCycle ES-Lösungskomponenten
gemäß Ihren spezifischen Anforderungen an System- und Anwendungsserver konfiguriert und
assembliert. Falls Sie nach der Bereitstellung eine Lösungskomponente hinzufügen müssen, führen
Sie LiveCycle Configuration Manager aus, um die gewünschten Änderungen vorzunehmen, und stellen
Sie anschließend die aktualisierte EAR-Datei erneut bereit.
Wenn Sie LiveCycle ES zum ersten Mal bereitstellen, müssen Sie LiveCycle ES nach der Bereitstellung des
Produkts mithilfe von LiveCycle Configuration Manager initialisieren.
Wenn Sie einen externen Webserver verwenden, finden Sie Informationen bezüglich der Konfiguration
zum Erteilen des Zugriffs auf den Anwendungsserver in der Dokumentation zum Webserver.
Übersicht der bereitstellbaren Komponenten
Bei der Bereitstellung müssen Sie die folgenden Komponenten für LiveCycle ES bereitstellen.
G
adobe-livecycle-native-jboss-[BS].ear
G
adobe-livecycle-jboss.ear
G
adobe-workspace-client.ear (nur LiveCycle Process Management ES)
Nach der Konfiguration von LiveCycle ES mithilfe von LiveCycle Configuration Manager (erforderlich) befinden
sich diese Dateien im Verzeichnis „[LiveCycle ES-Stammverzeichnis]/configurationManager/export/“.
20
Adobe LiveCycle ES
Bereitstellen von LiveCycle ES unter JBoss Application Server
Installieren und Bereitstellen von LiveCycle ES für JBoss
Bereitstellen unter JBoss Application Server
21
Bereitstellen unter JBoss Application Server
LiveCycle ES-Lösungskomponenten werden unter JBoss Application Server durch Kopieren der
bereitstellbaren Komponenten in das Bereitstellungsverzeichnis bereitgestellt. JBoss Application Server
kann ausgeführt werden oder beendet sein, wenn Sie die Dateien in die Verzeichnisse kopieren. Wenn Sie
die Dateien kopiert haben, müssen Sie den Server starten bzw. neu starten, um sicherzugehen, dass die
Dienste ordnungsgemäß gestartet werden.
® So stellen Sie LiveCycle ES-Lösungskomponenten unter JBoss Application Server bereit:
G
Kopieren Sie die folgenden Dateien aus dem Verzeichnis
„[LiveCycle ES-Stammverzeichnis]/configurationManager/export“ in das Verzeichnis
„[Anwendungsserver-Stammverzeichnis]/server/all/deploy“:
G
adobe-livecycle-native-jboss-[BS].ear
G
adobe-livecycle-jboss.ear
G
adobe-workspace-client.ear (nur LiveCycle Process Management ES)
Nächste Schritte
Sie müssen LiveCycle Configuration Manager ausführen, um die Datenbank zu initialisieren und
die Komponenten und LiveCycle ES-Archivdateien (LCAs) bereitzustellen. Sie können außerdem
die Bereitstellung der Komponenten und LCAs überprüfen lassen. (Siehe „Ausführen von
LiveCycle Configuration Manager zum Konfigurieren und Bereitstellen von LiveCycle ES“ auf Seite 17.)
5
Aktivitäten nach der Bereitstellung
In diesem Kapitel wird beschrieben, wie über den Zugriff auf LiveCycle-Verwaltungskonsole und die
Überprüfung der Protokolldateien des Anwendungsservers die Bereitstellung überprüft werden kann.
In diesem Kapitel werden auch die ersten Arbeitsschritte nach der Installation, Konfiguration und
Bereitstellung der LiveCycle ES-Lösungskomponenten auf dem Anwendungsserver beschrieben:
G
„Konfigurieren von Acrobat 8.1 für PDF Generator ES“ auf Seite 22
G
„Abschließende Einrichtung für LiveCycle Rights Management ES“ auf Seite 23
G
„Überprüfen der Bereitstellung und Zugreifen auf LiveCycle-Verwaltungskonsole“ auf Seite 23
G
„Zugriff auf die Webanwendungen der Lösungskomponente“ auf Seite 24
G
„Zugreifen auf User Management“ auf Seite 25
G
„Konfigurieren von LiveCycle ES fur den LDAP-Zugriff“ auf Seite 26
G
„Leistungsparameter für überwachte Ordner in PDF Generator ES“ auf Seite 27
G
„Konfigurieren des FIPS-Modus“ auf Seite 27
G
„Konfigurieren von Einstellungen für eine digitale HTML-Signatur“ auf Seite 28
G
„Konfigurieren des Connector für EMC Documentum-Dienstes“ auf Seite 28
G
„Konfigurieren des Connector für IBM FileNet-Dienstes“ auf Seite 33
G
„Deinstallieren von LiveCycle ES“ auf Seite 36
Nachdem Sie die Einstellungen in diesem Kapitel konfiguriert haben, sollten Sie das Dokument Verwalten
von LiveCycle ES unter help.adobe.com/de_DE/livecycle/es/admin_guide.pdf lesen. Es enthält zusätzliche
Informationen zum Konfigurieren der LiveCycle ES-Umgebung für die Bereitstellung und Produktion.
Konfigurieren von Acrobat 8.1 für PDF Generator ES
Hinweis: Dieser Vorgang wird nur auf der Windows-Plattform unterstützt.
Wenn Sie Acrobat 8.1 nicht mithilfe des LiveCycle ES-Installationsprogramms installiert haben, müssen
Sie die folgenden Schritte durchführen, um Acrobat 8.1 für die Verwendung mit PDF Generator ES
einzurichten.
® So konfigurieren Sie Acrobat 8.1 für die Verwendung mit PDF Generator ES:
1. Wenn eine frühere Acrobat-Version (8.0 oder früher) installiert ist, deinstallieren Sie Acrobat über das
Fenster „Software“ in der Windows-Systemsteuerung.
2. Navigieren Sie zu einem der folgenden Ordner auf dem LiveCycle ES-Installationsmedium:
G
additional\acrobat\efg\
G
additional\acrobat\jpn\
3. Installieren Sie Acrobat 8.1, indem Sie die Datei „AutoPlay.exe“ ausführen.
4. Wechseln Sie zum Stammverzeichnis des LiveCycle ES-Installationsmediums.
5. Führen Sie die folgende Stapelverarbeitungsdatei aus:
Acrobat_for_PDFG_Configuration.bat [LiveCycle ES-Stammverzeichnis]
22
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Abschließende Einrichtung für LiveCycle Rights Management ES
23
® So überprüfen Sie die Installation von Acrobat 8.1:
1. Wechseln Sie zu einer PDF-Datei im System und doppelklicken Sie darauf, um sie in Acrobat zu öffnen.
2. Wird die PDF-Datei geöffnet, wurde Acrobat 8.1 ordnungsgemäß installiert. Wird die PDF-Datei nicht
ordnungsgemäß geöffnet, müssen Sie Acrobat deinstallieren und anschließend neu installieren.
Hinweis: Vergewissern Sie sich, dass alle nach dem Abschluss der Acrobat-Installation angezeigten
Dialogfelder geschlossen werden, und deaktivieren Sie die automatische Aktualisierung
für Acrobat.
Legen Sie die Umgebungsvariable Acrobat_PATH so fest, dass sie auf Acrobat.exe verweist
(z. B. C:\Programme\Adobe\Acrobat 8.0\Acrobat\Acrobat.exe).
Abschließende Einrichtung für LiveCycle Rights Management ES
Für Rights Management ES muss der Anwendungsserver für die Verwendung von SSL konfiguriert sein.
Anweisungen zur Konfiguration finden Sie in Verwalten von LiveCycle ES unter
help.adobe.com/de_DE/livecycle/es/admin_guide.pdf.
Überprüfen der Bereitstellung und Zugreifen auf
LiveCycle-Verwaltungskonsole
Sie können die Bereitstellung überprüfen, indem Sie sich an der LiveCycle-Verwaltungskonsole anmelden.
Wenn Sie sich nicht anmelden können, wird LiveCycle ES auf dem Anwendungsserver ausgeführt und der
Standardbenutzer wurde in der Datenbank erstellt.
Sie können die Protokolldateien des Anwendungsservers überprüfen, um sicherzustellen, dass Komponenten
ordnungsgemäß bereitgestellt wurden, oder die Ursachen eventuell aufgetretener Bereitstellungsprobleme
bestimmen.
Zugreifen auf LiveCycle-Verwaltungskonsole
Bei LiveCycle-Verwaltungskonsole handelt es sich um ein webbasiertes Portal, über das Sie auf
zahlreiche Konfigurationsseiten zugreifen können. Auf den Konfigurationsseiten können Sie
Laufzeiteigenschaften festlegen, welche die Funktionsweise von LiveCycle ES steuern. Wenn Sie
sich an LiveCycle-Verwaltungskonsole anmelden, erhalten Sie Zugriff auf die User Management-,
Überwachter Ordner- und E-Mail-Clients-Konfiguration sowie auf administrative Konfigurationsoptionen
für andere Dienste. Über die LiveCycle-Verwaltungskonsole greifen Sie auch auf Archivverwaltung zu,
mit deren Hilfe Administratoren Archive verwalten und Dienste in einer Produktionsumgebung
bereitstellen.
Der standardmäßige Benutzername für die Anmeldung an LiveCycle-Verwaltungskonsole lautet
administrator und das Standardkennwort password. Nach der ersten Anmeldung können Sie das
Standardkennwort mithilfe von User Management ändern.
Bevor Sie auf LiveCycle-Verwaltungskonsole zugreifen, muss LiveCycle ES auf dem Anwendungsserver
bereitgestellt sein und ausgeführt werden.
Informationen zum Verwenden der LiveCycle-Verwaltungskonsole finden Sie in der Archivverwaltungshilfe,
die über das Hilfe-Menü des Fensters der LiveCycle-Verwaltungskonsole aufgerufen werden kann.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Anzeigen der Protokolldateien
24
® So greifen Sie auf LiveCycle-Verwaltungskonsole zu:
1. Geben Sie in einem Webbrowser den folgenden URL ein:
http://[Hostname]:[Anschluss]/adminui
Der Standardanschluss für JBoss ist „8080“.
2. Geben Sie in das Feld Benutzername den Wert administrator und in das Feld Kennwort den
Wert password ein.
3. Nachdem Sie sich angemeldet haben, können Sie auf Dienste klicken, um die Dienstverwaltungsseiten
aufzurufen, oder auf Einstellungen klicken, um die Seiten für die Verwaltung der Einstellungen für
andere Lösungskomponenten anzuzeigen.
Anzeigen der Protokolldateien
Ereignisse wie Laufzeit- oder Startfehler werden in die Protokolldateien des Anwendungsservers
geschrieben. Wenn bei der Bereitstellung auf dem Anwendungsserver Probleme auftreten, können
Sie diese mithilfe der Protokolldateien identifizieren. Sie können die Protokolldateien in einem
beliebigen Texteditor öffnen.
Zugriff auf die Webanwendungen der Lösungskomponente
Nach der Bereitstellung von LiveCycle ES können Sie auf die Webanwendungen zugreifen, die den
folgenden Lösungskomponenten zugeordnet sind:
G
LiveCycle Reader Extensions ES
G
LiveCycle Workspace ES
G
LiveCycle Rights Management ES
Nach dem Zugriff auf die Webanwendungen mithilfe der standardmäßigen Administratorberechtigungen,
um zu prüfen, ob ein Zugriff möglich ist, können Sie weitere Benutzer und Rollen erstellen, damit andere
Benutzer sich anmelden und die Anwendungen nutzen können. Informationen finden Sie in der
User Management-Hilfe unter der Adresse www.adobe.com/go/learn_lc_adminUM_de.
® So greifen Sie auf die Reader Extensions ES-Webanwendung zu:
Hinweis: Sie müssen eine Reader Extension-Berechtigung zuweisen und einem neuen Benutzer die
Benutzerrollen zuordnen. Weitere Informationen finden Sie in Verwalten von LiveCycle ES im
Kapitel „SSL-Konfiguration“.
1. Öffnen Sie einen Webbrowser und geben Sie diese Adresse ein:
http://localhost:8080/ReaderExtensions
(lokale Bereitstellung, die den Standardanschluss verwendet).
2. Melden Sie sich mit dem standardmaßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
Hinweis: Sie benötigen Administrator- oder Hauptbenutzerberechtigungen, um sich mit dem
standardmäßigen Benutzernamen und Kennwort anmelden zu können. Um anderen
Benutzern den Zugriff auf die Webanwendung Reader Extensions ES zu erlauben,
müssen Sie die Benutzer in User Management erstellen und ihnen die Rolle „Reader
Extensions-Webanwendung“ zuweisen.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Zugreifen auf Rights Management ES:
25
® So greifen Sie auf Workspace ES zu:
1. Öffnen Sie einen Webbrowser und geben Sie diese Adresse ein:
http://localhost:8080/workspace
(lokale Bereitstellung, die den Standardanschluss verwendet).
2. Melden Sie sich mit dem standardmaßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
Zugreifen auf Rights Management ES:
Sie müssen in User Management einen Benutzer mit der Rolle „RM-Endbenutzerkonsole“
erstellen und sich mit den diesem Benutzer zugeordneten Anmeldeinformationen bei der
Rights Management ES-Administrator- oder Endbenutzeranwendung anmelden.
® So greifen Sie auf die Rights Management ES-Webanwendung für Endbenutzer zu:
1. Öffnen Sie einen Webbrowser und geben Sie diese Adresse ein:
http://[Server]:[Anschluss]/edc/Login.do
Hinweis: Der Administratorbenutzer kann nicht auf die Rights Management ES-Webanwendung
für Endbenutzer zugreifen. Sie können neue Benutzer mithilfe der
Administratorbenutzeroberfläche von LiveCycle ES erstellen.
® So greifen Sie auf die Rights Management ES-Webanwendung für Administratoren zu:
1. Öffnen Sie einen Webbrowser und geben Sie diese Adresse ein:
http://[Server]:[Anschluss]/adminui
Zugreifen auf User Management
Mit User Management können Administratoren eine Datenbank aller Benutzer und Gruppen
verwalten, die mit einem oder mehreren Benutzerverzeichnissen von Drittanbietern synchronisiert ist.
User Management ermöglicht die Authentifizierung, Autorisierung und Benutzerverwaltung für
LiveCycle ES-Lösungskomponenten wie Reader Extensions ES, Workspace ES, Rights Management ES,
LiveCycle Process Management ES und LiveCycle Forms ES.
® So greifen Sie auf User Management zu:
1. Melden Sie sich an LiveCycle-Verwaltungskonsole an.
2. Klicken Sie auf der Startseite von LiveCycle-Verwaltungskonsole auf Einstellungen.
3. Klicken Sie auf der Seite Einstellungen auf User Management.
Hinweis: Informationen zum Konfigurieren von Benutzern mit User Management erhalten Sie, wenn Sie
rechts oben auf der User Management-Seite auf User Management-Hilfe klicken.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren von LiveCycle ES fur den LDAP-Zugriff
Konfigurieren von LiveCycle ES fur den LDAP-Zugriff
Orientieren Sie sich beim Konfigurieren von User Management für die Unterstützung der
Authentifizierung mit LDAP am nachfolgend beschriebenen Verfahren.
® So konfigurieren Sie User Management mit LDAP (Unternehmensdomäne):
1. Öffnen Sie einen Webbrowser, wechseln Sie zu http://[Hostname]:[Anschluss]/adminui und
melden Sie sich an. (Siehe „Zugreifen auf LiveCycle-Verwaltungskonsole“ auf Seite 23.)
2. Klicken Sie auf Einstellungen > User Management > Domänenverwaltung und dann auf
Neue Unternehmensdomäne.
3. Geben Sie in das Feld ID einen eindeutigen Bezeichner für die Domäne ein.
4. Geben Sie in das Feld Name einen aussagekräftigen Namen für die Domäne ein.
5. Klicken Sie auf Authentifizierung hinzufügen und wählen Sie in der Liste
Authentifizierungsanbieter den Eintrag LDAP aus.
6. Klicken Sie auf OK.
7. Klicken Sie auf Verzeichnis hinzufügen und wählen Sie unter Profilname einen Namen für Ihr
LDAP-Profil aus.
8. Klicken Sie auf Weiter.
9. Geben Sie in die Felder Server, Anschluss, SSL und Bindung die erforderlichen Werte ein.
Informationen zu diesen Einstellungen finden Sie in der User Management-Hilfe unter
www.adobe.com/go/learn_lc_adminUM_de im Abschnitt „Verzeichniseinstellungen“.
10. Wählen Sie unter Seite mit folgenden Elementen füllen eine Verzeichniseinstellung wie
Standardmäßige Sun ONE-Werte aus.
11. Klicken Sie auf Weiter und konfigurieren Sie die Benutzereinstellungen den Anforderungen
entsprechend. Weitere Informationen zu den Einstellungen finden Sie in der User Management-Hilfe
unter „Verzeichniseinstellungen“.
12. Klicken Sie auf Weiter und konfigurieren Sie die Gruppeneinstellungen den Anforderungen
entsprechend. Weitere Informationen zu den Einstellungen finden Sie in der User Management-Hilfe
unter „Verzeichniseinstellungen“.
13. (Optional) Testen Sie die Konfiguration:
G
Klicken Sie auf Testen.
G
Geben Sie im Bereich Verzeichnis testen unter Suchen einen Objektnamen ein und wählen Sie
unter mit: einen Objekttyp wie z. B. Anmelde-ID aus.
G
Klicken Sie auf Testen. Ist der Test erfolgreich, werden die Objektdetails angezeigt. Klicken Sie
auf Zurück.
14. Klicken Sie auf Fertig stellen, um die Seite Neues Verzeichnis zu verlassen, und klicken Sie zum
Beenden erneut auf OK.
26
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Leistungsparameter für überwachte Ordner in PDF Generator ES
27
Leistungsparameter für überwachte Ordner in PDF Generator ES
Um java.io.IOException-Fehlermeldungen zu vermeiden, die darauf hinweisen, dass nicht genügend
Speicherplatz zur Durchführung von PDF-Konvertierungen mithilfe eines überwachten Ordners zur
Verfügung steht, ändern Sie die Einstellungen für PDF Generator ES in LiveCycle-Verwaltungskonsole.
® So legen Sie Leistungsparameter für PDF Generator ES fest:
1. Melden Sie sich an LiveCycle-Verwaltungskonsole an und klicken Sie auf Dienste > Archivverwaltung >
Dienstverwaltung > PDFGConfigService.
2. Legen Sie die folgenden Werte fest:
G
PDFG Cleanup Scan Seconds: 1800
G
Job Expiration Seconds: 6000
3. Erhöhen Sie Server conversion timeout vom Standardwert von 270 auf einen höheren Wert wie
etwa 450.
4. Klicken Sie auf Speichern.
5. Starten Sie den Server neu.
Konfigurieren des FIPS-Modus
LiveCycle ES umfasst einen FIPS-Modus, um den Datenschutz mithilfe des RSA BSAFE Crypto-C 2.1Verschlüsselungsmoduls auf nach dem FIPS-Standard 140-2 (Federal Information Processing Standard)
genehmigte Algorithmen einzuschränken.
Wenn Sie diese Option nicht während der LiveCycle ES-Konfiguration mithilfe von
LiveCycle Configuration Manager aktivieren oder die Option aktiviert haben, sie aber deaktivieren
möchten, können Sie diese Einstellung in der LiveCycle-Verwaltungskonsole ändern.
Zum Ändern des FIPS-Modus muss der Server neu gestartet werden.
Im FIPS-Modus werden die in Acrobat-Versionen vor 7.0 verwendeten Verschlüsselungsalgorithmen nicht
unterstützt. Wenn der FIPS-Modus aktiviert ist und Sie den Verschlüsselungsdienst zum Verschlüsseln
einer PDF-Datei mithilfe eines Kennworts mit einem auf Acrobat 5 eingestellten Kompatibilitätsniveau
verwenden, schlägt der Verschlüsselungsversuch mit Ausgabe eines Fehlers fehl.
Wenn FIPS aktiviert ist, wendet der Assembler-Dienst keine Kennwortverschlüsselung auf Dokumente an.
Wird dies dennoch versucht, wird eine FIPSModeException-Ausnahme ausgelöst, die angibt, dass
"Kennwortverschlüsselung im FIPS-Modus nicht zulässig" ist. Darüber hinaus wird das
DDX-Element (Document Description XML) PDFsFromBookmarks im FIPS-Modus nicht unterstützt,
wenn das Basisdokument kennwortverschlüsselt ist.
® So schalten Sie den FIPS-Modus ein oder aus:
1. Melden Sie sich an LiveCycle-Verwaltungskonsole an.
2. Wechseln Sie zu Einstellungen > Core-System > Konfigurationen > Core-Konfigurationen.
3. Wählen Sie FIPS aktivieren aus, um den FIPS-Modus zu aktivieren, oder deaktivieren Sie die Option,
um den FIPS-Modus zu deaktivieren.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren von Einstellungen für eine digitale HTML-Signatur
28
4. Klicken Sie auf OK.
5. Starten Sie den Anwendungsserver neu.
Hinweis: Die LiveCycle ES-Software führt keine Codevalidierung durch, um die FIPS-Kompatibilität
sicherzustellen. Sie bietet einen FIPS-Betriebsmodus, damit die von FIPS genehmigten
Algorithmen aus den durch FIPS genehmigten Bibliotheken (RSA) für Kryptografiedienste
verwendet werden.
Konfigurieren von Einstellungen für eine digitale HTML-Signatur
Um die digitale HTML-Signaturfunktion von LiveCycle Forms ES verwenden zu können, müssen Sie die
folgenden Schritte ausführen.
® So aktivieren Sie die digitale HTML-Signatur:
1. Stellen Sie die Datei „[LiveCycle ES-Stammverzeichnis]/deploy/adobe-forms-ds.ear“ auf Ihrem
Anwendungsserver bereit.
2. Melden Sie sich an LiveCycle ES Administration Console an.
3. Wählen Sie Service > LiveCycle Forms ES aus.
4. Wählen Sie Digitale HTML-Signatur aktiviert aus.
Konfigurieren des Connector für EMC Documentum-Dienstes
Wenn Sie den Connector für EMC Documentum-Dienst als Teil Ihrer LiveCycle ES-Lösung installiert haben,
führen Sie den folgenden Vorgang aus, um den Dienst für das Herstellen von Verbindungen mit dem
Documentum-Repository zu konfigurieren.
® So konfigurieren Sie Connector für EMC Documentum:
1. Suchen Sie die Datei adobe-component-ext.properties im Ordner
[JBOSS -STAMMVERZEICHNIS]/bin. Wenn die Datei nicht vorhanden ist, müssen Sie sie erstellen.
Fügen Sie eine neue Systemeigenschaft hinzu, die den Speicherort des Documentum-Content
Server-Konfigurationsordners und die folgenden JAR-Dateien der Documentum Foundation
Classes enthält:
G
dfc.jar
G
dfcbase.jar
Die neue Systemeigenschaft sollte diese Form aufweisen:
[Komponenten-ID]_[Komponentenversion].ext=[JAR-Dateien und/oder Ordner]
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren des Connector für EMC Documentum-Dienstes
29
Beispielsweise kann ausgehend von der Standardinstallation von Content Server und Documentum
Foundation Classes die folgende Systemeigenschaft in einer neuen Zeile hinzugefügt werden – es
dürfen keine Zeilenumbrüche verwendet und die Zeile muss mit einem Wagenrücklauf abgeschlossen
werden:
com.adobe.livecycle.ConnectorforEMCDocumentum_8.0.3174.1.156395.1.ext
=C:/Documentum/Config,C:/Programme/Documentum/Shared/dfc.jar,
C:/Programme/Documentum/Shared/dfcbase.jar
Sie können die Version der Komponente ermitteln, indem Sie sich bei der
LiveCycle-Verwaltungskonsole anmelden, zu Dienste > Archivverwaltung > Dienstverwaltung
navigieren und anschließend nach der Komponente suchen. Die Versionsnummer ist in der Spalte
Komponentenversion aufgelistet.
2. Wenn JBoss Application Server aktuell nicht ausgeführt wird, starten Sie den Server. Beenden Sie
andernfalls den Serverdienst, und starten Sie ihn erneut.
3. Öffnen Sie einen Webbrowser und geben Sie diese URL ein:
http://localhost:8080/adminui (lokale Bereitstellung, die den Standardport verwendet)
4. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
5. Navigieren Sie zu Dienste > LiveCycle ES Connector für EMC Documentum >
Konfigurationseinstellungen.
6. Geben Sie alle erforderlichen Informationen für das Documentum-Repository ein. Um Documentum als
Repository-Provider zu verwenden, wählen Sie im Bereich Repository Service Provider-Informationen
EMC Documentum Repository Provider aus, und klicken Sie dann auf Speichern. Weitere Informationen
über das Documentum-Repository finden Sie in der Documentum-Administrator-Hilfe unter
www.adobe.com/go/learn_lc_adminDocumentum_de.
7. (Optional) Navigieren Sie zu Einstellungen für Repository-Anmeldeinformationen, klicken Sie auf
Hinzufügen, geben Sie die Docbase-Informationen an und klicken Sie dann auf Speichern. Weitere
Informationen über das Documentum-Repository finden Sie in der Documentum-Administrator-Hilfe
unter www.adobe.com/go/learn_lc_adminDocumentum_de.
8. Navigieren Sie zu Dienste > Archivverwaltung > Dienstverwaltung, wählen Sie die folgenden
Dienste aus und klicken Sie dann auf Start:
G
EMCDocumentumAuthProviderService
G
EMCDocumentumContentRepositoryConnector
G
EMCDocumentumRepositoryProvider
Wenn einer der Dienste nicht ordnungsgemäß gestartet wird, überprüfen Sie die in Schritt 6
vorgenommenen Einstellungen.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren des Connector für EMC Documentum-Dienstes
30
9. Führen Sie eine der folgenden Aufgaben aus:
G
Fahren Sie mit diesem Vorgang fort, um den Documentum-Autorisierungsdienst
(EMCDocumentumAuthProviderService) zum Anzeigen der Inhalte eines
Documentum-Repositorys in der Ansicht „Ressourcen“ von Workbench ES zu verwenden.
Beim Verwenden des Documentum-Autorisierungsdiensts wird die standardmäßige
LiveCycle ES-Autorisierung außer Kraft gesetzt. Der Documentum-Autorisierungsdienst
muss für die Anmeldung bei Workbench ES mit Documentum-Anmeldeinformationen
konfiguriert werden.
G
Melden Sie sich zur Verwendung des LiveCycle ES-Repositorys mit den
LiveCycle ES-Superadministrator-Anmeldeinformationen (standardmäßig Administrator und
password) bei Workbench ES an. Sie haben die erforderlichen Schritte für diesen Vorgang jetzt
abgeschlossen. Die in Schritt 6 angegebenen Anmeldeinformationen werden in diesem Fall mithilfe
des standardmäßigen LiveCycle ES-Autorisierungsdiensts für den Zugriff auf das
Standardrepository verwendet.
10. Starten Sie JBoss Application Server erneut.
11. Melden Sie sich bei der LiveCycle-Verwaltungskonsole an, navigieren Sie zu Einstellungen >
Benutzerverwaltung > Domänenverwaltung und klicken Sie auf Neue Unternehmensdomäne.
12. Geben Sie eine ID und einen Namen für die Domäne ein. Die Domänen-ID ist der eindeutige
Bezeichner der Domäne. Der Name ist eine beschreibende Bezeichnung der Domäne.
13. Fügen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:
G
Klicken Sie auf Authentifizierung hinzufügen.
G
Wählen Sie Benutzerdefiniert in der Liste Authentifizierungsanbieter aus und wählen Sie
dann EMCDocumentumAuthProvider.
G
Klicken Sie auf OK.
14. Fügen Sie einen LDAP-Authentifizierungsanbieter hinzu:
G
Klicken Sie auf Authentifizierung hinzufügen.
G
Wählen Sie LDAP in der Liste Authentifizierungsanbieter aus.
G
Klicken Sie auf OK.
15. Fügen Sie ein LDAP-Verzeichnis hinzu:
G
Klicken Sie auf Verzeichnis hinzufügen.
G
Geben Sie im Feld Profilname einen eindeutigen Namen ein, und klicken Sie dann auf Weiter.
G
Geben Sie Werte für die Optionen Server, Anschluss, SSL, Bindung und Seite mit folgenden
Elementen füllen ein. Wenn Sie Benutzer für die Option Bindung auswählen, müssen Sie auch
Werte für die Felder Name und Kennwort eingeben. (Optional) Wählen Sie Basis-DN abrufen aus,
um die Basisdomänennamen abzurufen, falls erforderlich. Klicken Sie auf Weiter, wenn Sie diesen
Schritt abgeschlossen haben.
Informationen über diese Einstellungen finden Sie unter User Management Hilfe unter der Adresse
www.adobe.com/go/learn_lc_adminUM_de.
G
Konfigurieren Sie die Benutzereinstellungen, klicken Sie auf Weiter, konfigurieren Sie ggf.
Gruppeneinstellungen und klicken Sie dann auf Weiter.
Informationen über diese Einstellungen finden Sie unter User Management Hilfe unter der Adresse
www.adobe.com/go/learn_lc_adminUM_de.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Erstellen des XDP MIME-Formats im Documentum-Repository
31
16. Klicken Sie auf OK, um die Seite Verzeichnis hinzufügen zu verlassen, und klicken Sie zum Beenden
erneut auf OK.
17. Wählen Sie die neue Unternehmensdomäne aus, und klicken Sie dann auf Jetzt synchronisieren.
Der Synchronisierungsvorgang kann – je nach der Anzahl der Benutzer und Gruppen im
LDAP-Netzwerk und der Verbindungsgeschwindigkeit – einige Minuten in Anspruch nehmen.
Klicken Sie zum Überprüfen des Synchronisierungsstatus auf Aktualisieren; der Status wird in der
Spalte Aktueller Synchronisierungsstatus angezeigt.
18. Klicken Sie auf Einstellungen > Benutzerverwaltung > Benutzer und Gruppen.
19. Suchen nach Benutzern, die aus LDAP synchronisiert wurden. Wählen Sie einen oder mehrere
Benutzer aus, klicken Sie auf Rolle zuweisen, wählen Sie eine oder mehrere LiveCycle ES-Rolle(n)
aus und klicken Sie dann auf OK. Klicken Sie erneut auf OK, um die Rollenzuweisung zu bestätigen.
Wiederholen Sie diesen Schritt für alle Benutzer, denen Sie Rollen zuweisen möchten. Weitere
Informationen über das Zuweisen von LiveCycle ES-Rollen finden Sie in der User Management-Hilfe
unter der Adresse www.adobe.com/go/learn_lc_adminUM_de.
20. Starten Sie Workbench ES, und melden Sie sich mit den folgenden Anmeldeinformationen an:
Benutzername: [benutzername]@[repository_name]
Kennwort: [kennwort]
Das Documentum-Repository sollte jetzt in der Ansicht „Ressourcen“ in Workbench ES angezeigt
werden. Wenn Sie sich nicht mithilfe von benutzername@repository_name anmelden, versucht
Workbench ES eine Anmeldung beim in Schritt 6 angegebenen Standardrepository.
Sobald Sie den Connector für EMC Documentum-Dienst konfiguriert haben, sollten Sie unter Verwalten
von LiveCycle ES unter der Adresse www.adobe.com/go/learn_lc_administration_de nach Informationen
zur ordnungsgemäßen Konfiguration der Workbench ES-Funktionen mithilfe des
Documentum-Repositorys suchen.
Erstellen des XDP MIME-Formats im Documentum-Repository
Damit Benutzer XDP-Dateien in einem Documentum-Repository speichern oder sie daraus abrufen
können, müssen Sie eine der folgenden Aufgaben ausführen:
G
Ein entsprechendes XDP-Format in jedem Repository erstellen, in dem Benutzer auf XDP-Dateien
zugreifen sollen.
G
Den Connector für EMC Documentum-Dienst für die Verwendung eines
Documentum-Administratorkontos zum Zugriff auf das Documentum-Repository konfigurieren. In
diesem Fall wird das XDP-Format vom Connector für EMC Documentum-Dienst bei Bedarf erstellt.
® So erstellen Sie das XDP-Format auf dem Documentum Content Server mithilfe von
Documentum-Administrator:
1. Melden Sie sich bei Documentum-Administrator an.
2. Klicken Sie auf Formate.
3. Wählen Sie Datei > Neu > Format aus.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Erstellen des XDP MIME-Formats im Documentum-Repository
32
4. Geben Sie die folgenden Informationen in den entsprechenden Feldern ein:
Name: xdp
Standard-Dateierweiterung: xdp
Mime-Typ: application/xdp
5. Wiederholen Sie die Schritte 1 bis 4 fur alle anderen Documentum-Repositorys, in denen von
Benutzern XDP-Dateien gespeichert werden.
® So konfigurieren Sie den Connector für EMC Documentum-Dienst für die Verwendung eines
Documentum-Administrators:
1. Öffnen Sie einen Webbrowser und geben Sie diese Adresse ein:
http://localhost:8080/adminui (lokale Bereitstellung, die den Standardport verwendet)
2. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
3. Klicken Sie auf Dienste > LiveCycle ES Connector für EMC Documentum >
Konfigurationseinstellungen.
4. Aktualisieren Sie im Abschnitt Documentum-Prinzipalanmeldeinformationen die folgenden
Informationen:
Benutzername: [Documentum-Administrator-Benutzername]
Kennwort: [Documentum-Administrator-Kennwort]
5. Klicken Sie auf Einstellungen für Repository-Anmeldeinformationen.
6. Wählen Sie in der Liste ein Repository aus oder, wenn keine Repositorys vorhanden sind, klicken Sie auf
Hinzufügen.
7. Geben Sie die folgenden Informationen ein:
Repository-Name: [Repository-Name]
Repository-Anmeldeinformationen-Benutzername: [Documentum-Administrator-Benutzername]
Repository-Anmeldeinformationen-Kennwort: [Documentum-Administrator-Kennwort]
8. Klicken Sie auf Speichern.
9. Wiederholen Sie die Schritte 7 9 für alle Repositorys, in denen Benutzer XDP-Dateien speichern sollen.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren des Connector für IBM FileNet-Dienstes
33
Konfigurieren des Connector für IBM FileNet-Dienstes
Wenn Sie den Connector für IBM FileNet-Dienst als Teil Ihrer LiveCycle ES-Lösung installiert haben,
führen Sie den folgenden Vorgang aus, um den Dienst für das Herstellen von Verbindungen mit dem
FileNet-Objektspeicher zu konfigurieren.
® So konfigurieren Sie Connector für IBM FileNet:
1. Suchen Sie die Datei adobe-component-ext.properties im Ordner
[JBOSS -STAMMVERZEICHNIS]/bin. Wenn die Datei nicht vorhanden ist, müssen Sie sie erstellen.
Fügen Sie eine neue Systemeigenschaft hinzu, die den Speicherort der folgenden JAR-Dateien des
Anwendungsmoduls angibt:
G
activation.jar
G
javaapi.jar
G
log4j-1.2.8.jar
G
mailapi.jar
G
p8cjares.jar
G
soap.jar
G
xercesimpl.jar
G
xml-apis.jar
Die neue Systemeigenschaft sollte diese Form aufweisen:
[Komponenten-ID]_[Komponentenversion].ext=[JAR-Dateien und/oder Ordner]
Beispielsweise kann ausgehend von der Standardinstallation des Anwendungsmoduls der Datei
die folgende Systemeigenschaft in einer neuen Zeile hinzugefügt werden – es dürfen keine
Zeilenumbrüche verwendet und die Zeile muss mit einem Wagenrücklauf abgeschlossen werden:
com.adobe.livecycle.ConnectorforIBMFileNet_8.0.3174.1.156395.1.ext=
C:/Programme/FileNet/lib2/activation.jar,
C:/Programme/FileNet/lib2/javaapi.jar,
C:/Programme/FileNet/lib2/log4j-1.2.8.jar,
C:/Programme/FileNet/lib2/mailapi.jar,
C:/Programme/FileNet/lib2/p8cjares.jar,
C:/Programme/FileNet/lib2/soap.jar,
C:/Programme/FileNet/lib2/xercesImpl.jar,
C:/Programme/FileNet/lib2/xml-apis.jar
Sie können die Version der Komponente ermitteln, indem Sie sich bei der
LiveCycle-Verwaltungskonsole anmelden, zu Dienste > Archivverwaltung > Dienstverwaltung
navigieren und anschließend nach der Komponente suchen. Die Versionsnummer ist in der Spalte
Komponentenversion aufgelistet.
2. Wenn JBoss Application Server aktuell nicht ausgeführt wird, starten Sie den Server. Beenden Sie
andernfalls den Serverdienst, und starten Sie ihn erneut.
3. Öffnen Sie einen Webbrowser und geben Sie diese URL ein:
http://localhost:8080/adminui (lokale Bereitstellung, die den Standardport verwendet)
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren des Connector für IBM FileNet-Dienstes
34
4. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
5. Navigieren Sie zu Dienste > LiveCycle ES Connector für IBM FileNet >
Konfigurationseinstellungen.
6. Geben Sie im Bereich Repository Service Provider-Informationen alle erforderlichen
FileNet-Repository-Informationen ein, wählen Sie IBM FileNet Repository Provider aus und
klicken dann auf Speichern. Weitere Informationen über das FileNet-Repository finden Sie in
der FileNet-Administrator-Hilfe unter www.adobe.com/go/learn_lc_adminFileNet_de.
Hinweis: Die in diesem Schritt eingegebenen Anmeldeinformationen werden beim Starten der IBM
FileNet-Repositorydienste im nächsten Schritt überprüft. Wenn die Anmeldeinformationen
ungültig sind, wird ein Fehler ausgegeben und das Starten der Dienste schlägt fehl.
7. Wechseln Sie zu Dienste > Archivverwaltung > Dienstverwaltung, wählen Sie die folgenden Dienste
aus und klicken Sie dann auf Starten:
G
IBMFileNetAuthProviderService
G
IBMFileNetContentRepositoryConnector
G
IBMFileNetRepositoryProvider
Wenn einer der Dienste nicht ordnungsgemäß gestartet wird, überprüfen Sie die in Schritt 6
vorgenommenen Einstellungen.
8. Führen Sie eine der folgenden Aufgaben aus:
G
Fahren Sie mit diesem Vorgang fort, um den FileNet-Autorisierungsdienst
(IBMFileNetAuthProviderService) zum Anzeigen der Inhalte eines FileNet-Objektspeichers in
der Ansicht "Ressourcen" von Workbench ES zu verwenden. Beim Verwenden des
FileNet-Autorisierungsdiensts wird die standardmäßige LiveCycle ES-Autorisierung außer Kraft
gesetzt. Der FileNet-Autorisierungsdienst muss für die Anmeldung bei Workbench ES mit
FileNet-Anmeldeinformationen konfiguriert werden.
G
Melden Sie sich zur Verwendung des LiveCycle ES-Repositorys mit den
LiveCycle ES-Superadministrator-Anmeldeinformationen (standardmäßig Administrator und
password) bei Workbench ES an. Sie haben die erforderlichen Schritte für diesen Vorgang jetzt
abgeschlossen. Die in Schritt 6 angegebenen Anmeldeinformationen verwenden in diesem Fall den
standardmäßigen LiveCycle ES-Autorisierungsdienst für den Zugriff auf das Standardrepository.
9. Starten Sie JBoss Application Server erneut.
10. Melden Sie sich bei der LiveCycle-Verwaltungskonsole an, navigieren Sie zu Einstellungen >
Benutzerverwaltung > Domänenverwaltung und klicken Sie auf Neue Unternehmensdomäne.
11. Geben Sie eine ID und einen Namen für die Domäne ein. Die Domänen-ID ist der eindeutige
Bezeichner der Domäne. Der Name ist eine beschreibende Bezeichnung der Domäne.
12. Fügen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:
G
Klicken Sie auf Authentifizierung hinzufügen.
G
Wählen Sie Benutzerdefiniert in der Liste Authentifizierungsanbieter aus und wählen Sie dann
IBMFileNetAuthProviderService.
G
Klicken Sie auf OK.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren des Connector für IBM FileNet-Dienstes
35
13. Fügen Sie einen LDAP-Authentifizierungsanbieter hinzu:
G
Klicken Sie auf Authentifizierung hinzufügen.
G
Wählen Sie LDAP in der Liste Authentifizierungsanbieter aus.
G
Klicken Sie auf OK.
14. Fügen Sie ein LDAP-Verzeichnis hinzu:
G
Klicken Sie auf Verzeichnis hinzufügen.
G
Geben Sie im Feld Profilname einen eindeutigen Namen ein, und klicken Sie dann auf Weiter.
G
Geben Sie Werte für die Optionen Server, Anschluss, SSL, Bindung und Seite mit folgenden
Elementen füllen ein. Wenn Sie Benutzer für die Option Bindung auswählen, müssen Sie auch
Werte für die Felder Name und Kennwort eingeben. (Optional) Wählen Sie Basis-DN abrufen aus,
um die Basisdomänennamen abzurufen, falls erforderlich. Klicken Sie auf Weiter, wenn Sie diesen
Schritt abgeschlossen haben.
Informationen über diese Einstellungen finden Sie unter User Management Hilfe unter der Adresse
http://www.adobe.com/go/learn_lc_adminUM_de.
G
Konfigurieren Sie die Benutzereinstellungen, klicken Sie auf Weiter, konfigurieren Sie ggf.
Gruppeneinstellungen und klicken Sie dann auf Weiter.
Informationen über diese Einstellungen finden Sie unter User Management Hilfe unter der Adresse
http://www.adobe.com/go/learn_lc_adminUM_de.
15. Klicken Sie auf OK, um die Seite Verzeichnis hinzufügen zu verlassen, und klicken Sie zum Beenden
erneut auf OK.
16. Wählen Sie die neue Unternehmensdomäne aus, und klicken Sie dann auf Jetzt synchronisieren.
Der Synchronisierungsvorgang kann – je nach der Anzahl der Benutzer und Gruppen im
LDAP-Netzwerk und der Verbindungsgeschwindigkeit – einige Minuten in Anspruch nehmen.
Klicken Sie zum Überprüfen des Synchronisierungsstatus auf Aktualisieren; der Status wird in der
Spalte Aktueller Synchronisierungsstatus angezeigt.
17. Klicken Sie auf Einstellungen > Benutzerverwaltung > Benutzer und Gruppen.
18. Suchen nach Benutzern, die aus LDAP synchronisiert wurden. Wählen Sie einen oder mehrere Benutzer
aus, klicken Sie auf Rolle zuweisen, wählen Sie eine oder mehrere LiveCycle ES-Rolle(n) aus und klicken
Sie dann auf OK. Klicken Sie erneut auf OK, um die Rollenzuweisung zu bestätigen. Wiederholen Sie
diesen Schritt für alle Benutzer, denen Sie Rollen zuweisen möchten. Weitere Informationen zum
Zuweisen von LiveCycle ES-Rollen finden Sie in der User Management-Hilfe unter der Adresse
http://www.adobe.com/go/learn_lc_adminUM_de.
19. Starten Sie Workbench ES, und melden Sie sich mit den folgenden Anmeldeinformationen an:
Benutzername: [benutzername]@[repository_name]
Kennwort: [kennwort]
Der FileNet-Objektspeicher sollte jetzt in der Ansicht „Ressourcen“ in Workbench ES angezeigt werden.
Wenn Sie sich nicht mithilfe von benutzername@repository_name anmelden, versucht Workbench ES
eine Anmeldung beim in Schritt 6 angegebenen Standardrepository.
Sobald Sie den Connector für IBM FileNet-Dienst konfiguriert haben, sollten Sie unter Verwalten von
LiveCycle ES unter der Adresse www.adobe.com/go/learn_lc_administration_de nach Informationen zur
ordnungsgemäßen Konfiguration der Workbench ES-Funktionen mithilfe des Filenet-Repositorys suchen.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Deinstallieren von LiveCycle ES
Deinstallieren von LiveCycle ES
Das Deinstallationsprogramm im [LiveCycle ES-Stammverzeichnis] entfernt keine Dateien, die Sie auf
dem Anwendungsserver bereitgestellt haben.
Vorsicht: Wenn Sie das Deinstallationsprogramm ausführen, wird der gesamte Inhalt des
Produktinstallationsverzeichnisses ohne Warnmeldung gelöscht. Bevor Sie fortfahren,
sichern Sie alle Daten, die Sie nicht verlieren möchten.
® So entfernen Sie die Dateien vom Computer:
1. Starten Sie das Deinstallationsprogramm:
G
(Windows) Führen Sie diese Aufgaben aus:
G
G
G
Wählen Sie in der Windows-Systemsteuerung die Option Software.
G
Entfernen Sie Adobe Adobe LiveCycle ES.
G
Entfernen Sie Adobe Acrobat 8.1 Professional (falls mit PDF Generator ES installiert).
Alternativ dazu können Sie manuell auch folgende Schritte durchführen:
G
cd [LiveCycle ES-Stammverzeichnis]/_uninst/server
G
Doppelklicken Sie auf die Datei „livecycle8_uninstall.exe“.
(Linux) Geben Sie an einem Terminal ./livecycle8_uninstall.bin ein (eventuell müssen
Sie diese Binärdatei in eine ausführbare Datei ändern).
2. Befolgen Sie die auf dem Bildschirm angezeigten Anweisungen des Deinstallationsprogramms und
klicken Sie auf Fertig stellen.
36
6
Manuelles Konfigurieren von BAM Server für LiveCycle ES
In diesem Abschnitt werden die Aufgaben beschrieben, die für die manuelle Installation und
Konfiguration von LiveCycle Business Activity Monitoring ES für die Verwendung mit LiveCycle ES
durchgeführt werden müssen:
G
„Erstellen und Konfigurieren der BAM Server-Metadaten-Datenbank“ auf Seite 37
G
„Installieren von JBoss Application Server“ auf Seite 40
G
„Installieren der Datenbanktreiber für JBoss Application Server für BAM Server“ auf Seite 40
G
„Konfigurieren von Process Management ES für BAM Server“ auf Seite 48
G
„Bereitstellen der EAR-Datei von BAM Server für LiveCycle ES“ auf Seite 48
G
„Konfigurieren von Business Activity Monitoring ES“ auf Seite 49
G
„Konfigurieren von LDAP-Einstellungen für BAM Server“ auf Seite 51
G
„Verwendung von BAM Dashboard“ auf Seite 56
G
„Herunterfahren des BAM Server“ auf Seite 57
G
„Deinstallation... Business Activity Monitoring ES“ auf Seite 58
Bei diesen Anweisungen werden die folgenden Benennungskonventionen für allgemeine Dateipfade
verwendet.
Name
Beschreibung
Standardwert
[JBoss-BAMStammverzeichnis]
Das Basisverzeichnis des
Anwendungsservers für
Business Activity Monitoring ES.
JBoss unter Windows: C:\jboss
[LiveCycle
Der Speicherort, an dem die
ES-Stammverzeichnis] LiveCycle ES-Dienste installiert
werden.
JBoss unter Linux: /opt/jboss
Windows: C:\Adobe\LiveCycle8
Linux und UNIX: /opt/adobe/livecycle8
Die meisten Informationen zu Verzeichnissen in diesem Handbuch gelten plattformübergreifend (unter
Linux und UNIX wird bei allen Dateinamen und Pfadangaben die Groß- und Kleinschreibung beachtet).
Plattformspezifische Informationen werden bei Bedarf aufgeführt.
Erstellen und Konfigurieren der
BAM Server-Metadaten-Datenbank
Sie müssen eine Business Activity Monitoring ES-Metadaten-Datenbank erstellen, in der die Definitionen
der von BAM Server überwachten Prozessmetrik sowie die Einzelheiten zu Warnhinweisen und zu
Laufzeitdaten von Objekten gespeichert werden, die auf der Festplatte beibehalten werden müssen.
Da Business Activity Monitoring ES-Metadaten sehr umfangreich werden können, müssen Sie der
BAM Server-Metadaten-Datenbank mindestens 50 MB Speicherplatz zuweisen. Bei Bereitstellungen
in einer Produktionsumgebung sollten Sie mindestens 200 MB zuweisen.
37
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Benutzerkonten
38
Bei einigen Aspekten der Konfiguration der Business Activity Monitoring ES-Metadaten-Datenbank sind
für BAM Server gegebenenfalls bestimmte Einstellungen erforderlich. Die Einstellungen sind vom Typ des
Anwendungsservers abhängig, der als Host für BAM Server dient, sowie vom Typ des Datenbankservers,
auf dem die Business Activity Monitoring ES-Metadaten gespeichert werden.
Benutzerkonten
Sie müssen außerdem ein Benutzerkonto einrichten, mit dem BAM Server eine Verbindung zur
Business Activity Monitoring ES-Metadaten-Datenbank herstellen kann. Das Benutzerkonto muss
über Berechtigungen zum Erstellen, Bearbeiten und Aktualisieren der Datenbank verfügen.
Für Oracle müssen Sie außerdem ein Benutzerkonto einrichten, mit dem BAM Server eine Verbindung
zur Metadaten-Datenbank herstellen kann. Das Benutzerkonto muss über Berechtigungen zum Erstellen,
Bearbeiten und Aktualisieren der Datenbank verfügen. Weisen Sie die Rollen CONNECT und RESOURCE
sowie die Systemberechtigungen ACCESS_ANY_WORKSPACE, CREATE_ANY_VIEW und
UNLIMITED_TABLESPACE zu. Das Datenbank-Benutzerkonto muss mit einem Tablespace verknüpft
werden, den Sie speziell für Business Activity Monitoring ES-Metadaten erstellen.
Konfigurieren der Datenbankumgebung
Wenn Sie DB2 als Business Activity Monitoring ES-Metadaten-Datenbank verwenden, müssen Sie eine
Umgebungsvariable erstellen, die den Namen der zugehörigen DB2-Instanz enthält. Zudem müssen Sie
den Pfad zu den freigegebenen DB2-Bibliotheken in der Bibliothekspfadvariablen angeben.
In den folgenden Beispielen werden Befehle zum Konfigurieren der Umgebungsvariablen aufgeführt.
Verwenden Sie den Ihrem Betriebssystem entsprechenden Befehl. Eventuell müssen Sie die Pfadangabe
im Befehl durch das von Ihnen für DB2 verwendete Installationsverzeichnis ersetzen.
Beispiel: Befehle zum Konfigurieren von Umgebungsvariablen unter Windows
Die folgenden Befehle finden auf eine DB2-Instanz mit dem Namen DB2 Anwendung.
DB2-Bibliotheksdateien sind unter C:\SQLLIB\BIN installiert:
set DB2INSTANCE=DB2
set PATH=C:\SQLLIB\BIN;%PATH%
Beispiel: Befehle zum Konfigurieren von Umgebungsvariablen unter Solaris
Die folgenden Befehle finden auf eine DB2-Instanz mit dem Namen db2fs Anwendung.
DB2-Bibliotheksdateien sind unter /opt/IBM/db2/V8.1/lib installiert:
export DB2INSTANCE=db2fs
export LD_LIBRARY_PATH=/opt/IBM/db2/V8.1/lib:${LD_LIBRARY_PATH}
Beispiel: Befehle zum Konfigurieren von Umgebungsvariablen unter AIX
Die folgenden Befehle gelten für eine DB2-Instanz mit dem Namen db2f.
/opt/IBM/db2/V8.1/lib:
export DB2INSTANCE=db2fs
export LIBPATH=/opt/IBM/db2/V8.1/lib:${LIBPATH}
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Erstellen der BAM Server-Metadaten-Datenbank
39
Erstellen der BAM Server-Metadaten-Datenbank
Damit BAM Server eine Verbindung zur Datenbank herstellen kann, in der die BAM Server-Metadaten
gespeichert werden, müssen Sie eine Datenquelldatei erstellen und auf der Instanz von
JBoss Application Server bereitstellen, auf der BAM Server ausgeführt wird. Darüber hinaus müssen
Sie die standardmäßigen Datentypzuordnungen auf JBoss ändern.
® So erstellen Sie die Metadaten-Datenbank für MySQL:
1. Wenn der JBoss Application Server ausgeführt wird, beenden Sie ihn, indem Sie an einer
Eingabeaufforderung zum Verzeichnis „[Anwendungsserver-Stammverzeichnis]/bin“ navigieren
und den folgenden Befehl eingeben:
G
(Windows) shutdown.bat -S
G
(Linux) ./shutdown.sh -S
2. Stellen Sie sicher, dass die MySQL-Datenbank für LiveCycle ES ausgeführt wird, indem Sie Start >
Alle Programme > Verwaltung > Dienste auswählen.
3. Öffnen Sie eine Eingabeaufforderung, wechseln Sie zum Verzeichnis
„[Anwendungsserver-Stammverzeichnis]\mysql\bin“ und geben Sie den folgenden Befehl zum
Starten vom MySQL Monitor ein:
mysql -u<Benutzername> -p<Kennwort>
Hinweis: <Benutzername> und <Kennwort> sind die Anmeldeinformationen, die Sie für Ihre
MySQL-Datenbank erstellt haben.
4. Geben Sie an der Eingabeaufforderung „mysql>“ den folgenden Befehl ein.
create database adobe_meta;
5. Geben Sie an der Eingabeaufforderung „mysql>“ den folgenden Befehl ein.
GRANT ALL ON adobe_meta.* TO 'adobe'@'localhost' IDENTIFIED BY 'adobe';
6. Geben Sie an der Eingabeaufforderung „mysql>“ den Befehl quit ein, um MySQL Monitor zu beenden.
® So erstellen Sie die Metadaten-Datenbank für SQL Server:
1. Wenn der JBoss Application Server ausgeführt wird, beenden Sie ihn, indem Sie an einer
Eingabeaufforderung zum Verzeichnis „[Anwendungsserver-Stammverzeichnis]/bin“ navigieren
und den folgenden Befehl eingeben:
G
(Windows) shutdown.bat -S
G
(Linux) ./shutdown.sh -S
2. Starten Sie die SQL Server-Anwendung und klicken Sie auf Sicherheit > Anmeldungen >
Neue Anmeldung.
3. Geben Sie einen Anmeldenamen und ein Kennwort an. Sie müssen das Kennwort durch erneute
Eingabe bestätigen.
4. (Optional) Deaktivieren Sie enforce password policy.
5. Behalten Sie unter Default Database die Master-Einstellung bei und klicken Sie auf OK.
6. Klicken Sie auf Database > New Database.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Installieren von JBoss Application Server
40
7. Geben Sie in das Feld Database name die Angabe adobe_meta als Namen Ihrer
Metadaten-Datenbank ein.
8. Geben Sie im Feld Owner den Anmeldenamen ein, den Sie in Schritt 3 eingegeben haben.
9. Geben Sie unter Database data in das Feld Initial size den Wert 50 ein.
10. Geben Sie unter Database log in das Feld Initial size den Wert 10 ein und klicken Sie auf OK.
11. Klicken Sie auf Security > Logins, geben Sie den Namen der Metadaten-Datenbank ein und klicken
Sie dann auf properties.
12. Wählen Sie unter General im Feld default database den Namen der Metadaten-Datenbank aus.
13. Stellen Sie sicher, dass unter „User mapping > Users mapped to this login“ Ihre Metadaten-Datenbank
ausgewählt ist.
14. Stellen Sie sicher, dass als Benutzer und als Standardschema jeweils „dbo“ festgelegt ist.
15. Wählen Sie Ihre Metadaten-Datenbankanmeldung aus und vergewissern Sie sich, dass sowohl
db_owner als auch public ausgewählt ist.
16. Klicken Sie auf OK.
Installieren von JBoss Application Server
Wenn Sie JBoss Application Server manuell zum Ausführen von BAM Server konfigurieren, müssen Sie
JBoss Application Server 4.0.3 SP1 von den folgenden Adresse herunterladen und installieren.
http://labs.jboss.com/jbossas/downloads
Installieren der Datenbanktreiber für JBoss Application Server
für BAM Server
Damit BAM Server eine Verbindung zur Business Activity Monitoring ES-Metadaten-Datenbank und der
LiveCycle ES-Datenbank herstellen kann, müssen Sie die Treiber für die verwendeten Datenbanktypen
installieren.
Hinweis: LiveCycle ES und BAM Server werden in unterschiedlichen JBoss-Navigationsstrukturen
ausgeführt, was bedeutet, dass die Treiber in jeder Struktur benötigt werden. Demzufolge
müssen Sie diese Treiber für BAM Server erneut installieren.
® So installieren Sie den JDBC-Treiber für MySQL:
1. Laden Sie die Datei mysql-connector-java-3.0.15-ga-bin-jar von der MySQL-Website herunter:
http://www.mysql.com/products/connector/j/
2. Kopieren Sie die Datei in das Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/lib.
® So installieren Sie den JDBC-Treiber für SQL Server:
G
Kopieren Sie die Treiberdatei für den Datenbankserver „sqljdbc.jar“ in das Verzeichnis
„[JBoss-BAM-Stammverzeichnis]/server/all/lib“.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren der BAM Server-Metadaten-Datenbank
41
Konfigurieren der BAM Server-Metadaten-Datenbank
Im folgenden Abschnitt wird beschrieben, wie Sie die
Business Activity Monitoring ES-Metadaten-Datenbank konfigurieren.
® So konfigurieren Sie MySQL-Datenquelle:
1. Wechseln Sie zum Verzeichnis „[JBoss-BAM-Stammverzeichnis]/server/all/deploy“ und erstellen Sie die
Datei celequest_metadata-ds.xml mit einem Texteditor.
2. Fügen Sie den folgenden Code in die Datei celequest_metadata-ds.xml ein:
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.metadata.metaDatasource</jndi-name>
<connection-url>jdbc:mysql://[Hostname]:[Anschluss]/[Datenbankname]
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<user-name>[Benutzername]</user-name>
<password>[Kennwort]</password>
<min-pool-size>10</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>20000</blocking-timeout-millis>
<idle-timeout-minutes>10</idle-timeout-minutes>
<prepared-statement-cache-size>50</prepared-statement-cache-size>
<transaction-isolation>TRANSACTION_READ_COMMITTED
</transaction-isolation>
</no-tx-datasource>
</datasources>
Dabei gilt:
G
[Hostname] ist der Name des Computers, auf dem MySQL ausgeführt wird.
G
[Anschluss] ist der Anschluss, der für den Zugriff auf die Datenbank verwendet wird.
Der Standardanschluss für MySQL ist „3306“.
G
[Datenbankname] ist der Name der BAM Server-Metadaten-Datenbank.
G
[Benutzername] ist der Name des Datenbank-Benutzerkontos, das auf die
BAM Server-Metadaten-Datenbank zugreifen kann.
G
[Kennwort] ist das Kennwort für den Benutzernamen, der für das Element [Benutzername]
angegeben wurde.
3. Speichern und schließen Sie die Datei.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBoss
Herstellen einer Verbindung zwischen JBoss Application Server für
BAM Server und der LiveCycle ES-Datenbank 42
® So konfigurieren Sie die SQL Server 2005-Datenquelle:
1. Wechseln Sie zum Verzeichnis „[JBoss-BAM-Stammverzeichnis]/server/all/deploy“ und erstellen Sie die
Datei celequest_metadata-ds.xml mit einem Texteditor.
2. Fügen Sie den folgenden Code in die Datei celequest_metadata-ds.xml ein:
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.metadata.metaDatasource</jndi-name>
<connection-url>jdbc:sqlserver://[Hostname]:[Anschluss];dbname=[Datenbankname]
</connection-url>
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver
</driver-class>
<user-name>[Benutzername]</user-name>
<password>[Kennwort]</password>
<min-pool-size>10</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>20000</blocking-timeout-millis>
<idle-timeout-minutes>10</idle-timeout-minutes>
<prepared-statement-cache-size>50</prepared-statement-cache-size>
<transaction-isolation>TRANSACTION_READ_COMMITTED
</transaction-isolation>
</no-tx-datasource>
</datasources>
Dabei gilt:
G
[Hostname] ist der Name des Computers, auf dem SQL Server 2005 ausgeführt wird.
G
[Anschluss] ist der Anschluss, der für den Zugriff auf die Datenbank verwendet wird.
Der Standardanschluss für SQL Server 2005 ist „1433“.
G
[Datenbankname] ist der Name der BAM Server-Metadaten-Datenbank.
G
[Benutzername] ist der Name des Datenbank-Benutzerkontos, das auf die
BAM Server-Metadaten-Datenbank zugreifen kann.
G
[Kennwort] ist das Kennwort für den Benutzernamen, der für das Element [Benutzername]
angegeben wurde.
3. Speichern und schließen Sie die Datei.
Herstellen einer Verbindung zwischen JBoss Application Server für
BAM Server und der LiveCycle ES-Datenbank
Sie müssen eine Verbindung zur LiveCycle ES-Datenbank auf der Instanz von JBoss Application Server
konfigurieren, auf der BAM Server ausgeführt wird, damit der Server Informationen über die Prozessdaten
zur Laufzeit abrufen kann.
Wie Sie die von Ihnen verwendete Verbindung konfigurieren, hängt vom Typ der Datenbank ab, die Sie
zum Speichern von LiveCycle ES-Daten verwenden:
„Herstellen einer Verbindung zur LiveCycle ES-Datenbank auf SQL Server“ auf Seite 43“
„Herstellen einer Verbindung zur LiveCycle ES-Datenbank für MySQL“ auf Seite 44
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBoss
Herstellen einer Verbindung zwischen JBoss Application Server für
BAM Server und der LiveCycle ES-Datenbank 43
Herstellen einer Verbindung zur LiveCycle ES-Datenbank auf SQL Server
Damit BAM Server eine Verbindung zur LiveCycle ES-Datenbank herstellen kann, müssen Sie eine
Datenquelldatei erstellen und diese auf der JBoss Application Server-Instanz bereitstellen, auf der
BAM Server ausgeführt wird.
® So erstellen Sie eine Datenquelle für die LiveCycle ES-Datenbank auf SQL Server 2005:
1. Öffnen Sie einen Texteditor und erstellen Sie eine neue Textdatei mit dem folgenden Code:
<datasources>
<local-tx-datasource>
<jndi-name>IDP_DS</jndi-name>
<connection-url>jdbc:sqlserver://[Hostname]:[Anschluss];
databaseName=[Datenbankname]</connection-url>
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver
</driver-class>
<user-name>[Benutzername]</user-name>
<password>[Kennwort]</password>
<min-pool-size>10</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>60000</blocking-timeout-millis>
<idle-timeout-minutes>15</idle-timeout-minutes>
<prepared-statement-cache-size>100</prepared-statement-cache-size>
<transaction-isolation>TRANSACTION_READ_COMMITTED
</transaction-isolation>
<!-- sql to call when connection is created
<new-connection-sql>some arbitrary sql</new-connection-sql>
-->
<!-- sql to call an existing pooled connection when it is obtained from
pool
<check-valid-connection-sql>some arbitrary sql
</check-valid-connection-sql>
-->
<!-- corresponding type-mapping in the standardjbosscmp-jdbc.xml
(optional) -->
<Metadaten>
<type-mapping>MS SQLSERVER2000</type-mapping>
</metadata>
</local-tx-datasource>
</datasources>
Dabei gilt:
G
[Hostname] ist der Name des Computers, auf dem SQL Server 2005 ausgeführt wird.
G
[Anschluss] ist der Anschluss, der für den Zugriff auf die LiveCycle ES-Datenbank verwendet
wird. Der Standardanschluss für SQL Server 2005 ist „1433“.
G
[Datenbankname] ist der Name der LiveCycle ES-Datenbank.
G
[Benutzername] ist Name des Datenbank-Benutzerkontos, das auf die LiveCycle ES-Datenbank
zugreifen kann.
G
[Kennwort] ist das Kennwort für den Benutzernamen, der für das Element [Benutzername]
angegeben wurde.
2. Speichern Sie die Datei im Verzeichnis „[JBoss-BAM-Stammverzeichnis]/server/default/deploy“ unter
dem Namen adobe-ds.xml.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren erforderlicher JVM-Optionen für JBoss Application Server
44
Herstellen einer Verbindung zur LiveCycle ES-Datenbank für MySQL
Damit BAM Server eine Verbindung zur LiveCycle ES-Datenbank herstellen kann, müssen Sie eine
Datenquelldatei erstellen und diese auf der JBoss Application Server-Instanz bereitstellen, auf der
BAM Server ausgeführt wird.
® So erstellen Sie eine Datenquelle für die LiveCycle ES-Datenbank für MySQL:
1. Öffnen Sie einen Texteditor und erstellen Sie eine neue Textdatei mit dem folgenden Code:
<datasources>
<local-tx-datasource>
<jndi-name>IDP_DS</jndi-name>
<connection-url>jdbc:mysql://[Hostname]:[Anschluss]/[dbname]
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<user-name>[Benutzername]</user-name>
<password>[Kennwort]</password>
<min-pool-size>1</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>20000</blocking-timeout-millis>
<idle-timeout-minutes>10</idle-timeout-minutes>
<prepared-statement-cache-size>50</prepared-statement-cache-size>
<transaction-isolation>TRANSACTION_READ_COMMITTED
</transaction-isolation>
</local-tx-datasource>
</datasources>
Dabei gilt:
G
[Hostname] ist der Name des Computers, auf dem MySQL ausgeführt wird.
G
[Anschluss] ist der Anschluss, der für den Zugriff auf die LiveCycle ES-Datenbank verwendet
wird.
G
[Datenbankname] ist der Name der LiveCycle ES-Datenbank.
G
[Benutzername] ist Name des Datenbank-Benutzerkontos, das auf die LiveCycle ES-Datenbank
zugreifen kann.
G
[Kennwort] ist das Kennwort für den Benutzernamen, der für das Element [Benutzername]
angegeben wurde.
2. Speichern Sie die Datei im Verzeichnis „[JBoss-BAM-Stammverzeichnis]/server/default/deploy“ unter
dem Namen adobe-ds.xml.
Konfigurieren erforderlicher JVM-Optionen für JBoss Application Server
Sie müssen die JVM (Java™ Virtual Machine) zur Unterstützung von BAM Server konfigurieren.
® So konfigurieren Sie die JVM-Optionen für JBoss Application Server:
1. Wechseln Sie zum Verzeichnis „[JBoss-BAM-Stammverzeichnis]/bin“ und öffnen Sie das Startskript in
einem Texteditor:
G
(Windows) run.bat
G
(Linux) run.sh
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Optionale JVM-Parameter für JBoss Application Server
45
2. Ändern Sie die Arbeitsspeichereinstellungen für JAVA_OPTS auf ein Minimum von 256 MB und ein
Maximum von 1024 MB. Fügen Sie außerdem -server ein, um die Leistung zu steigern:
G
(Windows) set JAVA_OPTS=%JAVA_OPTS% -server -XX:MaxPermSize=256m -Xms256m
-Xmx1024m
G
(Linux) JAVA_OPTS="$JAVA_OPTS -server -XX:MaxPermSize=256m -Xms256m
-Xmx1024m"
Bei hohen Datenbelastungen sollten Sie die Einstellung des maximalen Speicherwerts auf
-Xmax1536m (1,5 GB) erhöhen.
3. Fügen Sie eine Einstellung für JAVA_OPTS hinzu, um die Unterstützung von UTF-8-Zeichen zu aktivieren:
G
(Windows) set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=utf8
G
(Linux) JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8"
4. Fügen Sie eine Einstellung für JAVA_OPTS hinzu, um die Threadstapelgröße auf 300 zu erhöhen:
G
(Windows) set JAVA_OPTS=%JAVA_OPTS% -XX:ThreadStackSize=300
G
(Linux) JAVA_OPTS="$JAVA_OPTS -XX:ThreadStackSize=300"
5. Speichern und schließen Sie die Startskriptdatei.
Optionale JVM-Parameter für JBoss Application Server
Sie können mehrere optionale JVM-Parameter festlegen, die mit der Business Activity Monitoring ESMetadaten-Datenbank in Beziehung stehen. Dazu gehören u. a. die Sprache, das Land und die
Sortierungsstärke. Diese JVM-Parameter werden mithilfe von Befehlen im folgenden Format angegeben:
-Dcom.celequest.property.[PARAMETER]=[WERT]
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Optionale JVM-Parameter für JBoss Application Server
46
Die folgende Tabelle enthält eine Übersicht über gültige Werte für [PARAMETER] und [WERT].
Parameter
Beschreibung
LANGUAGE
Der ISO-Sprachcode für den Server.
Mit dem folgenden Befehl wird der Parameter LANGUAGE beispielsweise auf
Portugiesisch eingestellt:
-Dcom.celequest.property.LANGUAGE=PT
COUNTRY
Der ISO-Ländercode für den Server.
LOCALESORT
Gibt an, ob bei Zeichenfolgenvergleichen das Gebietsschema berücksichtigt wird.
Die gültigen Werte sind true und false:
G
Geben Sie true an, wenn das Gebietsschema bei Zeichenfolgenvergleichen
berücksichtigt werden soll.
G
Geben Sie false an, wenn das Gebietsschema bei Zeichenfolgenvergleichen
nicht berücksichtigt werden soll.
Der Standardwert ist false.
STRENGTH
Die Sortierungsstärke, d. h. der Umfang, in dem nicht englische Zeichen
verglichen und sortiert werden.
Die gültigen Werte (von oberflächlichem bis hin zu vollständigem Vergleich)
sind primary, secondary, tertiary und identical. Der Standardwert ist
tertiary.
Weitere Informationen zu Sortierungsparametern finden Sie in der Sun
Java-Dokumentation unter der folgenden Adresse:
http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html
Hinweis: Diese Einstellung ist nur aktiv, wenn für LOCALESORT der Wert true
gewählt wurde.
DECOMPOSITION
Die Art und Weise der Sortierungsauflösung. Die gültigen Werte sind none,
canonical und full. Der Standardwert ist canonical.
Weitere Informationen zu Sortierungsparametern finden Sie in der Sun
Java-Dokumentation unter der folgenden Adresse:
http//java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html
Hinweis: Diese Einstellung ist nur aktiv, wenn für LOCALESORT der Wert true
gewählt wurde.
Wenn Sie mehrere Eigenschaften einrichten möchten, trennen Sie die Befehle jeweils durch ein
Leerzeichen voneinander. Beispielsweise stellen die folgenden Befehle die Sprache auf Portugiesisch
und das Gebietsschema auf Brasilien ein:
-Dcom.celequest.property.LANGUAGE=PT -Dcom.celequest.property.LOCALE=BR
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Optionale JVM-Parameter für JBoss Application Server
Anpassen der Anschlussnummern
Wenn mehrere JBoss Application Server auf einem Computer ausgeführt werden müssen, sollten die
folgenden Anschlüsse für den bzw. die sekundären Server geändert werden. Die folgende Liste enthält
Vorschläge für die Anschlussänderung. Mit Dienstprogrammen wie TCPView für Windows oder Netstat
können Sie prüfen, ob ein gewünschter Anschluss zur Verfügung steht.
Öffnen Sie jede der folgenden Dateien in einem Texteditor und nehmen Sie die angegebenen
Änderungen vor:
[JBoss-BAM-Stammverzeichnis]\server\all\deploy\jbossweb-tomcat50.sar\server.xml
G
Ändern Sie den HTTP/1.1 Connector-Anschluss von 8080 in 8888.
G
Ändern Sie den AJP 1.3 Connector-Anschluss von 8009 in 8099.
G
Ändern Sie den SSL/TLS Connector-Anschluss von 8443 in 8493.
[JBoss-BAM-Stammverzeichnis]\server\all\conf\jboss-service.xml
G
Ändern Sie den WebService-Anschluss von 8083 in 8899.
G
Ändern Sie den NamingService-Anschluss von 1099 in 9999.
G
Ändern Sie RMIport von 1098 in 9998.
G
Ändern Sie RMIObjectPort von 4444 in 9444.
G
Ändern Sie PooledInvoker ServerBindPort von 4445 in 9445.
[JBoss-BAM-Stammverzeichnis]\server\all\deploy\cluster-service.xml
G
Ändern Sie den ha.jndi.HANamingService-Anschluss von 1100 in 1190.
G
Ändern Sie RmiPort von 1101 in 1191.
G
Ändern Sie RMIObjectPort von 4444 in 9447.
G
Ändern Sie ServerBindPort von 4446 in 9446 [nur bei Clusterumgebungen notwendig].
[JBoss-BAM-Stammverzeichnis]\server\all\deploy\jms\hajndi-jms-ds.xml
G
Ändern Sie java.naming.provider.url von 1100 in 1190.
[JBoss-BAM-Stammverzeichnis]\server\all\conf\jacorb.properties
G
Ändern Sie OAPort von 3528 in 9528.
G
Ändern Sie OASSLPort von 3529 in 9529.
[JBoss-BAM-Stammverzeichnis]\server\all\deploy-hasingleton\jms\uil2-service.xml
G
Ändern Sie ServerBindPort von 8093 in 8993.
[JBoss-BAM-Stammverzeichnis]\server\all\deploy\snmp-adaptor.sar\META-INF\jboss-service.xml
G
Ändern Sie den Anschluss von 1161 in 1182.
G
Ändern Sie den Anschluss von 1161 in 1181.
[JBoss-BAM-Stammverzeichnis]\server\all\deploy\snmp-adaptor.sar\managers.xml
G
Ändern Sie den Anschluss von 1161 in 1182.
47
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren von Process Management ES für BAM Server
48
Konfigurieren von Process Management ES für BAM Server
Sie können Process Management ES mithilfe der LiveCycle-Verwaltungskonsole so konfigurieren,
dass eine Verbindung zu BAM Server hergestellt wird. Dazu müssen Sie den Server, auf dem der
LiveCycle ES-Server und der BAM Server ausgeführt werden, sowie die Informationen des
Benutzerkontos angeben, über das der Zugriff auf BAM Server erfolgt.
® So konfigurieren Sie Process Management ES für BAM Server:
1. Melden Sie sich an LiveCycle-Verwaltungskonsole an.
2. Klicken Sie auf Dienste > LiveCycle Process Management ES > Servereinstellungen >
BAM-Konfigurationseinstellungen.
3. Geben Sie Werte für die folgenden Eigenschaften ein:
BAM-Host: Der Hostname oder die IP-Adresse des Servers, auf dem BAM Server ausgeführt wird.
Der Standardwert ist localhost.
BAM-Anschluss: Der Dienstanschluss des Anwendungsservers, auf dem BAM Server ausgeführt
wird. Der Standardwert ist 8080.
LiveCycle-Serverhost: Der Hostname oder die IP-Adresse des Servers, auf dem der
LiveCycle ES-Server ausgeführt wird. Der Standardwert ist localhost.
SOAP-Anschluss des LiveCycle-Servers: Der Dienstanschluss des Anwendungsservers, auf dem
der LiveCycle ES-Server ausgeführt wird. Der Standardwert ist 8080.
Benutzername: (Optional) Der Benutzername des Administratorkontos, über das
Process Management ES auf BAM Server zugreift. Der Standardbenutzername ist system.
Hinweis: Wenn Sie den Benutzernamen für ein anderes Benutzerkonto angeben, stellen Sie sicher,
dass der Benutzer über vollständige Administratorrechte für BAM Server verfügt. Weitere
Informationen zum Verwalten von BAM Server-Benutzerkonten finden Sie unter Verwenden
von BAM Workbench.
Kennwort: (Optional) Ein gültiges Kennwort für den oben angegebenen Benutzernamen.
Das Standardkennwort ist manager.
4. Klicken Sie auf Speichern und starten Sie den LiveCycle ES-Server neu.
Bereitstellen der EAR-Datei von BAM Server für LiveCycle ES
® So stellen Sie die EAR-Datei für BAM Server bereit:
1. Beenden Sie JBoss Application Server.
2. Wechseln Sie zum Verzeichnis „[LiveCycle ES-Stammverzeichnis]/deploy“ und kopieren Sie die Datei
„CAS_Adobe.ear“ in das Verzeichnis „[JBoss-BAM-Stammverzeichnis]/server/all/deploy/“.
3. Starten Sie den Anwendungsserver neu.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren von Business Activity Monitoring ES
49
Konfigurieren von Business Activity Monitoring ES
® So melden Sie sich an der BAM Workbench-Oberfläche an:
1. Nach der Initialisierung von JBoss Application Server greifen Sie auf die BAM Workbench-Oberfläche
zu, indem Sie in einem Webbrowser den folgenden URL eingeben:
http://[Hostname]:[Anschluss]/bam/login/workbench.htm
2. Melden Sie sich als Administrator an. Für das Administrator-Standardkonto für BAM Server gelten
folgende Angaben:
Benutzername: system
Kennwort: manager
Hinweis: Führen Sie die folgenden Schritte nur aus, wenn Sie über die Schritte 1 und 2 oben nicht auf
die BAM Workbench-Oberfläche zugreifen konnten.
3. Stellen Sie in der in der Windows-Systemsteuerung unter „Dienste“ sicher, dass der JBoss for Adobe
LiveCycle8-Dienst ausgeführt wird.
4. Klicken Sie mit der rechten Maustaste auf den Diensteintrag und klicken Sie auf Eigenschaften,
um den Starttyp des Dienstes auf Manuell festzulegen.
5. Wählen Sie auf der Registerkarte Allgemein in der Liste Starttyp den Eintrag Manuell aus und klicken
Sie auf OK. Damit stellen Sie sicher, dass der JBoss-Dienst beim Neustart des Computers nicht
automatisch gestartet wird.
6. Beenden Sie den JBoss for Adobe LiveCycle8-Dienst, indem Sie auf Den Dienst beenden klicken.
7. Wechseln Sie an einer Eingabeaufforderung zum Verzeichnis [LiveCycle ES-Stammverzeichnis]/jboss/bin
und geben Sie den folgenden Befehl ein:
run.bat -c all
® So konfigurieren Sie die BAM Server-Systemeinstellungen:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname] :[BAM-Anschluss]/bam/workbench eingeben.
2. Geben Sie auf der Anmeldeseite den Benutzernamen und das Kennwort des Systemmanagers ein.
Es folgen die Standardwerte:
Benutzername: system
Kennwort: manager
3. Wechseln Sie zu Workbench > Verwaltungskonsole > Systemeinstellungen.
4. Wählen Sie in der Liste Konfigurieren den Eintrag Prüfpunktkonfiguration aus.
5. Aktivieren Sie das Kontrollkästchen Prüfpunkt aktivieren.
6. Geben Sie in das Feld Wiederherstellungsprotokollverzeichnis den Pfad zum
BAM-Protokollverzeichnis ein. Zum Beispiel:
[JBoss-BAM-Stammverzeichnis]/server/all/log
7. Wählen Sie aus der Liste Konfigurieren den Eintrag Protokollierung aus.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren von Business Activity Monitoring ES
50
8. Geben Sie in das Feld Protokollverzeichnis den Pfad zum BAM-Protokollverzeichnis ein. Zum Beispiel:
[JBoss-BAM-Stammverzeichnis]/server/all/log
9. Wählen Sie in der Liste Konfigurieren den Eintrag Systemsteuerung aus und stellen Sie sicher, dass
Zustand bei Neustart wiederherstellen ausgewählt ist.
10. Wählen Sie aus der Liste Konfigurieren den Eintrag SMTP-Konfiguration aus und geben Sie die
folgenden Parameter ein:
Host: URL für den SMTP-Host.
Adresse: IP-Adresse für den SMTP-Host.
Benutzer: Benutzername für das Konto.
Kennwort: Benutzerkennwort für das Konto.
11. Klicken Sie auf OK.
12. Starten Sie den LiveCycle ES-Server und BAM Server neu.
® So importieren Sie die Metadaten-Definitionen für LiveCycle ES:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Geben Sie auf der Anmeldeseite den Benutzernamen und das Kennwort des Systemmanagers ein.
Es folgen die Standardwerte:
Benutzername: system
Kennwort: manager
3. Klicken Sie auf die Registerkarte Administration Console und dann auf Import/Export.
4. Wählen Sie Metadaten aus einer JAR-Datei importieren (Upload) aus und geben Sie den
vollständigen Pfad zum Speicherort der Metadaten-Vorlage für Business Activity Monitoring ES an,
die für den Typ der von Ihnen verwendeten LiveCycle ES-Datenbank geeignet ist:
G
(DB2) adobeimport_DB2.jar
G
(MySQL) adobeimport_MySQL.jar
G
(Oracle) adobeimport_Oracle.jar
G
(SQL Server) adobeimport_SQLServer.jar
Diese Dateien werden im Verzeichnis [LiveCycle-Stammverzeichnis]/deploy installiert.
5. Klicken Sie auf Hochladen und anschließend auf OK, um die Datei zu importieren.
® (Oracle) So aktualisieren Sie die JDBC-Abfrage:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Geben Sie auf der Anmeldeseite den Benutzernamen und das Kennwort des Systemmanagers ein.
Es folgen die Standardwerte:
Benutzername: system
Kennwort: manager
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Konfigurieren von LDAP-Einstellungen für BAM Server
51
3. Klicken Sie auf die Registerkarte Application Workbench und anschließend auf Ereignisse, um eine
Liste mit Ereignissen anzuzeigen.
4. Doppelklicken Sie auf ein Adobe-Ereignis und dann auf Dieses Ereignis bearbeiten.
5. Geben Sie in das Feld JDBC-Abfrage folgenden Code ein:
select uuid,major_version,minor_version,"descriptor",state,service_uuid,
component_oid,update_time,create_time from tb_sc_service_configuration
where monitor='1'
6. Klicken Sie auf Abfrage erneut senden.
7. Klicken Sie auf die Registerkarte Abruf und wählen Sie aus der Liste Inkrementierendes Feld den
Eintrag update_time aus. Notieren Sie sich den Anfangswert (z. B. 2000-01-01 00:00:00), da Sie diesen
ggf. später benötigen.
8. Klicken Sie auf Ereignis speichern.
Konfigurieren von LDAP-Einstellungen für BAM Server
Mit Business Activity Monitoring ES können Sie nicht nur Benutzer und Berechtigungen manuell erstellen,
sondern auch Benutzerdaten von unterstützten LDAP-Anbietern importieren. Sie können eine automatische
Synchronisierung planen bzw. eine manuelle Synchronisierung mit dem LDAP-Server durchführen, um
vorhandene Benutzer und Rollen automatisch zu aktualisieren.
Beim Synchronisieren mit dem LDAP-Server werden verschiedene Eigenschaften (Basis-DN des Benutzers,
Anmeldedaten und Kennwort, vollständiger Name, Beschreibung, E-Mail-Adresse) in der
BAM Server-Metadaten-Datenbank zwischengespeichert.
Wenn BAM Server Benutzer vom LDAP-Server importiert, werden LDAP-Gruppen in
Business Activity Monitoring ES-Rollen umgewandelt. Benutzern werden Rollen abhängig von der
Gruppe zugewiesen, der sie auf dem LDAP-Server angehören. Weitere Informationen finden Sie unter
„Einschränkungen für LDAP-Verbindungen von BAM Server“ auf Seite 51.
Hinweis: BAM Server kann mit allen LDAP-Anbietern integriert werden, die Version 3 des LDAP-Protokolls
unterstützen.
Einschränkungen für LDAP-Verbindungen von BAM Server
Für die Verbindung zwischen BAM Server und dem LDAP-Server gelten die folgenden Einschränkungen:
G
Sie können nur jeweils eine Verbindung zu einem LDAP-Server konfigurieren.
G
BAM Server erstellt Rollen anhand von Gruppen, die auf dem LDAP-Server definiert wurden. Wenn
BAM Server eine Gruppe findet, für die noch keine Rolle erstellt wurde, wird eine Rolle ohne jegliche
Berechtigungen erstellt. Sie können die Berechtigungen zu einem späteren Zeitpunkt bei Bedarf
ändern. (Siehe „Konfigurieren der LDAP-Rollenzuordnung“ auf Seite 55.)
G
Wenn BAM Server einen Benutzer importiert und dieser Benutzer einer Gruppe angehört, für die
es keine entsprechende Business Activity Monitoring ES-Rolle gibt, wird der Benutzer zwar erstellt,
jedoch werden ihm keine Rollen zugewiesen.
G
Wenn ein Benutzer vom LDAP-Server importiert wurde, können Sie die ihm zugewiesene Rolle
nicht ändern. Importierten Benutzern können Rollen zugewiesen werden, indem am LDAP-Server
Änderungen vorgenommen werden. Allerdings haben Sie die Möglichkeit, manuell erstellten
Benutzern Rollen zuzuweisen, die anhand von LDAP-Gruppen erstellt wurden.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Richtlinien für LDAP-Verbindungen von BAM Server
52
Richtlinien für LDAP-Verbindungen von BAM Server
Wenn Sie die Verbindung zwischen dem BAM Server und dem LDAP-Server einrichten, sollten Sie sich
an den folgenden Richtlinien orientieren:
G
Wenn die Verbindung zum LDAP-Server nicht sicher ist, verwenden Sie SSL.
G
Für die Authentifizierung sollten Sie SASL (Simple Authentication and Security Layer) verwenden.
Diese Methode wird von LDAP unterstützt.
G
Aus Sicherheitsgründen sollten die Zugriffsrechte des LDAP-Synchronisierungsbenutzers auf die
Abfrage des LDAP-Servers beschränkt sein. Weitere Informationen zum Synchronisierungsbenutzer
finden Sie unter „Konfigurieren der automatischen LDAP-Synchronisierung“ auf Seite 52.
Vorsicht: Das Kennwort dieses Benutzers wird anhand umkehrbarer symmetrischer Verschlüsselung in
den BAM Server-Metadaten gespeichert. Alle Personen mit Zugriff auf die Metadaten können
daher auch dieses Kennwort in Erfahrung bringen.
Konfigurieren der automatischen LDAP-Synchronisierung
Sie haben die Möglichkeit, eine automatische Synchronisierung von BAM Server mit dem LDAP-Server zu
planen. Durch die Synchronisierung wird gewährleistet, dass die Benutzerkonten und Rollendefinitionen,
die von BAM Server in der BAM Server-Metadaten-Datenbank zwischengespeichert werden, mit dem
Inhalt des LDAP-Servers übereinstimmen.
BAM Server erstellt während der Synchronisierung anhand von neuen Gruppen auf dem LDAP-Server
neue Rollen und entfernt Rollen, wenn die entsprechenden Gruppen seit der letzten Synchronisierung
vom LDAP-Server entfernt wurden.
Hinweis: Die Rollen werden selbst dann entfernt, wenn sie manuell erstellten Benutzern zugewiesen
wurden. Wenn die Rollen derartiger Benutzer im Rahmen der Synchronisierung entfernt werden,
bleiben die Benutzerkonten zwar erhalten, jedoch wird die Rollenzuweisung aufgehoben.
® So konfigurieren Sie die automatische LDAP-Synchronisierung:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Synchronisierung.
4. Wählen Sie die Option LDAP aktiviert aus, sofern sie noch nicht ausgewählt ist.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren der automatischen LDAP-Synchronisierung
53
5. Geben Sie Werte für die folgenden Eigenschaften an:
Ursprüngliche Kontextfactory: Der JNDI-Name, über den BAM Server die Verbindung zum
LDAP-Server herstellt. Der Standardwert ist com.sun.jndi.ldap.LdapCtxFactory.
Sie müssen diesen Wert voraussichtlich nicht ändern.
LDAP-Server: Der DNS-Name oder die IP-Adresse des LDAP-Servers.
LDAP-Anschluss: Der Anschluss, an dem der LDAP-Server ausgeführt wird. Der Standardanschluss
ist in der Regel 389. Wenn Sie jedoch die SSL-Option auswählen, ist der Standardanschluss in der
Regel 636. Erkundigen Sie sich beim LDAP-Administrator, welchen Anschluss Sie angeben müssen.
LDAP SSL: Wählen Sie diese Option aus, wenn der LDAP-Server zur Verwendung von SSL konfiguriert
ist. Die Auswahl dieser Option kann sich auf die Einstellung des LDAP-Anschlusses auswirken.
LDAP-Authentifizierung: Die vom LDAP-Server verwendete Authentifizierungsmethode. Wahlen
Sie eine der folgenden Optionen:
G
Einfach
G
SASL (Simple Authentication and Security Layer). Wählen Sie diese Option für Sun ONE.
G
Compare Encrypted Password
LDAP-Prinzipal-DN-Präfix: Bei der einfachen Authentifizierungsmethode wird der von Ihnen
angegebene Text vor dem Anmeldenamen des Benutzers eingefügt:
G
Bei LDAP-Servern, bei denen eine DN-Anmeldung erforderlich ist, geben Sie den entsprechenden
Eigenschaftswert gefolgt von einem Gleichheitszeichen ein (z. B. cn= oder uid=).
G
Bei Active Directory geben Sie keinen Wert ein.
LDAP-Prinzipal-DN-Suffix: Bei der einfachen Authentifizierungsmethode wird der von Ihnen
angegebene Text nach dem Anmeldenamen des Benutzers eingefügt:
G
Bei LDAP-Servern, bei denen eine DN-Anmeldung erforderlich ist, geben Sie die entsprechende
Wertkette ein. Beim ersten Suffixzeichen muss es sich um ein Komma (,) handeln.
,ou=Users,dc=domain,dc=name
G
Bei Active Directory ist eine einfache Anmeldung mit einer E-Mail-Adresse erforderlich. Geben
Sie daher das Symbol @ gefolgt von dem für Active Directory geltenden Domänennamen ein.
Benutzer-DN zur LDAP-Synchronisierung: Der Benutzer, der die Verbindung zum Server herstellt
und die Liste der Benutzer und Rollen liest. Aus Sicherheitsgründen müssen Sie ein Benutzerkonto
angeben, das nur zum Lesen des LDAP-Verzeichnisses berechtigt ist.
LDAP-Synchronisierungskennwort: Das Kennwort für den Benutzer, der unter „Benutzer-DN zur
LDAP-Synchronisierung“ angegeben wurde.
6. Klicken Sie auf Verbindung testen. Die Verbindung sowie die Konfiguration der Benutzer- und
Rollenzuordnung werden getestet. Wenn die Verbindungseinstellungen korrekt sind und eine
Verbindung hergestellt werden kann, wird eine entsprechende Meldung angezeigt. Wenn Sie die
Benutzer- und Rollenzuordnung für LDAP noch nicht konfiguriert haben, wird ein Fehler ausgegeben.
7. Klicken Sie zum Festlegen des LDAP-Synchronisierungsplans auf die Schaltflächen Zeitplan hinzufügen,
Zeitplan bearbeiten und Zeitplan entfernen.
Hinweis: Die Synchronisierung sollte zu einem Zeitpunkt erfolgen, zu dem nur sehr wenige Benutzer
beim Server angemeldet sind.
8. Klicken Sie auf OK.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren der LDAP-Benutzerzuordnung
54
Konfigurieren der LDAP-Benutzerzuordnung
Sie können die Parameter der Benutzerzuordnung konfigurieren, die darüber entscheiden, welche
Benutzer vom LDAP-Server importiert und synchronisiert werden. Welche Parameter Sie festlegen
können, hängt vom jeweiligen LDAP-Serveranbieter ab.
® So konfigurieren Sie die Parameter für die LDAP-Benutzerzuordnung:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Benutzerzuordnung und geben Sie Werte für die folgenden
Parameter ein:
Basis-DN für LDAP-Benutzer: Das Stammverzeichnis der Struktur, die nach Benutzern durchsucht
wird, z. B. Beispiel:
G
(Sun ONE) OU=people,DC=your domain,DC=com
G
(Active Directory) CN=Users,DC=yourdomain,DC=com
Suchfilter für LDAP-Benutzer: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp
am besten geeignet ist. Auf dem LDAP-Server könnte beispielsweise eine spezielle Gruppe für
Business Activity Monitoring ES-Benutzer eingerichtet sein. Mit diesem Filter könnten Sie dann
gewährleisten, dass nur Benutzer importiert werden, die dieser Gruppe angehören.
Anmelde-ID für LDAP-Benutzer: Die Anmelde-ID des angegebenen Anbieters. Dieser Wert wird
in Business Activity Monitoring ES als Anmelde-ID des Benutzers verwendet.
Vollständiger Name des LDAP-Benutzers: Geben Sie cn ein, wenn Sie Sun ONE oder Active
Directory verwenden.
LDAP-Benutzerbeschreibung: Geben Sie description ein, wenn Sie Sun ONE oder Active
Directory verwenden.
Primäre E-Mail-Adresse für LDAP-Benutzer: Geben Sie userPrincipalName ein. Dies bezieht
sich auf die E-Mail-Adresse des Benutzers im LDAP-Verzeichnis.
Verschlüsseltes Kennwort für LDAP-Benutzer: Geben Sie das Kennwort des festgelegten Benutzers
ein, falls Sie Sun ONE oder Tivoli verwenden. Bei Active Directory muss das Feld leer bleiben.
4. Klicken Sie auf die Registerkarte LDAP-Synchronisierung und dann auf Verbindung testen,
um festzustellen, ob die Benutzer erfolgreich importiert werden.
5. Klicken Sie auf OK.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Konfigurieren der LDAP-Rollenzuordnung
55
Konfigurieren der LDAP-Rollenzuordnung
Sie können die Parameter der Rollenzuordnung konfigurieren, die darüber entscheiden, welche Gruppen
oder Rollen importiert und/oder synchronisiert werden. Welche Parameter Sie festlegen können, hängt
vom jeweiligen LDAP-Serveranbieter ab.
® So konfigurieren Sie die Parameter für die LDAP-Rollenzuordnung:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Rollenzuordnung und geben Sie Werte für die folgenden
Parameter ein:
Basis-DN für LDAP-Rolle: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp am
besten geeignet ist:
G
(Sun ONE) OU=Groups,DC=your domain,DC=com
G
(Active Directory) CN=Users,DC=yourdomain,DC=com
Suchfilter für LDAP-Rollen: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp am
besten geeignet ist:
G
(Sun ONE) (&(objectclass=groupOfUniqueNames))
G
(Active Directory) (&(objectclass=group))
Anmelde-ID für LDAP-Rolle: Geben Sie cn ein, wenn Sie Sun ONE oder Active Directory verwenden.
Vollständiger Name der LDAP-Rolle: Geben Sie displayname ein, wenn Sie Sun ONE oder
Active Directory verwenden.
LDAP-Rollenbeschreibung: Geben Sie description ein, wenn Sie Sun ONE oder Active
Directory verwenden.
LDAP-Rollenmitglied: Der Name der aus mehreren Werten bestehenden Eigenschaft, die
Rollenmitglieder enthält:
G
(Sun ONE) uniqueMember
G
(Active Directory) member
Art des LDAP-Rollenmitglieds: Verwenden Sie eine der folgenden Optionen:
G
Distinguished Name: Benutzer werden über die Rollenmitgliedseigenschaften anhand von
DN identifiziert, z. B. cn=jadmin,ou=people,dc=your domain,dc=com.
G
Anmelde-ID: Benutzer werden über die Rollenmitgliedseigenschaften anhand des Werts der
Eigenschaft identifiziert, die als Anmelde-ID für Business Activity Monitoring ES dient.
4. Klicken Sie auf die Registerkarte LDAP-Synchronisierung und dann auf Verbindung testen,
um festzustellen, ob die Benutzer erfolgreich importiert werden.
5. Klicken Sie auf OK.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Manuelles Synchronisieren mit dem LDAP-Server
56
Manuelles Synchronisieren mit dem LDAP-Server
Sie können BAM Server jederzeit manuell mit dem LDAP-Server synchronisieren.
Synchronisierungsanforderungen werden einer Warteschlange hinzugefügt, um gleichzeitige
Synchronisierungen zu vermeiden.
® So führen Sie eine manuelle Synchronisierung mit dem LDAP-Server durch:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Synchronisierung.
4. Klicken Sie auf Jetzt synchronisieren. Die Länge der Synchronisierung ist von der jeweiligen Umgebung
abhängig. Wenn der Vorgang abgeschlossen ist, wird eine entsprechende Meldung angezeigt.
5. Klicken Sie auf OK.
Verwendung von BAM Dashboard
Wenn ein Prozess aktiviert und sofort aufgerufen wird, wird die Prozessinstanz nicht im entsprechenden
BAM Dashboard registriert. BAM Server braucht mehrere Sekunden nach der Prozessaktivierung, bis es die
Prozessaktivität überwachen kann. Warten Sie nach dem Aktivieren eines Prozesses mehrere Sekunden,
bevor Sie den Prozess aufrufen.
Wenn Sie BAM Server installieren, nachdem LiveCycle ES einen Prozess ausgeführt hat, müssen Sie
BAM Dashboard auffüllen. Beim Auffüllen von BAM Dashboard wird BAM Server initialisiert, um mit dem
Abrufen der LiveCycle ES-Datenbank zu beginnen. Sobald dieser Prozess aktiviert ist, kann die AdobeView
aus den Informationen erstellt werden, die aus der LiveCycle ES-Datenbank abgerufen wurden. Bei einer
kompletten LiveCycle ES-Neuinstallation ist die Datenbank leer, so dass keine Ansicht erstellt wird.
® So füllen Sie BAM Dashboard auf:
1. Wechseln Sie zu Workbench > Application Workbench > Ereignisse.
2. Suchen Sie den Eintrag AdobeEvent in der Liste Ereignisse und starten Sie das Ereignis neu.
Wählen Sie Abhängigkeiten deaktivieren aus und klicken Sie auf Alle aktivieren.
3. Wählen Sie Abhängigkeiten deaktivieren für alle Ereignisse außer dem AdobeEvent-Ereignis und
allen Systemereignissen aus, die mit VC beginnen.
4. Wählen Sie im Verlauf von ActivityInstanceStartedEvents aktivieren die Option Nur dieses Objekt
aktivieren aus.
5. Aktivieren Sie alle ActivityInstanceCompletedEvents.
6. Wählen Sie im Verlauf von ProcessInstanceStartedEvents aktivieren die Option Nur dieses Objekt
aktivieren aus.
7. Aktivieren Sie alle Ereignisse unter ProcessInstanceCompletedEvent, QueueEvent,
TaskCompletedEvent, TastReassignedEvent und TaskSpentTimeOnQueueEvent.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Herunterfahren des BAM Server
57
8. Wechseln Sie zu Workbench > Application Workbench > Ansichten.
9. Suchen Sie den Eintrag AdobeView in der Liste Ansichten und starten Sie die Ansicht neu.
10. Klicken Sie auf Abhängigkeiten deaktivieren und dann auf Alle aktivieren. Warten Sie, bis sich die
Liste der vorhandenen Orchestrations aufgebaut hat.
Nach dem Auffüllen von BAM Dashboard können Sie sich bei BAM Dashboard anmelden, um die
LiveCycle ES-Prozesse anzuzeigen.
® So melden Sie sich an BAM Dashboard an:
1. Geben Sie in einem Webbrowser den URL zum Dashboard ein. Geben Sie beispielsweise Folgendes ein:
http://[Hostname]:[Anschluss]/bam/login/dashboard.htm
2. Melden Sie sich als Administrator an. Für das standardmäßig Administratorkonto für BAM Server gelten
folgende Angaben:
Benutzername: system
Kennwort: manager
Herunterfahren des BAM Server
Verwenden Sie das folgende Verfahren, um den BAM Server unter JBoss Application Server
herunterzufahren.
® So fahren Sie Business Activity Monitoring ES unter JBoss Application Server herunter:
1. Melden Sie sich als Systemadministrator an BAM Workbench an.
2. Führen Sie einen Systemprüfpunkt durch, indem Sie Verwaltungskonsole > Systemeinstellungen >
Prüfpunktkonfiguration auswählen und dann auf Prüfpunkt jetzt ausführen klicken.
Der Systemstatus wird in einem Snapshot gespeichert. Ist die Option „Zustand bei Neustart
wiederherstellen“ auf der Registerkarte „Systemsteuerung“ aktiviert, stellen die Server beim Neustart
die letzten Prüfpunktdaten wieder her.
3. Führen Sie das JBoss Application Server-Skript zum Herunterfahren aus:
G
(Windows) \[JBoss-BAM-Stammverzeichnis]\bin\shutdown.bat -S
G
(UNIX) ./[JBoss-BAM-Stammverzeichnis]/bin/shutdown.sh -S
Zusätzliche Dokumentation
Weitere Informationen zu LiveCycle Business Activity Monitor finden Sie hier:
G
Business Activity Monitor - Dashboard unter www.adobe.com/go/learn_lc_bamdashboard_de
G
Business Activity Monitor - Server unter www.adobe.com/go/learn_lc_bamserver_de
G
Business Activity Monitor - Workbench unter www.adobe.com/go/learn_lc_bamworkbench_de
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBossJBoss
Deinstallation... Business Activity Monitoring ES
Deinstallation... Business Activity Monitoring ES
Vor einer Neuinstallation müssen Sie BAM Server vollständig deinstallieren.
® So deinstallieren Sie BAM Server:
1. Beenden Sie den BAM Server.
2. Heben Sie die Bereitstellung der EAR-Datei für BAM Server auf.
3. Entfernen Sie die folgenden Dateien:
G
[JBoss-BAM-Stammverzeichnis]/server/all/deploy/CAS_Adobe.ear
G
[JBoss-BAM-Stammverzeichnis]/server/all/log/*
4. Löschen Sie aus dem Verzeichnis des Wiederherstellungsprotokolls und aus dem
Protokollierungsverzeichnis alle Dateien, deren Namen Ähnlichkeit mit den folgenden
Benennungsmustern aufweisen:
G
filestore*.dat
G
DEFAULTRECOVERYLOGGER_*
G
chkpoint*
5. Überprüfen Sie den Inhalt des Ordners „[Anwendungsserver-Stammverzeichnis]\bin“ und löschen
Sie ggf. vorhandene „chkpoint*“-Dateien.
6. Legen Sie die Datenbanktabellen, in denen die BAM Server-Metadaten gespeichert sind, mit
einem Datenbankverwaltungsprogramm in der Datenbank ab. Sie können auch eine neue
BAM Server-Metadaten-Datenbank erstellen.
58
7
Erweiterte Konfiguration für Produktionssysteme
In diesem Abschnitt werden erweiterte Optimierungsschritte für LiveCycle Output ES, LiveCycle Forms ES
und LiveCycle PDF Generator ES beschrieben. Die Aufgaben in diesem Abschnitt sollten nur von einem
erfahrenen Anwendungsserveradministrator auf einem Produktionssystem ausgeführt werden.
LiveCycle Output ES und LiveCycle Forms ES
Der aktuelle Standardwert für „PoolMax“ ist 4. Der tatsächlich festzulegende Wert hängt von der
Hardwarekonfiguration und der erwarteten Nutzung in Ihrer Umgebung ab.
Für eine optimale Nutzung wird empfohlen, den unteren Grenzwert von „PoolMax“ nicht niedriger
als entsprechend der Anzahl der verfügbaren CPUs festzulegen. Der obere Grenzwert muss vom
Verarbeitungslastmuster des Servers bestimmt werden. Generell sollte der obere Grenzwert auf das
Doppelte der Anzahl der CPUs auf dem Server festgelegt werden.
® So ändern Sie den vorhandenen Wert von „PoolMax“:
1. Bearbeiten Sie in einem Texteditor das JBoss-Startskript.
2. Fügen Sie für „ConvertPdf“ die folgenden Eigenschaften hinzu:
G
com.adobe.convertpdf.bmc.POOL_MAX=4
G
com.adobe.convertpdf.bmc.MAXIMUM_REUSE_COUNT=5000
G
com.adobe.convertpdf.bmc.REPORT_TIMING_INFORMATION=true
G
com.adobe.convertpdf.bmc.CT_ALLOW_SYSTEM_FONTS=true
3. Fügen Sie für „XMLFM“ die folgenden Eigenschaften hinzu:
G
com.adobe.xmlform.bmc.POOL_MAX=4
G
com.adobe.xmlform.bmc.MAXIMUM_REUSE_COUNT=5000
G
com.adobe.xmlform.bmc.REPORT_TIMING_INFORMATION=true
G
com.adobe.xmlform.bmc.CT_ALLOW_SYSTEM_FONTS=true
LiveCycle PDF Generator ES
LiveCycle PDF Generator ES kann bei bestimmten Typen von Eingabedateien mehrere PDF-Konvertierungen
gleichzeitig ausführen. Dies wird mithilfe von Session Beans ohne Status erzwungen.
Konfiguration der Größe des EJB-Pools
Zum Erzwingen unabhängiger Poolgrößen stehen für die folgenden Typen von Eingabedateien vier
verschiedene Session Beans ohne Status zur Verfügung:
G
Adobe PostScript®- und Encapsulated PostScript (EPS)-Dateien
G
Bilddateien (z. B. BMP, TIFF, PNG, JPEG usw.)
G
OpenOffice-Dateien
59
Adobe LiveCycle ES
Erweiterte Konfiguration für Produktionssysteme
Installieren und Bereitstellen von LiveCycle ES für JBoss
G
Konfiguration der Größe des EJB-Pools
60
Alle anderen Dateitypen (außer HTML-Dateien) wie Microsoft Office-, Photoshop-, PageMaker- und
FrameMaker-Dateien
Die Poolgröße für HTML-zu PDF-Konvertierungen kann nicht über Session Beans ohne Status verwaltet
werden.
Die standardmäßige Poolgröße für PostScript-, EPS- und Bilddateien ist auf 3, für OpenOffice und andere
Dateitypen (außer HTML) auf 1 festgelegt.
Sie können die Poolgröße für PS/EPS- und Bilddateien basierend auf der Konfiguration Ihrer Serverhardware
(z. B. Anzahl der CPUs, der Kernels jeder CPU usw.) festlegen. Für OpenOffice und andere Dateitypen muss die
Poolgröße dagegen unverändert bleiben (d. h. 1), damit PDF Generator ES ordnungsgemäß funktioniert.
In diesem Abschnitt wird erläutert, wie die Poolgröße für die PS-zu-PDF- und Bilddatei-zu-PDF-Konvertierung
für die unterstützten Anwendungsserver festgelegt werden kann.
Nachfolgend wird angenommen, dass die beiden folgenden LiveCycle ES-Anwendungs-EAR-Dateien
auf dem Anwendungsserver bereitgestellt wurden:
G
adobe-livecycle-<Anwendungsserver>.ear
G
adobe-livecycle-native-<Anwendungsserver>-<Plattform>.ear
Hier muss <Anwendungsserver> durch den Namen des Anwendungsservers in Kleinschreibung ersetzt
werden, auf dem LiveCycle ES bereitgestellt wurde (beispielsweise „jboss“, „weblogic“ oder „websphere“)
und <Plattform> muss durch eine der vier Zeichenfolgen („x86_win32“, „x86_linux“, „sparc_sunos“ oder
„powerpc_aix“) abhängig vom Betriebssystem ersetzt werden (Windows, Linux, SunOS™ oder AIX), unter
dem Ihr Anwendungsserver ausgeführt wird.
® So konfigurieren Sie die Poolgröße für die PS-zu-PDF- und Bilddatei-zu-PDF-Konvertierung:
1. Öffnen Sie in WinRAR die Datei „adobe-livecycle-jboss.ear“.
2. Wechseln Sie zum folgenden Pfad und öffnen Sie geschachtelte JAR-Dateien nacheinander in WinRAR:
adobe-pdfg-bmc-invoker-ejb.jar > META-INF
3. Extrahieren Sie die Datei „jboss.xml“ in einen geeigneten Speicherort im Dateisystem und öffnen Sie
sie in einem Texteditor.
4. Wechseln Sie in der XML-Datei zum Knoten mit dem folgenden Pfad (der in der standardmäßigen
XPath-Schreibung angegeben ist):
jboss / container-configurations / container-configuration
5. Wählen Sie den Knoten container-configuration aus, für den der Knoten container-name
auf den Wert PDFG ImageToPDF Stateless SessionBean festgelegt ist.
6. Wechseln Sie ferner zu container-pool-conf und legen Sie den Knoten MaximumSize auf den
gewünschten Wert fest (z. B. die neue Poolgröße für Bilddatei-zu-PDF-Konvertierungen).
7. Wiederholen Sie die Schritte 5 und 6 für die Poolgröße für PS-zu-PDF-Konvertierungen (falls erforderlich).
Der Knoten container-name für PS-zu-PDF-Konvertierungen ist auf PDFG PSToPDF Stateless
SessionBean festgelegt.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für JBoss
Erweiterte Konfiguration für Produktionssysteme
Konfiguration der Größe des EJB-Pools
61
8. Speichern Sie die Änderungen und komprimieren Sie die gesamte EAR-Struktur zurück in die
ursprüngliche Form.
9. Stellen Sie die geänderte EAR-Datei wieder in JBoss Application Server bereit. Sie werden zum Neustart
von JBoss aufgefordert.
A
Fehlerbehebung
In diesem Kapitel werden mögliche Probleme beim Installieren und Bereitstellen von LiveCycle ES
beschrieben und Vorschläge zur ihrer Vermeidung bzw. Umgehung gemacht.
Anfordern von Hilfe
In diesem Abschnitt werden die Schritte genannt, die Sie vor Kontaktieren des Adobe-Support ausführen
sollten. Wenn durch Konsultieren der LiveCycle ES-Dokumentation Ihre Probleme nicht behoben werden
konnten, wenden Sie sich an den Adobe-Support. Damit wir Ihr Anliegen schnell bearbeiten können,
halten Sie Antworten auf die folgenden Fragen bereit:
G
Was haben Sie gemacht, als das Problem auftreten ist?
G
Können Sie das Problem reproduzieren?
G
Wurde eine Fehlermeldung angezeigt, als das Problem auftrat? Ist Ihnen sonst noch etwas aufgefallen?
G
Treten die Fehler weiterhin auf, wenn Sie in Internet Explorer („Extras > Internetoption > Erweitert“) die
Option „Kurze HTTP-Fehlermeldungen anzeigen“ deaktivieren?
Installationseinstellungen
Wenn bei der Installation, Konfiguration und Bereitstellung von LiveCycle ES Probleme auftreten,
vergewissern Sie sich, dass Sie die Anweisungen in den folgenden LiveCycle ES-Dokumenten
ordnungsgemäß befolgt haben:
G
Vorbereiten der Installation von LiveCycle ES
G
Installieren und Bereitstellen von LiveCycle ES für Ihren Anwendungsserver
G
Verwalten von LiveCycle ES
Wenn Sie alle Installations- und Konfigurationsschritte gemäß der Dokumentation ausgeführt haben,
finden Sie in den folgenden Abschnitten Probleme, die Ihren ggf. ähneln.
Anwendungsservereinstellungen
Überprüfen Sie die folgenden Anwendungsservereinstellungen, bevor Sie sich an den Adobe-Support
wenden:
G
Total transaction lifetime timeout: 300
G
Ursprüngliche Heap-Größe: 256
G
Maximale Heap-Größe: 1024 MB
G
Prepared Statement Cache: 100
G
Database Connection Pool Maximum: IDP_DS ist 100 und RM_DS ist 30
G
Themen- und Warteschlangenverbindungs-Factorys
G
Connection Pool Maximum Connections: 50
62
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Datenbankinitialisierungseinstellungen
63
Datenbankinitialisierungseinstellungen
Wenn es Probleme beim Initialisieren des LiveCycle ES-Servers gibt, prüfen Sie Folgendes:
G
Die Namen von Datenbankinstanzen dürfen nur alphanumerische Zeichen enthalten.
G
(Linux ) Die Namen von Datenbankinstanzen dürfen den plattformspezifischen Grenzwert von
8 Zeichen nicht überschreiten.
Wenn die Initialisierung am Anfang des Prozesses fehlschlägt, prüfen Sie Folgendes:
G
Die LiveCycle ES-Datenbank wurde erstellt und der Benutzer hat Vollzugriffsrechte für die Datenbank.
G
Mit dem PING-Befehl ist ein Zugriff auf den Datenbankserver möglich.
G
Die Datenbank ist leer, d. h. sie enthält keine Tabellen, Sequenzen, Sichten oder Indextabellen.
G
Der JNDI-Name für IDP_DS wurde erstellt.
Wenn die Initialisierung beim Schreiben in die Registrierung fehlschlägt, überprüfen Sie die
Anwendungsserverprotokolle auf Fehler zu Warteschlangen und Themen. Sind Fehler vorhanden,
prüfen Sie, ob die Warteschlangen und Themen ordnungsgemäß konfiguriert wurden.
Probleme beim Zugreifen auf die Seite „Dienste“ innerhalb der
LiveCycle-Verwaltungskonsole
Wenn Sie in LiveCycle-Verwaltungskonsole zur Seite „Dienste“ wechseln und diese leer angezeigt wird,
führen Sie die folgenden Schritte als vorläufige Lösung durch, um die korrekte Anzeige der Seite
sicherzustellen.
® So zeigen Sie die Seite „Dienste“ ordnungsgemäß an:
1. Starten Sie JBoss Application Server durch Eingabe des folgenden Befehls manuell (nicht mithilfe
des Windows-Dienstes):
run -b localhost -c all
2. Fügen Sie die IP-Adresse und den Hostnamen des LiveCycle ES-Servers zur Windows-Hostdatei im
Verzeichnis „C:\Windows\system32\drivers\etc\hosts“ hinzu.
Fehlerbehebung mit Protokolldateien
In diesem Abschnitt wird beschrieben, wie Sie Fehler in LiveCycle ES mithilfe der Protokolldateien beheben.
Protokolldatei von LiveCycle Configuration Manager
Standardmäßig befindet sich die LiveCycle Configuration Manager-Protokolldatei im Verzeichnis
„[LiveCycle ES-Stammverzeichnis]ConfigurationManager\log“ und heißt „lcm.0.log“ (oder ähnlich).
Die Protokolldateien sind bei der Fehleranalyse in LiveCycle Configuration Manager nützlich und
werden eventuell vom Support von Adobe Enterprise benötigt.
JBoss-Protokolldatei
Standardmäßig befinden sich die JBoss-Protokolldateien im Verzeichnis „[LiveCycle
ES-Stammverzeichnis]jboss\server\all\log“ und heißen „boot.log“ und „server.log“. Die Protokolldateien
sind für die Fehleranalyse bei der Bereitstellung und dem Bootstrapping von JBoss Application Server
und LiveCycle ES nützlich und werden eventuell vom Support von Adobe Enterprise benötigt.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Konfigurieren des Scheduler-Dienstes für nicht standardmäßige JNDI-URLs
64
Konfigurieren des Scheduler-Dienstes für nicht standardmäßige
JNDI-URLs
Eventuell benötigt der Scheduler-Dienst zusätzliche Konfigurationseinstellungen, um richtig zu
funktionieren.
Umgebungen ohne Cluster
Dies ist die JNDI-URL für den IDP_DS, der von Ihrem Anwendungsserver verwaltet wird:
org.quartz.dataSource.idp.java.naming.provider.url
Sie benötigen diesen URL, falls sich der JNDI-URL vom standardmäßigen JNDI-URL für den Anwendungsserver
unterscheidet (z. B. JBoss: jnp://localhost:1099).
® So stellen Sie die Scheduler-Eigenschaften ein:
1. Erstellen Sie eine neue Datei namens „dscscheduler.properties“.
2. Legen Sie die Werte der oben genannten Eigenschaften entsprechend den Anforderungen für den
Knoten des Anwendungsservers fest. Beispiel:
org.quartz.dataSource.idp.java.naming.provider.url =
jnp://localhost:1099/
org.quartz.jobstore.isClustered = true
org.quartz.scheduler.instanceId = AUTO
3. Fügen Sie das JVM-Argument -Dadobe.idp.scheduler.properties=[Pfad zu dieser
Datei]/dscscheduler.properties zu den Startskriptdateien bzw. der Konfiguration des
Anwendungsservers hinzu.
Fehlermeldungen
In diesem Abschnitt werden LiveCycle ES-spezifische Fehlermeldungen und ihre Definitionen beschrieben.
Beim Konvertieren nativer Dateien schlägt PDF Generator ES unter
Windows fehl
Beim Konvertieren nativer Dateien (z. B. Microsoft Word in PDF) schlägt PDF Generator ES bei der
Ausführung auf einem Windows-Betriebssystem eventuell fehl, wobei eine der folgenden ähnliche
Ausnahme in die Protokolldatei eingetragen wird:
INFO [PDF Generator] Application server started as user: SYSTEM
Dieses Problem tritt auf, wenn Sie nicht dasselbe Benutzerkonto für Microsoft Office, PDF Generator ES,
Acrobat für PDF Generator ES und Ihren Anwendungsserverprozess verwenden.
Um dieses Problem zu beheben, ändern Sie den Benutzer für den Dienst „JBoss für Adobe LiveCycle“
in den Benutzer für Microsoft Office.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Klasse nicht gefunden
65
® So legen Sie den Benutzer für den Dienst „JBoss für Adobe LiveCycle“ fest:
1. Wählen Sie Start > Systemsteuerung > Verwaltung > Computerverwaltung > Dienste und
Anwendungen > Dienste aus.
2. Doppelklicken Sie auf den Dienst „JBoss für Adobe LiveCycle“ und wählen Sie die Registerkarte
Anmelden aus.
3. Wählen Sie Dieses Konto aus, geben Sie den Benutzernamen und das Kennwort für den Microsoft
Office-Benutzer ein und klicken Sie auf OK.
Klasse nicht gefunden
Überprüfen Sie bei diesem Fehler Folgendes:
G
Ist die Klassenpfadeinstellung ungültig oder nicht vorhanden?
G
Ist die JAR-Datei veraltet?
G
Gibt es in der Klasse ein Kompilierungsproblem?
JNDI-Name nicht gefunden
Überprüfen Sie bei diesem Fehler Folgendes:
G
Wenn das Symptom eine Ausnahmestapelverfolgung mit Folgendem enthält
javax.naming.NameNotFoundException: jdbc/<falscher Name>
prüfen Sie, ob der erwartete Name ordnungsgemäß geschrieben ist. Falls nicht, müssen Sie den
Code korrigieren.
® So beseitigen Sie die gängigsten JNDI-Ausnahmen:
1. Überprüfen Sie die JNDI-Struktur auf dem LiveCycle ES-Anwendungsserver. Wird der verwendete
Name in der Struktur angezeigt?
G
Falls ja, ist es sehr wahrscheinlich, dass Ihr Code im Objekt InitialContext nicht ordnungsgemäß
eingerichtet wurde, das für die Suche verwendet wird, und die Suche in einer JNDI-Struktur erfolgt, die
nicht diejenige ist, in der die Ressource aufgelistet ist. Überprüfen Sie im Handbuch zur Installation und
BereitstellungLiveCycle ES Ihres Anwendungsservers die zu verwendenden Eigenschaftswerte.
G
Falls nein, fahren Sie mit Schritt 2 fort.
2. Wird die Ressourcen in der JNDI-Struktur unter einem anderen Namen als dem in der Suche angegebenen
Namen aufgeführt?
G
Falls ja, verwenden Sie den falschen Suchnamen. Geben Sie den ordnungsgemäßen Namen an.
G
Falls nein, fahren Sie mit Schritt 3 fort.
3. Überprüfen Sie beim Systemstart die Protokolle des Anwendungsservers. Wenn der Anwendungsserver
so konfiguriert wurde, dass diese Ressource verfügbar sein soll, aber ein Fehler auftritt, wird an dieser
Stelle eine Ausnahme ausgelöst. Wie lautet die Ausnahme?
G
Falls ja, überprüfen Sie die Ausnahme und die Stapelablaufverfolgung. Wenn eine Ausnahme vom
Typ „Name nicht gefunden“ im Rahmen Ihrer Untersuchung der Serverprotokolle ein Symptom
eines anderen Problems ist, wechseln Sie zu den Fehlerbehebungsschritten für dieses Problem.
G
Falls nein, fahren Sie mit Schritt 4 fort.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für JBoss
Ausnahmen beim mehrfachen Initialisieren der LiveCycle ES-Datenbank
66
4. Wenn die Ressource nicht in der JNDI-Struktur aufgeführt ist und beim Start keine Ausnahme ausgelöst
wird, die erklärt, warum diese nicht zur Verfügung steht, ist der wahrscheinlichste Grund, dass der
Anwendungsserver nicht ordnungsgemäß für die Bereitstellung dieser Ressource konfiguriert wurde.
Prüfen Sie die Konfiguration des Anwendungsservers. Wurde er für die Bereitstellung dieser Ressource
konfiguriert?
G
Falls nein, Siehe Installieren und Bereitstellen von LiveCycle ES für Ihren Anwendungsserver.
G
Ist dies der Fall, handelt es sich nicht um eines der gängigen Probleme, die als Ursache dieses
Fehlers gelten. Wenden Sie sich an den Adobe-Support.
Ausnahmen beim mehrfachen Initialisieren der LiveCycle ES-Datenbank
Wenn Sie die LiveCycle ES-Datenbank initialisieren, nachdem sie bereits initialisiert wurde, werden eventuell
Ausnahmen ausgegeben, die darauf hinweisen, dass das POF-Schema bereits initialisiert wurde.
Sie können diesen Fehler einfach ignorieren.