Installieren und Konfigurieren von LiveCycle für JBoss

Transcrição

bc
Installieren und Konfigurieren von
LiveCycle für JBoss
Adobe® LiveCycle™
October 2006
Version 7.2
© 2006 Adobe Systems Incorporated. Alle Rechte vorbehalten.
Adobe® LiveCycle™ 7.2 Installieren und Konfigurieren von LiveCycle für JBoss® für Microsoft® Windows® und Linux®
Ausgabe 1.0, October 2006
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 sowie Firmenlogos in Beispielvorlagen oder -formularen, die im Lieferumfang dieser Software enthalten sind,
dienen nur zur Veranschaulichung und sollen nicht auf ein tatsächliches Unternehmen hinweisen.
Adobe, das Adobe-Logo, Acrobat, Kozuka Gothic, Kozuka Mincho, LiveCycle, Minion, Myriad, Photoshop, PostScript und Reader sind
eingetragene Marken oder Marken von Adobe Systems Incorporated in den USA und/oder anderen Ländern.
BEA WebLogic Server ist eine eingetragene Marke von BEA Systems, Inc.
IBM, AIX, DB2 und WebSphere sind Marken der International Business Machines Corporation in den USA und/oder anderen Ländern.
Intel und Pentium sind eingetragene Marken der Intel Corporation in den USA und anderen Ländern.
Linux ist eine eingetragene Marke von Linus Torvalds in den USA und anderen Ländern.
Macintosh ist eine Marke von Apple Computer, Inc., die in den USA und anderen Ländern eingetragen ist.
Microsoft, Windows und Windows Server sind eingetragene Marken oder Marken der Microsoft Corporation in den USA und/oder anderen
Ländern.
Novell und SUSE sind eingetragene Marken von Novell, Inc. in den USA und anderen Ländern.
Oracle ist eine Marke der Oracle Corporation, die in bestimmten Rechtsgebieten möglicherweise eingetragen ist.
Red Hat und JBoss sind Marken oder eingetragene Marken von Red Hat, Inc. in den USA und anderen Ländern.
Sun, Java, JavaScript und Solaris sind Marken oder eingetragene Marken von Sun Microsystems, Inc. in den USA und anderen Ländern.
Alle SPARC-Marken werden unter Lizenz verwendet und sind Marken oder eingetragene Marken von SPARC International, Inc. Produkte mit
SPARC-Marken basieren auf einer von Sun Microsystems, Inc. entwickelten Architektur.
Alle anderen Marken sind Eigentum ihrer jeweiligen Inhaber.
Diese Software basiert teilweise auf der Arbeit der Independent JPEG Group.
Teile mit Copyright 1992, 1993 Simmule Turner und Rich Salz. Alle Rechte vorbehalten.
Dieses Produkt enthält Software, die von der Apache Software Foundation (http://www.apache.org/) entwickelt wurde.
Teile mit Copyright (C) 1991, 1999 Free Software Foundation, Inc. Die JBOSS-, OmniORB- und JacORB-Bibliotheken sind unter der GNU Library
General Public License lizenziert. Eine Kopie der Lizenz liegt dieser Software bei.
Dieses Produkt enthält BISAFE- und/oder TIPEM-Software von RSA Data Security, Inc.
Dieses Produkt enthält von Brian M. Clapper ([email protected]) entwickelte Software.
Teile dieses Codes sind von Apple Computer, Inc. gemäß den Bedingungen der Apple Public Source License, Version 2, lizenziert. Die
Quellcodeversion dieser Teile und die Lizenz stehen unter http://www.opensource.apple.com/apsl/ zur Verfügung.
Teile basieren zum Teil auf der Arbeit des FreeType-Teams.
Powered by Celequest. Enthält Technologie, die unter Lizenz von der Celequest Corporation vertrieben wird. Copyright 2005 Celequest
Corporation. Alle Rechte vorbehalten.
Dieses Produkt enthält Software, die vom Jaxen Project (http://www.jaxen.org/) entwickelt wurde.
Dieses Programm wurde mit MacApp® geschrieben: ©1985-1988 Apple Computer, Inc. APPLE COMPUTER, INC. ÜBERNIMMT KEINERLEI
AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GEWÄHRLEISTUNGEN FÜR DAS PRODUKT, EINSCHLIESSLICH GEWÄHRLEISTUNGEN BEZÜGLICH
DER MARKTGÄNGIGKEIT ODER DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Die MacApp-Software ist rechtlich geschütztes Eigentum von
Apple Computer, Inc. und ist für Adobe nur für den gemeinsamen Vertrieb mit Adobe-Software lizenziert.
Teile sind gemäß der MPL (Mozilla Public License), Version 1.1 (verfügbar unter www.mozilla.org), lizenziert. Die gemäß den Bestimmungen
der Lizenz vertriebene Software wird OHNE GEWÄHRLEISTUNG UND OHNE JEGLICHE ZUSICHERUNGEN, VERPFLICHTUNGEN ODER
GARANTIEN JEDWEDER ART (weder ausdrücklich noch stillschweigend) ZUR VERFÜGUNG GESTELLT. Die genauen Berechtigungen und
Einschränkungen gemäß der Lizenz sind dem Wortlaut der Lizenz zu entnehmen.
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 bzw. 48 C.F.R. §227.7202, falls anwendbar. In Übereinstimmung mit 48 C.F.R. §12.212 bzw.
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 verpflichtet sich Adobe, 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
Einleitung ..................................................................................................................................... 8
Inhalt dieses Handbuchs ............................................................................................................................................................. 8
Zielgruppe des Handbuchs ........................................................................................................................................................ 8
Konventionen in diesem Handbuch ....................................................................................................................................... 8
Verwandte Dokumentation........................................................................................................................................................ 9
Aktualisierte Informationen zu LiveCycle-Produkten...............................................................................................10
1
Vorbereiten der Installation ..................................................................................................... 11
Installation, Konfiguration und Bereitstellung ..................................................................................................................11
Methoden für die Installation, Konfiguration und Bereitstellung von LiveCycle-Produkten...........................12
Aktualisieren von LiveCycle-Produkten ...............................................................................................................................12
Informationen zur Installation von Watched Folder .......................................................................................................13
Systemanforderungen................................................................................................................................................................13
Unterstützte Software ..........................................................................................................................................................13
Plattform- und Softwarekombinationen.......................................................................................................................15
Mindestanforderungen an die Hardware .....................................................................................................................15
Zusätzliche Anforderungen für LiveCycle PDF Generator Elements und LiveCycle PDF Generator
Professional........................................................................................................................................................................16
Zusätzliche Anforderungen für LiveCycle PDF Generator für PostScript ..........................................................16
Checklisten für Installation, Konfiguration und Bereitstellung ...................................................................................17
Checkliste für die Turnkey-Installation und -Bereitstellung ...................................................................................17
Checkliste für die manuelle Installation und Bereitstellung ..................................................................................17
Aktualisierte Informationen zu LiveCycle-Produkten...............................................................................................18
Teil I: Turnkey-Installation
2
Installieren von LiveCycle-Produkten mit der Turnkey-Methode......................................... 20
Durchführen der Turnkey-Installation ..................................................................................................................................20
Ändern der LiveCycle-Dienste...........................................................................................................................................25
3
Aufgaben nach der Bereitstellung ........................................................................................... 27
Zugreifen auf Administrator.....................................................................................................................................................27
Zugreifen auf User Management ...........................................................................................................................................28
Aufgaben nach der Bereitstellung von LiveCycle Assembler ......................................................................................28
Überprüfen der Bereitstellung von LiveCycle Assembler .......................................................................................28
Aufgaben nach der Bereitstellung von LiveCycle Forms...............................................................................................29
Überprüfen der Bereitstellung von LiveCycle Forms................................................................................................29
Aufgaben nach der Bereitstellung von LiveCycle Print..................................................................................................29
Überprüfen der Bereitstellung ..........................................................................................................................................30
Bereitstellen und Ausführen der PrintIVS-Webanwendung ..................................................................................30
Ausführen der Print Submitter-Anwendung ...............................................................................................................30
Ausführen der Print-Anwendung der Form Server-Modul-API.............................................................................31
Aufgaben nach der Bereitstellung von LiveCycle Form Manager..............................................................................32
Zugreifen auf die Endbenutzerseiten für LiveCycle Form Manager....................................................................32
Aufgaben nach der Bereitstellung von LiveCycle PDF Generator..............................................................................33
Einrichten von Auftragsquellen........................................................................................................................................33
Einrichten von Adobe PDF Printer als Standarddrucker..........................................................................................33
4
Adobe LiveCycle
Inhaltsverzeichnis
Installieren von Schriften ....................................................................................................................................................33
Einstellen des Konvertierungstimeouts in LiveCycle PDF Generator .................................................................34
Teil II: Manuelle Installation, Konfiguration und Bereitstellung
4
Installieren von LiveCycle-Produkten...................................................................................... 37
Installieren von LiveCycle PDF Generator ...........................................................................................................................37
Installieren von LiveCycle-Produkten ...................................................................................................................................40
Installieren von LiveCycle Print ...............................................................................................................................................42
Installieren von Watched Folder.............................................................................................................................................43
Anzeigen des Fehlerprotokolls................................................................................................................................................43
5
Vorbereiten der Umgebung ..................................................................................................... 44
Erstellen der Datenbank ............................................................................................................................................................44
Erstellen einer MySQL-Datenbank...................................................................................................................................44
Erstellen einer Oracle-Datenbank ....................................................................................................................................45
Erstellen einer DB2-Datenbank.........................................................................................................................................46
Konfigurieren einer DB2-Datenbank für die gleichzeitige Verwendung ..........................................................47
Erstellen einer SQL Server-Datenbank ...........................................................................................................................48
Erstellen einer JMS-Datenbank auf SQL Server...........................................................................................................48
Vorbereiten des Anwendungsservers...................................................................................................................................50
Installieren von JBoss Application Server......................................................................................................................50
6
Konfigurieren von LiveCycle-Produkten für die Bereitstellung ............................................ 51
7
Manuelles Konfigurieren von JBoss......................................................................................... 56
Starten und Beenden von JBoss .............................................................................................................................................56
Ändern der JBoss-Konfigurationsdateien ...........................................................................................................................57
Konfigurieren von JBoss für Watched Folder.....................................................................................................................61
Herstellen einer Verbindung zwischen JBoss für LiveCycle-Produkte und der LiveCycle-Datenbank .........61
Konfigurieren der MySQL-Datenquelle..........................................................................................................................61
Konfigurieren der Oracle-Datenquelle...........................................................................................................................62
Konfigurieren der DB2-Datenquelle ...............................................................................................................................64
Konfigurieren der SQL Server-Datenquelle..................................................................................................................65
8
Manuelles Bereitstellen auf JBoss ............................................................................................ 67
Bereitstellen von LiveCycle-Produkten ................................................................................................................................67
Name des JBoss-Verzeichnisses........................................................................................................................................67
Übersicht der bereitstellbaren Komponenten ............................................................................................................67
Bereitstellen auf JBoss ................................................................................................................................................................68
Anwenden des Verbindungspool-Patches für Watched Folder..................................................................................69
Anzeigen von Protokolldateien ..............................................................................................................................................69
9
Initialisieren der Datenbank..................................................................................................... 70
10 Konfigurieren von LiveCycle-Produkten für den LDAP-Zugriff............................................. 72
Konfigurieren von LiveCycle-Produkten mit LDAP..........................................................................................................72
Konfigurieren von LiveCycle-Produkten mit LDAPS .......................................................................................................73
Teil III: Konfiguration nach der Bereitstellung
11 Konfigurieren von SSL auf JBoss .............................................................................................. 75
Erstellen einer SSL-Berechtigung ...........................................................................................................................................75
Konfigurieren von SSL auf JBoss............................................................................................................................................77
Adobe LiveCycle
Inhaltsverzeichnis
12 Manuelles Konfigurieren von JBoss für BAM Server .............................................................. 80
Installieren von JBoss Application Server............................................................................................................................80
Erstellen der BAM-Metadaten-Datenbank..........................................................................................................................80
Benutzerkonten ......................................................................................................................................................................80
Konfigurieren von JBoss für BAM Server..............................................................................................................................81
Installieren der Datenbanktreiber auf JBoss für BAM Server .................................................................................81
Herstellen einer Verbindung zwischen JBoss und der BAM-Metadaten-Datenbank ...................................81
Herstellen einer Verbindung zwischen JBoss für BAM Server und der LiveCycle-Datenbank...................83
Konfigurieren erforderlicher JVM-Optionen für JBoss .............................................................................................86
Optionale JVM-Optionen für JBoss..................................................................................................................................87
Ändern der JBoss-Threadkonfiguration.........................................................................................................................88
Konfigurieren der JBoss-Protokollierung ......................................................................................................................89
Anpassen der Anschlussnummern..................................................................................................................................89
Bereitstellen von BAM Server...................................................................................................................................................91
Teil IV: Zusätzliche Konfigurationsschritte für LiveCycle Workflow
13 Erste Schritte mit BAM Server................................................................................................... 93
Konfigurieren von LiveCycle Workflow Server für BAM Server ...................................................................................93
Zugreifen auf BAM Workbench und BAM Dashboard ...................................................................................................93
Konfigurieren von BAM Server ................................................................................................................................................94
Konfigurieren der SMTP-Einstellungen..........................................................................................................................94
Importieren der Metadaten-Definitionen für LiveCycle Workflow......................................................................95
Konfigurieren von LDAP-Einstellungen für BAM Server ..........................................................................................96
14 Installieren von LiveCycle Workflow Designer .....................................................................101
Installieren von LiveCycle Workflow Designer .............................................................................................................. 101
Herstellen einer Verbindung zu Anwendungsservern über nicht standardmäßige Anschlüsse................. 102
Deinstallieren von LiveCycle Workflow Designer.......................................................................................................... 102
A
Unterstützte Plattform- und Softwarekombinationen ........................................................104
B
Mit dem Font Manager-Modul installierte Schriften ............................................................107
C
Aufrufen von LiveCycle Assembler mit LiveCycle Workflow und Watched Folder ............108
Übersicht über Aufgaben....................................................................................................................................................... 108
Bereitstellen von QPACs und Erstellen von Workflow-Prozessen ........................................................................... 109
Verwenden dynamischer oder statischer DDX-Dateien....................................................................................... 109
Konfigurieren einer Assembler-QPAC in einem Workflow-Prozess.................................................................. 110
Erstellen und Konfigurieren eines überwachten Ordners.......................................................................................... 112
Erstellen einer Datei JobConfig.xml ................................................................................................................................... 114
Vorbereiten von PDF- und DDX-Dateien.......................................................................................................................... 116
Senden des LiveCycle Assembler-Auftrags zur Verarbeitung................................................................................... 116
D
Entwickeln von Formularen für LiveCycle .............................................................................118
Veröffentlichen von Dateien mithilfe von Clientsoftware.......................................................................................... 118
Entwerfen von Formularen für LiveCycle-Produkte ..................................................................................................... 118
Verwenden von dynamischen Formularen in LiveCycle-Produkten................................................................ 119
Einbetten von Schriften in PDF/A-konforme Formulare ...................................................................................... 119
E
Deinstallieren von LiveCycle-Produkten ...............................................................................120
Entfernen der mit der Turnkey-Methode installierten Produktdateien ................................................................ 120
Entfernen der auf manuelle Weise installierten Produktdateien............................................................................. 121
Adobe LiveCycle
Inhaltsverzeichnis
F
Aktualisieren von LiveCycle-Produkten auf Version 7.2 oder 7.2.1....................................122
Richtlinien für die Aktualisierung ........................................................................................................................................ 122
Aktualisieren des Anwendungsservers....................................................................................................................... 123
Verwenden der automatischen oder der Turnkey-Installation für die Aktualisierung.............................. 123
Konfigurieren mit Configuration Manager während der Aktualisierung....................................................... 123
Übersicht über die manuelle Aktualisierung................................................................................................................... 123
LiveCycle Forms und LiveCycle Print.................................................................................................................................. 124
Aktualisieren von Adobe Form Server 6.0 auf LiveCycle Forms 7.2.................................................................. 124
Aktualisieren von LiveCycle Forms und LiveCycle Print 7.x auf LiveCycle Forms und LiveCycle Print 7.2 125
LiveCycle Form Manager ........................................................................................................................................................ 129
LiveCycle Assembler, LiveCycle Workflow und Watched Folder ............................................................................. 131
LiveCycle Workflow Designer ............................................................................................................................................... 134
BAM Server für LiveCycle Workflow ................................................................................................................................... 134
Informationen zum BAM Server-Aktualisierungsdienstprogramm.................................................................. 135
LiveCycle PDF Generator ........................................................................................................................................................ 137
LiveCycle Document Security ............................................................................................................................................... 140
LiveCycle Reader Extensions ................................................................................................................................................. 142
LiveCycle Policy Server ............................................................................................................................................................ 146
G
Verbessern der Serverleistung ...............................................................................................148
Optimieren von Inline-Dokumenten und Auswirkungen auf den JVM-Speicher.............................................. 148
Erhöhen des der JVM zugewiesenen maximalen Speichers ..................................................................................... 149
Löschen temporärer Dateien aus dem globalen Speicherverzeichnis .................................................................. 150
DB2-Konfigurationseinstellungen....................................................................................................................................... 150
Verbessern der Windows Server-Leistung mit LDAP ................................................................................................... 150
Index .........................................................................................................................................152
Einleitung
Dieses Handbuch ist eine von mehreren verfügbaren Informationsquellen für die Verwendung des
Produktpakets von Adobe® LiveCycle™. LiveCycle-Produkte tragen zur Automatisierung und
Beschleunigung des Flusses geschäftskritischer Informationen von und zu Kunden, Partnern,
Auftraggebern und Mitarbeitern bei.
Inhalt dieses Handbuchs
In diesem Handbuch finden Sie Informationen zum Installieren und Konfigurieren der folgenden
LiveCycle-Produkte unter Microsoft® Windows® und Linux® und erfahren darüber hinaus, wie die Produkte
auf JBoss® Application Server bereitgestellt werden:
Adobe LiveCycle Assembler 7.2.1
Adobe LiveCycle Forms 7.2
Adobe LiveCycle Form Manager 7.2
Adobe LiveCycle PDF Generator 7.2 Professional, LiveCycle PDF Generator 7.2 Elements und LiveCycle
PDF Generator 7.2 für PostScript®
Adobe LiveCycle Print 7.2
Adobe LiveCycle Workflow 7.2.1
Dieses Handbuch enthält darüber hinaus Anleitungen für die Installation und Konfiguration von Watched
Folder 1.1.
Zielgruppe des Handbuchs
Dieses Handbuch richtet sich an Administratoren oder Entwickler, die für die Installation, Konfiguration,
Verwaltung oder Bereitstellung von LiveCycle-Produkten zuständig sind. Benutzer dieses Handbuchs
sollten mit Anwendungsservern, den Betriebssystemen Linux und Windows, Datenbankservern im Format
MySQL, Oracle®, DB2® oder SQL Server sowie Webumgebungen vertraut sein.
Konventionen in diesem Handbuch
In diesem Handbuch werden die folgenden Namenskonventionen für allgemeine Dateipfade verwendet.
Name
Standardwert
Beschreibung
[LiveCycle-Stammverzeichnis]
Windows:
C:\Adobe\LiveCycle\
Das Installationsverzeichnis für alle
LiveCycle-Produkte. Das
Installationsverzeichnis enthält
Unterordner für Adobe Configuration
Manager, die Produkt-SDKs sowie die
einzelnen installierten LiveCycleProdukte (einschließlich
Produktdokumentation).
Linux:
/opt/adobe/livecycle/
8
Adobe LiveCycle
Einleitung
Verwandte Dokumentation
Name
Standardwert
Beschreibung
[Produkt-Stammverzeichnis]
Windows:
Die Verzeichnisse, in denen sich
produktspezifische Ordner und
Dateien befinden (Dokumentation,
Deinstallationsdateien, Beispiele und
Lizenzinformationen).
C:\Adobe\LiveCycle\Assembler
C:\Adobe\LiveCycle\pdfgenerator
C:\Adobe\LiveCycle\Workflow
C:\Adobe\LiveCycle\Forms
C:\Adobe\LiveCycle\Print
C:\Adobe\LiveCycle\Formmanager
Linux:
/opt/adobe/livecycle/assembler
/opt/adobe/livecycle/pdfgenerator
/opt/adobe/livecycle/workflow
/opt/adobe/livecycle/forms
/opt/adobe/livecycle/print
/opt/adobe/livecycle/formmanager
[AnwendungsserverStammverzeichnis]
Windows (Turnkey-Installation):
C:\Adobe\LiveCycle\jboss\
Windows (manuelle Installation):
C:\jboss
Das Basisverzeichnis des
Anwendungsservers, auf dem die
LiveCycle-Produkte ausgeführt
werden.
Linux:
/opt/jboss
[JBoss-BAM-Stammverzeichnis]
Das Verzeichnis, in dem JBoss installiert ist. Das Basisverzeichnis der
JBoss-Instanz, auf der Business
Activity Monitor (BAM) Server
ausgeführt wird.
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.
Verwandte Dokumentation
Dieses Handbuch enthält Anleitungen zur Bereitstellung von LiveCycle-Produkten auf JBoss. Die
Handbücher Installieren und Konfigurieren von LiveCycle-Produkten für andere unterstützte
Anwendungsserver können von der folgenden Website heruntergeladen werden:
www.adobe.com/support/documentation/en/livecycle/
In der folgenden Tabelle finden Sie Hinweise auf weiterführende Informationen zum Verwenden von
LiveCycle-Produkten:
9
Adobe LiveCycle
Einleitung
Gewünschte Informationen
Aktualisierte Informationen zu LiveCycle-Produkten
10
Siehe
Allgemeine Informationen zu einem Produkt
Handbücher Übersicht für die einzelnen Produkte
sowie Informationen zur Integration mit anderen
Adobe-Produkten
Produktarchitektur, Verwendung der APIs und
Entwickeln benutzerdefinierter Anwendungen
zum Verwenden mit den Produkten
Entwicklerhandbücher für die einzelnen Produkte, z. B.
Developing Custom Applications for LiveCycle Workflow
oder Developing Applications for LiveCycle Assembler
EJB-API, einschließlich Erläuterungen der
Klassen und Methoden
Handbuch API Reference für die einzelnen Produkte.
Diese Handbücher werden in der Regel als JavaDocs
mit dem entsprechenden Produkt installiert. Einige
Handbücher liegen dem Produkt jedoch als PDFDokumente bei.
Syntax für die DDX-Grammatik (Document
Document Description XML Reference
Description XML) und verwandte, von LiveCycle
Assembler unterstützte XML-Grammatiken
Einrichten und Verwalten von Watched Folder
Watched Folder-Administrator-Hilfe
Verwalten des Zugriffs auf die Benutzeroberfläche User Management-Administrator-Hilfe
von Adobe Administrator
Verwenden von LiveCycle Workflow Designer
Erstellen von Workflows oder LiveCycle Workflow
Designer-Hilfe
Verwenden des LiveCycle Workflow-SDK zum
Erstellen von QPACs (Quick Process Action
Components), die in den EJB-APIs der
LiveCycle-Produkte Methoden aufrufen
Die mit dem LiveCycle Workflow-SDK verfügbaren
QPAC-Handbücher, z. B. Using LiveCycle Assembler
QPACs oder Using LiveCycle Forms QPACs
Weitere Dienste und Produkte, die in
LiveCycle-Produkte integriert werden können
www.adobe.de
Patch-Updates, technische Hinweise und
zusätzliche Informationen zu dieser
Produktversion
www.adobe.com/support/products/enterprise/
index.html
Informationen zu weiterer Dokumentation zu den einzelnen LiveCycle-Produkten finden Sie im Ordner
[Produkt-Stammverzeichnis]/documentation in der Datei doc_map.pdf.
Hinweis: Wenn Sie Text direkt aus diesem Handbuch kopieren und einfügen, können Sie das Tag <CR>
mitkopieren, falls sich die Anleitungen in diesem Handbuch über eine Zeile erstrecken.
Adobe Systems hat im Knowledge Center einen Artikel veröffentlicht, um Kunden die neuesten
Informationen zu LiveCycle-Produkten mitzuteilen. Sie finden diesen Artikel unter
www.adobe.com/support/products/enterprise/knowledgecenter/c4811.pdf.
1
Vorbereiten der Installation
In diesem Kapitel wird die Vorbereitung des Systems auf die Installation von LiveCycle-Produkten
beschrieben.
O
„Installation, Konfiguration und Bereitstellung“ auf Seite 11
O
„Methoden für die Installation, Konfiguration und Bereitstellung von LiveCycle-Produkten“ auf Seite 12
O
„Installieren und Bereitstellen mehrerer LiveCycle-Produkte“ auf Seite 12
O
„Systemanforderungen“ auf Seite 13
O
„Checklisten für Installation, Konfiguration und Bereitstellung“ auf Seite 17
O
„Aktualisierte Informationen zu LiveCycle-Produkten“ auf Seite 18
Vor Beginn der Installation von LiveCycle-Produkten auf dem Anwendungsserver sollten Sie die
Downloadseite für Adobe LiveCycle-Produkte besuchen, um sicherzustellen, dass Sie über die aktuellste
Version der Software verfügen. Sie finden diese Seite unter der folgenden Adresse:
www.adobe.com/support/products/enterprise/support_downloads.html
Installation, Konfiguration und Bereitstellung
Die Installation, Konfiguration und Bereitstellung von LiveCycle-Produkten besteht aus den folgenden Schritten:
Installation: Beim Installieren der Produkte werden alle erforderlichen Dateien in eine
Installationsverzeichnis-Struktur auf dem Computer kopiert. Die Installation wird durch Ausführen
des Installationsprogramms durchgeführt. Das Standardverzeichnis für die Installation ist
C:\Adobe\LiveCycle (Windows) bzw. /opt/adobe/livecycle (Linux). Sie können die Dateien jedoch auch
in einem anderen Verzeichnis installieren. In diesem Handbuch wird das Standardverzeichnis für die
Installation als [LiveCycle-Stammverzeichnis] bezeichnet. Damit mehrere LiveCycle-Produkte
zusammenarbeiten können, müssen alle Produkte im selben Verzeichnis [LiveCycle-Stammverzeichnis]
installiert werden. Auf diese Weise können Sie die unterschiedlichen LiveCycle-Produkte zu einer
EAR-Datei assemblieren. (Siehe „Installieren von LiveCycle-Produkten“ auf Seite 40.)
Konfiguration und Assemblierung: Beim Konfigurieren der Produkte werden verschiedene
Einstellungen vorgenommen, mit denen die Funktionsweise der Produkte festgelegt wird. Beim
Assemblieren der Produkte werden alle benötigten installierten Komponenten gemäß Ihren
Konfigurationsanweisungen zu einer bereitstellbaren EAR-Datei zusammengefügt. Sie konfigurieren
und assemblieren die Produkte für die Bereitstellung, indem Sie Configuration Manager ausführen.
(Siehe „Konfigurieren von LiveCycle-Produkten für die Bereitstellung“ auf Seite 51.) Sie können
mehrere LiveCycle-Produkte gleichzeitig konfigurieren und assemblieren.
Bereitstellung: Das Bereitstellen der Produkte besteht aus der Bereitstellung der assemblierten
EAR-Datei und einiger weiterer konfigurierter Dateien auf dem JBoss-Anwendungsserver, auf dem Sie
die LiveCycle-Lösung ausführen möchten. Wenn Sie mehrere Produkte konfiguriert und assembliert
haben, werden die meisten bereitstellbaren Komponenten für diese Produkte zu einer einzelnen
bereitstellbaren LiveCycle.ear-Datei zusammengefasst.
Initialisieren der LiveCycle-Datenbank: Beim Initialisieren der LiveCycle-Datenbank werden Tabellen
zur Verwendung mit Adobe User Management und bestimmten LiveCycle-Produkten erstellt. Wenn Sie
ein LiveCycle-Produkt bereitstellen, das eine Verbindung zur LiveCycle-Datenbank herstellt, müssen Sie
die LiveCycle-Datenbank nach der Bereitstellung initialisieren. (Siehe „Initialisieren der Datenbank“ auf
Seite 70.)
11
Adobe LiveCycle
Methoden für die Installation, Konfiguration und Bereitstellung von LiveCycle-Produkten 12
Methoden für die Installation, Konfiguration und Bereitstellung
von LiveCycle-Produkten
Sie können eine der folgenden Methoden verwenden, um LiveCycle-Produkte zu installieren, zu
konfigurieren und bereitzustellen sowie die Datenbank zu initialisieren:
Turnkey: (Windows/JBoss/MySQL) Mit der Turnkey-Methode können Sie die Dateien installieren und
anschließend Configuration Manager ausführen, um die EAR-Datei und andere Komponenten zu
konfigurieren und automatisch die folgenden Aufgaben durchzuführen:
O
Installieren und Konfigurieren von JBoss Application Server und der MySQL-Datenbank
O
Assemblieren und Bereitstellen der Produkte auf JBoss
O
Initialisieren der MySQL-Datenbank
Bei der Turnkey-Methode wird SSL nicht konfiguriert. (Siehe „Checkliste für die Turnkey-Installation
und -Bereitstellung“ auf Seite 17 oder „Installieren von LiveCycle-Produkten mit der Turnkey-Methode“
auf Seite 20.)
Manuell: Mit der manuellen Methode können Sie die Dateien installieren und anschließend
Configuration Manager ausführen, um den Anwendungsserver, die EAR-Datei und andere
Komponenten zu konfigurieren sowie die EAR-Datei bereitzustellen. Sie können die Konfiguration des
Anwendungsservers und die Bereitstellung der EAR-Datei auch manuell durchführen. Danach müssen
Sie jedoch den Anwendungsserver auf manuelle Weise installieren und nach der Konfiguration starten
sowie die Datenbank erstellen und konfigurieren, bevor Sie Configuration Manager ausführen und auf
dem Anwendungsserver bereitstellen können. Darüber hinaus müssen Sie Configuration Manager ein
zweites Mal ausführen (nach der Bereitstellung), um die Datenbank zu initialisieren. (Siehe „Checkliste
für die manuelle Installation und Bereitstellung“ auf Seite 17.)
Installieren und Bereitstellen mehrerer LiveCycle-Produkte
Wenn Sie mehrere der in diesem Handbuch besprochenen LiveCycle-Produkte bereitstellen und ihre
Interoperabilität gewährleisten möchten, müssen Sie die Produkte an demselben Speicherort installieren,
in einer einzelnen EAR-Datei assemblieren und diese EAR-Datei dann bereitstellen.
Hinweis: Falls Sie mehrere Produkte des Produktpakets von LiveCycle 7.2 installieren möchten, sollten Sie
bei der Installation die folgende Reihenfolge einhalten:
O
LiveCycle PDF Generator
O
LiveCycle Assembler, LiveCycle Forms, LiveCycle Form Manager, LiveCycle Print, LiveCycle
Workflow
O
LiveCycle Document Security, LiveCycle Policy Server, LiveCycle Reader Extensions
Ausführliche Informationen zum Installieren mehrerer Produkte finden Sie in der TechNote unter
Aktualisieren von LiveCycle-Produkten
Informationen zum Aktualisieren von LiveCycle-Produkten finden Sie in diesem Handbuch unter
„Aktualisieren von LiveCycle-Produkten auf Version 7.2 oder 7.2.1“ auf Seite 122.
Adobe LiveCycle
Informationen zur Installation von Watched Folder 13
Informationen zur Installation von Watched Folder
Sowohl LiveCycle Assembler als auch LiveCycle PDF Generator können mithilfe überwachter Ordner die
Verarbeitung von Aufträgen initiieren. Allerdings setzen LiveCycle Assembler und LiveCycle PDF Generator
hierbei unterschiedliche Technologien ein.
LiveCycle Assembler verwendet einen Dienst mit dem Namen Watched Folder, den Sie separat installieren
und mithilfe von Configuration Manager mit LiveCycle Workflow konfigurieren. Dieser Dienst ist in der
bereitstellbaren LiveCycle.ear-Datei enthalten.
In LiveCycle PDF Generator gehören überwachte Ordner zu den integrierten Funktionen, die nicht separat
installiert werden müssen. Die für die überwachten Ordner von LiveCycle PDF Generator erforderlichen
Konfigurationsaufgaben werden unter „Aufgaben nach der Bereitstellung von LiveCycle PDF Generator“
auf Seite 33 beschrieben.
Alle übrigen Verweise auf die Installation und Konfiguration von Watched Folder in diesem Handbuch
beziehen sich auf den Dienst, den LiveCycle Workflow und LiveCycle Assembler verwenden.
Systemanforderungen
Dieser Abschnitt enthält Einzelheiten zur Software und Hardware, die zur Ausführung von LiveCycleProdukten erforderlich sind.
Hinweis: Wenn Sie die Turnkey-Methode zur Installation und Konfiguration wählen, benötigen Sie
lediglich das Java™ Development Kit (JDK) und einen unterstützten Webbrowser. Mit der
Turnkey-Methode werden JBoss (einschließlich Apache-Webserver) und eine MySQL-Datenbank
installiert und konfiguriert.
Das JDK ist keine Vorbedingung für LiveCycle PDF Generator. Sollte es noch nicht installiert sein,
wird es vom Turnkey-Installationsprogramm installiert.
Unterstützte Software
Diese Tabelle bietet einen Überblick über die Anwendungsserver, Webbrowser und JDK-Versionen, die von
LiveCycle-Produkten unterstützt werden. Eine vollständige Liste finden Sie unter „Unterstützte Plattformund Softwarekombinationen“ auf Seite 104.
Adobe LiveCycle
Unterstützte Software 14
Erforderliche Software
Unterstützte Version
Betriebssystem
O
Microsoft Windows Server™ 2003 Enterprise Edition oder Standard
Edition
O
(LiveCycle Workflow Designer) Microsoft Windows XP Service
Pack 2
O
SUSE™ Linux Enterprise Server 9.0, i386 (32 Bit)
O
Red Hat® Linux Advanced Server 2.1 oder 3.0
Hinweis: LiveCycle PDF Generator Elements und LiveCycle PDF
Generator Professional werden nur unter Microsoft Windows
Server 2003 unterstützt.
Anwendungsserver
O
JBoss Application Server 3.2.5
O
JBoss Application Server 3.2.6 (gilt nur für BAM Server, eine
Komponente von LiveCycle Workflow Server)
Hinweis: Der Zugriff auf LiveCycle Administrator setzt voraus, dass der
Anwendungsserver über eine aktive Internetverbindung
verfügt.
Webbrowser
O
Microsoft Internet Explorer 6.0 für Windows
O
Netscape 7.1 oder höher für Windows
O
Netscape 7.2 oder höher für Linux
O
Mozilla 1.8 oder höher für Windows und Linux
O
Safari 1.2.3, Safari 1.3, Safari 2.0 (Endbenutzerunterstützung nur für
Macintosh)
O
(LiveCycle Forms) Firefox 1.0
Hinweis: LiveCycle PDF Generator unterstützt nur Microsoft Internet
Explorer 6.0.
JDK
O
J2SDK Version 1.4.2_04 oder eine spätere Unterversion von 1.4.2
(Unterversion 1.4.2_10 wird nicht unterstützt)
Sie müssen die Umgebungsvariable JAVA_HOME erstellen oder so
einstellen, dass sie auf den Installationspfad von Java verweist.
Vergewissern Sie sich, dass sich das Verzeichnis \bin der
J2SE-Installation (Java 2 Standard Edition) in der Umgebungsvariablen
PATH befindet. (Dies ist bei LiveCycle PDF Generator und LiveCycle
Assembler nicht erforderlich.)
Datenbank
O
Microsoft SQL Server 2000 SP 3
O
MySQL 4.1
O
(Turnkey) HSQLDB 1.7.1 wird als JBoss JMS-Datenbank verwendet
(HSQLDB 1.7.1 ist im Lieferumfang von JBoss 3.2.5 enthalten)
O
Oracle 9i
O
Oracle 10g
Adobe LiveCycle
Plattform- und Softwarekombinationen 15
Erforderliche Software
Unterstützte Version
Datenbanktreiber
O
IBM DB2: db2jcc.jar und db2jcc_license_cu.jar
O
Microsoft SQL Server 2000: msbase.jar, mssqlserver.jar und
msutil.jar
O
MySQL: mysql-connector-java-3.0.15-ga-bin.jar
O
Microsoft SQL Server 2000 für BAM: msbase.jar, mssqlserver.jar und
msutil.jar
O
Oracle: ojdbc14,jar, Version 10.2.0.2
O
Sun ONE 5.1, 5.2
O
Microsoft Active Directory 2000
O
Microsoft Active Directory 2003
O
Novell® eDirectory 8.7
LDAP-Server
Hinweis: Wenn Sie die Turnkey-Installation durchführen, darf auf dem Zielrechner keine Instanz von JBoss
Application Server oder des MySQL-Datenbankservers ausgeführt werden.
Plattform- und Softwarekombinationen
Die folgende Tabelle bietet einen Überblick über die von JBoss 3.2.5 unterstützten Software- und
Datenbankkombinationen. Eine vollständige Liste der von den einzelnen Betriebssystemen unterstützten
Software finden Sie unter „Unterstützte Plattform- und Softwarekombinationen“ auf Seite 104.
Hinweis: LiveCycle PDF Generator Elements und LiveCycle PDF Generator Professional werden nur unter
Windows Server 2003 Enterprise Edition ausgeführt.
Betriebssystem
Datenbank
Red Hat Linux Advanced Server 3.0
Microsoft SQL Server 2000 SP 3
Microsoft Windows Server 2003 Enterprise Edition oder Standard Edition MySQL 4.1
Mindestanforderungen an die Hardware
In der Tabelle in diesem Abschnitt werden die unterstützten Betriebssysteme und die entsprechende
Hardware aufgeführt. Für alle Installationen sind diese Einstellungen als Mindestwerte empfohlen:
O
Speicherplatz für die Installation: 3 GB für jedes Produkt; für LiveCycle PDF Generator sind jedoch
3,5 GB erforderlich
O
Temporärer Systemspeicherplatz während der Installation: 3 GB
O
Arbeitsspeicher für die Ausführung der Produkte: 1 GB pro Produkt für jeden Prozessor; für LiveCycle
PDF Generator sind jedoch 1,5 GB für jeden Prozessor erforderlich
Betriebssystem
Windows Server 2003 Enterprise Edition oder
Standard Edition
Intel® Pentium® 3-Prozessor oder gleichwertiger
x86-Prozessor, 1 GHz
Adobe LiveCycle
Zusätzliche Anforderungen für LiveCycle PDF Generator Elements und LiveCycle PDF Generator Professional 16
Betriebssystem
SUSE Linux Enterprise Server 9.0, i386 (32 Bit)
Pentium 3-Prozessor oder gleichwertiger x86-Prozessor,
1 GHz
Red Hat Linux Advanced Server 2.1 oder 3.0
Pentium 3-Prozessor oder gleichwertiger x86-Prozessor,
1 GHz
Zusätzliche Anforderungen für LiveCycle PDF Generator Elements und
LiveCycle PDF Generator Professional
LiveCycle PDF Generator Elements und LiveCycle PDF Generator Professional müssen unter Microsoft
Windows Server 2003 mit dem Gebietsschema en_US installiert werden. Der Windows-Benutzer, der das
Produkt installiert, muss über Administratorrechte verfügen und auch Microsoft Office auf diesem
Computer installiert haben.
Vor der Installation von LiveCycle PDF Generator Elements oder LiveCycle PDF Generator Professional
müssen Sie sich vergewissern, dass weder Adobe Acrobat® Professional noch Acrobat Standard installiert
ist. Ist Acrobat installiert, müssen Sie diese Software deinstallieren und den Computer dann neu starten.
Adobe Reader® darf jedoch installiert sein.
Vor der Installation von LiveCycle PDF Generator Elements oder LiveCycle PDF Generator Professional
müssen Sie auch die Software installieren, die die Dateiformate unterstützt, für die die Unterstützung der
PDF-Konvertierung erforderlich ist. LiveCycle PDF Generator Elements und LiveCycle PDF Generator
Professional können so erweitert werden, dass sie diese zusätzlichen Dateitypen mithilfe der folgenden
Anwendungen in PDF-Dateien konvertieren können:
O
Microsoft Office 2000, XP oder 2003
O
(LiveCycle PDF Generator Professional) Microsoft Office Visio 2003
O
(LiveCycle PDF Generator Professional) Microsoft Project 2003
O
(LiveCycle PDF Generator Professional) AutoCAD 2005
O
Corel WordPerfect 12
O
Adobe Photoshop® CS2
Bevor Sie unter Windows eine Turnkey-Installation von LiveCycle PDF Generator abschließen,
vergewissern Sie sich, dass das Befehlszeilenprogramm Dienststeuerungs-Manager (sc.exe) in der
Windows-Umgebungsvariablen installiert ist. Diese Software ist auf einigen Windows-Servern nicht
vorinstalliert. Die Datei sc.exe wird standardmäßig im Verzeichnis \Windows\system32 installiert.
LiveCycle PDF Generator Professional und LiveCycle PDF Generator Elements müssen auf dem Server
installiert werden, auf dem sie konfiguriert und bereitgestellt werden müssen.
Zusätzliche Anforderungen für LiveCycle PDF Generator für PostScript
LiveCycle PDF Generator für PostScript wird von allen unter „Unterstützte Software“ auf Seite 13
aufgeführten Betriebssystemen unterstützt.
Vor der Installation von LiveCycle PDF Generator für PostScript unter Linux müssen Sie sich vergewissern,
dass das bc-Tool auf dem Computer installiert ist. (bc ist eine Sprache für Berechnungen mit beliebiger
Präzision.) Sie können das bc-Tool von GNU unter www.gnu.org/software/bc/bc.html herunterladen.
Adobe LiveCycle
Checklisten für Installation, Konfiguration und Bereitstellung 17
Checklisten für Installation, Konfiguration und Bereitstellung
Dieser Abschnitt enthält Checklisten, mit denen Sie den Installations- und Konfigurationsprozess Schritt
für Schritt durchführen können. Es steht eine Checkliste für die Installation und Konfiguration mit der
Turnkey-Methode oder der manuellen Methode zur Verfügung.
Vergewissern Sie sich vor dem Starten des Installationsprogramms, dass die JAR-Dateien nicht mit WinZip
oder einer anderen Anwendung, sondern nur mit dem Java Application Launcher verknüpft sind.
Checkliste für die Turnkey-Installation und -Bereitstellung
Die folgende Tabelle enthält die Schritte, die für die Installation von LiveCycle-Produkten mit der
Turnkey-Methode erforderlich sind.
Wählen Sie diese Installations- und Konfigurationsmethode, wenn Sie noch keinen Anwendungsserver
installiert und konfiguriert haben und JBoss verwenden möchten oder wenn die Produkte zu Test- und
Vorführzwecken schnell und einfach installiert und konfiguriert werden sollen.
Verwenden Sie die Turnkey-Konfigurationsmethode nicht, wenn Sie planen, SSL zu aktivieren. Wenn Sie
SSL benötigen, führen Sie eine manuelle Konfiguration durch. (Siehe „Konfigurieren von
LiveCycle-Produkten für die Bereitstellung“ auf Seite 51.)
Aufgabe
Siehe
Vergewissern Sie sich, dass die erforderliche Software in
der Zielumgebung installiert ist.
Führen Sie das Installationsprogramm mit aktivierter
Turnkey-Option für JBoss aus. Das Produkt, JBoss und
MySQL werden installiert und konfiguriert.
„Installieren von
LiveCycle-Produkten mit der
Turnkey-Methode“ auf Seite 20
Greifen Sie auf Administrator und User Management zu.
„Zugreifen auf Administrator“ auf
Seite 27
Überprüfen Sie die Protokolldatei.
„Anzeigen von Protokolldateien“ auf
Seite 69
Checkliste für die manuelle Installation und Bereitstellung
Die folgende Tabelle enthält die Schritte, die für die Installation von LiveCycle-Produkten mit der
manuellen Methode erforderlich sind. Der Anwendungsserver muss bereits installiert sein, bevor Sie die
Installation durchführen.
Wählen Sie diese Installationsmethode, wenn Sie das Produkt in einer Produktionsumgebung verwenden.
Hinweis: Stellen Sie bei der Installation mehrerer Produkte sicher, dass alle Produkte installiert sind, bevor
Sie Configuration Manager zum Konfigurieren und Bereitstellen ausführen.
Adobe LiveCycle
Aktualisierte Informationen zu LiveCycle-Produkten 18
Aufgabe
Siehe
Vergewissern Sie sich, dass die erforderliche Software in
der Zielumgebung installiert ist.
Erstellen Sie die Datenbank, die mit User Management
verwendet werden soll. Installieren Sie den
Anwendungsserver und bereiten Sie ihn vor.
„Vorbereiten der Umgebung“ auf
Seite 44
Führen Sie das Installationsprogramm aus.
„Installieren von
LiveCycle-Produkten“ auf Seite 37
Führen Sie Configuration Manager aus und wählen Sie
Assistent für die benutzerdefinierte Konfiguration.
Dadurch werden die Produkte konfiguriert und
assembliert.
„Konfigurieren von
LiveCycle-Produkten für die
Bereitstellung“ auf Seite 51
Konfigurieren Sie die JBoss-Einstellungen. Hierbei
„Manuelles Konfigurieren von JBoss“
müssen verschiedene Einstellungen konfiguriert werden. auf Seite 56
Stellen Sie die Produkt-Bereitstellungsdateien auf dem
Anwendungsserver bereit.
„Manuelles Bereitstellen auf JBoss“
auf Seite 67
Führen Sie Configuration Manager aus, um die
Datenbank zu initialisieren.
„Initialisieren der Datenbank“ auf
Seite 70
Greifen Sie auf Administrator und User Management zu.
„Zugreifen auf Administrator“ auf
Seite 27
Konfigurieren Sie den LDAP-Zugriff.
„Konfigurieren von
LiveCycle-Produkten für den
LDAP-Zugriff“ auf Seite 72
Konfigurieren Sie gegebenenfalls SSL auf dem
Anwendungsserver.
„Konfigurieren von SSL auf JBoss“
auf Seite 77
(LiveCycle Workflow) Erstellen Sie die BAM- MetadatenDatenbank und konfigurieren Sie den Anwendungsserver
für BAM Server.
„Manuelles Konfigurieren von JBoss
für BAM Server“ auf Seite 80
Überprüfen Sie die Protokolldatei.
„Anzeigen von Protokolldateien“ auf
Seite 69
Adobe Systems hat im Knowledge Center einen Artikel veröffentlicht, um Kunden die neuesten
Informationen zu LiveCycle-Produkten mitzuteilen. Sie finden diesen Artikel unter
Teil I: Turnkey-Installation
In diesem Abschnitt des Handbuchs wird die Ausführung einer Turnkey-Installation der
LiveCycle-Produkte beschrieben.
Informationen zur manuellen Konfiguration und Bereitstellung der Produkte finden Sie unter „Manuelle
Installation, Konfiguration und Bereitstellung“ auf Seite 36.
19
2
Installieren von LiveCycle-Produkten mit der
Turnkey-Methode
In diesem Kapitel wird die Installation der LiveCycle-Produkte mit der Turnkey-Methode beschrieben. Bei
der Turnkey-Installation werden automatisch alle Aufgaben durchgeführt, die zum Installieren und
Konfigurieren von LiveCycle-Produkten auf JBoss Application Server unter Windows erforderlich sind.
Bei der Turnkey-Installation werden die folgenden Aufgaben durchgeführt:
O
Installation der Produktdateien
O
Installation einer vorkonfigurierten Version von JBoss 3.2.5 (mit integriertem Apache-Webserver)
O
Installation einer vorkonfigurierten Version von MySQL 4.1
O
(LiveCycle PDF Generator) Installation eines JDK, sofern im Zielsystem noch keines vorhanden ist
O
Start von Configuration Manager
O
Konfiguration und Assemblierung der LiveCycle-Produktkomponenten
O
Bereitstellung aller erforderlichen Komponenten für JBoss
O
Initialisierung von MySQL bei der Installation von LiveCycle-Produkten, für die User Management
erforderlich ist
Durchführen der Turnkey-Installation
Vergewissern Sie sich vor dem Durchführen der Turnkey-Installation, dass die Umgebung, in der Sie
LiveCycle-Produkte installieren und bereitstellen, die Systemanforderungen erfüllt. (Siehe Hinweis unter
„Systemanforderungen“ auf Seite 13.) Hierzu gehört auch die manuelle Installation der erforderlichen
JDK-Version. Während der Turnkey-Installation werden Sie zur Eingabe des JDK-Stammverzeichnisses
aufgefordert. Anschließend werden JBoss und MySQL automatisch installiert.
Bei der Turnkey-Installation werden der Hostname auf localhost, die Anschlussnummer für JBoss auf
8080 und die Anschlussnummer für MySQL auf 3306 eingestellt. Wenn JBoss und MySQL bereits installiert
sind, vergewissern Sie sich, dass sie nicht diese Anschlüsse verwenden. Sie können bei der TurnkeyInstallation und -Konfiguration keinen anderen Hostnamen oder Anschluss für JBoss oder MySQL
konfigurieren.
Standardmäßig werden bei der Turnkey-Installation das LiveCycle-Produkt und alle zugehörigen
Komponenten und Softwareanwendungen im Verzeichnis \Adobe\LiveCycle abgelegt (im Weiteren als
[LiveCycle-Stammverzeichnis] bezeichnet).
Hinweis: Eine erfolgreiche Installation setzt voraus, dass Sie über Lese- und Schreibberechtigungen für
das Installationsverzeichnis verfügen. Bei den folgenden Verzeichnisse handelt es sich um die
standardmäßigen Installationsverzeichnisse. Sie können jedoch bei Bedarf auch andere
Verzeichnisse festlegen:
O
Windows: C:\Adobe\LiveCycle\
O
Linux: /opt/adobe/livecycle/
JBoss und MySQL werden im Verzeichnis [LiveCycle-Stammverzeichnis]/jboss bzw.
[LiveCycle-Stammverzeichnis]/mysql installiert und von dort ausgeführt. Sie können jedoch ein anderes
Verzeichnis angeben, indem Sie den Pfad eingeben oder zum gewünschten Verzeichnis wechseln.
20
Adobe LiveCycle
Installieren von LiveCycle-Produkten mit der Turnkey-Methode
21
Bei der Turnkey-Installation werden die folgenden Windows-Dienste erstellt:
O
JBoss for Adobe LiveCycle
O
MySQL for Adobe LiveCycle
O
(LiveCycle Workflow) JBoss for Adobe LiveCycle Workflow BAM
Diese Dienste werden während der Turnkey-Installation von Configuration Manager verwendet. Sie
können in der Systemsteuerung von Windows im Bereich Verwaltung unter Dienste beendet und
gestartet werden.
Hinweis: Wenn JBoss und MySQL bereits installiert sind, müssen Sie deren Dienste beenden, bevor Sie die
Turnkey-Installation ausführen.
Sie sollten bei der Turnkey-Installation die Standard-Konfigurationsoptionen übernehmen. Wenn Sie es
vorziehen, die Konfigurationsoptionen selbst einzurichten, sollten Sie eine manuelle Installation,
Konfiguration und Bereitstellung durchführen. Informationen zu den Konfigurationsoptionen finden Sie
unter „Konfigurieren von LiveCycle-Produkten für die Bereitstellung“ auf Seite 51.
Tipp: Um die Installation zu beschleunigen, sollten Sie für die Dauer der Installation gegebenenfalls
vorhandene On-Access-Virenschutzprogramme deaktivieren.
Das nachfolgende Verfahren gilt für alle Produkte außer LiveCycle PDF Generator. (Siehe „So führen Sie die
Turnkey-Installation für LiveCycle PDF Generator aus:“ auf Seite 23.)
³ So führen Sie die Turnkey-Installation durch:
1. Doppelklicken Sie auf der Stammebene der Installations-DVD auf die EXE-Datei.
2. Wählen Sie bei der Aufforderung eine Sprache für das Installationsprogramm und klicken Sie auf OK.
3. Klicken Sie im Begrüßungsbildschirm auf Weiter.
4. Klicken Sie im Bildschirm Vor der Installation auf Weiter.
5. Geben Sie die Seriennummer in das Textfeld ein und klicken Sie auf Weiter.
6. Lesen Sie die Produkt-Lizenzvereinbarung, wählen Sie Ich akzeptiere die Bedingungen der
Lizenzvereinbarung und klicken Sie auf Weiter.
Hinweis: Abhängig von dem Produkt, das Sie installieren, werden die nächsten Schritte
möglicherweise in einer anderen Reihenfolge angezeigt.
7. Wählen Sie JBoss, aktivieren Sie Produkt automatisch konfigurieren und bereitstellen und klicken
Sie auf Weiter.
8. Lesen Sie die Lizenzinformationen für die Installation von JBoss, wählen Sie Ich akzeptiere die
Bedingungen der Lizenzvereinbarung und klicken Sie auf Weiter.
9. Lesen Sie die Lizenzinformationen für die Installation von MySQL, wählen Sie Ich akzeptiere die
10. Geben Sie bei Bedarf den Pfad zum JDK ein oder klicken Sie auf Durchsuchen, um zu dessen
Stammverzeichnis zu wechseln. Klicken Sie auf Weiter.
11. Akzeptieren Sie das angegebene Adobe-Standardverzeichnis oder klicken Sie auf Durchsuchen und
wechseln Sie zu dem Verzeichnis, in dem Sie das Produkt installieren möchten. Klicken Sie auf Weiter.
Adobe LiveCycle
22
Hinweis: Wenn Sie den Namen eines nicht vorhandenen Verzeichnisses eingeben, wird dieses
Verzeichnis erstellt.
12. Überprüfen Sie die Installationsdetails und klicken Sie auf Installieren. Im Anschluss an die Installation
wird eine Zusammenfassung angezeigt.
13. In diesem Bildschirm haben Sie die folgenden Möglichkeiten:
O
Wenn Sie nur ein einziges LiveCycle-Produkt installieren oder dies das letzte zu installierende
LiveCycle-Produkt ist, wählen Sie Configuration Manager starten und klicken Sie auf Fertig
stellen. Fahren Sie mit Schritt 14 fort.
O
Wenn Sie noch weitere LiveCycle-Produkte installieren möchten, klicken Sie auf Fertig stellen, um
das Installationsprogramm zu beenden und die Installationsprogramme der übrigen Produkte
auszuführen.
14. Wählen Sie bei der entsprechenden Aufforderung eine Sprache für Configuration Manager und klicken
Sie auf OK.
16. Wählen Sie im Bildschirm Konfigurationsmodus die Option Assistent für die typische
Konfiguration und klicken Sie auf Weiter.
17. Wählen Sie im Bildschirm Konfigurationsvoreinstellungen entweder Zuvor eingegebene Werte
verwenden oder Standardwerte wiederherstellen und klicken Sie auf Weiter.
Hinweis: Dieser Bildschirm wird nur angezeigt, wenn Configuration Manager zuvor bereits ausgeführt
wurde.
18. Wählen Sie bei Bedarf im Bildschirm Produktauswahl die Option JBoss als Typ des verwendeten
Anwendungsservers.
19. Wählen Sie bei Bedarf Plattform und dann die Produkte, die Sie konfigurieren und bereitstellen
möchten, und klicken Sie auf Weiter.
20. (LiveCycle Forms) Wählen Sie im Bildschirm Adobe User Management-Auswahl entweder LiveCycle
Forms mit User Management und Administrator oder LiveCycle Forms ohne User Management
und Administrator. Klicken Sie auf Weiter.
21. Klicken Sie im Bildschirm Produkte konfigurieren und assemblieren auf Weiter.
22. Überprüfen Sie im Bildschirm Anwendungskonfiguration und Assemblierung – Zusammenfassung
die Details und klicken Sie auf Weiter. Configuration Manager konfiguriert unter Verwendung der
Standardwerte die LiveCycle-Produkteigenschaften und assembliert die Produkte in der Datei
LiveCycle.ear.
23. Wenn Konfiguration und Assemblierung abgeschlossen sind, klicken Sie auf Weiter.
24. Klicken Sie im Bildschirm LiveCycle bereitstellen auf Weiter.
25. Klicken Sie im Bildschirm Produkte bereitstellen – Zusammenfassung auf Weiter.
26. Geben Sie in das Feld Basis-URL des Anwendungsservers die URL ein, die Configuration Manager
zum Herstellen einer Verbindung zum Anwendungsserver verwenden kann, und klicken Sie auf
Weiter. Die URL muss das folgende Format aufweisen:
Adobe LiveCycle
23
http://[Hostname]:[Anschluss]
Hierbei kennzeichnet [Hostname] den Namen oder die IP-Adresse des Computers, der als Host für
den Anwendungsserver dient, und [Anschluss] den vom Anwendungsserver verwendeten
HTTP-Dienstanschluss (z. B. http://localhost:8080).
27. Klicken Sie im Bildschirm Datenbank für LiveCycle vorbereiten auf Weiter.
28. Klicken Sie im Bildschirm Bereitstellungsanweisungen auf Weiter.
29. Klicken Sie im Bildschirm Datenbankinitialisierung auf Datenbank jetzt initialisieren, um eine
Verbindung zwischen den LiveCycle-Produkten und der Datenbank herzustellen, und klicken Sie auf
Weiter.
30. Klicken Sie im Bildschirm Datenbankinitialisierung auf Datenbank jetzt initialisieren. Wenn die
Aufgabe abgeschlossen ist, klicken Sie auf Weiter.
31. Klicken Sie im Bildschirm Tasks abgeschlossen auf Fertig stellen.
Das Produkt ist nun auf JBoss bereitgestellt und JBoss wird ausgeführt. Falls JBoss nicht ausgeführt
wird, können Sie den Dienst JBoss for Adobe LiveCycle über den Windows-Dienst starten.
Die JBoss- und MySQL-Dienste werden standardmäßig mit dem Starttyp Manuell installiert. Ändern
Sie dies, indem Sie Start > Verwaltung > Dienste wählen, nach den Diensten suchen und die
Einstellung in Automatisch ändern. Andernfalls müssen Sie die JBoss- und MySQL-Dienste bei einem
Computerneustart manuell starten.
Die JBoss-Protokolldatei (server.log) befindet sich im Verzeichnis [LiveCycle-Stammverzeichnis]/
jboss/server/all/log. Diese Datei enthält Informationen zu Aktivität und Status von JBoss.
³ So führen Sie die Turnkey-Installation für LiveCycle PDF Generator aus:
1. Doppelklicken Sie auf der Stammebene der Installations-DVD auf die EXE-Datei.
5. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Überprüfen Sie die
Informationen zu den Installationsvoraussetzungen für Adobe LiveCycle PDF Generator 7.2 und klicken
Sie auf Weiter.
6. Wenn Sie zur Deaktivierung der On-Access-Virenscanner-Software aufgefordert werden, klicken Sie auf
Weiter. Sie sollten Virenscanner-Software während der Installation deaktivieren, um den Vorgang zu
beschleunigen.
8. Akzeptieren Sie das angegebene Adobe-Standardverzeichnis oder klicken Sie auf Durchsuchen und
wechseln Sie zu dem Verzeichnis, in dem Sie das Produkt installieren möchten. Klicken Sie auf Weiter.
Adobe LiveCycle
24
Hinweis: Wenn Sie mehrere LiveCycle-Produkte installieren, müssen alle Produkte im selben
Verzeichnis [LiveCycle-Stammverzeichnis] installiert werden.
9. Wählen Sie JBoss, aktivieren Sie Produkt automatisch konfigurieren und bereitstellen und klicken
Sie auf Weiter.
10. Geben Sie bei Bedarf den Pfad zum JDK ein oder klicken Sie auf Durchsuchen, um zu dessen
Stammverzeichnis zu wechseln. Klicken Sie auf Weiter.
11. Lesen Sie die Lizenzinformationen für die Installation von JBoss, wählen Sie Ich akzeptiere die
12. Lesen Sie die Lizenzinformationen für die Installation von MySQL, wählen Sie Ich akzeptiere die
13. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Geben Sie den Benutzernaen
und das Kennwort des Administrators von Microsoft Office ein (sofern installiert) und klicken Sie auf
Weiter.
14. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Wenn Corel WordPerfect
installiert ist, wechseln Sie im Bildschirm für Corel WordPerfect zum Speicherort der ausführbaren Datei
von Corel WordPerfect und klicken Sie auf Weiter. Wenn Corel WordPerfect nicht installiert ist, klicken
Sie sofort auf Weiter.
15. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Wenn Adobe Photoshop
installiert ist, wechseln Sie im Bildschirm für Adobe Photoshop zum Speicherort der ausführbaren Datei
von Adobe Photoshop (sofern nicht im Standardverzeichnis installiert) und klicken Sie auf Weiter.
Wenn Adobe Photoshop nicht installiert ist, klicken Sie sofort auf Weiter.
17. In diesem Bildschirm haben Sie die folgenden Möglichkeiten:
O
Wenn Sie nur ein einziges LiveCycle-Produkt installieren oder dies das letzte zu installierende
LiveCycle-Produkt ist, wählen Sie Configuration Manager starten und klicken Sie auf Fertig
stellen. Fahren Sie mit Schritt 18 fort.
O
Wenn Sie noch weitere LiveCycle-Produkte installieren möchten, klicken Sie auf Fertig stellen, um
das Installationsprogramm zu beenden und die Installationsprogramme der übrigen Produkte
auszuführen.
Sie auf OK.
20. Wählen Sie Assistent für die typische Konfiguration und klicken Sie auf Weiter.
21. Wählen Sie im Bildschirm Konfigurationsvoreinstellungen entweder Zuletzt eingegebene Werte
Hinweis: Dieser Bildschirm wird nur angezeigt, wenn Configuration Manager zuvor bereits ausgeführt
wurde.
22. Wählen Sie bei Bedarf JBoss als Typ des verwendeten Anwendungsservers.
Adobe LiveCycle
Ändern der LiveCycle-Dienste
25
23. Wählen Sie Plattform sowie die Produkte, die Sie konfigurieren und bereitstellen möchten, und klicken
Sie auf Weiter.
24. Klicken Sie im Bildschirm Produkte konfigurieren und assemblieren – Zusammenfassung auf Weiter.
25. Überprüfen Sie die Zusammenfassung der Konfigurationsdetails und klicken Sie auf Weiter.
Configuration Manager konfiguriert die LiveCycle-Produkteigenschaften anhand der Standardwerte
und assembliert die Produkte in der Datei LiveCycle.ear sowie der zusätzlichen Datei pdfg-all.ear oder
pdfg-ps-all.ear.
27. Geben Sie in das Feld Basis-URL des Anwendungsservers die URL ein, die Configuration Manager
zum Herstellen einer Verbindung zum Anwendungsserver verwenden kann. Die URL muss das
folgende Format aufweisen:
http://[Hostname]:[Anschluss]
Hierbei kennzeichnet [Hostname] den Namen oder die IP-Adresse des Computers, der als Host für
den Anwendungsserver dient, und [Anschluss] den vom Anwendungsserver verwendeten
HTTP-Dienstanschluss (z. B. http://localhost:8080).
28. Klicken Sie im Bildschirm Produkte bereitstellen auf Weiter.
29. Klicken Sie im Bildschirm Bereitstellungsanweisungen auf Weiter.
30. Klicken Sie im Bildschirm Datenbankinitialisierung auf Datenbank jetzt initialisieren, um eine
Verbindung zwischen den LiveCycle-Produkten und der Datenbank herzustellen, und klicken Sie auf
Weiter.
Das Produkt ist nun auf JBoss bereitgestellt und JBoss wird ausgeführt. Falls JBoss nicht ausgeführt
wird, können Sie den Dienst JBoss for Adobe LiveCycle über den Windows-Dienst starten.
Die JBoss-Protokolldatei (server.log) befindet sich im Verzeichnis [LiveCycle-Stammverzeichnis]/
jboss/server/all/log. Diese Datei enthält Informationen zu Aktivität und Status von JBoss.
Standardmäßig werden bei der Turnkey-Installation die Dienste JBoss for Adobe LiveCycle sowie MySQL
for Adobe LiveCycle so konfiguriert, dass ein manueller Start erforderlich ist. Wenn Sie die Dienste für
einen automatischen Start konfigurieren möchten, führen Sie das nachfolgend beschriebene Verfahren
durch.
³ So ändern Sie LiveCycle-Dienste:
1. Wählen Sie Start > Alle Programme > Verwaltung > Dienste.
2. Klicken Sie mit der rechten Maustaste auf den Dienst JBoss for Adobe LiveCycle und klicken Sie auf
Eigenschaften.
3. Wählen Sie im Menü Starttyp die Option Automatisch und klicken Sie auf OK.
4. Klicken Sie mit der rechten Maustaste auf den Dienst MySQL for Adobe LiveCycle und klicken Sie auf
Eigenschaften.
Adobe LiveCycle
26
6. (LiveCycle Workflow Business Activity Monitor) Klicken Sie mit der rechten Maustaste auf JBoss for
Adobe LiveCycle Workflow BAM und klicken Sie auf Eigenschaften.
Nächster Schritt
Für LiveCycle Forms und LiveCycle Assembler können Sie jetzt eine Beispielanwendung bereitstellen, um
die Installation und Bereitstellung zu testen. (Siehe „Überprüfen der Bereitstellung von LiveCycle Forms“
auf Seite 29 und „Überprüfen der Bereitstellung von LiveCycle Assembler“ auf Seite 28.)
Darüber hinaus haben Sie jetzt Zugriff auf Administrator und User Management und können mit der
Entwicklung von Anwendungen für das LiveCycle-Produkt beginnen. (Siehe „Aufgaben nach der
Bereitstellung“ auf Seite 27 und die Entwicklerhandbücher für die installierten Produkte.)
3
Aufgaben nach der Bereitstellung
In diesem Kapitel werden die ersten Arbeitsschritte nach der Installation, Konfiguration und Bereitstellung
der LiveCycle-Produkte auf dem Anwendungsserver beschrieben:
O
„Zugreifen auf Administrator“ auf Seite 27
O
„Zugreifen auf User Management“ auf Seite 28
O
„Aufgaben nach der Bereitstellung von LiveCycle Assembler“ auf Seite 28
O
„Aufgaben nach der Bereitstellung von LiveCycle Forms“ auf Seite 29
O
„Aufgaben nach der Bereitstellung von LiveCycle Print“ auf Seite 29
O
„Aufgaben nach der Bereitstellung von LiveCycle Form Manager“ auf Seite 32
O
„Aufgaben nach der Bereitstellung von LiveCycle PDF Generator“ auf Seite 33
Zugreifen auf Administrator
Bei Administrator handelt es sich um ein webbasiertes Portal, über das Sie auf zahlreiche Konfigurationsseiten
zugreifen können. Auf den Konfigurationsseiten können Sie Laufzeiteigenschaften festlegen, die die
Funktionsweise von LiveCycle-Produkten steuern. Wenn Sie sich bei Administrator anmelden, erhalten Sie
Zugriff auf User Management, Adobe JMX Monitor, die Watched Folder-Konfiguration (mit Watched Folder
installiert), Process Manager- und Servereinstellungen (mit LiveCycle Workflow installiert) sowie auf
verwaltungstechnische Konfigurationsoptionen für andere LiveCycle-Produkte.
Der standardmäßige Benutzername für die Anmeldung bei Administrator lautet administrator und das
Standardkennwort password. Nach der ersten Anmeldung können Sie das Standardkennwort mithilfe von
User Management ändern.
Bevor Sie auf Administrator zugreifen, müssen die LiveCycle-Produkte auf dem Anwendungsserver
bereitgestellt und ausgeführt werden.
Informationen zum Verwenden von Administrator finden Sie in der Adobe Administrator-Hilfe, die über das
Hilfe-Menü des Fensters von Administrator aufgerufen werden kann.
³ So greifen Sie auf Administrator zu:
1. Geben Sie in einem Webbrowser die folgende URL ein:
http://[Hostname]:[Anschluss]/adminui
Der Standardanschluss für JBoss ist 8080.
2. Geben Sie in das Feld für den Benutzernamen administrator und in das Feld für das Kennwort
password ein.
3. Nachdem Sie sich angemeldet haben, können Sie auf Dienste klicken, um die Administrator-Seiten für
das LiveCycle-Produkt aufzurufen, oder auf Einstellungen, um die User Management-Seiten
anzuzeigen
27
Adobe LiveCycle
Zugreifen auf User Management
28
Zugreifen auf User Management
Mit User Management können Administratoren eine Datenbank für alle Benutzer und Gruppen verwalten,
die mit einem oder mehreren Benutzerverzeichnissen von Drittanbietern synchronisiert sind. Die
Anwendung ermöglicht die Authentifizierung, Autorisierung und Benutzerverwaltung für LiveCycleProdukte wie LiveCycle PDF Generator, LiveCycle Assembler, LiveCycle Form Manager, LiveCycle Forms
und LiveCycle Workflow.
Mit User Management können Sie zwischen LiveCycle-Produkten und Anwendungen, die durch
Netegrity SiteMinder geschützt sind, mithilfe von SAML (Security Assertion Markup Language) die
SSO-Funktionalität (Single Sign-On) aktivieren. Wenn SSO implementiert ist, sind die LiveCycleAnmeldeseiten nicht erforderlich und werden nicht angezeigt, wenn der Benutzer bereits über sein
Firmenportal authentifiziert wurde.
Informationen zum Verwenden von User Management finden Sie in der Adobe User
Management-Administrator-Hilfe, die über das Hilfe-Menü des Fensters von User Management aufgerufen
werden kann.
³ So greifen Sie auf User Management zu:
1. Klicken Sie auf der Homepage von Administrator auf Einstellungen.
2. 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.
³ (LiveCycle Forms) So greifen Sie ohne User Management auf Administrator zu:
O
Geben Sie in einem Webbrowser die folgende URL ein:
http://[Hostname]:[Anschluss]/FormServerAdmin/settings.html
Aufgaben nach der Bereitstellung von LiveCycle Assembler
In diesem Abschnitt werden die Aufgaben beschrieben, die nach der Bereitstellung speziell für LiveCycle
Assembler durchgeführt werden müssen.
Überprüfen der Bereitstellung von LiveCycle Assembler
Sie können überprüfen, ob LiveCycle Assembler bereitgestellt ist und ordnungsgemäß ausgeführt wird,
indem Sie das mitgelieferte Beispiel bereitstellen. (Siehe Samples Guide for LiveCycle Assembler im
Verzeichnis [LiveCycle-Stammverzeichnis]/Assembler/samples/docs.)
³ So stellen Sie das LiveCycle Assembler-Beispiel bereit:
1. Wechseln Sie zum Verzeichnis [LiveCycle-Stammverzeichnis]/Assembler/samples/build/prebuilt.
2. Stellen Sie die Datei jboss.sample-assembler7.ear bereit, indem Sie sie in das Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/deploy kopieren.
http://localhost:8080/adobe/livecycle/samples/assembler7/
Adobe LiveCycle
Aufgaben nach der Bereitstellung von LiveCycle Forms
29
4. Klicken Sie auf die Option zur Anzeige von Informationen über Assembler und vergewissern Sie sich,
dass die LiveCycle Assembler-Daten an das Ergebnisfenster zurückgegeben werden.
Sie können jetzt Anwendungen für LiveCycle Assembler erstellen. (Siehe Handbuch Developing
Applications for LiveCycle Assembler.)
Aufgaben nach der Bereitstellung von LiveCycle Forms
Forms durchgeführt werden müssen.
Sie können jetzt benutzerdefinierte Anwendungen für LiveCycle Forms erstellen. (Siehe Handbuch
Developing Custom Applications.) Einzelheiten zum Form Server-Modul finden Sie in der Form Server
Module API Reference. Einzelheiten zur API des XML Form-Moduls finden Sie in der XML Form Module API
Reference.
Sie können optional LiveCycle Print installieren, um mit LiveCycle Forms zusätzlich zu PDF- und
HTML-Formularen auch Formulare als Adobe PostScript-, PCL- (Printer Control Language) und
ZPL-Druckdatenströme (Zebra Programming Language) auszugeben. Ohne LiveCycle Print wiederum
können Formulare in LiveCycle Forms nicht als Druckdatenströme ausgegeben werden. Stattdessen
sendet LiveCycle Forms Formulare über ein Netzwerk und gibt sie in Clientanwendungen wie
Webbrowsern als PDF- oder HTML-Formulare wieder.
Überprüfen der Bereitstellung von LiveCycle Forms
Mit der im Lieferumfang des Produkts enthaltenen Anwendung Installation Verification Sample können
Sie überprüfen, ob LiveCycle Forms bereitgestellt ist und ordnungsgemäß ausgeführt wird.
³ So greifen Sie auf die Anwendung Installation Verification Sample zu:
1. Kopieren Sie die Datei FormsIVS.ear aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/components/forms/samples/common/ in das Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/deploy.
2. Starten Sie den Anwendungsserver neu.
http://[Hostname]:[Anschluss]/FormsIVS
Hierbei kennzeichnet [Hostname] den Namen des Servers, auf dem Forms bereitgestellt wurde. Wenn
Sie FormsIVS auf dem Server selbst aufrufen, geben Sie anstelle von localhost den Servernamen ein.
Hinweis: Wenn Sie Informationen zur Verwendung der Sample-Anwendung benötigen, klicken Sie auf
der Samples-Seite im Webbrowser auf den Hilfe-Link.
Aufgaben nach der Bereitstellung von LiveCycle Print
Print durchgeführt werden müssen.
Adobe LiveCycle
Überprüfen der Bereitstellung
30
Überprüfen der Bereitstellung
Sie können folgendermaßen überprüfen, ob LiveCycle Print bereitgestellt ist und ordnungsgemäß
ausgeführt wird:
O
Stellen Sie die Webanwendung Print Installation and Verification Sample (PrintIVS) bereit und führen
Sie sie aus.
O
Führen Sie die Print Submitter-Konsolenanwendung aus. (Sie müssen diese Anwendung nicht
bereitstellen.)
Beide Anwendungen rufen LiveCycle Print über die LiveCycle Print-API auf (diese API nimmt den
LiveCycle Print-Webdienst in Anspruch).
O
Führen Sie die Anwendung Forms Installation and Verification Sample (FormsIVS) aus. Wenn LiveCycle
Print bereitgestellt ist, enthält die Ausgabeformatliste zusätzlich die Optionen PostScript, ZPL und
PCL. Informationen zur Anwendung Installation Verification Sample finden Sie unter „Überprüfen der
Bereitstellung von LiveCycle Forms“ auf Seite 29.
LiveCycle Print kann nicht nur durch Ausführen der beiden Beispieldruckanwendungen aufgerufen werden,
sondern auch mit der Print-Anwendung der Form Server-Modul-API. Diese Print-Beispielanwendung ist eine
Konsolenanwendung, über die LiveCycle Print mithilfe der Form Server-Modul-API aufgerufen wird.
(Siehe „Ausführen der Print-Anwendung der Form Server-Modul-API“ auf Seite 31.)
Bereitstellen und Ausführen der PrintIVS-Webanwendung
Die PrintIVS-Webanwendung ist in der Datei adobe-printSubmitter.ear gepackt, die sich nach dem
Ausführen von Configuration Manager im Verzeichnis [LiveCycle-Stammverzeichnis]/ components/print/
common/ear sowie im Verzeichnis [LiveCycle-Stammverzeichnis]/configurationManager/export befindet.
Die Ausführung dieser Anwendung setzt die Kenntnis der Druckspezifikation voraus, da die Anwendung
die gleichen Werte wie die Druckspezifikation erfordert. (Siehe „Druckspezifikation“ im Handbuch Erste
Schritte für LiveCycle Print.)
³ So stellen Sie die PrintIVS-Webanwendung bereit und führen sie aus:
1. Kopieren Sie die Datei adobe-printSubmitter.ear aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/components/print/samples/common/printsubmitter in das Verzeichnis
2. Geben Sie zum Ausführen der Beispielanwendung in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/PrintIVS ein.
3. Geben Sie die erforderlichen Werte ein und klicken Sie auf die Option zum Drucken.
Ausführen der Print Submitter-Anwendung
Die Print Submitter-Anwendung besteht aus der Datei lcprint.bat (Windows) bzw. lcprint.sh (Linux), die
sich im Verzeichnis [LiveCycle-Stammverzeichnis]/components/print/samples/common/lcprint befindet.
Sie können die Print Submitter-Anwendung an einer Eingabeaufforderung ausführen, um LiveCycle Print
aufzurufen.
Adobe LiveCycle
Ausführen der Print-Anwendung der Form Server-Modul-API
31
³ So führen Sie die Print Submitter-Anwendung aus:
1. Wechseln Sie an einer Eingabeaufforderung zum Verzeichnis
[LiveCycle-Stammverzeichnis]/components/print/samples/common/lcprint.
Wenn für die Installation nicht das Standardverzeichnis verwendet wurde, erstellen Sie eine neue
Umgebungsvariable mit dem Namen LiveCycleRoot und geben Sie als Wert das auf Ihrem System
verwendete Installationsverzeichnis an.
2. Geben Sie den folgenden Befehl ein:
lcprint <-d,--dataFile filename> <-f,--specFile filename> <-s,--server
server:port>
Das erste Argument ist ein voll qualifizierter Pfad zur Datendatei und ist optional. Im Lieferumfang
von LiveCycle Print sind eine Reihe von Datendateien enthalten. Diese sind im Verzeichnis
[LiveCycle-Stammverzeichnis]/components/print/samples/common/lcprint/data gespeichert.
Die meisten dieser Dateien enthalten mehrere Datensätze. Die Datei PurchaseOrder_batch_25.xml
enthält z. B. 25 Datensätze. Mithilfe einer Datendatei, die mehrere Datensätze enthält, können Sie
mehrere Druckdatenströme erstellen. (Siehe „Arbeiten mit mehreren Datensätzen“ im Handbuch Erste
Das zweite Argument ist ein voll qualifizierter Pfad zur Druckspezifikation, die an LiveCycle Print
gesendet wird. Sie können die Datei PrintSpecTemplate.xml ergänzen und diese Datei verwenden. Die
Datei PrintSpecTemplate.xml ist im selben Verzeichnis wie die Datei lcprint.bat gespeichert. (Siehe
„Druckspezifikation“ im Handbuch Erste Schritte für LiveCycle Print.)
Ein Wert, der in der Druckspezifikation angegeben werden muss, ist der Speicherort des
Formularentwurfs, auf dem ein Druckdatenstrom beruht. Beispielformularentwürfe befinden sich im
Verzeichnis [LiveCycle-Stammverzeichnis]/components/print/samples/common/lcprint/forms.
Das dritte Argument gibt den Servernamen und den Anschluss an und ist erforderlich.
Darüber hinaus können Sie mit der Print Submitter-Konsolenanwendung Informationen zu einer
früheren Anforderung abrufen. Verwenden Sie zum Ausführen dieser Aufgabe den folgenden Befehl:
lcprint <-r,--result requestId>
Hierbei kennzeichnet requestId einen Zeichenfolgenwert wie 59572cd82, der eine
Anforderungskennung angibt. Dieser Befehl gibt Ergebnisdaten zurück, die den Status einer
Anforderung angeben. (Siehe „Ergebnisdaten“ im Handbuch Erste Schritte für LiveCycle Print.)
Ausführen der Print-Anwendung der Form Server-Modul-API
Die Print-Anwendung der Form Server-Modul-API ruft LiveCycle Print an einer Eingabeaufforderung über
die Form Server-Modul-API auf. (Siehe „Arbeiten mit der Form Server-Modul-API“ im Handbuch Erste
Die Print-Anwendung der Form Server-Modul-API besteht aus einer Java-Datei namens FsPrint.java, die
sich im Verzeichnis [LiveCycle-Stammverzeichnis]/components/print/samples/common/fsprint befindet.
Wenn Sie mit Windows arbeiten, müssen Sie die in diesem Verzeichnis abgelegte Datei fsprint.bat
ausführen. Wenn Sie mit Linux arbeiten, müssen Sie die Datei fsprint.sh ausführen.
Hinweis: Die Print-Anwendung der Form Server-Modul-API erstellt ein SOAPClient-Objekt, das einen
gültigen SOAP-Endpunkt festlegt. Der standardmäßige SOAP-Endpunkt in der Datei FsPrint.java
ist für den standardmäßigen SOAP-Endpunkt von JBoss konfiguriert. Wenn LiveCycle Forms auf
einem anderen J2EE-Anwendungsserver bereitgestellt wird, müssen Sie die Datei FsPrint.java
bearbeiten und dabei für den jeweiligen SOAP-Endpunkt Kommentarzeichen hinzufügen bzw.
Adobe LiveCycle
Aufgaben nach der Bereitstellung von LiveCycle Form Manager
32
entfernen. Weitere Informationen zum Verwenden eines SOAPClient-Objekts finden Sie im
Handbuch Entwickeln benutzerdefinierter Anwendungen für LiveCycle Forms.
³ So führen Sie die Print-Anwendung der Form Server-Modul-API aus:
[LiveCycle-Stammverzeichnis]/components/print/samples/common/fsprint.
Wenn für die Installation nicht das Standardverzeichnis verwendet wurde, erstellen Sie eine neue
Umgebungsvariable mit dem Namen LiveCycleRoot und geben Sie als Wert das auf Ihrem System
verwendete Installationsverzeichnis an.
fsprint <-argument 1> <-argument2>
Das erste Argument ist ein voll qualifizierter Pfad zum Formularentwurf (eine XDP-Datei). Sie können
einen Beispielformularentwurf aus dem Verzeichnis [LiveCycle-Stammverzeichnis]/components/print/
samples/common/lcprint/forms verwenden.
Das zweite Argument ist optional und definiert das Ziel des Druckdatenstroms. Sie können z. B. einen
Datei-URI zu einer PostScript-Datei definieren. Wenn dieser Wert nicht angegeben ist, wird die Ausgabe
in die Standardausgabedatei geschrieben. Dieser Wert ist mit dem PrintURI-Element vergleichbar,
das in der Druckspezifikation enthalten ist. (Siehe „Druckspezifikation“ im Handbuch Erste Schritte für
LiveCycle Print.)
Tipp: Der Quellcode für die Print-Anwendung der Form Server-Modul-API ist in der Datei FsPrint.java
enthalten. Wenn Sie diese Datei öffnen, können Sie sich die Anwendungslogik ansehen, die
LiveCycle Print über die Form Server-Modul-API aufruft.
Aufgaben nach der Bereitstellung von LiveCycle Form Manager
Form Manager durchgeführt werden müssen.
Zugreifen auf die Endbenutzerseiten für LiveCycle Form Manager
Nachdem Sie User Management zum Herstellen einer Verbindung zum LDAP-Server Ihrer Organisation
konfiguriert haben, können Benutzer über die folgende URL auf Endbenutzerseiten für LiveCycle Form
Manager zugreifen:
http://[Hostname]:[Anschluss]/fm
Zugriff auf die Endbenutzerseiten ist außerdem über die standardmäßigen Angaben für Benutzername
(Administrator) und Kennwort (password) möglich.
Informationen zum Verwenden der Endbenutzerseiten für LiveCycle Form Manager finden Sie in der
LiveCycle Form Manager-Hilfe, die über das Hilfe-Menü im Fenster von LiveCycle Form Manager aufgerufen
werden kann.
Adobe LiveCycle
Aufgaben nach der Bereitstellung von LiveCycle PDF Generator
33
Aufgaben nach der Bereitstellung von LiveCycle PDF Generator
PDF Generator durchgeführt werden müssen.
Einrichten von Auftragsquellen
LiveCycle PDF Generator kann so konfiguriert werden, dass Aufträge aus überwachten Ordnern sowie per
E-Mail oder über die Webbenutzeroberfläche (Beispielcode) übertragene Aufträge angenommen werden
können. (Siehe LiveCycle PDF Generator Administrator-Hilfe.)
LiveCycle PDF Generator kann außerdem Aufträge annehmen, die über die Webdienste-Schnittstelle von
LiveCycle PDF Generator übermittelt werden. Um diese Funktion zu aktivieren, müssen Sie die mit
LiveCycle PDF Generator als Beispiel installierte Webdienst-Clientanwendung auf Entwicklungsebene
ändern. Danach kann die Anwendung für die Auftragsübertragung verwendet werden. Weitere
Informationen zum Konfigurieren dieser Auftragsquellen finden Sie im Handbuch Developing Custom
Applications für LiveCycle PDF Generator.
Einrichten von Adobe PDF Printer als Standarddrucker
Dieser Abschnitt findet nur auf LiveCycle PDF Generator Professional und Elements Anwendung.
Sie müssen Adobe PDF Printer auf dem Server als Standarddrucker einrichten.
³ So richten Sie Adobe PDF Printer als Standarddrucker ein:
1. Wechseln Sie im Betriebssystem zum Druckerfenster.
2. Richten Sie Adobe PDF als Standarddrucker ein.
Installieren von Schriften
Sie können die Schriften installieren, die in den von LiveCycle PDF Generator konvertierten Dokumenten
verwendet werden. Schriften können von PostScript- oder EPS-Dokumenten referenziert werden. Zudem
ist die Referenzierung durch native Dateiformate möglich, z. B. aus Microsoft Word oder Microsoft Excel.
Wenn Sie zusätzliche Schriften für eine Anwendung verfügbar machen möchten, installieren Sie die
Schriften mit einem der folgenden Verfahren:
O
O
Installieren Sie die Schriften im dafür vorgesehenen Ordner:
O
(Windows) C:\Windows\Fonts
O
(Linux) /usr/X11R6/lib/X11/fonts
Wechseln Sie mit Configuration Manager über den Bildschirm Konfiguration des Font ManagerModuls zum Schriftartenverzeichnis und stellen Sie das Font Manager- Modul erneut bereit.
Informationen zum Bereitstellen des Font Manager- Moduls finden Sie unter „Konfigurieren von
LiveCycle-Produkten für die Bereitstellung“ auf Seite 51.
Eine Liste der mit dem Font Manager- Modul installierten Schriften finden Sie unter „Mit dem Font
Manager-Modul installierte Schriften“ auf Seite 107.
Hinweis: Schriften im Font Manager- Modul stehen den nativen Anwendungen, mit denen LiveCycle PDF
Generator native Dateiformate konvertiert, nicht zur Verfügung. Zu diesen nativen
Adobe LiveCycle
Einstellen des Konvertierungstimeouts in LiveCycle PDF Generator
34
Anwendungen gehören auch Microsoft Word und Acrobat. Damit eine Schrift für native
Anwendungen verfügbar ist, müssen Sie sie im Schriftordner des Systems installieren. Wenn
LiveCycle PDF Generator in einem Servercluster verwendet wird, muss die Schrift auf allen
Computern installiert werden, die als Host für die nativen Anwendungen dienen.
Auflösen von Schriftreferenzen
Dieser Abschnitt findet nur auf LiveCycle PDF Generator Elements und LiveCycle PDF Generator
Professional Anwendung.
Bei Schriftreferenzen in einer nativen Datei setzen LiveCycle PDF Generator Elements und LiveCycle PDF
Generator Professional die native Anwendung mit Adobe PDF Printer ein, um ein natives Dateiformat in
PDF zu konvertieren. Die native Anwendung löst Schriftreferenzen über das Verzeichnis C:\Windows\Fonts
auf.
Bei Schriftreferenzen in einem PDF-Dokument versuchen die Produkte, die Schriftreferenzen in der
genannten Reihenfolge über die folgenden Quellen aufzulösen:
O
Im PDF-Dokument eingebettete Schriften
O
Font Manager- Modul
O
C:\WINDOWS\Fonts
Die Einstellungen für das Konvertierungstimeout in LiveCycle PDF Generator können auf Ebene des
Anwendungsservers oder der Auftragsquelle konfiguriert werden. Wird die Timeout-Einstellung auf
mehreren Ebenen konfiguriert, wird die unterste Ebene angewendet.
Einzelheiten zum Konfigurieren der Einstellung auf Ebene des Anwendungsservers finden Sie unter
„Manuelles Konfigurieren von JBoss“ auf Seite 56.
³ So stellen Sie die Einstellungen für das Konvertierungstimeout auf der Ebene der Auftragsquelle
ein:
O
Wählen Sie in Administrator die Option PDF erstellen und geben Sie in das Feld Timeout festlegen
einen Wert in Sekunden ein. Standardmäßig wird dieser Wert der Datei server.aes.properties
entnommen.
³ So legen Sie die Einstellungen für das Konvertierungstimeout für überwachte Ordner und
E-Mail-Quellen fest:
1. Wählen Sie in Administrator den Befehl Dienste > Adobe LiveCycle PDF Generator >
Konfigurationsdateien > Konfiguration exportieren.
2. Wählen Sie Gesamte Konfiguration herunterladen und klicken Sie auf Herunterladen.
Standardmäßig wird dieser Wert der Datei server.aes.properties entnommen.
3. Bearbeiten Sie die Datei native2pdfconfig.xml in einem Texteditor und legen Sie die Ebene für
<timeout> fest.
4. Laden Sie die Änderungen hoch, indem Sie Konfiguration importieren wählen, zum Speicherort der
Datei native2pdfconfig.xml wechseln und auf Importieren klicken.
Hinweis: Die Timeout-Ebene für Webdienste-APIs wird der Datei server.aes.properties entnommen.
Adobe LiveCycle
35
Nächster Schritt
Wenn Sie LiveCycle Workflow manuell installiert und konfiguriert haben, müssen Sie jetzt den
JBoss-Anwendungsserver für BAM Server konfigurieren. (Siehe „Manuelles Konfigurieren von JBoss für
BAM Server“ auf Seite 80.)
Wenn Sie LiveCycle Workflow mit der Turnkey-Methode installiert und konfiguriert haben, können Sie mit
den Anleitungen zum Konfigurieren von BAM Server fortfahren. (Siehe „Erste Schritte mit BAM Server“ auf
Seite 93.)
Teil II: Manuelle Installation, Konfiguration und
Bereitstellung
In diesem Abschnitt des Handbuchs wird die manuelle Installation, Konfiguration und Bereitstellung der
LiveCycle-Produkte beschrieben.
Informationen zur automatischen Installation, Konfiguration und Bereitstellung der Produkte finden Sie
unter „Installieren von LiveCycle-Produkten mit der Turnkey-Methode“ auf Seite 20.
36
4
Installieren von LiveCycle-Produkten
In diesem Kapitel wird die Verwendung des Installationsprogramms zur Installation von LiveCycleProdukten auf einem Windows- oder Linux-System beschrieben.
Informationen zum Installieren von LiveCycle PDF Generator (alle Versionen) finden Sie unter Installieren
von LiveCycle PDF Generator.
Hinweis: Wenn Sie mehrere LiveCycle-Produkte installieren, sollten Sie zuerst die Installation von
LiveCycle PDF Generator durchführen. Wenn Sie LiveCycle PDF Generator nach anderen
LiveCycle-Produkten installieren, müssen Sie wie unter „So installieren Sie LiveCycle PDF
Generator nach anderen LiveCycle-Produkten:“ auf Seite 38 beschrieben vorgehen.
Informationen zum Installieren eines der folgenden LiveCycle-Produkte finden Sie unter „Installieren von
LiveCycle-Produkten“ auf Seite 40:
O
LiveCycle Assembler
O
LiveCycle Forms
O
LiveCycle Form Manager
O
LiveCycle Workflow
Informationen zum Installieren von LiveCycle Print (zur Verwendung mit LiveCycle Forms) finden Sie unter
„Installieren von LiveCycle Print“ auf Seite 42.
Hinweis: LiveCycle Forms muss vor LiveCycle Print installiert werden.
Informationen zum Installieren von Watched Folder (zur Verwendung mit LiveCycle Workflow und
LiveCycle Assembler) finden Sie unter „Installieren von Watched Folder“ auf Seite 43.
Vor der Installation der Produkte müssen Sie sicherstellen, dass die Umgebung über die zum Ausführen
von LiveCycle-Produkten erforderliche Software und Hardware verfügt. Außerdem sollten Sie mit den
Installationsoptionen vertraut sein und die Umgebung entsprechend vorbereitet haben. (Siehe
„Vorbereiten der Installation“ auf Seite 11.)
Wenn Sie als Installationsziel einen Speicherort wählen, an dem bereits ein LiveCycle-Produkt installiert ist,
installieren Sie zunächst das neue Produkt, führen Sie Configuration Manager zur erneuten Assemblierung
der Produkte aus und heben Sie dann die Bereitstellung der anderen Produkte auf dem Anwendungsserver
auf. Stellen Sie anschließend alle Dateien erneut auf dem Anwendungsserver bereit.
Installieren von LiveCycle PDF Generator
Das in diesem Abschnitt beschriebene Verfahren findet auf LiveCycle PDF Generator Professional,
LiveCycle PDF Generator Elements und LiveCycle PDF Generator für PostScript Anwendung.
Für die Ausführung des Installationsprogramms benötigen Sie die folgenden Informationen:
O
Seriennummer des zu installierenden Produkts
O
Art der durchzuführenden Installation und Konfiguration (siehe „Methoden für die Installation,
Konfiguration und Bereitstellung von LiveCycle-Produkten“ auf Seite 12)
37
Adobe LiveCycle
38
O
O
Sie müssen den JBoss-Dienst so konfigurieren, dass er mit den Anmeldedaten des Administrators von
Microsoft Office ausgeführt wird. Sie können die Anmeldeeigenschaften für den JBoss-Dienst in der
Windows-Systemsteuerung im Bereich Verwaltung unter Dienste konfigurieren.
Wenn Sie LiveCycle PDF Generator Professional oder LiveCycle PDF Generator Elements installieren, stellen
Sie sicher, dass Acrobat nicht auf dem Computer installiert ist.
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 Meldungen ähnlich der folgenden 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.
Tipp: Um die Installation zu beschleunigen, sollten Sie für die Dauer der Installation gegebenenfalls
vorhandene On-Access-Virenschutzprogramme deaktivieren.
³ So installieren Sie LiveCycle PDF Generator nach anderen LiveCycle-Produkten:
Wenn Sie bereits andere LiveCycle-Produkte installiert haben, müssen Sie vor dem Installieren von
LiveCycle PDF Generator die folgenden Schritte ausführen.
1. Wählen Sie im Fenster für die Windows-Dienste die Option JBoss for Adobe LiveCycle.
2. Beenden Sie den Dienst, falls er gegenwärtig ausgeführt wird.
3. Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie Eigenschaften.
4. Klicken Sie auf die Registerkarte Anmelden.
5. Wählen Sie Dieses Konto.
6. Geben Sie den Benutzernamen und das Kennwort ein, die beim Installieren der Microsoft Office- und
Adobe Acrobat-Anwendungen verwendet wurden.
7. Starten Sie den Dienst JBoss for Adobe LiveCycle.
³ So installieren Sie LiveCycle PDF Generator für die manuelle Bereitstellung:
1. Starten Sie das Installationsprogramm auf der Stammebene des Installationsmediums:
O
(Windows) Doppelklicken Sie auf die EXE-Datei.
O
(Linux) Geben Sie an einer Eingabeaufforderung file_name.bin ein.
Hinweis: Eventuell müssen Sie unter Linux die für das Installationsprogramm geltenden Rechte
ändern. Geben Sie hierzu chmod +x filename.bin ein.
Adobe LiveCycle
39
5. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Überprüfen Sie die
Informationen zu den Installationsvoraussetzungen für Adobe LiveCycle PDF Generator 7.2 und klicken
Sie auf Weiter.
beschleunigen.
8. Akzeptieren Sie das angegebene Standardverzeichnis oder klicken Sie auf Durchsuchen und wechseln
Sie zu dem Verzeichnis, in dem Sie das Produkt installieren möchten. Klicken Sie auf Weiter.
9. Wählen Sie bei der entsprechenden Aufforderung den Anwendungsserver, auf dem Sie das Produkt
bereitstellen möchten, und klicken Sie auf Weiter.
Hinweis: Wählen Sie nicht die Option zur automatischen Konfiguration und Bereitstellung aus.
10. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Wenn Corel WordPerfect
installiert ist, wechseln Sie im Bildschirm für Corel WordPerfect zur ausführbaren Datei von Corel
WordPerfect und klicken Sie auf Weiter. Wenn Corel WordPerfect nicht installiert ist, klicken Sie sofort
auf Weiter.
11. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Wenn Adobe Photoshop
installiert ist, wechseln Sie im Bildschirm für Adobe Photoshop zur ausführbaren Datei von Adobe
Photoshop und klicken Sie auf Weiter. Wenn Adobe Photoshop nicht installiert ist, klicken Sie sofort
auf Weiter.
12. Überprüfen Sie die Installationsdetails und klicken Sie auf Installieren. Das Installationsprogramm
zeigt den Fortschritt der Installation an. Im Anschluss an die Installation wird eine Zusammenfassung
angezeigt.
13. Vergewissern Sie sich, dass die Option Configuration Manager starten nicht aktiviert ist und klicken
Sie auf Fertig stellen.
Vorsicht: Führen Sie Configuration Manager erst aus, wenn Sie alle erforderlichen Produkte installiert und
die Umgebung entsprechend vorbereitet haben. (Siehe „Vorbereiten der Umgebung“ auf
Seite 44.) Nach der Installation aller Produkte und der Vorbereitung der Umgebung müssen Sie
Configuration Manager nur ein einziges Mal ausführen, um die bereitstellbaren Komponenten
zu konfigurieren und zu assemblieren. Wenn Sie zu einem späteren Zeitpunkt ein weiteres
LiveCycle-Produkt hinzufügen möchten, können Sie Configuration Manager erneut ausführen,
um die Produktmodule zu konfigurieren, zu assemblieren und bereitzustellen. (Siehe
„Konfigurieren von LiveCycle-Produkten für die Bereitstellung“ auf Seite 51.)
Adobe LiveCycle
40
Dieser Abschnitt findet nur auf LiveCycle Assembler, LiveCycle Forms, LiveCycle Form Manager und
LiveCycle Workflow Anwendung.
Für die Ausführung des Installationsprogramms benötigen Sie die folgenden Informationen:
O
Seriennummer des zu installierenden Produkts
O
Art der durchzuführenden Installation und Konfiguration (siehe „Methoden für die Installation,
Konfiguration und Bereitstellung von LiveCycle-Produkten“ auf Seite 12)
O
O
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 Meldungen ähnlich der folgenden 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 im temporären Verzeichnis des verwendeten Betriebssystems mindestens
3 GB freier Speicherplatz für das Installationsprogramm vorhanden ist:
O
(Windows) TMP oder TEMP gemäß Einstellung der Umgebungsvariablen
O
(Linux) Basisverzeichnis des angemeldeten Benutzers
³ So installieren Sie LiveCycle-Produkte für die manuelle Bereitstellung:
1. Wechseln Sie zum Stammverzeichnis des Installationsmediums. Bei Workflow müssen Sie zum
Verzeichnis AdobeLiveCycleWorkflow7.2 wechseln.
2. Starten Sie das Installationsprogramm:
O
(Windows) Doppelklicken Sie auf die EXE-Datei.
O
Vorsicht: Wenn Sie das Produkt unter Linux installieren, müssen Sie als Root-Benutzer angemeldet sein,
um das Produkt erfolgreich im Standard-Installationsverzeichnis /opt/adobe/livecycle
installieren zu können. Wenn Sie nicht als Root-Benutzer angemeldet sind, ändern Sie das
Installationsverzeichnis in ein Verzeichnis, für das Sie Berechtigungen besitzen (z. B.
$HOME/adobe/livecycle).
Adobe LiveCycle
41
5. Falls Sie eine Aktualisierung für eine frühere Version installieren, vergewissern Sie sich im Bildschirm
Vor der Installation lesen, dass Sie alle Anleitungen für die Aktualisierung befolgt haben. Klicken Sie
auf Weiter. Wenn Sie keine Aktualisierung durchführen, klicken Sie auf Weiter.
beschleunigen.
Hinweis: Abhängig von dem Produkt, das Sie installieren, werden die nächsten beiden Schritte
möglicherweise in umgekehrter Reihenfolge angezeigt.
9. Wählen Sie den Anwendungsserver, auf dem Sie das Produkt bereitstellen möchten, und klicken Sie auf
Weiter.
Hinweis: Wählen Sie nicht die Option zur automatischen Konfiguration und Bereitstellung aus.
Sie zu dem Verzeichnis, in dem Sie das Produkt installieren möchten. Klicken Sie auf Weiter.
Hinweis: Wenn Sie den Namen eines nicht vorhandenen Verzeichnisses eingeben, wird dieses Verzeichnis
erstellt.
Vorsicht: Bei der Installation des Produkts können Sie ein anderes Installationsverzeichnis angeben. Wenn
Sie das Produkt unter Linux installieren, darf das angegebene Verzeichnis keine Leerzeichen
enthalten, da die Installation sonst nicht durchgeführt wird.
angezeigt.
Hinweis: Wenn Sie LiveCycle Workflow installiert haben, können Sie jetzt Watched Folder installieren.
(Siehe „Installieren von Watched Folder“ auf Seite 43.)
Hinweis: Wenn Sie LiveCycle Forms installiert haben, können Sie jetzt LiveCycle Print installieren. (Siehe
„Installieren von LiveCycle Print“ auf Seite 42.)
Adobe LiveCycle
Installieren von LiveCycle Print
42
Installieren von LiveCycle Print
Vor der Installation von LiveCycle Print müssen Sie zunächst LiveCycle Forms installieren. (Siehe
„Installieren von LiveCycle-Produkten“ auf Seite 40.)
³ So installieren Sie LiveCycle Print:
1. Starten Sie das Installationsprogramm auf der Stammebene des Installationsmediums:
O
(Windows) Doppelklicken Sie auf die Datei adobe_livecycle_print_7_2.exe.
O
(Linux) Geben Sie an einer Eingabeaufforderung adobe_livecycle_print_7_2.bin ein.
Hinweis: Eventuell müssen Sie unter Linux die für das Installationsprogramm geltenden Rechte
ändern. Geben Sie hierzu chmod +x filename.bin ein.
4. Falls Sie eine Aktualisierung für eine frühere Version installieren, vergewissern Sie sich im Bildschirm
Vor der Installation lesen, dass Sie alle Anleitungen für die Aktualisierung befolgt haben. Klicken Sie
auf Weiter. Wenn Sie keine Aktualisierung durchführen, klicken Sie auf Weiter.
Sie zum Verzeichnis [LiveCycle-Stammverzeichnis], in dem Sie LiveCycle Forms installiert haben.
Hinweis: LiveCycle Print muss im selben Verzeichnis [LiveCycle-Stammverzeichnis] wie LiveCycle Forms
installiert werden.
angezeigt.
Hinweis: Wenn Sie die Installation mit den Beispielanwendungen von LiveCycle Print testen möchten,
müssen Sie die Datei adobe-printSubmitter.ear bereitstellen. (Siehe „Bereitstellen und
Ausführen der PrintIVS-Webanwendung“ auf Seite 30.)
Adobe LiveCycle
Installieren von Watched Folder
43
Installieren von Watched Folder
Bei der Installation von Watched Folder werden die zur Konfiguration und Bereitstellung erforderlichen
Dateien auf dem Computer abgelegt. Führen Sie dieses Verfahren erst durch, nachdem Sie LiveCycle
Workflow und LiveCycle Assembler installiert haben.
³ So installieren Sie Watched Folder:
1. Starten Sie das Installationsprogramm im Verzeichnis Watched Folder auf der Installations-DVD für
Adobe LiveCycle Assembler:
O
(Windows) Doppelklicken Sie auf die Datei setupwin32.exe.
O
(Linux) Geben Sie an einer Eingabeaufforderung setupLinux.bin ein.
2. Wählen Sie bei der Aufforderung eine Sprache für die Installation und klicken Sie auf OK.
4. Wenn Sie den Installationsvorgang beschleunigen möchten, deaktivieren Sie sämtliche
Virenscanner-Software und klicken Sie auf Weiter.
6. Akzeptieren Sie den Standardspeicherort oder klicken Sie auf Durchsuchen und wechseln Sie zu dem
Verzeichnis, in dem Sie Watched Folder installieren möchten. Klicken Sie auf Weiter.
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 Verzeichnis
[LiveCycle-Stammverzeichnis].
Nächste Schritte
Sie müssen die Datenbank und den Anwendungsserver nun auf ihre Aufgaben als Host für
LiveCycle-Produkte vorbereiten. (Siehe „Vorbereiten der Umgebung“ auf Seite 44.)
5
Vorbereiten der Umgebung
In diesem Kapitel wird die Vorbereitung der Umgebung für das Hosten von LiveCycle-Produkten
beschrieben. Die in diesem Kapitel beschriebenen Aufgaben müssen vor dem Konfigurieren der
LiveCycle-Produkte durchgeführt werden:
O
„Erstellen der Datenbank“ auf Seite 44
O
„Vorbereiten des Anwendungsservers“ auf Seite 50.
Bei Ausführung einer Turnkey-Installation ist die Durchführung dieser Aufgaben nicht erforderlich.
Erstellen der Datenbank
In diesem Abschnitt wird die Einrichtung der Datenbank beschrieben, in der LiveCycleKonfigurationsinformationen und Laufzeitdaten gespeichert werden. Die nachfolgend beschriebenen
Verfahren gelten für alle LiveCycle-Produkte, die User Management verwenden. Wenn Sie die Datenbank
bereits zur Bereitstellung anderer LiveCycle-Produkte konfiguriert haben, müssen Sie die Aufgaben nicht
erneut durchführen.
Hinweis: User Management ist eine optionale Funktion für LiveCycle Forms.
Ist dies Ihre erste Installation eines LiveCycle-Produkts, müssen Sie eine leere Datenbank erstellen. Alle zur
Unterstützung von LiveCycle-Produkten erforderlichen Tabellen werden von Configuration Manager beim
Initialisieren der Datenbank erstellt. (Siehe „Initialisieren der Datenbank“ auf Seite 70.)
Bevor Sie die Datenbank erstellen, müssen Sie sich mit den Installationsanforderungen vertraut machen
und sicherstellen, dass die erforderliche Software installiert ist. (Siehe „Vorbereiten der Installation“ auf
Seite 11.)
Informationen zum Erstellen der BAM-Metadaten-Datenbank für LiveCycle Workflow Server finden Sie
unter „Erstellen der BAM-Metadaten-Datenbank“ auf Seite 80.
Erstellen einer MySQL-Datenbank
Erstellen Sie mit den MySQL-Tools eine MySQL-Datenbank für die Verwendung mit den LiveCycleProdukten sowie ein MySQL-Benutzerkonto, über das der Anwendungsserver eine Verbindung zur
Datenbank herstellen kann. Darüber hinaus müssen Sie die Konfiguration für den
MySQL-Datenbankserver ändern. Informationen zum Erstellen von Datenbank und Benutzerkonto finden
Sie in der MySQL-Dokumentation.
Tipp: Wenn Sie anhand einer grafischen Benutzeroberfläche ein Datenbankschema einrichten und neue
Benutzer auf MySQL hinzufügen möchten, müssen Sie MySQL Administrator installieren. Weitere
Informationen finden Sie in der Benutzerdokumentation zu MySQL.
Sie benötigen den Datenbanknamen sowie den Benutzernamen und das Kennwort des
MySQL-Benutzerkontos, wenn Sie die Datenbankverbindung auf JBoss konfigurieren.
44
Adobe LiveCycle
Erstellen einer Oracle-Datenbank
45
MySQL-Benutzerkonto
Für das von Ihnen erstellte MySQL-Benutzerkonto sind für den Zugriff auf die Tabellen in der
LiveCycle-Datenbank die folgende Zugriffsrechte erforderlich:
O
SELECT
O
INSERT
O
UPDATE
O
DELETE
O
CREATE
O
DROP
O
REFERENCES
O
INDEX
O
ALTER
O
CREATE_TMP_TABLE
O
LOCK_TABLES
Konfigurieren des MySQL-Datenbankservers
Damit beim Hochladen umfangreicher Dateien auf MySQL keine Probleme auftreten, müssen Sie die
maximal zulässige Größe des Kommunikationspakets auf 25 MB einstellen. Diese Eigenschaft wird in der
MySQL-Datei my.ini (Windows) bzw. der Datei my.cnf (Linux) festgelegt. Weitere Informationen zur
maximal zulässigen Größe des Kommunikationspakets in MySQL finden Sie unter
http://dev.mysql.com/doc/mysql/en/packet-too-large.html.
Wenn Ihre MySQL-Installation keine Datei namens my.ini bzw. my.cnf enthält, müssen Sie die Datei
erstellen. Informationen zum Speicherort der Datei oder zum Erstellen der Datei finden Sie in der
MySQL-Dokumentation.
³ So passen Sie die MySQL-Konfiguration an:
1. Öffnen Sie die Datei my.ini (Windows) bzw. my.cnf (Linux) in einem Texteditor.
2. Fügen Sie dem Abschnitt [mysqld] die folgende Zeile hinzu:
max_allowed_packet=25M
3. Speichern und schließen Sie die Datei.
Erstellen einer Oracle-Datenbank
Wenn Sie die bei der Installation von Oracle 9i oder 10g erstellte Standarddatenbank nicht verwenden
möchten, erstellen Sie mit dem Database Configuration Assistant-Tool eine neue Datenbank.
Wenn eines oder mehrere der LDAP-Verzeichnisse, mit denen die Datenbank zur Authentifizierung von
LiveCycle-Benutzern eine Synchronisierung durchführt, Datensätze mit UTF-8-Zeichen enthält, müssen Sie
eine Datenbank erstellen, die den UTF-8-Zeichensatz verwendet.
Darüber hinaus müssen Sie einen neuen Benutzer in der Datenbank erstellen und diesem die Rollen DBA,
CONNECT und RESOURCE sowie die Systemzugriffsrechte ACCESS_ANY_WORKSPACE, UNLIMITED
Adobe LiveCycle
Erstellen einer DB2-Datenbank
46
TABLESPACE und CREATE VIEW zuweisen. Bei Bereitstellungen unter Linux darf der Benutzername
maximal 8 Zeichen umfassen, unter Windows gilt eine Beschränkung von 12 Zeichen.
Der Benutzername und das Kennwort des neuen Benutzers, den Sie in der Datenbank erstellen, werden
beim Erstellen der Datenquelle erneut verwendet.
Informationen zum Verwenden von Oracle 9i oder 10g finden Sie in der Dokumentation zu Oracle 9i
bzw. 10g.
Erstellen einer DB2-Datenbank
Erstellen Sie eine DB2-Datenbank, indem Sie das in diesem Abschnitt aufgeführte Skript ausführen. Das
Skript ist auf ein System abgestimmt, das für die Datenbank 1 GB Speicherplatz verwendet. Wenn in Ihrem
System für die Datenbank eine andere Speichermenge vorgesehen ist, lesen Sie in der DB2-Dokumentation
die Hinweise zur Konfiguration der Systemeinstellungen.
Darüber hinaus müssen Sie einen Benutzer mit SYSADM- und DBADM-Rechten erstellen, der bei der
Konfiguration der Datenquelle auf dem Anwendungsserver verwendet werden kann. Informationen zum
Erstellen von Benutzern finden Sie in der DB2-Dokumentation. Bei Bereitstellungen unter Linux darf der
Benutzername maximal 8 Zeichen umfassen, unter Windows gilt eine Beschränkung von 12 Zeichen.
Der Benutzername und das Kennwort des neuen Benutzers, den Sie in der Datenbank erstellen, werden
beim Erstellen der Datenquelle erneut verwendet.
Nachdem Sie die Datenbank erstellt haben, müssen Sie sie konfigurieren, um die gleichzeitige
Verwendung zu ermöglichen. (Siehe „Konfigurieren einer DB2-Datenbank für die gleichzeitige
Verwendung“ auf Seite 47.)
³ So erstellen Sie eine DB2-Datenbank:
1. Erstellen Sie auf dem DB2-Hostcomputer eine neue Textdatei, die das folgende DB2-Skript enthält:
create database Datenbankname using codeset utf-8 territory default
connect to Datenbankname;
CREATE BUFFERPOOL "BP8K" SIZE 50000 PAGESIZE 8192 NOT EXTENDED STORAGE;
connect reset;
CREATE TEMPORARY TABLESPACE DATENBANKNAME_TEMP_8K IN DATABASE PARTITION
GROUP
IBMTEMPGROUP PAGESIZE 8192 MANAGED BY SYSTEM USING
('DB2_Stammverzeichnis\DATENBANKNAME_TEMP')
EXTENTSIZE 32 PREFETCHSIZE 16 BUFFERPOOL BP8K;
CREATE REGULAR TABLESPACE DATENBANKNAME_DATA_8K IN DATABASE PARTITION
GROUP
IBMDEFAULTGROUP PAGESIZE 8192 MANAGED BY DATABASE USING
(FILE'DB2_Stammverzeichnis\DATENBANKNAME_DATA'9000) EXTENTSIZE 16
PREFETCHSIZE 16 BUFFERPOOL
BP8K;
commit work;
connect reset;
alter bufferpool ibmdefaultbp immediate size 96000;
alter bufferpool bp8k immediate size 32000;
commit work;
connect reset;
Adobe LiveCycle
Konfigurieren einer DB2-Datenbank für die gleichzeitige Verwendung
update db cfg for Datenbankname using
deactivate database Datenbankname;
activate database Datenbankname;
47
dbheap 4000;
logbufsz 2048;
locklist 2000;
chngpgs_thresh 40;
logfilsiz 4000;
2. Nehmen Sie die folgenden Änderungen am Skript vor:
O
Ersetzen Sie die Platzhalter Datenbankname und DATENBANKNAME durch den Namen, den Sie der
LiveCycle-Datenbank zuweisen möchten.
O
Ersetzen Sie DB2_Stammverzeichnis durch den Pfad zu dem Stammverzeichnis, in dem DB2
installiert ist.
O
Stellen Sie sicher, dass sich die einzelnen Befehle vollständig in je einer einzelnen Zeile befinden
und jeder Befehl mit einem Semikolon (;) endet.
O
Ersetzen Sie den Wert 9000 in der folgenden Zeile durch die Größe Ihrer Datenbank:
(FILE'DB2_Stammverzeichnis\DATENBANKNAME_DATA'9000)
Mit diesem Wert wird die Mindestanzahl der Seiten angegeben, die zum Initialisieren der
Datenbank erforderlich sind. Sie können diesen Wert auch nach dem Initialisieren der Datenbank
mit den DB2-Verwaltungstools ändern.
3. Speichern Sie die Textdatei an einem Ort, auf den der DB2-Befehlszeilenprozessor zugreifen kann.
4. Öffnen Sie eine Eingabeaufforderung.
5. (Windows) Geben Sie den folgenden Befehl ein, um den DB2-Befehlszeilenprozessor zu öffnen:
db2cmd
6. Geben Sie den folgenden Befehl ein, um das Skript auszuführen:
db2 -tf <Skriptdateipfad>/<Skriptdateiname>
Konfigurieren einer DB2-Datenbank für die gleichzeitige Verwendung
Wenn Sie mit einer DB2-Datenbank arbeiten, müssen Sie diese für die gleichzeitige Verwendung durch
mehrere Benutzer konfigurieren.
³ So konfigurieren Sie die DB2-Datenbank für die gleichzeitige Verwendung:
1. Starten Sie das DB2 Control Center:
O
(Windows) Wählen Sie Start > Programme > IBM DB2 > General Administration Tools > Control
Center.
O
(Linux) Geben Sie an einer Eingabeaufforderung den Befehl db2cc ein.
2. Klicken Sie in der Objektstruktur des DB2 Control Center auf All Databases.
3. Klicken Sie mit der rechten Maustaste auf die Datenbank, die Sie für LiveCycle-Produkte erstellt haben,
und klicken Sie auf Configuration Advisor.
4. Führen Sie die im Configuration Advisor-Assistenten angezeigten Schritte durch und stellen Sie sicher,
dass die in der folgenden Tabelle aufgeführten Eigenschaften eingestellt sind.
Adobe LiveCycle
Erstellen einer SQL Server-Datenbank
DB2-Eigenschaft
Erforderlicher Wert
Workload type
Mixed
48
Average number of SQL transactions Fewer than 10
per unit of work
Database Administration Priority
Faster transaction performance
Populated Database
Wählen Sie die Einstellung, die dem derzeitigen Zustand der
Datenbank entspricht. Die Datenbank ist nicht gefüllt, wenn
sie mit Configuration Manager noch nicht initialisiert wurde.
Isolation Level
Cursor Stability
Erstellen einer SQL Server-Datenbank
Sie können eine SQL Server-Datenbank erstellen, in der LiveCycle-Produkte Laufzeit- und
Konfigurationsdaten speichern können. Weitere Informationen zum Erstellen einer SQL Server-Datenbank
finden Sie in der SQL Server-Dokumentation. LiveCycle-Produkte unterstützen SQL Server 2000 SP3a.
Erstellen Sie eine SQL Server-Datenbank und einen Benutzer mit SYSADM- und DBADM-Rechten, der bei
der Konfiguration der Datenquelle auf dem Anwendungsserver verwendet werden kann. Informationen
zum Erstellen der Datenbank und des Benutzers finden Sie in der SQL Server-Dokumentation.
Die SQL Server-Datenbank kann mit den Windows- oder SQL Server-Authentifizierungstypen konfiguriert
werden. Zum Ausführen der Datenbank mit JBoss muss der Authentifizierungstyp auf SQL Server
eingestellt sein.
Hinweis: LiveCycle PDF Generator benötigt außerdem eine JMS-Datenbank auf SQL Server. (Siehe
„Erstellen einer JMS-Datenbank auf SQL Server“ auf Seite 48.)
Erstellen einer JMS-Datenbank auf SQL Server
Dieser Abschnitt findet nur auf LiveCycle PDF Generator Anwendung.
Wenn LiveCycle PDF Generator auf JBoss bereitgestellt wird, müssen Sie abgesehen von der
LiveCycle-Datenbank auch eine JMS-Datenbank (Java Message Service) auf SQL Server erstellen.
³ So erstellen Sie eine JMS-Datenbank:
1. Wählen Sie Start > Programme > Microsoft SQL Server > Enterprise Manager.
2. Wählen Sie in der Navigationsstruktur den Befehl Konsolenstamm > Microsoft SQL Server > SQL
Server-Gruppe > [Servername] > Datenbanken.
3. Klicken Sie mit der rechten Maustaste auf Datenbanken und wählen Sie Neue Datenbank.
4. Geben Sie in das Feld Name einen Namen für die Datenbank ein und klicken Sie auf OK.
5. Wählen Sie in der Navigationsstruktur den Befehl Konsolenstamm > Microsoft SQL Server > SQL
Server-Gruppe > [Servername] > Sicherheit > Benutzernamen.
6. Klicken Sie mit der rechten Maustaste auf Benutzernamen und wählen Sie Neuer Benutzername.
Adobe LiveCycle
Erstellen einer JMS-Datenbank auf SQL Server
49
7. Geben Sie im Bildschirm SQL Server-Eigenschaften den gewünschten Benutzernamen in das Feld
Name ein, wählen Sie SQL Server-Authentifizierung und geben Sie in das Feld Kennwort ein
Kennwort ein.
8. Klicken Sie auf die Registerkarte Datenbankzugriff, wählen Sie die Datenbank aus, die Sie in Schritt 4
erstellt haben, und wählen Sie in der Liste In Datenbankrolle zulassen die Einträge public und
db_owner.
9. Klicken Sie auf die Registerkarte Serverrollen, wählen Sie die Option für den Ersteller der Datenbank
und klicken Sie auf OK.
10. Geben Sie im Bildschirm Kennwort bestätigen das in Schritt 7 erstellte Kennwort ein und klicken Sie
auf OK.
11. Klicken Sie in der Navigationsstruktur mit der rechten Maustaste auf Benutzernamen und wählen Sie
Neuer Benutzername. Geben Sie in das Feld Name die Bezeichnung guest ein und wählen Sie SQL
Server-Authentifizierung.
12. Vergewissern Sie sich, dass die von Ihnen in Schritt 4 erstellte Datenbank als Standarddatenbank
festgelegt ist und als Standardsprache Deutsch verwendet wird.
13. Klicken Sie auf die Registerkarte Datenbankzugriff und wählen Sie die Datenbank aus, die Sie in
Schritt 4 erstellt haben. Wählen Sie in der Liste In Datenbankrolle zulassen den Eintrag public und
klicken Sie auf OK.
14. Wählen Sie im Dialogfeld Kennwort bestätigen die Option Leeres Kennwort und klicken Sie auf OK.
15. Wählen Sie Start > Programme > Microsoft SQL Server > Query Analyzer und melden Sie sich mit
dem in Schritt 7 erstellten Benutzernamen an.
16. Kopieren Sie das folgende SQL-Skript in das Fenster Abfrage:
USE IhreDatenbank;
CREATE TABLE JMS_MESSAGES (MESSAGEID INTEGER NOT NULL,
DESTINATION VARCHAR(150) NOT NULL, TXID INTEGER, TXOP CHAR(1),
MESSAGEBLOB IMAGE, PRIMARY KEY (MESSAGEID, DESTINATION));
CREATE TABLE JMS_TRANSACTIONS (TXID INTEGER);
CREATE TABLE JMS_USERS (USERID VARCHAR(32) NOT NULL,
PASSWD VARCHAR(32) NOT NULL, CLIENTID VARCHAR(128), PRIMARY KEY(USERID));
CREATE TABLE JMS_ROLES (ROLEID VARCHAR(32) NOT NULL,
USERID VARCHAR(32) NOT NULL, PRIMARY KEY(USERID, ROLEID));
CREATE TABLE JMS_SUBSCRIPTIONS (CLIENTID VARCHAR(128) NOT NULL,
SUBNAME VARCHAR(128) NOT NULL, TOPIC VARCHAR(255) NOT NULL,
SELECTOR VARCHAR(255), PRIMARY KEY(CLIENTID, SUBNAME));
INSERT INTO JMS_USERS (USERID, PASSWD)
INSERT INTO JMS_USERS (USERID, PASSWD,
'DurableSubscriberExample');
INSERT INTO JMS_ROLES (ROLEID, USERID)
VALUES ('guest', 'guest');
VALUES ('j2ee', 'j2ee');
CLIENTID) VALUES ('john', 'needle',
VALUES
VALUES
VALUES
VALUES
VALUES
('nobody', 'nobody');
('dynsub', 'dynsub');
('guest','guest');
('j2ee','guest');
('john','guest');
Adobe LiveCycle
INSERT
INSERT
INSERT
INSERT
INSERT
INSERT
INTO
INTO
INTO
INTO
INTO
INTO
JMS_ROLES
JMS_ROLES
JMS_ROLES
JMS_ROLES
JMS_ROLES
JMS_ROLES
Vorbereiten des Anwendungsservers
(ROLEID,
(ROLEID,
(ROLEID,
(ROLEID,
(ROLEID,
(ROLEID,
USERID)
USERID)
USERID)
USERID)
USERID)
USERID)
VALUES
VALUES
VALUES
VALUES
VALUES
VALUES
50
('subscriber','john');
('publisher','john');
('publisher','dynsub');
('durpublisher','john');
('durpublisher','dynsub');
('noacc','nobody');
17. Ersetzen Sie in der ersten Zeile des Skripts IhreDatenbank durch den Namen der Datenbank, die Sie
in Schritt 4 erstellt haben.
18. Klicken Sie zum Ausführen des Skripts auf den grünen Pfeil in der Taskleiste. Das SQL-Skript sollte nun
fehlerfrei ausgeführt werden.
Vorbereiten des Anwendungsservers
Sie müssen den Anwendungsserver installieren, den Sie zum Ausführen der LiveCycle-Produkte
verwenden möchten. Darüber hinaus müssen Sie einige vorläufige Konfigurationsschritte auf dem
Anwendungsserver durchführen.
Installieren von JBoss Application Server
Wenn Sie JBoss manuell zum Ausführen von LiveCycle-Produkten konfigurieren, müssen Sie JBoss
Application Server 3.2.5 herunterladen und installieren. JBoss kann von der folgenden Website
heruntergeladen werden:
http://labs.jboss.com/portal/jbossas/download
Wenn Sie eine Turnkey-Installation ausführen, müssen Sie JBoss nicht installieren, da die Installation von
Configuration Manager automatisch durchgeführt wird.
Nächster Schritt
Sie müssen die LiveCycle-Produkte jetzt für die Bereitstellung konfigurieren. (Siehe „Konfigurieren von
6
Konfigurieren von LiveCycle-Produkten für die Bereitstellung
In diesem Kapitel wird die Konfiguration von LiveCycle-Produkten für die Bereitstellung beschrieben.
In diesem Kapitel wird davon ausgegangen, dass die LiveCycle-Produkte bereits installiert sind. Wenn Sie die
Produkte noch nicht installiert haben, finden Sie Informationen unter „Installieren von LiveCycle-Produkten“
auf Seite 40.
Die mit einem LiveCycle-Produkt installierte Instanz von Configuration Manager kann mit allen
LiveCycle-Produkten verwendet werden. Wenn Sie Configuration Manager ausführen, können Sie die zu
konfigurierenden LiveCycle-Produkte und den Typ des Anwendungsservers angeben, den Sie in die
Lösung integrieren. Außerdem können Sie Laufzeiteigenschaften für LiveCycle-Produkte festlegen und
Sicherheit aktivieren oder deaktivieren.
Wenn Sie bereits ein oder mehrere LiveCycle-Produkte ausführen, müssen Sie die vorhandenen Produkte
mit dem neu zu konfigurierenden Produkt konfigurieren und assemblieren. Hierfür müssen Sie zunächst
die Bereitstellung der zuvor installierten Produkte rückgängig machen und anschließend alle Produkte
auswählen, die während der Konfiguration assembliert werden sollen. Die zuvor bereitgestellten Produkte
werden dann in die Datei LiveCycle.ear aufgenommen und bei der Bereitstellung der Datei auf dem
Anwendungsserver mit dem neuen Produkt bereitgestellt.
Hinweis: Wenn mehrere LiveCycle-Produkte assembliert werden sollen, müssen alle diese Produkte im
selben Verzeichnis [LiveCycle-Stammverzeichnis] installiert werden.
Wenn Configuration Manager die Konfiguration der Produkte abschließt, werden die auf dem
Anwendungsserver bereitzustellenden Dateien (LiveCycle.ear, adobe-FontManager.ear und die
produktspezifischen EAR-Dateien) im folgenden Verzeichnis gespeichert:
O
(Windows) [LiveCycle-Stammverzeichnis]\configurationManager\export
O
(Linux) [LiveCycle-Stammverzeichnis]/configurationManager/export
³ So konfigurieren Sie die Produkte für die Bereitstellung:
1. Wechseln Sie zum Verzeichnis [LiveCycle-Stammverzeichnis]/configurationManager und starten Sie
Configuration Manager:
O
(Windows) Doppelklicken Sie auf ConfigurationManager.exe.
O
(Linux) Geben Sie an einer Eingabeaufforderung ConfigurationManager.bin ein.
Sie auf OK.
3. Klicken Sie im Begrüßungsbildschirm von Configuration Manager auf Weiter.
4. Wählen Sie Assistent für die benutzerdefinierte Konfiguration und klicken Sie auf Weiter.
6. Wählen Sie den installierten Anwendungsserver, die Option Plattform sowie die zu konfigurierenden
Produkte. Klicken Sie auf Weiter.
51
Adobe LiveCycle
52
7. (LiveCycle Forms) Wählen Sie im Bildschirm Adobe User Management-Auswahl entweder LiveCycle
Forms mit User Management und Administrator oder LiveCycle Forms ohne User Management
und Administrator. Klicken Sie auf Weiter.
8. Stellen Sie sicher, dass nur LiveCycle-Produkte konfigurieren und assemblieren ausgewählt ist und
klicken Sie auf Weiter.
10. (Optional) Wenn Sie auf dem Anwendungsserver SSL-Sicherheit verwenden, aktivieren Sie im
Bildschirm Konfiguration des Data Manager-Moduls die Option SSL aktivieren und geben Sie das
SSL-Berechtigungskennwort ein.
Falls Sie noch keine SSL-Berechtigung eingerichtet haben, können Sie hier ein Kennwort eingeben und
dieses später zum Erstellen der SSL-Berechtigung verwenden. (Siehe „Konfigurieren von SSL auf JBoss“
auf Seite 77.)
11. Geben Sie ein Verzeichnis an, das für die temporäre Datei von Adobe LiveCycle-Produkten
verwendet werden soll, und klicken Sie auf Weiter.
Hinweis: (Linux) Wenn Sie nicht als Root-Benutzer angemeldet sind, geben Sie ein Verzeichnis unter
Ihrem Basisverzeichnis an.
Weitere Informationen zur temporären Datei von Adobe LiveCycle-Produkten finden Sie unter
„Optimieren von Inline-Dokumenten und Auswirkungen auf den JVM-Speicher“ auf Seite 148.
12. Übernehmen Sie im Bildschirm Konfiguration des Data Manager-Moduls – Fortsetzung die
Standardwerte für die folgenden Eigenschaften oder geben Sie neue Werte ein und klicken Sie auf
Weiter:
O
Sweep-Intervall für lokalen Speicher (in Sekunden): Die Zeit, die zwischen Versuchen vergeht,
Dateien zu löschen, die nicht mehr benötigt werden und zuvor zum Weiterleiten der Dokumentdaten
zwischen LiveCycle-Diensten dienten, die auf demselben Computer ausgeführt werden.
O
Sweep-Intervall für globalen Speicher (in Sekunden): Die Zeit, die zwischen Versuchen vergeht,
Dateien zu löschen, die veraltet sind und zuvor zum Weiterleiten der Dokumentdaten zwischen
LiveCycle-Diensten dienten, die auf unterschiedlichen Computern ausgeführt werden. Geben Sie
diese Eigenschaft nur an, wenn LiveCycle-Produkte in einer Clusterumgebung bereitgestellt
werden.
O
Standardmäßige Inline-Maximalgröße (in Byte): Die maximale Anzahl von Byte, die im Speicher
verbleiben, wenn Dokumente zwischen verschiedenen LiveCycle-Komponenten weitergeleitet
werden. Dokumente, die diesen Höchstwert überschreiten, werden auf der Festplatte gespeichert.
Mit dieser Eigenschaft können Sie die Leistung anpassen. (Siehe „Optimieren von
Inline-Dokumenten und Auswirkungen auf den JVM-Speicher“ auf Seite 148.)
O
Standard-Zeitsperre für Entsorgung (in Sekunden): Die maximale Zeit, in der ein Dokument, das
zwischen verschiedenen LiveCycle-Komponenten weitergeleitet wird, als aktiv bezeichnet wird. Nach
Ablauf dieser Zeit können alle Dateien entfernt werden, die zum Speichern dieses Dokuments
verwendet wurden. Mit dieser Eigenschaft können Sie die Auslastung des Festplattenspeicherplatzes
steuern.
O
NFS-Protokoll verwenden (nur Windows): Wählen Sie diese Option, wenn Sie LiveCycle-Produkte
in einer Clusterumgebung bereitstellen. Vor dem Aktivieren dieser Option muss auf WindowsComputern zusätzliche NFS-Software installiert werden. Diese Option hat keine Auswirkungen auf
Bereitstellungen unter Linux.
O
Globales Speicherverzeichnis: Ein Pfad zu einem freigegebenen Verzeichnis, in dem dauerhaft
genutzte Dokumente gespeichert werden, die zwischen LiveCycle-Produkten ausgetauscht
Adobe LiveCycle
53
werden. LiveCycle Workflow verwendet dieses Verzeichnis, um prozessrelevante Dateien auf
allen Clusterknoten freizugeben. LiveCycle Form Manager verwendet dieses Verzeichnis, um
Indexdateien zu speichern, die bei der Volltextsuche eingesetzt werden. Die Verwendung eines
freigegebenen NFS-Verzeichnisses kann zu einer Leistungssteigerung beitragen.
(LiveCycle PDF Generator) Wenn LiveCycle PDF Generator als Dienst ausgeführt wird und Sie einen
Netzwerkordner für die Eigenschaft Globales Speicherverzeichnis angeben möchten, müssen Sie
die Netzwerkadresse des Ordners verwenden und nicht den Pfad des zugeordneten Laufwerks.
Beispielsweise ist \\Computer_Name\temp die Netzwerkadresse des Ordners temp auf dem
Computer mit dem Namen Computer_Name.
Weitere Informationen zur Eigenschaft Globales Speicherverzeichnis finden Sie unter
„Optimieren von Inline-Dokumenten und Auswirkungen auf den JVM-Speicher“ auf Seite 148.
13. (LiveCycle Forms, LiveCycle Form Manager, LiveCycle Workflow, LiveCycle Assembler) (Optional)
Wählen Sie im Konfigurationsbildschirm des Font Manager-Moduls Schriften für LiveCycle Forms aus,
die zusätzlich zu den mit dem Produkt gelieferten Schriften verwendet werden sollen. Geben Sie in das
Feld Schriftartenverzeichnis den Pfad ein oder wechseln Sie zu dem Verzeichnis, in dem die Schriften
gespeichert sind, die Sie hinzufügen möchten. Klicken Sie auf Weiter.
Hinweis: Die Rechte zur Verwendung von Schriften anderer Anbieter als Adobe unterliegen dem
Lizenzvertrag dieser Anbieter von Schriftarten und werden nicht von der Lizenz für die
Adobe-Software abgedeckt. Adobe empfiehlt, dass Sie vor der Verwendung von
Drittanbieter-Schriften in Verbindung mit Adobe-Software alle relevanten Lizenzverträge
der Drittanbieter lesen und dafür sorgen, dass Sie diese Verträge einhalten. Dies gilt
insbesondere für die Verwendung von Schriften in einer Serverumgebung.
14. (LiveCycle Assembler) (Optional) Geben Sie im Bildschirm Konfiguration der AssemblerSicherheitsgruppe den zu implementierenden Sicherheitstyp an, der die Berechtigung zum
Ausführen von Assembler DDX-Aufträgen steuert. Klicken Sie auf Weiter. Es stehen zwei Arten von
Benutzer-Authentifizierung zur Auswahl:
O
Geben Sie ein Sternchen (*) ein, wenn sich alle Benutzer anmelden dürfen, für die ein gültiger
Eintrag im LDAP-System vorhanden ist.
O
Lassen Sie das Feld leer, wenn sich alle Benutzer anmelden dürfen.
15. (LiveCycle Forms, LiveCycle Form Manager, LiveCycle Workflow) (Optional) Übernehmen Sie im
Konfigurationsbildschirm des Form Server-Moduls die Standardwerte für die folgenden Eigenschaften
oder geben Sie neue Werte ein. Klicken Sie auf Weiter:
O
UI-Validierung: Der Benutzeroberflächentyp, der in HTML-Formularen bei Auftreten eines
Überprüfungsfehlers verwendet werden soll. Wenn Sie Liste wählen, werden alle
Überprüfungsfehler auf dem Formular als Links angezeigt. Wenn Sie Meldungsfeld wählen, wird
jede Fehlermeldung in einem Dialogfeld angezeigt, das sich über Weiter- und Zurück-Schaltflächen
steuern lässt. Wo die Listen oder Schaltflächen angezeigt werden, hängt von der für
Validierungsberichterstellung gewählten Option ab.
O
Validierungsberichterstellung: Die Stelle, an der die Überprüfungsmeldungen angezeigt werden.
Wählen Sie eine der folgenden Optionen:
O
Rahmen links: Zeigt Überprüfungsmeldungen in einem Rahmen links im Webbrowser an.
O
Rahmen rechts: Zeigt Überprüfungsmeldungen in einem Rahmen rechts im Webbrowser an.
O
Rahmen oben: Zeigt Überprüfungsmeldungen in einem Rahmen oben im Webbrowser an.
O
Rahmen unten: Zeigt Überprüfungsmeldungen in einem Rahmen unten im Webbrowser an.
O
Kein Rahmen links: Zeigt Überprüfungsmeldungen im selben Fenster links im Webbrowser an.
Adobe LiveCycle
54
O
Kein Rahmen rechts: Zeigt Überprüfungsmeldungen im selben Fenster rechts im Webbrowser
an.
O
Kein Rahmen oben: Zeigt Überprüfungsmeldungen im selben Fenster oben im Webbrowser
an.
O
Kein Rahmen unten: Zeigt Überprüfungsmeldungen im selben Fenster unten im Webbrowser
an.
O
Ohne: Zeigt keine Überprüfungsmeldungen an.
O
Keine UI: Gibt die Überprüfungsmeldungen über die API zurück (mit Daten). Die Überprüfungsmeldungen werden nicht auf dem Bildschirm angezeigt.
O
Keine UI mit Formular: Gibt die Überprüfungsmeldungen über die API zurück (mit dem
Formular). Die Überprüfungsmeldungen werden nicht auf dem Bildschirm angezeigt.
O
Validierungsgrenze: Die Rahmengröße (in Pixel), wenn für Validierungsberichterstellung die
Option Rahmen links, Rahmen rechts, Rahmen oben oder Rahmen unten gewählt wurde. Die
Rahmengröße muss gleich oder größer Null sein.
O
Ausgabetyp: Der Typ der HTML-Ausgabe, die an den Webbrowser zurückgegeben wird. Wählen
Sie HTML (vollständig), um das Formular zwischen vollständigen HTML-Tags wiederzugeben
(vollständige HTML-Seite) bzw. Formular-Hauptteil, um das Formular zwischen div-Tags
wiederzugeben (keine vollständige HTML-Seite).
O
Gebietsschema: Die Sprache, in der Überprüfungsmeldungen als Teil von HTML-Transformationen
an Clientanwendungen wie Webbrowser gesendet werden sollen. Der Standardwert ist Deutsch
(Deutschland). Informationen zu anwendbaren Werten finden Sie unter „Sprach- und
Gebietsschemakombinationen“ im Handbuch Entwickeln benutzerdefinierter Anwendungen, das mit
LiveCycle Forms installiert wurde.
O
Charset: Der zur Kodierung des Ausgabe-Datenstroms zu verwendende Zeichensatz. Diese
Eigenschaft ist vom Parameter sFormPreference abhängig, der über die API festgelegt wird. Bei
HTML-Transformationen unterstützt das Form Server-Modul Zeichenkodierungswerte, die vom
java.nio.charset-Paket definiert werden. Eine Liste der unterstützten Werte finden Sie unter
http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html.
O
Cache aktiviert: Wählen Sie diese Option, wenn Sie die Leistung optimieren möchten. Diese
Option nutzt die Cache-Eigenschaft des Formularentwurfs. Informationen zum Konfigurieren
dieses Werts im Formularentwurf finden Sie in der Adobe LiveCycle Designer-Hilfe.
16. (LiveCycle Forms, LiveCycle Form Manager, LiveCycle Workflow) (Optional) Übernehmen Sie im
Konfigurationsbildschirm des XML Form-Moduls die Standardwerte für die folgenden Eigenschaften
oder geben Sie neue Werte an und klicken Sie auf Weiter:
O
Pool Max: Die maximale Anzahl von Prozessen, die ausgeführt werden können. Der empfohlene
Wert errechnet sich wie folgt: Gesamtanzahl der CPUs * 2 + Konstante (1 oder 2). Wenn der
PoolMax-Grenzwert erreicht wurde, werden anhand von PoolSize Dienstinstanzen erstellt.
O
Trace Level: Die Ablaufverfolgungsstufe. Die folgenden Optionen sind verfügbar:
O
Ohne: Die Ablaufverfolgung ist nicht aktiviert.
O
Eingabe/Beenden: Meldungen werden jedes Mal protokolliert, wenn eine Methode ausgeführt
oder beendet wird.
O
Parameter: Meldungen werden jedes Mal protokolliert, wenn eine Methode ausgeführt oder
beendet wird. Die Werte sämtlicher Parameter, die an die Methoden übergeben werden, werden
protokolliert.
Adobe LiveCycle
O
O
55
Details: Meldungen werden jedes Mal protokolliert, wenn eine Methode ausgeführt oder
beendet wird. Die Werte sämtlicher Parameter, die an die Methoden übergeben werden, sowie
alle zusätzlichen Meldungen werden protokolliert.
Zeitinformationen melden: Wählen Sie diese Option, wenn Sie die Start- und Endzeit von
Aufrufen überwachen möchten. Sie können diese Informationen zum Anpassen der Leistung
verwenden.
17. Überprüfen Sie im Bildschirm Anwendungskonfiguration und Assemblierung – Zusammenfassung
die Konfigurationsdetails und klicken Sie auf Weiter.
18. Klicken Sie im Bildschirm Produkte konfigurieren und assemblieren – Zusammenfassung auf
Weiter.
19. Klicken Sie im Bildschirm Tasks abgeschlossen auf Weiter, wenn Sie eine weitere Aufgabe ausgewählt
haben, die von Configuration Manager durchgeführt werden soll, oder auf Fertig stellen, wenn Sie
Configuration Manager beenden möchten.
Nächster Schritt
Sie müssen den Anwendungsserver jetzt konfigurieren. (Siehe „Manuelles Konfigurieren von JBoss“ auf
Seite 56.)
7
Manuelles Konfigurieren von JBoss
In diesem Kapitel wird die manuelle Konfiguration von JBoss Application Server für die Vorbereitung der
manuellen Bereitstellung von LiveCycle-Produkten beschrieben. Der Anwendungsserver kann auch im
Rahmen der Turnkey-Installation automatisch konfiguriert werden. (Siehe „Installieren von
LiveCycle-Produkten mit der Turnkey-Methode“ auf Seite 20.)
Führen Sie die folgenden Aufgaben durch:
O
Ändern Sie verschiedene JBoss-Konfigurationsdateien auf der JBoss-Instanz, die als Host für
LiveCycle-Produkte dient. (Siehe „Ändern der JBoss-Konfigurationsdateien“ auf Seite 57.)
O
Kopieren Sie die entsprechende Watched Folder-Datei nach JBoss. (Siehe „Konfigurieren von JBoss für
Watched Folder“ auf Seite 61.)
O
Erstellen Sie die Datenquelle, damit LiveCycle-Produkte eine Verbindung zur Datenbank herstellen
können. (Siehe „Herstellen einer Verbindung zwischen JBoss für LiveCycle-Produkte und der
LiveCycle-Datenbank“ auf Seite 61.)
Hinweis: Wenn Sie LiveCycle PDF Generator zusätzlich zu anderen zuvor installierten LiveCycle-Produkten
installiert haben, müssen Sie die Anmeldedaten des Anmeldebenutzerkontos auf die Anmeldedaten
des Kontos ändern, mit dem Microsoft Office auf demselben Computer wie LiveCycle installiert
wurde.
Mit den in diesem Kapitel beschriebenen Verfahren wird der Anwendungsserver für alle
LiveCycle-Produkte konfiguriert. Sollte das Verfahren bei einem bestimmten Produkt abweichen, sind die
entsprechenden Schritte klar hervorgehoben. Wenn Sie den Anwendungsserver bereits zur Bereitstellung
anderer LiveCycle-Produkte konfiguriert haben, müssen Sie die nachfolgend beschriebenen Verfahren
nicht erneut durchführen.
In diesem Kapitel wird davon ausgegangen, dass Sie die Datenbank konfiguriert und ein
Datenbank-Benutzerkonto erstellt haben. Ist dies nicht der Fall, finden Sie Informationen unter
„Vorbereiten der Umgebung“ auf Seite 44.
Starten und Beenden von JBoss
In mehreren Verfahren in diesem Kapitel werden Sie aufgefordert, die Instanz von JBoss, auf der Sie
LiveCycle-Produkte bereitstellen möchten, zu beenden und zu starten.
³ So starten Sie JBoss:
[Anwendungsserver-Stammverzeichnis]/bin.
2. Starten Sie den Server durch Eingabe des folgenden Befehls:
O
(Windows) run.bat -c all
O
(Linux) ./run.sh –c all
56
Adobe LiveCycle
Ändern der JBoss-Konfigurationsdateien
57
³ So beenden Sie JBoss:
[Anwendungsserver-Stammverzeichnis]/bin.
2. Beenden Sie den Server durch Eingabe des folgenden Befehls:
O
(Windows) shutdown.bat -S
O
(Linux) ./shutdown.sh -S
Sie müssen die folgenden Bereiche der JBoss-Instanz ändern, die als Host für LiveCycle-Produkte dient:
O
Verzeichnis endorsed
O
Datei run.bat (Windows) oder run.sh (Linux)
O
JMS
O
Datei jacorb.properties
O
Class-Loading-Isolation der EAR-Datei
O
Einstellungen für die maximalen Threads
O
Datei dom4j.jar
O
cluster-service.xml
Hinweis: Wenn Sie JBoss auf Red Hat Enterprise Linux Advanced Server 3.0 ausführen, müssen Sie die
Umgebungsvariable LD_ASSUME_KERNEL auf 2.4.19 einstellen. Verwenden Sie dazu den
Befehl export LD_ASSUME_KERNEL=2.4.19. Anschließend müssen Sie JBoss von der gleichen
Shell ausführen, in der Sie auch die Umgebungsvariable eingerichtet haben.
³ So erstellen Sie ein Verzeichnis endorsed:
1. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/lib und erstellen Sie ein
Verzeichnis mit dem Namen endorsed.
2. Kopieren Sie die folgenden Dateien aus dem Verzeichnis [LiveCycle-Stammverzeichnis]/components/
um/endorsed in das neu erstellte Verzeichnis endorsed:
O
dom3-xercesImpl-2.4.0.jar
O
dom3-xml-apis-2.4.0.jar
O
xalan-2.4.1.jar
³ So ändern Sie die Dateien run.bat oder run.sh:
1. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/bin und öffnen Sie die folgende
Datei in einem Texteditor:
O
(Windows) run.bat
O
(Linux) run.sh
Tipp: Deaktivieren Sie während der Bearbeitung der Datei den Zeilenumbruch, damit in diesen
Befehlszeilen keine Zeilenschaltungen enthalten sind.
Adobe LiveCycle
58
2. (Windows) Suchen Sie in der Datei run.bat die folgende Zeile:
"%JAVA%" %JAVA_OPTS% -classpath "%JBOSS_CLASSPATH%" org.jboss.Main %*
Ersetzen Sie die Zeile durch den folgenden Text:
"%JAVA%" %JAVA_OPTS% -classpath "%JBOSS_CLASSPATH%" -Xms128m -Xmx512m
-Dorg.apache.lucene.writeLockTimeout=10000
-Djava.endorsed.dirs=%JBOSS_HOME%/server/all/lib/endorsed org.
jboss.Main -c all %*
3. (Linux) Suchen Sie in der Datei run.sh die folgende Textstelle:
# Execute the JVM
"$JAVA" $JAVA_OPTS \
-classpath "$JBOSS_CLASSPATH" \
org.jboss.Main "$@"
Ersetzen Sie diese Textstelle durch den folgenden Text:
# Execute the JVM
"$JAVA" $JAVA_OPTS -Xms128m -Xmx1024m \
-classpath "$JBOSS_CLASSPATH" \
-Dorg.apache.lucene.writeLockTimeout=10000\
-Djava.endorsed.dirs=$JBOSS_HOME/server/all/lib/endorsed \
org.jboss.Main -c all "$@"
4. (SQL Server) Fügen Sie dem Text, den Sie in Schritt 2 oder 3 geändert haben, das folgende Argument
hinzu:
-Dadobe.workflow.scheduler.jdbc.delegate=org.quartz.impl.jdbcjobstore
.MSSQLDelegate \
Hinweis: Dieser Befehl sollte unmittelbar auf den entsprechenden Befehl -Djava (siehe oben) folgen.
Unter Windows muss er vor org.jboss.Main stehen.
5. Speichern Sie die Datei.
³ So ändern Sie die JMS-Konfiguration:
1. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/deploy/jms und öffnen
Sie die Datei hajndi-jms-ds.xml in einem Texteditor.
2. Fügen Sie nach dem Abschnitt JMS XA Resource adapter den folgenden Text ein:
<tx-connection-factory>
<track-connection-by-tx>true</track-connection-by-tx>
<jndi-name>adobe_JmsQueueXA</jndi-name>
<xa-transaction/>
<adapter-display-name>JMS Adapter</adapter-display-name>
<config-property type="java.lang.String"
name="SessionDefaultType">javax.jms.Topic</config-property>
<security-domain-and-application>JmsXARealm
</security-domain-and-application>
name="JmsProviderAdapterJNDI">java:/DefaultJMSProvider
</config-property>
</tx-connection-factory>
<tx-connection-factory>
Adobe LiveCycle
59
<track-connection-by-tx>true</track-connection-by-tx>
<jndi-name>adobe_JmsTopicXA</jndi-name>
<xa-transaction/>
<adapter-display-name>JMS Adapter</adapter-display-name>
name="SessionDefaultType">javax.jms.Topic
</config-property>
<security-domain-and-application>JmsXARealm
</security-domain-and-application>
name="JmsProviderAdapterJNDI">java:/DefaultJMSProvider
</config-property>
</tx-connection-factory>
3. (LiveCycle PDF Generator, LiveCycle Assembler) Wechseln Sie zum Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/deploy/jms und dekomprimieren Sie die Datei
jms-ra.rar.
4. (LiveCycle PDF Generator, LiveCycle Assembler) Wechseln Sie zum Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/deploy/jms/META-INF und öffnen Sie die Datei ra.xml
in einem Texteditor.
5. (LiveCycle PDF Generator, LiveCycle Assembler) Suchen Sie in der Datei ra.xml die folgenden Zeilen:
<config-property-name>Strict</config-property-name>
<config-property-type>java.lang.Boolean</config-property-type>
<config-property-value>true</config-property-value>
Ändern Sie den Wert für <config-property-value> von true in false und speichern Sie die
Änderungen an der Datei.
6. Komprimieren Sie die Datei jms-ra.rar erneut.
³ So bearbeiten Sie die Datei jacorb.properties:
1. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/conf und öffnen Sie die
Datei jacorb.properties in einem Texteditor.
2. Suchen Sie die Eigenschaft jacorb.poa.thread_pool_max und ändern Sie den Wert der
Eigenschaft in 16.
³ So ändern Sie die Einstellungen für die maximalen Threads:
1. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/deploy/
jbossweb-tomcat50.sar/ und öffnen Sie die Datei server.xml in einem Texteditor.
2. Geben Sie wie im folgenden Beispiel gezeigt beim Element <connector> für Anschluss 8080 unter
maxThreads den Wert 75, unter minSpareThreads den Wert 25 und unter maxSpareThreads
den Wert 50 ein:

<Connector port="8080" address="${jboss.bind.address}"
maxThreads="75" minSpareThreads="25" maxSpareThreads="50"
enableLookups="false" redirectPort="8443" acceptCount="250"
connectionTimeout="20000" disableUploadTimeout="true"/>
Adobe LiveCycle
60
³ So legen Sie für das Class-Loading der EAR-Datei den Isolationsmodus fest:
1. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/deploy/
jbossweb-tomcat50.sar/META-INF und öffnen Sie die Datei jboss-service.xml in einem Texteditor.
2. Suchen Sie das folgende Attribut und stellen Sie es wie folgt ein:
<attribute name="UseJBossWebLoader">false</attribute>
4. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/conf und öffnen Sie die
Datei jboss-service.xml in einem Texteditor.
5. (LiveCycle PDF Generator) Stellen Sie <attribute name="Transaction
Timeout">600</attribute> auf einen für Ihr System angemessenen Wert ein. Damit dieser Wert
angewendet werden kann, muss er höher sein als der Wert, der an der Auftragsquelle konfiguriert wird
(mit Administrator nach der Bereitstellung). (Siehe LiveCycle PDF Generator-Administrator-Hilfe.)
6. Suchen Sie in der Datei im Abschnitt Deployers die folgende Zeile:
<mbean code="org.jboss.deployment.EARDeployer"
name="jboss.j2ee:service=EARDeployer">:
7. Fügen Sie nach der Zeile den folgenden Text ein:

<attribute name="Isolated">true</attribute>

<attribute name="CallByValue">true</attribute>
³ So aktualisieren Sie die Datei dom4j.jar:
1. Wechseln Sie zu http://dom4j.org/ und laden Sie eine Version der Datei dom4j.jar herunter, die
aktueller als Implementation-Version 1.5 ist.
2. Benennen Sie die heruntergeladene Datei in dom4j.jar um.
3. Ersetzen Sie die Datei dom4j.jar im Verzeichnis [Anwendungsserver-Stammverzeichnis]/lib durch die
aktuellere Datei, die Sie heruntergeladen haben.
Hinweis: Sie müssen die Datei dom4j.jar ersetzen, da die in JBoss 3.2.5 enthaltene Dateiversion
org.jaxen.*-Klassen enthält. Diese Klassen rufen mit einigen Komponenten der
LiveCycle-Produkte Konflikte hervor.
³ So ändern Sie die Datei cluster-service.xml:
1. Wechseln Sie zum Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/deploy und öffnen Sie
die Datei cluster-service.xml in einem Texteditor.
2. Suchen Sie das Element UDP und setzen Sie folgende Attributwerte:
O
mcast_port=<Beliebige_Anschlussnummer>
O
ip_ttl="1"
Adobe LiveCycle
O
Konfigurieren von JBoss für Watched Folder
61
ip_mcast="false"
Der Wert mcast_port kann in eine beliebige Anschlussnummer zwischen 30000 und 60000 geändert
werden. Jede JBoss-Instanz muss eine eindeutige Anschlussnummer verwenden. Ist dies nicht der Fall,
versucht JBoss, die Server in einem Cluster zu erfassen, wodurch die Leistung beeinträchtigt wird.
Konfigurieren von JBoss für Watched Folder
Wenn Sie Watched Folder für die Verwendung mit LiveCycle Workflow und LiveCycle Assembler
installieren, müssen Sie auf dem Anwendungsserver, auf dem LiveCycle Workflow und Watched Folder
bereitgestellt werden sollen, das im Folgenden beschriebene Verfahren durchführen.
³ So konfigurieren Sie JBoss für Watched Folder:
O
Kopieren Sie die Datei jboss-watchedfolder-service.xml aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/components/watchedFolder/jboss/config in das Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/deploy-hasingleton/jms.
Herstellen einer Verbindung zwischen JBoss für
LiveCycle-Produkte und der LiveCycle-Datenbank
Sie müssen die Datenquelle konfigurieren, damit sie eine Verbindung zur LiveCycle-Datenbank herstellt.
Für JBoss können Sie eine MySQL-, Oracle 9i-, Oracle 10g-, DB2- oder SQL Server-Datenquelle
konfigurieren. (Siehe „Vorbereiten der Umgebung“ auf Seite 44.)
Weitere Informationen zur Verwendung eines Datenbanktyps, der nicht dem für die JBoss JMS-Datenbank
verwendeten Standardtyp entspricht, finden Sie in der JBoss-Dokumentation.
Konfigurieren der MySQL-Datenquelle
Damit JBoss eine Verbindung zur MySQL-Datenbank herstellen kann, in der LiveCycle-Daten gespeichert
werden, müssen Sie die folgenden Aufgaben durchführen, wenn Sie die LiveCycle-Produkte manuell
bereitstellen:
O
Besorgen Sie sich den JDBC-Treiber für MySQL und kopieren Sie ihn auf die JBoss-Instanz, auf der Sie
LiveCycle-Produkte bereitstellen werden.
O
Erstellen Sie eine Datenquelldatei und stellen Sie sie auf der JBoss-Instanz bereit, auf der die
LiveCycle-Produkte bereitgestellt werden sollen.
Vor der Konfiguration der MySQL-Datenquelle muss die LiveCycle-Datenbank bereits auf MySQL erstellt
worden sein. (Siehe „Erstellen einer MySQL-Datenbank“ auf Seite 44.)
Wenn Sie eine Turnkey-Installation durchführen, werden der Anwendungsserver und die Produkte
automatisch so konfiguriert, dass sie mit der MySQL-Datenbank interagieren, die bei der
Turnkey-Installation ebenfalls automatisch installiert wird.
Adobe LiveCycle
Konfigurieren der Oracle-Datenquelle
62
³ So können Sie sich den JDBC-Treiber für MySQL besorgen und kopieren:
1. Besorgen Sie sich die Datei mysql-connector-java-3.0.15-ga-bin.jar entweder aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/configurationManager/lib oder von der MySQL-Website unter
www.mysql.com/products/connector/j/.
2. Kopieren Sie die Datei in das Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/lib.
³ So erstellen Sie die MySQL-Datenquelldatei:
1. Öffnen Sie einen Texteditor und erstellen Sie eine neue Textdatei mit dem folgenden Code:
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<local-tx-datasource>
<jndi-name>IDP_DS</jndi-name>
<connection-url>jdbc:mysql://Hostname:Anschluss/Datenbankname
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<user-name>Datenbank_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>
2. Ersetzen Sie den fett gedruckten Text durch die entsprechenden Werte für Ihre LiveCycle-Datenbank:
O
Hostname: Der Name, die IP-Adresse oder der voll qualifizierte Pfad des Computers, der als Host
für die LiveCycle-Datenbank dient.
O
Anschluss: Der Anschluss, der für den Zugriff auf die LiveCycle-Datenbank verwendet wird. Der
Standardanschluss ist 3306.
O
Datenbankname: Der Name der Datenbank, in der die LiveCycle-Daten gespeichert werden.
O
Datenbank_Benutzername und Kennwort: Der Benutzername und das Kennwort, mit denen
der Anwendungsserver auf die LiveCycle-Datenbank zugreift.
3. Speichern Sie die Datei im Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/deploy unter
dem Namen adobe-ds.xml.
4. Starten Sie JBoss neu.
Damit JBoss eine Verbindung zum Oracle 9i- oder 10g-Tablespace herstellen kann, in dem LiveCycle-Daten
gespeichert werden, müssen Sie die folgenden Aufgaben durchführen:
O
Besorgen Sie sich den JDBC-Treiber für Oracle 9i und kopieren Sie ihn auf die JBoss-Instanz, auf der Sie
Adobe LiveCycle
63
Hinweis: Bei Oracle 10g sind JDBC-Treiberklassen mit der Oracle Client- oder Database-Installation
verfügbar und müssen nicht separat heruntergeladen werden. Der JDBC-Treiber befindet
sich im Verzeichnis [Datenbankserver-Stammverzeichnis]/jdbc/lib.
O
Erstellen Sie eine Datenquelldatei und stellen Sie sie auf der JBoss-Instanz bereit, auf der die
Vor der Konfiguration der Oracle-Datenquelle muss die LiveCycle-Datenbank bereits auf Oracle erstellt
worden sein. (Siehe „Erstellen einer Oracle-Datenbank“ auf Seite 45.)
³ So können Sie sich den JDBC-Treiber für Oracle 9i oder 10g besorgen und kopieren:
1. Laden Sie die für Ihre Datenbank geeignete Datei ojdbc14.jar von der Oracle-Website unter
www.oracle.com/technology/software/index.html herunter.
2. Kopieren Sie die Datei ojdbc14.jar in das Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/lib.
³ So erstellen Sie die Oracle-Datenquelldatei:
<datasources>
<connection-url>jdbc:oracle:thin:@Hostname:Anschluss:Dienstname
</connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>

<exception-sorter-class-name>
org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter
</exception-sorter-class-name>
</datasources>
Informationen zur URL für die Oracle-Verbindung finden Sie unter
www.oracle.com/technology/tech/java/sqlj_jdbc/htdocs/jdbc_faq.htm#05_04.
O
O
O
Dienstname: Der Name des Oracle-Datenbankdienstes.
O
Adobe LiveCycle
Konfigurieren der DB2-Datenquelle
64
Konfigurieren der DB2-Datenquelle
Damit JBoss eine Verbindung zur DB2-Datenbank herstellen kann, in der LiveCycle-Daten gespeichert
werden, müssen Sie die folgenden Aufgaben durchführen:
O
Besorgen Sie sich den JDBC-Treiber für DB2 und kopieren Sie ihn auf die JBoss-Instanz, auf der Sie
O
Erstellen Sie eine DB2-Datenquelldatei und stellen Sie sie auf der JBoss-Instanz bereit, auf der
Vor der Konfiguration der DB2-Datenquelle muss die LiveCycle-Datenbank bereits auf DB2 erstellt worden
sein. (Siehe „Erstellen einer DB2-Datenbank“ auf Seite 46.)
³ So können Sie sich den JDBC-Treiber für DB2 besorgen und kopieren:
1. Besorgen Sie sich die Dateien db2jcc.jar und db2jcc_license_cu.jar aus den
DB2-Installationsverzeichnissen.
2. Kopieren Sie die Dateien in das Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/lib.
³ So erstellen Sie die DB2-Datenquelldatei:
<datasources>
<connection-url>jdbc:db2://Servername:Anschluss/Datenbankname
</connection-url>
<driver-class>com.ibm.db2.jcc.DB2Driver
</driver-class>
<SelectMethod>Cursor</SelectMethod>
</datasources>
O
Servername: Der Name des Computers, auf dem DB2 ausgeführt wird.
O
Anschluss: Der Anschluss, über den der Zugriff auf DB2 erfolgt. Der Standardanschluss ist 50000.
O
Datenbankname: Der Name der DB2-Datenbank, in der die LiveCycle-Daten gespeichert werden.
(Siehe „Erstellen der Datenbank“ auf Seite 44.)
O
Adobe LiveCycle
Konfigurieren der SQL Server-Datenquelle
65
Damit JBoss eine Verbindung zur SQL Server-Datenbank herstellen kann, in der LiveCycle-Daten
gespeichert werden, müssen Sie die folgenden Aufgaben durchführen:
O
Besorgen Sie sich die JDBC-Treiberdateien für SQL Server und kopieren Sie sie auf die JBoss-Instanz, auf
der Sie LiveCycle-Produkte bereitstellen werden.
O
Erstellen Sie eine SQL Server-Datenquelldatei und stellen Sie sie auf der JBoss-Instanz bereit, auf der die
Vor der Konfiguration der SQL Server-Datenquelle muss die LiveCycle-Datenbank bereits auf SQL Server
erstellt worden sein. (Siehe „Erstellen einer SQL Server-Datenbank“ auf Seite 48.)
³ So können Sie sich den JDBC-Treiber für SQL Server besorgen und kopieren:
1. Laden Sie den SQL Server 2000-Treiber für JDBC SP3 von der Microsoft-Website unter
www.microsoft.com/sql/downloads herunter und installieren Sie den Treiber.
2. Kopieren Sie die Dateien msbase.jar, mssqlserver.jar und msutil.jar aus dem Verzeichnis
C:\Programme\Microsoft SQL Server 2000 Driver for JDBC\lib in das Verzeichnis
³ So erstellen Sie die SQL Server-Datenquelldatei:
<datasources>
<connection-url>jdbc:microsoft:sqlserver://Hostname:Anschluss;
DatabaseName=Datenbankname;SelectMethod=Cursor</connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver
</driver-class>
<SelectMethod>Cursor</SelectMethod>
<check-valid-connection-sql>SELECT 1</check-valid-connection-sql>
</datasources>
O
O
O
Datenbankname: Der Name der von Ihnen erstellten Datenbank, die als LiveCycle-Datenbank
dienen soll.
O
Adobe LiveCycle
66
Nächster Schritt
Wenn Sie LiveCycle Workflow installieren und konfigurieren und BAM Server ebenfalls installieren und
konfigurieren möchten, müssen Sie JBoss jetzt manuell für die Verwendung mit BAM Server konfigurieren.
(Siehe „Konfigurieren von JBoss für BAM Server“ auf Seite 81.)
Wenn Sie LiveCycle Workflow nicht installieren, müssen Sie die Produkte jetzt für die
Anwendungsserver-Datenbank bereitstellen. (Siehe „Bereitstellen auf JBoss“ auf Seite 68.)
8
Manuelles Bereitstellen auf JBoss
In diesem Kapitel wird die Bereitstellung von LiveCycle-Produkten auf JBoss beschrieben.
O
„Bereitstellen von LiveCycle-Produkten“ auf Seite 67
O
„Bereitstellen auf JBoss“ auf Seite 68
O
„Anwenden des Verbindungspool-Patches für Watched Folder“ auf Seite 69
O
„Anzeigen von Protokolldateien“ auf Seite 69
Bereitstellen von LiveCycle-Produkten
Bevor Sie LiveCycle-Produkte bereitstellen, vergewissern Sie sich, dass die folgenden Voraussetzungen
erfüllt sind:
O
Sie haben die erforderliche Software und die notwendigen Dateien installiert und kennen die
Verzeichnispfade, die Sie zur Arbeit benötigen. (Siehe „Systemanforderungen“ auf Seite 13.)
O
Sie haben LiveCycle-Produkte installiert. (Siehe „Installieren von LiveCycle-Produkten“ auf Seite 37.)
O
Sie haben JBoss konfiguriert. (Siehe „Manuelles Konfigurieren von JBoss“ auf Seite 56.)
O
Sie haben Configuration Manager ausgeführt und die Produkte Ihren spezifischen System- und
Anwendungsserver-Anforderungen gemäß konfiguriert und assembliert. Falls Sie nach der
Bereitstellung weitere Änderungen an den Eigenschaften vornehmen müssen, führen Sie
Configuration Manager aus, um die gewünschten Änderungen vorzunehmen, und stellen Sie die
aktualisierte EAR-Datei dann bereit. (Siehe „Konfigurieren von LiveCycle-Produkten für die
Bereitstellung“ auf Seite 51.)
Wenn Sie einen Webserver installiert haben, finden Sie Informationen bezüglich der Konfiguration zum
Gewähren von Zugriff auf den Anwendungsserver in der Dokumentation zum Webserver.
Name des JBoss-Verzeichnisses
In diesem Kapitel wird das Basisverzeichnis von JBoss 3.2.5 als [Anwendungsserver-Stammverzeichnis]
bezeichnet und das Verzeichnis, in dem die LiveCycle-Produkte und -Komponenten installiert sind, als
[LiveCycle-Stammverzeichnis]. (Siehe „Konventionen in diesem Handbuch“ auf Seite 8.)
Übersicht der bereitstellbaren Komponenten
In dieser Tabelle werden die bereitstellbaren Komponenten für LiveCycle-Produkte aufgelistet.
Komponente
LiveCycle-Produkt
adobe-ds.xml
Alle
adobe-FontManager.ear
Alle
adobe-service.xml
Alle
DocumentServicesLibrary.jar
Alle
67
Adobe LiveCycle
Bereitstellen auf JBoss
Komponente
LiveCycle-Produkt
LCM.ear
Alle
LiveCycle.ear
Alle
adobe-Assembler7.ear
LiveCycle Assembler
mysql-connector-java-3.0.15-ga-bin.jar
LiveCycle Assembler und LiveCycle PDF Generator
FormsIVS.ear
LiveCycle Forms
pdfg-all.ear
LiveCycle PDF Generator Professional und LiveCycle PDF
Generator Elements
pdfg-ps-all.ear
LiveCycle PDF Generator für PostScript
adobe-printSubmitter.ear
LiveCycle Print
68
Bereitstellen auf JBoss
LiveCycle-Produkte werden auf JBoss 3.2.5 durch Kopieren der bereitstellbaren Komponenten in das
Bereitstellungsverzeichnis bereitgestellt. JBoss kann ausgeführt werden oder beendet sein, wenn Sie die
Dateien in das Verzeichnis 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-Produkte auf JBoss bereit:
1. Kopieren Sie die folgenden Dateien aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/configurationManager/export in das Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/deploy:
O
O
LiveCycle.ear
2. Kopieren Sie die Datei LCM.ear aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/configurationManager/deploy/jboss in das Verzeichnis
3. Kopieren Sie die Datei adobe-service.xml aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/configurationManager/deploy/jboss in das Verzeichnis
[Anwendungsserver-Stammverzeichnis]/server/all/deploy/jms.
4. Kopieren Sie die Datei DocumentServicesLibrary.jar aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/components/csa/jboss/lib/adobe in das Verzeichnis
5. (LiveCycle Assembler) Kopieren Sie die Datei adobe-Assembler7.ear aus dem Verzeichnis
6. (LiveCycle Forms) Kopieren Sie die Datei FormsIVS.ear aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/components/forms/samples/common in das Verzeichnis
Adobe LiveCycle
Anwenden des Verbindungspool-Patches für Watched Folder
69
7. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Kopieren Sie die Datei
pdfg-all.ear aus dem Verzeichnis [LiveCycle-Stammverzeichnis]/configurationManager/export in das
Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/deploy.
8. (LiveCycle PDF Generator für PostScript) Kopieren Sie die Datei pdfg-ps-all.ear aus dem Verzeichnis
9. Starten Sie JBoss neu, um die korrekte Ausführung der Anwendungen zu gewährleisten.
Hinweis: Beim Starten von JBoss werden möglicherweise mehrere Fehlermeldungen in die
JBoss-Server-Protokolldatei geschrieben. Diese Meldungen werden ausgegeben, wenn Sie
die Datenbank noch nicht initialisiert haben.
Anwenden des Verbindungspool-Patches für Watched Folder
Wenn Watched Folder während eines bestimmten Zeitraums (in Stunden) ausgelastet ist, gibt JBoss 3.2.5
einen Ausnahmefehler aus, da alle Datenbankverbindungen im Verbindungspool belegt sind. Dies ist ein
bekanntes Problem in JBoss 3.2.5. Der Verbindungspool-Patch nimmt Änderungen an der Datei
jboss-jca.sar vor.
Wenden Sie diesen Patch an, wenn Sie Watched Folder in einer Produktionsumgebung bzw. Watched
Folder in einer Testumgebung unter Belastungsbedingungen einsetzen. (Der Patch ist nicht erforderlich,
wenn Sie Watched Folder für einfache Vorführ- oder Testzwecke verwenden.)
³ So wenden Sie den Verbindungspool-Patch auf JBoss 3.2.5 an:
1. Beenden Sie den JBoss-Dienst.
2. Ersetzen Sie die Datei jboss-jca.sar im Verzeichnis
[Anwendungsserver-Stammverzeichnis]\server\all\deploy durch die Datei jboss.-jca.sar im Verzeichnis
[LiveCycle-Stammverzeichnis]\configurationManager\deploy\jboss\.
3. Starten Sie den JBoss-Dienst neu.
Anzeigen von 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 ermitteln. Sie können die Protokolldateien in einem Texteditor öffnen.
Die folgenden Protokolldateien sind im Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/log
gespeichert:
O
boot.log
O
server.log.[jjjj-mm-tt]
O
server.log
Nächster Schritt
Sie müssen jetzt die Datenbank mithilfe von Configuration Manager initialisieren. (Siehe „Initialisieren der
Datenbank“ auf Seite 70.)
9
Initialisieren der Datenbank
In diesem Kapitel wird die manuelle Initialisierung der LiveCycle-Datenbank beschrieben.
Wenn Sie User Management mit LiveCycle-Produkten verwenden, müssen Sie Configuration Manager
ausführen, um die Datenbank für die Integration mit User Management zu initialisieren. Wenn Sie
Configuration Manager ausführen, muss der Anwendungsserver bereits ausgeführt werden. Die
Datenbankinitialisierung bereitet eine Datenbank auf den Einsatz mit LiveCycle-Produkten vor, indem
Tabellen erstellt und gegebenenfalls Daten in diese Tabellen eingefügt werden. Dieser Vorgang muss nur
bei der ersten Bereitstellung des Produkts durchgeführt werden.
Geben Sie während der Datenbankinitialisierung nur dann einen SSL-aktivierten Anschluss an, wenn sich
auf dem Anwendungsserver vertrauenswürdige SSL-Zertifikate befinden. Ist dies nicht der Fall, muss für
die Durchführung der Datenbankinitialisierung ein Anschluss angegeben werden, bei dem es sich nicht
um einen SSL-aktivierten Anschluss handelt. (Siehe „Konfigurieren von SSL auf JBoss“ auf Seite 75.)
In diesem Kapitel wird davon ausgegangen, dass die LiveCycle-Datenbank für die Integration mit dem
Produkt bereits konfiguriert und das Produkt auf dem Anwendungsserver bereitgestellt wurde. Ist dies
nicht der Fall, finden Sie Informationen unter „Vorbereiten der Umgebung“ auf Seite 44 und „Manuelles
Bereitstellen auf JBoss“ auf Seite 67.
³ So initialisieren Sie die Datenbank:
1. Starten Sie den Anwendungsserver.
2. Starten Sie Configuration Manager, indem Sie zum Verzeichnis [LiveCycle-Stammverzeichnis]/
configurationManager wechseln und den folgenden Befehl eingeben:
O
(Windows) ConfigurationManager.exe
O
(Linux) ConfigurationManager.bin
4. Wählen Sie im Bildschirm Konfigurationsmodus die Option Assistent für die benutzerdefinierte
Konfiguration und klicken Sie auf Weiter.
6. Wählen Sie im Bildschirm Produktauswahl die Option Plattform und dann die Produkte, die Sie
konfigurieren und bereitstellen möchten. Klicken Sie auf Weiter.
7. Wählen Sie im Bildschirm Taskauswahl die Option Bootstrap-Datenbank und klicken Sie auf Weiter.
Hinweis: Sie müssen lediglich die Bootstrap-Datenbank auswählen. Andere Optionen sind nicht
erforderlich.
8. Geben Sie im Bildschirm Anwendungsserver-URL in das Feld Basis-URL des Anwendungsservers
die URL ein, über die Configuration Manager eine Verbindung zum Anwendungsserver herstellen
kann. Klicken Sie auf Weiter. Klicken Sie im Bildschirm Datenbank für LiveCycle vorbereiten auf
Weiter.
70
Adobe LiveCycle
Initialisieren der Datenbank
9. Klicken Sie im Bildschirm Datenbankinitialisierung auf Datenbank jetzt initialisieren. Wenn die
Aufgabe abgeschlossen ist, klicken Sie auf Weiter.
Nächster Schritt
Sie können jetzt auf User Management und Administrator zugreifen. (Siehe „Aufgaben nach der
Bereitstellung“ auf Seite 27.)
Zudem können Sie LiveCycle-Produkte für den LDAP-Zugriff konfigurieren. (Siehe „Konfigurieren von
LiveCycle-Produkten für den LDAP-Zugriff“ auf Seite 72.)
Wenn Sie LiveCycle Workflow verwenden, können Sie jetzt LiveCycle Workflow Designer installieren.
(Siehe „Installieren von LiveCycle Workflow Designer“ auf Seite 101.)
71
10
Konfigurieren von LiveCycle-Produkten für den LDAP-Zugriff
In diesem Kapitel wird die Konfiguration von LiveCycle-Produkten mit LDAP bzw. LDAP über SSL (LDAPS)
beschrieben.
O
„Konfigurieren von LiveCycle-Produkten mit LDAP“ auf Seite 72
O
„Konfigurieren von LiveCycle-Produkten mit LDAPS“ auf Seite 73
Vorsicht: Wenn Sie mehrere LiveCycle-Produkte installieren und bereitstellen, finden Sie im
entsprechenden Handbuch Installieren und Konfigurieren Informationen zum Erhalten der
bestimmten SSL- und Sicherheitseinstellungen für jedes der von Ihnen installierten
LiveCycle-Produkte.
Konfigurieren von LiveCycle-Produkten mit LDAP
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:
1. Öffnen Sie einen Webbrowser, wechseln Sie zu http://[Hostname]:[Anschluss]/adminui und
melden Sie sich an. (Siehe „Zugreifen auf Administrator“ auf Seite 27.)
2. Wählen Sie Einstellungen > User Management > Domänenverwaltung und klicken Sie auf Neue
Domä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.
Hinweis: JAAS wurde für User Management in LiveCycle 7.2 abgelehnt.
6. Klicken Sie auf OK.
7. Klicken Sie auf Verzeichnis hinzufügen.
8. Wählen Sie unter Seite mit folgenden Elementen füllen eine Verzeichniseinstellung wie
Standardmäßige Sun ONE-Werte aus.
9. Geben Sie in die Felder Server, Anschluss, SSL und Bindung die erforderlichen Werte ein. Weitere
Informationen zu den Verzeichniseinstellungen finden Sie in der Online-Hilfe.
10. Nehmen Sie die gewünschten Benutzer- und Gruppeneinstellungen vor. Weitere Informationen zu den
Verzeichniseinstellungen finden Sie in der Online-Hilfe.
11. (Optional) Testen Sie die Konfiguration:
O
Klicken Sie auf Testen.
72
Adobe LiveCycle
Konfigurieren von LiveCycle-Produkten für den LDAP-Zugriff
Konfigurieren von LiveCycle-Produkten mit LDAPS
73
O
Geben Sie im Bildschirm Verzeichnis testen unter Suchen einen Objektnamen ein und wählen Sie
unter mit: einen Objekttyp wie z. B. Anmelde-ID aus.
O
Klicken Sie auf Testen. Ist der Test erfolgreich, werden die Objektdetails angezeigt. Klicken Sie auf
Zurück.
12. Klicken Sie auf OK, um die Seite Verzeichnis hinzufügen zu verlassen, und klicken Sie zum Beenden
erneut auf OK.
Konfigurieren von LiveCycle-Produkten mit LDAPS
Orientieren Sie sich beim Konfigurieren von User Management für die Unterstützung der
Authentifizierung mit LDAPS am nachfolgend beschriebenen Verfahren.
³ So konfigurieren Sie User Management mit LDAPS:
1. Aktivieren Sie SSL auf dem Verzeichnisserver. Weitere Informationen finden Sie in der Dokumentation
des Verzeichnisanbieters.
2. Exportieren Sie ein Clientzertifikat vom Verzeichnisserver.
3. Verwenden Sie das Keytool, um die Datei mit dem Clientzertifikat in den standardmäßigen
JVM-Zertifikatspeicher zu importieren. Das hierfür verwendete Verfahren ist von den JVM- und
Clientinstallationspfaden abhängig. Wenn Sie z. B. JDK 1.4.2 verwenden, geben Sie an einer
Eingabeaufforderung den folgenden Code ein:
keytool -import -file client_certificate -alias myalias -keystore
jdk142_08/jre/lib/security/cacerts
Geben Sie bei der Aufforderung das Kennwort ein. (Für Java lautet das Standardkennwort changeit.)
In einer Meldung wird angezeigt, dass das Zertifikat erfolgreich importiert wurde.
4. Aktivieren Sie SSL in User Management. Greifen Sie auf die Einstellungen für User Management zu,
indem Sie auf den Seiten von Administrator den Befehl Einstellungen > User Management wählen.
Wählen Sie beim Konfigurieren der Verzeichniseinstellungen für die Eigenschaft SSL die Option Ja und
ändern Sie die Eigenschaft Anschluss entsprechend. Der Standardanschluss ist 636.
Fehlerbehebung
Falls beim Einsatz von SSL Probleme auftreten, verwenden Sie einen beliebigen LDAP-Browser, um zu
überprüfen, ob dieser bei Verwendung von SSL auf das LDAP-System zugreifen kann. Kann der LDAPBrowser nicht auf das LDAP-System zugreifen, ist das Problem auf die Konfiguration des Zertifikats und des
Anwendungsservers zurückzuführen. Kann der LDAP-Browser auf das LDAP-System zugreifen, ist User
Management nicht korrekt konfiguriert.
Teil III: Konfiguration nach der Bereitstellung
In diesem Abschnitt des Handbuchs werden die zusätzlichen Konfigurationsaufgaben beschrieben, die
nach dem Bereitstellen der LiveCycle-Produkte auf dem Anwendungsserver und dem Initialisieren der
LiveCycle-Datenbanken durchgeführt werden müssen.
74
11
Konfigurieren von SSL auf JBoss
In diesem Kapitel wird die Erstellung von SSL-Berechtigungen und die Konfiguration von SSL auf dem
Anwendungsserver beschrieben, um die Sicherheit Ihrer Daten bei der Kommunikation mit dem
Anwendungsserver zu erhöhen.
Die Informationen in diesem Kapitel finden sowohl auf Turnkey- als auch auf manuelle Installationen
Anwendung.
Hinweis: Vor dem Konfigurieren von SSL auf dem Anwendungsserver sollten Sie die Installation,
Konfiguration und Bereitstellung der LiveCycle-Produkte durchführen und sicherstellen, dass die
Produkte korrekt ausgeführt werden.
Stellen Sie unbedingt sicher, dass die auf dem Anwendungsserver konfigurierten Sicherheitseinstellungen
mit den in der Datei LiveCycle.ear enthaltenen Sicherheitseinstellungen übereinstimmen.
Vorsicht: Wenn Sie mehrere LiveCycle-Produkte installieren und bereitstellen, finden Sie im
entsprechenden Handbuch Installieren und Konfigurieren Informationen zum Erhalten der
bestimmten SSL- und Sicherheitseinstellungen für jedes der von Ihnen installierten
LiveCycle-Produkte.
Falls Sie SSL im Data Manager-Modul noch nicht aktiviert (d. h. im Rahmen der Datei LiveCycle.ear
assembliert) haben, führen Sie Configuration Manager aus, um die Produkte mit aktiviertem SSL neu
zu konfigurieren und zu assemblieren und die Datei LiveCycle.ear erneut bereitzustellen. Das in
Configuration Manager angegebene SSL-Kennwort muss mit dem Kennwort übereinstimmen, das Sie
beim Konfigurieren von SSL auf dem Anwendungsserver angeben. (Siehe „Konfigurieren von
Zur Konfiguration von SSL auf dem Anwendungsserver müssen die folgenden Aufgaben durchgeführt
werden:
O
„Erstellen einer SSL-Berechtigung“ auf Seite 75
O
„Konfigurieren von SSL auf JBoss“ auf Seite 77
Erstellen einer SSL-Berechtigung
Für die Konfiguration von SSL auf JBoss benötigen Sie zur Authentifizierung eine SSL-Berechtigung. Sie
können diese Berechtigung anhand der folgenden Arbeitsschritte mit dem IBM Key Management Tool
erstellen, das mit dem Java-Keytool installiert wird.
O
Erstellen Sie ein Schlüsselpaar (öffentlich/privat).
O
Fügen Sie den öffentlichen Schlüssel in ein selbst signiertes Zertifikat des Typs X.509 v1 ein, das als
eingliedrige Zertifikatskette gespeichert wird.
O
Speichern Sie die Zertifikatskette und den privaten Schlüssel in einem neuen Keystore.
Der Keytool-Befehl befindet sich in der Regel im Java-Verzeichnis jre/bin. Mit dem Befehl keytool -genkey
wird das Keytool gestartet und das Schlüsselpaar erstellt. Der Keytool-Befehl muss mehrere Optionen und
Optionswerte enthalten, die in der folgenden Tabelle aufgeführt sind. Der Keytool-Befehl befindet sich in
der Regel im Java-Verzeichnis jre/bin und muss mehrere Optionen und Optionswerte enthalten, die in der
folgenden Tabelle aufgeführt sind.
75
Adobe LiveCycle
Erstellen einer SSL-Berechtigung
Keytool-Option
Beschreibung
Optionswert
-alias
Der Alias des Keystore.
ads-credentials
-keyalg
Der zum Erstellen des
Schlüsselpaars zu
verwendende Algorithmus.
RSA
-keystore
Sie können abhängig von den firmeninternen
Richtlinien einen anderen Algorithmus verwenden.
Der Speicherort und der Name [Anwendungsserver-Stammverzeichnis]/server/all/
der Keystore-Datei.
svcnative/ads-ssl.jks
Der Speicherort kann den
absoluten Pfad der Datei
enthalten oder relativ zum
aktuellen Verzeichnis der
Eingabeaufforderung angegeben werden, an der der
Keytool-Befehl eingegeben
wird.
-validity
-storepass
Die Gültigkeitsdauer des
Zertifikats (in Tagen).
3650
Das Kennwort, das den
Keystore-Inhalt schützt.
Das Keystore-Kennwort muss mit dem
SSL-Berechtigungskennwort übereinstimmen, das
mithilfe von Configuration Manager für das Data
Manager-Modul festgelegt wurde.
Sie können abhängig von den firmeninternen
Richtlinien einen anderen Wert verwenden.
76
Adobe LiveCycle
Keytool-Option
Beschreibung
-keypass
Das Kennwort, das den privaten Verwenden Sie dasselbe Kennwort wie für die
Schlüssel des Schlüsselpaars
Option -storepass. Das Schlüsselkennwort muss
mindestens 6 Zeichen aufweisen.
schützt.
-dname
Der Distinguished Name, der
den Eigentümer des Keystore
kennzeichnet.
77
Optionswert
"CN=[Benutzername],OU=[Gruppenname],
O=[Firmenname], L=[Stadt],
S=[Bundesland], C=[Ländercode]"
O
[Benutzername]: Die Kennung des Benutzers,
dem der Keystore gehört.
O
[Gruppenname]: Die Kennung der
Unternehmensgruppe, der der
Keystore-Besitzer angehört.
O
[Firmenname]: Der Name Ihres
Unternehmens.
O
[Stadt]: Der Ort, an dem Ihr Unternehmen
seinen Sitz hat.
O
[Bundesland]: Das Bundesland, in dem Ihr
Unternehmen seinen Sitz hat.
O
[Ländercode]: Der aus zwei Buchstaben
bestehende Code für das Land, in dem Ihr
Unternehmen seinen Sitz hat.
Sie können Keystore mit einem einzelnen Befehl ausführen, der alle zum Erstellen des Keystore
erforderlichen Informationen enthält. Weitere Informationen zum Verwenden des Keytool-Befehls finden
Sie in der Datei keytool.html, die sich in der JDK-Dokumentation befindet.
³ So erstellen Sie eine SSL-Berechtigung:
[Anwendungsserver-Stammverzeichnis]/server/all/svcnative.
[JAVA_HOME]/bin/keytool -genkey -v -alias ads-credentials -keyalg RSA
-keystore "ads-ssl.jks" -validity 3650 -storepass Speicher_Kennwort
-keypass Schlüssel_Kennwort -dname "CN=Benutzer-ID, OU=Gruppenname,
O=Firmenname,L=Stadt, S=Bundesland, C=Ländercode"
Hinweis: Sie müssen [JAVA_HOME] durch das Verzeichnis ersetzen, in dem das JDK installiert ist.
Ferner müssen Sie die fett gedruckten Werte durch die für Ihre Umgebung zutreffenden
Werte ersetzen.
Die Keystore-Datei wird im Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/svcnative
erstellt.
Sie können SSL auf dem Anwendungsserver aktivieren, indem Sie die in diesem Abschnitt angegebenen
Dateien bearbeiten. Wenn SSL konfiguriert ist, müssen Sie JBoss manuell starten.
Adobe LiveCycle
³ So aktivieren Sie SSL auf JBoss:
1. Öffnen Sie die Datei jacorb.properties im Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/
all/conf in einem Texteditor und bearbeiten Sie den Abschnitt SSL Configuration, so dass er den
folgenden Text enthält:
#########################
### SSL Configuration ###
#########################
# The qualified classname of the ssl socket factory class
jacorb.ssl.socket_factory=org.jacorb.security.ssl.sun_jsse.SSLSocket
Factory
# The qualified classname of the ssl server socket factory class
jacorb.ssl.server_socket_factory=org.jacorb.security.ssl.sun_jsse.
SSLServerSocketFactory
# The name and location of the keystore. This should be absolute
# to the directory where this property file resides.
# jacorb.security.keystore=c:/jboss-3.2.5/server/all/svcnative/
ads-ssl.jks
jacorb.security.keystore=<-- Replace with absolute path of
ads-ssl.jks -->
jacorb.security.keystore_password=IhrSSLKennwort
# Trusted ca certs are also in the same keystore
jacorb.security.jsse.trustees_from_ks=on
jacorb.security.support_ssl=on
# Client side ssl supported or enforced?
jacorb.security.ssl.client.supported_options=60
jacorb.security.ssl.client.required_options=0
# Server side ssl supported or enforced?
jacorb.security.ssl.server.supported_options=60
jacorb.security.ssl.server.required_options=60
2. Speichern Sie die Datei jacorb.properties.
3. Öffnen Sie die Datei server.xml im Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/
all/deploy/jbossweb-tomcat50.sar in einem Texteditor und heben Sie die Kommentierungen für den
folgenden Abschnitt auf:

4. Ersetzen Sie den Wert des Attributs keystoreFile durch
"${jboss.server.home.dir}/svcnative/ads-ssl.jks". Dies ist der Speicherort der
Keystore-Datei.
5. Ersetzen Sie den Wert des Attributs keystorePass durch das Keystore-Kennwort, das Sie beim
Erstellen des Keystore festgelegt haben.
6. Speichern Sie die Datei server.xml.
7. Öffnen Sie die Datei iiop-service.xml im Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/
all/deploy in einem Texteditor und heben Sie die Kommentierungen für den folgenden Text auf:
78
Adobe LiveCycle
79

8. Legen Sie die Werte für die Attribute KeyStoreURL und KeyStorePass Ihrer Konfiguration
entsprechend fest:
<attribute name="KeyStoreURL">
[Anwendungsserver-Stammverzeichnis]/server/all/svcnative/ads-ssl.jks
</attribute>
<attribute name="KeyStorePass">
keystore password
</attribute>
9. Heben Sie die Kommentierungen im Abschnitt CORBA ORB service auf:

10. Speichern Sie die Datei iiop-service.xml.
12. Greifen Sie mit SSL auf Administrator zu, indem Sie die folgende URL in einem Webbrowser eingeben:
https://[Hostname]:[Anschluss]/adminui
Nächster Schritt
Wenn Sie LiveCycle Workflow Business Activity Monitor installieren, können Sie jetzt einen
Anwendungsserver konfigurieren, der als Host für BAM Server dient. (Siehe „Manuelles Konfigurieren von
JBoss für BAM Server“ auf Seite 80.) Sie können außerdem LiveCycle Workflow Designer installieren. (Siehe
„Installieren von LiveCycle Workflow Designer“ auf Seite 101.)
12
Manuelles Konfigurieren von JBoss für BAM Server
Der Inhalt dieses Kapitels findet auf LiveCycle Workflow-Lizenzen Anwendung, die nur die Verwendung
von Business Activity Monitor gestatten.
In diesem Kapitel wird die Erstellung der Metadaten-Datenbank für LiveCycle Workflow Business Activity
Monitor (BAM) und die Konfiguration des JBoss-Anwendungsservers für BAM Server beschrieben. Hierbei
handelt es sich um eine Komponente von LiveCycle Workflow.
Bei der Installation der Produkte mit der Turnkey-Methode werden JBoss und MySQL automatisch
installiert und konfiguriert. Sie müssen die in diesem Kapitel beschriebenen Verfahren nicht durchführen.
In diesem Kapitel wird das Basisverzeichnis der JBoss-Instanz, die Sie für BAM Server konfiguriert haben,
als [JBoss-BAM-Stammverzeichnis] bezeichnet. (Siehe „Konventionen in diesem Handbuch“ auf Seite 8.)
In diesem Kapitel wird davon ausgegangen, dass die LiveCycle-Datenbank bereits konfiguriert ist. Ist dies
nicht der Fall, finden Sie Informationen unter „Vorbereiten der Umgebung“ auf Seite 44.
Installieren von JBoss Application Server
Wenn Sie JBoss manuell zum Ausführen von BAM Server konfigurieren, müssen Sie JBoss Application
Server 3.2.6 herunterladen und installieren. JBoss kann von der folgenden Website heruntergeladen werden:
http://labs.jboss.com/portal/jbossas/download
Erstellen der BAM-Metadaten-Datenbank
Sie müssen eine Metadaten-Datenbank für LiveCycle Workflow Business Activity Monitor 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 Monitor-Metadaten sehr umfangreich werden können, müssen Sie der BAMMetadaten-Datenbank mindestens 50 MB Speicherplatz zuweisen. Bei Bereitstellungen in einer
Produktionsumgebung sollten Sie mindestens 200 MB zuweisen.
Bei einigen Aspekten der Konfiguration der BAM-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
Monitor-Metadaten gespeichert werden.
Benutzerkonten
Sie müssen außerdem ein Benutzerkonto einrichten, mit dem BAM Server eine Verbindung zur
BAM-Metadaten-Datenbank herstellen kann. Das Benutzerkonto muss über Berechtigungen zum
Erstellen, Bearbeiten und Aktualisieren der Datenbank verfügen.
Bei Oracle muss das Datenbank-Benutzerkonto mit einem Tablespace verknüpft werden, den Sie speziell
für Business Activity Monitor-Metadaten erstellen.
80
Adobe LiveCycle
Konfigurieren von JBoss für BAM Server
81
Konfigurieren von JBoss für BAM Server
Wenn Sie LiveCycle Workflow installieren und manuell auf JBoss bereitstellen, müssen Sie JBoss manuell
installieren und konfigurieren, damit BAM Server ordnungsgemäß ausgeführt wird.
BAM Server darf nicht auf derselben JBoss-Instanz wie LiveCycle Workflow Server bereitgestellt werden.
Sie müssen die folgenden Bereiche auf der JBoss-Instanz konfigurieren, auf der BAM Server ausgeführt
wird:
O
Installieren Sie die Datenbanktreiber, die JBoss für die Kommunikation mit der BAM-MetadatenDatenbank und der LiveCycle-Datenbank benötigt. (Siehe „Installieren der Datenbanktreiber auf JBoss
für BAM Server“ auf Seite 81.)
O
Erstellen Sie eine Datenquelldatei, damit BAM Server eine Verbindung zur BAM-Metadaten-Datenbank
herstellen kann. (Siehe „Herstellen einer Verbindung zwischen JBoss und der
BAM-Metadaten-Datenbank“ auf Seite 81.)
O
Erstellen Sie eine Datenquelldatei, damit BAM Server eine Verbindung zur LiveCycle-Datenbank
herstellen kann. (Siehe „Herstellen einer Verbindung zwischen JBoss für BAM Server und der
LiveCycle-Datenbank“ auf Seite 83.)
O
Konfigurieren Sie die JVM (Java Virtual Machine), auf der der JBoss-Anwendungsserver ausgeführt
wird. (Siehe „Konfigurieren erforderlicher JVM-Optionen für JBoss“ auf Seite 86.)
O
Ändern Sie die Threadkonfiguration auf JBoss. (Siehe „Ändern der JBoss-Threadkonfiguration“ auf
Seite 88.)
O
Konfigurieren Sie JBoss, so dass Business Activity Monitor-Ereignisse nicht mehrmals in
JBoss-Protokollen erfasst werden. (Siehe „Konfigurieren der JBoss-Protokollierung“ auf Seite 89.)
O
Ändern Sie JBoss-Anschlüsse, um Konflikte mit anderen Anwendungen zu vermeiden, die auf
demselben Computer ausgeführt werden. (Siehe „Anpassen der Anschlussnummern“ auf Seite 89.)
Installieren der Datenbanktreiber auf JBoss für BAM Server
Damit BAM Server eine Verbindung zur BAM-Metadaten-Datenbank und LiveCycle-Datenbank herstellen
kann, müssen Sie die Treiber für die verwendeten Datenbanktypen installieren.
³ So installieren Sie den JDBC-Treiber für SQL Server:
O
Kopieren Sie die Datenbanktreiberdateien für SQL Server 2000 (msbase.jar, mssqlserver.jar, msutil.jar)
in das Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/lib.
Hinweis: LiveCycle und BAM Server werden in völlig verschiedenen JBoss-Strukturen ausgeführt, d. h.
dass in beiden Strukturen Treiber erforderlich sind. Daher müssen Sie diese Treiber für BAM
Server erneut installieren. (Siehe „So können Sie sich den JDBC-Treiber für SQL Server
besorgen und kopieren:“ auf Seite 65.)
Herstellen einer Verbindung zwischen JBoss und der
BAM-Metadaten-Datenbank
Sie müssen eine Verbindung zur BAM-Metadaten-Datenbank auf der JBoss-Instanz konfigurieren, auf der
BAM Server ausgeführt wird, damit der Server Informationen über die von ihm überwachte Prozessmetrik
abrufen kann.
Adobe LiveCycle
Herstellen einer Verbindung zwischen JBoss und der BAM-Metadaten-Datenbank
82
Wie Sie die von Ihnen verwendete Verbindung konfigurieren, hängt vom Typ der Datenbank ab, die Sie
zum Speichern von Business Activity Monitor-Metadaten verwenden:
O
„Herstellen einer Verbindung zur BAM-Metadaten-Datenbank auf SQL Server“ auf Seite 82
Herstellen einer Verbindung zur BAM-Metadaten-Datenbank auf SQL Server
Damit BAM Server eine Verbindung zur SQL Server-Datenbank herstellen kann, in der die Business Activity
Monitor-Metadaten gespeichert werden, müssen Sie eine Datenquelldatei erstellen und auf der JBossInstanz bereitstellen, auf der BAM Server ausgeführt wird. Darüber hinaus müssen Sie die
standardmäßigen Datentypzuordnungen auf JBoss ändern.
³ So erstellen Sie eine Datenquelle für die BAM-Metadaten-Datenbank auf SQL Server:
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.metadata.metaDatasource</jndi-name>
<connection-url></connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class>
<track-statements>false</track-statements>
<application-managed-security/>
</no-tx-datasource>
</datasources>
2. Ersetzen Sie  im Element connection-url durch den folgenden Text:
jdbc:microsoft:sqlserver://[Hostname]:[Anschluss];SelectMethod=cursor;
databaseName=[Datenbankname];user=[Benutzername];password=[Datenbankkenn
wort]
O
[Hostname]: Der Name des Computers, auf dem SQL Server 2000 ausgeführt wird.
O
[Anschluss]: Der Anschluss, der für den Zugriff auf den Datenbankdienst verwendet wird. Der
Standardanschluss für SQL Server 2000 ist 1433.
O
[Datenbankname]: Der Name der BAM-Metadaten-Datenbank.
O
[Benutzername]: Der Name des Datenbank-Benutzerkontos, das auf die BAM-MetadatenDatenbank zugreifen kann.
O
[Datenbankkennwort]: Das Kennwort für den Benutzernamen, der für [Benutzername]
festgelegt wurde.
3. Speichern Sie die Datei im Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/deploy unter dem
Namen celequest_metadata-ds.xml.
³ So ändern Sie die Datentypzuordnungen für SQL Server auf JBoss:
1. Wechseln Sie zum Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/conf und öffnen Sie die
Datei standardjbosscmp-jdbc.xml in einem Texteditor.
2. Ändern Sie im Abschnitt <defaults> im oberen Bereich der Datei die folgenden Parameter, wie
durch den fett hervorgehobenen Text angegeben:
Adobe LiveCycle
Herstellen einer Verbindung zwischen JBoss für BAM Server und der LiveCycle-Datenbank
83
<datasource>java:/com.celequest.metadata.metaDatasource</datasource>
<datasource-mapping>MS SQLSERVER2000</datasource-mapping>
<create-table>false</create-table>
...
<list-cache-max>10000</list-cache-max>
3. Suchen Sie das Element type-mappings mit dem untergeordneten Element name, das den Text
MS SQLSERVER2000 enthält, und fügen Sie unterhalb des letzten Elements function-mapping
den folgenden Code ein:
<mapping>
<java-type>com.celequest.metadata.ejb.BigString</java-type>
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>IMAGE</sql-type>
</mapping>
<mapping>
<java-type>com.celequest.jar.Jar</java-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertFiring</java-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertAck</java-type>
</mapping>
<mapping>
<java-type>com.celequest.alert.AlertInstance</java-type>
</mapping>
<mapping>
<java-type>com.celequest.util.misc.SerializableWrapper</java-type>
</mapping>
Herstellen einer Verbindung zwischen JBoss für BAM Server und der
LiveCycle-Datenbank
Sie müssen eine Verbindung zur LiveCycle-Datenbank auf der JBoss-Instanz 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-Daten verwenden:
O
„Herstellen einer Verbindung zur LiveCycle-Datenbank auf SQL Server“ auf Seite 84
Adobe LiveCycle
O
84
„Herstellen einer Verbindung zur LiveCycle-Datenbank auf MySQL“ auf Seite 85
Herstellen einer Verbindung zur LiveCycle-Datenbank auf SQL Server
Damit BAM Server eine Verbindung zur LiveCycle-Datenbank herstellen kann, müssen Sie eine
Datenquelldatei erstellen und diese auf der JBoss-Instanz bereitstellen, auf der BAM Server ausgeführt
wird.
³ So erstellen Sie eine Datenquelle für die LiveCycle-Datenbank auf SQL Server 2000:
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.adobe</jndi-name>
<connection-url></connection-url>
<driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver
</driver-class>

<user-name></user-name>
<password></password>
</no-tx-datasource>
</datasources>
jdbc:microsoft:sqlserver://[Hostname]:[Anschluss];SelectMethod=cursor;
databaseName=[Datenbankname];user=[Datenbankbenutzer];password=[Datenban
kkennwort]
O
[Hostname]: Der Name des Computers, auf dem SQL Server 2000 ausgeführt wird.
O
[Anschluss]: Der Anschluss, der für den Zugriff auf die LiveCycle-Datenbank verwendet wird.
Der Standardanschluss für SQL Server 2000 ist 1433.
O
[Datenbankname]: Der Name der LiveCycle-Datenbank.
O
[Datenbankbenutzer]: Der Name des Datenbank-Benutzerkontos, das auf die
LiveCycle-Datenbank zugreifen kann.
O
[Datenbankkennwort]: Das Kennwort für den Benutzernamen, der für
[Datenbankbenutzer] festgelegt wurde.
3. Ersetzen Sie  im Element <user-name> durch den
Benutzernamen des Datenbank-Benutzerkontos, das auf die LiveCycle-Datenbank zugreifen kann.
4. Ersetzen Sie  im Element <password> durch das Kennwort für den
Benutzernamen, der für das Element <user-name> angegeben wurde.
5. Speichern Sie die Datei im Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/deploy/ unter
Adobe LiveCycle
85
Herstellen einer Verbindung zur LiveCycle-Datenbank auf MySQL
Damit BAM Server eine Verbindung zur LiveCycle-Datenbank herstellen kann, müssen Sie eine
Datenquelldatei erstellen und diese auf der JBoss-Instanz bereitstellen, auf der BAM Server ausgeführt
wird.
³ So installieren Sie den JDBC-Treiber für MySQL:
1. Laden Sie von der MySQL-Website unter http://www.mysql.com/products/connector/j/ die Datei
mysql-connector-java-3.0.15-ga-bin-jar herunter.
2. Kopieren Sie die Datei in das Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/lib.
³ So erstellen Sie eine Datenquelle für die LiveCycle-Datenbank auf MySQL:
<datasources>
<no-tx-datasource>
<jndi-name>com.celequest.adobe</jndi-name>
<connection-url><![CDATA[]]>
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>

<user-name></user-name>
<password></password>
</no-tx-datasource>
</datasources>
jdbc:mysql://[Hostname]/[Datenbankname]?user=[Datenbank-Benutzername]&p
assword=
[Datenbankkennwort]&autoReconnect=true&autoReconnectForPools=true
O
[Hostname]: Der Name des Computers, auf dem MySQL ausgeführt wird.
O
[Datenbankname]: Der Name der LiveCycle-Datenbank.
O
[Datenbank-Benutzername]: Der Name des Datenbank-Benutzerkontos, das auf die
LiveCycle-Datenbank zugreifen kann.
O
[Datenbankkennwort]: Das Kennwort für den Benutzernamen, der für
[Datenbank-Benutzername] festgelegt wurde.
3. Ersetzen Sie  im Element <user-name> durch den
Benutzernamen des Datenbank-Benutzerkontos, das auf die LiveCycle-Datenbank zugreifen kann.
4. Ersetzen Sie  im Element <password> durch das Kennwort für den
Benutzernamen, der für das Element <user-name> angegeben wurde.
Adobe LiveCycle
Konfigurieren erforderlicher JVM-Optionen für JBoss
86
5. 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
Sie müssen die JVM (Java Virtual Machine) zur Unterstützung von BAM Server konfigurieren.
³ So konfigurieren Sie die JVM-Optionen für JBoss:
1. Wechseln Sie zum Verzeichnis [JBoss-BAM-Stammverzeichnis]/bin und öffnen Sie das Startskript in
einem Texteditor:
O
(Windows) run.bat
O
(Linux) run.sh
2. Ändern Sie die Speichereinstellungen für JAVA_OPTS auf ein Minimum von 128 MB und ein Maximum
von 768 MB. Fügen Sie außerdem -server ein, um die Leistung zu steigern:
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -server -Xms128m -Xmx768m
O
(Linux) JAVA_OPTS="$JAVA_OPTS -server -Xms128m -Xmx768m"
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 doppelte Protokollierung der Systemausgabe
zu deaktivieren. Dies ist eine vorläufige Lösung für JBoss-Fehler 877974:
O
Windows:
set JAVA_OPTS=%JAVA_OPTS%
-Dorg.jboss.logging.Log4jService.catchSystemOut=false
-Dorg.jboss.logging.Log4jService.catchSystemErr=false
O
Linux:
JAVA_OPTS="$JAVA_OPTS
-Dorg.jboss.logging.Log4jService.catchSystemOut=false
-Dorg.jboss.logging.Log4jService.catchSystemErr=false"
4. Fügen Sie eine Einstellung für JAVA_OPTS hinzu, um die Unterstützung von UTF-8-Zeichen zu
aktivieren:
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=utf8
O
(Linux) JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8”
5. Fügen Sie eine Einstellung für JAVA_OPTS hinzu, um die Threadstapelgröße auf 300 zu erhöhen:
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% -XX:ThreadStackSize=300
O
(Linux) JAVA_OPTS="$JAVA_OPTS -XX:ThreadStackSize=300”
6. (Optional) Fügen Sie eine Einstellung für JAVA_OPTS hinzu, um optionale JVM-Optionen
hinzuzufügen:
O
(Windows) set JAVA_OPTS=%JAVA_OPTS% [JVM-Optionen]
Adobe LiveCycle
O
Optionale JVM-Optionen für JBoss
(Linux) JAVA_OPTS="$JAVA_OPTS [JVM-Optionen]
[JVM-Optionen] sind die Optionen, die Sie hinzufügen möchten, und weisen das folgende
Format auf:
-Dcom.celequest.property.[PARAMETER]=[WERT]
Informationen zu diesen Optionen finden Sie unter „Optionale JVM-Optionen für JBoss“ auf Seite 87.
7. Speichern und schließen Sie die Startskriptdatei.
Optionale JVM-Optionen für JBoss
Sie können mehrere optionale JVM-Parameter festlegen, die mit der BAM-Metadaten-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]
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
Diese Option gibt an, ob bei Zeichenfolgenvergleichen das Gebietsschema
berücksichtigt wird. Die gültigen Werte sind true und false:
O
Geben Sie true an, wenn das Gebietsschema bei Zeichenfolgenvergleichen
berücksichtigt werden soll.
O
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
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.
87
Adobe LiveCycle
Ändern der JBoss-Threadkonfiguration
Parameter
Beschreibung
DECOMPOSITION
Die Art und Weise der Sortierungsauflösung. Die gültigen Werte sind none,
canonical und full. Der Standardwert ist canonical.
88
Weitere Informationen zu Sortierungsparametern finden Sie in der Sun
Java-Dokumentation unter
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
Ändern der JBoss-Threadkonfiguration
Bevor Sie BAM Server auf JBoss bereitstellen, müssen Sie die Threadkonfiguration in der JBoss-Datei
server.xml ändern.
³ So ändern Sie die Threadkonfiguration:
1. Wechseln Sie zum Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/deploy/
jbossweb-tomcat50.sar und öffnen Sie die Datei server.xml.
2. Suchen Sie die Überschrift .
Hinweis: Wenn Sie die Turnkey-Installation ausführen und den JBoss-Thread ändern, könnte die
Anschlussnummer 9080 lauten.
3. Ändern Sie die Werte im Element Connector für den HTTP-Anschluss, so dass sie mit dem fett
gedruckten Text im folgenden XML-Code übereinstimmen:
4. (Optional) Fügen Sie die Attribute compression und socketBuffer demselben Element
Connector hinzu, um die Gesamtleistung von Business Activity Monitor zu steigern, wie der fett
gedruckte Text im folgenden Beispiel zeigt:
connectionTimeout="20000" disableUploadTimeout="true"
compression="on" socketBuffer="1045576" />
5. Speichern und schließen Sie die Datei server.xml.
Adobe LiveCycle
Konfigurieren der JBoss-Protokollierung
89
Konfigurieren der JBoss-Protokollierung
An die Business Activity Monitor-Protokolle gesendete Meldungen werden gegebenenfalls auch in der
JBoss-Datei server.log aufgezeichnet. Standardmäßig protokolliert JBoss zusätzlich zu den eigenen
Meldungen und den Meldung anderer Anwendungen, für die JBoss als Host dient, auch alle von BAM
Server veröffentlichten Meldungen. Sie können die JBoss-Datei log4j.xml bearbeiten, um zu verhindern,
dass Business Activity Monitor-Meldungen in der JBoss-Protokolldatei aufgezeichnet werden.
Vorsicht: Führen Sie dieses Verfahren nicht durch, wenn JBoss ausgeführt wird. Andernfalls erfasst JBoss
sämtliche Meldungen sowohl in der Konsole als auch in der Protokolldatei.
Hinweis: Business Activity Monitor-Server veröffentlichen standardmäßig Meldungen, die mindestens
den Schweregrad Info aufweisen. Über die Verwaltungskonsole von BAM Workbench können
Sie ändern, welche Meldungen die Server veröffentlichen.
³ So verhindern Sie, dass JBoss Meldungen von Business Activity Monitor aufzeichnet:
1. Beenden Sie JBoss.
2. Öffnen Sie im Verzeichnis [JBoss-BAM-Stammverzeichnis]/default/conf/ die Datei log4j.xml in einem
Texteditor.
3. Suchen Sie den folgenden XML-Code:
<root>
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</root>
4. Löschen Sie das Element appender-ref mit dem Attribut ref des Werts FILE. Das Element root
sollte nun wie im folgenden XML-Code aussehen:
<root>
<appender-ref ref="CONSOLE"/>
</root>
5. Suchen Sie in der Datei den Abschnitt Categories und fügen Sie das folgende Element category
hinzu, damit JBoss alle Meldungen der Kategorie org an die Konsole sendet (z. B. die von JBoss
veröffentlichten Meldungen) und Meldungen der Kategorie com (z. B. com.celequest) nicht in der
Protokolldatei erfasst:
<category name="org">
<appender-ref ref="FILE"/>
</category>
6. Speichern Sie die Datei log4j.xml und starten Sie JBoss neu.
Anpassen der Anschlussnummern
Sie müssen die von JBoss verwendeten Anschlüsse ändern, damit keine Konflikte mit den von anderen
Anwendungen auf dem Hostcomputer verwendeten Anschlüssen auftreten, z. B. der JBoss-Instanz, auf der
LiveCycle Workflow Server ausgeführt wird.
Adobe LiveCycle
Anpassen der Anschlussnummern
90
³ So ändern Sie die Anschlüsse:
jbossweb-tomcat50.sar und öffnen Sie die Datei server-xml in einem Texteditor.
2. Ändern Sie die Einstellungen für den HTTP-Anschluss und den Umleitungsanschluss, die sich im Block
HTTP/1.1 Connector befinden:
3. Ändern Sie die Einstellungen für den AJP-Anschluss und den Umleitungsanschluss:

enableLookups="false" redirectPort="18443" debug="0"
protocol="AJP/1.3"/>
4. Ändern Sie die SSL/TSL-Anschlusseinstellung:

5. Speichern und schließen Sie die Datei server.xml.
http-invoker.sar/META-INF und öffnen Sie die Datei jboss-service.xml in einem Texteditor.
7. Aktualisieren Sie alle Vorkommnisse des Attributs InvokerURLSuffix:
<attribute name="InvokerURLSuffix">:9080/invoker/...
8. Speichern und schließen Sie die Datei jboss-service.xml.
9. Wechseln Sie zum Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/conf und öffnen Sie die
Datei jboss-service.xml.
10. Ändern Sie im Abschnitt Class Loading im Element <mbean
code="org.jboss.web.WebService" name="jboss:service=WebService"> den
Anschluss in 18083:
<attribute name="Port">18083</attribute>
11. Ändern Sie im Abschnitt JNDI im Element <mbean
code="org.jboss.naming.NamingService" name="jboss:service=Naming"
xmbeandd="resource:xmdesc/NamingService-xmbean.xml"> den Anschluss in 11099:
<attribute name="Port">11099</attribute>
12. Ändern Sie den RMI-Anschluss in 11098:
<attribute name="RmiPort">11098</attribute>
Adobe LiveCycle
Bereitstellen von BAM Server
91
13. Ändern Sie im Abschnitt Invokers to the JMX node im Element <mbean
code="org.jboss.invocation.pooled.server.PooledInvoker"
name="jboss:service=invoker,type=pooled"> den Wert für RMIObjectPort in 14444:
<attribute name="RMIObjectPort">14444</attribute>
14. Ändern Sie den Wert für ServerBindPort in 14445:
<attribute name="ServerBindPort">14445</attribute>
15. Speichern und schließen Sie die Datei jboss-service.xml.
16. Wechseln Sie zum Verzeichnis [JBoss-BAM-Stammverzeichnis]/server/default/deploy/jms und öffnen Sie
die Datei uil2-service.xml in einem Texteditor.
17. Ändern Sie im Element <mbean code="org.jboss.mq.il.uil2.UILServerILService"
name="jboss.mq:service=InvocationLayer,type=UIL2"> den Wert für ServerBindPort
in 18093:
<attribute name="ServerBindPort">18093</attribute>
18. Speichern und schließen Sie die Datei uil2-service.xml.
Bereitstellen von BAM Server
Sie stellen BAM Server auf JBoss bereit, indem Sie die Datei CAS_Adobe.ear auf die JBoss-Instanz kopieren,
die Sie für BAM Server konfiguriert haben, und die Datei CQIntegration.ear auf die JBoss-Instanz, die Sie für
LiveCycle Workflow Server konfiguriert haben. JBoss 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 BAM Server auf JBoss bereit:
1. Kopieren Sie die Datei CAS_Adobe.ear aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/configurationManager/working/bam/common in das Verzeichnis
[JBoss-BAM-Stammverzeichnis]/server/default/deploy.
2. Starten Sie die für BAM Server konfigurierte JBoss-Instanz neu.
3. Kopieren Sie die Datei CQIntegration.ear aus dem Verzeichnis
[LiveCycle-Stammverzeichnis]/configurationManager/working/bam/common in das Verzeichnis
4. Starten Sie die für LiveCycle Workflow Server konfigurierte JBoss-Instanz neu.
Nächster Schritt
Sie müssen jetzt mit Business Activity Monitor in Verbindung stehende Eigenschaften auf LiveCycle
Workflow Server und BAM Server konfigurieren. (Siehe „Erste Schritte mit BAM Server“ auf Seite 93.)
Teil IV: Zusätzliche Konfigurationsschritte für LiveCycle Workflow
In diesem Abschnitt des Handbuchs werden die für LiveCycle Workflow-Installationen zusätzlich
erforderlichen Konfigurationsschritte beschrieben.
92
13
Erste Schritte mit BAM Server
In diesem Kapitel wird die anfängliche Konfiguration von LiveCycle Workflow Server zur Überwachung der
Prozessaktivität von BAM Server beschrieben. Sie müssen sowohl auf LiveCycle Workflow Server als auch
auf BAM Server verschiedene Einstellungen vornehmen:
O
„Konfigurieren von LiveCycle Workflow Server für BAM Server“ auf Seite 93
O
„Konfigurieren von BAM Server“ auf Seite 94
Konfigurieren von LiveCycle Workflow Server für BAM Server
Sie können LiveCycle Workflow Server mithilfe von Administrator so konfigurieren, dass eine Verbindung
zu BAM Server hergestellt wird. Dazu müssen Sie den Server angeben, auf dem BAM Server ausgeführt
wird, sowie die Informationen des Benutzerkontos, über das der Zugriff auf BAM Server erfolgt.
³ So konfigurieren Sie LiveCycle Workflow Server für BAM Server:
1. Melden Sie sich bei Administrator an. (Siehe „Zugreifen auf Administrator“ auf Seite 27.)
2. Klicken Sie auf Dienste und dann auf Adobe LiveCycle Workflow.
3. Klicken Sie auf Servereinstellungen und dann auf BAM-Konfigurationseinstellungen.
4. Geben Sie Werte für die folgenden Eigenschaften an:
O
Host: Der Hostname oder die IP-Adresse des Servers, auf dem BAM Server ausgeführt wird. Der
Standardwert ist localhost.
O
Anschluss: Der Dienstanschluss des Anwendungsservers, auf dem BAM Server ausgeführt wird. Der
Standardwert ist der Standardanschluss des Anwendungsservers, für den LiveCycle Workflow
installiert wurde.
O
Benutzername: (Optional) Der Benutzername des Administratorkontos, über das LiveCycle
Workflow Server 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.
Informationen zum Verwalten von BAM-Benutzerkonten finden Sie in der BAM
Workbench-Hilfe oder im Handbuch Using LiveCycle Workflow Workbench.
O
Kennwort: (Optional) Ein gültiges Kennwort für den oben angegebenen Benutzernamen. Das
Standardkennwort ist manager.
5. Klicken Sie auf Speichern und starten Sie die Datei LiveCycle.ear erneut.
Zugreifen auf BAM Workbench und BAM Dashboard
Nachdem BAM Server bereitgestellt wurde und auf dem Anwendungsserver ausgeführt wird, können Sie
über einen Webbrowser auf BAM Workbench und Business Activity Monitor (BAM) Dashboard zugreifen.In
BAM Workbench stehen Tools zum Verwalten von BAM Server und zum Einrichten von Berichten zur
Verfügung, die Benutzer in BAM Dashboard anzeigen können.
93
Adobe LiveCycle
Konfigurieren von BAM Server
94
Für die Anmeldung bei den Business Activity Monitor-Seiten sind ein Benutzername und ein Kennwort
erforderlich. Wenn Sie BAM Server bereitstellen, wird ein Standardkonto für Verwaltungsaufgaben
angelegt. Der Benutzername dieses Kontos lautet system und das Kennwort manager.
Tipp: Nach Wunsch können Sie einen anderen Benutzer für Verwaltungszwecke erstellen oder den
vorhandenen Benutzer mit BAM Workbench ändern. Wenn Sie den vorhandenen Benutzer ändern,
müssen Sie auch die entsprechenden Eigenschaften auf LiveCycle Workflow Server bearbeiten.
(Siehe „Konfigurieren von LiveCycle Workflow Server für BAM Server“ auf Seite 93.)
Weitere Informationen zum Verwenden der Tools des Administrations-Frameworks erhalten Sie, wenn Sie
sich bei BAM Workbench anmelden und die Hilfe aufrufen.
³ So greifen Sie auf BAM Workbench zu:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/celequest/workbench eingeben.
2. Geben Sie in das Feld Benutzername einen gültigen Benutzernamen und in das Feld Kennwort das
entsprechende Kennwort ein. Sie können den Standardbenutzernamen system und das
Standardkennwort manager verwenden.
³ So greifen Sie auf BAM Dashboard zu:
1. Starten Sie BAM Dashboard, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/celequest/dashboard eingeben.
2. Geben Sie in das Feld Benutzername einen gültigen Benutzernamen und in das Feld Kennwort das
entsprechende Kennwort ein. Sie können den Standardbenutzernamen system und das
Konfigurieren von BAM Server
Sie können BAM Server mit BAM Workbench zum Überwachen von LiveCycle Workflow-Prozessen
konfigurieren. (Siehe „Zugreifen auf BAM Workbench und BAM Dashboard“ auf Seite 93.)
Führen Sie mit BAM Workbenchdie folgenden Aufgaben durch:
O
Konfigurieren Sie die SMTP-Servereinstellungen zum Senden von E-Mails.
O
Importieren Sie die zur Überwachung von LiveCycle Workflow-Prozessen verwendeten
Metadaten-Definitionen.
O
Konfigurieren Sie die LDAP-Einstellungen für BAM Server.
Konfigurieren der SMTP-Einstellungen
BAM Server sendet E-Mail-Nachrichten über einen SMTP-Server an Benutzer von Business Activity Monitor.
Sie müssen den Server angeben, auf dem der SMTP-Server ausgeführt wird, und die Informationen des
Benutzerkontos, über das BAM Server auf den SMTP-Server zugreifen kann.
³ So konfigurieren Sie die SMTP-Einstellungen:
1. Vergewissern Sie sich, dass LiveCycle Workflow Server und die BAM Server-Anwendungen gestartet
wurden.
Adobe LiveCycle
Importieren der Metadaten-Definitionen für LiveCycle Workflow
95
2. Vergewissern Sie sich, dass die BAM-Metadaten-Datenbank gestartet wurde.
4. Melden Sie sich mit dem Benutzernamen und dem Kennwort an, die für die Verwaltung von Business
Activity Monitor festgelegt wurden. Sie können den Standardbenutzernamen system und das
5. Wenn Sie sich zum ersten Mal bei BAM Workbench anmelden, wird das Dialogfeld First Time Setup
angezeigt. Klicken Sie in diesem Dialogfeld auf Open System Settings und dann auf die Registerkarte
SMTP Configuration.
O
SMTP Host: Der Netzwerkname oder die IP-Adresse des SMTP-Servers, den BAM Server zum
Senden von E-Mail-Nachrichten verwendet.
O
SMTP From Address: Die E-Mail-Adresse, die BAM Server zum Empfangen von E-Mail-Nachrichten
verwendet.
O
SMTP User: Der Benutzername des von BAM Server verwendeten E-Mail-Kontos.
O
SMTP Password: Das Kennwort für den SMTP-Benutzer.
7. Klicken Sie auf die Registerkarte Checkpoint Configuration und geben Sie in das Feld Recovery Log
Directory den Pfad des Wiederherstellungsprotokoll-Verzeichnisses ein.
8. Klicken Sie auf die Registerkarte Logging und geben Sie in das Feld Logging Directory den Pfad des
Protokollierungsverzeichnisses ein.
Importieren der Metadaten-Definitionen für LiveCycle Workflow
Sie müssen Metadaten-Definitionen für LiveCycle Workflow importieren, um die von BAM Server
überwachte Prozessmetrik zu konfigurieren.
³ So importieren Sie Metadaten-Definitionen für LiveCycle Workflow:
1. Vergewissern Sie sich, dass LiveCycle Workflow Server und die BAM Server-Anwendungen ausgeführt
werden.
2. Vergewissern Sie sich, dass die BAM-Metadaten-Datenbank gestartet wurde.
4. Klicken Sie auf die Registerkarte Administration Console und dann auf Import/Export.
5. Wählen Sie Import Metadata from a JAR file (upload) und geben Sie den vollständigen Pfad zum
Speicherort der Metadaten-Vorlage für LiveCycle Workflow BAM an, die für den Typ der von Ihnen
verwendeten LiveCycle-Datenbank geeignet ist:
O
(SQL Server) adobeimport_SQLServer.jar
Adobe LiveCycle
O
Konfigurieren von LDAP-Einstellungen für BAM Server
96
(MySQL) adobeimport_MySQL.jar
Diese Dateien werden im Verzeichnis [LiveCycle-Stammverzeichnis]/Workflow/bam/BAMAppTemplate
installiert.
Mit Business Activity Monitor 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-Metadaten-Datenbank zwischengespeichert.
Wenn BAM Server Benutzer vom LDAP-Server importiert, werden LDAP-Gruppen in Business Activity
Monitor-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 96.
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:
O
Sie können nur jeweils eine Verbindung zu einem LDAP-Server konfigurieren.
O
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 99.)
O
Wenn BAM Server einen Benutzer importiert und dieser Benutzer einer Gruppe angehört, für die es
keine entsprechende Business Activity Monitor-Rolle gibt, wird der Benutzer zwar erstellt, jedoch
werden ihm keine Rollen zugewiesen.
O
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.
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:
O
Wenn die Verbindung zum LDAP-Server nicht sicher ist, verwenden Sie SSL.
O
Für die Authentifizierung sollten Sie SASL (Simple Authentication and Security Layer) verwenden. Diese
Methode wird von LDAP unterstützt.
Adobe LiveCycle
O
97
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 97.
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-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:
2. Klicken Sie auf die Registerkarte Administration Console und dann auf System Settings.
3. Klicken Sie auf die Registerkarte LDAP Synchronization.
4. Wählen Sie die Option LDAP Enabled, sofern sie noch nicht ausgewählt ist.
O
Initial Context Factory: 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.
O
LDAP Server: Der DNS-Name oder die IP-Adresse des LDAP-Servers.
O
LDAP Port: 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.
O
LDAP SSL: Wählen Sie diese Option, wenn der LDAP-Server zur Verwendung von SSL konfiguriert
ist. Die Auswahl dieser Option kann sich auf die Einstellung des LDAP-Anschlusses auswirken.
O
LDAP Authentication: Die vom LDAP-Server verwendete Authentifizierungsmethode. Wählen Sie
eine der folgenden Optionen:
O
Simple
O
SASL (Simple Authentication and Security Layer). Wählen Sie diese Option für Sun ONE.
O
Compare Encrypted Password
Adobe LiveCycle
O
O
98
LDAP Principal DN Prefix: Bei der einfachen Authentifizierungsmethode wird der von Ihnen
angegebene Text vor dem Anmeldenamen des Benutzers eingefügt:
O
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=).
O
Bei Active Directory geben Sie keinen Wert ein.
LDAP Principal DN Suffix: Bei der einfachen Authentifizierungsmethode wird der von Ihnen
angegebene Text hinter dem Anmeldenamen des Benutzers eingefügt:
O
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. Beispiel:
,ou=Users,dc=domain,dc=name
O
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.
O
LDAP Synchronization User: 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.
O
LDAP Synchronization Password: Das Kennwort für den Benutzer, der unter LDAP
Synchronization User angegeben wurde.
6. Klicken Sie auf Test Connection. 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 Add Schedule, Edit
Schedule und Remove Schedule.
Hinweis: Die Synchronisierung sollte zu einem Zeitpunkt erfolgen, zu dem nur sehr wenige Benutzer
beim Server angemeldet sind.
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:
3. Klicken Sie auf die Registerkarte LDAP User Mapping.
4. Geben Sie Werte für die folgenden Parameter an:
Adobe LiveCycle
O
99
LDAP User Base DN: Das Stammverzeichnis der Struktur, die nach Benutzern durchsucht wird.
Beispiel:
O
(Sun ONE) OU=people,DC=your domain,DC=com
O
(Active Directory) CN=Users,DC=yourdomain,DC=com
O
LDAP User Search Filter: 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 Monitor eingerichtet sein. Mit diesem Filter könnten Sie dann gewährleisten, dass nur
Benutzer importiert werden, die dieser Gruppe angehören.
O
LDAP User LoginID: Die Anmelde-ID des angegebenen Anbieters. Dieser Wert wird in Business
Activity Monitor als Anmelde-ID des Benutzers verwendet.
O
LDAP User Full Name: Geben Sie cn ein, wenn Sie Sun ONE oder Active Directory verwenden.
O
LDAP User Description: Geben Sie description ein, wenn Sie Sun ONE oder Active Directory
verwenden.
O
LDAP User PrimaryEmail: Geben Sie userPrincipalName ein. Dies bezieht sich auf die
E-Mail-Adresse des Benutzers im LDAP-Verzeichnis.
O
LDAP User EncryptedPassword: Geben Sie das Kennwort des festgelegten Benutzers ein, falls Sie
Sun ONE oder Tivolie verwenden. Bei Active Directory muss das Feld leer bleiben.
5. Klicken Sie auf die Registerkarte LDAP Synchronization und dann auf Test Connection, um
festzustellen, ob die Benutzer erfolgreich importiert werden.
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:
3. Klicken Sie auf die Registerkarte LDAP Role Mapping.
4. Geben Sie Werte für die folgenden Parameter an:
O
O
O
LDAP Role Base DN: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp am besten
geeignet ist:
O
(Sun ONE) OU=Groups,DC=your domain,DC=com
O
(Active Directory) CN=Users,DC=yourdomain,DC=com
LDAP Role Search Filter: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp am
besten geeignet ist.
O
(Sun ONE) (&(objectclass=groupOfUniqueNames))
O
(Active Directory) (&(objectclass=group))
LDAP Role LoginID: Geben Sie cn ein, wenn Sie Sun ONE oder Active Directory verwenden.
Adobe LiveCycle
O
LDAP Role Full Name: Geben Sie displayname ein, wenn Sie Sun ONE oder Active Directory
verwenden.
O
LDAP Role Description: Geben Sie description ein, wenn Sie Sun ONE oder Active Directory
verwenden.
O
LDAP Role Member: Der Name der aus mehreren Werten bestehenden Eigenschaft, die
Rollenmitglieder enthält:
O
O
(Sun ONE) uniqueMember
O
(Active Directory) member
100
LDAP Role Member is: Wählen Sie eine der folgenden Optionen:
O
Distinguished Name: Benutzer werden über die Rollenmitgliedseigenschaften anhand von
DN identifiziert, z. B. cn=jadmin,ou=people,dc=your domain,dc=com.
O
Login identification: Benutzer werden über die Rollenmitgliedseigenschaften anhand
des Werts der Eigenschaft identifiziert, die als Anmelde-ID für Business Activity Monitor dient.
5. Klicken Sie auf die Registerkarte LDAP Synchronization und dann auf Test Connection, um
festzustellen, ob die Benutzer erfolgreich importiert werden.
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:
3. Klicken Sie auf die Registerkarte LDAP Synchronization.
4. Klicken Sie auf Synchronize Now. Die Länge der Synchronisierung ist von der jeweiligen Umgebung
abhängig. Wenn der Vorgang abgeschlossen ist, wird eine entsprechende Meldung angezeigt.
Nächste Schritte
Sie können jetzt LiveCycle Workflow Designer installieren. (Siehe „Installieren von LiveCycle Workflow
Designer“ auf Seite 101.)
14
Installieren von LiveCycle Workflow Designer
In diesem Kapitel wird die Installation von LiveCycle Workflow Designer beschrieben.
Sie müssen ein Installationsprogramm ausführen, um LiveCycle Workflow Designer zu installieren
und eine Verbindung mit LiveCycle Workflow Server zu konfigurieren. Bei der Ausführung des
Installationsprogramms müssen Sie den Namen des Servers angeben, auf dem LiveCycle Workflow Server
bereitgestellt ist.
Bevor Sie LiveCycle Workflow Designer installieren, müssen Sie J2SDK Version 1.4.2_04 oder eine spätere
Unterversion von 1.4.2 installieren (Unterversion 1.4.2_10 wird nicht unterstützt).
LiveCycle Workflow Designer wird standardmäßig am folgenden Speicherort installiert:
O
(Windows) C:\Adobe\LiveCycle\WorkflowDesigner
O
(Linux) /opt/adobe/livecycle/workflow_designer
³ So installieren Sie LiveCycle Workflow Designer:
1. Führen Sie das Installationsprogramm auf der Stammebene des Installationsmediums aus, indem Sie
den folgenden Befehl eingeben:
O
(Windows) adobe_lc_workflow_721_des.exe
O
(Linux) adobe_lc_workflow_721_des.bin
3. Lesen Sie die Lizenzvereinbarung, wählen Sie I accept the terms of the license agreement und
klicken Sie auf Next.
4. Akzeptieren Sie das Standardverzeichnis für die Installation oder klicken Sie auf Browse und wechseln
Sie zu dem Verzeichnis, in dem Sie das Produkt installieren möchten. Klicken Sie auf Next.
5. Wählen Sie JBoss als Typ des Anwendungsservers, der als Host für LiveCycle Workflow Server dient, und
klicken Sie auf Next.
6. Geben Sie in das Textfeld den Namen des Computers ein, auf dem LiveCycle Workflow Server
ausgeführt wird, und klicken Sie auf Next.
7. Überprüfen Sie die Installationsdetails und klicken Sie auf Back, um Einstellungen zu ändern, bzw. auf
Install, um fortzufahren.
8. Klicken Sie auf Finish.
101
Adobe LiveCycle
Herstellen einer Verbindung zu Anwendungsservern über nicht standardmäßige Anschlüsse
102
9. Wenn Sie LiveCycle Workflow Designer nicht auf dem Computer installieren, auf dem LiveCycle
Workflow Server bereitgestellt wurde, vergewissern Sie sich, dass die Systemuhr die korrekte Uhrzeit
anzeigt.
Falls die Systemuhr um mehr als zwei Stunden von der korrekten Uhrzeit der aktuellen Zeitzone
abweicht, kann LiveCycle Workflow Designer keine Verbindung zum Anwendungsserver herstellen. Die
Systemuhr des Anwendungsservers muss ebenfalls auf die korrekte Uhrzeit eingestellt sein.
Herstellen einer Verbindung zu Anwendungsservern über nicht
standardmäßige Anschlüsse
Die Standardkonfiguration von LiveCycle Workflow Designer stellt über standardmäßige JNDI- und
HTTP-Anschlüsse eine Verbindung zum Anwendungsserver her. Verwendet der Anwendungsserver nicht
standardmäßige Anschlussnummern, müssen Sie die Konfigurationsdatei von LiveCycle Workflow
Designer manuell ändern.
³ So ändern Sie den für JNDI- und HTTP-Verbindungen verwendeten Anschluss:
1. Öffnen Sie die Datei qlc-config.xml, die sich am folgenden Speicherort befindet, in einem Texteditor:
O
(Windows) [LiveCycle-Stammverzeichnis]/WorkflowDesigner/qlc/
O
(Linux) [LiveCycle-Stammverzeichnis]/workflow_designer/qlc/
2. Suchen Sie das Element property mit dem name-Attribut java.naming.provider.url und ändern
Sie die URL im Attribut value, so dass sie den Anschluss enthält, den Sie für JNDI-Verbindungen
verwenden.
Beispielsweise stellt das folgende Element property den Anschluss für JNDI-Verbindungen auf 1099
ein:
<property name="java.naming.provider.url" value="jnp://localhost:1099/"/>
3. Suchen Sie das Element application-services und ersetzen Sie den Wert des Attributs port
durch den Anschluss, den Ihr Anwendungsserver für HTTP-Verbindungen verwendet.
Beispielsweise stellt das folgende Element application-services den für HTTP-Verbindungen zu
verwendenden Anschluss auf 8080 ein:
<application-services host="localhost" port="8080"
context="adobe-services"/>
Deinstallieren von LiveCycle Workflow Designer
Zum Lieferumfang von LiveCycle Workflow Designer gehört ein Deinstallationsprogramm, das im Rahmen
der Installation erstellt wird. Das Deinstallationsprogramm dient zum Entfernen der Produktdateien.
³ So entfernen Sie LiveCycle Workflow Designer:
1. Starten Sie das Deinstallationsprogramm:
O
(Windows) Wechseln Sie zum Verzeichnis [LiveCycle-Stammverzeichnis]/WorkflowDesigner/_uninst/
und doppelklicken Sie auf uninstall.exe.
Adobe LiveCycle
O
Deinstallieren von LiveCycle Workflow Designer
103
(Linux) Wechseln Sie zum Verzeichnis [LiveCycle-Stammverzeichnis]/workflow_designer/_uninst/
und führen Sie uninstall.bin aus.
2. Wählen Sie bei der Aufforderung eine Sprache für das Deinstallationsprogramm und klicken Sie auf OK.
3. Klicken Sie im Begrüßungsbildschirm auf Next.
4. Überprüfen Sie die Informationen in der Zusammenfassung und klicken Sie auf Uninstall.
5. Wenn ein Dialogfeld Remove Existing File angezeigt wird, wählen Sie die Option Yes To All.
6. Klicken Sie auf Finish.
Nächste Schritte
Sie können jetzt QPACs bereitstellen. (Siehe Handbuch Erstellen von Workflows oder die LiveCycle Workflow
Designer-Hilfe.)
Wenn Sie Watched Folder und LiveCycle Assembler installiert haben, können Sie Workflows erstellen, bei
denen Watched Folder über die LiveCycle Assembler-QPACs zum Einsatz kommt. (Siehe „Aufrufen von
LiveCycle Assembler mit LiveCycle Workflow und Watched Folder“ auf Seite 108.)
A
Unterstützte Plattform- und Softwarekombinationen
In diesem Anhang werden die unterstützten Plattform- und Softwarekombinationen für
LiveCycle-Produkte aufgeführt. Eine Zusammenfassung der Plattformkombinationen finden Sie unter
„Vorbereiten der Installation“ auf Seite 11.
Hinweis: LiveCycle PDF Generator Elements und LiveCycle PDF Generator Professional können nur auf
Windows Server 2003 Enterprise Edition ausgeführt werden.
Plattform
Anwendungsserver
JDK
Datenbank
Windows
Server 2003,
Standard Edition
JBoss 3.2.5
J2SDK Version 1.4.2_04
MS SQL Server 2000 SP3
JBoss 3.2.5
MySQL 4.1
Windows
Server 2003,
Enterprise
Edition
JBoss 3.2.5
IBM DB2 8.2
(Version 8.1, Fix Pack 7)
JBoss 3.2.5
Oracle 9i
JBoss 3.2.5
Oracle 10g
IBM WebSphere® 5.1.1.5
IBM JDK, mit WebSphere
installiert
Oracle 9i
BEA WebLogic
Server® 8.1 SP5
Oracle 9i
BEA WebLogic
Server 8.1 SP5
Oracle 10g
IBM WebSphere 5.1.1.5
installiert
Oracle 10g
installiert
IBM DB2 8.2
installiert
104
Adobe LiveCycle
105
Plattform
Anwendungsserver
JDK
Datenbank
Red Hat Linux
Advanced
Server 2.1,
Update 3
JBoss 3.2.5
JBoss 3.2.5
MySQL 4.1
JBoss 3.2.5
Oracle 9i
JBoss 3.2.5
Oracle 10g
JBoss 3.2.5
IBM DB2 8.2
BEA WebLogic
Server 8.1 SP5
Oracle 9i
BEA WebLogic
Server 8.1 SP5
Oracle 10g
installiert
IBM DB2 8.2
installiert
Oracle 9i
installiert
Oracle 10g
JBoss 3.2.5
MySQL 4.1
JBoss 3.2.5
Oracle 9i
JBoss 3.2.5
Oracle 10g
JBoss 3.2.5
IBM DB2 8.2
BEA WebLogic
Server 8.1 SP5
Oracle 9i
BEA WebLogic
Server 8.1 SP5
Oracle 10g
installiert
IBM DB2 8.2
installiert
Oracle 9i
installiert
Oracle 10g
installiert
Oracle 9i
installiert
Oracle 10g
installiert
IBM DB2 8.2
Red Hat Linux
Advanced
Server 3.0
IBM AIX® 5.2
Adobe LiveCycle
106
Plattform
Anwendungsserver
JDK
Datenbank
IBM AIX 5.3
installiert
Oracle 9i
installiert
Oracle 10g
installiert
IBM DB2 8.2
BEA WebLogic
Server 8.1 SP5
Oracle 9i
BEA WebLogic
Server 8.1 SP5
Oracle 10g
installiert
IBM DB2 8.2
installiert
Oracle 9i
installiert
Oracle 10g
BEA WebLogic
Server 8.1 SP5
Oracle 9i
installiert
Oracle 9i
installiert
Oracle 10g
SUSE Linux ES 9.0 JBoss 3.2.5
JBoss 3.2.5
Oracle 9i
JBoss 3.2.5
Oracle 10g
JBoss 3.2.5
MySQL 4.1
BEA WebLogic
Server 8.1 SP5
Oracle 9i
installiert
Oracle 9i
installiert
Oracle 10g
Sun™ Solaris™ 8
Sun Solaris 9
B
Mit dem Font Manager-Modul installierte Schriften
Einige Module müssen auf Schriften zugreifen, die mit dem Font Manager-Modul installiert werden. Das
Font Manager-Modul umfasst eine Reihe von Schriften im Paket, die Sie in Ihren benutzerdefinierten
Anwendungen verwenden können.
Beim Konvertieren von nativen Dokumenten in PDF-Dokumente sowie beim Konvertieren von
PDF-Dokumenten in ein anderes Format wird das Font Manager-Modul nicht verwendet.
Sie können dem Font Manager-Modul Schriften hinzufügen. Das Modul wird später in der Datei
LiveCycle.ear gebündelt. Informationen zum Hinzufügen von eigenen Schriften finden Sie unter
„Konfigurieren von LiveCycle-Produkten für die Bereitstellung“ auf Seite 51.
Folgende Schriften werden zusammen mit dem Font Manager-Modul installiert
Adobe Serif MM
Kozuka Mincho Std Bold
Adobe Sans MM
Kozuka Mincho Std Heavy
Adobe Ming Std Light
Kozuka Mincho Pro-VI Regular
Adobe Song Std Light
Letter Gothic Std Medium
Adobe Myungjo Std Medium
Letter Gothic Std Slanted
Adobe Pi Std
Letter Gothic Std Bold
Bell Gothic Std Light
Letter Gothic Std Bold Slanted
Bell Gothic Std Bold
Minion® Pro Italic
Bell Gothic Std Black
Minion Pro Semibold
Courier Std
Minion Pro Semibold Italic
Courier Std Bold
Minion Pro Bold
Courier Std Bold Oblique
Minion Pro Bold Italic
Courier Std Oblique
Minion Pro Regular
EuroSign (TTF)
Myriad® Pro Light
Kozuka Gothic® Std Extra Light
Myriad Pro Light Italic
Kozuka Gothic Std Light
Myriad Pro Regular
Kozuka Gothic Std Regular
Myriad Pro Italic
Kozuka Gothic Std Medium
Myriad Pro Bold
Kozuka Gothic Std Bold
Myriad Pro Semibold
Kozuka Gothic Std Heavy
Myriad Pro Semibold Italic
Kozuka Gothic Pro Medium
Myriad Pro Bold Italic
Kozuka Mincho® Std Extra Light
Myriad Pro Black
Kozuka Mincho Std Light
Myriad Pro Black Italic
Kozuka Mincho Std Regular
Symbol
Kozuka Mincho Std Medium
107
C
Aufrufen von LiveCycle Assembler mit LiveCycle
Workflow und Watched Folder
In diesem Anhang wird das Aufrufen von LiveCycle Assembler über LiveCycle Workflow mit den LiveCycle
Assembler-QPACs und Watched Folder beschrieben.
In diesem Anhang wird davon ausgegangen, dass Sie LiveCycle Assembler, LiveCycle Workflow und
Watched Folder bereits installiert, konfiguriert und bereitgestellt haben.
Hinweis: Überwachte Ordner können für den Einsatz mit LiveCycle PDF Generator implementiert werden,
müssen jedoch separat konfiguriert werden. Dieses Kapitel behandelt ausschließlich den
Watched Folder-Dienst, der LiveCycle Workflow und LiveCycle Assembler integriert.
Informationen zum Einrichten überwachter Ordner für LiveCycle PDF Generator finden Sie in der
LiveCycle PDF Generator Administrator-Hilfe, die über die Webbenutzeroberfläche von LiveCycle
PDF Generator aufgerufen werden kann.
Übersicht über Aufgaben
Sie können entweder mit Watched Folder oder einer von Ihnen entwickelten Clientanwendung LiveCycle
Workflow zum Initiieren eines Workflows anweisen, der eine LiveCycle Assembler-QPAC aktiviert.
Dieser Abschnitt enthält eine Liste der Aufgaben, die Sie ausführen müssen, um einen Workflow
einzurichten, der einen von Watched Folder aufgerufenen LiveCycle Assembler-Prozess durchführt.
Ausführliche Anleitungen zu den einzelnen Aufgaben finden Sie im angegebenen Abschnitt oder
Dokument. Die Aufgaben müssen in der Reihenfolge durchgeführt werden, in der sie in der Tabelle
aufgeführt sind.
Hinweis: Führen Sie Configuration Manager erst aus, nachdem Sie alle Produktdateien installiert haben.
Schritt
Aufgabe
Siehe
1
Bereitstellen der LiveCycle Assembler-QPACs
für LiveCycle Workflow Designer
Using LiveCycle Assembler QPACs (verfügbar
auf der Installations-DVD für LiveCycle
Assembler bzw. auf der LiveCycle
Workflow-SDK-Website)
2
Erstellen und Bereitstellen eines Workflow, der
eine LiveCycle Assembler-QPAC enthält
„Bereitstellen von QPACs und Erstellen von
Workflow-Prozessen“ auf Seite 109
Erstellen von Workflows für LiveCycle
Workflow
LiveCycle Workflow Designer-Hilfe
3
Erstellen eines überwachten Ordners im
Dateisystem
„Erstellen und Konfigurieren eines
überwachten Ordners“ auf Seite 112
4
Anmelden bei Administrator und Erstellen und
Konfigurieren eines überwachten Ordners
„Erstellen und Konfigurieren eines
überwachten Ordners“ auf Seite 112
108
Adobe LiveCycle
Aufrufen von LiveCycle Assembler mit LiveCycle Workflow und Watched Folder
Bereitstellen von QPACs und Erstellen von Workflow-Prozessen
Schritt
Aufgabe
Siehe
5
Erstellen einer Datei JobConfig.xml
„Erstellen einer Datei JobConfig.xml“ auf
Seite 114
109
6
Vorbereiten der Test- oder
Produktionskomponenten, einschließlich
PDF-Eingabedateien und einer DDX-Datei
„Vorbereiten von PDF- und DDX-Dateien“
auf Seite 116
Developing Applications for LiveCycle
Assembler
Document Description XML Reference
7
Senden des LiveCycle Assembler-Auftrags zur
Verarbeitung
„Senden des LiveCycle Assembler-Auftrags
zur Verarbeitung“ auf Seite 116
Developing Custom Applications for LiveCycle
Workflow
Bereitstellen von QPACs und Erstellen von Workflow-Prozessen
Zum Erstellen von Workflows für LiveCycle Assembler stehen zwei QPACs zur Verfügung: die
Assembler-QPAC und die CreateDocumentList-QPAC. Die Assembler-QPAC wird für alle LiveCycle
Assembler-Workflows verwendet, unabhängig davon, ob der Prozess mithilfe von Watched Folder oder
einer anderen Methode initiiert wird (z. B. Clientanwendungen oder Webdienste).
In diesem Abschnitt wird beschrieben, wie Sie einen Workflow-Prozess erstellen, der die Assembler-QPAC
verwendet. Dabei erfahren Sie unter anderem, wie Sie die erforderlichen Variablen und Aktionseigenschaften in LiveCycle Workflow Designer erstellen. Informationen zum Erstellen eines Workflow-Prozesses,
der die CreateDocumentList-QPAC verwendet, finden Sie im Handbuch Using LiveCycle Assembler QPACs.
Die Arbeitsschritte zum Erstellen eines Workflow-Prozesses, der eine Assembler-QPAC enthält, stimmen im
Wesentlichen mit den Arbeitsschritten zum Erstellen eines beliebigen Workflow-Prozesses in LiveCycle
Workflow Designer überein. Im nachfolgend beschriebenen Verfahren werden die für die Assembler-QPAC
geltenden Besonderheiten erläutert. Weitere Informationen zum Erstellen von Workflows, Einrichten von
Variablen und Festlegen von Aktionseigenschaften in einer QPAC finden Sie in den Handbüchern Erstellen
von Workflows und Using LiveCycle Assembler QPACs.
Verwenden dynamischer oder statischer DDX-Dateien
Wenn Sie Aufträge zur Verarbeitung durch LiveCycle Workflow und LiveCycle Assembler an Watched
Folder senden, können Sie eine dynamische oder eine statische DDX-Datei verwenden. Wenn Sie eine
Anwendung zum Senden von Aufträgen an LiveCycle Assembler erstellen oder einsetzen, die sich
ausschließlich auf den QPAC-Workflow stützt (ohne Watched Folder), müssen Sie eine statische DDX-Datei
verwenden.
Ein Workflow, der eine dynamische DDX-Datei verwendet, verarbeitet die DDX-Datei, die sich im
Eingabeordner eines überwachten Ordners befindet. Wenn Sie im Workflow-Prozess eine dynamische
DDX-Datei einsetzen möchten, müssen Sie eine <inputddx>-Variable erstellen und diese in den
Aktionseigenschaften der QPAC angeben.
Ein Workflow, der eine statische DDX-Datei verwendet, verarbeitet eine bestimmte DDX-Datei, die in die
QPAC geladen wird und jedes Mal zum Einsatz kommt, wenn der Prozess von der Datei JobConfig.xml
Adobe LiveCycle
Konfigurieren einer Assembler-QPAC in einem Workflow-Prozess
110
aufgerufen wird. Wenn Sie im Workflow-Prozess eine statische DDX-Datei einsetzen möchten, müssen Sie
beim Festlegen der Aktionseigenschaften für den Workflow zu der DDX-Datei wechseln und diese in die
QPAC laden. Sie können eine statische DDX-Datei einsetzen, wenn Sie einen überwachten Ordner
verwenden oder den Prozess nur mithilfe der QPACs ausführen.
Wenn Sie in LiveCycle Workflow Designer einen neuen Workflow-Prozess einrichten, müssen Sie für diesen
Prozess Variablen definieren. Wenn Sie dem Workflow die Assembler-QPAC hinzufügen, müssen Sie für die
QPAC die Aktionseigenschaften festlegen. In den Aktionseigenschaften kommen die von Ihnen
definierten Variablen zum Einsatz.
Welche Optionen Sie im Dialogfeld Action Properties auswählen, hängt davon ab, ob Sie eine
dynamische oder eine statische DDX-Datei verwenden.
Hinweis: Die in diesem Kapitel genannten Variablen wie <inputddx> und <inputdocmap> werden in
LiveCycle Workflow Designer vom Benutzer definiert. Sie können stattdessen beliebige andere
Namen verwenden.
Variablen für die Assembler-QPAC
Variable
Eigenschaftswerte
<inputdocmap>
Type: map oder document
in: Ausgewählt
out: Nicht ausgewählt
required: Nicht ausgewählt
<inputddx>
Type: document
in: Ausgewählt
out: Nicht ausgewählt
(nur für dynamische
DDX-Datei erforderlich)
<outputmap>
Type: map und document
in: Nicht ausgewählt
out: Ausgewählt
<joblog>
Type: document
in: Nicht ausgewählt
out: Ausgewählt
(nicht erforderlich, wenn
die Protokollierungsstufe
deaktiviert ist)
Adobe LiveCycle
111
Aktionseigenschaften für die Assembler-QPAC
Workflow-Typ
Verwenden von Watched
Folder mit einer
dynamischen DDX-Datei
Auswahl auf der Registerkarte
„Input“
Auswahl auf der Registerkarte
„Output“
Use a Document Variable to load the
DDX file: Klicken Sie auf die Schaltfläche
mit den Auslassungspunkten und wählen
Sie die <inputddx>-Variable aus.
Output Document Map:
Klicken Sie auf die Schaltfläche
mit den Auslassungspunkten
und wählen Sie die
<outputmap>-Variable aus.
Input Document Map Variable:
Wählen Sie die <inputdocmap>Variable aus.
Verwenden von Watched
Folder mit einer statischen
DDX-Datei
Use the Browse button to locate the
DDX file: Wechseln Sie zu der
gewünschten DDX-Datei.
Input Document Map Variable:
Wählen Sie die <inputdocmap>Variable aus.
Ausschließliches Verwenden Input Document Map: Wählen Sie
der QPAC (mit einer
diese Option nicht aus.
statischen DDX-Datei)
Use the Browse button to locate the
DDX file: Wechseln Sie zu der
gewünschten DDX-Datei.
und wählen Sie die
und wählen Sie die
Hinweis: Informationen zum Auswählen von Optionen auf der Registerkarte Configuration finden Sie im
nächsten Abschnitt, Fehlerprotokollierung und Fehlermodi in Assembler-QPAC-Workflows.
Fehlerprotokollierung und Fehlermodi in Assembler-QPAC-Workflows
Wenn Sie anhand der Assembler-QPAC einen Workflow einrichten, können Sie die von LiveCycle Workflow
beim Auftreten von Ausnahmefehlern verwendeten Fehlerprotokollierungsstufen und Fehlermodi
auswählen.
Für die Fehlerprotokollierung stehen die Stufen Off (keine Protokollierung), Normal (kurze Meldungen)
und Debug (ausführliche Fehlerbeschreibungen) zur Auswahl. Sie können eine Prozessvariable (z. B.
<joblog>) des Typs Document mit dem Feld Output Log Document verknüpfen, damit die
Protokollmeldungen gespeichert werden.
Für den Fehlermodus stehen die beiden Optionen Stall Process und Terminate Process zur Verfügung.
Abhängig von der gewählten Option wird ein Prozess von der Assembler-QPAC angehalten oder beendet,
wenn in LiveCycle Assembler ein Ausnahmefehler auftritt.
Wenn ein Auftrag fehlschlägt und die Option Stall Process ausgewählt ist, wird der Workflow-Prozess
angehalten, aber nicht beendet. Wenn Sie die Protokollierungsstufe Normal oder Debug gewählt haben,
werden in Administrator auf der Seite LiveCycle Workflow Stalled Action Einzelheiten zum Ausnahmefehler
aufgeführt. Administratoren von Komponenten sollten nach dem Prozess suchen und ihn beenden und dann
in Administrator die angehaltene Aktion nach Wunsch löschen. Die protokollierten Meldungen werden auf
der Seite Stalled Action angezeigt, nicht jedoch auf der Prozessseite.
Wenn ein Auftrag nicht ausgeführt werden kann und Terminate Process ausgewählt ist, wird der
Workflow-Prozess bei einem Ausnahmefehler beendet. Wenn Sie die Protokollierungsstufe Normal oder
Debug gewählt haben, werden die Details zu dem Ausnahmefehler in die Protokolldatei der Komponente
Adobe LiveCycle
Erstellen und Konfigurieren eines überwachten Ordners
112
aufgenommen, bei der der Ausnahmefehler aufgetreten ist. Die Protokolldatei für Watched Folder trägt
den Namen activity.log und befindet sich im Unterverzeichnis /failure des konfigurierten überwachten
Ordners.
Wenn Sie eine Assembler-QPAC für den Einsatz mit Watched Folder konfigurieren, sollten Sie den
Fehlermodus auf Terminate Process einstellen. Benutzer von Watched Folder haben möglicherweise
keinen Zugriff auf Administrator. Wenn Prozesse also angehalten, jedoch nicht beendet werden, werden
sie erst über den Ausnahmefehler unterrichtet, wenn der Prozess beendet ist. Wenn Sie den Fehlermodus
auf Terminate Process einstellen, ist gewährleistet, dass Fehlermeldungen in der Datei activity.log erfasst
werden. Diese Datei befindet sich (bei der Protokollierungsstufe Normal oder Debug) im Verzeichnis
[watchedfolder]/failure.
Informationen zum Einstellen der Fehlerprotokollierung und der Fehlermodi finden Sie unter Using
LiveCycle Assembler QPACs.
³ So erstellen Sie einen Workflow, der eine Assembler-QPAC enthält:
1. Stellen Sie die Assembler-QPAC für LiveCycle Workflow Designer bereit. (Siehe Using LiveCycle
Assembler QPACs.)
2. Wählen Sie in LiveCycle Workflow Designer den Befehl File > New > Process Category.
3. Wählen Sie die neue Prozesskategorie aus und wählen Sie den Befehl File > New > Process Type.
4. Klicken Sie mit der rechten Maustaste auf den neuen Prozesstyp und wählen Sie New Workflow.
5. Weisen Sie dem Workflow einen Namen zu und übernehmen Sie für die übrigen Optionen die
Standardwerte (synchronous ist aktiviert, die anderen Optionen sind deaktiviert).
6. Erstellen Sie die Variablen für den Workflow, wie in der Tabelle unter „Variablen für die
Assembler-QPAC“ auf Seite 110 beschrieben, indem Sie in der Palette Variables auf die Schaltfläche
mit dem grünen Pluszeichen (+) klicken. Weitere Informationen zum Erstellen von Variablen finden Sie
in der LiveCycle Workflow Designer-Hilfe.
7. Erstellen Sie eine neue Komponentenkategorie. (Siehe Erstellen von Workflows.)
8. Fügen Sie die Assembler-QPAC der neuen Komponentenkategorie hinzu (stellen Sie die Komponente
bereit) und legen Sie die Aktionseigenschaften für den Workflow fest (siehe Tabelle unter
„Aktionseigenschaften für die Assembler-QPAC“ auf Seite 111).
9. Speichern Sie den Workflow-Prozess und stellen Sie ihn bereit.
Sie müssen im Dateisystem ein Verzeichnis anlegen, das Sie als überwachten Ordner konfigurieren
können. Nachdem Sie den überwachten Ordner mithilfe der Konfigurationsschnittstelle von Watched
Folder konfiguriert haben, enthält er die folgenden Unterverzeichnisse:
Adobe LiveCycle
113
/[watchedfolder]
/input
/stage
/failure
/result
/preserve
Informationen zu diesen Unterverzeichnissen finden Sie in der Watched Folder-Administrator-Hilfe.
Wenn Sie Dateien zur Verarbeitung weiterleiten möchten, müssen Sie sie im Verzeichnis /[watched
folder]/input ablegen.
Müssen im LiveCycle Assembler-Prozess mehrere Dateien verarbeitet werden, übertragen Sie die
einzelnen Dateien nicht in das Verzeichnis input. Erstellen Sie stattdessen ein separates Sammelverzeichnis, legen Sie alle erforderlichen Dateien darin ab (d. h. die PDF-Eingabedateien und
gegebenenfalls die DDX-Datei) und platzieren Sie das Sammelverzeichnis dann in das Verzeichnis input
des überwachten Ordners.
³ So erstellen und konfigurieren Sie einen überwachten Ordner:
1. Legen Sie im Dateisystem auf dem Server ein Verzeichnis an, das als überwachter Ordner dienen soll.
2. Melden Sie sich bei Administrator an.
3. Klicken Sie auf Dienste, auf Watched Folder und dann auf Verwaltung und Status von Watched
Folder.
4. Klicken Sie auf Neuer überwachter Ordner.
5. Geben Sie in das Feld Name des überwachten Ordners einen Namen für den überwachten Ordner
ein. (Dieser Name muss nicht mit dem Namen des Verzeichnisses übereinstimmen, das Sie in Schritt 1
im Dateisystem erstellt haben. Dies bietet sich jedoch für die einfachere Verfolgung an.)
6. Geben Sie in das Feld Pfad des überwachten Ordners den vollständigen Pfad zu dem Verzeichnis an,
das Sie im Dateisystem erstellt haben.
7. Geben Sie in das Feld Eingeschlossene(s) Dateimuster den Namen des von Ihnen für die
PDF-Eingabedateien erstellten Verzeichnisses an (dies ist das Verzeichnis, das Sie im Verzeichnis input
des überwachten Ordners ablegen werden). Wenn Sie mehrere Dateien und Ordner im überwachten
Ordner platzieren möchten, können Sie mehrere Dateien oder Namen angeben.
8. Richten Sie die übrigen Optionen Ihren Anforderungen entsprechend ein. Informationen zu den
verfügbaren Optionen finden Sie in der Watched Folder-Administrator-Hilfe.
Tipp: Wenn Sie eine große Anzahl von Quelldateien in den überwachten Ordner übertragen, kann der
Vorgang mehrere Minuten in Anspruch nehmen. Es ist möglich, dass Watched Folder den
überwachten Ordner prüft, ein neues Sammelverzeichnis erkennt und einen Workflow-Prozess
initiiert, bevor der Kopiervorgang abgeschlossen ist. Um dies zu vermeiden, müssen Sie dem
Sammelverzeichnis während des Kopierens in das Verzeichnis input einen anderen Namen als den
Namen zuweisen, nach dem Watched Folder sucht. Nachdem alle Eingabedateien kopiert wurden,
müssen Sie den Namen des Sammelverzeichnisses durch den Namen ersetzen, der in der Watched
Folder-Konfiguration angegeben wurde (d. h. der Wert von Eingeschlossene(s) Dateimuster).
Adobe LiveCycle
114
Die Datei JobConfig.xml kann im Stammverzeichnis des Verzeichnisses input oder im Sammelverzeichnis
zusammen mit den anderen zugehörigen Dateien abgelegt werden.
Wenn Sie im überwachten Ordner mehrere Aufträge (Sammelverzeichnisse) für verschiedene Workflows
platzieren möchten, die dynamische DDX-Dateien verwenden, muss die Datei JobConfig.xml in den
einzelnen Sammelverzeichnissen abgelegt werden, die in das Verzeichnis input im überwachten Ordner
übertragen werden.
Wenn Sie mehrere Aufträge für denselben Workflow übertragen möchten, der eine statische DDX-Datei
verwendet, können Sie die Datei JobConfig.xml im Stammverzeichnis des Verzeichnisses input ablegen.
Diese Datei JobConfig.xml wird auch für die nachfolgend eingehenden Aufträge verwendet.
Erstellen Sie eine Datei JobConfig.xml, indem Sie anhand der folgenden Beispiele eine XML-Datei erstellen.
Beispiel C.1
Datei JobConfig.xml für eine dynamische DDX-Datei
<process-config xmlns="http://adobe.com/watchedfolder"
xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance"
xsi:schemaLocation="http://adobe.com/watchedfolder
C:\WatchedFolder\schemas\JobConfiguration.xsd">
<process-type>myworkflow</process-type>
<process-variables>
<process-variable>
<filter-pattern>*.pdf</filter-pattern>
<process-variable-type>map</process-variable-type>
<process-variable-name>inputdocmap</process-variable-name>
<process-variable-datatype>document</process-variable-datatype>
<process-input>true</process-input>
</process-variable>
<process-variable>
<filter-pattern>*.ddx</filter-pattern>
<process-variable-type>single</process-variable-type>
<process-variable-name>inputddx</process-variable-name>
</process-variable>
</process-variables>
</process-config>
Beispiel C.2
Datei JobConfig.xml für eine statische DDX-Datei
Verwenden Sie die oben beschriebene Datei JobConfig.xml, lassen Sie jedoch die Prozessvariable
<inputddx> weg.
<process-config xmlns="http://adobe.com/watchedfolder"
xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance"
xsi:schemaLocation="http://adobe.com/watchedfolder
C:\WatchedFolder\schemas\JobConfiguration.xsd">
<process-type>myworkflow</process-type>
<process-variables>
<process-variable>
<filter-pattern>*.pdf</filter-pattern>
Adobe LiveCycle
115
<process-variable-type>map</process-variable-type>
<process-variable-name>inputdocmap</process-variable-name>
</process-variable>
</process-variables>
</process-config>
Der Inhalt der Datei JobConfig.xml verweist auf die Variablen und Aktionen, die im unter „Konfigurieren
einer Assembler-QPAC in einem Workflow-Prozess“ auf Seite 110 beschriebenen Workflow-Prozess
definiert wurden.
Knoten
Beschreibung
process-config
Das Stammverzeichnis der Auftragskonfigurationsdatei.
process-type
Der Name des Workflow-Prozesstyps. Dieser Wert muss dem Wert
entsprechen, der im Workflow-Prozess in LiveCycle Workflow
Designer festgelegt wurde.
process-variables
Enthält mehrere process-variable-Knoten.
process-variable
Jeder process-variable-Knoten verweist auf eine Variable im
Workflow-Prozess. Seine Unterelemente geben Eigenschaftswerte
für die einzelnen Prozessvariablen an.
filter-pattern
Das Muster, anhand dessen die Dateien aus dem Eingabesatz
gefiltert werden, der für die Prozessvariable eingerichtet wird.
Dieses Muster gleicht den Typ der zu verarbeitenden Dateien mit
der Variablen ab.
process-variable-type
Der Typ der Eingabevariablen, d. h. single, list oder map.
Im oben genannten Beispiel wird list für die
<inputdocmap>-Variable verwendet, da die Variable eine Reihe
von Dokumenten angibt (alle Dateien, die im überwachten Ordner
abgelegt werden). Für die <inputddx>-Variable wurde single
angegeben, da nur eine Datei enthalten ist.
process-variable-name
Der Name der Workflow-Variablen wie im Workflow definiert. Im
oben genannten Beispiel entsprechen die Variablennamen den
unter „Konfigurieren einer Assembler-QPAC in einem
Workflow-Prozess“ auf Seite 110 erstellten Namen inputdocmap
and inputddx.
process-variable-datatype
Der Typ der Workflow-Variablen. Die beiden Variablentypen
document und xml werden unterstützt. Dies entspricht dem
Attribut containedtype der Variablen (nicht dem Attribut
collectiontype).
process-input
Diese Einstellung wird von Watched Folder zurzeit nicht
verwendet. Übernehmen Sie den vorgegebenen Wert true.
Weitere Informationen zum Erstellen der Datei JobConfig.xml finden Sie in der Watched
Folder-Administrator-Hilfe.
Adobe LiveCycle
Vorbereiten von PDF- und DDX-Dateien
116
Vorbereiten von PDF- und DDX-Dateien
Die PDF-Dateien, die sich im Verzeichnis input befinden oder von der Assembler-QPAC definiert werden,
müssen mit dem Dateimusterwert übereinstimmen, der für das Element source in der DDX-Datei
definiert wurde.
Wenn Sie Watched Folder mit LiveCycle Assembler verwenden, müssen Sie die Input Document
Map-Variable festlegen (siehe „Konfigurieren einer Assembler-QPAC in einem Workflow-Prozess“ auf
Seite 110). Sie müssen das Attribut sourceMatch für das Quellelement verwenden, um das Dateimuster
zu definieren. Informationen zum Einrichten des regulären Ausdrucksmusters für das Attribut
sourceMatch finden Sie in der Document Description XML Reference.
Beispielsweise stehen verschiedene Möglichkeiten zur Verfügung, die PDF-Quelle in der DDX-Datei
anzugeben:
O
Musterabgleich mit bestimmten Dateinamen:
<PDF source="mysource" sourceMatch="appendix[\d]+[.]pdf" select="1-last"/>
O
Musterabgleich mit Platzhalterwert:
<PDF source="mysource" sourceMatch=".+[.]pdf" select="1-last"/>
In den oben genannten Beispielen werden beim Musterabgleich alle PDF-Eingabedateien berücksichtigt,
deren Namen mit den Zeichen appendix beginnen und die dann von einer Ziffer und der Dateierweiterung .pdf gefolgt werden. Mit dem Platzhalterwert wird mindestens eine PDF-Eingabedatei mit
beliebigen Zeichen berücksichtigt, die Ziffern enthalten und auf .pdf enden.
Weitere Informationen zum Festlegen des Quellelements in der DDX-Datei finden Sie im Handbuch
Developing Applications for LiveCycle Assembler unter „Specifying multiple input streams“ und in der
Document Description XML Reference.
Senden des LiveCycle Assembler-Auftrags zur Verarbeitung
Sie können einen LiveCycle Assembler-Auftrag programmgesteuert an Watched Folder weiterleiten,
indem Sie eine Stapelverarbeitungsdatei verwenden, die das Paket mit den erforderlichen Dateien an den
konfigurierten überwachten Ordner überträgt. (Anleitungen zum Erstellen einer Stapelverarbeitungsdatei
oder eines Skripts für diesen Vorgang können im Rahmen dieses Handbuchs nicht behandelt werden.) Sie
können einen Auftrag auch manuell durch Ziehen oder Kopieren des Dateipakets in Watched Folder
weiterleiten.
Wenn Sie in LiveCycle Workflow Designer einen LiveCycle Assembler-Workflow erstellt haben, der
Watched Folder nicht verwendet, können Sie den Auftrag mithilfe einer Clientanwendung zur
Verarbeitung weiterleiten, die Sie mit der LiveCycle Workflow-Java-API erstellen. Informationen zum
Entwickeln von Clientanwendungen für LiveCycle Workflow finden Sie im Handbuch Developing Custom
Applications for LiveCycle Workflow, das im Lieferumfang des LiveCycle Workflow-SDK enthalten ist.
Zum Übertragen von Aufträgen zur Verarbeitung stehen mit LiveCycle Workflow noch eine Reihe anderer
Methoden zur Verfügung, z. B. Webdienste, E-Mail, Messaging-Warteschlangen sowie Online-Formulare.
Weitere Informationen finden Sie in den Handbüchern Developing Custom Applications for LiveCycle
Workflow und Developing Custom QPACs.
Hinweis: Wenn für Watched Folder die NFS-Freigabe eingerichtet wurde, werden temporäre Dateien und
Verzeichnisse für Watched Folder-Aufträge im globalen Speicherverzeichnis abgelegt, jedoch
nicht automatisch bei Beendigung der Auftragsverarbeitung gelöscht. Vermeiden Sie
Adobe LiveCycle
Senden des LiveCycle Assembler-Auftrags zur Verarbeitung
117
Leistungseinbußen, indem Sie Dateien namens Session[NNNN] regelmäßig entfernen. NNNN
gibt hierbei die ID des Workflow-Prozesses im globalen Speicherverzeichnis an.
Der Standardspeicherort des globalen Speicherverzeichnisses lautet
[Temp-Verzeichnis]/AdobeDocumentStorage/global. Wenn das [Temp-Verzeichnis] vom Benutzer
in Configuration Manager nicht angegeben wurde, wird als Standardverzeichnis java.io.tmpdir
verwendet.
D
Entwickeln von Formularen für LiveCycle
Dieser Anhang enthält nützliche Hinweise für Formularentwickler, z. B. Informationen zum Verwenden von
WebDAV mit LiveCycle Form Manager sowie zu den Elementen, die für LiveCycle-Produkte für
verschiedene Formulartypen erforderlich sind.
Veröffentlichen von Dateien mithilfe von Clientsoftware
Formularentwickler und -eigentümer können ihre Dateien mithilfe WebDAV-aktivierter Clientsoftware in
dem von LiveCycle Form Manager verwendeten Repository der LiveCycle-Produkte veröffentlichen und
darauf zugreifen.
Die Verwendung von WebDAV setzt voraus, dass auf dem Computer Software zur Dateiverwaltung
ausgeführt wird (z. B. Microsoft Windows Explorer), die eine Verbindung zu WebDAV-Servern herstellen
kann.
Damit Sie eine Verbindung zu einem WebDAV-Verzeichnis herstellen können, müssen Sie die URL des
Verzeichnisses angeben. Die Standard-URL für das LiveCycle Form Manager-Repository lautet:
http://[Hostname]:[Anschluss]/appstore/Forms
Hierbei kennzeichnet [Hostname] den Namen des Computers, auf dem LiveCycle-Produkte ausgeführt
werden, und [Anschluss] den für LiveCycle-Produkte verwendeten Anschluss.
Angenommen, die in Ihrem Unternehmen für die Formularentwicklung zuständigen Mitarbeiter erstellen
Formulare in LiveCycle Designer und möchten diese Formulare und die entsprechenden Dateien in
LiveCycle Designer mit dem Menübefehl zum Veröffentlichen in das Repository der LiveCycle-Produkte
kopieren. Zuerst müssen sie mithilfe von Windows Explorer eine neue Netzwerkressource hinzufügen, die
eine Verbindung zur URL der Repository der LiveCycle-Produkte herstellt. Die Verbindung wird unter
Netzwerkumgebung als Ordner angezeigt. Nachdem die Netzwerkressource hinzugefügt wurde, kann
der Ordner zum Veröffentlichen von Dateien im Repository verwendet werden.
Entwerfen von Formularen für LiveCycle-Produkte
Wenn Formulare mit LiveCycle-Produkten verwendet werden sollen, müssen hinsichtlich des
Formularentwurfs und/oder der Konfiguration der LiveCycle-Produkte gegebenenfalls einige Punkte
beachtet werden. Bei den folgenden Formulartypen müssen bestimmte Voraussetzungen erfüllt sein,
damit sie in LiveCycle-Produkten eingesetzt werden können:
O
Dynamische Formulare
O
PDF/A-konforme Formulare
O
Formulare, die Teilformularobjekte enthalten
O
In Acrobat erstellte PDF-Formulare
Informationen zum Entwerfen von Formularen für die Verwendung mit LiveCycle Workflow finden Sie im
Handbuch Erstellen von Workflows, das mit LiveCycle Workflow installiert wird.
118
Adobe LiveCycle
Entwickeln von Formularen für LiveCycle
Verwenden von dynamischen Formularen in LiveCycle-Produkten
119
Verwenden von dynamischen Formularen in LiveCycle-Produkten
Bei dynamischen Formularen handelt es sich um Formulare, die sich an den Umfang der eingehenden
Daten anpassen können und somit bei Bedarf vergrößert oder verkleinert werden. Sie enthalten in der
Regel Schaltflächen, die von LiveCycle Forms Formulardaten anfordern. LiveCycle Forms gibt das Formular
mit den Daten wieder und sendet es an den Client zurück. Der Browser des Clients wird anhand des
Formulars aktualisiert, das wiederum abhängig von der neuen Datenmenge vergrößert oder verkleinert
wurde.
Bei einigen Formulartypen können Benutzer beispielsweise durch Angabe von Suchkriterien eine
Datenbank abfragen. Die zurückgegebenen Daten werden in demselben Formular (Teilformular) in einer
Tabelle angezeigt. Die Anzahl der Tabellenzeilen hängt vom Umfang der zurückgegebenen Daten ab. Zum
Senden der Abfrage klickt der Benutzer auf eine Schaltfläche. Die Abfrage wird daraufhin an LiveCycle
Forms gesendet.
LiveCycle-Produkte unterstützen bei dynamischen Formularen die folgenden Schaltflächentypen:
O
Eine Schaltfläche zum Aktualisieren der Daten in einem dynamischen Formular
O
Eine Schaltfläche zum Zurücksenden eines PDF-Dokuments an einen Client, der dann eine Kopie des
Dokuments lokal speichern bzw. das Dokument drucken kann
In LiveCycle-Produkten werden für diese Schaltflächen bestimmte Schaltflächennamen verwendet, damit
diese Schaltflächen problemlos erkannt werden. Diese Namen müssen in dynamischen Formularen eingesetzt werden. Sie können entweder die Standardnamen übernehmen oder für die LiveCycle-Produkte
auf den Administrator-Seiten andere Namen festlegen.
Eigenschaft
Standard
Beschreibung und Optionen
Schaltflächenname für
Neudarstellung
RENDERAGAIN
Der Schaltflächenname, an dem LiveCycle-Produkte erkennen,
dass diese Schaltfläche eine Anfrage an LiveCycle Forms sendet,
um das aktuelle Formular anhand der aktualisierten Daten erneut
wiederzugeben
Name der
PRINTFORM
Druckschaltfläche
Der Schaltflächenname, an dem LiveCycle-Produkte erkennen, dass
diese Schaltfläche das aktuelle Formular in ein PDF-Dokument
umwandelt und an den Endbenutzer zurückgibt
Einbetten von Schriften in PDF/A-konforme Formulare
Wenn Sie einen Formularentwurf erstellen, von dem bei der Wiedergabe durch LiveCycle Forms ein mit
PDF/A Level 1B konformes Formular erstellt werden soll, müssen alle verwendeten Schriften in den
Formularentwurf eingebettet werden. Sind die Schriften nicht eingebettet, ist das wiedergegebene
Formular zwar ein gültiges PDF-Formular, jedoch nicht mit PDF/A Level 1B konform.
Im Formularentwurf können nur Schriften eingebettet werden, die mindestens zur Anzeige und zum
Drucken lizenziert sind. Die Schriften im Font Manager-Modul erfüllen dieses Kriterium.
E
Deinstallieren von LiveCycle-Produkten
In diesem Kapitel wird die Deinstallation von LiveCycle-Produktdateien beschrieben, die auf manuelle
Weise oder mit der Turnkey-Methode installiert wurden.
Entfernen der mit der Turnkey-Methode installierten
Produktdateien
Für jedes mit der Turnkey-Methode installierte LiveCycle-Produkt ist ein Deinstallationsprogramm
vorhanden, mit dem Sie das Produkt vom Computer entfernen können. Das Deinstallationsprogramm
entfernt nur das jeweilige LiveCycle-Produkt. Dateien, die Sie auf dem Anwendungsserver bereitgestellt
haben, sowie Module, die gemeinsam mit anderen LiveCycle-Produkten genutzt werden, werden nicht
entfernt.
Beim Entfernen der Produktkomponenten werden JBoss und MySQL nicht entfernt. Sie müssen diese
Anwendungen auf manuelle Weise entfernen. Auch nach dem Deinstallieren der Dienste können JBoss
und MySQL über eine Eingabeaufforderung gestartet werden.
Vorsicht: Sichern Sie vor dem Entfernen von MySQL alle Daten, die Sie weiterhin benötigen.
³ So entfernen Sie die Produktdateien:
1. Wechseln Sie zum Verzeichnis [Produkt-Stammverzeichnis]/_uninst/ und doppelklicken Sie auf die Datei
[Produktname]_uninstall.exe. Sie können das Deinstallationsprogramm auch über die WindowsSystemsteuerung mit der Funktion Software starten.
3. Befolgen Sie die auf dem Bildschirm angezeigten Anweisungen und klicken Sie auf Fertig stellen.
³ So entfernen Sie die JBoss- und MySQL-Dienste:
1. Stellen Sie sicher, dass die JBoss- und MySQL-Dienste beendet wurden. Geben Sie zum Beenden des
Dienstes JBoss for Adobe LiveCycle an einer Eingabeaufforderung den folgenden Befehl ein:
net stop "JBoss for Adobe LiveCycle"
Geben Sie zum Beenden des Dienstes MySQL for Adobe LiveCycle an einer Eingabeaufforderung den
folgenden Befehl ein:
net stop "MySQL for Adobe LiveCycle"
2. Deinstallieren Sie den Dienst JBoss for Adobe LiveCycle auf manuelle Weise, indem Sie zum
Verzeichnis [LiveCycle-Stammverzeichnis]/jboss/ wechseln und an einer Eingabeaufforderung den
folgenden Befehl eingeben:
JBossService.exe -uninstall "JBoss for Adobe LiveCycle"
3. (LiveCycle Workflow Business Activity Monitor) Deinstallieren Sie den Dienst JBoss for Adobe
LiveCycle Workflow BAM auf manuelle Weise, indem Sie zum Verzeichnis
120
Adobe LiveCycle
Deinstallieren von LiveCycle-Produkten
Entfernen der auf manuelle Weise installierten Produktdateien
121
[LiveCycle-Stammverzeichnis]/jboss/ directory wechseln und an einer Eingabeaufforderung den
JBossService.exe -uninstall "JBoss for Adobe LiveCycle Workflow BAM"
4. Deinstallieren Sie den Dienst MySQL for Adobe LiveCycle auf manuelle Weise, indem Sie zum
Verzeichnis [LiveCycle-Stammverzeichnis]/jboss/ wechseln und an einer Eingabeaufforderung den
JBossService.exe -uninstall "MySQL for Adobe LiveCycle"
Hinweis: Wenn Sie mehrere LiveCycle-Produkte deinstallieren möchten und LiveCycle Assembler oder
LiveCycle PDF Generator zuletzt installiert wurde, gibt es zwei ausführbare Dienst-Dateien:
JavaService.exe und JBossService.exe.
Entfernen der auf manuelle Weise installierten Produktdateien
Mit dem Deinstallationsprogramm im Verzeichnis [Produktstammverzeichnis] werden weder Dateien, die
Sie auf dem Anwendungsserver bereitgestellt haben, noch Module entfernt, die auch von anderen
LiveCycle-Produkten verwendet werden.
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. Wechseln Sie zum Verzeichnis [Produktstammverzeichnis]/_uninst/ und starten Sie das
Deinstallationsprogramm:
O
(Windows) Doppelklicken Sie auf die EXE-Datei. Sie können auch die Funktion Software
verwenden.
O
3. Befolgen Sie die auf dem Bildschirm angezeigten Anweisungen und klicken Sie auf Fertig stellen.
F
Aktualisieren von LiveCycle-Produkten auf
Version 7.2 oder 7.2.1
In diesem Kapitel werden die zum Aktualisieren der derzeitigen LiveCycle-Produkte auf Version 7.2 (bzw.
im Falle von LiveCycle Assembler und LiveCycle Workflow auf Version 7.2.1) erforderlichen Schritte
beschrieben.
Dieses Dokument sollte zusammen mit dem Handbuch Installieren und Konfigurieren von LiveCycle bzw.
Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten für den jeweiligen Anwendungsserver
verwendet werden. Im Verlauf dieses Dokuments wird auf Abschnitte in diesen Handbüchern zum
Installieren und Konfigurieren verwiesen, in denen ausführlichere Informationen zu finden sind.
Eine vollständige Liste der unterstützten Plattformen und der Systemanforderungen für
LiveCycle 7.2-Produkte finden Sie in diesem Handbuch im Kapitel „Vorbereiten der Installation“.
In diesem Kapitel werden die folgenden Namenskonventionen für allgemeine Dateipfade verwendet:
[LiveCycle-Stammverzeichnis]: Dieses Verzeichnis verweist auf den Speicherort von
LiveCycle-Produkten und -Komponenten vor den Versionen 7.2 oder 7.2.1.
[LiveCycle72-Stammverzeichnis]: Dieses Verzeichnis verweist auf den Speicherort von
LiveCycle-Produkten und -Komponenten der Versionen 7.2 oder 7.2.1.
Die Handbücher Installieren und Konfigurieren von LiveCycle finden auf die folgenden Produkte
Anwendung:
O
LiveCycle Assembler 7.2.1
O
Adobe LiveCycle Forms 7.2
O
Adobe LiveCycle Form Manager 7.2
O
Adobe LiveCycle PDF Generator 7.2
O
Adobe LiveCycle Print 7.2
O
Adobe LiveCycle Workflow 7.2.1
O
Adobe LiveCycle Workflow Designer 7.2.1
O
Watched Folder 1.1
Die Handbücher Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten finden auf die folgenden
Produkte Anwendung:
O
Adobe LiveCycle Document Security 7.2
O
Adobe LiveCycle Reader Extensions 7.2
O
Adobe LiveCycle Policy Server 7.2
Richtlinien für die Aktualisierung
In diesem Abschnitt werden die Richtlinien beschrieben, die Sie zum Aktualisieren von
LiveCycle-Produkten auf Version 7.2 oder Version 7.2.1 befolgen müssen.
122
Adobe LiveCycle
Aktualisieren von LiveCycle-Produkten auf Version 7.2 oder 7.2.1
Aktualisieren des Anwendungsservers
123
Aktualisieren des Anwendungsservers
Vergewissern Sie sich, dass Sie die erforderlichen Patches und Fix Packs auf den Anwendungsserver
anwenden, auf dem Sie LiveCycle-Produkte ausführen. Darüber hinaus müssen Sie über die aktualisierten
Datenbanktreiber verfügen. Ihre Umgebung muss den in diesem Handbuch im Kapitel „Unterstützte
Software“ angegebenen Systemanforderungen entsprechen.
Verwenden der automatischen oder der Turnkey-Installation für die
Aktualisierung
Bei Installationen für die Bereitstellung auf WebSphere oder WebLogic können Sie Configuration Manager
zum Konfigurieren und Bereitstellen des Produkts, zum Initialisieren der Datenbank und zum Überprüfen
der Bereitstellung verwenden.
Bevor Sie LiveCycle-Produkte mit Configuration Manager automatisch konfigurieren, muss die
Bereitstellung der bereits vorhandenen LiveCycle-Komponenten aufgehoben und der Anwendungsserver
neu gestartet werden.
Bei Installationen für die Bereitstellung auf JBoss können Sie die Produkte mit Configuration Manager für
die Bereitstellung konfigurieren und die Datenbank initialisieren. Sie müssen die Produktkomponenten
jedoch manuell bereitstellen. Die Installation mit der Turnkey-Methode wird nur für die Aktualisierung von
LiveCycle Reader Extensions unterstützt.
Wenn Sie LiveCycle-Produkte ausführen, die ursprünglich mit der Turnkey-Methode installiert wurden,
können Sie die Aktualisierung auf Version 7.2 oder 7.2.1 durchführen, indem Sie die in diesem Handbuch
enthaltenen Anleitungen für die manuelle oder automatische Konfiguration befolgen. Anleitungen zum
Aktualisieren von LiveCycle Reader Extensions mit der Turnkey-Methode sind ebenfalls in diesem Kapitel
enthalten.
Konfigurieren mit Configuration Manager während der Aktualisierung
Sie sollten den WebSphere- oder WebLogic-Anwendungsserver nicht automatisch mit Configuration
Manager konfigurieren, da bei diesem Vorgang aktuelle Konfigurationseinstellungen auf dem
Anwendungsserver möglicherweise überschrieben werden.
Während der Aktualisierung konfigurieren Sie einige Laufzeiteigenschaften des Produkts und des
Anwendungsservers mit Configuration Manager. Bei Aktualisierungen von Version 7.x sollten Sie das
aktualisierte Produkt mit denselben Eigenschaftswerten konfigurieren. In den Handbüchern Installieren
und Konfigurieren finden Sie im Kapitel „Konfigurieren von LiveCycle-Produkten für die Bereitstellung“
Informationen zu den Eigenschaften, die beim Aktualisieren des Produkts konfiguriert werden müssen.
Übersicht über die manuelle Aktualisierung
In dieser Checkliste finden Sie die wichtigsten Aufgaben, die Sie zum Aktualisieren eines
LiveCycle-Produkts der Version 7.x auf ein LiveCycle-Produkt der Version 7.2 oder 7.2.1 durchführen
müssen. Ausführliche Informationen finden Sie in den spezifischen Aktualisierungsverfahren für das zu
aktualisierende Produkt.
Die in der Spalte „Siehe“ angegebenen Abschnitte sind in den Handbüchern Installieren und Konfigurieren
Aufgabe
Siehe
Sichern Sie die Datenbank, in der die derzeitige
LiveCycle-Konfiguration und die Laufzeitdaten
gespeichert sind.
Dokumentation des Datenbankservers
Adobe LiveCycle
LiveCycle Forms und LiveCycle Print
124
Erstellen Sie Sicherungskopien der derzeit
bereitgestellten LiveCycle EAR- und WAR-Dateien in
einem separaten Verzeichnis.
(JBoss) Beenden Sie die derzeit eventuell
verwendeten Dienste (JBoss for Adobe LiveCycle,
MySQL for Adobe LiveCycle, JBoss for Workflow BAM,
AdobeDocumentSecurity oder
AdobeReaderExtensions).
Heben Sie die Bereitstellung von LiveCycleKomponenten auf dem Anwendungsserver auf.
Dokumentation des Anwendungsservers
Deinstallieren Sie die Vorgängerversion der
LiveCycle-Produkte mit dem Deinstallationsprogramm.
Kapitel „Deinstallieren von
LiveCycle-Produkten“
Wenden Sie die erforderlichen Patches und Fix Packs
auf den Anwendungsserver an und laden Sie die
aktualisierten Datenbanktreiber herunter.
Abschnitt „Unterstützte Software“ des
Kapitels „Vorbereiten der Installation“
Installieren Sie das LiveCycle 7.2- oder 7.2.1-Produkt
an einem neuen Speicherort im Dateisystem (d. h.
nicht im Standardverzeichnis). Installieren Sie das
Produkt nicht im selben Verzeichnis, in dem die
früheren LiveCycle-Produkte installiert sind.
Kapitel „Installieren von
LiveCycle-Produkten“
Führen Sie Configuration Manager aus, um das
Produkt zu konfigurieren. Wenden Sie dieselben
Konfigurationsdaten wie bei der Originalinstallation
an. Wenn Sie WebSphere oder WebLogic verwenden,
können Sie das Produkt mit Configuration Manager
automatisch bereitstellen, die Datenbank
initialisieren und die Bereitstellung überprüfen.
(JBoss) Kapitel „Konfigurieren von
LiveCycle-Produkten für die Bereitstellung“
(JBoss) Stellen Sie die Produktkomponenten auf dem
Anwendungsserver bereit.
Kapitel „Manuelles Bereitstellen auf JBoss“
(JBoss) Führen Sie Configuration Manager aus, um
die Datenbank zu initialisieren.
Kapitel „Initialisieren der Datenbank“
(WebLogic, WebSphere) Kapitel
„Automatisches Konfigurieren von
LiveCycle-Produkten“ oder „Konfigurieren
von LiveCycle-Produkten für die
Bereitstellung“
LiveCycle Forms und LiveCycle Print
Dieser Abschnitt enthält Anleitungen zum Aktualisieren von LiveCycle Forms 7.2 und LiveCycle Print 7.2.
Hinweis: Sie müssen LiveCycle Forms 7.2 vor der Installation von LiveCycle Print 7.2 installieren.
Aktualisieren von Adobe Form Server 6.0 auf LiveCycle Forms 7.2
Dieser Abschnitt enthält Anleitungen zum Aktualisieren von Adobe Form Server 6.0 auf LiveCycle
Forms 7.2.
Adobe LiveCycle
Aktualisieren von LiveCycle Forms und LiveCycle Print 7.x auf LiveCycle Forms und LiveCycle Print 7.2
125
³ So aktualisieren Sie Adobe Form Server 6.0 auf LiveCycle Forms 7.2:
1. Heben Sie die Bereitstellung des Vorgängerprodukts auf dem Anwendungsserver auf. (Weitere
Informationen finden Sie in der Dokumentation des Anwendungsservers.)
2. Deinstallieren Sie das Vorgängerprodukt mit dem Deinstallationsprogramm. (Weitere Informationen
finden Sie im Handbuch Installieren und Konfigurieren für Form Server 6.0.)
3. Aktualisieren Sie den Anwendungsserver und die Datenbank, um sicherzustellen, dass die System- und
Softwareanforderungen für LiveCycle 7.2-Produkte erfüllt sind.
4. Installieren Sie LiveCycle Forms 7.2 und stellen Sie die Anwendung bereit. Initialisieren Sie die
Datenbank anhand der Anleitungen zur manuellen Installation und Bereitstellung in diesem
Dokument. Wenn Sie WebSphere oder WebLogic verwenden, können Sie das Produkt mit
Configuration Manager automatisch bereitstellen, die Datenbank initialisieren und die Bereitstellung
überprüfen.
Hinweis: Wenn Sie User Management nicht zusammen mit LiveCycle Forms installiert und konfiguriert
haben, benötigen Sie keine Datenbankverbindung und müssen die Schritte zum Initialisieren
der Datenbank nicht durchführen.
Aktualisieren von LiveCycle Forms und LiveCycle Print 7.x auf
LiveCycle Forms und LiveCycle Print 7.2
Im vorliegenden Verfahren wird beschrieben, wie eine Aktualisierung von LiveCycle Forms 7.0 oder 7.1 auf
LiveCycle Forms 7.2 sowie von LiveCycle Print 7.1 auf LiveCycle Print 7.2 durchgeführt wird.
Sie sollten LiveCycle Forms 7.2 in einem neuen Verzeichnis installieren, damit die zuvor installierte Version
nicht überschrieben wird.
³ So rufen Sie die Formularkonfigurationseigenschaften ab (für LiveCycle Forms 7.0 oder 7.1 ohne
User Management):
Der Standardanschluss für WebLogic ist 7001. Wenn Sie einen verwalteten Server ausführen, haben Sie
den Anwendungsserver möglicherweise für die Verwendung einer anderen Anschlussnummer
(beispielsweise 8001) konfiguriert. Der Standardanschluss für WebSphere ist 9080, der
Standardanschluss für JBoss ist 8080.
2. Notieren Sie sich die auf dieser Seite angezeigten Einstellungen.
³ So rufen Sie die Formularkonfigurationseigenschaften ab (für LiveCycle Forms 7.0 oder 7.1 mit
User Management):
(beispielsweise 8001) konfiguriert. Der Standardanschluss für WebSphere ist 9080, der Standardanschluss für JBoss ist 8080.
Adobe LiveCycle
126
3. Klicken Sie auf Dienste und dann auf Adobe LiveCycle Forms.
4. Notieren Sie sich die auf dieser Seite angezeigten Einstellungen.
5. Diese Eigenschaften müssen beim Installieren und Konfigurieren von LiveCycle Forms 7.2 in
Configuration Manager im Bildschirm Form Server-Modulkonfiguration für die neue Installation
festgelegt werden.
³ So führen Sie eine Aktualisierung auf LiveCycle Forms 7.2 und LiveCycle Print 7.2 durch:
1. Erstellen Sie eine Sicherungskopie der Datenbank, in der derzeit die Konfigurations- und Laufzeitdaten
für LiveCycle Forms 7.0 oder 7.1 gespeichert sind.
2. Vergewissern Sie sich, dass Sie über Sicherungskopien der derzeit bereitgestellten LiveCycle EAR- und
WAR-Dateien verfügen, die für das zu aktualisierende Produktionssystem konfiguriert sind.
3. Erstellen Sie Sicherungskopien der XDC-Dateien von LiveCycle Print 7.1.
4. (JBoss) Wenn Ihre LiveCycle-Bereitstellung auf JBoss Application Server mit einer MySQL-Datenbank
ausgeführt wird, die Sie mit der Turnkey-Option installiert haben, beenden Sie die Dienste JBoss for
Adobe LiveCycle und MySQL for Adobe LiveCycle.
5. Heben Sie die Bereitstellung der folgenden Dateien auf dem Anwendungsserver auf:
O
LiveCycle.ear
O
FormsIVS.ear
O
adobe-FontManager.war
O
LCMBootstrapper.war
O
adobe-printSubmitter.ear (nur LiveCycle Print)
Informationen zum Aufheben der Bereitstellung auf WebLogic oder WebSphere finden Sie im
Handbuch Installieren und Konfigurieren von LiveCycle unter „Deinstallieren von EAR-Dateien“.
Hinweis: Wenn die Datei LiveCycle.ear nicht mehr bereitgestellt ist, kann LiveCycle Print 7.1 nicht
ausgeführt werden.
6. Beenden Sie WebLogic Server oder WebSphere Application Server.
7. Deinstallieren Sie die Vorgängerversion der LiveCycle-Produkte mit dem Deinstallationsprogramm.
(Weitere Informationen finden Sie im entsprechenden Handbuch Installieren und Konfigurieren von
LiveCycle im Kapitel „Deinstallieren von LiveCycle-Produkten“.)
Softwareanforderungen für LiveCycle Forms 7.2 erfüllt sind.
9. Installieren Sie LiveCycle Forms 7.2 in einem neuen Verzeichnis (nicht im Standardverzeichnis). Wählen
Sie beispielsweise das Verzeichnis C:\Adobe\LiveCycle72\ oder /opt/adobe/livecycle72/. Befolgen Sie
im Handbuch Installieren und Konfigurieren von LiveCycle die Anleitungen unter „Installieren von
LiveCycle-Produkten“.
Hinweis: Wenn Sie mehrere LiveCycle 7.2-Produkte installieren oder aktualisieren, müssen Sie diese im
selben Verzeichnis [LiveCycle72-Stammverzeichnis] installieren.
Adobe LiveCycle
127
10. Kopieren Sie die Datei DocumentServicesLibrary.jar je nach verwendetem Anwendungsserver:
O
(WebLogic) Kopieren Sie die Datei aus dem Verzeichnis
[LiveCycle72-Stammverzeichnis]/components/csa/weblogic/lib/adobe in das Verzeichnis
[Anwendungsserver-Domäne]/lib.
O
(WebSphere) Kopieren Sie die Datei aus dem Verzeichnis
[LiveCycle72-Stammverzeichnis]/components/csa/websphere/lib/adobe in das Verzeichnis
[Anwendungsserver-Stammverzeichnis]/optionalLibraries.
O
(JBoss) Kopieren Sie die Datei aus dem Verzeichnis
[LiveCycle72-Stammverzeichnis]/components/csa/jboss/lib/adobe in das Verzeichnis
Hinweis: Bearbeiten Sie die mit LiveCycle Print 7.2 installierten XDC-Dateien, so dass sie den mit
Version 7.1 verwendeten Dateien entsprechen, und verwenden Sie diese bearbeiteten
Dateien. Informationen zu den mit LiveCycle Print gelieferten XDC-Dateien finden Sie im
Handbuch Erste Schritte sowie im Handbuch Editing XDC Files to Customize Printing Workflows
für LiveCycle Print.
12. Konfigurieren Sie LiveCycle Forms 7.2 mit Configuration Manager. (Weitere Informationen finden Sie im
Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel „Konfigurieren von LiveCycleProdukten für die Bereitstellung“.) Wählen Sie in den einzelnen Bildschirmen von Configuration
Manager die folgenden Optionen:
O
Konfigurationsmodus: Wählen Sie Assistent für die benutzerdefinierte Konfiguration.
O
Produktauswahl: Wählen Sie den verwendeten Anwendungsserver sowie die Optionen Plattform,
LiveCycle Forms und LiveCycle Print (falls zutreffend).
O
Adobe User Management-Auswahl: Wählen Sie eine der folgenden Optionen:
O
O
LiveCycle Forms mit User Management und Administrator: Wählen Sie diese Option, wenn
Sie in der vorherigen Bereitstellung LiveCycle Forms mit User Management verwendet hatten.
O
LiveCycle Forms ohne User Management und Administrator: Wählen Sie diese Option, wenn
Sie in der vorherigen Bereitstellung LiveCycle Forms ohne User Management verwendet hatten.
Taskauswahl: Wählen Sie die folgenden Optionen:
O
Produkte konfigurieren und assemblieren
O
Bootstrap-Datenbank (nur bei Verwendung von User Management in der Konfiguration)
Wählen Sie für WebSphere und WebLogic auch die folgenden Optionen:
O
Produkte bereitstellen
O
Bereitgestellte Produkte überprüfen
13. Führen Sie die Schritte durch, die in den übrigen Bildschirmen von Configuration Manager angezeigt
werden. Übernehmen Sie die Standardwerte in Configuration Manager unabhängig davon, ob Sie eine
Konfiguration mit User Management und Administrator oder ohne User Management und
Administrator durchführen.
Hinweis: Wenn Sie zum Festlegen des globalen Speicherverzeichnisses aufgefordert werden, geben
Sie dasselbe Verzeichnis an, das Sie derzeit für dieses Verzeichnis verwenden.
Führen Sie bei einer Bereitstellung auf WebSphere oder WebLogic die Schritte 14 und 15 durch. Führen
Sie bei einer Bereitstellung auf JBoss die Schritte 16 und 17 durch.
Adobe LiveCycle
128
14. (WebSphere und WebLogic) Wählen Sie im Bildschirm Produkte für die Bereitstellung bestätigen
die folgenden EAR-Dateien aus:
O
LiveCycle.ear
O
O
adobe-printSubmitter.ear (nur LiveCycle Print)
15. (WebSphere und WebLogic) Führen Sie die in den Bildschirmen von Configuration Manager
angezeigten Schritte durch, um die Datenbank zu initialisieren und die bereitgestellten Produkte zu
überprüfen.
16. (JBoss) Stellen Sie LiveCycle Forms 7.2 bereit. (Weitere Informationen finden Sie im Handbuch
Installieren und Konfigurieren von LiveCycle im Kapitel „Manuelles Bereitstellen auf JBoss“.)
17. (JBoss) (Konfiguration mit User Management) Führen Sie Configuration Manager aus, um die
Datenbank zu initialisieren. Wählen Sie Assistent für die benutzerdefinierte Konfiguration und
wählen Sie Bootstrap-Datenbank.
Hinweis: Das Initialisieren der Datenbank ist erforderlich, um dem Datenbankschema neue
Tabellenspalten hinzuzufügen. Das Initialisieren der Datenbank wirkt sich nicht auf die
vorhandenen Daten aus.
18. Stellen Sie die Dateien FormsIVS.ear bereit. Führen Sie dazu die für Ihren Anwendungsserver
erforderlichen Schritte durch. (Weitere Informationen finden Sie im Handbuch Installieren und
Konfigurieren von LiveCycle im Kapitel „Aufgaben nach der Bereitstellung von LiveCycle Forms“.)
19. Überprüfen Sie die Bereitstellung, indem Sie im Handbuch Installieren und Konfigurieren von LiveCycle
die Schritte unter „Aufgaben nach der Bereitstellung von LiveCycle Forms“ durchführen.
20. Aktualisieren Sie den Klassenpfad Ihrer Anwendung, indem Sie den Speicherort der JAR Files
formserver-client.jar, adobe-common.jar, datamanager-client.jar und AdobeCSAUtils.jar angeben.
Fügen Sie dem Klassenpfad der Anwendung die Datei um-client.jar hinzu, wenn die Anwendung das
Objekt InvocationContext in der Form Server Modul-API übergibt. Weitere Informationen zu
diesen Dateien finden Sie im Handbuch „Entwickeln benutzerdefinierter Anwendungen“, das sich im
Verzeichnis [LiveCycle72-Stammverzeichnis]/forms/documentation befindet.
³ So konfigurieren Sie LiveCycle Forms (ohne Verwendung von User Management):
2. Geben Sie die Einstellungen ein, die Sie beim Abrufen der LiveCycle Forms-Konfigurationseinstellungen aus der vorherigen LiveCycle.ear-Datei notiert haben. (Siehe „So rufen Sie die
Formularkonfigurationseigenschaften ab (für LiveCycle Forms 7.0 oder 7.1 ohne User Management):“
auf Seite 125.)
3. Klicken Sie auf Speichern.
Hinweis: Die an dieser Stelle geänderten Einstellungen werden nach einem Neustart des
Anwendungsservers nicht beibehalten.
Adobe LiveCycle
129
³ So konfigurieren Sie LiveCycle Forms (bei Verwendung von User Management):
2. Der Standardanschluss für WebLogic ist 7001. Wenn Sie einen verwalteten Server ausführen, haben Sie
4. Klicken Sie auf Dienste und dann auf Adobe LiveCycle Forms.
5. Geben Sie die Einstellungen ein, die Sie beim Abrufen der LiveCycle Forms-Konfigurationseinstellungen aus der vorherigen LiveCycle.ear-Datei notiert haben. (Siehe „So rufen Sie die
Formularkonfigurationseigenschaften ab (für LiveCycle Forms 7.0 oder 7.1 mit User Management):“ auf
Seite 125.)
6. Klicken Sie auf Speichern.
Dieser Abschnitt enthält Anleitungen zum Aktualisieren von LiveCycle Form Manager 7.0.1 auf LiveCycle
Form Manager 7.2. Für diese Aktualisierung müssen Sie die auf dem Anwendungsserver bereitgestellten
Serverkomponenten aktualisieren und die Datenbank initialisieren.
Sie sollten LiveCycle Form Manager 7.2 in einem neuen Verzeichnis installieren, damit die zuvor installierte
Version nicht überschrieben wird.
³ So aktualisieren Sie LiveCycle Form Manager 7.0.1 auf Version 7.2:
für LiveCycle Form Manager 7.0.1 gespeichert sind.
4. Befolgen Sie die Anleitungen im Handbuch Installieren und Konfigurieren für LiveCycle Form
Manager 7.0.1, um die Bereitstellung der folgenden Komponenten von LiveCycle Form Manager 7.0.1
aufzuheben:
O
O
LiveCycle.ear
O
LCMBootstrapper.war
Informationen zum Aufheben der Bereitstellung auf WebLogic oder WebSphere finden Sie in diesem
5. Beenden Sie WebLogic Server oder WebSphere Application Server.
Adobe LiveCycle
130
Softwareanforderungen für LiveCycle 7.2-Produkte erfüllt sind.
8. Installieren Sie LiveCycle Form Manager 7.2 in einem neuen Verzeichnis (nicht im Standardverzeichnis).
Wählen Sie beispielsweise das Verzeichnis C:\Adobe\LiveCycle72\ oder /opt/adobe/livecycle72/.
Befolgen Sie im Handbuch Installieren und Konfigurieren von LiveCycle die Anleitungen unter
„Installieren von LiveCycle-Produkten“.
O
O
O
11. Konfigurieren Sie LiveCycle Form Manager 7.2 mit Configuration Manager. (Weitere Informationen
finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel „Konfigurieren von
LiveCycle-Produkten für die Bereitstellung“.) Wählen Sie in den einzelnen Bildschirmen von
Configuration Manager die folgenden Optionen:
O
O
Produktauswahl: Wählen Sie den verwendeten Anwendungsserver sowie die Option Plattform
und das zu konfigurierende Produkt.
O
O
O
Bootstrap-Datenbank
O
O
12. Konfigurieren Sie die Datei LiveCycle.ear gemäß den Anleitungen in den Bildschirmen von
Configuration Manager. Vergewissern Sie sich, dass Sie die EAR-Datei für LiveCycle 7.2 mit denselben
Einstellungen konfigurieren, die Sie auch für Version 7.0.1 verwendet haben. Führen Sie bei einer
Bereitstellung auf WebSphere oder WebLogic die Schritte 13 und 14 durch. Führen Sie bei einer
Bereitstellung auf JBoss die Schritte 15 und 16 durch.
Adobe LiveCycle
LiveCycle Assembler, LiveCycle Workflow und Watched Folder
131
die folgenden EAR-Dateien aus:
O
LiveCycle.ear
O
überprüfen.
15. (JBoss) Stellen Sie die Komponenten für LiveCycle Form Manager 7.2 bereit. (Weitere Informationen
finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel „Manuelles Bereitstellen
auf JBoss“.)
16. (JBoss) Führen Sie Configuration Manager aus, um die Datenbank zu initialisieren. Wählen Sie
Assistent für die benutzerdefinierte Konfiguration und wählen Sie Bootstrap-Datenbank.
(Weitere Informationen finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel
„Initialisieren der Datenbank“.)
die Schritte unter „Aufgaben nach der Bereitstellung von LiveCycle Form Manager“ durchführen.
Hinweis: Sie können die Installation und Konfiguration auch mithilfe der unter
www.adobe.com/devnet/livecycle/samples.html verfügbaren Beispiele überprüfen.
In diesem Abschnitt wird die Aktualisierung der folgenden Produkte beschrieben:
O
LiveCycle Workflow 7.0.1 oder 7.2 auf LiveCycle Workflow 7.2.1
O
LiveCycle Assembler 7.2 auf LiveCycle Assembler 7.2.1
O
Watched Folder 1.0 auf Watched Folder 1.1
Wenn Sie LiveCycle Workflow als eigenständiges Produkt aktualisieren, führen Sie nicht die Schritte durch,
die sich auf Watched Folder oder LiveCycle Assembler beziehen. Watched Folder ist für die Verwendung
mit LiveCycle Assembler und LiveCycle Workflow vorgesehen, wobei LiveCycle Workflow vor Watched
Folder installiert werden muss.
Für diese Aktualisierung müssen Sie die auf dem Anwendungsserver bereitgestellten Serverkomponenten
aktualisieren und die Datenbank initialisieren. Sie sollten LiveCycle Assembler 7.2.1 in einem neuen
Verzeichnis installieren, damit die zuvor installierte Version nicht überschrieben wird.
Wenn Sie LiveCycle Assembler 7.2.1 mit Configuration Manager konfigurieren, müssen Sie sicherstellen,
dass Sie für die Option Sicherheitsgruppen denselben Wert wählen, den Sie auch bei LiveCycle
Assembler 7.2 verwendet haben. (Für diesen Wert kann ein Sternchen (*) gewählt werden, um nur
Benutzern mit einem gültigen Eintrag im LDAP-System die Anmeldung zu gestatten. Sie können den Wert
auch leer lassen, um allen Benutzern die Anmeldung zu ermöglichen.)
Adobe LiveCycle
132
³ So aktualisieren Sie auf LiveCycle Assembler 7.2.1, LiveCycle Workflow 7.2.1 und Watched
Folder 1.1:
für LiveCycle Workflow 7.0.1 oder 7.2 gespeichert sind.
4. Heben Sie die Bereitstellung der folgenden Dateien auf dem Anwendungsserver auf:
O
LiveCycle.ear
O
O
LCMBootstrapper.war
O
adobe-Assembler7.ear (nur LiveCycle Assembler)
5. (WebSphere und WebLogic) Beenden Sie den Anwendungsserver.
„Deinstallieren von LiveCycle-Produkten“.)
7. Installieren Sie LiveCycle Assembler 7.2.1 in einem neuen Verzeichnis (nicht im Standardverzeichnis).
Befolgen Sie im Handbuch Installieren und Konfigurieren von LiveCycle die Anleitungen unter
„Installieren von LiveCycle-Produkten“.
8. Installieren Sie LiveCycle Workflow 7.2.1 im selben Verzeichnis, in dem Sie auch LiveCycle
Assembler 7.2.1 installiert haben. Befolgen Sie dabei die Anleitungen unter „Installieren von
LiveCycle-Produkten“ im entsprechenden Handbuch Installieren und Konfigurieren von LiveCycle.
Hinweis: Sie können LiveCycle Assembler und LiveCycle Workflow in einer beliebigen Reihenfolge
installieren.
9. Installieren Sie Watched Folder im selben Verzeichnis, in dem Sie auch LiveCycle Workflow installiert
haben. Befolgen Sie dabei die Anleitungen unter „Installieren von Watched Folder“ im Handbuch
Installieren und Konfigurieren von LiveCycle. LiveCycle Workflow muss bereits installiert sein.
O
Adobe LiveCycle
133
O
O
(JBoss) Kopieren Sie die Datei aus dem Verzeichnis [LiveCycle72-Stammverzeichnis]/ components/
csa/jboss/lib/adobe in das Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/lib.
Kopieren Sie die Datei adobe-service.xml aus dem Verzeichnis [LiveCycle72-Stammverzeichnis]/
configurationManager/deploy/jboss in das Verzeichnis [Anwendungsserver-Stammverzeichnis]/
server/all/deploy/jms.
12. Konfigurieren Sie die LiveCycle-Produkte mit Configuration Manager. (Weitere Informationen finden
Sie im Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel „Konfigurieren von LiveCycleProdukten für die Bereitstellung“.) Wählen Sie in den einzelnen Bildschirmen von Configuration
Manager die folgenden Optionen:
O
O
Produktauswahl: Wählen Sie den verwendeten Anwendungsserver und wählen Sie die Option
Plattform sowie alle installierten Produkte.
O
O
O
Bootstrap-Datenbank
O
O
werden. Vergewissern Sie sich, dass Sie die EAR-Datei für Version 7.2.1 mit denselben Einstellungen
konfigurieren, die Sie auch für Version 7.0.1 bzw. 7.2 verwendet haben. Führen Sie bei einer
die Archive, die Sie bereitstellen:
O
O
LiveCycle.ear
O
adobe-Assembler7.ear (nur LiveCycle Assembler)
überprüfen.
16. (JBoss) Stellen Sie LiveCycle Assembler, LiveCycle Workflow und Watched Folder 7.2 bereit. (Weitere
Informationen finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel
„Manuelles Bereitstellen auf JBoss“.) Diese Komponenten bestehen aus folgenden EAR-Dateien:
O
LiveCycle.ear
Adobe LiveCycle
O
O
LCM.ear
O
adobe-Assembler7.ear
LiveCycle Workflow Designer
134
17. (JBoss) Führen Sie Configuration Manager aus, um die Datenbank neu zu initialisieren. Wählen Sie
18. Aktualisieren Sie die Assembler-QPAC. (Weitere Informationen finden Sie in den Handbüchern
Upgrading LiveCycle Workflow Designer oder Erstellen von Workflows im Dokumentationssatz von
LiveCycle Workflow.)
die Schritte im Abschnitt für Aufgaben nach der Bereitstellung durchführen.
LiveCycle Workflow Designer
Sie müssen die Version von LiveCycle Workflow Designer verwenden, die mit LiveCycle Workflow 7.2.1
geliefert wird. Wenn Sie die neue User-QPAC mit vorhandenen Workflows verwenden möchten, müssen
Sie Ihre Workflows migrieren.
Sie müssen die LiveCycle-QPACs von LiveCycle Workflow 7.0.1 oder 7.2 auf Version 7.2.1 aktualisieren.
Weitere Informationen finden Sie im Handbuch Erstellen von Workflows, das LiveCycle Workflow Designer
beiliegt, unter „Komponenten aktualisieren“.
³ So aktualisieren Sie LiveCycle Workflow Designer:
1. Deinstallieren Sie LiveCycle Workflow 7.0.1 Designer.
2. Installieren Sie LiveCycle Workflow 7.2.1 Designer. (Weitere Informationen finden Sie im Handbuch
Installieren und Konfigurieren von LiveCycle im Kapitel „Installieren von LiveCycle Workflow Designer“.)
Hinweis: LiveCycle Workflow 7.2.1 wird mit einer aktualisierten User-QPAC geliefert, die neue
Funktionen zur Verfügung stellt. Wenn Ihre Workflows Benutzeraktionen enthalten und Sie
die neuen Funktionen nutzen möchten, müssen Sie Ihre Workflows migrieren. Weitere
Informationen finden Sie im Handbuch Erstellen von Workflows im Kapitel „Workflows von
älteren Versionen migrieren“ oder in der LiveCycle Workflow Designer-Hilfe.
BAM Server für LiveCycle Workflow
In diesem Abschnitt finden Sie Richtlinien für die Aktualisierung auf eine neue Version von BAM Server. Sie
müssen das BAM Server-Aktualisierungsdienstprogramm verwenden, um die XML-Metadatendateien zu
aktualisieren, die Sie während der Aktualisierung aus LiveCycle Workflow Business Activity Monitor
exportieren.
Adobe LiveCycle
Informationen zum BAM Server-Aktualisierungsdienstprogramm
135
Die Aktualisierung von BAM Server umfasst die folgenden Aufgaben:
O
Exportieren der BAM-Metadaten mit BAM Workbench
O
Aktualisieren der BAM-Metadaten mit dem BAM Server-Aktualisierungsdienstprogramm
O
Aufheben der Bereitstellung der EAR-Datei von BAM Server auf dem Anwendungsserver
O
Entfernen der Wiederherstellungsprotokolldateien und Ablegen der vorhandenen Tabellen in der
O
Bereitstellen der EAR-Datei von BAM Server, die mit LiveCycle Workflow 7.2.1 geliefert wird
O
Importieren der aktualisierten BAM-Metadaten mit BAM Workbench
Mit dem BAM Server-Aktualisierungsdienstprogramm werden exportierte Metadatendateien aktualisiert,
so dass sie die neuen, für die aktuelle Produktversion erforderlichen Funktionen aufweisen.
Das BAM Server-Aktualisierungsdienstprogramm liegt der Datei cqupgrade.JAR bei. Wenn Sie LiveCycle
Workflow installieren, wird diese Datei im Verzeichnis [LiveCycle-Stammverzeichnis]/Workflow/bam/
CQUpgrade abgelegt.
Hinweis: Das Aktualisierungsdienstprogramm gibt die Meldung Error parsing input file aus, wenn die
Dateien nicht aktualisiert werden können. Wenn dieser Fehler ausgegeben wird, ist die in der
Fehlermeldung genannte Datei möglicherweise beschädigt. Wenden Sie sich in diesem Fall an
den Support von Adobe Systems.
Syntax
Mit dem folgenden Befehl werden Metadatendateien aktualisiert, die in eine JAR File exportiert wurden:
java -jar cqupgrade.jar -jar -i inJar.jar [-o outJar.jar]
Parameter
Im BAM Server-Aktualisierungsdienstprogramm können die folgenden Parameter verwendet werden:
inJar.jar: Der Pfad zu der JAR File, in der die zu aktualisierenden exportierten Metadaten
gespeichert sind.
outJar.jar (optional): Der Pfad zur aktualisierten JAR File. Wenn Sie diesen Parameter nicht
angeben, werden die aktualisierten Dateien in der mit inJar.jar angegebenen JAR File gespeichert.
Die folgenden Beispielen enthalten Befehle, die Sie zum Aktualisieren von in JAR Files gespeicherten
Metadaten mit dem BAM Server-Aktualisierungsdienstprogramm verwenden können.
O
Mit dem folgenden Befehl werden die Metadatendateien aktualisiert, die in einer JAR File mit dem
Namen toUpgrade.jar enthalten sind. Diese Datei befindet sich im selben Verzeichnis wie die Datei
cqupgrade.jar:
java -jar cqupgrade.jar -i toUpgrade.jar
O
Mit dem folgenden Befehl werden die Metadatendateien aktualisiert, die in der JAR File toUpgrade.jar
enthalten sind. Die aktualisierten Dateien werden in einer anderen JAR File mit dem Namen
upgraded.jar gespeichert. Die Datei wird im selben Verzeichnis gespeichert, in dem sich auch
cqupgrade.jar befindet:
java -jar cqupgrade.jar -i toUpgrade.jar -o upgraded.jar
Adobe LiveCycle
136
³ So aktualisieren Sie Business Activity Monitor:
1. Melden Sie sich bei BAM Workbench an.
2. Klicken Sie auf die Registerkarte Administration und dann auf Import/Export.
3. Wählen Sie im Menü Operations die Option Export Metadata to a JAR File (download).
4. Klicken Sie im Dialogfeld File Download auf Save.
5. Legen Sie einen Speicherort und einen Dateinamen für die exportierte JAR File fest und klicken Sie auf
Save.
6. Klicken Sie im Dialogfeld Download Complete auf Close.
7. Klicken Sie auf System Settings und dann auf die Registerkarte Checkpoint Configuration. Notieren
Sie sich den Verzeichnispfad im Feld Recovery Log Directory. In einem späteren Schritt benötigen Sie
den Pfad zu diesem Verzeichnis, in dem die Dateien des Wiederherstellungsprotokolls gespeichert
sind.
8. Fahren Sie Business Activity Monitor herunter.
9. Aktualisieren Sie mit dem BAM Server-Aktualisierungsdienstprogramm (cqupgrade.jar) die Metadaten,
die Sie in eine JAR File exportiert haben. (Siehe „Informationen zum BAM
Server-Aktualisierungsdienstprogramm“ auf Seite 135.)
10. Heben Sie die Bereitstellung der EAR-Datei von BAM Server auf, indem Sie die Schritte für den
entsprechenden Anwendungsserver durchführen:
O
(JBoss) Löschen Sie die folgenden Verzeichnisse:
O
[JBoss-BAM-Stammverzeichnis]/server/default/work
O
[JBoss-BAM-Stammverzeichnis]/server/default/tmp
O
[JBoss-BAM-Stammverzeichnis]/server/default/data
O
[JBoss-BAM-Stammverzeichnis]/server/conf/jboss.web
O
(WebSphere) Heben Sie mit der Verwaltungskonsole von WebSphere die Bereitstellung der alten
EAR-Datei von BAM Server auf.
O
(WebLogic) Heben Sie mit der Verwaltungskonsole von WebLogic Server die Bereitstellung der
alten EAR-Datei von BAM Server auf.
11. Löschen Sie aus dem Verzeichnis des Wiederherstellungsprotokolls alle Dateien, deren Namen
Ähnlichkeit mit den folgenden Benennungsmustern aufweisen:
O
filestore*.dat
O
DEFAULTRECOVERYLOGGER_*
O
chkpoint_.x
12. Legen Sie die Datenbanktabellen, in denen die BAM-Metadaten gespeichert sind, mit einem
Datenbankverwaltungsprogramm in der BAM-Metadaten-Datenbank ab. Sie können auch eine neue
BAM-Metadaten-Datenbank erstellen. Weitere Informationen zur BAM-Metadaten-Datenbank finden
Sie im Handbuch Installieren und Konfigurieren von LiveCycle für den entsprechenden Anwendungsserver unter „Erstellen der BAM-Metadaten-Datenbank“.
Adobe LiveCycle
137
13. Stellen Sie die neue Version von BAM Server auf dem Anwendungsserver bereit. (Weitere
Informationen finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel
„Bereitstellen von BAM Server“.)
14. Melden Sie sich bei BAM Workbench an.
15. Überprüfen Sie die Konfigurationseinstellungen von BAM Server, um zu ermitteln, ob Aktualisierungen
erforderlich sind. (Weitere Informationen finden Sie im Handbuch Installieren und Konfigurieren von
LiveCycle im Kapitel „Erste Schritte mit BAM Server“.)
16. Klicken Sie auf die Registerkarte Administration und dann auf Import/Export.
17. Wählen Sie im Menü Operations die Option Import Metadata from a JAR File (upload).
18. Klicken Sie auf Browse, um zu der JAR File zu wechseln, in der die aktualisierten BAM-Metadaten
gespeichert sind, und klicken Sie auf OK.
19. Starten Sie die BAM Server-Instanz neu.
Damit Sie eine Aktualisierung von LiveCycle PDF Generator 7.0.1 oder 7.0.2 auf LiveCycle PDF
Generator 7.2 durchführen können, müssen Sie die Bereitstellung des derzeit verwendeten Produkts
aufheben, bevor Sie das neue Produkt installieren und bereitstellen können.
Die Anleitungen in diesem Abschnitt beziehen sich auf LiveCycle PDF Generator für PostScript, LiveCycle
PDF Generator Elements und LiveCycle PDF Generator Professional.
³ So aktualisieren Sie LiveCycle PDF Generator 7.0.2 auf LiveCycle PDF Generator 7.2:
für LiveCycle PDF Generator 7.0.1 oder 7.0.2 gespeichert sind.
3. (JBoss) Wenn Ihre Bereitstellung von LiveCycle PDF Generator auf JBoss Application Server mit einer
MySQL-Datenbank ausgeführt wird, die Sie mit der Turnkey-Option installiert haben, beenden Sie die
Dienste JBoss for Adobe LiveCycle und MySQL for Adobe LiveCycle.
4. Wenn Sie LiveCycle PDF Generator Professional oder LiveCycle PDF Generator Elements installieren,
müssen Sie zunächst Adobe Acrobat 7.0.5 in der Systemsteuerung von Microsoft Windows über die
Option Software deinstallieren und danach das System neu starten.
5. Befolgen Sie die Anleitungen im Handbuch Installieren und Konfigurieren für LiveCycle PDF
Generator 7.0.2, um die Bereitstellung der folgenden Komponenten von LiveCycle PDF Generator
aufzuheben:
O
pdfg-all.ear (oder pdfg-ps-all.ear)
O
LiveCycle.ear
O
Adobe LiveCycle
O
138
LCMBootstrapper.war
6. (WebSphere und WebLogic) Beenden Sie den Anwendungsserver.
„Deinstallieren von LiveCycle-Produkten“.)
8. Installieren Sie LiveCycle PDF Generator 7.2 in einem neuen Verzeichnis (nicht im Standardverzeichnis).
Wählen Sie beispielsweise den Ordner C:\Adobe\LiveCycle72\ oder /opt/adobe/livecycle72/. Befolgen
Sie im Handbuch Installieren und Konfigurieren von LiveCycle die Anleitungen unter „Installieren von
LiveCycle-Produkten“.
O
O
O
[Anwendungsserver-Stammverzeichnis]/server/all/lib. Kopieren Sie die Datei adobe-service.xml aus
dem Verzeichnis [LiveCycle72-Stammverzeichnis]/configurationManager/deploy/jboss in das
Verzeichnis [Anwendungsserver-Stammverzeichnis]/server/all/deploy/jms.
11. Konfigurieren Sie die LiveCycle-Produkte mit Configuration Manager. (Weitere Informationen finden
Sie im Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel „Konfigurieren von
LiveCycle-Produkten für die Bereitstellung“.) Wählen Sie in den einzelnen Bildschirmen von
Configuration Manager die folgenden Optionen:
O
O
Produktauswahl: Wählen Sie den verwendeten Anwendungsserver aus und wählen Sie die
Optionen Plattform und LiveCycle PDF Generator.
O
Taskauswahl: Wählen Sie alle der folgenden Optionen:
O
O
Bootstrap-Datenbank
O
O
werden. Vergewissern Sie sich, dass Sie die EAR-Datei für LiveCycle 7.2 mit denselben Einstellungen
Adobe LiveCycle
139
konfigurieren, die Sie auch für Version 7.0.2 verwendet haben. Führen Sie bei einer Bereitstellung auf
WebSphere oder WebLogic die Schritte 13 und 14 durch. Führen Sie bei einer Bereitstellung auf JBoss
die Schritte 15 und 16 durch.
O
O
O
LiveCycle.ear
überprüfen.
15. (JBoss) Stellen Sie die Komponenten von LiveCycle PDF Generator 7.2 bereit:
O
LiveCycle.ear
O
O
LCM.ear
O
„Manuelles Bereitstellen auf JBoss“.)
die Schritte unter „Aufgaben nach der Bereitstellung von LiveCycle PDF Generator“ durchführen.
³ So konfigurieren Sie JMS Messaging für WebSphere unter Windows:
1. Löschen Sie in der Verwaltungskonsole von WebSphere die JMS-Warteschlangen, Themen und Listener
Ports jedes Servers.
2. Konfigurieren Sie WebSphere MQ, indem Sie im Handbuch Installieren und Konfigurieren von LiveCycle
die Schritte unter „Konfigurieren von JMS-Ressourcen für WebSphere MQ“ durchführen.
3. Führen Sie die mit Configuration Manager gelieferten Skripten aus, um in der MQ-Installation
Warteschlagen zu erstellen, indem Sie im Handbuch Installieren und Konfigurieren von LiveCycle die
Schritte unter „Vorbereiten von WebSphere MQ“ durchführen.
Adobe LiveCycle
LiveCycle Document Security
140
4. Führen Sie Configuration Manager erneut aus und wählen Sie die Aufgabe Anwendungsserver
konfigurieren. Führen Sie die in Configuration Manager angezeigten Schritte durch, um die
Einstellungen des Anwendungsservers zu konfigurieren. (Weitere Informationen finden Sie im
Handbuch Installieren und Konfigurieren von LiveCycle im Kapitel „Ändern der Einstellungen des
Anwendungsservers“.) Wählen Sie in den einzelnen Bildschirmen von Configuration Manager die
folgenden Optionen:
O
JVM-Einstellungen: Wählen Sie Nicht anwenden.
O
JMS-Einstellungen: Legen Sie Werte für die Eigenschaften des MQ-Dienstes fest.
O
Erstellen der Datenquelle: Wählen Sie Nicht anwenden.
5. Klicken Sie im Bildschirm Anwendungsserver konfigurieren auf Einstellungen jetzt anwenden, um
den Anwendungsserver zu konfigurieren. Wenn der Vorgang abgeschlossen ist, klicken Sie auf Weiter.
6. Starten Sie den Anwendungsserver neu und klicken Sie im Bildschirm Anwendungsserver/-Cluster
neu starten auf Weiter, wenn Sie eine weitere Aufgabe für Configuration Manager ausgewählt haben,
bzw. auf Fertig stellen, wenn Sie Configuration Manager schließen möchten.
7. Überprüfen Sie, ob die Anwendungen korrekt gestartet werden.
Dieser Abschnitt enthält Anleitungen zum Aktualisieren von LiveCycle Document Security 7.0 oder 7.1 auf
LiveCycle Document Security 7.2. Für diese Aktualisierung müssen Sie die auf dem Anwendungsserver
bereitgestellten Serverkomponenten aktualisieren.
Sie sollten LiveCycle Document Security 7.2 in einem neuen Verzeichnis installieren, damit die zuvor
installierte Version nicht überschrieben wird.
³ So aktualisieren Sie LiveCycle Document Security 7.2:
1. Erstellen Sie Sicherungskopien der folgenden Dateien und Ordner:
O
../trust.xml
O
../credentials/
O
../certificates/
O
../CRLs/
O
../keystore
O
../trust.sig
3. Heben Sie die Bereitstellung der folgenden Komponenten von LiveCycle Document Security auf,
indem Sie die Anleitungen im Handbuch Installieren und Konfigurieren für LiveCycle Document
Security 7.0 oder 7.1 befolgen:
WebSphere und WebLogic
JBoss
adobe-FontManager.bar
adobe-PDFManipulation.war
adobe-PDFManipulation.bar
Adobe LiveCycle
adobe-TrustManager.war
adobe-TrustManager.bar
DataManagerService.war
AdobeServices.sar
ServicesNatives-2.war
adobe-APSProxy.war
adobe-APSProxy.bar
141
4. (WebSphere) Richten Sie Standardbenutzer, Rollen und Anmeldedateien ein, indem Sie im Handbuch
Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten die Schritte unter „So erstellen Sie eine
Zuordnung zwischen Benutzern und Rollen“ durchführen. (Dieses Verfahren muss jedes Mal
durchgeführt werden, wenn die Datei LiveCycle-security.ear neu bereitgestellt wird.)
7. Installieren Sie LiveCycle Document Security 7.2 in einem neuen Verzeichnis (nicht im
Standardverzeichnis). Wählen Sie beispielsweise den Ordner C:\Adobe\LiveCycle72\ oder
/opt/adobe/livecycle72/. Befolgen Sie im Handbuch Installieren und Konfigurieren von
LiveCycle-Sicherheitsprodukten die Anleitungen unter „Installieren von LiveCycle-Produkten“.
O
O
O
9. Konfigurieren Sie LiveCycle Document Security 7.2 mit Configuration Manager. (Siehe „Konfigurieren
von LiveCycle-Produkten“.) Wählen Sie in den einzelnen Bildschirmen von Configuration Manager die
folgenden Optionen:
O
O
O
O
O
Bootstrap-Datenbank
O
O
Adobe LiveCycle
LiveCycle Reader Extensions
O
Auswahl des Verzeichnisses „trust“: Wählen Sie Neues Verzeichnis „trust“ erstellen.
O
Keystore-Auswahl: Wählen Sie Neuen Keystore und neues Schlüsselpaar erstellen.
142
werden. Vergewissern Sie sich, dass Sie die EAR-Datei für Version 7.2 mit denselben Einstellungen
konfigurieren, die Sie auch für Version 7.0 bzw. 7.1 verwendet haben. Führen Sie bei einer
Hinweis: Wenn Sie zur Eingabe des globalen Speicherverzeichnisses aufgefordert werden, geben Sie
dasselbe Verzeichnis an, das Sie derzeit für temporäre Dateien von Adobe LiveCycleProdukten verwenden.
O
O
LiveCycle.ear
O
LiveCycle-security.ear
überprüfen.
13. (JBoss) Stellen Sie LiveCycle Document Security 7.2 bereit. (Weitere Informationen finden Sie im
Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten im Kapitel „Manuelles
Bereitstellen auf JBoss“.)
(Weitere Informationen finden Sie im Handbuch Installieren und Konfigurieren von LiveCycleSicherheitsprodukten im Kapitel „Initialisieren der Datenbank“.)
16. Überprüfen Sie die Installation und Konfiguration mithilfe der unter
www.adobe.com/devnet/livecycle/samples.html verfügbaren Beispiele.
Dieser Abschnitt enthält Anleitungen zum Aktualisieren von LiveCycle Reader Extensions 7.0 oder 7.0.2
auf LiveCycle Reader Extensions 7.2. Für diese Aktualisierung müssen Sie die auf dem Anwendungsserver
bereitgestellten Serverkomponenten aktualisieren.
Hinweis: (JBoss) Wenn Sie zuvor LiveCycle Reader Extensions mit der Turnkey-Methode auf Windows für
die Bereitstellung auf JBoss installiert haben, finden Sie im Handbuch Installieren und
Konfigurieren von LiveCycle-Sicherheitsprodukten im Abschnitt „So aktualisieren Sie LiveCycle
Reader Extensions mit der Turnkey-Methode“ Anleitungen für die Aktualisierung.
Sie sollten LiveCycle Reader Extensions 7.2 in einem neuen Verzeichnis installieren, damit die zuvor
installierte Version nicht überschrieben wird.
Adobe LiveCycle
143
Wenn Sie eine vorhandene Berechtigung verwenden, vergewissern Sie sich, dass die Berechtigung nicht
abgelaufen und weiterhin gültig ist. (Weitere Informationen finden Sie im Handbuch Installieren und
Konfigurieren von LiveCycle-Sicherheitsprodukten im Kapitel „Berechtigungen für Rechte von LiveCycle
Reader Extensions“.)
Benutzerdefinierte Anwendungen mit vorhandenen APIs, die in Adobe Document Services 6.0 for Reader
Extensions unterstützt waren, werden in LiveCycle Reader Extensions 7.2 nicht mehr unterstützt.
Benutzerdefinierte Anwendungen mit vorhandenen APIs, die in Adobe Document Services 6.1 unterstützt
waren, werden in LiveCycle Reader Extensions 7.2 weiterhin unterstützt und sind funktionsfähig.
Digitale Zertifikate, die für die Verwendung mit Reader Extensions Server 6.1 ausgestellt wurden, sind mit
LiveCycle Reader Extensions 7.2 kompatibel. Wenn Sie eine Aktualisierung von Version 6.1 auf Version 7.2
durchführen, erhalten Sie keine neue Berechtigung für Rechte.
³ So aktualisieren Sie LiveCycle Reader Extensions auf Version 7.2:
1. Erstellen Sie Sicherungskopien der folgenden Dateien und Ordner im Verzeichnis
[LiveCycle-Stammverzeichnis]/ReaderExtensions/trust:
O
../trust.xml
O
../credentials/
O
../certificates/
O
../CRLs/
O
../keystore
O
../trust.sig
3. Heben Sie die Bereitstellung der folgenden Komponenten von LiveCycle Reader Extensions auf, indem
Sie die Anleitungen im Handbuch Installieren und Konfigurieren für LiveCycle Reader Extensions 7.0
oder 7.0.2 befolgen:
WebSphere und WebLogic
JBoss
adobe-FontManager.bar
adobe-PDFManipulation.war
adobe-PDFManipulation.bar
adobe-TrustManager.war
adobe-TrustManager.bar
DataManagerService.war
AdobeServices.sar
ares.ear
ares.ear
adobe-CredentialSecurityEJB.ear
adobe-CredentialSecurityEJB.ear
adobe-APSProxy.war
adobe-APSProxy.bar
Adobe LiveCycle
144
6. Installieren Sie LiveCycle Reader Extensions 7.2 in einem neuen Verzeichnis (nicht im
Standardverzeichnis). Wählen Sie beispielsweise den Ordner C:\Adobe\LiveCycle72\ oder
/opt/adobe/livecycle72/. Befolgen Sie im Handbuch Installieren und Konfigurieren von
LiveCycle-Sicherheitsprodukten die Anleitungen unter „Installieren von LiveCycle-Produkten“.
O
O
O
8. Konfigurieren Sie LiveCycle Reader Extensions 7.2 mit Configuration Manager. (Weitere Informationen
finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten im Kapitel
„Konfigurieren von LiveCycle-Produkten für die Bereitstellung“.) Wählen Sie in den einzelnen
Bildschirmen von Configuration Manager die folgenden Optionen:
O
O
O
O
O
O
O
Auswahl des Verzeichnisses „trust“: Wählen Sie Neues Verzeichnis „trust“ erstellen.
O
Keystore-Auswahl: Wählen Sie Neuen Keystore und neues Schlüsselpaar erstellen.
werden. Vergewissern Sie sich, dass Sie die EAR-Datei für Version 7.2 mit denselben Einstellungen
konfigurieren, die Sie auch für Version 7.0 bzw. 7.1 verwendet haben. Führen Sie bei einer
Bereitstellung auf JBoss Schritt 12 durch.
Hinweis: Wenn Sie zur Eingabe des globalen Speicherverzeichnisses aufgefordert werden, geben Sie
dasselbe Verzeichnis an, das Sie derzeit für temporäre Dateien von Adobe LiveCycleProdukten verwenden.
O
O
LiveCycle.ear
Adobe LiveCycle
O
145
LiveCycle-security.ear
überprüfen.
12. (JBoss) Stellen Sie LiveCycle Reader Extensions 7.2 bereit. (Weitere Informationen finden Sie im
Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten im Kapitel „Manuelles
Bereitstellen auf JBoss“.)
14. Überprüfen Sie die Installation und Konfiguration, indem Sie zur entsprechenden URL wechseln:
O
(WebLogic) http://[Hostname]:7001/ReaderExtensions oder
http://[Hostname]:8001/ReaderExtensions (verwalteter Server)
O
(WebSphere) http://[Hostname]:9080/ReaderExtensions
O
(JBoss) http://[Hostname]:8080/ReaderExtensions
15. Geben Sie den Benutzernamen und das Kennwort ein, die Sie beim Konfigurieren des Benutzers von
LiveCycle Reader Extensions erstellt haben. (Weitere Informationen finden Sie im Handbuch Installieren
und Konfigurieren von LiveCycle-Sicherheitsprodukten in den Kapiteln „Einrichten von Benutzern, Rollen
und Anmeldedateien“ für JBoss oder WebLogic bzw. „So erstellen Sie eine Zuordnung zwischen
Benutzern und Rollen“ für WebSphere.)
³ (JBoss) So aktualisieren Sie LiveCycle Reader Extensions mit der Turnkey-Methode:
1. Beenden Sie in der Windows-Systemsteuerung im Bereich Verwaltung unter Dienste den
Windows-Dienst AdobeReaderExtensions.
2. Vergewissern Sie sich, dass Anschluss 8080 nicht verwendet wird.
3. Bei der Turnkey-Installation werden der Host auf localhost und die Anschlussnummer für JBoss auf
8080 eingestellt. Wenn JBoss bereits installiert ist, müssen Sie sich vergewissern, dass Anschluss 8080
noch nicht verwendet wird. Sie können bei der Turnkey-Installation und -Konfiguration keinen anderen
Host oder Anschluss für JBoss konfigurieren.
4. Installieren Sie LiveCycle Reader Extensions 7.2 mit der Turnkey-Methode in einem neuen Verzeichnis
(nicht im Standardverzeichnis). Wählen Sie beispielsweise den Ordner C:\Adobe\LiveCycle72\. Befolgen
Sie im Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten die Anleitungen
unter „Installieren von LiveCycle Reader Extensions oder LiveCycle Document Security“.
5. Überprüfen Sie die Installation und Konfiguration, indem Sie zur URL
http://[Hostname]:8080/ReaderExtensions wechseln.
Hinweis: Bei Turnkey-Installationen werden standardmäßig der Benutzername administrator und das
Kennwort password verwendet. Informationen zum Bearbeiten dieser Werte finden Sie im
Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten unter „Einrichten
von Benutzern, Rollen und Anmeldedateien“.
Adobe LiveCycle
LiveCycle Policy Server
146
Dieser Abschnitt enthält Anleitungen zum Aktualisieren von LiveCycle Policy Server 7.0.2 auf LiveCycle
Policy Server 7.2. Für diese Aktualisierung müssen Sie die auf dem Anwendungsserver bereitgestellten
Serverkomponenten aktualisieren und die Datenbank initialisieren.
Sie sollten LiveCycle Policy Server 7.2 in einem neuen Verzeichnis installieren, damit die zuvor installierte
Version nicht überschrieben wird.
³ So aktualisieren Sie LiveCycle Policy Server auf Version 7.2:
für LiveCycle Policy Server 7.0.2 gespeichert sind.
3. Heben Sie die Bereitstellung der folgenden Komponenten von LiveCycle Policy Server 7.0.2 auf:
O
asn1.jar
O
jsafe.jar
O
jsafeJCE.jar
O
edc-server-spi.jar
O
edc-server.ear
4. Entfernen Sie alle Dateien mit dem Dateinamen dom*.JAR aus dem Verzeichnis
[Anwendungsserver-Stammverzeichnis]/java/jre/lib/endorsed.
6. Installieren Sie LiveCycle Policy Server 7.2 in einem neuen Verzeichnis (nicht im Standardverzeichnis).
Befolgen Sie im Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten die
Anleitungen unter „Installieren von LiveCycle-Produkten“.
7. Stellen Sie LiveCycle Policy Server 7.2 bereit. (Informationen zum manuellen Bereitstellen des
Anwendungsservers finden Sie im Handbuch Installieren und Konfigurieren von LiveCycleSicherheitsprodukten für den entsprechenden Anwendungsserver.)
8. Führen Sie Configuration Manager aus, um die Datenbank neu zu initialisieren. Wählen Sie Assistent
für die benutzerdefinierte Konfiguration und wählen Sie Bootstrap-Datenbank. (Weitere
Informationen finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten
im Kapitel „Initialisieren der Datenbank“.)
Adobe LiveCycle
147
9. Konfigurieren Sie die verschiedenen Laufzeiteinstellungen für LiveCycle Policy Server. (Weitere
Informationen finden Sie im Handbuch Installieren und Konfigurieren von LiveCycle-Sicherheitsprodukten
im Abschnitt für Aufgaben nach der Bereitstellung.)
Hinweis: Sie können die Installation und Konfiguration mithilfe der unter
G
Verbessern der Serverleistung
Dieser Anhang enthält allgemeine Tipps zum Verbessern der Serverleistung bei der Arbeit mit
LiveCycle-Produkten.
Optimieren von Inline-Dokumenten und Auswirkungen auf den
JVM-Speicher
Wenn Sie in der Regel kleinere Dokumente verarbeiten, können Sie die Leistung in Bezug auf die
Übertragungsgeschwindigkeit von Dokumenten und den Speicherplatz durch die folgenden
LiveCycle-Produktkonfigurationen optimieren:
O
Erhöhen Sie die Inline-Maximalgröße für LiveCycle-Produkte, so dass diese über der Größe der meisten
Dokumente liegt.
O
Wenn Sie größere Dateien verarbeiten, legen Sie Speicherverzeichnisse fest, die sich in einem
Hochgeschwindigkeits-Festplattensystem oder auf einer RAM-Disk befinden.
Die standardmäßige Inline-Maximalgröße und die Speicherverzeichnisse (temporäres Speicherverzeichnis
für Adobe LiveCycle-Produkte und globales Speicherverzeichnis) sind Eigenschaften des Data ManagerModuls. Sie können das Data Manager-Modul mit Configuration Manager konfigurieren. (Siehe
Hinweis: Der Standardwert für die Inline-Maximalgröße beträgt 65.536 Byte.
Dokumentgröße und Inline-Maximalgröße
Wenn ein Dokument, das von LiveCycle-Produkten zur Verarbeitung gesendet wird, kleiner als oder gleich
der Inline-Maximalgröße ist, wird es als Inline-Dokument auf dem Server gespeichert und als AdobeDokumentobjekt serialisiert. Die Inline-Speicherung von Dokumenten kann die Leistung erheblich
steigern. Wenn Sie jedoch mit LiveCycle Workflow arbeiten, wird der Inhalt gegebenenfalls auch in der
Datenbank gespeichert, um eine einfachere Verfolgung zu gewährleisten. Eine Erhöhung der
Inline-Maximalgröße kann sich daher auf die Datenbankgröße auswirken.
Dokumente, die die Inline-Maximalgröße überschreiten, werden im lokalen Dateisystem gespeichert, d. h.
in dem Speicherverzeichnis, das über Configuration Manager festgelegt wurde. Das AdobeDokumentobjekt, das von und zum Server übertragen wird, ist lediglich ein Verweis auf diese Datei.
Wenn der Dokumentinhalt kleiner als die Inline-Maximalgröße ist, wird er in der Datenbank (als Teil des
Serialisierungsaufkommens des Dokuments) gespeichert. Eine Erhöhung der Inline-Maximalgröße kann
sich also auf die Datenbankgröße auswirken.
Maximale JVM-Heapgröße
Wenn die Inline-Maximalgröße erhöht wird, ist mehr Speicher zum Ablegen der serialisierten Dokumente
erforderlich. Daher muss in der Regel auch die JVM-Einstellung Maximale Heap-Größe erhöht werden.
Die maximale JVM-Heapgröße sollte nicht über 2 GB liegen.
Bei einem hoch ausgelasteten System, das eine Vielzahl von Dokumenten verarbeitet, kann der
JVM-Heapspeicher schnell erschöpft werden. Um Fehler wegen ungenügenden Speicherplatzes zu
148
Adobe LiveCycle
Erhöhen des der JVM zugewiesenen maximalen Speichers
149
verhindern, muss die maximale JVM-Heapgröße um einen Wert erhöht werden, der dem Produkt aus der
Größe der Inline-Dokumente und der Anzahl der Dokumente entspricht, die in der Regel zu einem
bestimmten Zeitpunkt ausgeführt werden.
Erhöhung der maximalen JVM-Heapgröße = (Größe der Inline-Dokumente) * (Durchschnittliche Anzahl
verarbeiteter Dokumente)
Beispiel G.1
Berechnen der maximalen JVM-Heapgröße
In diesem Beispiel wurden die maximale JVM-Heapgröße ursprünglich auf 512 MB und die InlineMaximalgröße auf 64 KB eingestellt. Der Server muss für die gleichzeitige Ausführung von 100 Aufträgen
konfiguriert werden, wobei jeder Auftrag neun Eingabedateien und eine Ergebnisdatei umfasst (d. h. zehn
Dateien pro Auftrag und 1000 gleichzeitig verarbeitete Dateien). Die Größe all dieser Dateien liegt unter
512 KB.
Damit alle Dateien als Inline-Dateien gespeichert werden können, muss die Inline-Maximalgröße auf
mindestens 512 KB eingestellt werden.
Die erforderliche Erhöhung der maximalen JVM-Heapgröße wird mit der folgenden Gleichung berechnet:
(512 KB) x (1000) = 512000 KB oder 512 MB
Die maximale JVM-Heapgröße muss daher um 512 MB erhöht werden, so dass sie insgesamt 1 GB beträgt.
Heapfragmentierung
Wenn die Größe von Inline-Dokumenten auf einen hohen Wert eingestellt wird, erhöht sich dadurch das
Risiko für Fehler wegen ungenügenden Speicherplatzes bei Systemen, die für Heapfragmentierungen
anfällig sind. Zur Inline-Speicherung eines Dokuments muss im JVM-Heapspeicher ein genügend großer
zusammenhängender Speicherblock zur Verfügung stehen. Einige Betriebssysteme, JVMs und
Löschprogrammalgorithmen (so genannte „Garbage Collectors“) sind für Fragmentierungen des
Heapspeichers anfällig. Die Fragmentierung reduziert die Größe des zusammenhängenden Heapspeichers, so dass Fehler wegen ungenügenden Speicherplatzes auch dann auftreten können, wenn der
insgesamt verfügbare freie Heapspeicher ausreichend ist.
Dies kann beispielsweise der Fall sein, wenn sich der JVM-Heap nach der Ausführung anderer Vorgänge
auf dem Anwendungsserver in einem fragmentierten Zustand befindet und der Garbage Collector den
Heap nicht genügend komprimieren kann, um große, zusammenhängende Speicherblöcke zu bilden.
Fehler wegen ungenügenden Speicherplatzes können auch dann noch auftreten, wenn die maximale
JVM-Heapgröße an die erhöhte Inline-Maximalgröße angepasst wurde.
Um die Heapfragmentierung zu berücksichtigen, darf die Inline-Dokumentgröße auf nicht mehr als 0,1 %
der gesamten Heapgröße eingestellt werden. Mit einer maximalen JVM-Heapgröße von 512 MB kann
beispielsweise eine Inline-Maximalgröße von 512 MB * 0,001 = 0,512 MB oder 512 KB unterstützt werden.
Erhöhen des der JVM zugewiesenen maximalen Speichers
Dieser Abschnitt findet nur auf WebSphere Anwendung.
Wenn Sie LiveCycle Configuration Manager ausführen oder versuchen, EJB-Bereitstellungscode über das
Befehlszeilen-Dienstprogramm ejbdeploy zu erstellen und ein Fehler wegen ungenügenden Speicherplatzes auftritt, müssen Sie die Größe des Speichers erhöhen, der der JVM zugewiesen ist.
Adobe LiveCycle
Löschen temporärer Dateien aus dem globalen Speicherverzeichnis
150
³ So erhöhen Sie den der JVM zugewiesenen maximalen Speicher:
1. Bearbeiten Sie im Verzeichnis {WAS_install_root}/deploytool/itp/ das Skript ejbdeploy:
O
(Windows) ejbdeploy.bat
O
(Linux) ejbdeploy.sh
2. Suchen Sie den Parameter -Xmx256M und erhöhen Sie den dort festgelegten Wert, z. B. -Xmx1024M.
3. Speichern Sie die Datei.
4. Führen Sie das Skript ejbdeploy aus oder starten Sie LiveCycle Configuration Manager neu.
Löschen temporärer Dateien aus dem globalen
Speicherverzeichnis
Bei der Ausführung eines Workflow-Prozesses werden temporäre Dateien im globalen Speicherverzeichnis
abgelegt, am Ende des Prozesses jedoch nicht gelöscht. Diese Dateien werden in Unterverzeichnissen
namens Session[NNNN] gespeichert. NNNN gibt hierbei die ID des Workflow-Prozesses an. Damit keine
Speicherplatzprobleme auftreten, müssen Sie die Session-Verzeichnisse für vollständig abgeschlossene
Prozesse regelmäßig löschen.
Wenn das globale Speicherverzeichnis in Configuration Manager nicht ausdrücklich festgelegt wurde,
wird als Standardspeicherort für das globale Speicherverzeichnis der Pfad [Temp-Verzeichnis]/
AdobeDocumentStorage/global verwendet. Wenn auch das [Temp-Verzeichnis] vom Benutzer in
Configuration Manager nicht angegeben wurde, wird als Standardverzeichnis java.io.tmpdir verwendet.
DB2-Konfigurationseinstellungen
Wenn Sie LiveCycle Form Manager mit einer DB2-Datenbank ausführen und der Computer nicht mehr
reagiert, überprüfen Sie die Protokolldateien auf Meldungen im Zusammenhang mit einem Deadlock.
Ändern Sie die DB2-Konfigurationsparameter, wenn solche Meldungen in den Protokolldateien vorhanden sind. Setzen Sie den Parameter LOCKTIMEOUT auf 15 und verdoppeln Sie die Werte für die
Parameter APPLHEAPSZ, STMTHEAP und SORTHEAP. Sie müssen die Datenbank und den
Anwendungsserver dann neu starten.
Verbessern der Windows Server-Leistung mit LDAP
Durch die Verwendung von Verbindungspools bei der Suchverbindung kann die Anzahl der benötigten
Anschlüsse um bis zu 50 % verringert werden, da diese Verbindung immer dieselben Berechtigungen für
eine bestimmte Domäne verwendet und darüber hinaus der Kontext und die entsprechenden Objekte
ausdrücklich geschlossen sind.
Adobe LiveCycle
Verbessern der Windows Server-Leistung mit LDAP
151
³ So konfigurieren Sie Windows Server für die Verwendung von Verbindungspools:
1. Starten Sie den Registrierungseditor, indem Sie Start > Ausführen wählen. Geben Sie in das Feld
Öffnen den Befehl regedit ein und klicken Sie auf OK.
2. Wechseln Sie zum folgenden Registrierungsschlüssel:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters
3. Suchen Sie im rechten Fenster des Registrierungseditors den Wertnamen TcpTimedWaitDelay. Falls
der Name fehlt, können Sie ihn hinzufügen, indem Sie in der Menüleiste den Befehl Bearbeiten >
Neu > DWORD-Wert wählen.
4. Geben Sie in das Feld Name die Bezeichnung TcpTimedWaitDelay ein.
Hinweis: Wenn in dem Feld weder ein blinkender Cursor noch der Text Neuer Wert # angezeigt
wird, klicken Sie mit der rechten Maustaste im rechten Fenster, wählen Sie im Menü die
Option Umbenennen und geben Sie unter Name die Bezeichnung TcpTimedWaitDelay
ein.
5. Wiederholen Sie diesen Schritt 4 für die Wertnamen MaxUserPort, MaxHashTableSize und
MaxFreeTcbs.
6. Doppelklicken Sie im rechten Fenster, um den Wert TcpTimedWaitDelay einzustellen. Wählen Sie
unter Basis die Option Dezimal und geben Sie in das Feld Wert den Wert 30 ein.
7. Doppelklicken Sie im rechten Fenster, um den Wert MaxUserPort einzustellen. Wählen Sie unter Basis
die Option Dezimal und geben Sie in das Feld Wert den Wert 65534 ein.
8. Doppelklicken Sie im rechten Fenster, um den Wert MaxHashTableSize einzustellen. Wählen Sie unter
Basis die Option Dezimal und geben Sie in das Feld Wert den Wert 65536 ein.
9. Doppelklicken Sie im rechten Fenster, um den Wert MaxFreeTcbs einzustellen. Wählen Sie unter Basis
die Option Dezimal und geben Sie in das Feld Wert den Wert 16000 ein.
Vorsicht: Wenn Sie mit dem Registrierungseditor oder einer anderen Methode fehlerhafte Änderungen
an der Registrierung vornehmen, kann dies schwerwiegende Folgen haben. Im Extremfall
müssen Sie das Betriebssystem neu installieren. Alle Änderungen an der Registrierung erfolgen
auf Ihr eigenes Risiko.
:
Index
A
Adobe Administrator, Zugriff 27
Adobe Form Server auf LiveCycle Forms aktualisieren 124
Adobe LiveCycle Assembler
aktualisieren 131
aufrufen 108
Aufträge zur Verarbeitung senden 116
Bereitstellung überprüfen 28
installieren 40
Adobe LiveCycle Document Security
aktualisieren 140
Adobe LiveCycle Form Manager
aktualisieren 129
auf Endbenutzerseiten zugreifen 32
installieren 40
WebDAV verwenden 118
Adobe LiveCycle Forms
aktualisieren 124
installieren 40
PDF/A-Konformität 119
Adobe LiveCycle PDF Generator
aktualisieren 137
Aufgaben nach der Bereitstellung 33
installieren 37
JMS-Datenbank erstellen 48
Konvertierungstimeout einstellen 34
Turnkey-Installation ausführen 23
zusätzliche Anforderungen 16
Adobe LiveCycle Policy Server
aktualisieren 146
Adobe LiveCycle Print
aktualisieren 124
installieren 42
Adobe LiveCycle Reader Extensions
aktualisieren 142
Adobe LiveCycle Workflow
aktualisieren 131
für BAM Server konfigurieren 93
installieren 40
LiveCycle Assembler aufrufen 108
Metadaten-Definitionen importieren 95
Adobe LiveCycle Workflow Designer
aktualisieren 134
deinstallieren 102
installieren 101
JNDI- und HTTP-Anschlüsse 102
Konfigurationsdatei ändern 102
Adobe LiveCycle-Datenbank
erstellen 44
initialisieren 11, 70
mit JBoss verbinden 61
Verbindung herstellen 83
Zugriff auf Tabellen 45
Adobe LiveCycle-Dienste ändern 25
Adobe LiveCycle-Produkte
aktualisierte Informationen 10
auf Version 7.2 oder 7.2.1 aktualisieren 122
Dokumentation 9
Formulare entwickeln 118
manuell installieren 37
Adobe PDF Printer als Standarddrucker einrichten 33
Adobe User Management
mit LDAP konfigurieren 72
Zugriff 28
adobe-printSubmitter.ear-Datei 30
Aktionseigenschaften, Assembler-QPAC 110
Aktualisieren, LiveCycle-Produkte 12, 122
Anschlussnummern für JBoss anpassen 89
Anwendungsserver
aktualisieren 123
auf JBoss bereitstellen 67
konfigurieren 56
Unterstützung 14
Anzeigen
Protokolldateien 43, 69
Assembler-QPAC
Informationen 109
Workflow-Prozesse erstellen 110
Auftragsquellen konfigurieren 33
Authentifizierung
LDAP verwenden 72, 96
mit SSL-Berechtigung 75
Automatische Installation
zum Aktualisieren von LiveCycle-Produkten 123
B
BAM Dashboard, Zugriff 93
BAM Server
Aktualisierungsdienstprogramm 135
auf JBoss bereitstellen 91
Benutzerkonten 80
Datenbanktreiber installieren 81
für LiveCycle Workflow aktualisieren 134
JBoss konfigurieren 81
JBoss mit Datenbank verbinden 81
konfigurieren 94
LiveCycle Workflow konfigurieren 93
mit LDAP-Server synchronisieren 97, 100
BAM Workbench, Zugriff 93
erstellen 80
Verbindung auf SQL Server herstellen 82
Verbindung zu JBoss herstellen 81
Beenden
JBoss 56
152
Adobe LiveCycle
Index
Installieren und Konfigurieren von LiveCycle for JBoss
Beispiele
auf Installation Verification Sample zugreifen 29
Datendateien 30
Formularentwürfe 30
LiveCycle Assembler bereitstellen 28
Print Submitter ausführen 30
Print-Anwendung der Form Server-Modul-API ausführen 31
PrintIVS-Webanwendung ausführen 30
Benutzerkonten
BAM Server 80
MySQL 45
Benutzerzuordnung für LDAP konfigurieren 98
Berechtigungen für SSL erstellen 75
Bereitstellen
auf JBoss 68
BAM Server auf JBoss 91
Informationen 11, 67
LiveCycle Assembler-Beispiel 28
LiveCycle-Produkte für Bereitstellung konfigurieren 51
mehrere LiveCycle-Produkte 12
PrintIVS-Webanwendung 30
Bereitstellung
Checklisten 17
Betriebssysteme
Datenbankunterstützung 15, 104
Unterstützung 14
Business Activity Monitor. Siehe BAM-Einträge
C
Checklisten 17
cluster-service.xml-Datei ändern 60
Configuration Manager
bei Aktualisierung verwenden 123
LiveCycle-Produkte konfigurieren 51
Verzeichniseinstellungen 150
CreateDocumentList-QPAC 109
D
Dateien
bereitstellbar 67
Zugriff über WebDAV-Clients 118
Datenbanken
Datenquelldateien erstellen 61
erstellen 44, 80
initialisieren 70
Treiber für BAM Server installieren 81
Treiberunterstützung 15
unterstützte Betriebssysteme 15, 104
Unterstützung 14
Verbindung zu JBoss herstellen 81
Datenquelldateien erstellen 61, 81
DB2-Datenbank
Datenquelle für JBoss erstellen 64
erstellen 46
für gleichzeitige Verwendung konfigurieren 47
Konfigurationseinstellungen 150
DDX-Dateien
in Workflows verwenden 109
153
Musterabgleich 116
Deinstallieren
LiveCycle Workflow Designer 102
Produktdateien 120, 121
Dokumentation 9
Dokumentübertragung, Leistung optimieren 148
dom4j.jar-Datei aktualisieren 60
Dynamische DDX-Dateien 109
Dynamische Formulare, Schaltflächenunterstützung 119
E
EAR-Datei, class-loading einstellen 60
endorsed-Verzeichnis erstellen 57
Entfernen. Siehe Deinstallieren
Erstellen
Datei JobConfig.xml 114
Datenbanken 44, 80
Datenquelldateien 61, 81
SSL-Berechtigung 75
überwachte Ordner 112
F
Fehlermodi, Assembler QPAC-Workflow 111
Fehlerprotokolle anzeigen 43
Fehlerprotokollierung, Assembler QPAC-Workflow 111
Form Server-Modul-API, Print-Anwendung ausführen 31
Formulare entwerfen 118
G
Globales Speicherverzeichnis
Informationen 52
temporäre Dateien 150
H
Hardware, Mindestanforderungen 15
Hinzufügen
Schriften zur Verwendung in LiveCycle Forms 53
HTTP-Anschlüsse, LiveCycle Workflow Designer 102
I
Importieren, LiveCycle Workflow Metadaten-Definitionen 95
Initialisieren, Datenbank 11, 70
Installation
Checklisten 17
Methoden 12
Verzeichnisse 20
Installieren
Siehe auch Konfigurieren 11
Anwendungen auf JBoss 68
Datenbanktreiber für BAM Server 81
Informationen 11
JBoss 50, 80
LiveCycle Workflow Designer 101
LiveCycle-Produkte für manuelle Bereitstellung 40
manuelle Methode 37
mehrere LiveCycle-Produkte 12
Schriften für konvertierte Dokumente 33
Turnkey-Methode 20
Adobe LiveCycle
Index
J
jacorb.properties-Datei ändern 59
JAR-Dateien, dom4.jar aktualisieren 60
JBoss
Anschlussnummern anpassen 89
Aufzeichnung von Meldungen verhindern 89
BAM Server bereitstellen 91
bereitstellbare Komponenten 67
Bereitstellung 68
für Watched Folder konfigurieren 61
Installationsverzeichnis 20
installieren 50, 80
Konfigurationsdateien ändern 57
mit Datenbank für BAM Server verbinden 81
mit LiveCycle-Datenbank verbinden 61
Name des Basisverzeichnisses 67
SSL konfigurieren 75, 77
starten und beenden 56
Thread-Konfiguration ändern 88
JBoss-Dienst deinstallieren 120
JDBC-Treiber
für DB2 kopieren 64
für MySQL kopieren 62
für Oracle kopieren 63
für SQL Server kopieren 65
JDK-Unterstützung 14
JMS
Datenbank erstellen 48
Konfiguration ändern 58
JNDI-Anschlüsse, LiveCycle Workflow Designer 102
JobConfig.xml-Datei für überwachte Ordner erstellen 114
JVM
konfigurieren 86
maximale Heapgröße erhöhen 148
K
Konfiguration, Checklisten 17
Konfigurationsdateien
für JBoss ändern 57
für LiveCycle Workflow Designer ändern 102
Konfigurationseigenschaften für Aktualisierung abrufen 125
Konfigurieren
Siehe auch Installieren
Anwendungsserver 56
Auftragsquellen 33
BAM Server 94
DB2-Datenbank für gleichzeitige Verwendung 47
DB2-Datenquelle für JBoss 64
Informationen 11
JBoss für BAM Server 81
JBoss für Watched Folder 61
JVM für JBoss 86
LiveCycle Workflow für BAM Server 93
LiveCycle-Produkte für Bereitstellung 51
MySQL-Datenquelle für JBoss 61
Oracle-Datenquelle für JBoss 62
SQL Server-Datenquelle für JBoss 65
154
SSL auf JBoss 75, 77
überwachte Ordner 112
User Management mit LDAP 72
Windows Server für Verwendung von Verbindungspools 151
Workflow-Prozesse mit Assembler QPAC 110
Konventionen, Pfadnamen 8
Konvertierungstimeout für LiveCycle PDF Generator einstellen 34
L
LDAP
Serverunterstützung 15
User Management konfigurieren 72
Windows Server-Leistung verbessern 150
Leistung von Windows Server verbessern 150
LiveCycle. Siehe Adobe LiveCycle
M
Manuelle Installation
ausführen 37
Checkliste 17
entfernen 121
Informationen 12
Mehrere LiveCycle-Produkte installieren und bereitstellen 12
MySQL
Benutzerkonto 45
Datenquelle für JBoss konfigurieren 61
Dienst deinstallieren 120
Installationsverzeichnis 20
Verbindung zu LiveCycle-Datenbank herstellen 85
N
Namenskonventionen, Dateipfade 8
O
Oracle-Datenbank
Datenquelle für JBoss erstellen 62
erstellen 45
P
PDF/A-konforme Formulare, Schriften einbetten 119
PDF-Dateien vorbereiten 116
Print Submitter-Anwendung ausführen 30
PrintExample BAT- und SH-Dateien 31
PrintIVS-Webanwendung bereitstellen und ausführen 30
Produktdateien
bereitstellbar 67
entfernen 120, 121
Protokolldateien anzeigen 43, 69
Q
QPACs
bereitstellen 109
erstellen 10
Adobe LiveCycle
Index
155
R
U
Repository, Zugriff über WebDAV-Clients 118
Rollenzuordnung für LDAP konfigurieren 99
run-Dateien ändern 57
Überprüfen
LiveCycle Assembler-Bereitstellung 28
LiveCycle Forms-Bereitstellung 29
LiveCycle Print-Bereitstellung 30
Überwachte Ordner
erstellen und konfigurieren 112
JobConfig.xml-Datei erstellen 114
User Management. Siehe Adobe User Management
S
Schriften
für konvertierte Dokumente installieren 33
in PDF/A-konforme Formulare einbetten 119
Schriftpakete 107
zur Verwendung in LiveCycle Forms auswählen 53
Senden, LiveCycle Assembler-Aufträge zur Verarbeitung 116
SMTP-Einstellungen für BAM Server konfigurieren 94
Software
Anforderungen 13
Dateien über Client veröffentlichen 118
installierbare Kombinationen 15
SQL Server
Datenquelle für JBoss konfigurieren 65
JDBC-Treiber 65
JMS-Datenbank erstellen 48
Treiber installieren 81
Verbindung zu BAM Server herstellen 82
Verbindung zu LiveCycle-Datenbank herstellen 84
SSL
auf JBoss konfigurieren 75, 77
Berechtigung erstellen 75
Starten
Administrator 27
Installationsprogramm 40
JBoss 56
User Management
28
Statische DDX-Dateien 109
submitter.bat-Datei 30
Synchronisieren, BAM Server mit LDAP-Server 97, 100
Systemanforderungen 13
V
Variablen, Assembler-QPAC 110
Verarbeiten, LiveCycle Assembler-Aufträge 116
Verbinden
Anwendungsserver 102
BAM-Metadaten-Datenbank auf SQL Server 82
JBoss mit BAM-Metadaten-Datenbank 81
JBoss mit LiveCycle-Datenbank 61
LiveCycle-Datenbank 83
Verbindungspool, Patch für Watched Folder anwenden 69
Verzeichnisse
bei Turnkey-Installation installiert 20
globales Speicherverzeichnis 52, 150
JBoss-Namenskonvention 67
W
Watched Folder
aktualisieren 131
Informationen zur Installation 13
installieren 43
JBoss konfigurieren 61
LiveCycle Assembler aufrufen 108
Verbindungspool-Patch anwenden 69
Webbrowser-Unterstützung 14
WebDAV-Clients 118
Workflow-Prozesse erstellen 109
X
T
Thread-Konfiguration für JBoss ändern 88
Threads, maximale Einstellungen ändern 59
Turnkey-Installation
ausführen 20
Checklisten 17
deinstallieren 120
Informationen 12
zum Aktualisieren von LiveCycle-Produkten 123
XML-Datei, Auftragskonfiguration 114
Z
Zugriff
Administrator 27
BAM Workbench und BAM Dashboard 93
Endbenutzerseiten für LiveCycle Form Manager 32
Installation Verification Sample-Anwendung 29
LiveCycle-Datenbanktabellen 45
Repository 118
User Management 28

Installieren und Konfigurieren von LiveCycle für JBoss

Transcrição

Documentos relacionados

Strategien für eine bessere Kundenbindung

Erste Schritte mit Formularleidfaden

PDF Generator 3D

Sunrise Huawei E220 Manual

Netzwerktechnik CHS Villach Mag. Rainer Swatek Dauer: 2

Kurzprofil - Patrick Nehls Homepage

Hilfe-PDF anzeigen

Anleitung: Adobe Produkte - Stifter

Der Weg zum unverwexelbar guten Druck

Installation RealPlayer