Installieren und Bereitstellen von LiveCycle ES für

bc
Installieren und Bereitstellen
von LiveCycle® ES für WebSphere®
Adobe® LiveCycle® ES
Februar 2009
Update 1 (8.2)
© 2009 Adobe Systems Incorporated. All rights reserved.
Adobe® LiveCycle® ES Update 1 (8.2) Installieren und Bereitstellen von LiveCycle ES für WebSphere für Microsoft® Windows®, UNIX® und
Linux®
Ausgabe 2.3, Februar 2009
If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished
under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part
of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording,
or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected
under copyright law even if it is not distributed with software that includes an end-user license agreement.
The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as
a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or
inaccuracies that may appear in the informational content contained in this guide.
Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law.
The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure
to obtain any permission required from the copyright owner.
Any references to company names, company logos and user names in sample material or sample forms included in this documentation
and/or software are for demonstration purposes only and are not intended to refer to any actual organization or persons.
Adobe, the Adobe logo, Acrobat, FrameMaker, LiveCycle, PageMaker, PhotoShop, Reader, and PostScript are either registered trademarks or
trademarks of Adobe Systems Incorporated in the United States and/or other countries.
IBM, AIX, DB2, and WebSphere are trademarks of International Business Machines Corporation in the United States, other countries, or both.
Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
Oracle is a trademark of Oracle Corporation and may be registered in certain jurisdictions.
Sun, Java, and Solaris, and SunOS are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.
UNIX is a registered trademark of The Open Group in the US and other countries.
All other trademarks are the property of their respective owners.
This product contains either BSAFE and/or TIPEM software by RSA Security, Inc.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
This product includes software developed by the IronSmith Project (http://www.ironsmith.org/).
This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/).
This product includes software developed by the Indiana University Extreme! Lab (http://www.extreme.indiana.edu/).
This product includes copyrighted software developed by E. Wray Johnson for use and distribution by the Object Data Management Group
(http://www.odmg.org/).
Portions © Eastman Kodak Company, 199- and used under license. All rights reserved. Kodak is a registered trademark and Photo CD is
a trademark of Eastman Kodak Company.
Powered by Celequest. Copyright 2005-2008 Adobe Systems Incorporated. All rights reserved. Contains technology distributed under license
from Celequest Corporation. Copyright 2005 Celequest Corporation. All rights reserved.
Single sign-on, extending Active Directory to Adobe LiveCycle ES provided by Quest Software “www.quest.comlidentity-management”
in a subsequent minor release that is not a bug fix (i.e., version 1.1 to 1.2 but not 1.1.1 to 1.1.2) of the Licensee Product that incorporates the
Licensed Product.
The Spelling portion of this product is based on Proximity Linguistic Technology.
© Copyright 1989, 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc. Burlington,
New Jersey USA.
© Copyright 1990 Merriam-Webster Inc. © Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2003 Franklin Electronic Publishers Inc. © Copyright 2003 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 Franklin Electronic Publishers, Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1991 Dr.Lluis de Yzaguirre I Maura © Copyright 1991 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1990 Munksgaard International Publishers Ltd. © Copyright 1990 All Rights Reserved Proximity Technology A Division of
Franklin Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1995 Van Dale Lexicografie bv © Copyright 1996 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1990 IDE a.s. © Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc.
Burlington, New Jersey USA.
© Copyright 2004 Franklin Electronics Publishers, Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1992 Hachette/Franklin Electronic Publishers, Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of
Franklin Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 Bertelsmann Lexikon Verlag © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 MorphoLogic Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1990 Williams Collins Sons & Co. Ltd. © Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA. © Copyright 1993-95 Russicon Company Ltd.
© Copyright 1995 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 IDE a.s. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc.
Burlington, New Jersey USA.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101,
consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R.
§12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable,
the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users
(a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein.
Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose,
CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including,
if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of
1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60,
60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
Inhaltsverzeichnis
Informationen zu diesem Dokument ......................................................................................... 8
Inhalt dieses Dokuments ............................................................................................................................................................. 8
Zielgruppe dieses Dokuments .................................................................................................................................................. 8
Zusätzliche Informationen........................................................................................................................................................10
1
Einführung ................................................................................................................................. 11
Informationen zur Installation, Konfiguration und Bereitstellung von LiveCycle ES...........................................11
Auswählen von Aufgaben für das Konfigurieren und Bereitstellen von LiveCycle ES........................................12
Aktualisieren auf LiveCycle ES .................................................................................................................................................12
Checkliste für die automatische Installation und Bereitstellung..........................................................................13
Checkliste für die manuelle Installation und Bereitstellung ..................................................................................13
2
Installation der Dateien für Lösungskomponenten ............................................................... 15
Installieren der Produktdateien ..............................................................................................................................................15
Installieren auf einer Windows-Testplattform für die Bereitstellung unter Linux oder UNIX ....................16
Konfigurieren der Berechtigung für Rechte von LiveCycle Reader Extensions ES.........................................16
Hinzufügen des Java 5-SDK in die Umgebungsvariable JAVA_HOME ...............................................................17
Installieren von LiveCycle ES..............................................................................................................................................17
Anzeigen des Fehlerprotokolls................................................................................................................................................19
Nächste Schritte............................................................................................................................................................................20
3
Konfigurieren von LiveCycle ES für die Bereitstellung........................................................... 21
Info LiveCycle Configuration Manager.................................................................................................................................21
Befehlszeilenschnittstelle im Vergleich zur grafischen Benutzeroberfläche LiveCycle
Configuration Manager .................................................................................................................................................22
Ermitteln des SOAP-Anschlusses des Anwendungsservers..........................................................................................23
Konfigurieren von und Bereitstellen von LiveCycle ES...................................................................................................23
Deinstallieren von EAR-Dateien..............................................................................................................................................28
Nächste Schritte............................................................................................................................................................................29
4
Manuelles Konfigurieren von WebSphere .............................................................................. 30
Festlegen von Verzeichnisberechtigungen........................................................................................................................30
Konfigurieren der JVM-Argumente .......................................................................................................................................31
Aktualisieren von „ejbdeploy.sh“ für UNIX/Linux.............................................................................................................32
Konfigurieren von WebSphere-Zeitlimiteinstellungen..................................................................................................32
Konfigurieren der Einschränkung für LiveCycle PDF Generator ES ...........................................................................34
Konfigurieren der Verbindung zur LiveCycle ES-Datenbank .......................................................................................34
Konfigurieren der J2C-Authentifizierung für die Datenquelle ..............................................................................35
Konfigurieren der DB2-Datenquelle ...............................................................................................................................35
Konfigurieren der Oracle-Datenquelle...........................................................................................................................38
Konfigurieren der SQL Server-Datenquelle..................................................................................................................41
Konfigurieren von JMS-Ressourcen für WebSphere........................................................................................................45
Zuweisen der JMS-Aktivierungsspezifikation..............................................................................................................49
Zuweisen von Ausnahmezielen ..............................................................................................................................................51
Konfigurieren der J2C-Authentifizierung für JMS ............................................................................................................51
SQL Server-JMS-Überprüfung..................................................................................................................................................53
4
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Inhaltsverzeichnis
5
Ausführen der LiveCycle Configuration Manager-Überprüfung ................................................................................54
Nächster Schritt.............................................................................................................................................................................54
5
Manuelles Bereitstellen von WebSphere................................................................................. 55
Bereitstellen von LiveCycle ES-Lösungskomponenten ..................................................................................................55
WebSphere-Verzeichnisname ...........................................................................................................................................55
Übersicht der bereitstellbaren Komponenten ............................................................................................................56
Bereitstellen unter WebSphere ...............................................................................................................................................56
Starten der Anwendung ............................................................................................................................................................57
Nächste Schritte............................................................................................................................................................................57
6
Aktivitäten nach der Bereitstellung......................................................................................... 58
Überprüfen der Bereitstellung und Zugreifen auf die LiveCycle Administration Console................................58
Zugreifen auf LiveCycle Administration Console.......................................................................................................59
Anzeigen der Protokolldateien.........................................................................................................................................59
Zugriff auf die Webanwendungen der Lösungskomponente.....................................................................................60
Zugreifen auf die Rights Management ES ....................................................................................................................61
Zugreifen auf User Management .....................................................................................................................................62
Zugriff auf das Content Services ES-Repository ................................................................................................................62
Konfigurieren von LiveCycle PDF Generator ES oder 3D ES .........................................................................................63
Festlegen von Umgebungsvariablen .............................................................................................................................63
Konfigurieren des Anwendungsservers für die Verwendung eines HTTP-Proxyservers .............................64
Einrichten von Adobe PDF Printer als Standarddrucker..........................................................................................65
Konfigurieren von Acrobat 9.0..........................................................................................................................................65
Installieren ostasiatischer Zeichen unter Windows...................................................................................................66
Hinzufügen von Schriftarten PDF Generator ES oder PDF Generator 3D ES....................................................66
Konfigurieren von „HTML in PDF“-Konvertierungen ................................................................................................68
Installieren des IPP-Clients........................................................................................................................................................70
Abschließende Einrichtung für LiveCycle Rights Management ES ............................................................................71
Konfigurieren von LiveCycle ES für den LDAP-Zugriff....................................................................................................71
Festlegen von Leistungsparametern für überwachte Ordner in PDF Generator ES oder 3D ES .....................73
Aktivieren des FIPS-Modus .......................................................................................................................................................74
Konfigurieren von Einstellungen für eine digitale HTML-Signatur............................................................................74
Konfigurieren des Document Management-Dienstes für LiveCycle Content Services ES ................................75
Konfigurieren des Connector for EMC Documentum-Dienstes ..................................................................................75
Erstellen des XDP MIME-Formats im Documentum-Repository .................................................................................78
Konfigurieren des Connector for IBM FileNet-Dienstes .................................................................................................80
Konfigurieren des Connectors, der FileNet 3.5 verwendet.....................................................................................80
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet .................................................................................83
Deinstallieren von LiveCycle ES ..............................................................................................................................................93
Deinstallieren einer LiveCycle ES-Lösungskomponente .........................................................................................94
7
Manuelles Konfigurieren von BAM Server für LiveCycle ES................................................... 95
Konfigurieren von WebSphere für BAM Server.................................................................................................................95
Konfigurieren des Keystore ......................................................................................................................................................96
Erstellen der Datei „bam.properties“.....................................................................................................................................97
Erstellen und Konfigurieren der BAM Server-Metadaten-Datenbank ......................................................................97
Benutzerkonten ......................................................................................................................................................................97
Konfigurieren der Datenbankumgebung (nur DB2) .................................................................................................98
Erstellen der Datenquelle für die BAM Server-Metadaten-Datenbank ........................................................... 100
Konfigurieren von WebSphere-Parametern.................................................................................................................... 103
Konfigurieren Process Management ES für BAM Server ............................................................................................. 104
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Inhaltsverzeichnis
6
Bereitstellen von BAM Server unter WebSphere ........................................................................................................... 105
Konfigurieren von LDAP-Einstellungen für BAM Server ............................................................................................. 107
Einschränkungen für LDAP-Verbindungen von BAM Server .............................................................................. 107
Richtlinien für LDAP-Verbindungen von BAM Server............................................................................................ 107
Konfigurieren der automatischen LDAP-Synchronisierung................................................................................ 108
Konfigurieren der LDAP-Benutzerzuordnung.......................................................................................................... 109
Konfigurieren der LDAP-Rollenzuordnung ............................................................................................................... 110
Manuelles Synchronisieren mit dem LDAP-Server ................................................................................................. 111
Verwendet BAM Dashboard.................................................................................................................................................. 111
Zusätzliche Dokumentation.................................................................................................................................................. 112
Deinstallation… Business Activity Monitoring............................................................................................................... 113
8
Erweiterte Konfiguration für Produktionssysteme ..............................................................114
Konfigurieren der Poolgröße für LiveCycle Output ES und LiveCycle Forms ES................................................ 114
LiveCycle PDF Generator ES .................................................................................................................................................. 115
Konfigurieren der EJB-Poolgröße.................................................................................................................................. 115
9
Fehlerbehebung ......................................................................................................................117
Anfordern von Hilfe .................................................................................................................................................................. 117
Installationseinstellungen ............................................................................................................................................... 117
Anwendungsservereinstellungen................................................................................................................................. 117
Verarbeiten vieler gleichzeitiger Aufrufe ................................................................................................................... 118
Fehlerbehebung mit Protokolldateien.............................................................................................................................. 118
Protokolldatei von LiveCycle Configuration Manager .......................................................................................... 118
Anzeigen der JVM-Systemausgabe- und Fehlerprotokolle................................................................................. 118
Löschen der Transaktionsprotokolldatei des Anwendungsservers ................................................................. 119
Exception: No trusted certificate found...................................................................................................................... 119
Konfigurieren des Scheduler-Dienstes für nicht standardmäßige JNDI-URLs .................................................... 120
Umgebungen ohne Cluster............................................................................................................................................. 120
Fehlermeldungen...................................................................................................................................................................... 121
Beim Konvertieren nativer Dateien schlägt Klasse nicht gefunden ................................................................. 121
JNDI-Name nicht gefunden............................................................................................................................................. 121
Fehler beim Bereitstellen der Datei „adobe-livecycle-websphere.ear“........................................................... 122
J2CA0294W-Warnmeldungen........................................................................................................................................ 122
Die Datei „adobe-livecycle-websphere.ear“ wird nicht auf der 64-Bit-Version von WebSphere
bereitgestellt .................................................................................................................................................................. 123
Ausnahmen beim mehrfachen Initialisieren der Datenbank.............................................................................. 123
XMLForm.exe-Berechtigungsfehler ............................................................................................................................. 123
J2CA0081E: Method cleanup error on SQL Server.................................................................................................. 123
Fehler bei der Datenbankinitialisierung auf WebLogic ........................................................................................ 124
Zu wenig Arbeitsspeicher: Java-Heap-Speicherfehler .......................................................................................... 124
Unnötige SystemOut-Meldungen beim Bereitstellen von Lösungskomponenten.................................... 125
Connector for EMC Documentum-Fehler .................................................................................................................. 125
Fehler beim Bereitstellen von EAR-Dateien .............................................................................................................. 125
Die Ausnahme „Java NameNotFoundException“ ................................................................................................... 125
LiveCycle Configuration Manager-Validierungsfehler während der JMS-Einrichtung ............................. 126
Bereitstellen von LiveCycle ES in einer verteilten Umgebung ........................................................................... 126
Fehler beim Validieren der Bereitstellung von LiveCycle-Komponenten ...................................................... 127
Verbessern der Windows Server-Leistung mit LDAP ............................................................................................. 127
Unter Solaris können keine Bereitstellungsfehler gestartet/erstellt werden................................................ 128
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Inhaltsverzeichnis
7
Hinweise zu PDF Generator ES ............................................................................................................................................. 128
Konfigurieren von PDF Generator ES für die Konvertierung von MS Office-Dateien
in das PDF-Format ........................................................................................................................................................ 128
Standardmakroeinstellungen von Microsoft Visio 2007 verursachen Konvertierungstimeout............. 129
A
Anhang – Installieren der Befehlszeilenschnittstelle ...........................................................130
Installieren von LiveCycle ES ................................................................................................................................................. 130
Fehlerprotokolle ........................................................................................................................................................................ 136
Deinstallieren von LiveCycle ES im Konsolenmodus ................................................................................................... 136
Nächste Schritte......................................................................................................................................................................... 136
B
Anhang – LCM-Befehlszeilenschnittstelle .............................................................................137
Reihenfolge der Vorgänge..................................................................................................................................................... 137
Eigenschaftendatei der Befehlszeilenschnittstelle ....................................................................................................... 137
Allgemeine Eigenschaften............................................................................................................................................... 138
Konfigurieren von LiveCycle ES-Eigenschaften ....................................................................................................... 139
Konfigurieren oder Überprüfen von Anwendungsservereigenschaften ....................................................... 141
Bereitstellen von LiveCycle-Eigenschaften................................................................................................................ 143
Initialisieren von LiveCycle-Eigenschaften ................................................................................................................ 143
Initialisieren von BAM-Eigenschaften.......................................................................................................................... 143
Bereitstellen von LiveCycle-Komponenteneigenschaften .................................................................................. 144
Verwendung der Befehlszeilenschnittstelle.............................................................................................................. 144
Verwendungsbeispiele............................................................................................................................................................ 148
Fehlerprotokolle ........................................................................................................................................................................ 148
Nächste Schritte......................................................................................................................................................................... 148
Informationen zu diesem Dokument
Dieses Dokument ist eine von mehreren Informationsquellen für die Verwendung von Adobe® LiveCycle® ES
(Enterprise Suite) Update 1. LiveCycle ES ist eine flexible, erweiterbare Plattform, die zur Automatisierung
und Beschleunigung der Übermittlung geschäftswichtiger Informationen von und zu Kunden, Partnern,
Auftraggebern und Mitarbeitern beiträgt.
Inhalt dieses Dokuments
In diesem Handbuch finden Sie Informationen zum Installieren und Konfigurieren der folgenden
Lösungskomponenten unter Microsoft® Windows®, Linux®, IBM® AIX® und Sun™ Solaris™ und erfahren
darüber hinaus, wie die Lösungskomponenten auf einem IBM WebSphere® Application Server
bereitgestellt werden:
●
Adobe LiveCycle Barcoded Forms ES
●
Adobe LiveCycle Business Activity Monitoring
●
Adobe LiveCycle ES Connector for EMC Documentum
●
Adobe LiveCycle ES Connector for IBM FileNet
●
Adobe LiveCycle ES Connector für IBM Content Manager
●
Adobe LiveCycle Content Services ES
●
Adobe LiveCycle Digital Signatures ES
●
Adobe LiveCycle Forms ES
●
Adobe LiveCycle Foundation
●
Adobe LiveCycle Output ES
●
Adobe LiveCycle PDF Generator ES
●
Adobe LiveCycle PDF Generator 3D ES
●
Adobe LiveCycle Process Management ES
●
Adobe LiveCycle Reader Extensions ES
●
Adobe LiveCycle Rights Management ES
Zielgruppe dieses Dokuments
Die Informationen dieses Handbuchs richtet sich an Administratoren und Entwickler, die für die
Installation, Konfiguration, Verwaltung oder Bereitstellung von LiveCycle ES-Komponenten zuständig
sind. Benutzer dieses Handbuchs sollten mit J2EE-Anwendungsservern, den Betriebssystemen
Linux, Microsoft Windows, AIX, oder Solaris, Datenbankservern im Format Oracle®, DB2® oder SQL Server
sowie Webumgebungen vertraut sein.
8
Adobe LiveCycle ES
Informationen zu diesem Dokument
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konventionen in diesem Handbuch
Konventionen in diesem Handbuch
In diesem Handbuch werden die folgenden Benennungskonventionen für allgemeine Dateipfade
verwendet.
Name
Standardwert
Beschreibung
[LiveCycle ESStammverzeichnis]
Windows:
C:\Adobe\LiveCycle8.2\
Das Installationsverzeichnis für alle
LiveCycle ES-Lösungskomponenten.
Das Installationsverzeichnis enthält
Unterordner für Adobe LiveCycle
Configuration Manager,
das Programming with LiveCycle ES
und die einzelnen installierten
LiveCycle ES-Lösungskomponenten
(einschließlich der
Produktdokumentation).
Dieses Verzeichnis enthält außerdem
Verzeichnisse im Zusammenhang
mit Drittanbietertechnologien.
Linux und UNIX:
/opt/adobe/livecycle8.2/
[Anwendungsserver- Dies sind beispielhafte
Stammverzeichnis] Installationsspeicherorte.
Ihr Installationsordner
kann davon abweichen.
Das Basisverzeichnis des
Anwendungsservers, unter dem die
LiveCycle ES-Dienste ausgeführt werden.
WebSphere unter Windows:
C:\Programme\IBM\WebSphere\
AppServer
WebSphere unter Linux und Solaris:
/opt/IBM/WebSphere/AppServer
WebSphere unter AIX:
/usr/IBM/WebSphere/AppServer
C:\bea\wlserver_10.0\
/opt/IBM/WebSphere/AppServer
[Servername]
Server1 für WebSphere
Der Name des Servercomputers,
der auf Ihrem Anwendungsserver
konfiguriert ist.
[DatenbankserverStammverzeichnis]
Hängt vom Datenbanktyp und Ihrer
Angabe bei der Installation ab.
Der Speicherort, an dem der
LiveCycle ES-Datenbankserver
installiert wird.
Die meisten Informationen zu Verzeichnissen in diesem Handbuch gelten plattformübergreifend (unter
Linux und UNIX® wird bei allen Dateinamen und Pfadangaben die Groß- und Kleinschreibung beachtet).
Plattformspezifische Informationen werden bei Bedarf aufgeführt.
9
Adobe LiveCycle ES
Informationen zu diesem Dokument
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zusätzliche Informationen
Zusätzliche Informationen
In der folgenden Tabelle finden Sie Hinweise auf weiterführende Informationen zu LiveCycle ES.
Gewünschte Informationen
Siehe
Allgemeine Informationen zu LiveCycle ES und
den Lösungskomponenten
LiveCycle ES Übersicht
Neues in der LiveCycle ES
(Enterprise Suite)-Version
Neues
LiveCycle ES-Terminologie
LiveCycle ES-Glossar
LiveCycle ES-Lösungskomponenten
Adobe LiveCycle ES
Weitere Dienste und Produkte, die in LiveCycle ES Adobe Developer Connection
integriert werden können
Installieren von Adobe LiveCycle Workbench ES
Installieren der Entwicklungsumgebung
Aktualisieren auf LiveCycle ES von einer früheren Vorbereiten der Aktualisierung auf LiveCycle ES
Version
Aktualisieren auf LiveCycle ES für WebSphere
Ausführen von Verwaltungsaufgaben
für LiveCycle ES
Verwalten von LiveCycle ES
Die gesamte Dokumentation zu LiveCycle ES
LiveCycle ES-Dokumentation
LiveCycle ES-Versionsinformationen und in
letzter Minute am Produkt vorgenommene
Änderungen
Anmerkungen zu dieser Version
Patch-Updates, technische Hinweise und
zusätzliche Informationen zu dieser
Produktversion
Technischer Support für LiveCycle
10
1
Einführung
In diesem Kapitel erhalten Sie Informationen zu den Typen von Installation und Bereitstellung,
die Sie durchführen sollten sowie Informationen zum Installations-, Konfiguration- und
Bereitstellungsprozess für:
●
„Informationen zur Installation, Konfiguration und Bereitstellung von LiveCycle ES“ auf Seite 11
●
„LiveCycle ES Checklisten für Installation, Konfiguration und Bereitstellung“ auf Seite 13
Informationen zum Vorbereiten Ihres Systems für die Installation von LiveCycle ES, einschließlich der
Systemvoraussetzungen, finden Sie in Vorbereiten der -Installation von LiveCycle ES.
Informationen zur Installation, Konfiguration und Bereitstellung
von LiveCycle ES
Die Installation, Konfiguration und Bereitstellung von LiveCycle ES besteht aus den folgenden Prozessen:
Installieren: Installieren Sie LiveCycle ES, indem Sie das Installationsprogramm ausführen. Bei der
Installation von LiveCycle ES werden alle erforderlichen Dateien in eine Installationsverzeichnisstruktur
auf dem Computer kopiert. Das Standardverzeichnis für die Installation ist „C:\Adobe\LiveCycle8.2“
(Windows) bzw. „/opt/adobe/LiveCycle8.2“ (Linux oder UNIX). Sie können die Dateien jedoch auch
in ein anderes Verzeichnis installieren. In diesem Dokument wird das Standardverzeichnis für die
Installation als [LiveCycleES-Stammverzeichnis] bezeichnet. (Siehe „Installation der Dateien
für Lösungskomponenten“ auf Seite 15.)
Konfigurieren und Assemblieren: Beim Konfigurieren von LiveCycle ES wird eine Reihe von
Einstellungen geändert, die bestimmen, wie LiveCycle ES funktioniert. Beim Assemblieren des
Produkts werden alle installierten Komponenten gemäß Ihren Konfigurationsanweisungen zu
bereitstellbaren EAR- und JAR-Dateien zusammengefügt. Konfigurieren und assemblieren Sie die
Komponenten für die Bereitstellung, indem Sie LiveCycle Configuration Manager ausführen.
(Siehe „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 21.) Sie können mehrere
LiveCycle ES-Lösungskomponenten gleichzeitig konfigurieren und assemblieren.
Bereitstellen: Das Bereitstellen des Produkts besteht aus der Bereitstellung der assemblierten
EAR-Dateien und unterstützender Dateien auf dem WebSphere-Anwendungsserver, auf dem Sie die
LiveCycle ES-Lösung ausführen möchten. Wenn Sie mehrere Lösungskomponenten konfiguriert und
assembliert haben, werden die bereitstellbaren Komponenten in den bereitstellbaren EAR-Dateien
zusammengefasst. Komponenten und LiveCycle ES-Archivdateien (LCA) sind als JAR-Dateien gepackt.
Initialisieren der LiveCycle ES-Datenbank: Beim Initialisieren der mit LiveCycle ES
zu verwendenden Datenbank werden Tabellen für die Verwendung mit User Management und
anderen Lösungskomponenten erstellt. Wenn Sie eine Lösungskomponente bereitstellen,
die eine Verbindung mit der LiveCycle ES-Datenbank herstellt, müssen Sie die LiveCycle ES-Datenbank
nach der Bereitstellung initialisieren.
11
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Einführung
Auswählen von Aufgaben für das Konfigurieren und Bereitstellen
von LiveCycle ES
12
Auswählen von Aufgaben für das Konfigurieren und Bereitstellen
von LiveCycle ES
Im Anschluss an eine Installation können Sie LiveCycle Configuration Manager ausführen, um eine Reihe
von Aufgaben durchzuführen:
●
Konfigurieren von LiveCycle ES-Lösungskomponenten in einer EAR-Datei zum Bereitstellen auf dem
Anwendungsserver
●
Konfigurieren von Anwendungsservereigenschaften zur Unterstützung von LiveCycle ES
●
Überprüfen der Konfiguration für den Anwendungsserver
●
Bereitstellen von LiveCycle ES-EAR-Dateien
●
Initialisieren der LiveCycle ES-Datenbank
●
Bereitstellen der LiveCycle ES-Komponenten
●
Überprüfen der Bereitstellung von LiveCycle ES-Komponenten
●
Konfigurieren der Berechtigung für Rechte von LiveCycle Reader Extensions ES (optional)
●
Importieren der LiveCycle ES-Beispiele (optional)
Wenn Sie Reader Extensions ES installieren, können Sie ebenfalls die Berechtigung für Rechte von
Reader Extensions ES angeben und importieren, die für das Anwenden von Verwendungsrechten
auf PDF-Dokumente erforderlich ist.
Obwohl Sie mithilfe von LiveCycle Configuration Manager den Anwendungsserver konfigurieren und
Datenquellen für die Datenbank einrichten können, möchten Sie diese Schritte vielleicht lieber manuell
vornehmen.
Gründe für das manuelle Konfigurieren des Anwendungsservers:
●
Es sind andere Anwendungen auf dem Anwendungsserver installiert und Sie befürchten
Konfigurationskonflikte.
●
Die Sicherheitsprozeduren für die Konfigurationsverwaltung in Ihrem Unternehmen schreiben eine
stärkere Kontrolle vor.
●
Sie nehmen Bereitstellungen vor, für die keine automatische Konfiguration zur Verfügung steht.
Führen Sie bei einer manuellen Konfiguration folgende Aufgaben aus:
●
Verwenden Sie LiveCycle Configuration Manager zum Konfigurieren von LiveCycle ES-Komponenten
mit den erforderlichen Schriftart- und temporären Verzeichnisse.
●
Konfigurieren Sie den Anwendungsserver konfigurieren Sie Datenquellen und stellen Sie die
EAR-Dateien für LiveCycle ES bereit.
●
Führen Sie LiveCycle Configuration Manager aus, um die Datenbank zu initialisieren.
Aktualisieren auf LiveCycle ES
Bevor Sie LiveCycle ES für die Aktualisierung von LiveCycle 7.x und höher installieren, müssen Sie
unbedingt die Aufgaben durchführen, die im Handbuch Vorbereiten der Aktualisierung auf LiveCycle ES
beschrieben werden.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Einführung
LiveCycle ES Checklisten für Installation, Konfiguration und
Bereitstellung
13
LiveCycle ES 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
automatischen Methode oder der manuellen Methode zur Verfügung.
Automatische Methode: Sieht die Verwendung von LiveCycle Configuration Manager
zum Konfigurieren und Bereitstellen von LiveCycle ES-EAR-Dateien, Konfigurieren des
Anwendungsservers, Initialisieren der Datenbank und Bereitstellen der Lösungskomponenten auf
dem Server vor. Die automatische Methode empfiehlt sich, wenn die Installation, Konfiguration und
Bereitstellung von LiveCycle ES mit so wenig Eingaben wie möglich erfolgen soll.
Manuelle Methode: Sieht die Verwendung von LiveCycle Configuration Manager nur zum
Konfigurieren von LiveCycle ES-EAR-Dateien, Initialisieren der Datenbank und Bereitstellen der
Lösungskomponenten auf dem Server vor. Die Konfiguration des Anwendungsserver, das Herstellen
einer Verbindung zur Datenbank und das Bereitstellen von LiveCycle ES-EAR-Dateien auf dem Server
wird vom Administrator manuell unter Verwendung der weiter hinten in diesem Handbuch
dargelegten Anweisungen durchgeführt. Die manuelle Methode empfiehlt sich, wenn die Installation,
Konfiguration und Bereitstellung von LiveCycle ES mit so präzisen Eingaben wie möglich erfolgen soll.
Diese Methode kann beispielsweise bei einer gesperrten Serverumgebung eingesetzt werden.
Checkliste für die automatische Installation und Bereitstellung
Die folgende Liste enthält die Schritte, die für die Installation von LiveCycle ES-Lösungskomponenten
mit der automatischen Methode erforderlich sind. WebSphere Application Server muss bereits installiert
sein, bevor Sie die Installation ausführen:
●
Vergewissern Sie sich, dass die erforderliche Software in der Zielumgebung installiert ist. (Siehe
Vorbereiten der Installation von LiveCycle ES (Einzelserver)).
●
Führen Sie das Installationsprogramm aus. (Siehe „Installation der Dateien für Lösungskomponenten“
auf Seite 15.)
●
Führen Sie LiveCycle Configuration Manager aus und wählen Sie alle Aufgaben im Bildschirm
„Taskauswahl“ aus. Dadurch werden die LiveCycle ES-EAR-Dateien konfiguriert und assembliert,
die Einstellungen des Anwendungsservers konfiguriert, die EAR-Dateien und anderen Komponenten
auf dem Anwendungsserver bereitgestellt, die LiveCycle ES-Datenbank initialisiert und die
Bereitstellung überprüft. (Siehe „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 21.)
●
Greifen Sie auf die LiveCycle Administration Console und User Management zu. (Siehe „Zugreifen
auf LiveCycle Administration Console“ auf Seite 59.)
●
(Optional) Konfigurieren Sie den LDAP-Zugriff. (Siehe „Konfigurieren von LiveCycle ES für den
LDAP-Zugriff“ auf Seite 71.)
Checkliste für die manuelle Installation und Bereitstellung
Die folgende Liste enthält die Schritte, die für die Installation von LiveCycle ES mit der manuellen Methode
erforderlich sind. Ihr Anwendungsserver muss bereits installiert und konfiguriert sein, bevor Sie die
Installation durchführen.
●
Vergewissern Sie sich, dass die erforderliche Software in der Zielumgebung installiert und
konfiguriert ist. (Siehe Vorbereiten der Installation von LiveCycle ES (Einzelserver).
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Einführung
Checkliste für die manuelle Installation und Bereitstellung
14
●
Führen Sie das Installationsprogramm aus. (Siehe „Installation der Dateien für Lösungskomponenten“
auf Seite 15.)
●
Führen Sie LiveCycle Configuration Manager aus und wählen Sie die Aufgabe „LiveCycle ES EARs
konfigurieren“ aus. Diese Aufgabe konfiguriert und assembliert LiveCycle ES. (Siehe „Konfigurieren
von LiveCycle ES für die Bereitstellung“ auf Seite 21.)
●
Konfigurieren Sie die WebSphere Application Server-Einstellungen. Hierbei müssen verschiedene
Einstellungen konfiguriert werden. (Siehe „Manuelles Konfigurieren von WebSphere“ auf Seite 30.)
●
Stellen Sie die EAR-Dateien auf dem Anwendungsserver bereit. Sie können dies manuell tun oder den
LiveCycle Configuration Manager verwenden. (Siehe „Manuelles Bereitstellen von WebSphere“
auf Seite 55.)
●
Führen Sie LiveCycle Configuration Manager aus, um LiveCycle ES-Komponentendateien bereitzustellen,
initialisieren Sie die LiveCycle ES-Datenbank und stellen Sie (optional) Produktbeispiele bereit. (Siehe
„Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 21.)
●
Greifen Sie auf die LiveCycle Administration Console und User Management zu. (Siehe „Zugreifen
auf LiveCycle Administration Console“ auf Seite 59.)
●
(Optional) Konfigurieren Sie den LDAP-Zugriff. (Siehe „Konfigurieren von LiveCycle ES für den
LDAP-Zugriff“ auf Seite 71.)
2
Installation der Dateien für Lösungskomponenten
In diesem Abschnitt wird die erste Phase der Einrichtung eines LiveCycle ES-Systems beschrieben, auf dem
das LiveCycle ES-Installationsprogramm unter einem Betriebssystem vom Typ Windows, Linux oder UNIX
ausgeführt wird. In einer nachfolgenden Phase wird die Ausführung von LiveCycle Configuration Manager
zum Konfigurieren und Bereitstellen von LiveCycle ES beschrieben.
Stellen Sie vor der Installation der Lösungskomponenten sicher, dass die Umgebung über die zum
Ausführen von LiveCycle ES-Produkten erforderliche Software und Hardware verfügt. Außerdem
sollten Sie mit den Installationsoptionen vertraut sein und die Umgebung entsprechend vorbereitet
haben. (Siehe Vorbereiten der Installation von LiveCycle ES (Einzelserver).)
LiveCycle ES bietet außerdem eine Befehlszeilenschnittstelle (Command Line Interface, CLI) für das
Installationsprogramm. Die Befehlszeilenschnittstelle sollte nur von erfahrenen LiveCycle ES-Benutzern
oder in Serverumgebungen verwendet werden, die die Verwendung der grafischen Benutzeroberfläche
von LiveCycle Configuration Manager nicht unterstützen (siehe „Anhang – LCM-Befehlszeilenschnittstelle“
auf Seite 137).
In diesem Kapitel werden die folgenden Themen behandelt:
●
„Installieren der Produktdateien“ auf Seite 15
●
„Anzeigen des Fehlerprotokolls“ auf Seite 19
Installieren der Produktdateien
Zur Ausführung eines Installationsprogramms benötigen Sie die Seriennummer der zu installierenden
Lösungskomponenten. Bei einer Aktualisierung von LiveCycle ES 8.0 werden die vorhandenen
Seriennummern für LiveCycle ES 8.0 verwendet. In diesem Fall müssen Sie nur dann weitere
Seriennummern hinzufügen, wenn Sie zusätzlich zu den zu aktualisierenden Komponenten
weitere Lösungskomponenten installieren.
●
Art der durchzuführenden Installation und Konfiguration
Eine erfolgreiche Installation setzt voraus, dass Sie über Lese- und Schreibberechtigungen
für das Installationsverzeichnis verfügen. Bei den folgenden Verzeichnissen handelt es sich
um die standardmäßigen Installationsverzeichnisse. Sie können jedoch bei Bedarf auch ein
anderes Verzeichnis festlegen:
●
(Windows) C:\Adobe\LiveCycle8.2\
●
(UNIX) /opt/adobe/livecycle8.2/
Das Installationsprogramm verwendet bei der Installation unter Linux das Basisverzeichnis des
angemeldeten Benutzers als temporäres Verzeichnis zum Speichern von Dateien. Daher werden
in der Konsole möglicherweise solche Meldungen angezeigt:
WARNING: could not delete temporary file/home/<Benutzername>/ismp001/1556006
Sie müssen nach Abschluss der Installation die temporären Dateien manuell löschen.
15
Adobe LiveCycle ES
Installation der Dateien für Lösungskomponenten
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren auf einer Windows-Testplattform für die Bereitstellung
unter Linux oder UNIX
16
Vorsicht: Stellen Sie sicher, dass das temporäre Verzeichnis Ihres Betriebssystems die
Mindestanforderungen erfüllt, die in Vorbereiten der Installation von LiveCycle ES (auf einem
einzelnen Knoten) beschrieben werden. Das temporäre Verzeichnis befindet sich an einem der
folgenden Speicherorte:
●
(Windows) TMP oder TEMP gemäß Einstellung in den Umgebungsvariablen
●
(UNIX) Basisverzeichnis des angemeldeten Benutzers
Auf UNIX-Systemen können Sie Lösungskomponenten auch installieren, konfigurieren und bereitstellen,
wenn Sie nicht als Root-Benutzer angemeldet sind:
●
(Solaris) /var/tmp
●
(AIX) /tmp
Hinweis: Wenn Sie die Lösungskomponenten unter dem Betriebssystem Linux oder UNIX installieren,
müssen Sie als Root-Benutzer angemeldet sein, um das Produkt erfolgreich im
Standardinstallationsverzeichnis „/opt/adobe/LiveCycle8.2/“ installieren zu können.
Wenn Sie nicht als Root-Benutzer angemeldet sind, ändern Sie das Installationsverzeichnis
in ein Verzeichnis, für das Sie Lese-, Schreib- und Ausführungsberechtigungen besitzen.
Sie können das Verzeichnis beispielsweise in „home/[Benutzername]/livecycle8.2“ ändern.
Temporäre Dateien werden im temporären Standardsystemverzeichnis oder in dem von Ihnen
angegebenen Verzeichnis erzeugt. In bestimmten Fällen bleiben die erzeugten temporären
Dateien auch nach dem Beenden des Installationsprogramms noch bestehen. Sie können diese
Dateien auch manuell entfernen.
Installieren auf einer Windows-Testplattform für die Bereitstellung
unter Linux oder UNIX
LiveCycle ES kann unter Windows für eine Bereitstellung auf einer Linux- oder UNIX-Plattform installiert
und konfiguriert werden. Sie können diese Funktionalität für die Installation in einer gesperrten Linuxoder UNIX-Umgebung verwenden. So ist in einer gesperrten Umgebung beispielsweise keine grafische
Benutzeroberfläche installiert. Wenn Sie das Installationsprogramm unter Windows ausführen, können Sie
ein Linux- oder UNIX-Betriebssystem als Zielplattform für die Bereitstellung von LiveCycle ES auswählen.
Das Installationsprogramm installiert Binärdateien für Linux oder Solaris, die auch von LiveCycle
Configuration Manager verwendet werden, wenn Sie das Produkt konfigurieren.
Der Computer mit Windows kann anschließend als Testspeicherort für die bereitstellbaren Objekte genutzt
werden, die auf einen Linux- oder UNIX-Computer für die Bereitstellung auf dem Anwendungsserver
kopiert werden können. Der gewünschte Anwendungsserver muss der Auswahl während der Installation
und Konfiguration ungeachtet des Betriebssystems entsprechen.
Hinweis: Das Host- und Zielbetriebssystem muss Windows sein, damit die Installation von Acrobat
für LiveCycle PDF Generator ES über das Installationsprogramm unterstützt wird.
Konfigurieren der Berechtigung für Rechte von LiveCycle Reader
Extensions ES
Sie sich vor dem Ausfuhren der Installation vergewissern, dass Sie über eine gültige Berechtigung und ein
Kennwort verfugen. Wenn Ihnen diese Informationen aktuell nicht vorliegen, können Sie die Berechtigung
nach der Installation und Bereitstellung von LiveCycle ES auf den Trust Store-Konfigurationsseiten
in LiveCycle Administration Console installieren.
Adobe LiveCycle ES
Installation der Dateien für Lösungskomponenten
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Hinzufügen des Java 5-SDK in die Umgebungsvariable JAVA_HOME
17
Hinzufügen des Java 5-SDK in die Umgebungsvariable JAVA_HOME
Die Umgebungsvariable JAVA_HOME muss auf das Java 5-SDK zeigen. Das benötigte Java-SDK heißt,
auf allen Plattformen außer Solaris Auf allen Plattformen außer Solaris müssen Sie auf IBM JDK 1.5.0 SR2
(in den Anwendungsserver integriert) verweisen. Unter Solaris müssen Sie auf Sun JDK 1.5.0_09
verweisen.
Die Java 5-SDK-Anforderungen finden Sie auch in Vorbereiten der Installation von LiveCycle ES
(Einzelknoten).
Installieren von LiveCycle ES
In diesem Abschnitt wird die Erstinstallation von LiveCycle ES Informationen zu Konfiguration und
Bereitstellung finden Sie unter „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 21.
Hinweis: Um Berechtigungsprobleme bei der Bereitstellung zu vermeiden, müssen Sie sicherstellen,
dass Sie das LiveCycle ES-Installationsprogramm und LiveCycle Configuration Manager als der
Benutzer ausführen, der den WebSphere-Server ausführt.
➤ So installieren Sie LiveCycle ES:
1. Wechseln Sie zum Verzeichnis „/livecycle_server/8.2“ auf dem Installationsmedium.
2. Bei einer Installation unter AIX oder Linux, die nicht direkt von einer Installations-DVD erfolgt,
müssen Sie Ausführungsberechtigung für die Installationsdatei festlegen, indem Sie einen von
folgenden Befehlen an der Eingabeaufforderung eingeben:
chmod 007 aix_livecycle8_setup.bin
chmod 007 linux_livecycle8_setup.bin
3. Starten Sie das Installationsprogramm:
●
(Windows) Doppelklicken Sie auf die Datei „win_livecycle8_setup.exe“.
●
(UNIX) Geben Sie an einer Eingabeaufforderung den für Ihr Betriebssystem benötigten
Dateinamen ein:
./aix_livecycle8_setup.bin
./linux_livecycle8_setup.bin
./solaris_livecycle8_setup.bin
Starten Sie bei Installation auf einer Windows-Testplattform für die Bereitstellung unter UNIX die
ausführbare Windows-Datei.
Geben Sie die folgenden zusätzlichen Argumente an, um das temporäre Verzeichnis des LiveCycle ESInstallationsprogramms an einen anderen, vom Standardwert abweichenden Speicherort umzuleiten:
-cp:p stage.jar -is:tempdir [Pfad zum alternativen temporären
Verzeichnis]
4. Wählen Sie nach Aufforderung eine Sprache für die Installation und klicken Sie auf OK.
5. Klicken Sie im Begrüßungsbildschirm auf Weiter. Ist eine frühere Version von LiveCycle ES 8.0.x
installiert, Installation aktualisieren“ angezeigt.
6. Wählen Sie eine der folgenden Optionen aus und klicken Sie auf Weiter:
●
Vorhandene Installation auf LiveCycle ES v8.2 aktualisieren: Wählen Sie diese Option, wenn die
Aktualisierung von LiveCycle ES 8.0.x auf LiveCycle ES 8.2 erfolgen soll. Vergewissern Sie sich,
Adobe LiveCycle ES
Installation der Dateien für Lösungskomponenten
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren von LiveCycle ES
18
dass das im Bildschirm angezeigte Verzeichnis der vorhandenen Version von LiveCycle ES
entspricht. Wechseln Sie andernfalls zum ordnungsgemäßen Verzeichnis.
Die Wahl dieser Option stellt sicher, dass Informationen aus der vorhandenen Installation, z. B. die
Produktseriennummer, verwendet werden. LiveCycle Configuration Manager führt die eigentlichen
Aktualisierungsaufgaben aus, nachdem der Installationsprozess abgeschlossen ist. Sie müssen Ihre
vorhandene Umgebung sichern, bevor Sie die Aktualisierung ausführen. (Siehe unter „LiveCycle ESDatenbank“ und „Sicherung und Wiederherstellung des globalen Dokumentenspeichers“
in Verwalten von LiveCycle ES.)
Hinweis: Wenn Sie die vorhandene Version von LiveCycle ES aktualisieren möchten, öffnen Sie das
Dokument Aktualisieren auf LiveCycle ES 8.2 von 8.0.x für Ihren Anwendungsserver und
befolgen die darin enthaltenen Aktualisierungsanweisungen.
●
LiveCycle ES v8.2 installieren: Wählen Sie diese Option, wenn eine neue und gesonderte Instanz
von LiveCycle ES 8.2 installiert werden soll. Bei Wahl dieser Option wird Ihre vorherige Installation
von LiveCycle ES weder aktualisiert noch entfernt.
7. Akzeptieren Sie auf dem Bildschirm „Speicherort der Installation“ das angegebene Standardverzeichnis
oder klicken Sie auf „Durchsuchen“ und wechseln Sie zu dem Verzeichnis, in dem Sie die
Lösungskomponente installieren möchten. Klicken Sie dann auf „Weiter“.
Hinweis: Wenn Sie den Namen eines nicht vorhandenen Verzeichnisses eingeben, wird dieses
Verzeichnis erstellt.
Vorsicht: Bei der Installation der Lösungskomponente können Sie ein anderes Installationsverzeichnis
angeben. Wenn Sie die Lösungskomponente unter Linux oder UNIX installieren, darf das
angegebene Verzeichnis keine Leerzeichen enthalten, da die Installation sonst nicht
ausgeführt wird.
8. Geben Sie die Seriennummer in das Textfeld ein und klicken Sie auf Hinzufügen. Wenn Sie mehrere
Lösungskomponenten lizenziert haben, wiederholen Sie diesen Schritt für jede vorhandene
Seriennummer. Klicken Sie, nachdem alle Seriennummern der Liste hinzugefügt wurden, auf Weiter.
Hinweis: Wenn Sie eine vorhandene Installation auf LiveCycle ES 8.2 installieren möchten, werden die
Seriennummern bereits in der Liste „Lösungskomponente Lizenztyp“ angezeigt. Sie müssen
keine Seriennummer hinzufügen, sondern können zum Fortfahren auf „Weiter“ klicken.
Tipp: Zum Zurücksetzen der Seriennummer können Sie auf Löschen klicken.
9. Lesen Sie die Lizenzvereinbarung von Adobe LiveCycle ES Server und aktivieren Sie Ich akzeptiere
die Bedingungen der Lizenzvereinbarung. Wenn Sie die Lizenzvereinbarung nicht akzeptieren,
können Sie den Vorgang nicht fortsetzen.
10. Klicken Sie auf Weiter und wählen Sie den Speicherort des JAVA SE SDK aus. Sie können zum richtigen
SDK-Speicherort wechseln oder mit der Standardeinstellung fortfahren und auf Weiter klicken.
11. (Nur Windows) Wählen Sie im Bildschirm „Auswahl des Betriebssystems“ das Betriebssystem aus,
für das LiveCycle ES konfiguriert werden soll, und klicken Sie auf Weiter.
Hinweis: An dieser Stelle können Sie festlegen, dass Windows als Testplattform für Ihre Bereitstellung
verwendet werden soll. Sie können ein UNIX-Betriebssystem als Ziel der Bereitstellung
auswählen, auch wenn Sie die Installation unter Windows ausführen. (Siehe „Installieren
auf einer Windows-Testplattform für die Bereitstellung unter Linux oder UNIX“ auf Seite 16.)
Adobe LiveCycle ES
Installation der Dateien für Lösungskomponenten
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Anzeigen des Fehlerprotokolls
19
12. (NurPDF Generator ES oder PDF Generator 3D ES für Windows) Wählen Sie die geeignete Option im
PDF Generator ES-Bildschirm:
●
Ja, die Unterstützung nativer Anwendungen für PDF Generator ES aktivieren: Wählen Sie
diese Option aus, wenn Acrobat 9.0 installiert ist. Wenn Acrobat nicht installiert ist, führen Sie die
Installation jetzt durch.
Hinweis: In PDF Generator 3D ES ist die Unterstützung nativer Anwendungen erforderlich,
um 3D-Dateien in PDF zu konvertieren.
Wenn eine nicht unterstützte Version von Acrobat installiert ist, schließen Sie die Installation
von LiveCycle ES ab, deinstallieren Acrobat und installieren anschließend Acrobat 9.0 vom
LiveCycle ES-Installationsmedium gemäß den Anweisungen im Verfahren „Konfigurieren
von Acrobat 9.0“ auf Seite 65.
●
Nein, keine Unterstützung nativer Anwendungen für LiveCycle PDF Generator ES aktivieren:
Aktivieren Sie diese Option, wenn die Funktion zur Unterstützung nativer Anwendungen nicht
verwendet werden soll.
13. (Nur PDF Generator ES bzw. PDF Generator 3D ES für Windows) Vergewissern Sie sich, dass Acrobat
installiert ist, und klicken Sie auf Weiter.
14. Überprüfen Sie im Bildschirm „Zusammenfassung vor der Installation“ die Installationsdetails
und klicken Sie auf Installieren. Das Installationsprogramm zeigt den Status der Installation an.
15. Überprüfen Sie die angezeigten Anmerkungen zu dieser Version und klicken Sie auf Weiter.
16. Überprüfen Sie die Details im Bildschirm „Zusammenfassung nach der Installation“. Aktivieren Sie
LiveCycle Configuration Manager starten und klicken Sie auf Fertig stellen.
Hinweis: Durch Aktivieren der Option LiveCycle Configuration Manager starten wird LiveCycle
Configuration Manager gestartet, mit dem Sie die Konfiguration und Bereitstellung sofort
abschließen können. Wenn Sie nicht bereit sind, LiveCycle Configuration Manager auszuführen,
vergewissern Sie sich, dass die Option LiveCycle Configuration Manager starten nicht
aktiviert ist, wenn Sie auf Fertig stellen klicken. Sie können LiveCycle Configuration Manager
später starten, wenn Sie bereit sind. (Siehe „Konfigurieren von LiveCycle ES für die
Bereitstellung“ auf Seite 21.)
Hinweis: (Nur PDF Generator ES bzw. PDF Generator 3D ES für Windows) Wenn Sie Acrobat 9.0 nicht
mithilfe des LiveCycle ES-Installationsprogramms installiert haben, müssen Sie die unter
„Konfigurieren von Acrobat 9.0“ auf Seite 65 beschriebenen Schritte ausführen.
Anzeigen des Fehlerprotokolls
Falls bei der Installation Fehler auftreten, wird die Datei adobe_lc8.2_server_install.log erstellt, in der die
entsprechenden Fehlermeldungen enthalten sind. Diese Protokolldatei befindet sich im temporären
Systemverzeichnis (TEMP oder TMP). (Siehe „Fehlerbehebung“ auf Seite 117.)
Sie müssen die Schriftartenverzeichnisse für jeden Computer im Cluster konfigurieren, einschließlich der
im Verzeichnis „[LiveCycle ES-Stammverzeichnis]\fonts“ installierten LiveCycle ES-Schriften.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installation der Dateien für Lösungskomponenten
Nächste Schritte
20
Auf allen Computern im Cluster müssen die Schriften im selben Pfad vorhanden sein und das Verzeichnis
muss den identischen Inhalt haben. Dies können Sie durch Verwendung eines freigegebenen Verzeichnisses
erreichen, auf das alle Computer im Cluster Zugriff haben, oder indem Sie den Inhalt des Verzeichnisses
[LiveCycle ES-Stammverzeichnis]\fonts auf jedem Computer im Cluster in einem identischen Pfad verfügbar
machen.
Notieren Sie den Speicherort, an dem diese freigegebenen Verzeichnisse erstellt wurden, um ihn später
bei der Konfiguration von LiveCycle ES mithilfe von LiveCycle Configuration Manager zur Hand zu haben.
Vorsicht: Die Schriftartenverzeichnisse müssen gesondert vom Verzeichnis des globalen
Dokumentenspeichers sein. Sie dürfen aber gesonderte verwandte Unterverzeichnisse
eines einzigen freigegebenen übergeordneten Verzeichnisses sein.
Nächste Schritte
Sie müssen LiveCycle ES jetzt für die Bereitstellung konfigurieren. (Siehe „Konfigurieren von LiveCycle ES
für die Bereitstellung“ auf Seite 21.)
3
Konfigurieren von LiveCycle ES für die
Bereitstellung
In diesem Kapitel wird beschrieben, wie Sie mit LiveCycle Configuration Manager die folgenden Aufgaben
durchführen:
●
Konfigurieren von LiveCycle ES-Lösungskomponenten in einer EAR-Datei zum Bereitstellen auf dem
Anwendungsserver
●
Konfigurieren von Anwendungsservereigenschaften zur Unterstützung von LiveCycle ES
●
Überprüfen der Anwendungsserverkonfiguration
●
Bereitstellen von LiveCycle ES-EAR-Dateien
●
Initialisieren der LiveCycle ES-Datenbank
●
Bereitstellen von LiveCycle ES-Komponenten
●
Überprüfen der Bereitstellung von LiveCycle ES-Komponenten
●
(Optional) Konfigurieren der Berechtigung für Rechte von LiveCycle Reader Extensions ES
(falls Reader Extensions ES installiert ist)
●
Initialisieren von BAM-Metadaten für LiveCycle ES Business Activity Monitoring
(falls Business Activity Monitoring installiert ist)
●
(Optional) Importieren der LiveCycle ES-Beispiele in LiveCycle ES
In diesem Kapitel wird davon ausgegangen, dass Sie die Umgebung für das Hosten von LiveCycle ES
vorbereitet und die Dateien der Lösungskomponenten bereits installiert haben. Wenn dies nicht der
Fall ist, finden Sie Informationen unter Vorbereiten der Installation von LiveCycle ES (auf einem einzelnen
Knoten) und „Installation der Dateien für Lösungskomponenten“ auf Seite 15.
Info LiveCycle Configuration Manager
LiveCycle Configuration Manager ist ein einem Assistenten ähnliches Tool zum Konfigurieren, Bereitstellen
und Überprüfen von LiveCycle ES-Komponenten für die Bereitstellung auf dem Anwendungsserver.
Sie können LiveCycle Configuration Manager verwenden, um den Anwendungsserver zu konfigurieren
und die EAR-Dateien für die Produkte auf dem Anwendungsserver bereitzustellen.
LiveCycle Configuration Manager wird mit den Lösungskomponentendateien installiert, wenn Sie das
Installationsprogramm von LiveCycle ES ausführen. Wenn Sie LiveCycle Configuration Manager ausführen,
geben Sie die zu konfigurierenden LiveCycle ES-Lösungskomponenten sowie alle von LiveCycle
Configuration Manager auszuführenden Aufgaben an.
Sie können LiveCycle Configuration Manager über das Installationsprogramm starten, wenn Sie die
Lösungskomponenten noch während der Installation konfigurieren möchten. Andernfalls können Sie
LiveCycle Configuration Manager später zu einem beliebigen Zeitpunkt ausführen. Wenn Sie mithilfe von
LiveCycle Configuration Manager den Anwendungsserver konfigurieren oder auf dem Anwendungsserver
Bereitstellungen vornehmen möchten, muss dieser gestartet sein, damit LiveCycle Configuration Manager
auf dem Server Konfigurationsaufgaben ausführen kann.
21
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von LiveCycle ES für die Bereitstellung
Befehlszeilenschnittstelle im Vergleich zur grafischen
Benutzeroberfläche LiveCycle Configuration Manager
22
Es ist möglich, einen Anwendungsserver zu konfigurieren, der nicht auf dem Computer installiert ist,
auf dem LiveCycle Configuration Manager ausgeführt wird. Allerdings muss der Anwendungsserver
auch auf dem Computer mit LiveCycle Configuration Manager installiert sein (ohne ausgeführt werden
zu müssen), damit LiveCycle Configuration Manager die Bibliotheksdateien des Anwendungsservers
verwenden kann.
Befehlszeilenschnittstelle im Vergleich zur grafischen Benutzeroberfläche
LiveCycle Configuration Manager
In diesem Beispiel wird die grafische LiveCycle Configuration Manager-Version beschrieben. Anweisungen
zum Arbeiten mit der Befehlszeilenschnittstellen-Version von LiveCycle Configuration Manager finden Sie
in „Anhang – LCM-Befehlszeilenschnittstelle“ auf Seite 137. Die folgende Tabelle veranschaulicht die
Funktionalität beider LiveCycle Configuration Manager-Versionen und nennt die manuell ausführbaren
Konfigurationsaufgaben.
LiveCycle ES-Konfigurationsaufgabe
Grafische
LCM-Version
LCM-Befehlszeilenversion
Manuell
(Nicht-LCM)
Konfigurieren von LiveCycle ES
Ja
Ja
Nein
Anwendungsserver konfigurieren
Ja
Ja
Ja
Überprüfen der Anwendungsserverkonfiguration
Ja
Ja
Ja
Bereitstellen von LiveCycle ES-EAR-Dateien
Ja
Ja
Ja
Initialisieren der LiveCycle ES-Datenbank
Ja
Ja
Nein
Initialisieren von Business Activity Monitoring
Ja
Ja
Ja
Bereitstellen von LiveCycle ES-Komponenten
Ja
Ja
Nein
Überprüfen der Bereitstellung
von LiveCycle ES-Komponenten
Ja
Ja
Ja
Überprüfen der Serververbindung
Ja
Ja
Nein
Überprüfen der LiveCycle ES-Serververbindung
Ja
Ja
Nein
Überprüfen der Datenbankverbindung
Ja
Ja
Nein
Konfigurieren von Reader Extensions ES
Ja
Nein
Ja
Importieren von Beispielen
Ja
Nein
Ja
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Ermitteln des SOAP-Anschlusses des Anwendungsservers
23
Ermitteln des SOAP-Anschlusses des Anwendungsservers
Auf einigen LiveCycle Configuration Manager-Bildschirmen müssen Sie den SOAP-Anschluss des
Anwendungsservers angeben. Führen Sie die folgenden Schritte aus, um zu ermitteln, welcher Anschluss
mit dem Anwendungsserver für SOAP-Verbindungen verwendet wird. Der Standardanschluss ist „8880“.
➤ So ermitteln Sie den SOAP-Anschluss unter WebSphere:
1. Wählen Sie in der Navigationsstruktur der Verwaltungskonsole von WebSphere den Befehl „System
Administration“ > „Application Servers“.
2. Klicken Sie unter „Additional Properties“ auf „Ports“. Notieren Sie sich im nächsten Bildschirm die
Anschlussnummer für SOAP_CONNECTOR_ADDRESS.
Hinweis: In der Verwaltungskonsole von WebSphere wird die Adresse des SOAP-Connectors in zwei
unterschiedlichen Abschnitten aufgeführt. Verwenden Sie den in Schritt 1 angegebenen Pfad.
Wenn Sie den SOAP-Anschluss verwenden, der unter „Servers“ > „Application Servers“ >
„[Servername]“ > „Communications“ > „Ports“ aufgeführt ist, wird beim Ausführen von LiveCycle
Configuration Manager folgende Fehlermeldung angezeigt:
com.adobe.livecycle.cdv.util.JaclResponseParser, parseString: WASX7017E:
Exception received while running file "..\scripts\jacl\config.jacl"; exception information:
com.ibm.ws.scripting.ScriptingException: WASX7070E: The configuration service is not available.
Konfigurieren von und Bereitstellen von LiveCycle ES
Beim Ausführen von LiveCycle Configuration Manager können Sie die Aufgaben auswählen, die vom
Programm automatisch durchgeführt werden sollen.
Hinweis: Die Bereitstellung von LiveCycle ES-Lösungskomponenten auf Remote-Servern mithilfe von
LiveCycle Configuration Manager wird nur bei verwalteten Anwendungsservern unterstützt,
nicht jedoch bei eigenständigen Anwendungsservern.
Tipp: LiveCycle Configuration Manager überprüft die in den einzelnen Bildschirmen angegebenen Werte,
wenn Sie auf „Weiter“ klicken. Wenn ein Wert nicht überprüft werden kann, wird eine Warnmeldung
angezeigt. Die entsprechende Eigenschaft wird auf dem Bildschirm rot angezeigt und der Vorgang
kann erst fortgesetzt werden, nachdem Sie einen gültigen Wert eingegeben haben.
Nachdem LiveCycle Configuration Manager die Konfiguration der LiveCycle ES -EAR-Dateien
abgeschlossen hat, werden die Dateien adobe-livecycle-native-websphere-[BS].ear,
adobe-livecycle-websphere.ear, adobe-workspace-client.ear (falls LiveCycle Process Management ES
installiert ist) und adobe-contentservices.ear (falls LiveCycle Content Services ES installiert ist) in das
folgende Verzeichnis kopiert:
●
(Windows) [LiveCycle ES-Stammverzeichnis]\configurationManager\export
●
(Linux, UNIX) [LiveCycle ES-Stammverzeichnis]/configurationManager/export
Wenn Sie mit LiveCycle Configuration Manager die EAR-Dateien bereitstellen, greift LiveCycle
Configuration Manager auf diese Dateien zu und stellt sie auf dem Anwendungsserver bereit. Wenn Sie
die LiveCycle ES-EAR-Dateien manuell bereitstellen, können Sie auf die Dateien in diesem Verzeichnis
zugreifen und sie auf dem Anwendungsserver bereitstellen.
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von und Bereitstellen von LiveCycle ES
24
Nach der Konfiguration der LiveCycle ES-EAR-Dateien durch LiveCycle Configuration Manager können Sie
die EAR-Dateien in benutzerdefinierte Dateinamen umbenennen (um beispielsweise im Dateinamen
einen Versionsbezeichner oder andere Informationen anzugeben, die für Standardverfahren in der lokalen
J2EE-Umgebung erforderlich sind). In LiveCycle Configuration Manager wird die Bereitstellung bzw. das
Aufheben der Bereitstellung von EAR-Dateien mit benutzerdefinierten Dateinamen nicht unterstützt.
Wenn Ihre EAR-Dateien benutzerdefinierte Dateinamen tragen, müssen Sie sie manuell auf dem
Anwendungsserver bereitstellen bzw. ihre Bereitstellung manuell aufheben. (Dies ist z. B. der Fall,
wenn Sie die EAR-Dateien anfangs mit benutzerdefinierten Dateinamen bereitstellen und später
Änderungen wie Service Packs oder Patches hinzufügen.)
Hinweis: Wenn Sie zuvor LiveCycle ES-Dateien bereitgestellt haben, müssen Sie zuerst die Bereitstellung
der produktspezifischen EAR-Dateien auf dem Anwendungsserver aufheben. Wenn Sie jedoch
EAR-Dateien mit LiveCycle Configuration Manager automatisch bereitstellen, hebt dieses Tool
die Bereitstellung zuvor bereitgestellter Dateien automatisch auf, bevor die aktualisierten
Dateien bereitgestellt werden. Falls bei diesem Prozess Fehler auftreten, können Sie die
Bereitstellung der EAR-Dateien manuell aufheben. (Siehe „Deinstallieren von LiveCycle ES“
auf Seite 93.)
Wenn Sie einen Remote-Anwendungsserver konfigurieren, stellen Sie sicher, dass ein Anwendungsserver
ebenfalls auf dem Computer mit LiveCycle Configuration Manager installiert ist, damit LiveCycle
Configuration Manager die Bibliotheksdateien des Anwendungsservers nutzen kann.
➤ So erfolgt die Konfiguration, die Aktualisierung auf und Bereitstellung von LiveCycle ES:
Tipp: In LiveCycle Configuration Manager können Sie F1 drücken, um Hilfeinformationen zum aktuellen
Bildschirm anzuzeigen. Diese Hilfe enthält Einzelheiten, die ggf. nicht in diesem Dokument
enthalten sind, und gilt spezifisch für den Kontext der einzelnen Bildschirme in LiveCycle
Configuration Manager.
1. Wenn Sie LiveCycle Configuration Manager im Installationsprogramm nicht automatisch gestartet
haben, wechseln Sie zum Verzeichnis „[LiveCycle ES-Stammverzeichnis]/configurationManager/bin“ und
geben den geeigneten Befehl ein:
●
(Windows) ConfigurationManager.bat
●
(Linux, UNIX) ./ConfigurationManager.sh
2. Wählen Sie bei der entsprechenden Aufforderung eine Sprache aus und klicken Sie auf OK.
3. Klicken Sie im Begrüßungsbildschirm auf Weiter.
4. Vergewissern Sie sich, dass im Bildschirm Auswahl der Aktualisierungsaufgaben die Option
Von LiveCycle ES aktualisieren nicht ausgewählt ist und klicken Sie auf Weiter, um fortzufahren.
Vorsicht: Wenn Sie eine bestehende LiveCycle ES-Installation aktualisieren möchten, führen Sie
nicht dieses Verfahren aus. Informationen und Verfahrenweisen zur Aktualisierung finden Sie im
Handbuch Vorbereiten der Aktualisierung auf LiveCycle ES für die aktuelle Version von LiveCycle ES
und im Handbuch Aktualisieren auf LiveCycle ES für Ihren Anwendungsserver.
5. Wählen Sie im Bildschirm „Auswahl von Lösungskomponenten“ die LiveCycle ESLösungskomponenten aus, die Sie installiert haben und bereitstellen möchten,
und klicken Sie auf Weiter.
6. Wählen Sie im Bildschirm „Taskauswahl“ alle Aufgaben aus, die durchgeführt werden sollen,
und klicken Sie auf Weiter.
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von und Bereitstellen von LiveCycle ES
25
Hinweis: Wenn Sie den Anwendungsserver nicht automatisch konfigurieren und LiveCycle ES
mit LiveCycle Configuration Manager automatisch bereitstellen möchten, wählen Sie
die Aufgaben Anwendungsserver konfigurieren, Anwendungsserverkonfiguration
überprüfen und LiveCycle ES-EARs bereitstellen. Sie müssen jedoch den Anwendungsserver
mithilfe der in „Manuelles Konfigurieren von WebSphere“ auf Seite 30 beschriebenen
Schritte manuell konfigurieren.
Vorsicht: Wählen Sie nicht die Option Anwendungsserver konfigurieren aus, wenn Sie Ihren
Anwendungsservercluster zuvor manuell konfiguriert haben. Die Auswahl dieser Option
für einen manuell konfigurierten Anwendungsservercluster kann LiveCycle ES-Fehler oder
Ausfälle verursachen.
7. Klicken Sie im Bildschirm „LiveCycle ES konfigurieren (1 von 3)“ auf „Konfigurieren“. Klicken Sie nach der
Konfiguration der EAR-Dateien auf Weiter.
8. Legen Sie im Bildschirm „LiveCycle ES konfigurieren (2 von 3)“ die Verzeichnisse fest, die von LiveCycle ES
verwendet werden, um auf Schriftarten zuzugreifen und temporäre Daten zu speichern, die im
Zusammenhang mit der Verarbeitung von Aufträgen stehen:
●
(Optional) Wenn Sie den Standardspeicherort des Verzeichnisses für Adobe-Serverschriftarten
ändern möchten, geben Sie den Pfad ein oder wechseln zu dem Verzeichnis.
●
(Optional) Geben Sie ein Verzeichnis an für das Feld Verzeichnis für Kundenschriftarten.
In diesem Verzeichnis werden alle zusätzlichen Schriftarten gespeichert, die lizenziert und
installiert sind.
●
(Optional) Wenn Sie den Standardspeicherort des Verzeichnisses für Systemschriftarten ändern
möchten, geben Sie den Pfad ein oder wechseln zu dem Verzeichnis.
●
(Optional) Um den Speicherort des temporären Verzeichnisses festzulegen, klicken Sie
auf Durchsuchen.
●
(Optional) Um FIPS zu aktivieren, vergewissern Sie sich, dass FIPS aktivieren ausgewählt ist.
Wählen Sie diese Option nur aus, wenn die Federal Information Processing Standards (FIPS)
erzwungen werden sollen.
9. Klicken Sie nach Angabe der Verzeichnisse auf Weiter.
10. Fügen Sie im Bildschirm „LiveCycle ES konfigurieren (3 von 3)“ den Speicherort für den Verzeichnispfad
des globalen Dokumentenspeichers hinzu, indem Sie eine der folgenden Aktionen ausführen:
●
Geben Sie den Speicherort des Verzeichnisses des globalen Dokumentenspeichers ein.
●
Klicken Sie auf Durchsuchen und wechseln Sie zum Speicherort des Verzeichnisses des globalen
Dokumentenspeichers.
Hinweis: Wenn Sie keinen bestimmten Speicherort für das Stammverzeichnis des globalen
Dokumentenspeichers angeben, wird ein Standardwert verwendet.
11. Klicken Sie auf Weiter und dann auf Konfigurieren, um die LiveCycle ES-EAR-Dateien mit diesen
Verzeichnisinformationen zu konfigurieren. Klicken Sie nach Abschluss der Konfiguration auf Weiter.
12. (Nur Content Services ES) Legen Sie im Bildschirm „LiveCycle Content Services ES-Konfiguration“
die Parameter fest, die von Content Services ES verwendet werden:
●
Bereitstellungstyp: Wählen Sie Einzelserver oder .
●
Stammverzeichnis für Inhalte: Geben Sie das von Content Services ES verwendete
Stammverzeichnis an.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von LiveCycle ES für die Bereitstellung
Konfigurieren von und Bereitstellen von LiveCycle ES
26
13. Klicken Sie im Bildschirm „LiveCycle ES konfigurieren - Zusammenfassung“ auf Weiter.
14. Klicken Sie im Bildschirm LiveCycle ES-EARs bereitstellen auf Bereitstellen.
15. (Nur LiveCycle ES Connector for EMC Documentum, LiveCycle ES Connector for IBM FileNet und
LiveCycle ES Connector for IBM Content Manager) Drücken Sie im Bildschirm „LiveCycle ESConnectors konfigurieren“ die Taste F1, befolgen Sie die Anweisungen im Dialogfeld „Hilfe“ und
klicken Sie auf „Weiter“.
16. Geben Sie im Bildschirm „Konfigurationsdetails des Anwendungsservers“ die Informationen in die
Felder ein (Pflichtfelder sind mit einem Sternchen markiert) und klicken Sie dann auf Serververbindung
überprüfen. Klicken Sie nach erfolgreichem Abschluss der Überprüfung auf Weiter. Drücken Sie F1,
um Einzelheiten zu den geforderten Informationen zu erhalten.
Hinweis: In Während dieser Aufgabe wird die Datei adobe-lcm-lcvalidator.ear auf dem WebSphere
Application Server bereitgestellt, um Versionsinformationen zu erfassen.
17. Wählen Sie im Bildschirm „Auswahl der Anwendungsserverkonfiguration“ alle Aufgaben aus,
die von LiveCycle Configuration Manager ausgeführt werden sollen, und klicken Sie auf Weiter.
Drücken Sie F1, um Einzelheiten zu den geforderten Informationen zu erhalten.
18. Geben Sie im Bildschirm „Konfiguration der Servereinstellungen“ die Informationen in die Felder ein
und klicken Sie auf Weiter. Drücken Sie F1, um Einzelheiten zu den geforderten Informationen
zu erhalten.
Wenn Sie die Servereinstellungen manuell konfigurieren, ohne LiveCycle Configuration Manager
zu beenden, führen Sie die im Abschnitt „Manuelles Konfigurieren von WebSphere“ auf Seite 30
beschriebenen Aufgaben aus.
19. Geben Sie im Bildschirm „Datenquellenkonfiguration“ die Informationen in die Felder ein und
klicken Sie auf „Datenbankverbindung testen“. Klicken Sie nach erfolgreichem Abschluss des
Verbindungstests auf Weiter. Drücken Sie F1, um Einzelheiten zu den geforderten Informationen
zu erhalten.
Hinweis: Wenn Sie Microsoft SQL Server als Datenbank verwenden, müssen Sie die geeigneten
Datenbanktreiber wie im Handbuch Vorbereiten der Installation von LiveCycle ES (Einzelserver)
beschrieben herunterladen. Sie können Datenquellen auch manuell konfigurieren,
anstatt Sie von LiveCycle Configuration Manager konfigurieren zu lassen. Wählen Sie
„Datenquelle manuell konfigurieren“ in der WebSphere Administrative Console, bevor Sie
fortfahren, wechseln Sie anschließend, ohne LiveCycle Configuration Manager zu beenden,
zur WebSphere Administrative Console und konfigurieren Sie die Datenquellen
wie erforderlich und wie beschrieben im Kapitel „Manuelles Konfigurieren von WebSphere“
in diesem Handbuch.
20. (Nur, wenn „Servereinstellungen konfigurieren“ aktiviert isst) Klicken Sie im Bildschirm
„Anwendungsserverkonfiguration“ auf Konfigurieren. Starten Sie die Server nach entsprechender
Aufforderung neu. Klicken Sie nach Abschluss des Vorgangs auf Weiter.
21. (Nur, wenn „Datenquelle konfigurieren“ aktiviert ist) Wählen Sie im Bildschirm Überprüfung der
Anwendungsserverkonfiguration alle Aufgaben aus, die überprüft werden sollen, und klicken Sie
auf Überprüfen. Klicken Sie nach Abschluss des Vorgangs auf Weiter.
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von und Bereitstellen von LiveCycle ES
27
22. Wählen Sie im Bildschirm LiveCycle ES-EARs bereitstellen die bereitzustellenden EAR-Dateien und
den virtuellen Host, auf dem sie bereitgestellt werden sollen, aus und klicken Sie auf Bereitstellen.
Dieser Vorgang kann mehrere Minuten dauern. Starten Sie die Server neu, wenn Sie dazu aufgefordert
werden. Klicken Sie nach erfolgreichem Abschluss der Bereitstellung auf Weiter.
Vorsicht: Wenn Sie in Schritt 10 ein nicht standardmäßiges Verzeichnis des globalen Dokumentenspeichers
konfiguriert haben, müssen Sie den WebSphere Application Server neu starten, bevor Sie die
LiveCycle ES-EAR-Dateien bereitstellen.
23. Überprüfen Sie im LiveCycle ES-Bildschirm Datenbankinitialisierung, dass die Host- (mithilfe
der IP-Adresse) und Anschlussinformationen mit den Host- und Anschlussinformationen
für einen LiveCycle ES-Server übereinstimmen, und klicken Sie dann auf Initialisieren. Bei der
Datenbankinitialisierung werden Tabellen in der Datenbank erstellt, den Tabellen Standarddaten
hinzugefügt und Basisrollen in der Datenbank erstellt. Starten Sie die Server nach entsprechender
Aufforderung neu. Klicken Sie nach erfolgreichem Abschluss der Initialisierung auf Weiter.
24. (Nur für Business Activity Monitoring) Geben Sie im Bildschirm „Business Activity Monitoring
initialisieren“ Informationen in die folgenden Felder ein:
Datenbanktyp: Die Datenbank, für die BAM-Metadaten ausgeführt werden.
BAM-Host: Der Name oder die IP-Adresse des Computers, der als Host für den Anwendungsserver
dient, auf dem der BAM-Server ausgeführt wird.
BAM-HTTP-Anschluss: Der HTTP-Dienstanschluss, den die Datenbank nutzt (z. B. 9080).
Benutzer-ID des BAM-Administrators: Die Administrator-ID, die zum Anmelden bei
BAM Workbench erforderlich ist. Die standardmäßige Benutzer-ID ist system.
Kennwort des BAM-Administrators: Das Kennwort, um sich bei BAM Workbench anzumelden.
Das Standardkennwort ist manager.
25. (Nur Business Activity Monitoring) Klicken Sie auf Initialisieren, um den Initialisierungsprozess
zu starten. Klicken Sie im Anschluss zum Fortfahren auf Weiter.
26. Geben Sie im Bildschirm LiveCycle ES-Serverinformationen in das Feld Kennwort password ein.
(Dieses Kennwort ist das Standard-Administratorkennwort. Es wird empfohlen, dieses später
zu ändern).
27. Klicken Sie auf Serververbindung überprüfen, um sicherzustellen, dass die Informationen für den
standardmäßigen Anwendungsserver ordnungsgemäß sind. Klicken Sie nach erfolgreichem Abschluss
der Überprüfung auf Weiter.
Hinweis: Die in diesem Bildschirm angezeigten Serverinformationen sind Standardwerte für die
Bereitstellung.
Durch Überprüfen der Serververbindung können Sie die Problembehandlung eingrenzen,
sollten bei der Bereitstellung oder Überprüfung Fehler auftreten. Wenn der Verbindungstest
Erfolg hat, die Bereitstellung oder Überprüfung in den nächsten Schritten jedoch fehlschlägt,
können bei der Fehlerbehebung Verbindungsprobleme ausgeschlossen werden.
28. Klicken Sie im Bildschirm LiveCycle-Komponentenbereitstellung auf Bereitstellen. Die zu diesem
Zeitpunkt bereitgestellten Komponenten sind Java-Archivdateien, die in den LiveCycle ESDienstcontainer „eingeklinkt“ werden, damit Dienste bereitgestellt, orchestriert und ausgeführt
werden können. Klicken Sie zum Anzeigen des Bereitstellungsstatus auf Fortschrittsprotokoll
anzeigen. Klicken Sie nach erfolgreichem Abschluss der Bereitstellung auf Weiter.
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Deinstallieren von EAR-Dateien
28
29. Klicken Sie im Bildschirm „Überprüfung der LiveCycle-Komponentenbereitstellung“ auf Überprüfen.
LiveCycle Configuration Manager überprüft, ob die LiveCycle-Komponenten (Java-Archivdateien)
auf dem LiveCycle ES-Server bereitgestellt wurden und ausgeführt werden. Klicken Sie zum Anzeigen
des Überprüfungsstatus auf Fortschrittsprotokoll anzeigen. Klicken Sie nach erfolgreichem
Abschluss der Überprüfung auf Weiter.
30. (Nur für Reader Extensions ES) Geben Sie im Bildschirm „Konfiguration von LiveCycle
Reader Extensions ES-Berechtigungen“ die Details im Zusammenhang mit der Berechtigung
für Rechte an, die die Dienste der Lösungskomponenten aktiviert:
Berechtigung für Rechte von LiveCycle Reader Extensions ES: Der Pfad und Dateinamen der
Berechtigung für Rechte (PFX- oder P12-Dateityp).
Berechtigungskennwort für Rechte von LiveCycle Reader Extensions ES: Das der Berechtigung
zugeordnete Kennwort. Dieses Kennwort wurde zusammen mit der Berechtigungsdatei
bereitgestellt.
Name für die konfigurierte Berechtigung für Rechte: Der Name (oder Alias), den die Berechtigung
bei der Konfiguration von LiveCycle Configuration Manager erhält.
Dieser Name sowie der Alias, mit dem bei SDK-Aufrufen die Berechtigung referenziert wird, werden
auf der Reader Extensions ES-Webbenutzeroberfläche angezeigt. Sie konnen einen beliebigen
eindeutigen Namen für die Berechtigung für Rechte erstellen.
Tipp: Sie können diesen Schritt zu diesem Zeitpunkt auslassen, indem Sie „Später mit LiveCycle
Administration Console konfigurieren“ auswählen. Im Anschluss an die Bereitstellung können Sie
die Berechtigung für Rechte mit LiveCycle Administration Console konfigurieren. (Klicken Sie
nach der Anmeldung an LiveCycle Administration Console auf Startseite > Einstellungen >
Trust Store-Verwaltung > Lokale Berechtigungen.)
Klicken Sie auf „Konfigurieren“ und dann auf „Weiter“.
31. (Optional) Klicken Sie im Bildschirm „Import von LiveCycle ES-Beispielen“ auf Importieren.
Klicken Sie nach erfolgreichem Abschluss des Importvorgangs auf Weiter oder auf Import
von LiveCycle ES-Beispielen überspringen, um die Beispiele später zu importieren.
32. Überprüfen Sie auf der Seite „Zusammenfassung“ die ausgeführten Aufgaben und klicken Sie
auf Weiter. Der Bildschirm „Nächste Schritte“ wird mit URL- und Anmeldeinformationen angezeigt.
33. Klicken Sie auf Beenden.
Deinstallieren von EAR-Dateien
Führen Sie die folgenden Schritte aus, um die Bereitstellung einer LiveCycle ES-Lösungskomponente
aufzuheben.
1. Starten Sie den Anwendungsserver.
2. Starten Sie WebSphere Administrative Console, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/admin eingeben.
3. Klicken Sie in der Navigationsstruktur auf Applications > Enterprise Applications.
4. Wählen Sie die Anwendungen adobe-livecycle-native-websphere-[BS].ear,
adobe-livecycle-websphere.ear und adobe-workspace-client.ear sowie alle anderen installierten
LiveCycle ES-Anwendungen aus und klicken Sie auf Beenden.
Hinweis: Die Datei adobe-workspace-client.ear wird nur mit Process Management ES bereitgestellt.
Adobe LiveCycle ES
Konfigurieren von LiveCycle ES für die Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Nächste Schritte
29
5. Wählen Sie die Anwendungen adobe-livecycle-native-websphere-[BS].ear,
adobe-livecycle-websphere.ear und adobe-workspace-client.ear sowie alle anderen
installierten LiveCycle ES-Anwendungen aus und klicken Sie auf Deinstallieren.
6. Klicken Sie auf Save directly to Master Configuration und starten Sie WebSphere neu.
Nach der Deinstallation der EAR-Datei müssen Sie möglicherweise die EAR-Datei neu konfigurieren und
erneut bereitstellen, wenn Sie ein Element hinzugefügt haben, für das weitere JVM- oder JMS-Einstellungen
erforderlich sind. Sie müssen außerdem LiveCycle Configuration Manager ausführen, um wesentliche und
nicht wesentliche Daten zu migrieren, die Datenbank neu zu initialisieren und LiveCycle ES-Komponenten
bereitzustellen.
Nächste Schritte
Nach der Konfiguration und Bereitstellung von LiveCycle ES können Sie die folgenden Aufgaben
ausführen:
●
Überprüfen Sie die Bereitstellung. (Siehe „Überprüfen der Bereitstellung und Zugreifen auf die
LiveCycle Administration Console“ auf Seite 58.)
●
Greifen Sie auf die LiveCycle Administration Console zu. (Siehe „Zugreifen auf LiveCycle Administration
Console“ auf Seite 59.)
●
Konfigurieren Sie PDF Generator ES oder PDF Generator 3D ES. (Siehe „Konfigurieren von LiveCycle
PDF Generator ES oder 3D ES“ auf Seite 63.)
●
Führen Sie die endgültigen Einrichtung für Rights Management ES aus. (Siehe „Abschließende
Einrichtung für LiveCycle Rights Management ES“ auf Seite 71.)
●
Konfigurieren Sie LiveCycle ES-Lösungskomponenten für den Zugriff auf LDAP. (Siehe „Konfigurieren
von LiveCycle ES für den LDAP-Zugriff“ auf Seite 71.)
●
Optimieren Sie die Leistung überwachter Ordner für PDF Generator ES. (Siehe „Festlegen
von Leistungsparametern für überwachte Ordner in PDF Generator ES oder 3D ES“ auf Seite 73.)
●
Aktivieren Sie den FIPS-Modus. (Siehe „Aktivieren des FIPS-Modus“ auf Seite 74.)
●
Aktivieren Sie digitale HTML-Signaturen. (Siehe „Konfigurieren von Einstellungen für eine digitale
HTML-Signatur“ auf Seite 74.)
●
Konfigurieren Sie Connector for EMC Documentum, Connector for IBM Content Manager oder
Connector for IBM FileNet. (Sieh „Konfigurieren des Connector for EMC Documentum-Dienstes“
auf Seite 75, „Konfigurieren des Connector for IBM FileNet-Dienstes“ auf Seite 80 oder „Konfigurieren
von LiveCycle ES Connector for IBM Content Manager“ auf Seite 88.)
●
Legen Sie Umgebungsvariablen für PDF Generator ES fest. (Siehe „Festlegen
von Umgebungsvariablen“ auf Seite 63.)
●
Deinstallieren Sie LiveCycle ES. (Siehe „Deinstallieren von LiveCycle ES“ auf Seite 93.)
4
Manuelles Konfigurieren von WebSphere
In diesem Kapitel wird die manuelle Konfiguration des Anwendungsservers für die Vorbereitung der
manuellen Bereitstellung von LiveCycle ES in einer Umgebung ohne Cluster beschrieben. Informationen
zur automatischen Konfiguration des Anwendungsservers finden Sie unter „Konfigurieren von und
Bereitstellen von LiveCycle ES“ auf Seite 23.
An dieser Stelle im Installationsprozess haben Sie bereits LiveCycle ES-Dateien installiert und führen
LiveCycle Configuration Manager zum Konfigurieren der bereitstellbaren LiveCycle ES-Archive aus.
Sie können nun die Datenbankverbindung mit dem Anwendungsserver manuell konfigurieren.
Wenn LiveCycle ES auf dem Anwendungsserver bereitgestellt wird, können Sie mit LiveCycle
Configuration Manager sowohl LiveCycle ES als auch LiveCycle ES Business Activity Monitoring
(falls zutreffend) initialisieren.
In diesem Kapitel werden die folgenden Themen behandelt:
●
„Festlegen von Verzeichnisberechtigungen“ auf Seite 30
●
„Konfigurieren der JVM-Argumente“ auf Seite 31
●
„Aktualisieren von „ejbdeploy.sh“ für UNIX/Linux“ auf Seite 32
●
„Konfigurieren von WebSphere-Zeitlimiteinstellungen“ auf Seite 32
●
„Konfigurieren der J2C-Authentifizierung für JMS“ auf Seite 51
●
„Konfigurieren der Einschränkung für LiveCycle PDF Generator ES“ auf Seite 34
●
„Konfigurieren der Verbindung zur LiveCycle ES-Datenbank“ auf Seite 34
●
„Konfigurieren von JMS-Ressourcen für WebSphere“ auf Seite 45
●
„Nächster Schritt“ auf Seite 54
Festlegen von Verzeichnisberechtigungen
LiveCycle ES muss Dateien in das Verzeichnis „[WAS_HOME]/installedApps“ (d. h. „/usr/IBM/WebSphere/
AppServer“) extrahieren. Sie müssen sicherstellen, dass eine Schreibberechtigung für dieses Verzeichnis
erteilt wurde. Andernfalls erfahren Sie im folgenden Abschnitt, wie Sie den Speicherort der extrahierten
Dateien ändern.
➤ So ändern Sie den Speicherort der extrahierten Dateien:
1. Melden Sie sich bei WebSphere Administrative Console an und klicken Sie in der Navigationsstruktur
auf Server > Anwendungsserver.
2. Klicken Sie im rechten Fenster auf den Namen des Servers (z. B. server1).
3. Wählen Sie unter Server Infrastructure den Befehl Java and Process Management > Process
Definition aus.
4. Klicken Sie unter Additional Properties auf Java Virtual Machine und klicken Sie im nächsten
Bildschirm auf Custom Properties.
30
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der JVM-Argumente
5. Klicken Sie auf New und erstellten Sie eine benutzerdefinierte Eigenschaft namens
adobeidp.RootDirectory.
6. Legen Sie als Wert für die gerade erstellte Eigenschaft den Pfad fest, in den native
Adobe-Dateien extrahiert werden sollen. Stellen Sie die Eigenschaft beispielsweise auf
„[WAS_HOME]/profiles/[server]/installedApps“ ein. Sie können auch die Beschreibung ändern.
Konfigurieren der JVM-Argumente
Sie müssen die JVM-Argumente und benutzerdefinierte Eigenschaften konfigurieren.
Vorsicht: Bei der Installation in einer reinen WebSphere Application Server-IPv6-Umgebung (d. h. ohne
jegliche IPv4-Adressen) müssen Sie die LiveCycle ES-EAR-Dateien manuell konfigurieren und
bereitstellen. Folgende Aufgaben sind erforderlich:
●
Ausführen von LiveCycle Configuration Manager zum Konfigurieren von LiveCycle ES
●
Manuelles Konfigurieren von WebSphere
●
Manuelles Bereitstellen der LiveCycle ES-EAR-Dateien
Im Anschluss an die Ausführung dieser Aufgaben führen Sie die folgenden Aufgaben mit
LiveCycle Configuration Manager durch:
●
Initialisieren der LiveCycle ES-Datenbank
●
Bereitstellen von LiveCycle ES-Komponenten
●
Überprüfen der Bereitstellung von LiveCycle ES-Komponenten
➤ So konfigurieren Sie die JVM-Argumente:
1. Klicken Sie in der Navigationsstruktur der WebSphere-Verwaltungskonsole auf Servers >
Application Servers und klicken Sie anschließend im rechten Bereich auf den Servernamen.
2. Wählen Sie unter Server Infrastructure den Befehl Java and Process Management >
Process Definition aus.
3. Klicken Sie unter Additional Properties auf Java Virtual Machine.
4. Geben Sie in das Feld Initial Heap Size den Wert 256 und in das Feld Maximum Heap Size den
Wert 1024 ein.
Hinweis: Dieser Wert ist von der Hardwarekonfiguration sowie dem verfügbaren Arbeitsspeicher
abhängig. Der Wert Null (0) könnte empfehlenswert sein, da dadurch kein Maximum
festgelegt wird. Der Wert Null bedeutet nicht, dass der Heap unendlich groß wird,
da der Parameter für die anfängliche Heapgröße sicherstellt, dass das Löschprogramm,
der so genannte Garbage Collector, periodisch ausgeführt wird, um das Heapwachstum
einzuschränken. Wenn Sie einen x86/64-Bit-Server verwenden, können Sie „Maximum
Heap Size“ auf 1792 einstellen.
5. Geben Sie in das Feld Generic JVM arguments den Wert -Dfile.encoding=utf8 ein.
6. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to the Master Configuration.
7. Klicken Sie im rechten Bereich unter Additional Properties auf Custom Properties und
dann auf New.
31
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Aktualisieren von „ejbdeploy.sh“ für UNIX/Linux
32
8. Geben Sie in das Feld Name für IPv4 den Eintrag java.net.preferIPv4Stack bzw. für IPv6
java.net.preferIPv6Stack und in das Feld Value den Eintrag true ein.
9. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Aktualisieren von „ejbdeploy.sh“ für UNIX/Linux
Für alle UNIX-Plattformen müssen Sie MaxPermSize und die Heap-Größe im Skript für „ejbdeploy.sh“
erhöhen. Bearbeiten Sie die Datei „[Anwendungsserver-Stammverzeichnis]/deploytool/itp/ejbdeploy.sh“
wie folgt:
1. Ändern Sie im Abschnitt „Sun OS“ den Eintrag EJBDEPLOY_JVM_OPTIONS wie folgt:
EJBDEPLOY_JVM_OPTIONS=”-XX:PermSize=256m –Xverify:none”;;
2. Ändern Sie im Abschnitt „$JAVA_CMD \“ die Zeile -Xms256m -Xmx256m wie folgt:
-Xms256m –Xmx1024m \
Konfigurieren von WebSphere-Zeitlimiteinstellungen
Das Erstellen einer großen Anzahl von Benutzern kann über einen einzelnen Aufruf der
CreateLocalUsers-API erfolgen. Die API speichert alle neuen Benutzer persistent oder setzt bei
einem Fehler alle Änderungen zurück. Deshalb muss die API in einer einzelnen Transaktion ausgeführt
werden, um ein Rückgängigmachen zu unterstützen. Da die Gültigkeitsdauer einer Transaktion von der
Anwendungsservereinstellung begrenzt wird (in der Regel 30 Sekunden), ist die Anzahl der Einfügungen
eingeschränkt, die in einem bestimmten Zeitrahmen erfolgen kann. Deshalb schlagen Masseneinfüge-APIs
wie CreateLocalUser fehl, wenn die Anzahl der Benutzer einen bestimmten Grenzwert überschreitet.
Dieser Grenzwert wird wiederum von der Gültigkeitsdauer der Transaktion bestimmt.
Sie müssen die folgenden Zeitlimiteinstellungen ändern:
●
Wert des Transaktionszeitlimits
●
Wert des CORBA-Transaktionszeitlimits
●
Wert des Transaktionszeitlimits für SOAP-Anforderungen
Hinweis: Wenn Sie LiveCycle PDF Generator ES installieren, müssen Sie auch „Nächster Schritt“
auf Seite 54 ausführen.
➤ So konfigurieren Sie das Transaktionszeitlimit:
1. Klicken Sie in der Navigationsstruktur der WebSphere-Verwaltungskonsole auf Servers >
Application servers und klicken Sie anschließend im rechten Bereich auf den Servernamen.
2. Klicken Sie unter Container Settings auf Container Services > Transaction Service.
3. Geben Sie unter General Properties in das Feld Total transaction lifetime timeout den Wert 300
(oder höher) ein.
4. Stellen Sie sicher, dass der Wert im Feld Maximum transaction timeout größer gleich dem Wert für
Total transaction lifetime timeout ist.
5. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von WebSphere-Zeitlimiteinstellungen
33
➤ So erhöhen Sie das CORBA-Zeitlimit:
1. Klicken Sie in der Navigationsstruktur auf Servers > Application servers und klicken Sie anschließend
im rechten Bereich auf den Servernamen.
2. Klicken Sie unter Container Settings auf Container Services > ORB Service.
3. Geben Sie unter General Properties in das Feld Request Timeout den Wert 360 und in das Feld
Locate Request Timeout den Wert 300 ein.
4. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erhöhen Sie den Zeitlimitwert für SOAP-Anforderungen:
1. Wechseln Sie zu Ihrem [Anwendungsserver-Stammverzeichnis] und suchen Sie alle Dateien namens
„soap.client.props“. Es kann mehrere Dateien mit diesem Namen geben. Es müssen beispielsweise
folgende Dateien geändert werden:
●
[Anwendungsserver-Stammverzeichnis]/profileTemplates/default/documents/properties/
soap.client.props
●
[Anwendungsserver-Stammverzeichnis]/profileTemplates/cell/default/documents/properties/
soap.client.props
●
[Anwendungsserver-Stammverzeichnis]/cip/profileTemplates/minimal/documents/properties/
soap.client.props
●
[Anwendungsserver-Stammverzeichnis]/profiles/AppSrv01/properties/soap.client.props
2. Wiederholen Sie Schritt 3 für jede der Dateien.
3. Öffnen Sie die Datei in einem Texteditor, suchen Sie die Eigenschaft com.ibm.SOAP.requestTimeout,
ändern Sie den Wert von 180 in 1800 und speichern Sie die Datei.
4. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Servers“ >
„Application Servers“ und klicken Sie anschließend im rechten Bereich auf den Servernamen.
5. Klicken Sie unter „Server Infrastructure“ auf Administration > Administration Services.
6. Klicken Sie unter „Additional Properties“ auf JMX connectors und klicken Sie dann in der Liste auf
SOAPConnector.
7. Klicken Sie im nächsten Bildschirm auf Custom Properties und dann in der Liste auf requestTimeout.
8. Ändern Sie unter „General Properties“ im Feld „Value“ den Wert von 600 in 1800.
9. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der Einschränkung für LiveCycle PDF Generator ES
34
Konfigurieren der Einschränkung für LiveCycle PDF Generator ES
Für PDF Generator ES muss eine Einschränkungskonfiguration zur Konfiguration des Anwendungsservers
hinzugefügt werden.
➤ So legen Sie die PDF Generator ES-Einschränkungskonfiguration fest:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Servers“ >
„Application Servers“ und klicken Sie anschließend im rechten Bereich auf den Servernamen.
2. Klicken Sie unter Server Infrastructure auf Java and Process Management > Process Definition.
3. Klicken Sie unter Additional Properties auf Java Virtual Machine und klicken Sie im nächsten
Bildschirm auf Custom Properties.
4. Klicken Sie auf New und geben Sie in die folgenden Felder die entsprechenden Einträge ein, um eine
neue Eigenschaft zu erstellen:
Name: com.ibm.websphere.ejbcontainer.poolSize
Wert: LiveCycle8#adobe-pdfg-bmc-invoker-ejb.jar#NativeToPDFInvoker=1,1:
LiveCycle8#adobe-pdfg-bmc-invoker-ejb.jar#OpenOfficeToPDFInvoker=1,1:
LiveCycle8#adobe-pdfg-bmc-invoker-ejb.jar#ImageToPDFInvoker=3,3:
LiveCycle8#adobe-pdfg-bmc-invoker-ejb.jar#PSToPDFInvoker=3,3
Hinweis: Sie müssen den Wert manuell eingeben. Sie können den Wert nicht aus diesem Dokument
kopieren und einfügen.
In diesem Beispiel ist LiveCycle8 der Name der LiveCycle ES 8.0-Core-Anwendung, wie sie in der
Verwaltungskonsole von WebSphere Application Server angezeigt wird. Lautet dieser Name anders,
müssen alle vier Vorkommen der Zeichenfolge LiveCycle8 im Parameter „Value“ durch den
tatsächlichen Anwendungsnamen ersetzt werden.
Beschreibung: Einschränkungskonfiguration für Adobe PDF Generator
5. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Konfigurieren der Verbindung zur LiveCycle ES-Datenbank
Damit WebSphere und Ihre LiveCycle ES-Bereitstellung eine Verbindung zur LiveCycle ES-Datenbank
herstellen können, erstellen Sie eine Datenbankverbindung für LiveCycle ES, indem Sie die Datenbanktreiber
installieren und anschließend eine Datenquelle einrichten.
Installieren Sie die Treiber für den jeweiligen Datenbanktyp, den Sie für die LiveCycle ES-Datenbank
verwenden. Sie mussen die Treiber in den Installationsverzeichnissen des Anwendungsservers ablegen.
Konfigurieren Sie die Datenquelle zum Herstellen einer Verbindung mit der Datenbank. Für WebSphere
können Sie eine DB2-, Oracle 10g-, MySQL oder SQL Server 2005-Datenquelle konfigurieren.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der J2C-Authentifizierung für die Datenquelle
35
Sie benötigen die folgenden Informationen aus Aufgaben, die Sie im Dokument Vorbereiten der
Installation von LiveCycle ES ausgeführt haben:
●
Datenbankname
●
Servername
●
Benutzername
●
Kennwort
Konfigurieren der J2C-Authentifizierung für die Datenquelle
Sie müssen die J2C-Authentifizierung für Ihre Datenquelle konfigurieren, bevor Sie die Datenquelle
konfigurieren.
➤ So erstellen Sie eine J2C-Authentifizierungskonfiguration für die Datenquelle:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Security“ >
„Secure administration, applications, and infrastructure“.
2. Klicken Sie im rechten Bereich unter „Authentication“ auf „Java Authentication and Authorization
Service“ > „J2C authentication data“ und dann auf „New“.
3. Geben Sie in die folgenden Felder die benötigten Informationen ein:
Alias: Geben Sie einen dem Datenbankbenutzer entsprechenden Namen ein
(z. B. IDP_DS/db2-db2user).
Benutzer-ID: Geben Sie eine Benutzer-ID ein. Diese ID ist die Anmeldeinformation für den Zugriff
auf die Datenbank, die mit der IDP_DS-Datenquelle verwendet wird (Beispiel: db2user).
Kennwort: Geben Sie ein Kennwort für diesen Benutzer ein.
4. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Konfigurieren der DB2-Datenquelle
Zum Konfigurieren der DB2-Datenquelle müssen Sie die DB2-Datenbanktreiber installieren, einen
DB2 JDBC-Provider für WebSphere erstellen, die Datenquelle für WebSphere anlegen und anschließend
den entsprechenden Verbindungspool konfigurieren.
Hinweis: Dieses Verfahrensweisen gelten für DB2 8.2 und DB2 9.1.
➤ So installieren Sie den DB2-Datenbanktreiber:
1. Erstellen Sie im Verzeichnis [Anwendungsserver-Stammverzeichnis] ein Verzeichnis namens „db2libs“.
2. Kopieren Sie die Dateien „db2jcc.jar“ und „db2jcc_license_cu.jar“ aus einem dieser Speicherorte in das
Verzeichnis „[Anwendungsserver-Stammverzeichnis]/db2libs“:
●
Das Java-Verzeichnis unter „[Datenbankserver-Stammverzeichnis],
z. B. „[Datenbankserver-Stammverzeichnis]/ibm/Sqllib/java“ (Windows)
oder „[Datenbankserver-Stammverzeichnis]/java“ (Linux oder UNIX).
●
(nur DB 8.2) [LiveCycle ES-Stammverzeichnis]\lib\db\db2
●
(nur DB 9.1) [LiveCycle ES-Stammverzeichnis]\lib\db\db2\9.1
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der DB2-Datenquelle
36
➤ So erstellen Sie einen DB2 JDBC-Provider:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf
„Environment“ > „Websphere Variables“ und klicken Sie anschließend im rechten Bereich
auf „DB2UNIVERSAL_JDBC_DRIVER_PATH“.
2. Geben Sie in das Feld Value den Pfad zum Verzeichnis db2libs ein.
3. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
4. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers.
5. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
6. Legen Sie im Bereich von Schritt 1 die folgende Konfiguration fest:
●
Wählen Sie in der Liste Database Type den Eintrag DB2 aus.
●
Wählen Sie in der Liste Provider Type den Eintrag DB2 Universal JDBC Driver Provider aus.
●
Wählen Sie in der Liste Implementation Type den Eintrag Connection pool data source aus.
Beachten Sie, dass für jedes LiveCycle Configuration Manager-Konfigurationsskript der Name der
Feldimplementierungsklasse com.ibm.db2.jcc.DB2ConnectionPoolDataSource lautet.
●
Behalten Sie im Feld Name den Standardwert bei, der DB2 Universal JDBC Driver Provider lautet,
oder geben Sie LiveCycle - db2 - IDP_DS ein.
7. Klicken Sie auf Next und dann im Bereich von Schritt 2 erneut auf Next.
8. Klicken Sie im Fenster von Schritt 3 auf Finish und anschließend auf Save directly to master
configuration.
➤ So erstellen Sie die DB2 JDBC-Datenquelle:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend
im rechten Bereich auf den unter „So erstellen Sie einen DB2 JDBC-Provider:“ auf Seite 36 erstellten
Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf New.
3. Legen Sie im Bereich von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
●
Geben Sie in die Felder Data source name und JNDI name die Bezeichnung IDP_DS ein.
●
Wählen Sie in der Liste unter „Component-Managed Authentication“ und
„XA Recovery Authentication“ den für diese Datenquelle unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus und klicken Sie dann auf Next.
4. Geben Sie im Fenster von Schritt 2 den Datenbanknamen und den Servernamen der unter
„So erstellen Sie eine J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35
erstellten Datenbank ein.
5. Stellen Sie sicher, dass Use this data source in container managed persistence (CMP) ausgewählt ist
und klicken Sie auf Next.
6. Klicken Sie im Bereich von Schritt 3 auf Finish.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der DB2-Datenquelle
37
7. Klicken Sie im rechten Bereich auf die soeben erstellte Datenquelle, um zusätzliche Parameter zu
ändern und die folgenden Konfiguration festzulegen:
●
Wählen Sie in der Liste Container-managed authentication alias den unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
●
Wählen Sie in der Liste Mapping-configuration alias den Eintrag DefaultPrincipalMapping aus.
8. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
9. Wählen Sie die zuvor erstellte Datenquelle aus und klicken Sie auf „Test Connection“, um sicherzustellen,
dass die Verbindung zur Datenquelle korrekt funktioniert.
➤ So konfigurieren Sie IDP_DS-Verbindungspools:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC und anschließend im rechten Bereich auf
den zuvor erstellten JDBC-Provider (entweder DB2 Universal JDBC Driver Provider oder LiveCycle db2 - IDP_DS) gemäß dem Beispiel unter „So erstellen Sie einen DB2 JDBC-Provider:“ auf Seite 36.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf IDP_DS.
3. Klicken Sie im nächsten Bildschirm unter „Additional Properties“ auf Connection Pool Properties und
richten Sie die Eigenschaften wie folgt ein:
●
Geben Sie in das Feld Maximum connections den Wert 30 (oder höher falls erforderlich) ein.
●
Geben Sie in das Feld Minimum connections den Wert 1 ein.
4. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie die DB2 JDBC-Datenquelle für LiveCycle Rights Management ES:
Hinweis: Dieses Verfahren ist nur erforderlich, wenn Rights Management ES installiert ist.
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC und anschließend auf den von Ihnen
unter „So erstellen Sie einen DB2 JDBC-Provider:“ auf Seite 36 erstellten Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf New.
3. Legen Sie im Bereich von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
●
Geben Sie in das Feld Data source name die Bezeichnung RM_DS ein.
●
Geben Sie in das Feld JNDI Name die Bezeichnung EDC_DS ein.
●
Wählen Sie in der Liste unter „Component-Managed Authentication“ und
„XA Recovery Authentication Alias“ den für diese Datenquelle unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus und klicken Sie dann auf Next.
4. Geben Sie im Fenster von Schritt 2 den Datenbanknamen und den Servernamen der unter
„So erstellen Sie eine J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35
erstellten Datenbank ein.
5. Stellen Sie sicher, dass Use this data source in container managed persistence (CMP) ausgewählt ist
und klicken Sie auf Next.
6. Klicken Sie im Bereich von Schritt 3 auf Finish.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der Oracle-Datenquelle
38
7. Wählen Sie die soeben erstellte Datenquelle aus, um zusätzliche Parameter zu ändern und die
folgenden Konfiguration festzulegen:
●
Wählen Sie in der Liste Container-managed authentication alias den unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
●
Wählen Sie in der Liste Mapping-configuration alias den Eintrag DefaultPrincipalMapping aus.
8. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
9. Wählen Sie die zuvor erstellte Datenquelle aus und klicken Sie auf „Test Connection“, um sicherzustellen,
dass die Verbindung zur Datenquelle korrekt funktioniert.
➤ So konfigurieren Sie die RM_DS-Verbindungspools für LiveCycle Rights Management ES:
Hinweis: Dieses Verfahren ist nur erforderlich, wenn Rights Management ES installiert ist.
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf den zuvor erstellten JDBC-Provider DB2 Universal JDBC Driver Provider for RM.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf RM_DS.
3. Klicken Sie im nächsten Bildschirm unter „Additional Properties“ auf Connection Pool Properties und
richten Sie die Eigenschaften wie folgt ein:
●
Geben Sie in das Feld Maximum connections den Wert 20 (oder höher falls erforderlich) ein.
●
Geben Sie in das Feld Minimum connections den Wert 1 ein.
4. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Ihre Datenquelle wurde jetzt erstellt und Sie können mit „Konfigurieren von JMS-Ressourcen
für WebSphere“ auf Seite 45 fortfahren.
Konfigurieren der Oracle-Datenquelle
Zum Konfigurieren der Oracle-Datenquelle müssen Sie die Oracle-Datenbanktreiber installieren, einen
Oracle JDBC-Provider für WebSphere erstellen, die Datenquelle für WebSphere anlegen und anschließend
den entsprechenden Verbindungspool konfigurieren.
➤ So installieren Sie den Oracle 10g-Datenbanktreiber:
1. Laden Sie den Oracle 10g-Treiber, Version 2 (10.2.0.2 Thin) von Oracle Technical Network herunter.
2. Erstellen Sie im Verzeichnis [Anwendungsserver-Stammverzeichnis] ein Verzeichnis mit dem Namen
db_driver und kopieren Sie die heruntergeladene Datei ojdbc14.jar in dieses neue Verzeichnis.
➤ So erstellen Sie den Oracle JDBC-Provider:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf
„Environment“ > „Websphere Variables“ und klicken Sie anschließend im rechten Bereich
auf „ORACLE_JDBC_DRIVER_PATH“.
2. Geben Sie unter „General Properties“ in das Feld Value den Pfad zu der Datei „ojdbc14.jar“ ein,
die Sie unter „So installieren Sie den Oracle 10g-Datenbanktreiber:“ auf Seite 38 erstellt haben.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der Oracle-Datenquelle
39
3. Klicken Sie auf OK und dann auf Save directly to Master Configuration.
4. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers.
5. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
6. Legen Sie im Bereich von Schritt 1 die folgende Konfiguration fest:
●
Wählen Sie in der Liste Database Type den Eintrag Oracle aus.
●
Wählen Sie in der Liste Provider Type den Eintrag Oracle JDBC Driver aus.
●
Wählen Sie in der Liste Implementation Type den Eintrag Connection pool data source aus.
●
Akzeptieren oder ändern Sie den Standardinhalt des Textfelds Name.
7. Klicken Sie auf Next, übernehmen Sie im Bereich von Schritt 2 den standardmäßigen
Datenbankklassenpfad und klicken Sie erneut auf Next.
8. Klicken Sie im Fenster von Schritt 3 auf Finish und anschließend auf Save directly to master
configuration.
➤ So erstellen Sie die Oracle JDBC-Datenquelle:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf den unter „So installieren Sie den Oracle 10g-Datenbanktreiber:“ auf Seite 38
erstellten Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf New.
3. Legen Sie im Bereich von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
●
Geben Sie in die Felder Data source name und JNDI name die Bezeichnung IDP_DS ein.
●
Wählen Sie in der Liste unter „Component-Managed Authentication“ und
„XA Recovery Authentication“ den für diese Datenquelle unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
4. Geben Sie im Bildschirm von Schritt 2 die folgende Zeile in das Feld URL ein:
jdbc:oracle:thin:@[Serverhost]:[Anschluss]:[SID]
wobei [Serverhost] die IP-Adresse des Datenbankservers, Anschluss der Anschluss, an dem die
Datenbank empfangsbereit ist (Standard „1521“), und SID die Dienst-ID der Datenbank ist.
5. Klicken Sie auf „Next“ und dann im Bereich von Schritt 3 erneut auf „Finish“.
6. Klicken Sie auf Save directly to master configuration.
7. Wählen Sie die soeben erstellte Datenquelle aus, um zusätzliche Parameter zu ändern und die
folgenden Konfiguration festzulegen:
●
Wählen Sie in der Liste Container-managed authentication alias den unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
●
Wählen Sie in der Liste Mapping-configuration alias den Eintrag DefaultPrincipalMapping aus.
8. Klicken Sie auf OK oder Apply und dann auf Save directly to Master Configuration.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der Oracle-Datenquelle
40
➤ So konfigurieren Sie IDP_DS-Verbindungspools:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf die zuvor erstellte Datenquelle Oracle JDBC Driver.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf IDP_DS.
3. Klicken Sie im nächsten Bildschirm unter Additional Properties auf Connection Pool Properties und
geben Sie in das Feld Maximum Connections den Wert 30 ein.
4. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie die Oracle JDBC-Datenquelle für LiveCycle Rights Management ES:
Hinweis: Dieses Verfahren ist nur erforderlich, wenn Rights Management ES installiert ist.
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf den unter „So installieren Sie den Oracle 10g-Datenbanktreiber:“ auf Seite 38
erstellten Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf New.
3. Legen Sie im Bereich von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
●
Geben Sie in das Feld Data source name die Bezeichnung RM_DS ein.
●
Geben Sie in das Feld JNDI Name die Bezeichnung EDC_DS ein.
●
Wählen Sie in der Liste unter „Component-Managed Authentication“ und
„XA Recovery Authentication“ den für diese Datenquelle unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
4. Geben Sie im Bildschirm von Schritt 2 die folgende Zeile in das Feld URL ein:
jdbc:oracle:thin:@[Serverhost]:[Anschluss]:[SID]
wobei [Serverhost] die IP-Adresse des Datenbankservers, Anschluss der Anschluss, an dem die
Datenbank empfangsbereit ist (Standard „1521“), und SID die Dienst-ID der Datenbank ist.
5. Klicken Sie auf „Next“ und dann im Bereich von Schritt 3 erneut auf „Finish“.
6. Klicken Sie auf Save directly to master configuration.
7. Wählen Sie die soeben erstellte Datenquelle (RM_DS) aus, um zusätzliche Parameter zu ändern und die
folgenden Konfiguration festzulegen:
●
Wählen Sie in der Liste Container-managed authentication alias den unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
●
Wählen Sie in der Liste Mapping-configuration alias den Eintrag DefaultPrincipalMapping aus.
8. Klicken Sie auf OK und dann auf Save directly to Master Configuration.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der SQL Server-Datenquelle
41
➤ So konfigurieren Sie die RM_DS-Verbindungspools für LiveCycle Rights Management ES:
Hinweis: Dieses Verfahren ist nur erforderlich, wenn Rights Management ES installiert ist.
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf die zuvor erstellte Datenquelle Oracle JDBC Driver.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf RM_DS.
3. Klicken Sie im nächsten Bildschirm unter Additional Properties auf Connection Pool Properties und
geben Sie in das Feld Maximum Connections den Wert 20 ein.
4. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Ihre Datenquelle wurde jetzt erstellt und Sie können mit „Konfigurieren von JMS-Ressourcen
für WebSphere“ auf Seite 45 fortfahren.
Konfigurieren der SQL Server-Datenquelle
Zum Konfigurieren der SQL Server-Datenquelle müssen Sie die SQL Server-Datenbanktreiber installieren,
einen SQL Server JDBC-Provider für WebSphere erstellen, die Datenquelle für WebSphere anlegen und
anschließend den entsprechenden Verbindungspool konfigurieren.
➤ So installieren Sie den SQL Server-Datenbanktreiber:
●
Laden Sie den JDBC-Treiber 1.1 für SQL Server 2005 unter folgender Adresse vom
Microsoft-Downloadcenter herunter (falls Sie dies nicht bereits getan haben),
indem Sie die Websiteanleitungen befolgen.
Hinweis: Notieren Sie sich das Verzeichnis, in das Sie den Treiber auf Ihrem System installieren.
➤ So erstellen Sie den SQL Server 2005 JDBC-Provider:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Environment“ >
„Websphere Variables“ und klicken Sie anschließend im rechten Bereich auf
„MSSQLSERVER_JDBC_DRIVER_PATH“.
2. Geben Sie unter General Properties in das Feld Value den Pfad zu der Datei „sqljdbc.jar“ ein,
den Sie unter „So installieren Sie den SQL Server-Datenbanktreiber:“ auf Seite 41 erstellt haben,
und klicken Sie auf OK.
3. Klicken Sie auf im Feld „Messages“ auf „Save directly to master configuration“.
4. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers.
5. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
6. Legen Sie im Bereich von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
●
Wählen Sie in der Liste Database Type den Eintrag User-defined aus.
●
Geben Sie in das Feld Implementation class name den Wert
com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource ein.
●
Geben Sie in das Feld Name die Bezeichnung User-defined JDBC Provider ein
(Standardeinstellung).
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der SQL Server-Datenquelle
42
7. Legen Sie im Bereich von Schritt 2 die Klassenpfadkonfiguration wie folgt fest und klicken Sie auf Next:
${MSSQLSERVER_JDBC_DRIVER_PATH}/sqljdbc.jar
8. Klicken Sie im Fenster von Schritt 3 auf Finish und anschließend auf Save directly to master
configuration.
➤ So erstellen Sie die SQL Server 2005-Datenquelle:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf den unter „So erstellen Sie den SQL Server 2005 JDBC-Provider:“ auf Seite 41
erstellten Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf New.
3. Legen Sie im Bereich von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
●
Geben Sie in die Felder Data source name und JNDI name die Bezeichnung IDP_DS ein.
●
Wählen Sie in der Liste unter „Component-Managed Authentication“ und
„XA Recovery Authentication Alias“ den für diese Datenquelle unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
4. Übernehmen Sie im Bereich von Schritt 2 die standardmäßig Datasource Helper Class und klicken Sie
auf Next.
5. Klicken Sie im Fenster von Schritt 3 auf Finish und anschließend auf Save directly to master
configuration.
6. Wählen Sie die zuvor erstellte Datenquelle aus, um zusätzliche Parameter zu ändern.
7. Legen Sie die folgende Konfiguration fest:
●
Wählen Sie in der Liste Container-managed authentication alias den unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
●
Wählen Sie in der Liste Mapping-configuration alias den Eintrag DefaultPrincipalMapping aus.
8. Klicken Sie auf OK und dann auf Save directly to Master Configuration.
➤ So konfigurieren Sie IDP_DS-Verbindungspools:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf User-defined JDBC Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf IDP_DS.
3. Klicken Sie im nächsten Bildschirm unter Additional Properties auf Custom Properties und
dann auf New.
4. Klicken Sie für jede unten aufgeführte Eigenschaft auf New, geben Sie dann den angegebenen Name
und Value der Eigenschaft ein, und klicken Sie schließlich auf OK oder Apply:
serverName: Die IP-Adresse der SQL Server-Datenbank
portNumber: Die Anschlussnummer der SQL Server-Datenbank
databaseName: Der Name der SQL Server-Datenbank
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der SQL Server-Datenquelle
43
5. Klicken Sie auf Save directly to master configuration.
6. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf User-defined JDBC Provider.
7. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf IDP_DS.
8. Klicken Sie im nächsten Bildschirm unter Additional Properties auf Connection Pool Properties und
geben Sie in das Feld Maximum Connections den Wert 30 ein.
9. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie die SQL Server 2005-Datenquelle für LiveCycle Rights Management ES:
Hinweis: Dieses Verfahren ist nur erforderlich, wenn Rights Management ES installiert ist.
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf den unter „So erstellen Sie den SQL Server 2005 JDBC-Provider:“ auf Seite 41
erstellten Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf New.
3. Legen Sie im Bereich von Schritt 1 die folgenden Konfiguration fest und klicken Sie auf Next:
●
Geben Sie in das Feld Data source name die Bezeichnung RM_DS ein.
●
Geben Sie in das Feld JNDI Name die Bezeichnung EDC_DS ein.
●
Wählen Sie in der Liste unter „Component-Managed Authentication“ und
„XA Recovery Authentication Alias“ den für diese Datenquelle unter „So erstellen Sie eine
J2C-Authentifizierungskonfiguration für die Datenquelle:“ auf Seite 35 erstellten
Authentifizierungsalias aus.
4. Übernehmen Sie im Bereich von Schritt 2 die standardmäßig Datasource Helper Class und klicken Sie
auf Next.
5. Klicken Sie im Fenster von Schritt 3 auf Finish und anschließend auf Save directly to master
configuration.
➤ So konfigurieren Sie die IDP_DS-Verbindungspools für LiveCycle Rights Management ES:
Hinweis: Dieses Verfahren ist nur erforderlich, wenn Rights Management ES installiert ist.
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf User-defined JDBC Provider.
2. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf RM_DS.
3. Klicken Sie im nächsten Bildschirm unter Additional Properties auf Custom Properties und
dann auf New.
4. Klicken Sie für jede unten aufgeführte Eigenschaft auf New, geben Sie dann den angegebenen Name
und Value der Eigenschaft ein und klicken Sie schließlich auf OK oder Apply:
serverName: Die IP-Adresse der SQL Server-Datenbank
portNumber: Die Anschlussnummer der SQL Server-Datenbank
databaseName: Der Name der SQL Server-Datenbank
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Manuelles Konfigurieren von WebSphere
Konfigurieren der SQL Server-Datenquelle
44
5. Klicken Sie auf Save directly to master configuration.
6. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > JDBC Providers und anschließend im
rechten Bereich auf User-defined JDBC Provider.
7. Klicken Sie unter Additional Properties auf Data sources und klicken Sie dann auf RM_DS.
8. Klicken Sie im nächsten Bildschirm unter Additional Properties auf Connection Pool Properties und
geben Sie in das Feld Maximum Connections den Wert 20 ein.
9. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So ordnen Sie die Windows-Anmeldung dem LiveCycle ES-Datenbankbenutzer zu:
Hinweis: Es muss bereits ein Benutzerkonto erstellt und Ihrer Windows-Domäne zugeordnet worden sein.
1. Verbinden Sie sich in Microsoft SQL Server Management Studio mit dem Datenbankserver,
auf dem sich die LiveCycle ES-Datenbank befindet.
2. Legen Sie den Authentifizierungsmodus auf Windows-Authentifizierung fest.
3. Erstellen Sie unter „Sicherheit“ > „Anmeldungen“ ein neues Konto für den
Windows-Domänenbenutzer und wählen Sie Windows-Authentifizierung.
4. Klicken Sie im Bildschirm „Anmeldung - Neu“ auf Benutzerzuordnung und legen Sie die Datenbank
und das Standardschema für den neuen Benutzer fest.
5. Wählen Sie db_owner als Datenbankrolle aus und klicken Sie auf OK.
Zum Überprüfen, dass der Benutzer erstellt wurde, erweitern Sie die LiveCycle ES-Datenbank in der
Navigationsstruktur und öffnen „Sicherheit“ > „Benutzer“. Der neue Benutzer wird dort aufgeführt.
➤ So konfigurieren Sie die integrierte Sicherheit unter Windows, um eine vertrauenswürdige
Verbindung mit SQL Server herzustellen:
1. Starten Sie den Anwendungsserver unter Verwendung des Windows-Domänenbenutzers. Wird
WebSphere Application Server als Dienst ausgeführt, sollte dieser unter Verwendung des
Benutzerkontos des Windows-Domänenbenutzers gestartet werden.
2. Starten Sie die WebSphere Administrative Console, indem Sie in das Adressfeld eines Webbrowsers
http://[Hostname]:[Anschluss]/IBM/console eingeben.
3. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > Data Sources und klicken Sie dann im
rechten Bereich auf IDP_DS.
4. Klicken Sie im rechten Bereich unter „Additional Properties“ auf Custom Properties und dann auf New.
5. Geben Sie in das Feld Name die Bezeichnung integratedSecurity ein und in das Feld Value den
Wert true ein.
6. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to the Master Configuration.
7. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > Data Sources und klicken Sie dann im
rechten Bereich auf RM_DS.
8. Klicken Sie im rechten Bereich unter „Additional Properties“ auf Custom Properties und dann auf New.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Manuelles Konfigurieren von WebSphere
Konfigurieren von JMS-Ressourcen für WebSphere
45
9. Geben Sie in das Feld Name die Bezeichnung integratedSecurity ein und in das Feld Value den
Wert true ein.
10. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to the Master Configuration.
11. Öffnen Sie in der Windows-Systemsteuerung über „Verwaltung“ die Option „Dienste“ und stoppen Sie
den IBM WebSphere Application Server V6.1 – <Node> Service.
12. Klicken Sie mit der rechten Maustaste auf den Dienstnamen und klicken Sie dann auf „Eigenschaften“ >
„Anmelden“.
13. Ändern Sie den Standardwert der Eigenschaft „Anmelden als“ von „Lokales Systemkonto“
in das Benutzerkonto des Windows-Domänenbenutzers, das Sie unter „So ordnen Sie die
Windows-Anmeldung dem LiveCycle ES-Datenbankbenutzer zu:“ auf Seite 44 konfiguriert haben.
Starten Sie den Dienst dann neu.
14. Fügen Sie auf dem Computer, auf dem der Anwendungsserver installiert ist, die Datei
„sqljdbc_auth.dll“ dem Windows-Systempfad (C:\Windows) hinzu.
Hinweis: Die Datei „sqljdbc_auth.dll“ befindet sich am selben Speicherort wie die
Microsoft SQL JDBC 1.1-Treiberinstallation (standardmäßig unter
[Installationsverzeichnis]/sqljdbc_1.1/enu/auth/x86).
Ihre Datenquelle wurde jetzt erstellt und Sie können mit „Konfigurieren von JMS-Ressourcen
für WebSphere“ auf Seite 45 fortfahren.
Konfigurieren von JMS-Ressourcen für WebSphere
Sie müssen JMS-Ressourcen (JMS – Java Message Service) für WebSphere konfigurieren.
Vorsicht: Wenn die JMS-Datenquelle von IDP_DS abweicht (z. B. eine gesonderte Datenbank oder
MQSeries), gehen bei der Wiederherstellung nach einem Systemausfall möglicherweise
JMS-Meldungen verloren. Hierzu können Aufträge gehören, die auf ihre Verarbeitung warten,
bzw. Prozesse, die zuvor fehlgeschlagen sind.
➤ So erstellen Sie den IDP_JMS_Bus:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Service
Integration“ > „Buses“ und klicken Sie anschließend im rechten Bereich auf „New“.
2. Geben Sie im Bereich von Schritt 1 IDP_JMS_Bus in das vorgesehene Feld ein.
3. Klicken Sie auf Weiter und dann im folgenden Bildschirm auf Fertig stellen.
4. Klicken Sie auf Save directly to master configuration.
➤ So weisen Sie Busmitglieder zu:
1. Klicken Sie in der Navigationsstruktur auf Service Integration > Buses und klicken Sie anschließend
im rechten Bereich auf IDP_JMS_Bus.
2. Klicken Sie unter Topology auf Bus Members und dann auf Hinzufügen.
3. Stellen Sie im Bereich von Schritt 1 sicher, dass Server ausgewählt ist, und klicken Sie dann auf Next.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von JMS-Ressourcen für WebSphere
46
4. Wählen Sie im Bereich von Schritt 2 Data store aus und klicken Sie auf Next.
5. Wählen Sie im Fenster von Schritt 3 IDP_DS als Datenquelle aus und klicken Sie auf Next.
6. Klicken Sie auf Finish und dann auf Save directly to Master Configuration.
7. Starten Sie den Anwendungsserver neu.
8. (Optional) Überprüfen Sie, ob der Messaging-Bus ordnungsgemäß gestartet wurde, indem Sie zu
„Service Integration“ > „Buses“ wechseln, auf „IDP_JMS_Bus“ klicken und dann unter „Topology“ auf
„Messaging Engines“ klicken. Wenn der Messaging-Bus funktioniert, wird ein grünes Symbol angezeigt.
➤ So konfigurieren Sie JMS-Warteschlangen-Verbindungs-Factorys:
1. Klicken Sie in der Navigationsstruktur auf Resources > JMS > Queue connection factories.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Wählen Sie Default messaging provider aus und klicken Sie auf OK.
4. Geben Sie im Bereich „Administration“ in die Felder Name und JNDI name den Wert
QueueConnectionFactory ein.
5. Wählen im Bereich Connection in der Liste Bus name den Namen IDP_JMS_Bus aus.
6. Wählen Sie im Bereich „Quality of Service“ in den Listen Non persistent message reliability und
Persistent message reliability den Eintrag As bus destination aus.
7. Wählen Sie im Bereich „Advanced Administrative“ den entsprechenden „Component-managed
Authentication Alias“, den Sie zuvor unter „So erstellen Sie eine J2C-Authentifizierungskonfiguration
für die Datenquelle:“ auf Seite 35 definiert haben.
8. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
9. Klicken Sie in der Liste auf QueueConnectionFactory und dann unter Additional Properties auf
Connection Pool Properties.
10. Legen Sie im nächsten Bildschirm unter „General Properties“ die folgenden Eigenschaften fest:
●
Geben Sie in das Feld Maximum connections den Wert 50 ein.
●
Geben Sie in das Feld Minimum connections den Wert 10 ein.
11. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
12. Wiederholen Sie die Schritte 2 bis 11, um eine weitere JMS-Warteschlangen-Verbindungs-Factory
zu erstellen. Ersetzen Sie hierbei in Schritt 4 bei „Name“ und „JNDI name“ die Angabe
QueueConnectionFactory durch JobManagerQueueConnectionFactory.
➤ So konfigurieren Sie JMS-Themen-Verbindungsfactories:
1. Klicken Sie in der Navigationsstruktur auf Resources > JMS > Topic connection factories.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Wählen Sie Default messaging provider aus und klicken Sie auf OK.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von JMS-Ressourcen für WebSphere
47
4. Geben Sie im Bereich „Administration“ in die Felder Name und JNDI name den Wert
TopicConnectionFactory ein.
5. Wählen im Bereich Connection in der Liste Bus name den Namen IDP_JMS_Bus aus.
6. Wählen Sie im Bereich „Quality of Service“ in den Listen Non persistent message reliability und
Persistent message reliability den Eintrag As bus destination aus.
7. Wählen Sie im Bereich „Advanced Administrative“ den entsprechenden „Component-managed
Authentication Alias“, den Sie zuvor unter „So erstellen Sie eine J2C-Authentifizierungskonfiguration
für die Datenquelle:“ auf Seite 35 definiert haben.
8. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
9. Klicken Sie in der Liste auf TopicConnectionFactory und dann unter Additional Properties auf
Connection Pool Properties.
10. Legen Sie im nächsten Bildschirm unter „General Properties“ die folgenden Eigenschaften fest:
●
Geben Sie in das Feld Maximum connections den Wert 50 ein.
●
Geben Sie in das Feld Minimum connections den Wert 10 ein.
11. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie eine Warteschlange:
1. Klicken Sie in der Navigationsstruktur auf Resources > JMS > Queues.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Übernehmen Sie die Standardeinstellung oder wählen Sie Default messaging provider aus und
klicken Sie auf OK.
4. Klicken Sie unter „General Properties“ auf Administration area und legen Sie folgende
Eigenschaften fest:
●
Geben Sie in das Feld Name die Bezeichnung adobe_PECommandQueue ein.
●
Geben Sie in das Feld JNDI name die Bezeichnung queue/adobe_PECommandQueue ein.
5. Legen Sie im Bereich „Connection“ die Eigenschaften wie folgt fest:
●
Wählen Sie in der Liste Bus Name den Eintrag IDP_JMS_Bus aus.
●
Wählen Sie in der Liste Queue name den Eintrag other, please specify aus und geben Sie
adobe_PECommandQueue in das eingeblendete Feld ein.
●
Wählen Sie in der Liste Delivery Mode den Eintrag Persistent aus.
6. Legen Sie im Bereich Advanced in der Liste Read ahead den Eintrag Inherit from connection
factory aus.
7. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
8. Wiederholen Sie die Schritte 2 bis 7 für jede der in der folgenden Tabelle aufgeführten Warteschlangen,
wobei Sie die in Schritt 4 festgelegten Eigenschaften unter der Gruppe „Connection“ durch die
entsprechenden Werte ersetzen.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von JMS-Ressourcen für WebSphere
Name
Delivery Mode
JNDI-Name
adobe_PEDCommandQueue
persistent
queue/adobe_PEDCommandQueue
adobe_PEInteractionQueue
persistent
queue/adobe_PEInteractionQueue
adobe_JobManagerQueue
persistent
queue/adobe_JobManagerQueue
48
Als Nächstes erstellen Sie für jede in „So erstellen Sie eine Warteschlange:“ auf Seite 47 definierte
Warteschlange ein Busziel.
➤ So erstellen Sie ein Busziel:
1. Klicken Sie in der Navigationsstruktur auf Service Integration > Buses und klicken Sie anschließend
im rechten Bereich auf IDP_JMS_Bus.
2. Klicken Sie im nächsten Bildschirm unter „Destination Resources“ auf Destinations und dann auf New.
3. Wählen Sie im nächsten Bildschirm unter Select Destination Type die Option Queue aus und
klicken Sie dann auf Next.
4. Geben Sie im Fenster von Schritt 1 in das Feld Identifier die Bezeichnung adobe_PECommandQueue
ein und klicken Sie auf Next.
5. Klicken Sie auf Next, übernehmen Sie den Standardwert für „Bus member“ und klicken Sie auf Finish.
6. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
7. Wiederholen Sie die Schritte 2 bis 6 für jede unter „So erstellen Sie eine Warteschlange:“ auf Seite 47
definierte Warteschlange.
➤ So erstellen Sie Themen:
1. Klicken Sie in der Navigationsstruktur auf Resources > JMS > Topics.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Übernehmen Sie die Standardeinstellung oder wählen Sie Default messaging provider aus und
klicken Sie auf OK.
4. Legen Sie im Bereich „Administration“ die folgenden Eigenschaften fest:
●
Geben Sie in das Feld Name die Bezeichnung adobe_TaskEventTopic ein.
●
Geben Sie in das Feld JNDI Name die Bezeichnung topic/adobe_TaskEventTopic ein.
5. Legen Sie im Bereich Connection die Eigenschaften wie folgt fest:
●
Geben Sie in das Feld Topic name die Bezeichnung adobe_TaskEventTopic ein.
●
Wählen Sie in der Liste Bus Name den Eintrag IDP_JMS_Bus aus.
●
Wählen Sie in der Liste Topic space den Eintrag Default.Topic.Space aus.
●
Wählen Sie in der Liste JMS Delivery Mode den Eintrag Persistent aus.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zuweisen der JMS-Aktivierungsspezifikation
49
6. Klicken Sie auf „OK“ oder „Apply“ und klicken Sie dann auf „Save directly to Master Configuration“.
7. Wiederholen Sie die Schritte 4 bis 6, um weitere Themen zu erstellen, welche die in der folgenden
Tabelle beschriebenen Eigenschaften Name, JNDI name und Topic name ersetzen.
Name und Themenname
JNDI-Name
adobe_ProcessEventTopic
topic/adobe_ProcessEventTopic
adobe_POFSchemaTopic
topic/adobe_POFSchemaTopic
Zuweisen der JMS-Aktivierungsspezifikation
Sie müssen die JMS-Aktivierungsspezifikation zuweisen.
➤ So erstellen Sie „PECommand_AS“:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Resources“ >
„JMS“ > „Activation specifications“.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Übernehmen Sie die Standardeinstellung oder wählen Sie Default messaging provider aus und
klicken Sie auf OK.
4. Legen Sie im Bereich „Administration“ die folgenden Eigenschaften fest:
●
Geben Sie in das Feld Name die Bezeichnung PECommand_AS ein.
●
Geben Sie in das Feld JNDI Name die Bezeichnung PECommand_AS ein.
5. Legen Sie im Bereich „Destination“ die Eigenschaften wie folgt fest:
●
Wählen Sie in der Liste Destination Type den Eintrag Queue.
●
Geben Sie in das Feld Destination JNDI name die Bezeichnung
queue/adobe_PECommandQueue ein.
●
Wählen Sie in der Liste Bus Name den Eintrag IDP_JMS_Bus aus.
6. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie PEDCommand_AS:
1. Klicken Sie in der Navigationsstruktur auf „Resources“ > „JMS “ > „Activation specifications“.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Klicken Sie auf OK und legen Sie im Bereich „Administration“ die folgenden Eigenschaften fest:
●
Geben Sie in das Feld Name die Bezeichnung PEDCommand_AS ein.
●
Geben Sie in das Feld JNDI name die Bezeichnung PEDCommand_AS ein.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zuweisen der JMS-Aktivierungsspezifikation
50
4. Legen Sie im Bereich „Destination“ die Eigenschaften wie folgt fest:
●
Wählen Sie in der Liste Destination Type den Eintrag Queue.
●
Geben Sie in das Feld Destination JNDI name die Bezeichnung
queue/adobe_PEDCommandQueue ein.
●
Wählen Sie in der Liste Bus Name den Eintrag IDP_JMS_Bus aus.
5. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie „Task_Event_AS“:
1. Klicken Sie in der Navigationsstruktur auf Resources > JMS > Activation specifications.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Übernehmen Sie die Standardeinstellung oder wählen Sie Default messaging provider aus und
klicken Sie auf OK.
4. Legen Sie im Bereich „Administration“ die folgenden Eigenschaften fest:
●
Geben Sie in das Feld Name die Bezeichnung Task_Event_AS ein.
●
Geben Sie in das Feld JNDI Name die Bezeichnung Task_Event_AS ein.
5. Legen Sie im Bereich „Destination“ die Eigenschaften wie folgt fest:
●
Wählen Sie in der Liste Destination Type den Eintrag Topic.
●
Geben Sie in das Feld Destination JNDI name die Bezeichnung
topic/adobe_TaskEventTopic ein.
●
Wählen Sie in der Liste Bus Name den Eintrag IDP_JMS_Bus aus.
6. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie JobManager_AS:
1. Klicken Sie in der Navigationsstruktur auf Resources > JMS > Activation specifications.
2. Wählen Sie in der Dropdown-Liste im rechten Bereich Node (ohne Server) als Ebene aus und klicken Sie
dann auf New.
3. Übernehmen Sie die Standardeinstellung oder wählen Sie Default messaging provider aus und
klicken Sie auf OK.
4. Legen Sie im Bereich „Administration“ die folgenden Eigenschaften fest:
●
Geben Sie in das Feld Name die Bezeichnung JobManager_AS ein.
●
Geben Sie in das Feld JNDI Name die Bezeichnung JobManager_AS ein.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zuweisen von Ausnahmezielen
51
5. Legen Sie im Bereich „Destination“ die Eigenschaften wie folgt fest:
●
Wählen Sie in der Liste Destination Type den Eintrag Queue.
●
Geben Sie in das Feld Destination JNDI name die Bezeichnung
queue/adobe_JobManagerQueue ein.
●
Wählen Sie in der Liste Bus Name den Eintrag IDP_JMS_Bus aus.
6. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Zuweisen von Ausnahmezielen
Sie müssen Skripts einrichten, um die Ausnahmeziele zuzuweisen.
➤ So weisen Sie Ausnahmeziele mithilfe von Skripts zu:
1. Wechseln Sie im Verzeichnis „install_root/IBM/WebSphere/AppServer“ zum Verzeichnis „bin“ und
führen Sie das Skript wsadmin.sh oder wsadmin.bat aus.
2. Zeigen Sie die Warteschlange an, indem Sie den folgenden Befehl an der Eingabeaufforderung von
wsadmin eingeben:
wsadmin>$AdminTask showSIBDestination {-bus IDP_JMS_Bus -name
adobe_PECommandQueue}
3. Ändern Sie das Ausnahmeziel für adobe_PECommandQueue wie folgt:
wsadmin>$AdminTask modifySIBDestination {-bus IDP_JMS_Bus -name
adobe_PECommandQueue -exceptionDestination adobe_PEDCommandQueue}
4. Um die Änderungen zu speichern, geben Sie wsadmin>$AdminConfig save ein.
5. Zum Beenden des Verwaltungstools geben Sie wsadmin>quit ein.
Hinweis: Der Server muss nicht neu gestartet werden, um die Änderungen zu übernehmen.
Konfigurieren der J2C-Authentifizierung für JMS
In diesem Abschnitt wird beschrieben, wie Sie die J2C-Authentifizierung festlegen.
Hinweis: Dieses Verfahren ist nur für WebSphere-Installationen erforderlich, bei denen die
JMS Bussicherheit aktiviert ist. Wenn Ihr Anwendungsserver für die Aktivierung der
JMS-Bussicherheit konfiguriert ist, müssen Sie die JMS-Gruppe, den JMS-Benutzer und die
dazugehörigen Sicherheitseinstellungen erstellen und Gruppenberechtigungen zuweisen.
➤ So konfigurieren Sie die J2C-Authentifizierung:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Security“ > „Secure
administration, applications, and infrastructure“.
2. Klicken Sie unter Authentication auf Java Authentication and Authorization Service >
J2C authentication data und klicken Sie auf New.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der J2C-Authentifizierung für JMS
52
3. Geben Sie in die folgenden Felder die benötigten Informationen ein:
Alias: Geben Sie einen dem Datenbankbenutzer entsprechenden Namen ein
(z. B. IDP_DS/db2-db2user).
Benutzer-ID: Geben Sie eine Benutzer-ID ein. Diese ID ist die Anmeldeinformation für den Zugriff
auf die Datenbank, die mit der IDP_DS-Datenquelle verwendet wird (Beispiel: db2user).
Kennwort: Geben Sie ein Kennwort für diesen Benutzer ein.
4. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
➤ So erstellen Sie eine Gruppe:
Hinweis: Sie müssen „Administrative Security“ und weitere Sicherheitseinstellungen aktivieren, um
Benutzer und Gruppen mithilfe verbundener Repositorys verwalten zu können. Wenn kein
SSL-Zertifikat auf Ihrem Computer vorhanden ist, installieren Sie es mit dem Java Keytool.
Nach der Installation melden Sie sich über HTTPS und den sicheren Anschluss (standardmäßig
ist dies Anschluss 9443) an der WebSphere Administrative Console an.
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „User and Groups“ >
„Manage Groups“ und anschließend auf „Create“. Sie werden aufgefordert, „Administrative Security“ zu
aktivieren.
2. Geben Sie in das Feld Group name die Bezeichnung lc8_jms_group ein und klicken Sie auf Create
und Close.
➤ So erstellen Sie einen Benutzer:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „User and Groups“ >
„Manage Users“ und anschließend auf „Create“.
2. Klicken Sie auf Group Membership und dann auf Search.
3. Wählen Sie den zuvor erstellten Gruppennamen lc8_jms_group aus und klicken Sie auf Close.
4. Geben Sie in das Feld User ID den Eintrag [Authentifizierung für JAAS-Name] ein (z. B. IDP_DS).
5. Geben Sie in die entsprechenden Felder einen Vor- und Nachnamen ein.
6. Geben Sie den [JAAS-Authentifizierungsnamen] als Kennwort ein und klicken Sie auf create.
➤ So weisen Sie Sicherheitseinstellungen zu:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Resources“ >
„JMS“ > „Activation specifications“.
2. Klicken Sie auf eine der Aktivierungsspezifikationen (beispielsweise auf „JobManager_AS“).
3. Wählen Sie unter „Additional Properties“ in der Liste Authentication Alias den
JMS-Authentifizierungsalias aus, der unter „So konfigurieren Sie die J2C-Authentifizierung:“
auf Seite 51 erstellt wurde.
4. Klicken Sie auf „OK“ oder „Apply“ und klicken Sie dann auf „Save directly to Master Configuration“.
5. Wiederholen Sie die Schritte 1 bis 4 für alle Aktivierungsspezifikationen.
Adobe LiveCycle ES
Manuelles Konfigurieren von WebSphere
Installieren und Bereitstellen von LiveCycle ES für WebSphere
SQL Server-JMS-Überprüfung
53
➤ So weisen Sie dem IDP_JMS-Bus Gruppenberechtigungen zu:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf „Service
Integration“ > „Buses“ und klicken Sie anschließend im rechten Bereich auf „IDP_JMS Bus“.
2. Klicken Sie unter Additional Properties auf Security.
3. Klicken Sie unter Additional Properties auf Users and groups in the bus connector role.
4. Klicken Sie auf „New“ > „General properties“ und verwenden Sie unter „Bus Connector Role group“ die
Standardeinstellung oder wählen Sie „Group name“ aus und geben Sie den unter „So konfigurieren Sie
die J2C-Authentifizierung:“ auf Seite 51 erstellten Gruppennamen ein.
5. Klicken Sie auf OK und dann auf Save directly to Master Configuration.
SQL Server-JMS-Überprüfung
Hinweis: Die Überprüfung ist nur für Microsoft SQL Server erforderlich.
Die JMS-Einrichtung für SQL Server macht zusätzliche Überprüfungen erforderlich. Diese sind auch
erforderlich, wenn die JMS- oder LiveCycle Configuration Manager-Überprüfung fehlschlägt.
➤ So überprüfen Sie die JMS-Einrichtung mit SQL Server:
1. Klicken Sie in der Navigationsstruktur der WebSphere-Verwaltungskonsole auf Service Integration >
Buses und klicken Sie anschließend im rechten Bereich auf IDP_JMS_BUS.
2. Klicken Sie unter „Topology“ auf Messaging Engines. Wenn der Bus funktioniert, sollte ein grüner Pfeil
angezeigt werden. Der Status des Busses ist zu diesem Zeitpunkt wahrscheinlich unbekannt.
3. Wählen Sie Ihre Messaging-Engine aus.
4. Klicken Sie unter Additional Properties auf Message store. Der Schemaname muss mit dem Namen
des Benutzers übereinstimmen. Liegt keine Übereinstimmung vor, legen Sie ihn so fest, dass er
übereinstimmt. Um die Microsoft SQL Server-Datenbank und -Benutzer einzurichten, lesen Sie
Vorbereiten der Installation von LiveCycle ES (Einzelserver).
5. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
6. Löschen Sie sämtliche Tabellen, die mit SIB beginnen, um Konflikte mit alten Buskonfigurationen
zu vermeiden.
7. Starten Sie WebSphere neu und wiederholen Sie Schritt 1 und 2, um sicherzustellen, dass der Bus
funktioniert.
Hinweis: Starten Sie WebSphere Application Server neu, damit alle Konfigurationsänderungen wirksam
werden.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Manuelles Konfigurieren von WebSphere
Ausführen der LiveCycle Configuration Manager-Überprüfung
Ausführen der LiveCycle Configuration Manager-Überprüfung
Führen Sie LiveCycle Configuration Manager aus und wählen Sie „Überprüfung der
Anwendungsserverkonfiguration“, um sicherzustellen, dass für Ihre WebSphere Application
Server-Konfiguration keine Fehler gemeldet werden. Etwaige Fehler müssen korrigiert werden,
ehe Sie die LiveCycle ES-Installation fortsetzen können.
Nächster Schritt
Sie müssen jetzt LiveCycle ES-EAR-Dateien auf dem Anwendungsserver bereitstellen. (Siehe
„Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 21.)
54
5
Manuelles Bereitstellen von WebSphere
Dieses Kapitel beschreibt die manuelle Bereitstellung Ihrer LiveCycle ES-Lösungskomponenten unter
WebSphere. Dieses Kapitel ist nur relevant, wenn Sie LiveCycle ES nicht automatisch unter Ihrem
WebSphere Application Server bereitstellen lassen möchten. Informationen zur automatischen
Bereitstellung von LiveCycle ES auf Ihrem Anwendungsserver finden Sie unter „Konfigurieren von und
Bereitstellen von LiveCycle ES“ auf Seite 23.
An dieser Stelle im Installationsprozess haben Sie LiveCycle ES-Dateien bereits installiert, LiveCycle
Configuration Manager zum Konfigurieren der bereitstellbaren LiveCycle ES-Archive ausgeführt und
Ihren WebSphere Application Server manuell konfiguriert. Nun stellen Sie die bereitstellbaren
LiveCycle ES-Archive manuell bereit.
In diesem Kapitel werden die folgenden Themen behandelt:
●
„Bereitstellen von LiveCycle ES-Lösungskomponenten“ auf Seite 55
●
„Bereitstellen unter WebSphere“ auf Seite 56
●
„Starten der Anwendung“ auf Seite 57
Bereitstellen von LiveCycle ES-Lösungskomponenten
Bevor Sie LiveCycle ES bereitstellen, vergewissern Sie sich, dass Sie die folgenden Aufgaben abgeschlossen
haben:
●
Sie haben die erforderliche Software und die notwendigen Dateien installiert und kennen die
Verzeichnispfade, die Sie zur Arbeit benötigen. Wenn Sie diese Aufgabe nicht ausgeführt haben,
lesen Sie Vorbereiten der Installation von LiveCycle ES (Einzelserver).
●
Sie haben LiveCycle Configuration Manager ausgeführt und die LiveCycle ES-Lösungskomponenten
gemäß Ihren spezifischen Anforderungen an System- und Anwendungsserver konfiguriert und
assembliert. Um nach der Bereitstellung eine Lösungskomponente hinzuzufügen, führen Sie LiveCycle
Configuration Manager aus, um die gewünschten Änderungen vorzunehmen, und stellen Sie
anschließend die aktualisierte EAR-Datei erneut bereit.
Wenn Sie LiveCycle ES zum ersten Mal bereitstellen, initialisieren Sie die Datenbank nach der
Bereitstellung des Produkts mithilfe von LiveCycle Configuration Manager.
Wenn Sie einen externen Webserver verwenden, finden Sie Informationen bezüglich der Konfiguration
zum Erteilen des Zugriffs auf den Anwendungsserver in der Dokumentation zum Webserver.
WebSphere-Verzeichnisname
In diesem Kapitel wird das WebSphere Application Server-Basisverzeichnis als
[Anwendungsserver-Stammverzeichnis] bezeichnet. Das Basisverzeichnis entspricht dem für die
Umgebungsvariable WAS_INSTALL_ROOT angegebenen Verzeichnis. Ähnlich dessen verweist das
Verzeichnis [LiveCycle ES-Stammverzeichnis] auf das Verzeichnis, in dem LiveCycle ES-Komponenten
installiert sind. (Siehe .)
55
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ESWebSphere
Manuelles Bereitstellen von WebSphere
Übersicht der bereitstellbaren Komponenten
56
Übersicht der bereitstellbaren Komponenten
Bei der Bereitstellung müssen Sie die folgenden Komponenten für LiveCycle ES bereitstellen.
●
adobe-livecycle-native-websphere-[BS].ear
●
adobe-livecycle-websphere.ear
●
adobe-workspace-client.ear
●
adobe-contentservices.ear (nur LiveCycle Content Services ES)
Nach der Konfiguration von LiveCycle ES mithilfe von LiveCycle Configuration Manager (erforderlich)
befinden sich diese Dateien im Verzeichnis „[LiveCycle ES-Stammverzeichnis]/configurationManager/export/“.
Bereitstellen unter WebSphere
Stellen Sie LiveCycle ES-Lösungskomponenten auf WebSphere bereit, indem Sie die EAR-Dateien der
entsprechenden Komponente mit der WebSphere Administrative Console auf dem Anwendungsserver
bereitstellen.
Vor dem Bereitstellen unter WebSphere starten Sie den Anwendungsserver auf dem Computer.
Beenden Sie den Anwendungsserver nach der Bereitstellung der erforderlichen Komponenten und
starten Sie ihn neu, bevor Sie Dienste starten.
➤ So stellen Sie die EAR-Dateien bereit:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Applications >
Install New Application.
2. Wählen Sie im rechten Bereich Remote file system oder Local File System aus.
3. Klicken Sie auf Browse, wechseln Sie zu einer der unter „Übersicht der bereitstellbaren Komponenten“
auf Seite 56 angegebenen EAR-Dateien und wählen Sie die gewünschte EAR-Datei aus.
4. Wählen Sie Show me all installation options and parameters aus und klicken Sie auf Next.
5. Wählen Sie Generate Default Bindings und klicken Sie auf Next.
6. Wählen Sie im rechten Bereich unter Summary in der linken Spalte den letzten Schritt aus und
klicken Sie auf Finish.
7. Klicken Sie nach erfolgreicher Installation der EAR-Datei im Feld Messages auf Save directly to Master
Configuration.
8. Wiederholen Sie diese Schritte für alle EAR-Dateien unter „Übersicht der bereitstellbaren
Komponenten“ auf Seite 56.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ESWebSphere
Manuelles Bereitstellen von WebSphere
Starten der Anwendung
57
Starten der Anwendung
Nach der Bereitstellung der Lösungskomponente müssen die Anwendungen gestartet werden. Wenn neben
dem Namen der Anwendung statt eines roten X ein grüner Pfeil angezeigt wird, wurde die Anwendung
erfolgreich bereitgestellt und gestartet. Falls die Anwendung nicht gestartet werden kann, wird in
WebSphere eine Fehlermeldung angezeigt.
Informationen zu Fehlermeldungen in WebSphere finden Sie in der Dokumentation zu WebSphere
Application Server.
➤ So starten Sie eine Anwendung in WebSphere:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Applications >
Enterprise Applications.
2. Wählen Sie die LiveCycle ES-Anwendungen aus, die Sie starten möchten, und klicken Sie auf Start.
Statt des roten X neben dem Anwendungsstatus wird nun ein grüner Pfeil angezeigt, der darauf
hinweist, dass die Anwendung ausgeführt wird.
Nächste Schritte
Sie müssen LiveCycle Configuration Manager ausführen, um die Datenbank zu initialisieren sowie
die Komponenten und LiveCycle ES-Archivdateien (LCAs) bereitzustellen. Sie können außerdem die
Bereitstellung der Komponenten und Archive überprüfen lassen. (Siehe „Konfigurieren von LiveCycle ES
für die Bereitstellung“ auf Seite 21.)
6
Aktivitäten nach der Bereitstellung
In diesem Kapitel wird beschrieben, wie über den Zugriff auf die LiveCycle Administration Console und die
Überprüfung der Protokolldateien des Anwendungsservers die Bereitstellung überprüft werden kann.
In diesem Kapitel werden auch die ersten Arbeitsschritte nach der Installation, Konfiguration und
Bereitstellung der LiveCycle ES-Lösungskomponenten auf dem Anwendungsserver beschrieben:
●
„Überprüfen der Bereitstellung und Zugreifen auf die LiveCycle Administration Console“ auf Seite 58
●
„Zugriff auf die Webanwendungen der Lösungskomponente“ auf Seite 60
●
„Zugriff auf das Content Services ES-Repository“ auf Seite 62
●
„Zugreifen auf User Management“ auf Seite 62
●
„Konfigurieren von LiveCycle PDF Generator ES oder 3D ES“ auf Seite 63
●
„Abschließende Einrichtung für LiveCycle Rights Management ES“ auf Seite 71
●
„Konfigurieren von LiveCycle ES für den LDAP-Zugriff“ auf Seite 71
●
„Festlegen von Leistungsparametern für überwachte Ordner in PDF Generator ES oder 3D ES“
auf Seite 73
●
„Aktivieren des FIPS-Modus“ auf Seite 74
●
„Konfigurieren von Einstellungen für eine digitale HTML-Signatur“ auf Seite 74
●
„Konfigurieren des Document Management-Dienstes für LiveCycle Content Services ES“ auf Seite 75
●
„Konfigurieren des Connector for EMC Documentum-Dienstes“ auf Seite 75
●
„Konfigurieren des Connector for IBM FileNet-Dienstes“ auf Seite 80
●
„Konfigurieren von LiveCycle ES Connector for IBM Content Manager“ auf Seite 88
●
„Deinstallieren von LiveCycle ES“ auf Seite 93
Nachdem Sie die Einstellungen in diesem Kapitel konfiguriert haben, sollten Sie das Dokument Verwalten
von LiveCycle ES lesen. Es enthält zusätzliche Informationen zum Konfigurieren der LiveCycle ES-Umgebung
für die Entwicklung und Produktion.
Überprüfen der Bereitstellung und Zugreifen auf die LiveCycle
Administration Console
Sie können die Bereitstellung überprüfen, indem Sie sich an der LiveCycle Administration Console anmelden.
Wenn Sie sich erfolgreich angemeldet haben, wird LiveCycle ES auf dem Anwendungsserver ausgeführt
und der Standardbenutzer wird in der Datenbank erstellt.
Sie können die Protokolldateien des Anwendungsservers überprüfen, um sicherzustellen,
dass Komponenten ordnungsgemäß bereitgestellt wurden, oder die Ursachen eventuell
aufgetretener Bereitstellungsprobleme bestimmen.
58
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zugreifen auf LiveCycle Administration Console
59
Zugreifen auf LiveCycle Administration Console
Bei LiveCycle Administration Console handelt es sich um ein webbasiertes Portal für den Zugriff
auf zahlreiche Konfigurationsseiten, auf denen Sie Laufzeiteigenschaften festlegen können, die die
Funktionsweise von LiveCycle ES steuern. Wenn Sie sich an LiveCycle Administration Console anmelden,
erhalten Sie Zugriff auf die User Management-, Watched Folder- und E-Mail-Clients-Konfiguration sowie
auf administrative Konfigurationsoptionen für andere Dienste. Über die LiveCycle Administration Console
greifen Sie auch auf Applications and Services zu, mit deren Hilfe Administratoren Archive verwalten und
Dienste in einer Produktionsumgebung bereitstellen.
Der standardmäßige Benutzername für die Anmeldung lautet administrator und das Standardkennwort
password. Nach der ersten Anmeldung können Sie das Standardkennwort mithilfe von User Management
ändern. Nach einer Aktualisierung ändern sich der Benutzername und das Kennwort nicht, der/das vom
Administrator bei der Konfiguration von festgelegt wurde.
Bevor Sie auf LiveCycle Administration Console zugreifen, muss LiveCycle ES auf dem Anwendungsserver
bereitgestellt sein und ausgeführt werden.
Informationen zur Verwendung von LiveCycle Administration Console finden Sie in der Applications and
Services-Administrator-Hilfe.
➤ So greifen Sie auf die LiveCycle Administration Console zu:
1. Geben Sie in einem Webbrowser den folgenden URL ein:
http://[Hostname]:[Anschluss]/adminui
Der Standardanschluss für WebSphere ist „9080“.
2. Geben Sie in das Feld Benutzername den Wert administrator und in das Feld Kennwort den Wert
password ein.
3. Nachdem Sie sich angemeldet haben, klicken Sie auf Dienste, um die Dienstverwaltungsseiten
aufzurufen, oder auf Einstellungen, um die Seiten für die Verwaltung der Einstellungen für andere
Lösungskomponenten anzuzeigen.
Anzeigen der Protokolldateien
Ereignisse wie Laufzeit- oder Startfehler werden in die Protokolldateien des Anwendungsservers
geschrieben. Wenn bei der Bereitstellung auf dem Anwendungsserver Probleme auftreten, konnen Sie
diese mithilfe der Protokolldateien identifizieren. Sie konnen die Protokolldateien in einem beliebigen
Texteditor offnen.
Die folgenden Protokolldateien sind im Verzeichnis
„[Anwendungsserver-Stammverzeichnis]/profiles/default/logs/Servername“ gespeichert:
●
SystemErr.log
●
SystemOut.log
●
StartServer.log
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zugriff auf die Webanwendungen der Lösungskomponente
60
Zugriff auf die Webanwendungen der Lösungskomponente
Nach der Bereitstellung von LiveCycle ES konnen Sie auf die Webanwendungen zugreifen, die den
folgenden Losungskomponenten zugeordnet sind:
●
LiveCycleReader Extensions ES
●
LiveCycleWorkspace ES
●
LiveCycleRights Management ES
●
LiveCycleContent Services ES
Nach dem Zugriff auf die Webanwendungen mithilfe der standardmäßigen Administratorberechtigungen,
um zu prüfen, ob ein Zugriff möglich ist, können Sie weitere Benutzer und Rollen erstellen, damit andere
Benutzer sich anmelden und die Anwendungen nutzen können. (Informationen dazu finden Sie in der
User Management-Hilfe.)
➤ So greifen Sie auf die Reader Extensions ES-Webanwendung zu:
Hinweis: Sie müssen eine Reader Extensions ES-Berechtigung zuweisen und einem neuen Benutzer die
Benutzerrollen zuordnen. (Siehe unter „Konfigurieren von SSL“ in Verwalten von LiveCycle ES.)
1. Öffnen Sie einen Webbrowser und geben Sie diesen URL ein:
http://localhost:9080/ReaderExtensions (lokale Bereitstellung unter Verwendung des
Standardanschlusses).
2. Melden Sie sich mit dem standardmaßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
Hinweis: Sie benötigen Administrator- oder Hauptbenutzerberechtigungen, um sich mit dem
standardmäßigen Benutzernamen und Kennwort anmelden zu können. Um anderen
Benutzer den Zugriff auf die Webanwendung Reader Extensions ES zu erlauben,
müssen Sie die Benutzer in User Management erstellen und ihnen die Rolle „Reader
Extensions-Webanwendung“ zuweisen.
➤ So greifen Sie auf die Workspace ES zu:
1. Öffnen Sie einen Webbrowser und geben Sie diesen URL ein:
http://localhost:9080/workspace (lokale Bereitstellung unter Verwendung des
Standardanschlusses).
2. Melden Sie sich mit dem standardmaßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zugreifen auf die Rights Management ES
61
➤ So greifen Sie auf die Content Services ES-Webanwendung zu:
Hinweis: Sie müssen die Rolle „LiveCycle Contentspace Administrator“ oder „LiveCycle Contentspace“
einem neuen Benutzer zuordnen, um sich an dieser Webanwendung anmelden zu können.
Erstellen Sie dazu die Benutzer in User Management und weisen Sie ihnen die entsprechende
Rolle zu.
1. Öffnen Sie einen Webbrowser und geben Sie diesen URL ein:
●
http://localhost:9080/contentspace (lokale Bereitstellung unter Verwendung des
Standardanschlusses).
2. Melden Sie sich mit dem standardmaßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
Zugreifen auf die Rights Management ES
Sie müssen in User Management einen Benutzer mit der Rolle „LiveCycle Rights Management –
Endbenutzer“ erstellen und sich mit den diesem Benutzer zugeordneten Anmeldeinformationen
bei den Administrator- oder Endbenutzeranwendungen von Rights Management ES anmelden.
➤ So greifen Sie auf die Rights Management ES-Webanwendung für Endbenutzer zu:
1. Öffnen Sie einen Webbrowser und geben Sie diesen URL ein:
http://[Server]:[Anschluss]/edc/Login.do
Hinweis: Der Administratorbenutzer kann nicht auf die Rights Management ES-Webanwendung
für Endbenutzer zugreifen. Sie können mithilfe der LiveCycle Administration Console neue
Benutzer erstellen.
➤ So greifen Sie auf die Rights Management ES-Webanwendung für die Administration zu:
1. Öffnen Sie einen Webbrowser und geben Sie diesen URL ein:
http://[Server]:[Anschluss]/adminui
2. Klicken Sie auf Dienste > LiveCycle Rights Management ES. Weitere Informationen zum Einrichten
von Benutzern und Rollen für Rights Management ES finden Sie im Handbuch Verwalten
von LiveCycle ES.
➤ So weisen Sie die Rolle „LiveCycle Rights Management-Endbenutzer“ zu:
1. Melden Sie sich an der LiveCycle Administration Console an. (Siehe „Zugreifen auf LiveCycle
Administration Console“ auf Seite 59.)
2. Klicken Sie auf „Einstellungen“ > „User Management“ > „Benutzer und Gruppen“.
3. Geben Sie in das Feld Suchen den Wert Alle ein und wählen Sie in der Liste In den Eintrag Gruppen aus.
4. Klicken Sie auf Suchen und dann in der angezeigten Liste für die erforderlichen Domänen
auf Alle Prinzipale.
5. Klicken Sie auf die Registerkarte Rollenzuweisungen und dann auf Rollen suchen.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zugreifen auf User Management
62
6. Aktivieren Sie in der Liste der Rollen das Kontrollkästchen neben LiveCycle Rights Management –
Endbenutzer.
7. Klicken Sie auf „OK“ und dann auf „Speichern“.
Zugreifen auf User Management
Mit User Management können Administratoren eine Datenbank aller Benutzer und Gruppen verwalten,
die mit einem oder mehreren Benutzerverzeichnissen von Drittanbietern synchronisiert ist. User
Management ermöglicht die Authentifizierung, Autorisierung und Benutzerverwaltung für LiveCycle ESLösungskomponenten wie Reader Extensions ES, Workspace ES, Rights Management ES,
Process Management ES und Forms ES.
➤ So greifen Sie auf User Management zu:
1. Melden Sie sich an der LiveCycle Administration Console an.
2. Klicken Sie auf der Startseite auf „Einstellungen“ > „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.
Zugriff auf das Content Services ES-Repository
Sie können Folgendes für den Zugriff auf das Content Services ES-Repository verwenden:
●
FTP (File Transfer Protocol)
●
WebDAV (Web-based Distributed Authoring and Versioning)
●
CIFS (Common Internet File Systems)
➤ So greifen Sie mithilfe von FTP auf das Content Services ES-Repository zu:
1. Öffnen Sie einen Webbrowser und geben Sie diesen URL ein:
ftp://[Servername]:[Anschluss]
Hinweis: Der Standardanschluss für das Content Services ES-Repository ist „8021“.
2. Melden Sie sich mit Ihrem Benutzernamen und Kennwort an.
Hinweis: Mit Mozilla FireFox ist die Anmeldung beim Content Services ES-Repository mittels FTP
nicht möglich. Verwenden Sie einen anderen Browser (z. B. Internet Explorer) für den
Zugriff auf das Content Services ES-Repository mittels FTP.
➤ So greifen Sie mithilfe von WebDAV auf das Content Services ES-Repository zu:
1. Öffnen Sie den Windows Explorer und navigieren Sie zu „Netzwerkumgebung“.
2. Klicken Sie mit der rechten Maustaste und wählen Sie „Netzwerkressource hinzufügen“ aus.
3. Geben Sie die folgende Netzwerkadresse ein:
http://[Servername]:[Anschluss]/contentspace/webdav
4. Melden Sie sich mit Ihrem Benutzernamen und Kennwort an.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von LiveCycle PDF Generator ES oder 3D ES
63
➤ So greifen Sie mithilfe von CIFS auf das Content Services ES-Repository zu:
Hinweis: Ihr Content Services ES-Repository muss zuvor für die Unterstützung des CIFS-Zugriffs
konfiguriert worden sein.
1. Klicken Sie auf einem Computer mit dem Betriebssystem Windows auf „Start“ > „Ausführen“.
2. Geben Sie Folgendes ein:
\\[Servername]a
Hinweis: Sie werden nicht zur Eingabe eines Benutzernamens oder Kennworts aufgefordert.
Konfigurieren von LiveCycle PDF Generator ES oder 3D ES
Wenn LiveCycle PDF Generator ES oder LiveCycle PDF Generator 3D ES als Bestandteil der LiveCycle ESLosung installiert wurde, fuhren Sie die folgenden Aufgaben aus:
●
„Festlegen von Umgebungsvariablen“ auf Seite 63
●
„Konfigurieren des Anwendungsservers für die Verwendung eines HTTP-Proxyservers“ auf Seite 64
●
„Einrichten von Adobe PDF Printer als Standarddrucker“ auf Seite 65
●
„Konfigurieren von Acrobat 9.0“ auf Seite 65
●
„Installieren ostasiatischer Zeichen unter Windows“ auf Seite 66
●
„Hinzufügen von Schriftarten PDF Generator ES oder PDF Generator 3D ES“ auf Seite 66
●
„Installieren des IPP-Clients“ auf Seite 70
Festlegen von Umgebungsvariablen
Wenn Sie die PDF Generator ES- oder PDF Generator 3D ES-Lösungskomponente installiert und für das
Konvertieren von Dateien in PDF konfiguriert haben, müssen Sie für einige Dateiformate manuell eine
Umgebungsvariable festlegen, die den absoluten Pfad der ausführbaren Datei enthält, die zum Starten der
entsprechenden Anwendung verwendet wird. Die folgende Tabelle führt die nativen Anwendungen auf,
bei denen Sie für PDF Generator ES oder PDF Generator 3D ES Umgebungsvariablen einrichten müssen.
Anwendung
Umgebungsvariable
Beispiel
Acrobat
Acrobat_PATH
C:\Programme\Adobe\Acrobat 9.0\Acrobat\
Acrobat.exe
Adobe
FrameMaker®
FrameMaker_PATH
C:\Programme\Adobe\FrameMaker7.1\
FrameMaker.exe
Editor
Notepad_PATH
C:\WINDOWS\Notepad.exe
OpenOffice
OpenOffice_PATH
C:\Programme\OpenOffice.org 2.0
Adobe
PageMaker®
PageMaker_PATH
C:\Programme\Adobe\PageMaker 7.0\
PageMaker.exe
WordPerfect
WordPerfect_PATH
C:\Programme\WordPerfect Office 12\
Programs\wpwin12.exe
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Anwendungsservers für die Verwendung eines
HTTP-Proxyservers
64
Hinweis: Die Umgebungsvariable OpenOffice_PATH wird auf den Installationsordner anstatt auf den
Pfad der ausfuhrbaren Datei festgelegt.
Für Microsoft Office-Anwendungen wie Word, PowerPoint, Excel, Visio und Project oder für AutoCAD
mussen keine Pfade festgelegt werden. Der Generate PDF-Dienst startet diese Anwendungen automatisch,
wenn sie auf dem Server installiert sind.
➤ So erstellen Sie eine neue Windows-Umgebungsvariable:
1. Wählen Sie „Start“ > „Systemsteuerung“ > „System“.
2. Klicken Sie auf die Registerkarte Erweitert und dann auf Umgebungsvariablen.
3. Klicken Sie im Abschnitt Systemvariablen auf Neu.
4. Geben Sie den festzulegenden Umgebungsvariablennamen ein (z. B. Photoshop_PATH). Dieser
Ordner ist der, der die ausführbare Datei enthält. Geben Sie beispielsweise Folgendes ein:
D:\Programme\Adobe\Adobe Photoshop CS2\Photoshop.exe
➤ So legen Sie die Umgebungsvariable PATH unter Linux oder UNIX fest (nur OpenOffice):
●
Geben Sie den folgenden Befehl ein:
export OpenOffice_PATH /opt/openoffice.org2
Konfigurieren des Anwendungsservers für die Verwendung eines
HTTP-Proxyservers
Wenn der Computer, auf dem LiveCycle ES ausgefuhrt wird, Proxyeinstellungen für den Zugriff auf externe
Websites verwendet, muss der Anwendungsserver mit folgenden als JVM-Argumente (Java Virtual
Machine) festgelegten Werten gestartet werden:
-Dhttp.proxyHost=[Serverhost]
-Dhttp.proxyPort=[Serveranschluss]
Führen Sie das folgende Verfahren zum Starten Ihres Anwendungsservers
mit HTTP-Proxyhosteinstellungen aus.
➤ So fügen Sie die Einstellung zu WebSphere hinzu:
1. Klicken Sie in der WebSphere Administrative Console auf Servers > Application Servers und
klicken Sie anschließend im rechten Fenster auf server1.
2. Klicken Sie unter „Server Infrastructure“ auf Java and Process Management > Process Definition.
3. Klicken Sie unter „Additional Properties“ auf Java Virtual Machine > Custom Properties.
4. Klicken Sie auf New und geben Sie in das Feld Name die Bezeichnung http.proxyHost ein.
5. Geben Sie im Feld Value den Hostnamen oder die IP-Adresse Ihres HTTP-Proxyservers ein und
klicken Sie auf OK.
6. Klicken Sie auf New und geben Sie in das Feld Name die Bezeichnung http.proxyPort ein.
7. Geben Sie im Feld Value die Anschlussnummer Ihres HTTP-Proxyservers ein und klicken Sie auf OK.
8. Klicken Sie auf im Feld Messages auf Save directly to master configuration.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Einrichten von Adobe PDF Printer als Standarddrucker
65
Hinweis: Wiederholen Sie zum Konfigurieren eines Clusters die Schritte 2 bis 8 für jeden Knoten
im Cluster.
9. Starten Sie alle WebSphere-Serverinstanzen neu.
Einrichten von Adobe PDF Printer als Standarddrucker
Sie mussen Adobe PDF Printer auf dem Server als Standarddrucker festlegen. Wenn Adobe PDF Printer
nicht als Standard festgelegt ist, kann PDF Generator ES Dateien nicht erfolgreich konvertieren.
➤ So legen Sie den Standarddrucker fest:
1. Wahlen Sie Start > Drucker und Faxgerate.
2. Klicken Sie mit der rechten Maustaste im Fenster Drucker und Faxgerate auf Adobe PDF und
wahlen Sie Als Standarddrucker festlegen.
Konfigurieren von Acrobat 9.0
Dieses Verfahren ist nur erforderlich, wenn Sie nach Abschluss der Installation von LiveCycle ES auf
Acrobat 9.0 aktualisiert oder diese Version installiert haben. Die Aktualisierung von Acrobat kann
nach der Ausführung von LiveCycle Configuration Manager und der Bereitstellung von LiveCycle ES
auf dem Anwendungsserver durchgeführt werden.
➤ So konfigurieren Sie Acrobat 9.0 Professional Extended für die Verwendung mit PDF Generator ES
oder PDF Generator 3D ES:
1. Wenn eine frühere Acrobat-Version (8.1 oder früher) installiert ist, deinstallieren Sie diese mithilfe von
„Software“ in der Windows-Systemsteuerung.
2. Acrobat 9.0 Professional Extended ist auf den LiveCycle ES-Datenträgern enthalten oder als Option für
ESD-Downloads vorhanden.
●
Wenn Sie die Datenträger verwenden, legen Sie die Acrobat 9.0 Professional Extended-CD ein.
●
Wenn Sie die ESD-Downloads verwenden, laden Sie Acrobat 9.0 Professional Extended von Ihrem
ESD-Speicherort herunter.
3. Installieren Sie Acrobat 9.0 Professional Extended, indem Sie die Datei „AutoPlay.exe“ ausführen.
4. Wechseln Sie zum Ordner additional\scripts auf dem LiveCycle ES-Installationsmedium.
5. Fuhren Sie folgende Stapelverarbeitungsdatei aus:
Acrobat_for_PDFG_Configuration.bat [LiveCycle ES-Stammverzeichnis]
6. Öffnen Sie Acrobat und wählen Sie Hilfe > Nach Updates suchen > Voreinstellungen.
7. Deaktivieren Sie Automatisch nach Aktualisierungen suchen.
➤ So überprüfen Sie die Installation von Acrobat 9.0 Professional Extended:
1. Wechseln Sie zu einer PDF-Datei im System und doppelklicken Sie darauf, um sie in Acrobat zu öffnen.
Wird die PDF-Datei geöffnet, wurde Acrobat 9.0 Professional Extended ordnungsgemäß installiert.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren ostasiatischer Zeichen unter Windows
66
2. Wird die PDF-Datei nicht ordnungsgemäß geöffnet, müssen Sie Acrobat deinstallieren und
anschließend neu installieren.
Hinweis: Vergewissern Sie sich, dass alle nach Abschluss der Acrobat-Installation angezeigten
Dialogfelder geschlossen werden, und deaktivieren Sie die automatische Aktualisierung
für Acrobat.
Legen Sie die Umgebungsvariable Acrobat_PATH so fest, dass sie auf Acrobat.exe verweist
(z. B. C:\Programme\Adobe\Acrobat 9.0\Acrobat\Acrobat.exe).
➤ So konfigurieren Sie die Unterstützung nativer Anwendungen:
1. Installieren und überprüfen Sie Acrobat wie im vorangehenden Verfahren beschrieben.
2. Legen Sie den Adobe PDF-Drucker als Standarddrucker fest.
3. (PDF Generator 3D ES) Registrieren Sie die DLL-Datei in
[LiveCycle8.2-Stammverzeichnis]\plugins\x86win32\PDFG3dAddin.dll.
Installieren ostasiatischer Zeichen unter Windows
Bei der Konvertierung von HTML-Dateien in PDF unter Verwendung von PDF Generator ES oder
PDF Generator 3D ES werden einige ostasiatische Sprachen wie Japanisch, Koreanisch und Chinesisch
sowie Sprachen mit Rechts-nach-links-Schreibrichtung wie Arabisch, Armenisch, Georgisch, Hebraisch,
Indisch, Thai und Vietnamesisch in der PDF-Datei moglicherweise nicht angezeigt.
Zum Anzeigen dieser Sprachen unter Windows müssen geeignete Schriftarten auf dem Client und Server
vorhanden sein.
➤ So installieren Sie ostasiatische Zeichen unter Windows:
1. Wählen Sie „Start“ > „Systemsteuerung“ und öffnen Sie „Regions- und Sprachoptionen“.
2. Aktivieren Sie auf der Registerkarte „Sprachen“ das Kontrollkästchen „Dateien für ostasiatische
Sprachen installieren“.
3. Aktivieren Sie auf der Registerkarte „Erweitert“ alle Optionen unter „Codepagekonvertierungstabellen“.
Wenn in konvertierten PDF-Dateien immer noch Schriftarten fehlen, uberprufen Sie, ob die Schriftart
„Arial Unicode MS (TrueType)“ (ARIALUNI.TTF) im Verzeichnis C:\WINDOWS\Fonts vorhanden ist.
Hinzufügen von Schriftarten PDF Generator ES oder PDF Generator 3D ES
LiveCycle ES bietet ein zentrales Repository für Schriften namens Adobe LiveCycle ES Fonts Management,
auf das alle LiveCycle ES-Lösungskomponenten zugreifen können. Das Fonts Management-Modul ist ein
zentraler Speicherort für alle Schriften, die für verschiedene LiveCycle ES-Lösungskomponenten verfügbar
sind und von diesen gemeinsam genutzt werden.
PDF Generator ES oder PDF Generator 3D ES müssen jedoch häufig externe (Nicht-LiveCycle ES-)
Anwendungen auf dem Server starten, die nicht für die Verwendung des LiveCycle ES-Schriften-Repositorys
konfiguriert werden können. In diesem Abschnitt wird beschrieben, wie die zusätzlichen Schriften
für diese Anwendungen verfügbar gemacht werden können, sodass die mithilfe von PDF Generator ES
oder PDF Generator 3D ES erstellten PDF-Dokumente diese zusätzlichen Schriften verwenden können.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Aktivitäten nach der Bereitstellung
Hinzufügen von Schriftarten PDF Generator ES oder
PDF Generator 3D ES
67
Anwendungen, die nicht von Adobe sind
Im Folgenden finden Sie eine Liste der Nicht-LiveCycle ES-Anwendungen, die von PDF Generator ES oder
PDF Generator 3D ES zur Erstellung von PDFs auf dem Server verwendet werden können:
Reine Windows-Anwendungen
●
Microsoft Office Word
●
Microsoft Office Excel
●
Microsoft Office PowerPoint
●
Microsoft Office Project
●
Microsoft Office Visio
●
Microsoft Office Publisher
●
AutoDesk AutoCAD
●
Corel WordPerfect
●
Adobe Photoshop CS
●
Adobe FrameMaker
●
Adobe PageMaker
●
Adobe Acrobat Professional Extended
Anwendungen für mehrere Plattformen
●
OpenOffice Writer
●
OpenOffice Calc
●
OpenOffice Draw
●
OpenOffice Impress
Hinweis: Zusätzlich zu diesen Anwendungen kann Ihre Liste weitere, von Ihnen hinzugefügte
Anwendungen enthalten.
Von den zuvor aufgeführten Anwendungen ist die OpenOffice Suite (bestehend aus Writer, Calc, Draw und
Impress) für die Plattformen Windows, Solaris und Linux verfügbar, während die anderen Anwendungen
nur unter Windows verfügbar sind.
Hinzufügen neuer Schriften zu reinen Windows-Anwendungen
Alle zuvor aufgeführten reinen Windows-Anwendungen können auf alle Schriften zugreifen, die im
Ordner C:\Windows\Fonts (oder entsprechend) verfügbar sind. Zusätzlich zu C:\Windows\Fonts
kann jede dieser Anwendungen über einen oder mehrere eigene, private Schriftenordner verfügen.
Daher müssen Sie, wenn Sie dem LiveCycle ES-Schriften-Repository benutzerdefinierte Schriften
hinzufügen möchten, sicherstellen, dass dieselben Schriften auch für die reinen Windows-Anwendungen
verfügbar sind, indem Sie sie in den Ordner C:\Windows\Fonts (oder entsprechend) kopieren.
Ihre benutzerdefinierten Schriften müssen gemäß einer Vereinbarung lizenziert sein, die Ihnen deren
Verwendung mit den Anwendungen erlaubt, die Zugriff auf dieses Schriften haben.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Aktivitäten nach der Bereitstellung
Konfigurieren von „HTML in PDF“-Konvertierungen
68
Hinzufügen neuer Schriften zur OpenOffice Suite
Das Hinzufügen von benutzerdefinierten Schriften zur OpenOffice Suite wird auf der OpenOffice-Seite
Fonts-FAQ unter http://wiki.services.openoffice.org erläutert.
Zusätzlich gibt es noch folgende Ressourcen zum schriftenbezogenen Verhalten der OpenOffice Suite:
●
OpenOffice Fonts Troubleshooting Guide unter http://www.openoffice.org/FAQs/fontguide.html. Teile
des Textes in diesem Handbuch gelten nur für OpenOffice 1.x und sind deshalb möglicherweise für
OpenOffice 2.x bedeutungslos.
●
Importing Fonts into OpenOffice 2.1 unter http://openoffice.blogs.com/openoffice/2007/02/
font_import_wiz.html. Auch wenn in diesem Blog OpenOffice 2.1 erwähnt wird, sollten die
angeführten Anleitungen auch für OpenOffice 2.2 und höher gelten.
Hinzufügen neuer Schriften zu anderen Anwendungen
Falls Sie PDF Generator ES durch Hinzufügen von Unterstützung für die PDF-Erstellung mithilfe anderer
Anwendungen erweitert haben, finden Sie Informationen zur optimalen Vorgehensweise, um diesen
Anwendungen neue Schriften hinzuzufügen, im Benutzerhandbuch der entsprechenden Anwendung.
Unter Windows sollte das Kopieren der benutzerdefinierten Schriften in den Ordner C:\Windows\Fonts
(oder entsprechend) ausreichen.
Konfigurieren von „HTML in PDF“-Konvertierungen
Der „HTML in PDF“-Konvertierungsprozess ist auf die Verwendung der Einstellungen von Acrobat 9.0
ausgelegt, wodurch die Einstellungen von LiveCycle PDF Generator ES außer Kraft gesetzt werden.
Hinweis: Diese Konfiguration ist erforderlich, um den „HTML in PDF“-Konvertierungsprozess zu aktivieren,
da diese Konvertierung andernfalls fehlschlägt.
➤ So konfigurieren Sie die „HTML in PDF“-Konvertierung:
1. Installieren und überprüfen Sie Acrobat wie in „Konfigurieren von Acrobat 9.0“ auf Seite 65
beschrieben.
2. Suchen Sie die Datei pdfgen.api im Verzeichnis [LiveCycle8.2-Stammverzeichnis]\plugins\x86win32 und
kopieren Sie sie in das Verzeichnis [Acrobat9.0-Stammverzeichnis]\Acrobat\plug_ins.
Aktivieren der Unterstützung für Unicode-Schriften bei „HTML
in PDF“-Konvertierungen
Damit PDF Generator ES bzw. PDF Generator 3D ES aus HTML-Quelldateien, die Unicode-Schriften
enthalten, PDF-Dateien erzeugen können, führen Sie folgende Schritte aus.
Vorsicht: Die „HTML in PDF“-Konvertierung schlägt fehl, wenn eine komprimierte (ZIP) Eingabedatei
HTML-Dateien enthält, deren Dateinamen Doppelbyte-Zeichen enthalten. Verwenden Sie zur
Vermeidung dieses Problems keine Doppelbyte-Zeichen in Namen von HTML-Dateien.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von „HTML in PDF“-Konvertierungen
69
1. Kopieren Sie die Unicode-Schrift in jedes der folgenden Verzeichnisse, je nachdem, wie es für Ihr
System erforderlich ist:
●
Windows
[Windows-Stammverzeichnis]\windows\fonts
[Windows-Stammverzeichnis]\winnt\fonts
●
UNIX
/usr/X/lib/X11/fonts/TrueType
/usr/openwin/lib/X11/fonts/TrueType
/usr/share/fonts/default/TrueType
/usr/X11R6/lib/X11/fonts/ttf
/usr/X11R6/lib/X11/fonts/truetype
/usr/X11R6/lib/X11/fonts/TrueType
/usr/X11R6/lib/X11/fonts/TTF
/Users/cfqauser/Library/Fonts
/System/Library/Fonts
/Library/Fonts
/Users/ + System.getProperty(<Benutzername>, root) + /Library/Fonts
System.getProperty(JAVA_HOME) + /lib/fonts
2. Ändern Sie die Schriftartennamenzuordnung in der Datei cffont.properties, die sich in der Datei
[LiveCycle8.2-Stammverzeichnis]/adobe-generatepdf-dsc.jar befindet:
●
Entpacken Sie dieses Archiv, suchen Sie die Datei cffont.properties und öffnen Sie sie in einem
Editor.
●
Fügen Sie in der durch Kommas getrennten Liste von Java-Schriftartnamen für jeden Schrifttyp
Ihrer Unicode-Systemschriftart eine Zuordnung hinzu, wie in diesen Beispielen dargestellt. Dabei ist
„kochi mincho“ der Name Ihrer Unicode-Systemschriftart.
dialog=Arial, Helvetica, kochi mincho
dialog.bold=Arial Bold, Helvetica-Bold, kochi mincho ...
●
Speichern und schließen Sie die Eigenschaftendatei, packen Sie die Datei
adobe-generatepdf-dsc.jar neu und stellen Sie sie wieder bereit.
Hinweis: Auf einem japanischen Betriebssystem geben Sie die Schriftartzuordnung auch in der Datei
cffont.properties.ja an. Diese Datei hat Vorrang vor der Standarddatei cffont.properties.
Tipp: In der Liste enthaltene Schriftarten werden von links nach recht durchsucht, wobei die erste
gefundene Schriftart verwendet wird. „HTML in PDF“-Konvertierungsprotokolle geben eine Liste
aller Schriftartnamen zurück, die im System gefunden wurden. Zur Ermittlung des Schriftartnamens,
der zugeordnet werden muss, fügen Sie die Schriftart in einem der zuvor aufgeführten Verzeichnisse
hinzu, starten den Server neu und führen anschließend eine Konvertierung aus. In den
Protokolldateien können Sie den Schriftartnamen ermitteln, der für die Zuordnung
zu verwenden ist.
Um die Schrift in die erzeugten PDF-Dateien einzubetten, legen Sie die Eigenschaft embedFonts in der
Datei cffont.properties auf true fest (Standardeinstellung ist false).
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren des IPP-Clients
70
Installieren des IPP-Clients
PDF Generator ES enthält ein IPP-Clientinstallationsprogramm (Internet Printing Protocol) zur Installation
des PDF Generator ES-Internetdruckers auf einem Clientcomputer. Nach dem Abschluss der Installation
wird der Liste der vorhandenen Drucker auf dem Clientcomputer ein PDF Generator ES-Drucker
hinzugefügt. Dieser Drucker kann dann zum Senden von Dokumenten zur Konvertierung in PDF
verwendet werden.
Hinweis: Der PDF Generator ES-IPP-Client (Assistent) wird nur auf 32-Bit-Windows-Plattformen
unterstützt.
Wenn die Installation des IPP-Clients unter Windows fehlschlägt oder wenn Sie den IPP-Drucker auf einer
UNIX- oder Linux-Plattform installieren möchten, verwenden Sie das native Dienstprogramm des
Betriebssystems zum Hinzfügen von Druckern und nehmen die Konfiguration gemäß der Beschreibung
in „So konfigurieren Sie den IPP-Drucker unter Windows mithilfe des nativen Assistenten zum Hinzufügen
von Druckern:“ auf Seite 70 vor.
➤ So installieren Sie den PDF Generator ES-IPP-Client:
1. Vergewissern Sie sich, dass Sie PDF Generator ES ordnungsgemäß auf Ihrem Server installiert haben.
2. Geben Sie auf einem Windows-Clientcomputer folgende URL im Webbrowser ein: Dabei ist [Server]
der Name des Servers, auf dem PDF Generator ES installiert ist, und [Anschluss] der verwendete
Anwendungsserveranschluss:
http://[Server]:[Anschluss]/pdfg-ipp/install
3. Aktivieren Sie im Bildschirm „Internetanschluss konfigurieren“ die Option Angegebenes Benutzerkonto
verwenden und geben Sie die Anmeldeinformationen eines LiveCycle-Benutzers an, der über die Rolle
„PDF Generator-Administrator“ oder „PDF Generator-Benutzer“ verfügt. Dieser Benutzer muss
außerdem eine E-Mail-Adresse besitzen, die zum Empfangen der konvertierten Dateien benötigt wird.
Damit diese Sicherheitseinstellung für alle Benutzer auf dem Clientcomputer gültig ist, aktivieren Sie
Identische Sicherheitsoptionen für alle Benutzer verwenden und klicken dann auf OK.
Nach einer erfolgreichen Installation wird ein Dialogfeld angezeigt, das angibt: „Der Drucker "Adobe
LiveCycle PDF Generator ES" wurde erfolgreich installiert.“
4. Klicken Sie auf OK. In der Liste der verfügbaren Drucker findet sich nun ein Drucker namens
Adobe LiveCycle PDF Generator ES.
➤ So konfigurieren Sie den IPP-Drucker unter Windows mithilfe des nativen Assistenten zum
Hinzufügen von Druckern:
1. Klicken Sie auf Start > Drucker und Faxgeräte und doppelklicken Sie auf Drucker hinzufügen.
2. Klicken Sie auf Weiter, aktivieren Sie die Option Netzwerkdrucker oder Drucker, der an einen
anderen Computer angeschlossen ist und klicken Sie auf Weiter.
3. Aktivieren Sie die Option Verbindung mit einem Drucker im Internet oder Heim-/Firmennetzwerk
herstellen und geben Sie die folgende URL für den IPP-Drucker ein, wobei [Server] der Name des
Servers und [Anschluss] die Anschlussnummer ist, an der der Server ausgeführt wird:
http://[Server]:[Anschluss]/pdfg-ipp/printer
4. Wählen Sie im Bildschirm „Internetanschluss konfigurieren“ die Option Das angegebene
Benutzerkonto verwenden aus und geben Sie gültige User Management-Anmeldeinformationen ein.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Aktivitäten nach der Bereitstellung
Abschließende Einrichtung für LiveCycle Rights Management ES
71
5. Wählen Sie im Feld Druckertreiberauswahl einen PostScript-basierten Standarddruckertreiber aus
(z. B. HP Color LaserJet PS).
6. Schließen Sie die Installation ab, indem Sie geeignete Optionen auswählen (z. B. Einrichten dieses
Druckers als Standarddrucker).
Hinweis: Die beim Hinzufügen des Druckers verwendeten Benutzeranmeldeinformationen müssen
über eine gültige, in User Management konfigurierte E-Mail-ID für den Empfang der Antwort
verfügen.
7. Konfigurieren Sie den sendmail-Dienst des E-Mail-Dienstes. Geben Sie in den Konfigurationsoptionen
des Dienstes einen gültigen SMTP-Server und Authentifizierungsinformationen an.
➤ So installieren und konfigurieren Sie den PDF Generator ES-IPP-Client unter Verwendung
von Proxyserver-Anschlussweiterleitung
1. Konfigurieren Sie die Anschlussweiterleitung auf dem CC-Proxyserver an einem bestimmten Anschluss
an den LiveCycle ES-Server und deaktivieren Sie die Authentifizierung auf Proxyserverebene
(da LiveCycle ES seine eigene Authentifizierung verwendet). Wenn ein Client eine Verbindung mit
diesem Proxyserver am weitergeleiteten Anschluss herstellt, werden alle Anforderungen an den
LiveCycle ES-Server weitergeleitet.
2. Installieren Sie den PDFG-IPP-Drucker unter Verwendung der folgenden URL:
http://[Proxyserver]:[weitergeleiteter Anschluss]/pdfg-ipp/install.
3. Geben Sie die notwendigen Anmeldeinformationen zur Authentifizierung des IPP-Druckers an.
4. Der IPP-Drucker wird auf dem Clientcomputer installiert, den Sie für die PDF-Konvertierung mithilfe
des durch die Firewall geschützten LiveCycle ES-Servers verwenden können.
Abschließende Einrichtung für LiveCycle Rights Management ES
Für Rights Management ES muss der Anwendungsserver für die Verwendung von SSL konfiguriert sein.
(Siehe Verwalten von LiveCycle ES.)
Konfigurieren von LiveCycle ES für den LDAP-Zugriff
Wenn Sie LDAP für LiveCycle 7.x-Produkte konfiguriert haben, werden diese Einstellungen während des
Aktualisierungsprozesses migriert, sodass Sie die Schritte in diesem Abschnitt nicht ausführen müssen.
Wenn Sie LDAP bislang nicht konfiguriert haben, orientieren Sie sich beim Konfigurieren von User
Management für die Unterstützung der Authentifizierung mit LDAP am nachfolgend beschriebenen
Verfahren.
➤ So konfigurieren Sie User Management mit LDAP (Unternehmensdomäne):
1. Öffnen Sie einen Webbrowser, wechseln Sie zu „http://[Hostname]:[Anschluss]/adminui“ und
melden Sie sich an. (Siehe „Zugreifen auf LiveCycle Administration Console“ auf Seite 59.)
2. Klicken Sie auf Einstellungen > User Management > Domänenverwaltung und dann auf Neue
Unternehmensdomäne.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von LiveCycle ES für den LDAP-Zugriff
72
3. Geben Sie in das Feld ID einen eindeutigen Bezeichner für die Domane ein, und in das Feld Name
einen beschreibenden Namen für die Domane.
Hinweis: Bei Verwendung von DB2 als LiveCycle ES-Datenbank beträgt die maximal zulässige Länge
der ID 100 Einzelbyte-Zeichen (ASCII) oder 50 Doppelbyte-Zeichen oder 25 Vierbyte-Zeichen.
(Siehe unter „Hinzufügen von Unternehemensdomänen“ in der User Management-Hilfe.)
Hinweis: Verwenden Sie, wenn Sie MySQL als LiveCycle ES-Datenbank einsetzen, nur EinzelbyteZeichen (ASCII) für die ID. (Siehe „Hinzufügen von Unternehmensdomänen“ in der User
Management-Hilfe.)
4. Klicken Sie auf „Authentifizierung hinzufügen“ und wählen Sie in der Liste „Authentifizierungsanbieter“
den Eintrag „LDAP“ aus.
5. Klicken Sie auf OK.
6. Klicken Sie auf Verzeichnis hinzufügen und geben Sie in das Feld Profilname einen Namen für Ihr
LDAP-Profil ein.
7. Klicken Sie auf Weiter.
8. Geben Sie in den Feldern Server, Anschluss, SSL und Bindung Werte an und wählen Sie im Feld Seite
mit folgenden Elementen fullen eine Verzeichniseinstellungsoption aus, wie z. B. Standardmäßige
Sun ONE-Werte. (Siehe unter „Verzeichniseinstellungen“ in der User Management-Hilfe.)
9. (Optional) Testen Sie die Konfiguration:
●
Klicken Sie auf Testen. Am Bildschirm wird eine Meldung angezeigt, dass ein Servertest erfolgreich
war, oder eine Meldung mit allen Konfigurationsfehlern, die aufgetreten sind.
10. Klicken Sie auf „Weiter“ und konfigurieren Sie die Benutzereinstellungen den Anforderungen
entsprechend. (Siehe unter „Verzeichniseinstellungen“ in der User Management-Hilfe.)
11. (Optional) Testen Sie die Konfiguration:
●
Klicken Sie auf Testen.
●
Überprüfen Sie im Feld „Suchfilter testen“ den Suchfilter oder geben Sie einen neuen Suchfilter an
und klicken Sie dann auf Senden. Am Bildschirm wird eine Liste mit Einträgen angezeigt, die die
Suchkriterien erfüllen.
●
Klicken Sie auf Schließen, um zum Bildschirm Benutzereinstellungen zurückzukehren.
12. Klicken Sie auf „Weiter“ und konfigurieren Sie die Gruppeneinstellungen den Anforderungen
entsprechend. (Siehe unter „Verzeichniseinstellungen“ in der User Management-Hilfe.)
13. (Optional) Testen Sie die Konfiguration:
●
Klicken Sie auf Testen.
●
Überprüfen Sie im Feld „Suchfilter testen“ den Suchfilter oder geben Sie einen neuen Suchfilter an
und klicken Sie dann auf Senden. Am Bildschirm wird eine Liste mit Einträgen angezeigt, die die
Suchkriterien erfüllen.
●
Klicken Sie auf Schließen, um zum Bildschirm Gruppeneinstellungen zurückzukehren.
14. Klicken Sie auf Fertig stellen, um die Seite Neues Verzeichnis zu verlassen, und klicken Sie dann zum
Beenden auf OK.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Festlegen von Leistungsparametern für überwachte Ordner
in PDF Generator ES oder 3D ES
73
➤ So konfigurieren Sie User Management mit LDAP (Lokale Domäne):
1. Öffnen Sie einen Webbrowser, wechseln Sie zu „http://[Hostname]:[Anschluss]/adminui“ und
melden Sie sich an. (Siehe „Zugreifen auf LiveCycle Administration Console“ auf Seite 59.)
2. Klicken Sie auf Einstellungen > User Management > Domänenverwaltung und dann auf Neue
lokale Domäne.
Festlegen von Leistungsparametern für überwachte Ordner
in PDF Generator ES oder 3D ES
Um java.io.IOException-Fehlermeldungen zu vermeiden, die darauf hinweisen, dass nicht
genügend Speicherplatz zur Durchführung von PDF-Konvertierungen mithilfe eines überwachten
Ordners zur Verfügung steht, ändern Sie die Einstellungen für PDF Generator ES oder PDF Generator 3D ES
in LiveCycle Administration Console.
Sie müssen zudem sicherstellen, dass die richtigen Werte für das Transaktionszeitlimit und die
ORB-Dienstwerte festgelegt sind (siehe „Konfigurieren von WebSphere-Zeitlimiteinstellungen“
auf Seite 32).
➤ So legen Sie Leistungsparameter für PDF Generator ES bzw. PDF Generator 3D ES fest:
1. Melden Sie sich bei LiveCycle Administration Console an und klicken Sie auf Dienste > Applications
and Services > Dienstverwaltung.
2. Wechseln Sie in der Liste der Dienste zu PDFGConfigService und legen Sie die folgenden Werte fest:
●
PDFG Cleanup Scan Seconds: 1800
●
Job Expiration Seconds: 6000
●
Server Conversion Timeout: Erhöhen Sie den Standardwert von 270 auf einen höheren Wert
wie etwa 450.
3. Klicken Sie auf „Speichern“ und starten Sie den Server neu.
4. Klicken Sie auf Next und im nächsten Bildschirm auf Advanced Targeting.
5. Wählen Sie im nächsten Bildschirm in der Liste Subdeployments den Eintrag
IDP_JMS_SubDeployment aus.
6. Klicken Sie auf Next und im nächsten Bildschirm auf Advanced Targeting.
7. Wählen Sie im nächsten Bildschirm in der Liste Subdeployments den Eintrag
IDP_JMS_SubDeployment aus.
8. Klicken Sie auf Next und im nächsten Bildschirm auf Advanced Targeting.
9. Wählen Sie im nächsten Bildschirm in der Liste Subdeployments den Eintrag
IDP_JMS_SubDeployment aus.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Aktivitäten nach der Bereitstellung
Aktivieren des FIPS-Modus
74
Aktivieren des FIPS-Modus
LiveCycle ES bietet einen FIPS-Modus, um den Datenschutz auf gemaß FIPS 140-2 (Federal Information
Processing Standard) zugelassene Algorithmen einzuschranken, die das Verschlusselungsmodul
RSA BSAFE Crypto-C 2.1 verwenden.
Wenn Sie diese Option nicht während der LiveCycle ES-Konfiguration mithilfe von LiveCycle Configuration
Manager aktivieren oder die Option aktiviert haben, sie aber deaktivieren möchten, können Sie diese
Einstellung in der LiveCycle Administration Console ändern.
Zum Andern des FIPS-Modus ist ein Neustart des Servers erforderlich.
Im FIPS-Modus werden Acrobat-Versionen vor 7.0 nicht unterstützt. Wenn der FIPS-Modus aktiviert ist und
die Prozesse „Mit Kennwort verschlüsseln“ und „Kennwort entfernen“ die Acrobat-Einstellung „Acrobat 5“
einschließen, schlägt der Prozess fehl.
Im Allgemeinen wendet der Assembler-Dienst bei aktiviertem FIPS keine Kennwortverschlusselung
auf Dokumente an. Wird dies dennoch versucht, wird eine FIPSModeException-Ausnahme ausgelöst,
die angibt, dass „Kennwortverschlüsselung im FIPS-Modus nicht zulässig“ ist. Darüber hinaus wird das
Element PDFsFromBookmarks im FIPS-Modus nicht unterstützt, wenn das Basisdokument
kennwortverschlüsselt ist.
➤ So schalten Sie den FIPS-Modus ein oder aus:
1. Melden Sie sich an der LiveCycle Administration Console an.
2. Klicken Sie auf Einstellungen > Core-System > Core-Konfigurationen > Konfigurationen.
3. Wahlen Sie FIPS aktivieren, um den FIPS-Modus zu aktivieren, oder deaktivieren Sie es zum
Deaktivieren des FIPS-Modus.
4. Klicken Sie auf OK und starten Sie den Anwendungsserver neu.
Hinweis: Die LiveCycle ES-Software uberpruft Code nicht auf FIPS-Kompatibilitat. Sie bietet einen
FIPS-Betriebsmodus, sodass gemaß FIPS zugelassene Algorithmen für Kryptographiedienste
aus den FIPS-zugelassenen Bibliotheken (RSA) verwendet werden.
Konfigurieren von Einstellungen für eine digitale HTML-Signatur
Um die digitale HTML-Signaturfunktion von Forms ES verwenden zu können, führen Sie das folgende
verfahren aus.
➤ So aktivieren Sie die digitale HTML-Signatur:
1. Stellen Sie die Datei „[LiveCycle ES-Stammverzeichnis]/deploy/adobe-forms-ds.ear“ auf Ihrem
Anwendungsserver bereit.
2. Melden Sie sich bei LiveCycle Administration Console an und klicken Sie auf Dienste > LiveCycle
Forms ES.
3. Wählen Sie Digitale HTML-Signatur aktiviert aus und klicken Sie auf Speichern.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Document Management-Dienstes
für LiveCycle Content Services ES
75
Konfigurieren des Document Management-Dienstes
für LiveCycle Content Services ES
Wenn Sie Content Services ES installiert haben und Ihr Anwendungsserver an einem nicht standardmäßigen
Anschluss ausgeführt wird (d. h. einem anderen Anschluss als 9080 in WebSphere), müssen Sie den vom
Document Management-Dienst verwendeten Anschluss ändern.
➤ So ändern Sie den Anschluss:
1. Melden Sie sich bei LiveCycle Administration Console an und klicken Sie auf Dienste > Applications
and Services > Dienstverwaltung.
2. Wählen Sie in der Liste den Eintrag DocumentManagementService aus.
3. Auf der Registerkarte Configuration im Feld HTTP Port legen Sie die von Ihnen verwendete
Anschlussnummer fest und klicken auf Save.
Konfigurieren des Connector for EMC Documentum-Dienstes
Wenn der Connector for EMC Documentum-Dienst als Teil Ihrer LiveCycle ES-Losung installiert wurde,
fuhren Sie das folgende Verfahren aus, um den Dienst für das Herstellen einer Verbindung mit dem
Documentum-Repository zu konfigurieren.
➤ So konfigurieren Sie Connector for EMC Documentum:
1. Suchen Sie die Datei adobe-component-ext.properties im Ordner
[WAS-STAMMVERZEICHNIS]/AppsServer/profiles/[Profilname] (Wenn die Datei nicht vorhanden ist,
erstellen Sie sie).
2. Fügen Sie eine neue Systemeigenschaft hinzu, die die folgenden JAR-Dateien der Documentum
Foundation Classes angibt (und nur für Connector for EMC Documentum 5.3 den Speicherort des
Documentum Content Server-Konfigurationsordners):
●
dfc.jar
●
(Connector for EMC Documentum 5.3) dfcbase.jar
●
(Connector for EMC Documentum 6.0) aspectjrt.jar
●
log4j.jar
Die neue Systemeigenschaft muss folgendes Format haben:
[Komponenten-ID].ext=[JAR-Dateien und/oder -Ordner]
Bei Verwendung von Standardinstallationen von Content Server und Documentum Foundation
Classes fügen Sie der Datei beispielsweise folgende Systemeigenschaft in einer neuen Zeile ohne
Zeilenwechsel hinzu und schließen die Zeile mit einem Zeilenumbruch ab:
●
Nur Connector for EMC Documentum 5.3:
com.adobe.livecycle.ConnectorforEMCDocumentum.ext=
C:/Documentum/Config,
C:/Programme/Documentum/Shared/dfc.jar,
C:/Programme/Documentum/Shared/dfcbase.jar,
C:/Programme/Documentum/Shared/log4j.jar
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
●
Konfigurieren des Connector for EMC Documentum-Dienstes
76
Nur Connector for EMC Documentum 6.0 :
com.adobe.livecycle.ConnectorforEMCDocumentum.ext=
C:/Programme/Documentum/Shared/dfc.jar,
C:/Programme/Documentum/Shared/aspectjrt.jar,
C:/Programme/Documentum/Shared/log4j.jar
Hinweis: Der vorangehende Text enthält Formatierungszeichen für Zeilenwechsel. Wenn dieser Text
kopiert und eingefügt wird, müssen die Formatierungszeichen entfernt werden.
3. (Nur Connector for EMC Documentum 6.0) Löschen Sie die Datei „dfc.keystore“ im Verzeichnis
C:\Documentum\config.
Hinweis: Dieser Schritt ist erforderlich aufgrund inkompatibler JDK-Anforderungen für WebSphere
und Documentum Foundation Classes von EMC Documentum 6.0.
4. Wenn WebSphere Application Server aktuell nicht ausgeführt wird, starten Sie den Server. Beenden Sie
andernfalls den Serverdienst, und starten Sie ihn erneut.
5. Offnen Sie einen Webbrowser und geben Sie diese URL ein:
http://localhost:9080/adminui (lokale Bereitstellung unter Verwendung des Standardanschlusses)
6. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
7. Navigieren Sie zu Dienste > LiveCycle ES Connector for EMC Documentum >
Konfigurationseinstellungen und führen Sie folgende Aufgaben aus:
●
Geben Sie alle erforderlichen Documentum-Repository-Informationen ein.
●
Zur Verwendung von Documentum als Repository Provider aktivieren Sie unter Repository
Service Provider-Informationen den Eintrag EMC Documentum Repository Provider und
klicken dann auf Speichern. (Weitere Informationen erhalten Sie, wenn Sie rechts oben in der
EMC Documentum-Hilfe auf die „Hilfe“-Verknüpfung klicken.)
8. (Optional) Wechseln Sie zu Dienste > LiveCycle ES Connector for EMC Documentum >
Einstellungen für Repository-Anmeldeinformationen, klicken Sie auf Hinzufügen, geben Sie die
Docbase-Informationen an und klicken Sie auf Speichern. (Weitere Informationen erhalten Sie,
wenn Sie rechts oben auf die Hilfe-Verknüpfung klicken.)
9. Wechseln Sie zu Dienste > Applications and Services > Dienstverwaltung und wählen Sie die
folgenden Dienste aus:
●
EMCDocumentumAuthProviderService
●
EMCDocumentumContentRepositoryConnector
●
EMCDocumentumRepositoryProvider
10. Klicken Sie auf Start. Wenn einer der Dienste nicht ordnungsgemäß gestartet wird, überprüfen Sie
die in Schritt 7 eingegebenen Einstellungen.
11. Fuhren Sie eine der folgenden Aufgaben aus:
●
Um mit dem Documentum Authorization-Dienst (EMCDocumentumAuthProviderService)
Inhalte eines Documentum-Repositorys in der Ansicht „Ressourcen“ von Workbench ES
anzuzeigen, fahren Sie mit diesem Verfahren fort. Beim Verwenden des Documentum-
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connector for EMC Documentum-Dienstes
77
Autorisierungsdiensts wird die standardmäßige LiveCycle ES-Autorisierung außer Kraft
gesetzt. Der Documentum-Autorisierungsdienst muss für die Anmeldung bei Workbench ES
mit Documentum-Anmeldeinformationen konfiguriert werden.
●
Melden Sie sich zur Verwendung des LiveCycle ES-Repositorys mit den LiveCycle ESSuperadministrator-Anmeldeinformationen (standardmäßig Administrator und password)
bei Workbench ES an.
Sie haben die für dieses Verfahren erforderlichen Schritte abgeschlossen. Verwenden Sie die
in Schritt 7 angegebenen Anmeldeinformationen sowie den standardmäßigen LiveCycle ESAutorisierungsdienst für den Zugriff auf das Standard-Repository.
12. Starten Sie WebSphere Application Server neu.
13. Melden Sie sich bei der LiveCycle Administration Console an und klicken Sie auf Einstellungen >
User Management > Domänenverwaltung.
14. Klicken Sie auf Neue Unternehmensdomäne und geben Sie eine ID und einen Namen für die
Domäne ein. Die Domanen-ID ist der eindeutige Bezeichner der Domane. Der Name ist eine
beschreibende Bezeichnung der Domane.
Hinweis: Bei Verwendung von DB2 als LiveCycle ES-Datenbank beträgt die maximal zulässige Länge
der ID 100 Einzelbyte-Zeichen (ASCII) oder 50 Doppelbyte-Zeichen oder 25 Vierbyte-Zeichen.
(Siehe unter „Hinzufügen von Unternehemensdomänen“ in der User Management-Hilfe.)
Hinweis: Verwenden Sie, wenn Sie MySQL als LiveCycle ES-Datenbank einsetzen,
nur Einzelbyte-Zeichen (ASCII) für die ID. (Siehe „Hinzufügen von Unternehmensdomänen“
in der User Management-Hilfe.)
15. Fugen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie Benutzerdefiniert in der Liste Authentifizierungsanbieter aus.
●
Wählen Sie EMCDocumentumAuthProvider und klicken Sie auf OK.
16. Fugen Sie einen LDAP-Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie in der Liste Authentifizierungsanbieter den Eintrag LDAP aus und klicken Sie auf OK.
17. Fugen Sie ein LDAP-Verzeichnis hinzu:
●
Klicken Sie auf Verzeichnis hinzufugen.
●
Geben Sie in das Feld Profilname eine eindeutige Zeichenfolge ein und klicken Sie auf Weiter.
●
Geben Sie für die Optionen Server, Anschluss, SSL und Bindung und Seite mit folgenden
Elementen fullen Werte an. Wenn Sie als Option Bindung den Wert User wahlen, mussen Sie
ebenfalls Werte für die Felder Name und Kennwort angeben.
●
(Optional) Wahlen Sie Basis-DNs abrufen, um erforderlichenfalls Basisdomanennamen abzurufen.
●
Klicken Sie auf Weiter, konfigurieren Sie die Benutzereinstellungen, klicken Sie auf Weiter,
konfigurieren Sie Gruppeneinstellungen wie erforderlich und klicken Sie auf Weiter.
Detailinformationen zu den Einstellungen erhalten Sie, wenn Sie rechts oben auf der Seite auf User
Management-Hilfe klicken.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Erstellen des XDP MIME-Formats im Documentum-Repository
78
18. Klicken Sie auf OK, um die Seite Verzeichnis hinzufügen zu verlassen, und klicken Sie zum Beenden
erneut auf OK.
19. Wahlen Sie die neue Unternehmensdomane aus und klicken Sie auf Jetzt synchronisieren.
In Abhangigkeit von der in Ihrem LDAP-Netzwerk vorhandenen Anzahl von Benutzern und
Gruppen sowie der Geschwindigkeit der Verbindung kann der Synchronisierungsprozess einige
Minuten in Anspruch nehmen.
(Optional) Klicken Sie zum Überprüfen des Synchronisierungsstatus auf Aktualisieren. Der Status wird
in der Spalte Aktueller Synchronisierungsstatus angezeigt.
20. Wechseln Sie zu Einstellungen > User Management > Benutzer und Gruppen.
21. Suchen Sie nach Benutzern, die aus LDAP synchronisiert wurden, und führen Sie die folgenden
Aufgaben durch:
●
Wählen Sie mindestens einen Benutzer aus und klicken Sie auf Rolle zuweisen.
●
Wählen Sie mindestens eine LiveCycle ES-Rolle aus und klicken Sie auf OK.
●
Klicken Sie ein weiteres Mal auf OK, um die Rollenzuweisung zu bestatigen.
Wiederholen Sie diesen Schritt für alle Benutzer, denen Sie Rollen zuweisen möchten. Weitere
Informationen erhalten Sie, wenn Sie rechts oben auf der Seite auf den User Management-Hilfe-Link
klicken.
22. Starten Sie Workbench ES und melden Sie sich mit den folgenden Anmeldeinformationen an:
Benutzername: [benutzername]@[repository_name]
Kennwort: [password]
Das Documentum-Repository sollte jetzt in der Ansicht „Ressourcen“ in der Workbench ES angezeigt
werden. Wenn Sie sich nicht unter Verwendung von Benutzername@Repository-Name anmelden,
versucht Workbench ES eine Anmeldung bei dem in Schritt 7 angegebenen Standardrepository.
23. (Optional) Wenn Sie die LiveCycle ES Samples für Connector for EMC Documentum installieren
möchten, erstellen Sie ein Documentum-Repository namens Samples und installieren dann die
Beispiele in dieses Repository.
Nachdem Sie den Connector for EMC Documentum-Dienst konfiguriert haben, empfiehlt es sich,
in Verwalten von LiveCycle ES Informationen zum ordnungsgemäßen Konfigurieren von Workbench ESFunktionen mit dem Documentum-Repository nachzulesen.
Erstellen des XDP MIME-Formats im Documentum-Repository
Damit Benutzer XDP-Dateien in einem Documentum-Repository speichern und daraus abrufen konnen,
mussen Sie eine dieser Aufgaben ausfuhren:
●
Ein entsprechendes XDP-Format in jedem Repository erstellen, in dem Benutzer auf XDP-Dateien
zugreifen sollen.
●
Den Connector for EMC Documentum-Dienst für die Verwendung eines Documentum AdministratorKontos zum Zugriff auf das Documentum-Repository konfigurieren. In diesem Fall wird das XDP-Format
vom Connector for EMC Documentum-Dienst jedes Mal verwendet, wenn es erforderlich ist.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Erstellen des XDP MIME-Formats im Documentum-Repository
79
➤ So erstellen Sie das XDP-Format auf dem Documentum Content Server mithilfe von Documentum
Administrator:
1. Melden Sie sich an Documentum Administrator an.
2. Klicken Sie auf Formate und wählen Sie Datei > Neu > Format.
3. Geben Sie die folgenden Informationen in die entsprechenden Felder ein:
Name: xdp
Standard-Dateierweiterung: xdp
Mime-Typ: application/xdp
4. Wiederholen Sie die Schritte 1 bis 3 für alle anderen Documentum-Repositorys, in denen von
Benutzern XDP-Dateien gespeichert werden.
➤ So konfigurieren Sie den Connector for EMC Documentum-Dienst für die Verwendung eines
Documentum Administrator:
1. Öffnen Sie einen Webbrowser und geben Sie diesen URL ein:
http://localhost:[Anschluss]/adminui (lokale Bereitstellung unter Verwendung des
Standardanschlusses)
2. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
3. Klicken Sie auf Dienste > LiveCycle ES Connector for EMC Documentum >
Konfigurationseinstellungen.
4. Aktualisieren Sie unter Documentum-Prinzipalanmeldeinformationen die folgenden Informationen
und klicken Sie auf Speichern:
Benutzername: [Documentum-Administrator-Benutzername]
Kennwort: [Documentum-Administrator-Kennwort]
5. Klicken Sie auf Einstellungen für Repository-Anmeldeinformationen und wählen Sie ein Repository
in der Liste aus, bzw. klicken Sie auf Hinzufügen, wenn keines vorhanden ist.
6. Geben Sie die gewünschten Informationen in die entsprechenden Felder ein und klicken Sie auf
Speichern:
Repository-Name: [Repository-Name]
Repository-Anmeldeinformationen-Benutzername: [Documentum-Administrator-Benutzername]
Repository-Anmeldeinformationen-Kennwort: [Documentum-Administrator-Kennwort]
7. Wiederholen Sie die Schritte 5 bis 6 für alle anderen Repositorys, in denen von Benutzern XDP-Dateien
gespeichert werden.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connector for IBM FileNet-Dienstes
80
Konfigurieren des Connector for IBM FileNet-Dienstes
Wenn der Connector for IBM FileNet-Dienst als Teil Ihrer LiveCycle ES-Losung installiert wurde, müssen Sie
den Dienst für das Herstellen einer Verbindung mit dem FileNet-Objektspeicher konfigurieren. Lesen Sie
in Abhängigkeit von Ihrer Version von IBM FileNet in einem der folgenden Abschnitte nach:
●
„Konfigurieren des Connectors, der FileNet 3.5 verwendet“ auf Seite 80
●
„Konfigurieren des Connectors, der FileNet 4.0.1 verwendet“ auf Seite 83
Konfigurieren des Connectors, der FileNet 3.5 verwendet
Führen Sie folgendes Verfahren aus, um den Connector for IBM FileNet-Dienst, der FileNet 3.5 verwendet,
zu konfigurieren.
➤ So konfigurieren Sie den Connector, der FileNet 3.5 verwendet:
1. Suchen Sie die Datei „adobe-component-ext.properties“ im Ordner
[Anwendungsserver-Stammverzeichnis]/profiles/[Profilname] (erstellen Sie die Datei, wenn Sie nicht
vorhanden sein sollte)
2. Fügen Sie eine neue Systemeigenschaft hinzu, die den Speicherort der folgenden JAR-Dateien des
FileNet-Anwendungsmoduls angibt:
●
activation.jar
●
javaapi.jar
●
log4j-1.2.8.jar
●
mailapi.jar
●
p8cjares.jar
●
soap.jar
●
xercesimpl.jar
●
xml-apis.jar
●
(optional) pe.jar
Hinweis: Fügen Sie die Datei pe.jar nur hinzu, wenn Ihre Bereitstellung den
IBMFileNetProcessEngineConnector-Dienst verwendet. Die neue
Systemeigenschaft sollte diese Struktur aufweisen:
[Komponenten-ID].ext=[JAR-Dateien und/oder -Ordner]
Beispielsweise kann ausgehend von der Standardinstallation des FileNet-Anwendungsmoduls unter
einem Windows-Betriebssystem der Datei die folgende Systemeigenschaft in einer neuen Zeile
hinzugefügt werden – es dürfen keine Zeilenumbrüche verwendet und die Zeile muss mit einem
Wagenrücklauf abgeschlossen werden:
Hinweis: Der folgende Text enthält Formatierungszeichen für Zeilenwechsel. Wenn dieser Text an eine
Stelle außerhalb dieses Dokuments kopiert wird, entfernen Sie die Formatierungszeichen,
wenn der Text an der neuen Stelle eingefügt werden.
com.adobe.livecycle.ConnectorforIBMFileNet.ext=
C:/Programme/FileNet/lib2/activation.jar,
C:/Programme/FileNet/lib2/javaapi.jar,
C:/Programme/FileNet/lib2/log4j-1.2.8.jar,
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 3.5 verwendet
81
C:/Programme/FileNet/lib2/mailapi.jar,
C:/Programme/FileNet/lib2/p8cjares.jar,
C:/Programme/FileNet/lib2/soap.jar,
C:/Programme/FileNet/lib2/xercesImpl.jar,
C:/Programme/FileNet/lib2/xml-apis.jar,
C:/Programme/FileNet/lib2/pe.jar
Hinweis: Fügen Sie den Text C:/Programme/FileNet/lib2/pe.jar nur hinzu, wenn Ihre
Bereitstellung den IBMFileNetProcessEngineConnector-Dienst verwendet.
3. Wenn WebSphere Application Server aktuell nicht ausgeführt wird, starten Sie den Server. Beenden Sie
andernfalls den Serverdienst, und starten Sie ihn erneut.
4. Offnen Sie einen Webbrowser und geben Sie diese URL ein:
http://localhost:9080/adminui (lokale Bereitstellung unter Verwendung des Standardanschlusses)
5. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
6. Klicken Sie auf Dienste > LiveCycle ES Connector for IBM FileNet.
7. Geben Sie alle erforderlichen FileNet-Repository-Informationen ein und wählen Sie unter Repository
Service Provider-Informationen den Eintrag IBM FileNet Repository Provider aus.
Wenn Ihre Bereitstellung den optionalen Prozess-Engine-Dienst verwendet, aktivieren Sie unter
Prozess-Engine-Einstellungen die Option Prozess-Engine-Connectordienst verwenden und
geben die Prozess-Engine-Einstellungen an. Weitere Informationen erhalten Sie, wenn Sie rechts
oben auf der Seite auf den Hilfe-Link klicken.
Hinweis: Die während dieses Schrittes angegebenen Anmeldeinformationen werden später überprüft,
wenn die IBM FileNet-Repository-Dienste gestartet werden. Wenn sie ungültig sind, wird ein
Fehler erzeugt und die Dienste werden nicht gestartet.
8. Klicken Sie auf Speichern und wechseln Sie dann zu Dienste > Applications and Services >
Dienstverwaltung.
9. Aktivieren Sie das Kontrollkästchen neben jedem der folgenden Dienste und klicken Sie dann auf
Starten:
●
IBMFileNetAuthProviderService
●
IBMFileNetContentRepositoryConnector
●
IBMFileNetRepositoryProvider
●
IBMFileNetProcessEngineConnector (falls konfiguriert)
Wenn einer der Dienste nicht ordnungsgemäß gestartet wird, überprüfen Sie die in Schritt 7
eingegebenen Einstellungen.
10. Fuhren Sie eine der folgenden Aufgaben aus:
●
Um mit dem FileNet Authorization-Dienst (IBMFileNetAuthProviderService) Inhalte eines FileNetObjektspeichers in der Ansicht „Ressourcen“ von Workbench ES anzuzeigen, fahren Sie mit diesem
Verfahren fort. Beim Verwenden des FileNet-Autorisierungsdienstes wird die standardmäßige
LiveCycle ES-Autorisierung außer Kraft gesetzt. Der FileNet-Autorisierungsdienst muss für die
Anmeldung bei Workbench ES mit FileNet-Anmeldeinformationen konfiguriert werden.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
●
Konfigurieren des Connectors, der FileNet 3.5 verwendet
82
Melden Sie sich zur Verwendung des LiveCycle ES-Repositorys mit den LiveCycle ESSuperadministrator-Anmeldeinformationen (standardmäßig Administrator und password)
bei Workbench ES an. Die in Schritt 7 angegebenen Anmeldeinformationen verwenden
in diesem Fall den standardmäßigen LiveCycle ES-Autorisierungsdienst für den Zugriff
auf das Standard-Repository.
11. Starten WebSphere Application Server.
12. Melden Sie sich an der LiveCycle Administration Console an und wechseln Sie zu Einstellungen >
User Management > Domänenverwaltung.
13. Klicken Sie auf Neue Unternehmensdomäne und geben Sie eine ID und einen Namen für die
Domäne ein. Die Domanen-ID ist der eindeutige Bezeichner der Domane. Der Name ist eine
beschreibende Bezeichnung der Domane.
Hinweis: Bei Verwendung von DB2 als LiveCycle ES-Datenbank beträgt die maximal zulässige Länge
der ID 100 Einzelbyte-Zeichen (ASCII) oder 50 Doppelbyte-Zeichen oder 25 Vierbyte-Zeichen.
(Siehe unter „Hinzufügen von Unternehemensdomänen“ in der User Management-Hilfe.)
Hinweis: Verwenden Sie, wenn Sie MySQL als LiveCycle ES-Datenbank einsetzen,
nur Einzelbyte-Zeichen (ASCII) für die ID. (Siehe „Hinzufügen von Unternehmensdomänen“
in der User Management-Hilfe.)
14. Fugen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie Benutzerdefiniert in der Liste Authentifizierungsanbieter aus.
●
Klicken Sie auf IBMFileNetAuthProviderService und dann auf OK.
15. Fugen Sie einen LDAP-Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie in der Liste Authentifizierungsanbieter den Eintrag LDAP aus und klicken Sie auf OK.
16. Fugen Sie ein LDAP-Verzeichnis hinzu:
●
Klicken Sie auf Verzeichnis hinzufugen.
●
Geben Sie in das Feld Profilname eine eindeutige Zeichenfolge ein und klicken Sie auf Weiter.
●
Geben Sie für die Optionen Server, Anschluss, SSL und Bindung und Seite mit folgenden
Elementen fullen Werte an. Wenn Sie als Option Bindung den Wert User wahlen, mussen Sie
ebenfalls Werte für die Felder Name und Kennwort angeben.
●
(Optional) Wahlen Sie Basis-DNs abrufen, um erforderlichenfalls Basisdomanennamen abzurufen.
Wenn Sie fertig sind, klicken Sie auf Weiter.
●
Konfigurieren Sie die Benutzereinstellungen, klicken Sie auf Weiter, konfigurieren Sie gegebenenfalls
Gruppeneinstellungen und klicken Sie auf Weiter.
Detailinformationen zu den Einstellungen erhalten Sie, wenn Sie rechts oben auf der Seite auf den
Hilfe-Link klicken.
17. Klicken Sie auf OK, um die Seite Verzeichnis hinzufügen zu verlassen, und klicken Sie zum Beenden
erneut auf OK.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
83
18. Wahlen Sie die neue Unternehmensdomane aus und klicken Sie auf Jetzt synchronisieren.
In Abhangigkeit von der in Ihrem LDAP-Netzwerk vorhandenen Anzahl von Benutzern und Gruppen
sowie der Geschwindigkeit der Verbindung kann der Synchronisierungsprozess einige Minuten
in Anspruch nehmen.
(Optional) Klicken Sie zum Überprüfen des Synchronisierungsstatus auf Aktualisieren. Der Status wird
in der Spalte Aktueller Synchronisierungsstatus angezeigt.
19. Wechseln Sie zu Einstellungen > User Management > Benutzer und Gruppen.
20. Suchen Sie nach Benutzern, die aus LDAP synchronisiert wurden, und führen Sie die folgenden
Aufgaben durch:
●
Wählen Sie mindestens einen Benutzer aus und klicken Sie auf Rolle zuweisen.
●
Wählen Sie mindestens eine LiveCycle ES-Rolle aus und klicken Sie auf OK.
●
Klicken Sie ein weiteres Mal auf OK, um die Rollenzuweisung zu bestatigen.
Wiederholen Sie diesen Schritt für alle Benutzer, denen Sie Rollen zuweisen möchten. Weitere
Informationen erhalten Sie, wenn Sie rechts oben auf der Seite auf den Hilfe-Link klicken.
21. Starten Sie die Workbench ES und melden Sie sich mithilfe der folgenden Anmeldeinformationen an:
Benutzername: [benutzername]@[repository_name]
Kennwort: [password]
Der FileNet-Objektspeicher sollte jetzt in der Ansicht „Ressourcen“ in der Workbench ES angezeigt
werden. Wenn Sie sich nicht mithilfe von Benutzername@Repository-Name anmelden, versucht
Workbench ES eine Anmeldung beim in Schritt 7 angegebenen Standard-Repository.
22. (Optional) Wenn Sie die LiveCycle ES-Beispiele für Connector for IBM FileNet installieren möchten,
erstellen Sie einen FileNet-Objektspeicher namens Samples und installieren dann die Beispiele
in diesen Objektspeicher.
Nachdem Sie den Connector for IBM FileNet-Dienst konfiguriert haben, empfiehlt es sich, in Verwalten
von LiveCycle ES Informationen zum ordnungsgemäßen Konfigurieren von Workbench ES-Funktionen
mit dem FileNet-Repository nachzulesen.
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
Führen Sie folgendes Verfahren aus, um den Connector for IBM FileNet-Dienst, der FileNet 4.0.1
verwendet, zu konfigurieren.
➤ So konfigurieren Sie den Connector, der FileNet 4.0.1 und den CEWS-Transport verwendet:
1. Melden Sie sich an der WebSphere Administrative Console an, klicken Sie auf Servers > Application
servers und klicken Sie auf den Namen der Serverinstanz, die Sie konfigurieren möchten
(z. B. „server1“).
2. Klicken Sie unter Server Infrastructure auf Java and Process Management > Process Definition.
3. Klicken Sie unter Additional Properties auf Java Virtual Machine.
4. Fügen Sie unter „Generic JVM arguments“ den Speicherort der FileNet-Konfigurationsdateien dem
Startbefehl des Anwendungsservers als Java-Option hinzu:
-Dwasp.location=/<Speicherort der Konfigurationsdateien>
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
84
Fügen Sie beispielsweise bei Verwendung einer Standardinstallation des FileNet-Anwendungsmoduls
unter einem Windows-Betriebssystem folgende Java-Option hinzu:
-Dwasp.location=C:/Progra~1/FileNet/AE/CE_API/wsi
5. Klicken Sie auf Apply und dann auf Save to Master Configuration.
6. Suchen Sie die Datei „adobe-component-ext.properties“ im Ordner
[Anwendungsserver-Stammverzeichnis]/profiles/[Profilname] (wenn die Datei nicht vorhanden ist,
erstellen Sie sie)..
7. Fügen Sie eine neue Systemeigenschaft hinzu, die den Speicherort dieser JAR-Dateien des
FileNet-Anwendungsmoduls angibt:
●
javaapi.jar
●
log4j-1.2.13.jar
●
soap.jar
●
wasp.jar
●
builtin_serialization.jar
●
wsdl_api.jar
●
jaxm.jar
●
jaxrpc.jar
●
saaj.jar
●
jetty.jar
●
runner.jar
●
p8cjares.jar
●
Jace.jar
●
(optional) pe.jar
Hinweis: Fügen Sie die Datei pe.jar nur hinzu, wenn Ihre Bereitstellung den
IBMFileNetProcessEngineConnector-Dienst verwendet. Die neue
Systemeigenschaft sollte diese Struktur aufweisen:
[Komponenten-ID].ext=[JAR-Dateien und/oder -Ordner]
Beispielsweise kann ausgehend von der Standardinstallation des FileNet-Anwendungsmoduls unter
einem Windows-Betriebssystem der Datei die folgende Systemeigenschaft in einer neuen Zeile
hinzugefügt werden – es dürfen keine Zeilenumbrüche verwendet und die Zeile muss mit einem
Wagenrücklauf abgeschlossen werden:
Hinweis: Der folgende Text enthält Formatierungszeichen für Zeilenwechsel. Wenn dieser Text an eine
Stelle außerhalb dieses Dokuments kopiert wird, entfernen Sie die Formatierungszeichen,
wenn der Text an der neuen Stelle eingefügt werden.
com.adobe.livecycle.ConnectorforIBMFileNet.ext=
C:/Programme/FileNet/AE/CE_API/lib2/javaapi.jar,
C:/Programme/FileNet/AE/CE_API/lib2/log4j-1.2.13.jar,
C:/Programme/FileNet/AE/Workplace/WEB-INF/lib/soap.jar,
C:/Programme/FileNet/AE/CE_API/wsi/lib/wasp.jar,
C:/Programme/FileNet/AE/CE_API/wsi/lib/builtin_serialization.jar,
C:/Programme/FileNet/AE/CE_API/wsi/lib/wsdl_api.jar,
C:/Programme/FileNet/AE/CE_API/wsi/lib/jaxm.jar,
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
85
C:/Programme/FileNet/AE/CE_API/wsi/lib/jaxrpc.jar,
C:/Programme/FileNet/AE/CE_API/wsi/lib/saaj.jar,
C:/Programme/FileNet/AE/CE_API/wsi/lib/jetty.jar,
C:/Programme/FileNet/AE/CE_API/wsi/lib/runner.jar,
C:/Programme/FileNet/AE/CE_API/lib2/p8cjares.jar,
C:/Programme/FileNet/AE/CE_API/lib/Jace.jar,
C:/Programme/FileNet/AE/Workplace/WEB-INF/lib/pe.jar
Hinweis: Fügen Sie C:/Programme/FileNet/AE/Workplace/WEB-INF/lib/pe.jar nur hinzu,
wenn Ihre Bereitstellung den IBMFileNetProcessEngineConnector-Dienst verwendet.
8. (Nur für FileNet-Prozess-Engine-Connector) Erstellen Sie mithilfe eines Texteditors eine Datei mit
folgendem Inhalt in einer einzigen Zeile, die mit einem Wagenrücklauf abgeschlossen werden muss:
RemoteServerUrl = cemp:http://[contentserver_IP]:
[contentengine_Anschluss]/wsi/FNCEWS40DIME/
9. Speichern Sie die Datei in einem gesonderten Ordner unter „WCMApiConfig.properties“ und
fügen Sie den Speicherort des Ordners mit der Datei „WCMApiConfig.properties“ der Datei
„adobe-component-ext.properties“ hinzu.
Wenn Sie beispielsweise die Datei als „c:/pe_config/WCMApiConfig.properties“ speichern, fügen Sie
den Pfad „c:/pe_config“ in der Datei „adobe-component-ext.properties“ hinzu.
10. Suchen Sie die Datei „wsjaas.conf“ und fügen Sie die folgenden Zeilen hinzu:
FileNetP8 {com.filenet.api.util.WSILoginModule required;};
FileNetP8WSI {com.filenet.api.util.WSILoginModule required;};
FileNetP8Engine
{com.ibm.ws.security.common.auth.module.proxy.WSLoginModuleProxy
required delegate=com.ibm.ws.security.common.auth.module.
WSLoginModuleImpl;};
FileNetP8Server
{com.ibm.ws.security.common.auth.module.proxy.WSLoginModuleProxy
required delegate=com.ibm.ws.security.common.auth.module.
WSLoginModuleImpl;};
FileNetP8KerberosService
{com.ibm.ws.security.common.auth.module.proxy.WSLoginModuleProxy
required delegate=com.filenet.engine.authentication.kerberos.login.
KrbServiceLoginModule;
com.ibm.ws.security.common.auth.module.proxy.WSLoginModuleProxy required
delegate=com.ibm.ws.security.server.lm.ltpaLoginModule;
com.ibm.ws.security.common.auth.module.proxy.WSLoginModuleProxy required
delegate=com.ibm.ws.security.server.lm.
wsMapDefaultInboundLoginModule;}
Hinweis: Die Datei „wsjaas.conf“ befindet sich standardmäßig im Ordner
„[Anwendungsserver-Stammverzeichnis]/profiles/[Profilname]/properties/".
11. Wenn WebSphere Application Server aktuell nicht ausgeführt wird, starten Sie den Server. Beenden Sie
andernfalls den Server und starten Sie ihn neu.
12. Offnen Sie einen Webbrowser und geben Sie diese URL ein:
http://localhost:9080/adminui (lokale Bereitstellung unter Verwendung des Standardanschlusses)
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
86
13. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
14. Klicken Sie auf Dienste > LiveCycle ES Connector for IBM FileNet.
15. Geben Sie alle erforderlichen FileNet-Repository-Informationen ein und wählen Sie unter Repository
Service Provider-Informationen den Eintrag IBM FileNet Repository Provider aus.
Wenn Ihre Bereitstellung den optionalen Prozess-Engine-Dienst verwendet, aktivieren Sie unter
Prozess-Engine-Einstellungen die Option Prozess-Engine-Connectordienst verwenden und
geben die Prozess-Engine-Einstellungen an. Weitere Informationen erhalten Sie, wenn Sie rechts
oben auf der Seite auf den Hilfe-Link klicken.
Hinweis: Die in diesem Schritt angegebenen Anmeldeinformationen werden später überprüft,
wenn die IBM FileNet-Repository-Dienste gestartet werden. Wenn sie ungültig sind,
wird ein Fehler erzeugt und die Dienste werden nicht gestartet.
16. Klicken Sie auf Speichern und wechseln Sie dann zu Dienste > Applications and Services >
Dienstverwaltung.
17. Aktivieren Sie das Kontrollkästchen neben den folgenden Diensten und klicken Sie auf Starten:
●
IBMFileNetAuthProviderService
●
IBMFileNetContentRepositoryConnector
●
IBMFileNetRepositoryProvider
●
IBMFileNetProcessEngineConnector (falls konfiguriert)
Wenn einer der Dienste nicht ordnungsgemäß gestartet wird, überprüfen Sie die in Schritt 15
eingegebenen Einstellungen.
18. Fuhren Sie eine der folgenden Aufgaben aus:
●
Um mit dem FileNet Authorization-Dienst (IBMFileNetAuthProviderService) Inhalte eines
FileNet-Objektspeichers in der Ansicht „Ressourcen“ von Workbench ES anzuzeigen,
fahren Sie mit diesem Verfahren fort. Beim Verwenden des FileNet-Autorisierungsdienstes wird die
standardmäßige LiveCycle ES-Autorisierung außer Kraft gesetzt. Der FileNet-Autorisierungsdienst
muss für die Anmeldung bei Workbench ES mit FileNet-Anmeldeinformationen konfiguriert
werden.
●
Melden Sie sich zur Verwendung des LiveCycle ES-Repositorys mit den LiveCycle ESSuperadministrator-Anmeldeinformationen (standardmäßig Administrator und password)
bei Workbench ES an. Die in Schritt 15 angegebenen Anmeldeinformationen verwenden
in diesem Fall den standardmäßigen LiveCycle ES-Autorisierungsdienst für den Zugriff
auf das Standard-Repository.
19. Starten WebSphere Application Server.
20. Melden Sie sich an der LiveCycle Administration Console an und wechseln Sie zu Einstellungen >
User Management > Domänenverwaltung.
21. Klicken Sie auf Neue Unternehmensdomäne und geben Sie eine ID und einen Namen für die Domäne
ein. Die Domanen-ID ist der eindeutige Bezeichner der Domane. Der Name ist eine beschreibende
Bezeichnung der Domane.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
87
Hinweis: Bei Verwendung von DB2 als LiveCycle ES-Datenbank beträgt die maximal zulässige Länge
der ID 100 Einzelbyte-Zeichen (ASCII) oder 50 Doppelbyte-Zeichen oder 25 Vierbyte-Zeichen.
(Siehe unter „Hinzufügen von Unternehemensdomänen“ in der User Management-Hilfe.)
Hinweis: Verwenden Sie, wenn Sie MySQL als LiveCycle ES-Datenbank einsetzen,
nur Einzelbyte-Zeichen (ASCII) für die ID. (Siehe „Hinzufügen von Unternehmensdomänen“
in der User Management-Hilfe.)
22. Fugen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie Benutzerdefiniert in der Liste Authentifizierungsanbieter aus.
●
Klicken Sie auf IBMFileNetAuthProviderService und dann auf OK.
23. Fugen Sie einen LDAP-Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie in der Liste Authentifizierungsanbieter den Eintrag LDAP aus und klicken Sie auf OK.
24. Fugen Sie ein LDAP-Verzeichnis hinzu:
●
Klicken Sie auf Verzeichnis hinzufügen und geben Sie in das Feld Profilname einen eindeutigen
Namen ein und klicken Sie auf Weiter.
●
Geben Sie für die Optionen Server, Anschluss, SSL und Bindung und Seite mit folgenden
Elementen fullen Werte an. Wenn Sie als Option Bindung den Wert User wahlen, mussen Sie
ebenfalls Werte für die Felder Name und Kennwort angeben.
●
(Optional) Wahlen Sie Basis-DNs abrufen, um erforderlichenfalls Basisdomanennamen abzurufen.
Wenn Sie fertig sind, klicken Sie auf Weiter.
●
Konfigurieren Sie die Benutzereinstellungen, klicken Sie auf Weiter, konfigurieren Sie gegebenenfalls
Gruppeneinstellungen und klicken Sie auf Weiter.
Detailinformationen zu den Einstellungen erhalten Sie, wenn Sie rechts oben auf der Seite auf den
Link „Hilfe“ klicken.
25. Klicken Sie auf OK, um die Seite Verzeichnis hinzufugen zu verlassen, und klicken Sie zum Beenden
erneut auf OK.
26. Wahlen Sie die neue Unternehmensdomane aus und klicken Sie auf Jetzt synchronisieren.
In Abhangigkeit von der in Ihrem LDAP-Netzwerk vorhandenen Anzahl von Benutzern und
Gruppen sowie der Geschwindigkeit der Verbindung kann der Synchronisierungsprozess einige
Minuten in Anspruch nehmen.
(Optional) Klicken Sie zum Überprüfen des Synchronisierungsstatus auf Aktualisieren. Der Status wird
in der Spalte Aktueller Synchronisierungsstatus angezeigt.
27. Wechseln Sie zu Einstellungen > User Management > Benutzer und Gruppen.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
88
28. Suchen Sie nach Benutzern, die aus LDAP synchronisiert wurden, und führen Sie die folgenden
Aufgaben durch:
●
Wählen Sie mindestens einen Benutzer aus und klicken Sie auf Rolle zuweisen.
●
Wählen Sie mindestens eine LiveCycle ES-Rolle aus und klicken Sie auf OK.
●
Klicken Sie ein weiteres Mal auf OK, um die Rollenzuweisung zu bestatigen.
Wiederholen Sie diesen Schritt für alle Benutzer, denen Sie Rollen zuweisen möchten. Weitere
Informationen erhalten Sie, wenn Sie rechts oben auf der Seite auf den Hilfe-Link klicken.
29. Starten Sie die Workbench ES und melden Sie sich mithilfe der folgenden Anmeldeinformationen an:
Benutzername: [benutzername]@[repository_name]
Kennwort: [password]
Der FileNet-Objektspeicher sollte jetzt in der Ansicht „Ressourcen“ in der Workbench ES angezeigt
werden. Wenn Sie sich nicht unter Verwendung von Benutzername@Repository-Name anmelden,
versucht Workbench ES eine Anmeldung bei dem in Schritt 15 angegebenen Standardrepository.
30. (Optional) Wenn Sie die LiveCycle ES Samples -Beispiele für Connector for IBM FileNet installieren
möchten, erstellen Sie einen FileNet-Objektspeicher namens Samples und installieren dann die
Beispiele in diesen Objektspeicher.
Nachdem Sie den Connector for IBM FileNet-Dienst konfiguriert haben, empfiehlt es sich, in Verwalten
von LiveCycle ES Informationen zum ordnungsgemäßen Konfigurieren von Workbench ES-Funktionen
mit dem FileNet-Repository nachzulesen.
Konfigurieren von LiveCycle ES Connector for IBM Content Manager
Wenn Sie den Connector for IBM Content Manager-Dienst als Teil Ihrer LiveCycle ES-Lösung installiert
haben, führen Sie den folgenden Vorgang aus, um den Dienst für das Herstellen von Verbindungen
mit dem IBM Content Manager-Datenspeicher zu konfigurieren.
➤ So konfigurieren Sie Connector for IBM Content Manager:
1. Suchen Sie die Datei adobe-component-ext.properties im Ordner
[WAS-STAMMVERZEICHNIS]/AppsServer/profiles/[Profilname]. Wenn die Datei nicht vorhanden ist,
erstellen Sie sie. Fügen Sie eine neue Systemeigenschaft hinzu, die den Speicherort der folgenden
IBM II4C-JAR-Dateien angibt, den Konfigurationsordner („Config“), der die
IBM II4C-Eigenschaftendateien enthält, sowie eine ZIP-Datei aus der DB2 Universal
Database-Clientinstallation:
●
Clio4CM.jar
●
cmb81.jar
●
cmbcm81.jar
●
cmbdb281.jar
●
cmbdb2c81.jar
●
cmbfed81.jar
●
cmbfedc81.jar
●
cmbicm81.jar
●
cmbicmc81.jar
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
●
cmbicmcup.jar
●
cmbjdbc81.jar
●
cmbjdbcc81.jar
●
cmblog4j81.jar
●
cmbsdk81.jar
●
cmbservlets81.jar
●
cmbtag81.jar
●
cmbupes81.jar
●
cmbutil81.jar
●
cmbutilfed81.jar
●
cmbutilicm81.jar
●
cmbutiljdbc81.jar
●
cmbview81.jar
●
cmbwas81.jar
●
cmbwcm81.jar
●
cmbwebservices.jar
●
cmbxmlmap.jar
●
cmbxmlservice.jar
●
common.jar
●
common.resources.jar
●
ecore.jar
●
ecore.resources.jar
●
ecore.xmi.jar
●
icmadm81.jar
●
icmrm81.jar
●
icmsdk81.jar
●
jcache.jar
●
log4j-1.2.8.jar
●
NLVLog.jar
●
xalan.jar
●
xerces.jar
●
xsd.jar
●
xsd.resources.jar
●
cmgmt (kopieren Sie diesen Ordner samt Inhalt)
●
db2java.zip
Die neue Systemeigenschaft sollte diese Struktur aufweisen:
[Komponenten-ID].ext=[JAR-Dateien und/oder -Ordner]
89
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
90
Beispielsweise kann ausgehend von der Standardinstallation des DB2 Universal Database-Clients und
von II4C der Datei die folgende Systemeigenschaft in einer neuen Zeile hinzugefügt werden – es
dürfen keine Zeilenumbrüche verwendet und die Zeile muss mit einem Wagenrücklauf abgeschlossen
werden:
com.adobe.livecycle.ConnectorforIBMCM.ext=
C:/Programme/IBM/db2cmv8/lib/Clio4CM.jar,
C:/Programme/IBM/db2cmv8/lib/cmb81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbcm81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbdb281.jar,
C:/Programme/IBM/db2cmv8/lib/cmbdb2c81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbfed81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbfedc81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbicm81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbicmc81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbicmcup.jar,
C:/Programme/IBM/db2cmv8/lib/cmbjdbc81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbjdbcc81.jar,
C:/Programme/IBM/db2cmv8/lib/cmblog4j81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbsdk81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbservlets81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbtag81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbupes81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbutil81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbutilfed81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbutilicm81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbutiljdbc81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbview81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbwas81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbwcm81.jar,
C:/Programme/IBM/db2cmv8/lib/cmbwebservices.jar,
C:/Programme/IBM/db2cmv8/lib/cmbxmlmap.jar,
C:/Programme/IBM/db2cmv8/lib/cmbxmlservice.jar,
C:/Programme/IBM/db2cmv8/lib/common.jar,
C:/Programme/IBM/db2cmv8/lib/common.resources.jar,
C:/Programme/IBM/db2cmv8/lib/ecore.jar,
C:/Programme/IBM/db2cmv8/lib/ecore.resources.jar,
C:/Programme/IBM/db2cmv8/lib/ecore.xmi.jar,
C:/Programme/IBM/db2cmv8/lib/icmadm81.jar,
C:/Programme/IBM/db2cmv8/lib/icmrm81.jar,
C:/Programme/IBM/db2cmv8/lib/icmsdk81.jar,
C:/Programme/IBM/db2cmv8/lib/jcache.jar,
C:/Programme/IBM/db2cmv8/lib/log4j-1.2.8.jar,
C:/Programme/IBM/db2cmv8/lib/NLVLog.jar,
C:/Programme/IBM/db2cmv8/lib/xalan.jar,
C:/Programme/IBM/db2cmv8/lib/xerces.jar,
C:/Programme/IBM/db2cmv8/lib/xsd.jar,
C:/Programme/IBM/db2cmv8/lib/xsd.resources.jar,
C:/Programme/IBM/db2cmv8/cmgmt,
C:/Programme/IBM/SQLLIB/java/db2java.zip
2. Wenn WebSphere Application Server aktuell nicht ausgeführt wird, starten Sie den Server. Beenden Sie
andernfalls den Server und starten Sie ihn neu.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
91
Sie können nun über die IBMCMConnectorService-Eigenschaftenblätter eine Verbindung mit dem
IBM Content Manager-Datenspeicher herstellen, indem Sie „Benutzeranmeldeinformationen verwenden“
als Anmeldemodus verwenden.
Sie haben die für dieses Verfahren erforderlichen Schritte abgeschlossen.
(Optional) Wenn Sie über die IBMCMConnectorService-Eigenschaftenblätter eine Verbindung mit dem
IBM Content Manager-Datenspeicher herstellen möchten, indem Sie die „Anmeldeinformationen aus
Prozesskontext verwenden“ als Anmeldemodus verwenden, führen Sie die folgendes Verfahren aus.
➤ So stellen Sie mithilfe des Anmeldemodus „Anmeldeinformationen aus Prozesskontext verwenden“
eine Verbindung her:
1. Offnen Sie einen Webbrowser und geben Sie diese URL ein:
http://localhost:9080/adminui (lokale Bereitstellung unter Verwendung des Standardanschlusses)
2. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:
Benutzername: administrator
Kennwort: password
3. Klicken Sie auf Dienste > LiveCycle ES Connector für IBM Content Manager >
Konfigurationseinstellungen.
4. Geben Sie alle erforderlichen Repository-Informationen ein und klicken Sie auf Speichern. Weitere
Informationen zum IBM Content Manager-Repository erhalten Sie, wenn Sie rechts oben auf der Seite
auf den Hilfe-Link klicken.
5. Führen Sie eine der folgenden Aufgaben aus:
●
Um mit dem IBM Content Manager-Autorisierungsdienst (IBMCMProviderService) Inhalte
eines IBM Content Manager-Datenspeichers in der Ansicht „Prozesse“ von Workbench ES
zu verwenden, fahren Sie mit diesem Verfahren fort. Beim Verwenden des IBM Content
Manager-Autorisierungsdienstes wird die standardmäßige LiveCycle ES-Autorisierung
außer Kraft gesetzt. Der Dienst muss für die Anmeldung bei Workbench ES mit IBM Content
Manager-Anmeldeinformationen konfiguriert werden.
●
Melden Sie sich, damit Sie mithilfe der in Schritt 7 angegebenen Systemanmeldeinformationen
Inhalte aus einem IBM Content Manager-Datenspeicher in der Ansicht „Prozesse“ von Workbench ES
verwenden können, mit den LiveCycle ES-Superadministrator-Anmeldeinformationen
(standardmäßig Administrator und password) bei Workbench ES an. Sie haben
die für dieses Verfahren erforderlichen Schritte abgeschlossen. Die in Schritt 7 angegebenen
Systemanmeldeinformationen verwenden in diesem Fall den standardmäßigen LiveCycle ESAutorisierungsdienst für den Zugriff auf das Standard-Repository.
6. Melden Sie sich an der LiveCycle Administration Console an und wechseln Sie zu Einstellungen >
User Management > Domänenverwaltung.
7. Klicken Sie auf Neue Unternehmensdomäne und geben Sie eine ID und einen Namen für die
Domäne ein. Die Domanen-ID ist der eindeutige Bezeichner der Domane. Der Name ist eine
beschreibende Bezeichnung der Domane.
Hinweis: Bei Verwendung von DB2 als LiveCycle ES-Datenbank beträgt die maximal zulässige Länge
der ID 100 Einzelbyte-Zeichen (ASCII) oder 50 Doppelbyte-Zeichen oder 25 Vierbyte-Zeichen.
(Siehe unter „Hinzufügen von Unternehemensdomänen“ in der User Management-Hilfe.)
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Connectors, der FileNet 4.0.1 verwendet
92
Hinweis: Verwenden Sie, wenn Sie MySQL als LiveCycle ES-Datenbank einsetzen,
nur Einzelbyte-Zeichen (ASCII) für die ID. (Siehe „Hinzufügen von Unternehmensdomänen“
in der User Management-Hilfe.)
8. Fugen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie zuerst in der Liste Authentifizierungsanbieter den Eintrag Benutzerdefiniert,
wählen Sie dann IBMCMAuthProviderService aus und klicken Sie anschließend auf OK.
9. Fugen Sie einen LDAP-Authentifizierungsanbieter hinzu:
●
Klicken Sie auf Authentifizierung hinzufugen.
●
Wählen Sie in der Liste Authentifizierungsanbieter den Eintrag LDAP aus und klicken Sie auf OK.
10. Fugen Sie ein LDAP-Verzeichnis hinzu:
●
Klicken Sie auf Verzeichnis hinzufugen.
●
Geben Sie in das Feld Profilname eine eindeutige Zeichenfolge ein und klicken Sie auf Weiter.
●
Geben Sie für die Optionen Server, Anschluss, SSL und Bindung und Seite mit folgenden
Elementen fullen Werte an. Wenn Sie als Option Bindung den Wert User wahlen, mussen Sie
ebenfalls Werte für die Felder Name und Kennwort angeben. (Optional) Wahlen Sie Basis-DNs
abrufen, um erforderlichenfalls Basisdomanennamen abzurufen. Wenn Sie fertig sind, klicken Sie
auf Weiter.
●
Konfigurieren Sie die Benutzereinstellungen, klicken Sie auf Weiter, konfigurieren Sie
gegebenenfalls Gruppeneinstellungen und klicken Sie auf Weiter.
Detailinformationen zu den zuvor genannten Einstellungen erhalten Sie, wenn Sie rechts oben auf der
Seite auf den Hilfe-Link klicken.
11. Klicken Sie auf OK, um die Seite Verzeichnis hinzufugen zu verlassen, und klicken Sie zum Beenden
erneut auf OK.
12. Wahlen Sie die neue Unternehmensdomane aus und klicken Sie auf Jetzt synchronisieren.
In Abhangigkeit von der in Ihrem LDAP-Netzwerk vorhandenen Anzahl von Benutzern und
Gruppen sowie der Geschwindigkeit der Verbindung kann der Synchronisierungsprozess einige
Minuten in Anspruch nehmen.
13. Um den Status der Synchronisierung zu uberprufen, klicken Sie auf Aktualisieren und prufen den
Status in der Spalte Aktueller Synchronisierungsstatus.
14. Wechseln Sie zu Einstellungen > User Management > Benutzer und Gruppen.
15. Suchen Sie nach Benutzern, die aus LDAP synchronisiert wurden, und führen Sie die folgenden
Aufgaben durch:
●
Wählen Sie mindestens einen Benutzer aus und klicken Sie auf Rolle zuweisen.
●
Wählen Sie mindestens eine LiveCycle ES-Rolle aus und klicken Sie auf OK.
●
Klicken Sie ein weiteres Mal auf OK, um die Rollenzuweisung zu bestatigen.
Wiederholen Sie diesen Schritt für alle Benutzer, denen Sie Rollen zuweisen möchten. Weitere
Informationen erhalten Sie, wenn Sie rechts oben auf der Seite auf den Hilfe-Link klicken.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Deinstallieren von LiveCycle ES
93
16. Starten Sie die Workbench ES und melden Sie sich mithilfe der folgenden Anmeldeinformationen an:
Benutzername: [benutzername]@[repository_name]
Kennwort: [password]
Der IBM Content Manager-Datenspeicher kann jetzt in der Ansicht „Prozesse“ innerhalb
von Workbench ES verwendet werden, wenn der Anmeldemodus für die orchestrierbaren
IBMCMConnectorService-Komponenten als Anmeldeinformationen aus Prozesskontext
verwenden festgelegt ist.
Nach der Konfiguration des Connector for IBM Content Manager-Dienstes sollten Sie Verwalten
von LiveCycle ES lesen.
Deinstallieren von LiveCycle ES
Das Deinstallationsprogramm im [LiveCycle ES-Stammverzeichnis] entfernt keine Dateien, die Sie auf dem
Anwendungsserver bereitgestellt haben.
Vorsicht: Wenn Sie das Deinstallationsprogramm ausführen, wird der gesamte Inhalt des
Produktinstallationsverzeichnisses ohne Warnmeldung gelöscht. Bevor Sie fortfahren,
sichern Sie alle Daten, die Sie nicht verlieren möchten.
➤ So entfernen Sie die Dateien vom Computer:
1. Starten Sie das Deinstallationsprogramm:
●
(Windows) Führen Sie diese Aufgaben aus:
●
●
Wählen Sie in der Windows-Systemsteuerung die Option Software.
●
Entfernen Sie Adobe Adobe LiveCycle ES.
●
Entfernen Sie Adobe Acrobat 9.0 Professional (falls mit PDF Generator ES installiert).
Alternativ dazu können Sie manuell auch folgende Schritte durchführen:
●
Legen Sie JAVA_HOME und PATH so fest, dass sie das IBM-JDK in WebSphere verwenden.
●
cd [Livecycle ES-Stammverzeichnis]/_uninst/server
●
Doppelklicken Sie auf die Datei „livecycle8_uninstall.exe“.
●
(Linux und UNIX) Geben Sie an einem Terminal ./livecycle8_uninstall.bin ein (eventuell
müssen Sie diese Binärdatei in eine ausführbare Datei ändern, z. B. chmod 777).
●
(AIX) Führen Sie diese Aufgaben aus:
●
Legen Sie JAVA_HOME und PATH so fest, dass sie das IBM-JDK in WebSphere verwenden.
●
Verzeichnis ändern: cd /opt/adobe/livecycle8/_uninst/server.
●
Geben Sie an einem Terminal java -jar uninstall.jar ein.
2. Befolgen Sie die auf dem Bildschirm angezeigten Anweisungen des Deinstallationsprogramms und
klicken Sie auf Fertig stellen.
Adobe LiveCycle ES
Aktivitäten nach der Bereitstellung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Deinstallieren einer LiveCycle ES-Lösungskomponente
94
Deinstallieren einer LiveCycle ES-Lösungskomponente
Beim Entfernen einer installierten Lösungskomponente gibt es zwei Hauptaufgaben:
●
Beenden Sie die Verwendung der LiveCycle ES-EAR-Dateien und heben Sie deren Bereitstellung
auf dem Anwendungsserver auf.
●
Führen Sie LiveCycle Configuration Manager aus, um die LiveCycle ES-EAR-Dateien und
-Lösungskomponenten (ohne die entfernte Komponente) neu zu konfigurieren und bereitzustellen.
➤ So deinstallieren Sie eine Lösungskomponente, ohne LiveCycle ES zu entfernen:
1. Beenden Sie die Verwendung der LiveCycle ES-EAR-Dateien und heben Sie deren Bereitstellung
mithilfe des Verwaltungsdienstprogramms des Anwendungsservers auf. Siehe „Deinstallieren
von EAR-Dateien“ auf Seite 28.
2. Führen Sie LiveCycle Configuration Manager aus. Siehe „Konfigurieren von und Bereitstellen
von LiveCycle ES“ auf Seite 23.
3. Wählen Sie im Bildschirm „Auswahl von Lösungskomponenten“ nur die Lösungskomponenten aus,
die erneut bereitgestellt werden sollen. Sind die zuvor installierten Komponenten ausgewählt,
heben Sie Auswahl der Komponente auf, die entfernt werden soll.
4. Wählen Sie im Bildschirm „Taskauswahl“ die folgenden Aufgaben aus und klicken Sie auf „Weiter“:
●
Konfigurieren von LiveCycle ES
●
Bereitstellen von LiveCycle ES-EAR-Dateien
●
Bereitstellen von LiveCycle ES-Komponenten
5. Führen Sie in den restlichen Bildschirmen die erforderlichen Aufgaben aus, prüfen Sie die nächsten
Schritte und klicken Sie auf „Beenden“.
Wenn Sie Output ES deinstallieren, sind die folgenden Aufgaben erforderlich, um die Deinstallation der
Komponente aus der LiveCycle ES-Umgebung abzuschließen:
●
Melden Sie sich bei der Workbench ES an und deinstallieren Sie den Output-Dienst über die Ansicht
„Komponenten“.
●
Entfernen Sie alle zugehörigen Beispiele.
Manuelles Konfigurieren von BAM Server
für LiveCycle ES
7
In diesem Abschnitt werden die Aufgaben beschrieben, die für die manuelle Installation und
Konfiguration von LiveCycle ES Business Activity Monitoring für die Verwendung mit LiveCycle ES
durchgeführt werden müssen:
●
„Konfigurieren von WebSphere für BAM Server“ auf Seite 95
●
„Konfigurieren des Keystore“ auf Seite 96
●
„Erstellen der Datei „bam.properties““ auf Seite 97
●
„Erstellen und Konfigurieren der BAM Server-Metadaten-Datenbank“ auf Seite 97
●
„Konfigurieren von WebSphere-Parametern“ auf Seite 103
●
„Konfigurieren Process Management ES für BAM Server“ auf Seite 104
●
„Bereitstellen von BAM Server unter WebSphere“ auf Seite 105
●
„Konfigurieren von LDAP-Einstellungen für BAM Server“ auf Seite 107
●
„Verwendet BAM Dashboard“ auf Seite 111
●
„Deinstallation… Business Activity Monitoring“ auf Seite 113
Bei den Anweisungen in diesem Dokument werden die folgenden Benennungskonventionen
für allgemeine Dateipfade verwendet.
'
Name
Beschreibung
[Anwendungsserver- Das Basisverzeichnis des
Stammverzeichnis] Anwendungsservers für
Business Activity Monitoring.
Standardwert
WebSphere unter Windows:
C:\Programme\IBM\WebSphere\AppServer
WebSphere unter Linux und Solaris:
/opt/IBM/WebSphere/AppServer
WebSphere unter AIX:
/usr/IBM/WebSphere/AppServer
[LiveCycle ESStammverzeichnis]
Der Speicherort, an dem die
LiveCycle ES-Dienste installiert
werden.
Windows: C:\Adobe\LiveCycle8.2
Linux und UNIX: /opt/adobe/livecycle8.2
Die meisten Informationen zu Verzeichnissen in diesem Dokument gelten plattformübergreifend
(unter Linux und UNIX wird bei allen Dateinamen und Pfadangaben die Groß- und Kleinschreibung
beachtet). Plattformspezifische Informationen werden bei Bedarf aufgeführt.
Konfigurieren von WebSphere für BAM Server
Wenn Sie LiveCycle Process Management ES installieren und Business Activity Monitoring verwenden,
müssen Sie WebSphere manuell konfigurieren, damit BAM Server ordnungsgemäß ausgeführt wird.
BAM Server sollte in einer eigenen Serverinstanz ausgeführt werden. Dafür müssen Sie ein neues Profil
erstellen und eine Verbindung zur LiveCycle ES-Datenbank einrichten.
95
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Keystore
96
Führen Sie die folgenden Aufgaben aus:
●
Konfigurieren Sie die Verbindung zur BAM Server-Metadaten-Datenbank.
●
Legen Sie die Parameter des Anwendungsservers fest.
●
Erstellen Sie Profil für das Hosten von BAM Server.
●
Konfigurieren Sie die Verbindung zur LiveCycle ES-Datenbank.
Hinweis: Wenn Sie Business Activity Monitoring unter WebSphere verwenden, müssen Sie ein Profil
für die Ausführung von BAM Server erstellen, das von der Instanz für die Ausführung
LiveCycle ES getrennt ist.
➤ So erstellen Sie ein Profil unter WebSphere:
1. Wechseln Sie an einer Eingabeaufforderung zum Verzeichnis
[Anwendungsserver­Stammverzeichnis]/bin/ProfileManagement.
2. Starten Sie den WebSphere Profile Creation-Assistenten, indem Sie den folgenden Befehl eingeben:
●
(Windows) pmt.bat
●
(AIX/Solaris/Linux) pmt.sh
3. Klicken Sie im Begrüßungsbildschirm auf Weiter.
4. Klicken Sie im Bildschirm „Environment Selection“ auf Next.
5. Wählen Sie im Bildschirm Profile Creation Options die Option Typical Profile Creation und
klicken Sie auf Weiter.
6. Legen Sie im Bildschirm „Administrative Security“ fest, ob die Sicherheit aktiviert sein soll,
und klicken Sie auf Next.
7. Prüfen Sie die Informationen im Bildschirm „Profile Creation Summary“. Achten Sie darauf, dass die
bereitgestellten Anschlussnummern, vor allem für die WebSphere Administrative Console, in Ordnung
sind, und klicken Sie dann auf Create.
Hinweis: Unter Windows wird das neue Profil standardmäßig als Dienst ausgeführt.
Konfigurieren des Keystore
Für die Ver- und Entschlüsselung von Kennwörtern benötigen Sie Administrator- und Benutzer-Keystores.
Außerdem müssen Sie den Speicherort dieser Keystores angeben.
➤ So richten Sie Keystores und deren Speicherorte ein:‘178 ‘
1. Kopieren Sie die Keystore-Datei „admin.jks“ aus
„[LiveCycleES­Stammverzeichnis]/LiveCycle_ES_SDK\misc\Business_Activity_Monitoring\keystore“
an einen Speicherort, der [Administrator-Keystore-Speicherort] genannt wird. Das Standardkennwort
ist „40fd2442fa“.
2. Kopieren Sie die Keystore-Datei „user_sample.jks“ aus
„[LiveCycleES­Stammverzeichnis]/LiveCycle_ES_SDK\misc\Business_Activity_Monitoring\keystore“
an einen Speicherort, der [Benutzer-Keystore-Speicherort] genannt wird. Das Standardkennwort
ist „8deb5102f8“.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Erstellen der Datei „bam.properties“
97
➤ So erstellen Sie einen Benutzer-Keystore:
Es wird ausdrücklich empfohlen, einen Benutzer-Keystore zu erstellen. So erstellen Sie einen
Benutzer-Keystore:
1. Unter „Arbeiten mit der Verschlüsselungskonfiguration“ in der LiveCycle Workbench ES-Hilfe finden Sie
Informationen zum Erstellen eines Java-Keystore.
2. Geben Sie den Speicherort Ihres Benutzer-Keystores in der Systemeinstellungseigenschaft
Keystore-Speicherort in Ihrer Datei „bam.properties“ an. (Siehe „Erstellen der Datei
„bam.properties““ auf Seite 97.)
Erstellen der Datei „bam.properties“
Bevor Sie die Installation starten, müssen Sie eine Textdatei mit Systemeigenschaften namens
„bam.properties“ erstellen. Speichern Sie diese Datei an einem beliebigen Speicherort im Dateisystem.
In diesem Dokument wird der Speicherort dieser Datei als [bam.properties-Dateispeicherort]
bezeichnet. Diese Eigenschaften sind erforderlich, damit Business Activity Monitoring ordnungsgemäß
startet. Ohne diese Textdatei zeigt die BAM Workbench ggf. das Webseitendialogfeld „Ersteinrichtung“ an,
da einige verbindliche Systemeigenschaften nicht festgelegt wurden.
Zum Festlegen der erforderlichen Systemeigenschaften erstellen Sie daher die Textdatei „bam.properties“
und speichern Sie in Ihrem Verzeichnis „[Anwendungsserver-BAM-Stammverzeichnis]/bin“. Sie müssen
folgende Eigenschaften und Standardwerte in der Textdatei mit den Starteigenschaften festlegen:
Logging Directory= [geben Sie ein Protokollverzeichnis an]
Recovery Log Directory =
[geben Sie ein Wiederherstellungsprotokollverzeichnis an]
Log File Prefix=bam
SMTP Host=localhost
SMTP From Address=lava@localhost
SMTP User=lava
Admin Keystore Location=[Administrator-Keystore-Speicherort]/admin.jks
Keystore Location=[Benutzer-Keystore-Speicherort]/user_sample.jks
Erstellen und Konfigurieren der
BAM Server-Metadaten-Datenbank
Sie müssen eine BAM Server-Metadaten-Datenbank erstellt haben, um die Definitionen der Prozessmetriken
zu speichern, die BAM Server überwacht. Einzelheiten zu unterstützten Datenbanken und Berechtigungen
finden Sie in Vorbereiten der Installation von LiveCycle ES (Einzelserver).
Benutzerkonten
Sie müssen ein dediziertes Benutzerkonto einrichten, mit dem BAM Server eine Verbindung
zur BAM Server-Metadaten-Datenbank herstellen kann. Einzelheiten zu den erforderlichen
Benutzerberechtigungen finden Sie in Vorbereiten der Installation von LiveCycle ES (Einzelserver).
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Konfigurieren der Datenbankumgebung (nur DB2)
98
Konfigurieren der Datenbankumgebung (nur DB2)
Dieser Abschnitt ist nur relevant, wenn Sie DB2 als Metadaten-Datenbank verwenden.
Wenn Sie DB2 als BAM Server-Metadaten-Datenbank verwenden, müssen Sie eine Umgebungsvariable
erstellen, die den Namen der zugehörigen DB2-Instanz enthält. Zudem müssen Sie den Pfad zu den
freigegebenen DB2-Bibliotheken in der Bibliothekspfadvariablen angeben.
In den folgenden Beispielen werden Befehle zum Konfigurieren der Umgebungsvariablen aufgeführt.
Verwenden Sie den Ihrem Betriebssystem entsprechenden Befehl. Eventuell müssen Sie die Pfadangabe
im Befehl durch das von Ihnen für DB2 verwendete Installationsverzeichnis ersetzen.
Example: Befehle zum Konfigurieren von Umgebungsvariablen unter Windows
Die folgenden Befehle finden auf eine DB2-Instanz mit dem Namen DB2 Anwendung.
DB2-Bibliotheksdateien sind unter C:\SQLLIB\BIN installiert:
set DB2INSTANCE=DB2
set PATH=C:\SQLLIB\BIN;%PATH%
Example: Befehle zum Konfigurieren von Umgebungsvariablen unter Solaris
Die folgenden Befehle finden auf eine DB2-Instanz mit dem Namen db2fs Anwendung.
DB2-Bibliotheksdateien sind unter /opt/IBM/db2/V8.1/lib installiert:
export DB2INSTANCE=db2fs
export LD_LIBRARY_PATH=/opt/IBM/db2/V8.1/lib:${LD_LIBRARY_PATH}
Example: Befehle zum Konfigurieren von Umgebungsvariablen unter AIX
Die folgenden Befehle finden auf eine DB2-Instanz mit dem Namen db2f Anwendung.
DB2-Bibliotheksdateien sind im Verzeichnis „/opt/IBM/db2/V8.1/lib“ installiert:
export DB2INSTANCE=db2f
export LIBPATH=/opt/IBM/db2/V8.1/lib:${LIBPATH}
Erstellen eines JAAS-Authentifizierungsalias für die
BAM Server-Metadaten-Datenbank
Sie müssen einen JAAS-Authentifizierungsalias für ein Benutzerkonto erstellen, das Zugriff auf die
BAM Server-Metadaten-Datenbank hat.
➤ So erstellen Sie einen JAAS-Authentifizierungsalias für die BAM Server-Metadaten-Datenbank:
1. Vergewissern Sie sich, dass die WebSphere Application Server-Instanz für BAM Server gestartet wurde.
2. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Security > Secure
administration, applications, and infrastructure.
3. Klicken Sie im rechten Bereich unter Authentication> auf Java Authentication and Authorization
Service > J2C authentication data.
4. Klicken Sie im nächsten Bildschirm im rechten Bereich auf New.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der Datenbankumgebung (nur DB2)
99
5. Geben Sie Werte für die folgenden Eigenschaften an und klicken Sie auf OK.
Alias: Ein Name für den Alias (z. B. BAMDB)
Benutzer-ID: Der Benutzername für das Benutzerkonto, das Zugriff auf die
BAM Server-Metadaten-Datenbank hat.
Kennwort: Das der angegebenen Benutzerkennung zugeordnete Kennwort.
Beschreibung:(Optional) Eine Beschreibung des Alias.
6. Klicken Sie auf Save und anschließend auf Save to the master configuration.
Erstellen eines JAAS-Authentifizierungsalias für die LiveCycle ES-Datenbank
Sie müssen unter BAM Server einen JAAS-Authentifizierungsalias für ein Benutzerkonto erstellen,
das Zugriff auf die LiveCycle ES-Metadaten-Datenbank hat.
➤ So erstellen Sie einen JAAS-Authentifizierungsalias für die LiveCycle ES-Datenbank:
1. Vergewissern Sie sich, dass der für BAM Server erstellte WebSphere-Anwendungsserver gestartet
wurde.
2. Erstellen und konfigurieren Sie den JAAS-Authentifizierungsalias, um die Verbindung zur
LiveCycle ES-Datenbank herzustellen. Befolgen Sie dabei die Anweisungen unter „Konfigurieren der
J2C-Authentifizierung für die Datenquelle“ auf Seite 35 für Ihren Typ von Metadaten-Datenbank.
Erstellen des JDBC-Providers für die BAM Server-Metadaten-Datenbank
Sie müssen den JDBC-Provider erstellen, mit dem Sie die Verbindung zur BAM Server-Metadaten-Datenbank
erstellen.
➤ So erstellen Sie den JDBC-Provider:
1. Vergewissern Sie sich, dass die WebSphere Application Server-Instanz für BAM Server gestartet wurde.
2. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Resources > JDBC >
JDBC Providers.
3. Wählen Sie im Bereich JDBC Providers den für den BAM Server-Server erstellten Bereich aus und
klicken Sie auf New.
4. (Oracle) Wählen Sie im Bildschirm von Schritt 1 die folgenden Werte aus:
Datenbanktyp: Oracle
Provider type: Oracle JDBC Driver
Implementation type: Connection pool data source
5. (DB2) Wählen Sie im Bildschirm von Schritt1 die folgenden Werte aus:
Datenbanktyp: DB2
Provider type: DB2 Universal JDBC Driver Provider
Implementation type: Connection pool data source
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Erstellen der Datenquelle für die BAM Server-Metadaten-Datenbank 100
6. (SQL Server) Wählen Sie im Bildschirm von Schritt1 die folgenden Werte aus:
Datenbanktyp: SQL Server
Provider type: WebSphere embedded Connect JDBC driver for MS SQL Server
Implementation type: Connection pool data source
7. Klicken Sie auf Next und geben Sie im Feld Classpath hinter anderen Einträgen in dem Feld die
Dateipfade ein, die dem zum Speichern der BAM Server-Metadaten verwendeten Datenbanktyp
entsprechen. Wenn Sie mehrere Klassenpfade hinzufügen müssen, müssen Sie nach jedem Pfad einen
harten Zeilenumbruch eingeben:
●
Oracle:
{WAS_INSTALL_ROOT}/db_driver/ojdbc14.jar
●
DB2:
{WAS_INSTALL_ROOT}/db_driver/db2jcc.jar
{WAS_INSTALL_ROOT}/db_driver/db2jcc_license_cu.jar
●
SQL Server – akzeptieren Sie die nativen Standardtreiber:
{WAS_INSTALL_ROOT}/db_driver/sqlserver.jar
{WAS_INSTALL_ROOT}/db_driver/base.jar
{WAS_INSTALL_ROOT}/db_driver/util.jar
Hinweis: Vergewissern Sie sich, dass Sie keine der im Feld „Classpath“ vorhandenen Einträge löschen.
8. Klicken Sie im Bildschirm von Schritt 2 auf Next und im Bildschirm von Schritt 3 auf Finish.
9. Klicken Sie auf Save und anschließend auf Save to the master configuration.
Erstellen eines JDBC-Providers für die LiveCycle ES-Datenbank
Erstellen Sie einen LiveCycle ES-JDBC-Provider auf dem Server, den Sie für BAM Server erstellt haben.
Dieser JDBC-Provider wird zum Herstellen der Verbindung zur LiveCycle ES-Datenbank verwendet.
➤ So erstellen Sie den JDBC-Provider:
●
Informationen für DB2 finden Sie unter „So erstellen Sie einen DB2 JDBC-Provider:“ auf Seite 36.
●
Informationen für Oracle finden Sie unter „So erstellen Sie den Oracle JDBC-Provider:“ auf Seite 38.
●
Informationen für SQL Server finden Sie unter „So erstellen Sie den SQL Server 2005 JDBC-Provider:“
auf Seite 41.
Erstellen der Datenquelle für die BAM Server-Metadaten-Datenbank
Erstellen Sie eine Datenquelldatei, damit BAM Server eine Verbindung zur
BAM Server-Metadaten-Datenbank herstellen kann.
➤ So erstellen Sie die DB2 JDBC-Datenquelle:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Resources > JDBC >
Data sources.
2. Wählen Sie im rechten Fenster in der Liste All scopes den geeigneten Bereich für Ihren BAM Server aus
(meistens „Node“) und klicken Sie auf New.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Erstellen der Datenquelle für die BAM Server-Metadaten-Datenbank 101
3. Legen Sie im Bildschirm von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
Data source name: com.celequest.metadata.metaDatasource
JNDI-Name: com.celequest.metadata.metaDatasource
Component-managed authentication: Wählen Sie den Authentifizierungsalias für diese
Datenquelle aus, den Sie in „Erstellen eines JAAS-Authentifizierungsalias für die
BAM Server-Metadaten-Datenbank“ auf Seite 98 erstellt haben.
4. Wählen Sie im Bildschirm von Schritt 2 die Option Select an existing JDBC provider und in der Liste
den in „Erstellen des JDBC-Providers für die BAM Server-Metadaten-Datenbank“ auf Seite 99 erstellten
JDBC-Provider aus.
5. Klicken Sie auf Next und klicken Sie im Bildschirm von Schritt 4 auf Finish.
6. Klicken Sie auf Save und anschließend auf Save to the master configuration.
7. Führen Sie die unter „So konfigurieren Sie
com.celequest.metadata.metaDatasource-Verbindungspools:“ auf Seite 102
beschriebenen Schritte für diese Datenquelle aus.
➤ So erstellen Sie die Oracle-Datenquelle:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > Data sources.
2. Wählen Sie den geeigneten Bereich für Ihren BAM Server aus (meistens „Node“) und klicken Sie
auf New.
3. Legen Sie im Bildschirm von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
Data source name: com.celequest.metadata.metaDatasource
JNDI-Name: com.celequest.metadata.metaDatasource
Component-managed authentication: Wählen Sie den für diese Datenquelle erstellten
Authentifizierungsalias aus.
4. Wählen Sie im Bildschirm von Schritt 2 die Option Select an existing JDBC provider und in der Liste
den in „Erstellen des JDBC-Providers für die BAM Server-Metadaten-Datenbank“ auf Seite 99 erstellten
JDBC-Provider aus.
5. Klicken Sie auf Next und geben Sie auf dem Bildschirm von Schritt 3 im Feld URL folgenden Text ein,
dabei steht [Serverhost] für die IP-Adresse des Datenbankservers, [Anschluss] für den Anschluss, an dem
die Datenbank empfangsbereit ist (standardmäßig 1521), und [SID] ist die Service-ID der Datenbank:
jdbc:oracle:thin:@[Serverhost]:[Anschluss]:[SID]
6. Wählen Sie in der Liste Data Store Helper Class Name den Eintrag Oracle 10g data store helper aus.
7. Deaktivieren Sie „Use this datasource in container managed persistence (CMP)“.
8. Klicken Sie auf Next und dann im Bildschirm Summary auf Finish.
9. Klicken Sie auf Save und anschließend auf Save to the master configuration.
10. Führen Sie die unter „So konfigurieren Sie
com.celequest.metadata.metaDatasource-Verbindungspools:“ auf Seite 102
beschriebenen Schritte für diese Datenquelle aus.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Erstellen der Datenquelle für die BAM Server-Metadaten-Datenbank 102
➤ So erstellen Sie die SQL Server 2005-Datenquelle:
1. Klicken Sie in der Navigationsstruktur auf Resources > JDBC > Data sources.
2. Wählen Sie den geeigneten Bereich für Ihren BAM Server aus (meistens „Node“) und klicken Sie
auf New.
3. Legen Sie im Bildschirm von Schritt 1 die folgenden Konfigurationen fest und klicken Sie auf Next:
Data source name: com.celequest.metadata.metaDatasource
JNDI-Name: com.celequest.metadata.metaDatasource
Component-managed authentication: Wählen Sie den für diese Datenquelle erstellten
Authentifizierungsalias aus.
4. Wählen Sie im Bildschirm von Schritt 2 die Option Select an existing JDBC provider und in der Liste
den in „Erstellen des JDBC-Providers für die BAM Server-Metadaten-Datenbank“ auf Seite 99 erstellten
JDBC-Provider aus.
5. Klicken Sie auf Next und klicken Sie im Bildschirm von Schritt 4 auf Finish.
6. Klicken Sie auf Save und anschließend auf Save to the master configuration.
7. Führen Sie die unter „So konfigurieren Sie
com.celequest.metadata.metaDatasource-Verbindungspools:“ auf Seite 102
beschriebenen Schritte für diese Datenquelle aus.
➤ So konfigurieren Sie com.celequest.metadata.metaDatasource-Verbindungspools:
1. Wählen Sie in der Navigationsstruktur Resources > JDBC >Data sources aus und klicken Sie auf die
gerade erstellte Datenquelle.
2. Klicken Sie im nächsten Bildschirm unter „Additional Properties“ auf Connection Pool Properties und
richten Sie die Eigenschaften wie folgt ein:
●
Geben Sie in das Feld Maximum connections den Wert 20 oder höher (falls erforderlich) ein.
●
Geben Sie in das Feld Minimum connections den Wert 1 ein.
3. Klicken Sie auf OK oder Apply und klicken Sie dann auf Save directly to Master Configuration.
Erstellen einer Datenquelle für die LiveCycle ES-Datenbank
Erstellen Sie eine IDP_DS-Datenquelle auf dem Server, den Sie für BAM Server erstellt haben. Diese
Datenquelle ermöglicht BAM Server den Zugriff auf die LiveCycle ES-Datenbank.
●
Informationen für DB2 finden Sie unter „So erstellen Sie die DB2 JDBC-Datenquelle:“ auf Seite 36.
●
Informationen für Oracle finden Sie unter „So erstellen Sie die Oracle JDBC-Datenquelle:“ auf Seite 39.
●
Informationen für SQL Server finden Sie unter „So erstellen Sie die SQL Server 2005-Datenquelle:“
auf Seite 42.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von WebSphere-Parametern 103
Testen der Datenbankverbindung
Sie sollten die Konfiguration des JDBC-Providers mit der in WebSphere verfügbaren Funktion zum Testen
der Verbindung testen.
➤ So testen Sie die Datenbankverbindung:
1. Klicken Sie in der Navigationsstruktur der WebLogic Server Administration Console auf Resources >
JDBC > JDBC Providers und anschließend im rechten Fenster auf Ihren Provider.
2. Klicken Sie unter „Additional Properties“ auf Data sources und anschließend
auf com.celequest.metadata.metaDatasource.
3. Klicken Sie auf Verbindung testen.
Im Feld „Message“ oben auf der Seite werden die Testergebnisse angezeigt. Sollte der Test fehlschlagen,
können Sie mit den Fehlerberichtfunktionen von WebSphere die Problemursache identifizieren.
<use-java-context>false</use-java-context>
Konfigurieren von WebSphere-Parametern
Sie müssen mehrere WebSphere Application Server-Parameter konfigurieren, um die Unterstützung
von BAM Server zu gewährleisten.
➤ So legen Sie die Parameter des Anwendungsservers fest:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Servers >
Application Servers und klicken Sie anschließend auf den Namen des Anwendungsservers,
auf dem Sie BAM Server bereitstellen möchten.
2. Klicken Sie auf die Registerkarte Configuration und klicken Sie unter Server Infrastructure auf Java
and Process Management > Process Definition.
3. Klicken Sie auf dem nächsten Bildschirm unter Additional Properties auf Java Virtual Machine.
4. Geben Sie auf dem nächsten Bildschirm Werte in den Feldern Initial Heap und Maximum Heap ein.
Welche Werte Sie hier eingeben, ist von der Leistungsfähigkeit Ihres Systems abhängig. Sie sollten
jedoch möglichst hohe Werte wählen. Die empfohlenen Mindestwerte sind 256 und 1024.
5. Geben Sie die folgenden drei Parameter durch Leerzeichen getrennt in das Feld Generic JVM
Arguments ein:
-Dfile.encoding=utf8
-DCASBOOTPROPS=[bam.properties-Dateispeicherort]
-Dcom.celequest.bootstrap.envpropname=CASBOOTPROPS
6. Klicken Sie auf Apply, klicken Sie auf OK und klicken Sie anschließend auf Save to the master
configuration.
7. Kehren Sie zum Hauptserverbildschirm zurück, indem Sie oben auf der Seite auf den Servernamen
klicken. Klicken Sie unter Container Settings auf Container Services > Transaction Service.
8. Geben Sie im nächsten Bildschirm unter Total transaction lifetime timeout den Wert 600 ein.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren Process Management ES für BAM Server 104
9. Klicken Sie auf OK, um zum Bildschirm Custom Properties zurückzukehren, und klicken Sie
anschließend auf Save to the Master Configuration.
10. Starten Sie WebSphere neu.
Konfigurieren Process Management ES für BAM Server
Sie können Process Management ES so konfigurieren, dass über die LiveCycle Administration Console
eine Verbindung zu BAM Server hergestellt wird. Dazu müssen Sie den Server angeben, auf dem der
LiveCycle ES-Server und der BAM Server ausgeführt werden, sowie die Informationen des Benutzerkontos,
über das der Zugriff auf BAM Server erfolgt.
➤ So konfigurieren Sie Process Management ES für BAM Server:
1. Melden Sie sich an der LiveCycle Administration Console an.
2. Klicken Sie auf Dienste > LiveCycle Process Management ES > Servereinstellungen >
BAM-Konfigurationseinstellungen.
3. Geben Sie Werte für die folgenden Eigenschaften ein:
BAM-Host: Der Hostname oder die IP-Adresse des Servers, auf dem BAM Server ausgeführt wird.
Der Standardwert ist localhost.
BAM-Anschluss: Der Dienstanschluss des Anwendungsservers, auf dem BAM Server ausgeführt
wird. Für Websphere beträgt dieser Wert in der Regel „9080“, wenn Business Activity Monitoring
auf demselben Server wie LiveCycle ES bereitgestellt wird.
LiveCycle-Serverhost: Der Hostname oder die IP-Adresse des Servers, auf dem der
LiveCycle ES-Server ausgeführt wird. Der Standardwert ist localhost.
SOAP-Anschluss des LiveCycle-Servers: Der Dienstanschluss des Anwendungsservers,
auf dem der LiveCycle ES-Server ausgeführt wird. Für Websphere beträgt dieser Wert in der
Regel „9080“.
Benutzername: (Optional) Der Benutzername des Administratorkontos, über das
Process Management ES auf BAM Server zugreift. Der Standardbenutzername ist system.
Hinweis: Wenn Sie den Benutzernamen für ein anderes Benutzerkonto angeben, stellen Sie sicher,
dass der Benutzer über vollständige Administratorrechte für BAM Server verfügt. Weitere
Informationen zum Verwalten von BAM Server-Benutzerkonten finden Sie in der LiveCycle
Workbench ES-Hilfe.
Kennwort: (Optional) Ein gültiges Kennwort für den oben angegebenen Benutzernamen.
Das Standardkennwort ist manager.
4. Klicken Sie auf Speichern und starten Sie den LiveCycle ES-Server neu.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Bereitstellen von BAM Server unter WebSphere 105
Bereitstellen von BAM Server unter WebSphere
Stellen Sie die EAR-Datei für BAM Server auf dem Anwendungsserver bereit, den Sie zum Ausführen
von BAM Server konfiguriert haben.
➤ So stellen Sie die EAR-Datei für BAM Server bereit:
1. Vergewissern Sie sich, dass der für BAM Server erstellte WebSphere Application Server gestartet wurde.
2. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Applications >
Install New Application.
3. Klicken Sie auf Durchsuchen, wählen Sie die Datei „Lava_Adobe.ear“ aus und klicken Sie anschließend
auf OK.
Hinweis: Die Datei „Lava_Adobe.ear“ befindet sich im Verzeichnis
[LiveCycle  ES-Stammverzeichnis]/deploy. Wenn Sie im Bildschirm „Solution
Component“ von LiveCycle Configuration Manager Business Activity Monitoring
ausgewählt haben, befindet sich die Datei auch im Verzeichnis
[LiveCycle  ES-Stammverzeichnis]/export.
4. Wählen Sie Show me all installation options and parameters aus und klicken Sie auf Next.
5. Wählen Sie Generate Default Bindings und klicken Sie auf Next.
6. Führen Sie in Map modules to servers die folgenden Aufgaben aus:
●
Wählen Sie das Modul „Celequest BAM Suite“ aus.
●
Wählen Sie unter „Clusters and Servers“ den Server für LiveCycle ES aus (standardmäßig ist dies
server1) und klicken Sie auf Apply.
●
Klicken Sie in allen nachfolgenden Bildschirmen auf Next.
7. Übernehmen Sie die Standardwerte, indem Sie auf Next klicken, bis der Zusammenfassungsbildschirm
angezeigt wird, und klicken Sie auf Finish.
Hinweis: Gegebenenfalls wird eine Meldung vom Typ Resource Warning eingeblendet. Sie können
diese Meldung ignorieren.
8. Klicken Sie auf Save und dann auf Save changes to the Master Configuration.
9. Starten Sie „Lava_Adobe.ear“:
●
Klicken Sie auf „Applications“ > „Enterprise Applications“.
●
Wählen Sie „Adobe LiveCycle ES Business Activity Monitoring“ aus und klicken Sie auf „Start“.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Bereitstellen von BAM Server unter WebSphere 106
➤ So konfigurieren Sie die BAM Server-Systemeinstellungen:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[BAM-Anschluss]/bam/workbench eingeben.
2. Geben Sie auf der Anmeldeseite den Benutzernamen und das Kennwort des Systemmanagers ein.
Es folgen die Standardwerte:
Benutzername: system
Kennwort: manager
Bei der ersten Anmeldung werden Sie aufgefordert, die Systemeinstellungen zu konfigurieren.
3. Klicken Sie auf Systemeinstellungen öffnen.
4. Wählen Sie in der Liste Konfigurieren den Eintrag Prüfpunktkonfiguration aus und stellen Sie sicher,
dass Prüfpunkt aktivieren ausgewählt ist.
5. Wählen Sie in der Liste Konfigurieren den Eintrag Systemsteuerung aus und stellen Sie sicher,
dass Zustand bei Neustart wiederherstellen ausgewählt ist.
6. Wählen Sie in der Liste Konfigurieren den Eintrag Verschlüsselungskonfiguration aus.
7. Geben Sie ein Kennwort in die Felder Keystore-Kennwort und Kennwort zum
Benutzer-PrivateKey ein. Das Standardkennwort für den Benutzer-Keystore ist 8deb5102f8.
8. Klicken Sie auf OK.
➤ So importieren Sie die Metadaten-Definitionen für LiveCycle ES:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Geben Sie auf der Anmeldeseite den Benutzernamen und das Kennwort des Systemmanagers ein.
Es folgen die Standardwerte:
Benutzername: system
Kennwort: manager
3. Klicken Sie auf die Registerkarte Administration Console und dann auf Import/Export.
4. Wählen Sie Metadaten aus einer JAR-Datei auf dem Server importieren aus und geben Sie den
vollständigen Pfad zum Speicherort der Metadaten-Vorlage für Business Activity Monitoring an,
die für den Typ der von Ihnen verwendeten LiveCycle ES-Datenbank geeignet ist:
●
(DB2) adobeimport_DB2.jar
●
(MySQL) adobeimport_MySQL.jar
●
(Oracle) adobeimport_Oracle.jar
●
(SQL Server) adobeimport_SQLServer.jar
Diese Dateien werden im Verzeichnis [LiveCycle-Stammverzeichnis]/deploy installiert.
5. Klicken Sie auf OK, um die Datei zu importieren.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von LDAP-Einstellungen für BAM Server 107
Konfigurieren von LDAP-Einstellungen für BAM Server
Zusätzlich zum manuellen Erstellen von Benutzern und Berechtigungen können Sie auch Benutzerdaten
von unterstützten LDAP-Anbietern importieren. Sie können eine automatische Synchronisierung planen
bzw. eine manuelle Synchronisierung mit dem LDAP-Server durchführen, um vorhandene Benutzer und
Rollen automatisch zu aktualisieren.
Beim Synchronisieren mit dem LDAP-Server werden verschiedene Eigenschaften (Basis-DN des Benutzers,
Anmeldedaten und Kennwort, vollständiger Name, Beschreibung, E-Mail-Adresse) in der
BAM Server-Metadaten-Datenbank zwischengespeichert.
Wenn BAM Server Benutzer vom LDAP-Server importiert, werden LDAP-Gruppen in
Business Activity Monitoring-Rollen umgewandelt. Benutzern werden Rollen abhängig
von der Gruppe zugewiesen, der sie auf dem LDAP-Server angehören. (Siehe „Einschränkungen
für LDAP-Verbindungen von BAM Server“ auf Seite 107.)
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:
●
Sie können nur jeweils eine Verbindung zu einem LDAP-Server konfigurieren.
●
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 110.)
●
Wenn BAM Server einen Benutzer importiert und dieser Benutzer einer Gruppe angehört, für die es
keine entsprechende Business Activity Monitoring-Rolle gibt, wird der Benutzer zwar erstellt, jedoch
werden ihm keine Rollen zugewiesen.
●
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:
●
Wenn die Verbindung zum LDAP-Server nicht sicher ist, verwenden Sie SSL.
●
Für die Authentifizierung sollten Sie SASL (Simple Authentication and Security Layer) verwenden.
Diese Methode wird von LDAP unterstützt.
●
Aus Sicherheitsgründen sollten die Zugriffsrechte des LDAP-Synchronisierungsbenutzers auf die
Abfrage des LDAP-Servers beschränkt sein. (Siehe „Konfigurieren der automatischen
LDAP-Synchronisierung“ auf Seite 108.)
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.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der automatischen LDAP-Synchronisierung 108
Konfigurieren der automatischen LDAP-Synchronisierung
Sie haben die Möglichkeit, eine automatische Synchronisierung von BAM Server mit dem LDAP-Server zu
planen. Durch die Synchronisierung wird gewährleistet, dass die Benutzerkonten und Rollendefinitionen,
die von BAM Server in der BAM Server-Metadaten-Datenbank zwischengespeichert werden, mit dem
Inhalt des LDAP-Servers übereinstimmen.
BAM Server erstellt während der Synchronisierung anhand von neuen Gruppen auf dem LDAP-Server
neue Rollen und entfernt Rollen, wenn die entsprechenden Gruppen seit der letzten Synchronisierung
vom LDAP-Server entfernt wurden.
Hinweis: Die Rollen werden selbst dann entfernt, wenn sie manuell erstellten Benutzern zugewiesen
wurden. Wenn die Rollen derartiger Benutzer im Rahmen der Synchronisierung entfernt werden,
bleiben die Benutzerkonten zwar erhalten, jedoch wird die Rollenzuweisung aufgehoben.
➤ So konfigurieren Sie die automatische LDAP-Synchronisierung:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Synchronisierung und aktivieren Sie LDAP aktiviert, wenn die
Option nicht bereits aktiviert ist.
4. Geben Sie Werte für die folgenden Eigenschaften an:
Ursprüngliche Kontextfactory: Der JNDI-Name, über den BAM Server die Verbindung zum
LDAP-Server herstellt. Der Standardwert ist com.sun.jndi.ldap.LdapCtxFactory.
Sie müssen diesen Wert voraussichtlich nicht ändern.
LDAP-Server: Der DNS-Name oder die IP-Adresse des LDAP-Servers.
LDAP-Anschluss: Der Anschluss, an dem der LDAP-Server ausgeführt wird. Der Standardanschluss
ist in der Regel 389. Wenn Sie jedoch die SSL-Option auswählen, ist der Standardanschluss in der
Regel 636. Erkundigen Sie sich beim LDAP-Administrator, welchen Anschluss Sie angeben müssen.
LDAP SSL: Wählen Sie diese Option aus, wenn der LDAP-Server zur Verwendung von SSL
konfiguriert ist. Die Auswahl dieser Option kann sich auf die Einstellung des LDAP-Anschlusses
auswirken.
LDAP-Authentifizierung: Die vom LDAP-Server verwendete Authentifizierungsmethode.
Wahlen Sie eine der folgenden Optionen:
●
Einfach
●
SASL (Simple Authentication and Security Layer). Wählen Sie diese Option für Sun ONE.
●
Compare Encrypted Password
LDAP-Prinzipal-DN-Präfix: Bei der einfachen Authentifizierungsmethode wird der von Ihnen
angegebene Text vor dem Anmeldenamen des Benutzers eingefügt:
●
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=).
●
Bei Active Directory geben Sie keinen Wert ein.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der LDAP-Benutzerzuordnung 109
LDAP-Prinzipal-DN-Suffix: Bei der einfachen Authentifizierungsmethode wird der von Ihnen
angegebene Text nach dem Anmeldenamen des Benutzers eingefügt:
●
Bei LDAP-Servern, bei denen eine DN-Anmeldung erforderlich ist, geben Sie die entsprechende
Wertkette ein. Beim ersten Suffixzeichen muss es sich um ein Komma (,) handeln.
,ou=Users,dc=domain,dc=name
●
Bei Active Directory ist eine einfache Anmeldung mit einer E-Mail-Adresse erforderlich. Geben
Sie daher das Symbol @ gefolgt von dem für Active Directory geltenden Domänennamen ein.
Benutzer-DN zur LDAP-Synchronisierung: Der Benutzer, der die Verbindung zum Server herstellt
und die Liste der Benutzer und Rollen liest. Aus Sicherheitsgründen müssen Sie ein Benutzerkonto
angeben, das nur zum Lesen des LDAP-Verzeichnisses berechtigt ist.
LDAP-Synchronisierungskennwort: Das Kennwort für den Benutzer, der unter „Benutzer-DN zur
LDAP-Synchronisierung“ angegeben wurde.
5. Klicken Sie auf Verbindung testen. Die Verbindung sowie die Konfiguration der Benutzer- und
Rollenzuordnung werden getestet. Wenn die Verbindungseinstellungen korrekt sind und eine
Verbindung hergestellt werden kann, wird eine entsprechende Meldung angezeigt. Wenn Sie die
Benutzer- und Rollenzuordnung für LDAP noch nicht konfiguriert haben, wird ein Fehler ausgegeben.
6. Klicken Sie zum Festlegen des LDAP-Synchronisierungsplans auf die Schaltflächen Zeitplan
hinzufügen, Zeitplan bearbeiten und Zeitplan entfernen, um den gewünschten Zeitplan
zu erstellen, und klicken Sie abschließend auf OK.
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:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Benutzerzuordnung und geben Sie Werte für die folgenden
Parameter ein:
Base DN für LDAP-Benutzer: Das Stammverzeichnis der Struktur, die nach Benutzern
durchsucht wird, wie im folgenden Beispiel gezeigt:
●
(Sun ONE) OU=people,DC=your domain,DC=com
●
(Active Directory) CN=Users,DC=yourdomain,DC=com
Suchfilter für LDAP-Benutzer: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp
am besten geeignet ist. Auf dem LDAP-Server könnte beispielsweise eine spezielle Gruppe für
Business Activity Monitoring-Benutzer eingerichtet sein. Mit diesem Filter könnten Sie dann
gewährleisten, dass nur Benutzer importiert werden, die dieser Gruppe angehören.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren der LDAP-Rollenzuordnung 110
Anmelde-ID für LDAP-Benutzer: Die Anmelde-ID des angegebenen Anbieters. Dieser Wert
wird in Business Activity Monitoring als Anmelde-ID des Benutzers verwendet.
Vollständiger Name des LDAP-Benutzers: Geben Sie cn ein, wenn Sie Sun ONE oder Active
Directory verwenden.
LDAP-Benutzerbeschreibung: Geben Sie description ein, wenn Sie Sun ONE oder Active
Directory verwenden.
Primäre E-Mail-Adresse für LDAP-Benutzer: Geben Sie userPrincipalName ein. Dies bezieht
sich auf die E-Mail-Adresse des Benutzers im LDAP-Verzeichnis.
Verschlüsseltes Kennwort für LDAP-Benutzer: Geben Sie das Kennwort des festgelegten
Benutzers ein, falls Sie Sun ONE oder Tivoli verwenden. Wenn Sie Active Directory verwenden,
übernehmen Sie den Standardwert.
4. Klicken Sie auf die Registerkarte LDAP-Synchronisierung und dann auf Verbindung testen,
um festzustellen, ob die Benutzer erfolgreich importiert werden. Klicken Sie abschließend auf OK.
Konfigurieren der LDAP-Rollenzuordnung
Sie können die Parameter der Rollenzuordnung konfigurieren, die darüber entscheiden, welche Gruppen
oder Rollen importiert und/oder synchronisiert werden. Welche Parameter Sie festlegen können, hängt
vom jeweiligen LDAP-Serveranbieter ab.
➤ So konfigurieren Sie die Parameter für die LDAP-Rollenzuordnung:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Rollenzuordnung und geben Sie Werte für die folgenden
Parameter ein:
Base DN für LDAP-Rolle: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp am
besten geeignet ist:
●
(Sun ONE) OU=Groups,DC=your domain,DC=com
●
(Active Directory) CN=Users,DC=yourdomain,DC=com
Suchfilter für LDAP-Rollen: Das Format, das für den von Ihnen verwendeten LDAP-Servertyp
am besten geeignet ist:
●
(Sun ONE) (&(objectclass=groupOfUniqueNames))
●
(Active Directory) (&(objectclass=group))
Anmelde-ID für LDAP-Rolle: Geben Sie cn ein, wenn Sie Sun ONE oder Active Directory verwenden.
Vollständiger Name der LDAP-Rolle: Geben Sie displayname ein, wenn Sie Sun ONE oder
Active Directory verwenden.
LDAP-Rollenbeschreibung: Geben Sie description ein, wenn Sie Sun ONE oder Active
Directory verwenden.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Manuelles Synchronisieren mit dem LDAP-Server 111
LDAP-Rollenmitglied: Der Name der aus mehreren Werten bestehenden Eigenschaft,
die Rollenmitglieder enthält:
●
(Sun ONE) uniqueMember
●
(Active Directory) member
Art des LDAP-Rollenmitglieds: Verwenden Sie eine der folgenden Optionen:
●
Distinguished Name: Benutzer werden über die Rollenmitgliedseigenschaften anhand
von DN identifiziert, z. B. cn=jadmin,ou=people,dc=your domain,dc=com.
●
Anmelde-ID:: Benutzer werden über die Rollenmitgliedseigenschaften anhand des Werts
der Eigenschaft identifiziert, die als Anmelde-ID für Business Activity Monitoring dient.
4. Klicken Sie auf die Registerkarte LDAP-Synchronisierung und dann auf Verbindung testen,
um festzustellen, ob die Benutzer erfolgreich importiert werden. Klicken Sie abschließend auf OK.
Manuelles Synchronisieren mit dem LDAP-Server
Sie können BAM Server jederzeit manuell mit dem LDAP-Server synchronisieren.
Synchronisierungsanforderungen werden einer Warteschlange hinzugefügt,
um gleichzeitige Synchronisierungen zu vermeiden.
➤ So führen Sie eine manuelle Synchronisierung mit dem LDAP-Server durch:
1. Starten Sie BAM Workbench, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf die Registerkarte Verwaltungskonsole und dann auf Systemeinstellungen.
3. Klicken Sie auf die Registerkarte LDAP-Synchronisierung und dann auf Jetzt synchronisieren.
Die Dauer der Synchronisierung ist von der jeweiligen Umgebung abhängig. Wenn der Vorgang
abgeschlossen ist, wird eine entsprechende Meldung angezeigt.
4. Klicken Sie auf OK.
Verwendet BAM Dashboard
Prozessspezifische Dashboards werden in Business Activity Monitoring erstellt, wenn Sie beim Erstellen
Ihres Prozesses in LiveCycle Workbench ES „BAM-Dashboards automatisch erstellen“ auswählen.
Wenn ein Prozess aktiviert und sofort aufgerufen wird, wird die Prozessinstanz nicht im entsprechenden
BAM Dashboard registriert. BAM Server braucht mehrere Sekunden nach der Prozessaktivierung, bis es die
Prozessaktivität überwachen kann. Warten Sie nach dem Aktivieren eines Prozesses mehrere Sekunden,
bevor Sie den Prozess aufrufen.
Wenn Sie BAM Server installieren, nachdem LiveCycle ES einen Prozess ausgeführt hat, müssen Sie
BAM Dashboard auffüllen. Beim Auffüllen von BAM Dashboard wird BAM Server initialisiert, um mit dem
Abrufen der LiveCycle ES-Datenbank zu beginnen. Sobald dieser Prozess aktiviert ist, kann die AdobeView
aus den Informationen erstellt werden, die aus der LiveCycle ES-Datenbank abgerufen wurden. Bei einer
kompletten LiveCycle ES-Neuinstallation ist die Datenbank leer, so dass keine Ansicht erstellt wird.
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Zusätzliche Dokumentation 112
➤ So füllen Sie BAM Dashboard auf:
1. Melden Sie sich an BAM Workbench an, indem Sie in die Adresszeile eines Webbrowsers
http://[Hostname]:[Anschluss]/bam/workbench eingeben.
2. Klicken Sie auf Application Workbench > Ereignisse.
3. Suchen Sie in der Liste Ereignisse im rechten Bereich die Einträge
ActivityInstanceStartedEvent und ActivityInstanceCompletedEvent.
4. Deaktivieren Sie die einzelnen Ereignisse, indem Sie in der Spalte „Status“ auf die Pfeilschaltfläche
klicken und Abhängigkeiten deaktivieren auswählen.
5. Aktivieren Sie die Ereignisse, indem Sie in der Spalte „Status“ auf die Pfeilschaltfläche klicken und
Alle aktivieren auswählen.
6. Wiederholen Sie die Schritte 3 bis 5 für ProcessInstanceStartedEvent und
ProcessInstanceCompletedEvent.
7. Wiederholen Sie die Schritte 3 bis 5 für alle verbleibenden Ereignisse, mit Ausnahme von AdobeEvent,
VC_SYSTEM_EVENTS und VC_TASK_EVENTS.
Nach dem Auffüllen von BAM Dashboard können Sie sich bei BAM Dashboard anmelden, um die
LiveCycle ES-Prozesse anzuzeigen.
➤ So melden Sie sich an BAM Dashboard an:
1. Geben Sie in einem Webbrowser die URL zum Dashboard ein. Geben Sie beispielsweise Folgendes ein:
http://[Hostname]:[Anschluss]/bam/login/dashboard.htm
2. Melden Sie sich als Administrator an. Für das standardmäßig Administratorkonto für BAM Server gelten
folgende Angaben:
Benutzername: system
Kennwort: manager
Zusätzliche Dokumentation
Weitere Informationen zu Business Activity Monitoring finden Sie in diesen Dokumenten:
●
Verwenden von Business Activity Monitoring Dashboard
●
Business Activity Monitoring-Serverreferenz
●
LiveCycle Workbench ES-Hilfe
Adobe LiveCycle ES
Manuelles Konfigurieren von BAM Server für LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Deinstallation… Business Activity Monitoring 113
Deinstallation… Business Activity Monitoring
Vor einer Neuinstallation müssen Sie BAM Server vollständig deinstallieren.
➤ So deinstallieren Sie BAM Server:
1. Heben Sie die Bereitstellung der EAR-Datei für BAM Server mithilfe der WebSphere Administrative
Console auf.
2. Löschen Sie aus dem Verzeichnis des Wiederherstellungsprotokolls und aus dem
Protokollierungsverzeichnis alle Dateien, deren Namen Ähnlichkeit mit den folgenden
Benennungsmustern aufweisen:
●
filestore*.dat
●
DEFAULTRECOVERYLOGGER_*
●
chkpoint*
3. Überprüfen Sie den Inhalt des Ordners „[Anwendungsserver-Stammverzeichnis]\bin“ und löschen Sie
ggf. vorhandene „chkpoint*“-Dateien.
4. Legen Sie die Datenbanktabellen, in denen die BAM Server-Metadaten gespeichert sind,
mit einem Datenbankverwaltungsprogramm in der Datenbank ab. Sie können auch eine neue
BAM Server-Metadaten-Datenbank erstellen.
8
Erweiterte Konfiguration für Produktionssysteme
In diesem Abschnitt werden erweiterte Optimierungsschritte für LiveCycle Output ES, LiveCycle Forms ES
und LiveCycle PDF Generator ES beschrieben. Die Aufgaben in diesem Abschnitt sollten nur von einem
erfahrenen Anwendungsserveradministrator auf einem Produktionssystem ausgeführt werden.
Konfigurieren der Poolgröße für LiveCycle Output ES und
LiveCycle Forms ES
Der aktuelle Standardwert für „PoolMax“ ist 4. Der tatsächlich festzulegende Wert hängt von der
Hardwarekonfiguration und der erwarteten Nutzung in Ihrer Umgebung ab.
Für eine optimale Nutzung wird empfohlen, den unteren Grenzwert von „PoolMax“ nicht niedriger
als entsprechend der Anzahl der verfügbaren CPUs festzulegen. Der obere Grenzwert muss vom
Verarbeitungslastmuster des Servers bestimmt werden. Generell sollte der obere Grenzwert auf das
Doppelte der Anzahl der CPUs auf dem Server festgelegt werden.
➤ So ändern Sie den vorhandenen Wert von „PoolMax“:
1. Melden Sie sich bei WebSphere Administrative Console an.
2. Klicken Sie in der Navigationsstruktur auf Servers > Application Servers > [Servername] > Java and
Process Management > Process Definition > Java Virtual Machine > Custom Properties.
3. Fügen Sie für „ConvertPdf“ die folgenden Eigenschaften hinzu:
●
com.adobe.convertpdf.bmc.POOL_MAX=[neuer Wert]
●
com.adobe.convertpdf.bmc.MAXIMUM_REUSE_COUNT=5000
●
com.adobe.convertpdf.bmc.REPORT_TIMING_INFORMATION=true
●
com.adobe.convertpdf.bmc.CT_ALLOW_SYSTEM_FONTS=true
4. Fügen Sie für „XMLFM“ die folgenden Eigenschaften hinzu:
●
com.adobe.xmlform.bmc.POOL_MAX=[neuer Wert]
●
com.adobe.xmlform.bmc.MAXIMUM_REUSE_COUNT=5000
●
com.adobe.xmlform.bmc.REPORT_TIMING_INFORMATION=true
●
com.adobe.xmlform.bmc.CT_ALLOW_SYSTEM_FONTS=true
114
Adobe LiveCycle ES
Erweiterte Konfiguration für Produktionssysteme
Installieren und Bereitstellen von LiveCycle ESWebSphere
LiveCycle PDF Generator ES 115
LiveCycle PDF Generator ES
LiveCycle PDF Generator ES kann bei bestimmten Typen von Eingabedateien mehrere PDF-Konvertierungen
gleichzeitig ausführen. Dies wird mithilfe von Session Beans ohne Status erzwungen.
Konfigurieren der EJB-Poolgröße
Zum Erzwingen unabhängiger Poolgrößen stehen für die folgenden Typen von Eingabedateien vier
verschiedene Session Beans ohne Status zur Verfügung:
●
Adobe PostScript®- und Encapsulated PostScript (EPS)-Dateien
●
Bilddateien (z. B. BMP-, TIFF-, PNG- und JPEG-Dateien)
●
OpenOffice-Dateien
●
Alle anderen Dateitypen (außer HTML-Dateien) wie etwa Microsoft Office-, Photoshop®-, PageMaker®und FrameMaker®-Dateien
Die Poolgröße für HTML-zu PDF-Konvertierungen kann nicht über Session Beans ohne Status verwaltet
werden.
Die standardmäßige Poolgröße für PostScript-, EPS- und Bilddateien ist auf 3, für OpenOffice und andere
Dateitypen (außer HTML) auf 1 festgelegt.
Sie können die Poolgröße für PS/EPS- und Bilddateien basierend auf der Konfiguration Ihrer Serverhardware
(z. B. Anzahl der CPUs, der Kernels jeder CPU usw.) festlegen. Für OpenOffice und andere Dateitypen muss
die Poolgröße dagegen unverändert bleiben (d. h. 1), damit PDF Generator ES ordnungsgemäß
funktioniert.
In diesem Abschnitt wird erläutert, wie die Poolgröße für die PS-zu-PDF- und Bilddatei-zu-PDF-Konvertierung
für die unterstützten Anwendungsserver festgelegt werden kann.
Nachfolgend wird angenommen, dass die beiden folgenden LiveCycle ES-Anwendungs-EAR-Dateien
auf dem Anwendungsserver bereitgestellt wurden:
●
adobe-livecycle-websphere.ear
●
adobe-livecycle-native-websphere-[Plattform].ear
wobei [Plattform] durch eine der folgenden Zeichenfolgen zu ersetzen ist, je nach Betriebssystem:
●
(Windows) x86_win32
●
(Linux) x86_linux
●
(SunOS™) sparc_sunos
●
(AIX) powerpc_aix
➤ So konfigurieren Sie die Poolgröße für die PS-zu-PDF- und Bilddatei-zu-PDF-Konvertierung:
1. Stellen Sie sicher, dass WebSphere Application Server ausgeführt wird.
2. Starten Sie die Verwaltungskonsole von WebSphere, indem Sie in die Adresszeile eines Browsers
http://[Hostname]:9060/ibm/console eingeben. Die Adresse kann anders lauten, wenn
WebSphere an einem nicht standardmäßigen Anschluss ausgeführt oder HTTPS erzwungen wird.
Falls Sicherheitseinstellungen aktiviert sind, werden Sie zur Angabe des Benutzernamens und
Kennworts aufgefordert.
Adobe LiveCycle ES
Erweiterte Konfiguration für Produktionssysteme
Installieren und Bereitstellen von LiveCycle ESWebSphere
Konfigurieren der EJB-Poolgröße 116
3. Klicken Sie in der Navigationsstruktur von WebSphere Administrative Console auf Servers >
Application Servers und klicken Sie anschließend auf einen Servernamen.
4. Klicken Sie unter „Server Infrastructure“ auf > Java and Process Management > Process Definition.
5. Klicken Sie unter Additional Properties auf Java Virtual Machine.
6. Klicken Sie unter „Additional Properties“ auf Custom Properties.
7. Suchen Sie die Eigenschaft com.ibm.websphere.ejbcontainer.poolSize und klicken Sie, falls
vorhanden, auf den Namen. Klicken Sie andernfalls auf New und geben Sie den Eigenschaftsnamen
com.ibm.websphere.ejbcontainer.poolSize ein. Falls die Eigenschaft bereits vorhanden ist,
wird ihr Wert wie folgt angezeigt:
LiveCycle8#adobe-pdfg-bmc-invoker-ejb.jar#NativeToPDFInvoker=1,1:LiveCycle
8#adobe-pdfg-bmc-invoker-ejb.jar#OpenOfficeToPDFInvoker=1,1:LiveCycle8#ado
be-pdfg-bmc-invoker-ejb.jar#ImageToPDFInvoker=3,3:LiveCycle8#adobe-pdfg-bm
c-invoker-ejb.jar#PSToPDFInvoker=3,3.
Im vorstehenden Code geben ImageToPDFInvoker=3,3 und PSToPDFInvoker=3,3 an,
dass die Werte für die minimale und maximale EJB-Poolgröße für Bilddatei-zu-PDF- und
PS-zu-PDF-Konvertierungen auf 3 festgelegt sind.
8. Ändern Sie diese Werte den Anforderungen entsprechend. Wenn Sie für
Bilddatei-zu-PDF-Konvertierungen die Poolgröße 5 und für PS-zu-PDF-Konvertierungen
die Poolgröße 8 festlegen möchten, muss der geänderte Eigenschaftswert wie folgt lauten:
LiveCycle8#adobe-pdfg-bmc-invoker-ejb.jar#NativeToPDFInvoker=1,1:LiveCyc
le8#adobe-pdfg-bmc-invoker-ejb.jar#OpenOfficeToPDFInvoker=1,1:LiveCycle8
#adobe-pdfg-bmc-invoker-ejb.jar#ImageToPDFInvoker=5,5:LiveCycle8#adobe-p
dfg-bmc-invoker-ejb.jar#PSToPDFInvoker=8,8.
Hinweis: In der vorstehenden Zeichenfolge steht LiveCycle8 für den Namen der
LiveCycle ES-Anwendung, die auf Ihrem Anwendungsserver bereitgestellt wird
(beispielsweise adobe-livecycle-websphere).
9. Speichern Sie die Änderungen und starten Sie den WebSphere-Anwendungsserver erneut.
Hinweis: Wenn Sie einen Anwendungsservercluster ausführen, müssen Sie auf jedem der Knoten des
Anwendungsserverclusters identische Änderungen vornehmen. Um Zeit zu sparen,
sollten Sie die Änderungen vornehmen, bevor Sie einen Cluster erstellen. Auf diese Weise
werden die Werte automatisch auf jedem erstellten Clusterknoten festgelegt, nachdem diese
Änderungen auf dem primären Knoten vorgenommen wurden.
9
Fehlerbehebung
In diesem Kapitel werden Probleme beim Installieren und Bereitstellen von LiveCycle ES beschrieben und
Vorschläge zur ihrer Vermeidung bzw. Umgehung gemacht.
Anfordern von Hilfe
In diesem Abschnitt werden die Schritte genannt, die Sie vor Kontaktieren des Adobe-Support ausführen
sollten. Wenn durch Konsultieren der LiveCycle ES-Dokumentation Ihre Probleme nicht behoben werden
konnten, wenden Sie sich an den Adobe-Support. Damit wir Ihr Anliegen schnell bearbeiten können,
halten Sie Antworten auf die folgenden Fragen bereit:
●
Was haben Sie gemacht, als das Problem auftreten ist?
●
Können Sie das Problem reproduzieren?
●
Wurde eine Fehlermeldung angezeigt, als das Problem auftrat? Ist Ihnen sonst noch etwas aufgefallen?
●
Treten die Fehler weiterhin auf, wenn Sie in Internet Explorer („Extras > Internetoption > Erweitert“)
die Option „Kurze HTTP-Fehlermeldungen anzeigen“ deaktivieren?
Installationseinstellungen
Wenn bei der Installation, Konfiguration und Bereitstellung von LiveCycle ES Probleme auftreten,
vergewissern Sie sich, dass Sie die Anweisungen in den folgenden LiveCycle ES-Dokumenten
ordnungsgemäß befolgt haben:
●
Vorbereiten der Installation von LiveCycle ES
●
Dokument Installation und Bereitstellen von LiveCycle ES für Ihren Anwendungsserver
●
Verwalten von LiveCycle ES
Wenn Sie alle Installations- und Konfigurationsschritte gemäß der Dokumentation ausgeführt haben,
finden Sie in den folgenden Abschnitten Probleme, die Ihren ggf. ähneln.
Anwendungsservereinstellungen
Stellen Sie sicher, dass die Einstellungen Ihres Anwendungsservers wie folgt lauten, bevor Sie sich an den
Adobe-Support wenden:
●
Total transaction lifetime timeout: 300
●
Ursprüngliche Heap-Größe: 256
●
Maximale Heap-Größe: 1.024 MB
●
Prepared Statement Cache: 100
●
Database Connection Pool Maximum: IDP_DS ist 30, RM_DS ist 20, BAM-Metadaten-Datenbank ist 20.
●
Topics and queues connection factories maximum pool connections: 50
117
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlerbehebung
Datenbankinitialisierungseinstellungen 118
Datenbankinitialisierungseinstellungen
Wenn es Probleme beim Initialisieren des LiveCycle ES-Servers gibt, prüfen Sie folgende Einschränkungen:
●
Die Namen von Datenbankinstanzen dürfen nur alphanumerische Zeichen enthalten.
●
(Linux und UNIX) Die Namen von Datenbankinstanzen dürfen den plattformspezifischen Grenzwert
von 8 Zeichen nicht überschreiten.
Wenn die Initialisierung am Anfang des Prozesses fehlschlägt, prüfen Sie, ob folgende Bedingungen
erfüllt sind:
●
Die LiveCycle ES-Datenbank wurde erstellt und der Benutzer hat Vollzugriffsrechte für die Datenbank.
●
Mit dem PING-Befehl ist ein Zugriff auf den Datenbankserver möglich.
●
Die Datenbank ist leer, d. h. sie enthält keine Tabellen, Sequenzen, Sichten oder Indextabellen.
●
Der JNDI-Name für IDP_DS wurde erstellt.
Wenn die Initialisierung beim Schreiben in die Registrierung fehlschlägt, überprüfen Sie die
Anwendungsserverprotokolle auf Fehler zu Warteschlangen und Themen. Sind Fehler vorhanden,
prüfen Sie, ob die Warteschlangen und Themen ordnungsgemäß konfiguriert wurden.
Verarbeiten vieler gleichzeitiger Aufrufe
Wenn Sie viele gleichzeitige Aufrufe erwarten, erhöhen Sie maximale Verbindungs-Poolgröße für die
Datenquelle (IDP_DS) auf einen Wert, der höher als die Anzahl gleichzeitiger Aufrufe ist.
Fehlerbehebung mit Protokolldateien
In diesem Abschnitt wird beschrieben, wie Sie Fehler in LiveCycle ES mithilfe der Protokolldateien beheben.
Protokolldatei von LiveCycle Configuration Manager
Standardmäßig befindet sich die LiveCycle Configuration Manager-Protokolldatei im Verzeichnis
„[LiveCycleES -Stammverzeichnis]\ConfigurationManager\log“ und heißt „lcm.0.log“ (oder ähnlich).
Die Protokolldateien sind bei der Fehleranalyse in LiveCycle Configuration Manager nützlich und
werden eventuell vom Support von Adobe Enterprise benötigt.
Anzeigen der JVM-Systemausgabe- und Fehlerprotokolle
Die JVM-Systemausgabe- und Fehlerprotokolle sind wichtige Hilfsmittel bei der Diagnose
von Serverstörungen.
➤ So zeigen Sie die JVM-Systemausgabe- und Fehlerprotokolle an:
1. Melden Sie sich bei der WebSphere Administrative Console an und klicken Sie in der Navigationsstruktur
auf Troubleshooting > Logs and Trace.
2. Klicken Sie auf den Namen des Anwendungsservers und anschließend auf JVM Logs.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Löschen der Transaktionsprotokolldatei des Anwendungsservers 119
3. Klicken Sie auf die Registerkarte Runtime und klicken Sie auf View entweder unter „System.out“,
um das JVM-Systemausgabeprotokoll anzuzeigen, oder unter „System.err“, um das Fehlerprotokoll
anzuzeigen. Wenn diese Wahlmöglichkeiten nicht zur Verfügung stehen, können Sie die Protokolle
über die Registerkarte Configuration anzeigen, indem Sie die Dateinamen SystemOut.log und
SystemErr.log angeben. Der Standardspeicherort der Dateien lautet wie folgt:
[Anwendungsserver-Stammverzeichnis]/profiles/[Profilname]/logs/
[Servername]
Löschen der Transaktionsprotokolldatei des Anwendungsservers
Wenn die Bereitstellung der Lösungskomponenten aus irgendeinem Grund fehlschlägt,
wird der Anwendungsserver, der als Host für LiveCycle ES dient, nicht neu gestartet, da er versucht,
die für ihn vermeintlichen rückgängig gemachten Transaktionen wiederherzustellen, was aber fehlschlägt.
Um dieses Problem zu beheben, suchen und löschen Sie die Transaktionsprotokolldatei des
Anwendungsservers und starten den Anwendungsserver neu.
Exception: No trusted certificate found
Ihr WebSphere Application Server meldet möglicherweise Ausnahmen, die den nachfolgend
beschriebenen Ausnahmemeldungen ähneln.
An der LiveCycle Administration Console angezeigte Ausnahmen:
Could not connect to Inbox. Error message: com.ibm.jsse2.util.h:
No trusted certificate found; nested exception is:
javax.net.ssl.SSLHandshakeException:
com.ibm.jsse2.util.h: No trusted certificate found
In WebSphere Application Server-Protokolldateien angezeigte Ausnahmen:
[5/28/08 13:15:30:283 CDT] 00000025 SystemOut
O
CWPKI0022E: SSL HANDSHAKE FAILURE: A signer with SubjectDN
"CN=imap.gmail.com, O=Google Inc, L=Mountain View, ST=California, C=US"
was sent from target host:port "null:null". The signer may need to be
added to local trust store "D:/servers/websphere6.1/profiles/AppSrv01
/config/cells/MN-TOBIKONode01Cell/nodes/MN-TOBIKONode01/trust.p12"
located in SSL configuration alias "NodeDefaultSSLSettings" loaded from
SSL configuration file "security.xml". The extended error message from
the SSL handshake exception is: "No trusted certificate found".
[5/28/08 13:15:30:283 CDT] 00000025 SystemOut
O
[5/28/08 13:15:30:283 CDT] 00000025 ExceptionUtil E
CNTR0020E: EJB threw an unexpected (non-declared) exception during
invocation of method "doSupports" on bean "BeanId(adobe-core-websphere
#adobe-dscf.jar#EjbTransactionCMTAdapter, null)". Exception data:
java.lang.RuntimeException: Could not connect to Inbox. Error message:
com.ibm.jsse2.util.h: No trusted certificate found;
nested exception is:
javax.net.ssl.SSLHandshakeException:
com.ibm.jsse2.util.h: No trusted certificate found
Dieses Problem tritt auf, wenn der WebSphere-Keystore ein erforderliches Zertifikat nicht enthält. Hierbei
ist zu beachten, dass der standardmäßige WebSphere-Keystore nur eine begrenzte Anzahl von Zertifikaten
enthält. Führen Sie die folgenden Schritte aus, um ein neues Zertifikat zum WebSphere-Keystore
hinzuzufügen.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren des Scheduler-Dienstes für nicht standardmäßige
JNDI-URLs 120
➤ So fügen Sie ein neues Zertifikat zum WebSphere-Keystore hinzu:
1. Ermitteln Sie das entsprechende Zertifikat im E-Mail-Dienst.
2. Kopieren Sie das Zertifikat nach [Anwendungsserver-Stammverzeichnis]\profiles\[Servername]\etc. . .
3. Melden Sie sich bei der WebSphere Administrative Console an und klicken Sie auf Security >
SSL certificate and key management.
4. Klicken Sie unter „Related Items“ auf Key stores and certificates und anschließend
auf CellDefaultTrustStore.
5. Unter „Additional Properties“ klicken Sie auf Signer certificates und anschließend auf Add.
6. Geben Sie in das Feld Alias einen geeigneten Alias für das Zertifikat ein, das Sie importieren.
7. Geben Sie in das Feld File name den Speicherort ein, an dem Sie das Zertifikat in Schritt 2 installiert
haben, und klicken Sie anschließend auf OK.
8. Klicken Sie auf Save directly to the master configuration. Das Zertifikat, das gerade hinzugefügt
wurde, sollte nun als Unterzeichner-Zertifikat aufgelistet werden.
9. Starten Sie WebSphere Application Server neu.
Konfigurieren des Scheduler-Dienstes für nicht standardmäßige
JNDI-URLs
Eventuell benötigt der Scheduler-Dienst zusätzliche Konfigurationseinstellungen, um richtig
zu funktionieren.
Umgebungen ohne Cluster
Falls sich der JNDI-URL vom standardmäßigen JNDI-URL für den Anwendungsserver unterscheidet
(z. B. bei WebSphere: iiop://localhost:2809), benötigen Sie den folgenden JNDI-URL für den IDP_DS,
der von Ihrem Anwendungsserver verwaltet wird:
org.quartz.dataSource.idp.java.naming.provider.url
➤ So stellen Sie die Scheduler-Eigenschaften ein:
1. Erstellen Sie eine neue Datei namens „dscscheduler.properties“.
2. Legen Sie die Werte der oben genannten Eigenschaften entsprechend den Anforderungen für den
Knoten des Anwendungsservers fest, wie beispielsweise:
org.quartz.dataSource.idp.java.naming.provider.url =
iop://localhost:2809/
org.quartz.jobstore.isClustered = true
org.quartz.scheduler.instanceId = AUTO
3. Fügen Sie das JVM-Argument
-Dadobe.idp.scheduler.properties=[Pfad zu dieser Datei]/
dscscheduler.properties zu den Startskriptdateien bzw. der Konfiguration
des Anwendungsservers hinzu.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlermeldungen 121
Fehlermeldungen
In diesem Abschnitt werden LiveCycle ES-spezifische Fehlermeldungen und Lösungen der zugrunde
liegenden Probleme beschrieben.
Beim Konvertieren nativer Dateien schlägt Klasse nicht gefunden
Wenn diese Fehlermeldung angezeigt wird, prüfen Sie, ob eines dieser Probleme vorliegt, und lösen es ggf.:
●
Ist die Klassenpfadeinstellung ungültig oder nicht vorhanden?
●
Ist die JAR-Datei veraltet?
●
Gibt es in der Klasse ein Kompilierungsproblem?
JNDI-Name nicht gefunden
Wenn diese Fehlermeldung angezeigt wird, prüfen Sie, ob eine Ausnahmestapelverfolgung mit folgender
Zeichenfolge vorhanden ist:
javax.naming.NameNotFoundException: jdbc/<falscher Name>
Falls der erwartete Name nicht falsch geschrieben ist, müssen Sie den Code korrigieren.
➤ So beseitigen Sie die gängigsten JNDI-Ausnahmen:
1. Überprüfen Sie die JNDI-Struktur auf dem LiveCycle ES-Anwendungsserver. Wird der verwendete
Name in der Struktur angezeigt?
●
Falls ja, ist es sehr wahrscheinlich, dass Ihr Code das Objekt InitialContext nicht
ordnungsgemäß einrichtet, das für die Suche verwendet wird, und die Suche in einer JNDI-Struktur
erfolgt, die nicht diejenige ist, in der die Ressource aufgelistet ist. Überprüfen Sie im Handbuch
Installieren und Bereitstellen von LiveCycle ES für Ihren Anwendungsserver die zu verwendenden
Eigenschaftswerte.
●
Falls nein, fahren Sie mit Schritt 2 fort.
2. Wird die Ressourcen in der JNDI-Struktur unter einem anderen Namen als dem in der Suche
angegebenen Namen aufgeführt?
●
Falls ja, verwenden Sie den falschen Suchnamen. Geben Sie den ordnungsgemäßen Namen an.
●
Falls nein, fahren Sie mit Schritt 3 fort.
3. Überprüfen Sie beim Systemstart die Protokolle des Anwendungsservers. Wenn der Anwendungsserver
so konfiguriert ist, dass diese Ressource verfügbar sein soll, aber ein Fehler auftritt, wird an dieser Stelle
eine Ausnahme angezeigt. Wie lautet die Ausnahme?
●
Falls ja, überprüfen Sie die Ausnahme und die Stapelablaufverfolgung. Wenn eine Ausnahme
vom Typ NameNotFoundException (Name nicht gefunden) im Rahmen Ihrer Untersuchung der
Serverprotokolle ein Symptom eines anderen Problems ist, wechseln Sie zu den
Fehlerbehebungsschritten für dieses Problem.
●
Falls nein, fahren Sie mit Schritt 4 fort.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehler beim Bereitstellen der Datei „adobe-livecycle-websphere.ear“ 122
4. Wenn die Ressource nicht in der JNDI-Struktur aufgeführt ist und beim Start keine Ausnahme auftritt,
die erklärt, warum diese nicht zur Verfügung steht, ist der Anwendungsserver wahrscheinlich nicht
ordnungsgemäß für die Bereitstellung dieser Ressource konfiguriert. Prüfen Sie die Konfiguration des
Anwendungsservers. Ist er für die Bereitstellung dieser Ressource konfiguriert?
●
Falls nein, lesen Sie das Kapitel „Konfigurieren der Verbindung zur Datenbank“ in diesem
Handbuch.
●
Ist dies der Fall, handelt es sich nicht um eines der gängigen Probleme, die als Ursache dieses
Fehlers gelten. Wenden Sie sich an den Adobe-Support.
Fehler beim Bereitstellen der Datei „adobe-livecycle-websphere.ear“
In diesem Abschnitt wird erklärt, wie Sie eine fehlgeschlagene Bereitstellung korrigieren, wenn beim
Versuch der Bereitstellung der Datei „adobe-livecycle-websphere.ear“ die folgende Fehlermeldung
angezeigt wird:
Could not deploy adobe-livecycle-websphere.ear.
com.adobe.livecycle.cdv.CDVException[ALC-LCM-030-112]: Fehler beim
Bereitstellen von EAR. Could not deploy adobe-livecycle-websphere.ear.
➤ So korrigieren Sie eine fehlerhafte WebSphere-Bereitstellung:
1. Führen Sie im Befehlsfenster den Befehl limit -n aus.
2. Wenn der Wert 1024 zurückgegeben wird, erhöhen Sie den Wert im Skript wasadmin.sh auf 2048.
3. Öffnen Sie das Skript „[Anwendungsserver-Stammverzeichnis]/bin/wsadmin.sh“ in einem Texteditor.
Fügen Sie in der Datei hinter der Kopfzeile mit dem Kommentarblock die Zeile ulimit -n 2048
hinzu.
4. Starten Sie WebSphere neu und stellen Sie die Datei „adobe-livecycle-websphere.ear“ mithilfe von
LiveCycle Configuration Manager bereit.
J2CA0294W-Warnmeldungen
Sie können die WebSphere-Protokollierungsstufe ändern, um Warnmeldungen in der Datei
„SystemOut.log“ zu vermeiden, die mit der abgelehnten Verwendung des direkten JNDI-Lookups
zusammenhängen.
Um die Warnmeldung J2CA0294W in „SystemOut.log“ zu unterdrücken, ändern Sie die
Protokollierungsstufe in *=info:com.ibm.ejs.j2c.ConnectionFactoryBuilderImpl=severe.
➤ So ändern Sie die Protokollierungsstufen:
1. Melden Sie sich über die URL http://[Hostname]:9060/admin bei der WebSphere Administrative
Console an und klicken Sie in der Navigationsstruktur auf Troubleshooting > Logs and Trace.
2. Klicken Sie im rechten Fenster auf den Namen des Anwendungsservers und anschließend
auf Change Log Detail Levels.
3. Geben Sie auf der Registerkarte „Configuration“ die folgende Zeichenfolge ein:
*=info:com.ibm.ejs.j2c.ConnectionFactoryBuilderImpl=severe
4. Klicken Sie auf OK und dann auf Save directly to the master configuration.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlerbehebung
Die Datei „adobe-livecycle-websphere.ear“ wird nicht auf der
64-Bit-Version von WebSphere bereitgestellt 123
Die Datei „adobe-livecycle-websphere.ear“ wird nicht auf der
64-Bit-Version von WebSphere bereitgestellt
Beim Bereitstellen der Datei „adobe-livecycle-websphere.ear“ (manuell oder mithilfe von LiveCycle
Configuration Manager) auf einer 64-Bit-Version eines WebSphere-Anwendungsservers wird eventuell
die folgende Fehlermeldung angezeigt:
Error executing deployment: java.lang.IllegalStateException. Error is Unable
to acquire application service. Ensure that the org.eclipse.core.runtime
bundle is resolved and started (see config.ini)..
java.lang.IllegalStateException: Unable to acquire application service. Ensure
that the org.eclipse.core.runtime bundle is resolved and started (see
config.ini).
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start
(EclipseAppLauncher.java:65)
Tritt dieser Fehler in der WebSphere Administrative Console auf, wird empfohlen, dass Sie Ihren
Anwendungsserver auf WebSphere Fixpack 15 und SR6 aktualisieren.
Ausnahmen beim mehrfachen Initialisieren der Datenbank
Wenn Sie die LiveCycle ES-Datenbank initialisieren, nachdem sie bereits initialisiert wurde, werden eventuell
Ausnahmen ausgegeben, die darauf hinweisen, dass das POF-Schema bereits initialisiert wurde.
Sie können diesen Fehler einfach ignorieren.
XMLForm.exe-Berechtigungsfehler
In Forms ES tritt ein UNIX/Linux-Berechtigungsproblem auf, wenn die folgende Fehlermeldung
protokolliert wird:
Cannot add execute permission on file /[Pfad zu XMLForm.exe]
Um diesen Fehler zu beheben, stellen Sie sicher, dass der Auslagerungsspeicher auf Servern mit UNIX und
Linux mindestens 3 GB groß ist.
J2CA0081E: Method cleanup error on SQL Server
Wenn der Fehler „J2CA0081E: Method cleanup failed while trying to execute method cleanup...“ angezeigt
wird, sieht die Stapelablaufverfolgung wie folgt aus:
"00000057 MCWrapper E J2CA0081E: Method cleanup failed while trying to execute
method cleanup on ManagedConnection WSRdbManagedConnectionImpl@6d826d82 from
resource SP_DS. Caught exception: com.ibm.ws.exception.WsException:
DSRA0080E: An exception was received by the Data Store Adapter. See original
exception message: This operation is not supported.. with SQL State : null SQL
Code : 0"
Sie müssen auf SQL Server 2005, JDBC-Treiberversion 1.2, aktualisieren. Laden Sie diesen Treiber vom
Microsoft Download Center herunter.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlerbehebung
Fehler bei der Datenbankinitialisierung auf WebLogic 124
Fehler bei der Datenbankinitialisierung auf WebLogic
Folgende Ausnahme kann beim Initialisieren der LiveCycle ES-Datenbank auf WebLogic Server auftreten:
Servlet failed with Exception java.lang.ClassCastException:
weblogic.jndi.factories.java.ReadOnlyContextWrapper at
com.adobe.livecycle.bootstrap.framework.BootstrapServlet.checkDatasource
(BootstrapServlet.java:216)
Ändern Sie zur Behebung dieses Problems die Datei „IDP_DS-3079-jdbc.xml“.
➤ So ändern Sie die Datei „IDP_DS-3079-jdbc.xml“:
1. Suchen Sie die Datei IDP_DS-3079-jdbc.xml im Verzeichnis [Anwendungsserver-Domäne]/config/jdbc
und öffnen Sie sie in einem Editor.
2. Suchen Sie die Zeile <jndi-name></jndi-name> und löschen Sie sie.
3. Speichern und schließen Sie die Datei und initialisieren Sie die Datenbank neu.
Zu wenig Arbeitsspeicher: Java-Heap-Speicherfehler
In LiveCycle ES sind Transaktionen möglich, deren Ausführung länger dauert als vom standardmäßigen
WebLogic-Transaktionszeitlimit vorgesehen. Die Verarbeitung großer PDF-Dokumente kann
beispielsweise sehr zeitaufwendig sein. Diese Fehler werden ggf. im Anwendungsserverprotokoll
angezeigt, wenn LiveCycle Workbench ES-Benutzer große Dateien in die Ansicht „Ressourcen“ ziehen.
Wenn OutOfMemoryError-Meldungen im Anwendungsserverprotokoll auftreten, müssen Sie das
Transaktionszeitlimit erhöhen. Der empfohlene Wert betragt 300 Sekunden (5 Minuten). Der Wert für das
Transaktionszeitlimit muss höher als das konfigurierte maximale Transaktionszeitlimit sein.
➤ So legen Sie das Transaktionszeitlimit von WebSphere fest:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Servers >
Application servers > [Servername].
2. Klicken Sie unter „Container Settings“ auf Container Services > Transaction Service.
3. Geben Sie unter General Properties in das Feld Total transaction lifetime timeout den Wert 300
(oder höher) ein.
4. Stellen Sie in „General Properties“ sicher, dass der Wert für Maximum transaction timeout größer
gleich dem für die Eigenschaft Total transaction lifetime timeout angegebenen Wert ist.
5. Klicken Sie auf „OK“.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlerbehebung
Unnötige SystemOut-Meldungen beim Bereitstellen
von Lösungskomponenten 125
Unnötige SystemOut-Meldungen beim Bereitstellen
von Lösungskomponenten
Es ist ein bekanntes Problem, dass beim Bereitstellen der LiveCycle ES-Lösungskomponenten auf dem
WebSphere Application Server unnötige SystemOut-Meldungen wie etwa die folgende in die Protokolldatei
„system.out“ geschrieben werden:
[2/26/08 19:16:34:303 CST] 00000022 SystemOut
Oflex.management.runtime.messaging.services.remoting.
RemotingDestinationControl
[2/26/08 19:16:34:304 CST] 00000022 SystemOut
O 9
[2/26/08 19:16:34:305 CST] 00000022 SystemOut
O
flex.management.runtime.messaging.services.remoting.adapters.
JavaAdapterControl
IBM stellt in seiner Liste Available Fixes einen Patch bereit, um dieses Problem zu beheben.
Connector for EMC Documentum-Fehler
Bei der Verwendung von LiveCycle ES Connector for EMC Documentum mit dem Documentum
DFC 5.3-Client, der auf dem LiveCycle ES-Server installiert ist, können folgende Fehler in den
Serverprotokollen angezeigt werden:
DM_CCONTENT_E_REMOVE_DIRECTORY
Tritt dies auf, fügen Sie folgenden Eintrag dem Abschnitt [DMAPI_CONFIGURATION] der Datei dmcl.ini
hinzu:
'local_clean_on_init=F'
Auf einem Windows-Server befindet sich die Datei dmcl.ini standardmäßig im Ordner
[Windows-Installationslaufwerk]\WINDOWS.
Starten Sie den LiveCycle ES-Server neu, um diese Änderung zu übernehmen.
Fehler beim Bereitstellen von EAR-Dateien
Abhängig von den zu installierenden LiveCycle ES-Diensten und Ihrer Systemkonfiguration werden bei
der Bereitstellung der EAR-Dateien Fehlermeldungen angezeigt. Tritt dies auf, erhöhen Sie den Wert
von MaxPermSize auf Ihrem Anwendungsserver von 256 auf 512. Spezifische Anleitungen zum
Festlegen dieses Werts auf Ihrem Anwendungsserver finden Sie in Vorbereiten der Installation von
LiveCycle ES.
Die Ausnahme „Java NameNotFoundException“
Beim Bootstrapping von User Manager-Komponenten für WebSphere Application Server wird nach dem
Start der Anwendung die folgende Ausnahmefehlermeldung nur einmal angezeigt:
00000043 javaURLContex E NMSV0310E: A JNDI operation on a "java:" name cannot
be completed because the server runtime is not able to associate the
operation's thread with any J2EE application component. This condition can
occur when the JNDI client using the "java:" name is not executed on the thread
of a server application request. Make sure that a J2EE application does not
execute JNDI operations on "java:" names within static code blocks or in
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlerbehebung
LiveCycle Configuration Manager-Validierungsfehler während der
JMS-Einrichtung 126
threads created by that J2EE application. Such code does not necessarily run on
the thread of a server application request and therefore is not supported by
JNDI operations on "java:" names Exception stack trace:
javax.naming.ConfigurationException [Root exception is
javax.naming.NameNotFoundException: Name comp/env/ejb not found in context
"java:".]
Sie können diesen Fehler einfach ignorieren.
LiveCycle Configuration Manager-Validierungsfehler während der
JMS-Einrichtung
Beim Validieren Ihres WebSphere Application Server-Clusters mit LiveCycle Configuration Manager
wird eventuell eine JMS-Ausnahme ausgegeben. Dieses Problem tritt auf, wenn das Verzeichnis
„[Anwendungsserver-Stammverzeichnis]/lib“ ungeeignete JDBC-Treiber enthält. Um das Problem
zu beheben, entfernen Sie alle JDBC-Treiber aus dem Verzeichnis
„[Anwendungsserver-Stammverzeichnis]/lib“.
Durch die folgenden Schritte lassen sich LiveCycle Configuration Manager-Validierungsfehler beheben,
die bei Verwendung von Microsoft SQL Server als JMS-Datenbank auftreten können.
➤ So überprüfen Sie die JMS-Einrichtung mit SQL Server:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Service
Integration > Buses und anschließend im rechten Fenster auf IDP_JMS_BUS.
2. Klicken Sie unter Topology auf Messaging Engines. Wenn alles ordnungsgemäß funktioniert, wird ein
grüner Pfeil angezeigt. Der Status des Busses ist zu diesem Zeitpunkt wahrscheinlich unbekannt.
3. Wählen Sie Ihre Messaging-Engine aus und klicken Sie unter Additional Properties auf Message
Store. Der Schemaname muss mit dem Benutzernamen übereinstimmen. Ist dies nicht der Fall,
legen Sie ihn entsprechend fest. Um die Microsoft SQL Server-Datenbank und -Benutzer einzurichten,
lesen Sie Vorbereiten der LiveCycle ES-Installation.
4. Klicken Sie auf „OK“ und dann auf „Save directly to the Master Configuration“.
5. Löschen Sie sämtliche Tabellen, die mit SIB beginnen, um Konflikte mit alten Buskonfigurationen zu
vermeiden.
6. Starten Sie WebSphere neu und wiederholen Sie Schritt 1, um sicherzustellen, dass der Bus
funktioniert.
Hinweis: Sie können die LiveCycle Configuration Manager-Validierung ausführen, um sicherzustellen,
dass JMS erfolgreich eingerichtet wurde.
Bereitstellen von LiveCycle ES in einer verteilten Umgebung
Wenn sich die Anwendungsserverinstanz auf einem anderen Server und nicht auf dem Server mit dem
Bereitstellungsmanager, befindet, müssen Sie die LiveCycle ES-EAR-Dateien manuell bereitstellen.
Wenn Sie die Bereitstellung mithilfe von LiveCycle Configuration Manager durchzuführen versuchen,
erhalten Sie eine Fehlermeldung, die besagt, dass die Bereitstellung fehlgeschlagen ist.
Führen Sie das folgende Verfahren aus, wenn dieser Fehler bei Verwendung von LiveCycle Configuration
Manager für die Bereitstellung der EAR-Dateien auftritt.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für WebSphere Fehler beim Validieren der Bereitstellung von LiveCycle-Komponenten 127
➤ So stellen Sie die LiveCycle ES-EAR-Dateien bereit:
1. Beenden Sie LiveCycle Configuration Manager.
2. Stellen Sie die EAR-Dateien manuell bereit. (Siehe „Manuelles Bereitstellen von WebSphere“
auf Seite 55.)
3. Führen Sie LiveCycle Configuration Manager aus und wählen Sie die Aufgaben erst nach der
Bereitstellung der EAR-Dateien für LiveCycle ES aus.
Fehler beim Validieren der Bereitstellung von LiveCycle-Komponenten
Beim manuellen Konfigurieren von WebSphere für LiveCycle ES wird eventuell folgender Fehler
ausgegeben:
Component deployment failed validation. Cannot connect to server container
Führen Sie in diesem Fall die folgenden Schritte aus:
➤ So erhöhen Sie das maximale Transaktionszeitlimit und die ORB-Dienstwerte:
1. Klicken Sie in der Navigationsstruktur der WebSphere Administrative Console auf Servers >
Application Servers und anschließend im rechten Fenster auf den Servernamen.
2. Klicken Sie unter Container Settings auf Container Services > Transaction Service.
3. Erhöhen Sie alle diese Zeitlimitwerte, um diesen LiveCycle ES-Fehler zu beheben:
●
Total transaction lifetime timeout: 1800
●
Async response timeout: 1800
●
Maximum transaction timeout: 1800
4. Starten Sie WebSphere Application Server neu.
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.
➤ So konfigurieren Sie Ihren Server mit Windows 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 Registrierungsschlüssel
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters.
3. Suchen Sie im rechten Fenster des Registrierungs-Editors den Wertnamen TcpTimedWaitDelay.
Falls der Name fehlt, wählen Sie Bearbeiten > Neu > DWORD-Wert aus, um ihn hinzuzufügen.
4. Geben Sie in das Feld „Name“ die Bezeichnung TcpTimedWaitDelay ein.
Adobe LiveCycle ES
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlerbehebung
Unter Solaris können keine Bereitstellungsfehler gestartet/erstellt
werden 128
5. Wenn in dem Feld weder eine Einfügemarke noch der Text Neuer Wert # angezeigt wird, klicken Sie
mit der rechten Maustaste in das rechte Fenster, wählen im Menü die Option Umbenennen aus und
geben unter Name die Bezeichnung TcpTimedWaitDelay ein.
6. Wiederholen Sie die Schritte 4 und 5 für die folgenden Wertnamen: MaxUserPort,
MaxHashTableSize und MaxFreeTcbs.
7. Doppelklicken Sie in den rechten Bereich, um den TcpTimedWaitDelay-Wert festzulegen.
Wählen Sie unter Basis die Option Dezimal und geben Sie in das Feld Wert den Wert 30 ein.
8. Doppelklicken Sie in den rechten Bereich, um den MaxUserPort-Wert festzulegen.
Wählen Sie unter Basis die Option Dezimal und geben Sie in das Feld Wert den Wert 65534 ein.
9. Doppelklicken Sie in den rechten Bereich, um den MaxHashTableSize-Wert festzulegen.
Wählen Sie unter Basis die Option Dezimal und geben Sie in das Feld Wert den Wert 65536 ein.
10. Doppelklicken Sie in den rechten Bereich, um den MaxFreeTcbs-Wert festzulegen.
Wählen Sie unter Basis die Option Dezimal und geben Sie in das Feld Wert den Wert 16000 ein.
Vorsicht: Wenn Sie mit dem Registrierungs-Editor oder einer anderen Methode fehlerhafte Änderungen
an der Registrierung vornehmen, kann dies schwerwiegende Folgen haben. Im Extremfall
müssen Sie eventuell das Betriebssystem neu installieren. Alle Änderungen an der Registrierung
erfolgen auf eigenes Risiko.
Unter Solaris können keine Bereitstellungsfehler gestartet/erstellt werden
Laden Sie das GNU-Tool „tar“ herunter und extrahieren Sie damit alle Dateien in einer Solaris-Umgebung.
Verwenden Sie nicht den Solaris-Befehl „tar“, um Dateien zu extrahieren. Andernfalls treten Fehler auf,
wie z. B. fehlende Dateien und dem folgenden ähnliche Protokolleinträge:
ERROR[org.apache.catalina.core.ContainerBase.[jboss.web].[localhost].
[/invoker]] Exception starting filter ReadOnlyAccessFilter
java.lang.ClassNotFoundException:
org.jboss.invocation.http.servlet.ReadOnlyAccessFilter
Hinweise zu PDF Generator ES
Die folgenden Themen behandeln Probleme mit PDF Generator ES und deren Lösungen.
Konfigurieren von PDF Generator ES für die Konvertierung
von MS Office-Dateien in das PDF-Format
Es ist ein bekanntes Problem, dass bei manchen LiveCycle ES-Servern eine DCOM-Berechtigungsrichtlinie
geändert werden muss, damit PDF Generator ES zum Konvertieren von Dateien aus Microsoft
Office-Anwendungen verwendet werden kann. Erfolgt die Änderung nicht, wird die folgende
Fehlermeldung ausgegeben:
INFO [STOUT] com.jniwrapper.win32.com.ComException: COM object method returns
error code: 0x80004005; E_FAIL (Unspecified error)
Microsoft hat die erforderlichen Schritte in einem Knowledgebase-Artikel auf der Microsoft Hilfe und
Support-Site dokumentiert.
Adobe LiveCycle ES
Fehlerbehebung
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Standardmakroeinstellungen von Microsoft Visio 2007 verursachen
Konvertierungstimeout 129
Standardmakroeinstellungen von Microsoft Visio 2007 verursachen
Konvertierungstimeout
Wird eine Microsoft Visio 2007-Datei, die Makros enthält, zur Konvertierung gesendet, führt das daraufhin
angezeigte Microsoft Office Visio-Dialogfeld mit Sicherheitshinweis dazu, dass die Konvertierung das
Zeitlimit überschreitet. Für eine erfolgreiche Konvertierung von Dateien mit Makros müssen die
Standardmakroeinstellungen in Visio geändert werden.
➤ So ändern Sie die Standardmakroeinstellungen in Visio 2007:
●
Klicken Sie in Visio 2007 auf Extras > Vertrauensstellungscenter > Makroeinstellungen, wählen Sie
eine der folgenden Optionen aus und klicken Sie auf „OK“:
●
Alle Makros mit Benachrichtigung deaktivieren
●
Alle Makros aktivieren
A
Anhang – Installieren der Befehlszeilenschnittstelle
LiveCycle ES bietet eine Befehlszeilenschnittstelle (Command Line Interface, CLI) für das
Installationsprogramm. Die Befehlszeilenschnittstelle sollte nur von erfahrenen LiveCycle ES-Benutzern
oder in Serverumgebungen verwendet werden, die die Verwendung der grafischen Benutzeroberfläche
des Installationsprogramms nicht unterstützen. Die Befehlszeilenschnittstelle wird im Konsolenmodus
in einer interaktiven Sitzung für alle Installationsvorgänge ausgeführt.
Vor der Installation der Lösungskomponenten müssen Sie sicherstellen, dass die Umgebung über die zum
Ausführen von LiveCycle ES-Produkten erforderliche Software und Hardware verfügt. Außerdem sollten Sie
mit den Installationsoptionen vertraut sein und die Umgebung entsprechend vorbereitet haben. (Siehe
Vorbereiten der Installation von LiveCycle ES (Einzelserver).) Lesen Sie anschließend die erste Seite von
„Installieren der Produktdateien“ auf Seite 15 und den Abschnitt „Installation der Dateien
für Lösungskomponenten“ auf Seite 15.
In diesem Anhang werden die folgenden Themen behandelt:
●
„Installieren von LiveCycle ES“ auf Seite 130
●
„Fehlerprotokolle“ auf Seite 136
●
„Nächste Schritte“ auf Seite 136
Installieren von LiveCycle ES
In diesem Abschnitt wird die Erstinstallation von LiveCycle ES beschrieben. Informationen zu Konfiguration
und Bereitstellung finden Sie unter „Konfigurieren von LiveCycle ES für die Bereitstellung“ auf Seite 21
sowie „Anhang – LCM-Befehlszeilenschnittstelle“ auf Seite 137.
Hinweis: Um Berechtigungsprobleme bei der Bereitstellung zu vermeiden, sollten Sie sich unbedingt
als der Benutzer anmelden, der den WebSphere-Prozess ausführt, wenn Sie das
LiveCycle ES-Installationsprogramm über die Befehlszeilenschnittstelle und LiveCycle
Configuration Manager ausführen.
➤ So installieren Sie LiveCycle ES:
1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie zum Verzeichnis „/livecycle_server/8.2“
auf dem Installationsmedium.
2. Rufen Sie den folgenden Befehl in einer einzelnen Zeile auf:
●
(Windows) java -cp stage.jar;..\..\third_party\jdbc\
mysql-connector-java-3.1.12-bin.jar run -console
●
(Linux) ./linux_livecycle8_setup.bin -cp:p stage.jar -console
●
(UNIX) ./solaris_livecycle8_setup.bin -cp:p stage.jar -console
●
(AIX) ./aix_livecycle8_setup.bin -cp:p stage.jar -console
130
Adobe LiveCycle ES
Anhang – Installieren der Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren von LiveCycle ES 131
Hinweis: Geben Sie die folgenden zusätzlichen Argumente an, um das temporäre Verzeichnis des
LiveCycle ES-Installationsprogramms an einen anderen, vom Standardwert abweichenden
Speicherort umzuleiten:
-cp:p stage.jar -is:tempdir [Pfad zum alternativen temporären
Verzeichnis]
3. Reagieren Sie auf die Eingabeaufforderungen entsprechend den Angaben in der folgenden Tabelle:
Eingabeaufforderung
Beschreibung
Wählen Sie eine Sprache aus, die für diesen Assistenten
verwendet werden soll.
Wählen Sie die Sprache für die Installation
aus, indem Sie einen Wert von 1 bis 4
eingeben. Die Auswahl wird in eckigen
Klammern angezeigt ([X]).
[X] 1 – Englisch
[ ] 2 – Französisch
[ ] 3 – Deutsch
Geben Sie [0] ein, wenn Sie die Auswahl
einer Sprache abgeschlossen haben.
[ ] 4 – Japanisch
Zur Auswahl eines Elements geben Sie dessen
Nummer ein bzw. [0], wenn Sie fertig sind: [ ]
Adobe LiveCycle ES
Willkommen bei Adobe LiveCycle ES
Der Installations-Assistent installiert Adobe LiveCycle ES
(Enterprise Suite), Serverversion 8.2. Klicken Sie auf
'Weiter', um fortzufahren.
Adobe LiveCycle ES
Adobe Systems Incorporated
http://www.adobe.com/products/livecycle/
Drücken Sie 1 für „Weiter“, 3 für „Abbrechen“ oder
5 für „Neuanzeige“ [1]
Geben Sie auf dem
Begrüßungsbildschirm 1 ein,
um die Installation fortzusetzen.
Adobe LiveCycle ES
Anhang – Installieren der Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren von LiveCycle ES 132
Eingabeaufforderung
Beschreibung
Adobe LiveCycle ES
Drücken Sie auf dem Bildschirm
„Zielort“ die Eingabetaste, um das
Standardverzeichnis zu übernehmen,
oder geben Sie ein neues
Installationsverzeichnis an.
Adobe LiveCycle ES-Installationsspeicherort
Geben Sie ein Verzeichnis ein oder drücken Sie die
Eingabetaste, um das Standardverzeichnis
zu übernehmen.
Das Zielverzeichnis für Windows ist
[C:\Adobe\LiveCycle8.2]
Das Zielverzeichnis für Unix/Linux ist
[/opt/adobe/livecycle8.2]
Hinweis: Wenn Sie den Namen eines nicht
vorhandenen Verzeichnisses
eingeben, wird dieses Verzeichnis
erstellt.
Vorsicht: Bei der Installation der
Lösungskomponenten
können Sie ein anderes
Installationsverzeichnis
angeben. Wenn Sie die
Lösungskomponente unter Linux
oder UNIX installieren, darf das
angegebene Verzeichnis keine
Leerzeichen enthalten, da die
Installation sonst nicht
durchgeführt wird.
Drücken Sie 1 für „Weiter“, 2 für „Zurück“,
3 für „Abbrechen“ oder 5 für „Neuanzeige“ [1]
Geben Sie 1 ein, um die Installation
fortzusetzen.
Adobe LiveCycle ES
Geben Sie eine Seriennummer ein.
Ihre lizenzierten Komponenten werden
angezeigt.
Seriennummer [ ]
[ ] 1 – Hinzufügen
[ ] 2 – Löschen
[X] 3 – Fertigstellen
Zur Auswahl eines Elements geben Sie dessen
Nummer ein bzw. 0, wenn Sie fertig sind: [0]
Wenn Sie über mehrere lizenzierte
Lösungskomponenten verfügen,
geben Sie 1 ein, um eine weitere
Seriennummer hinzuzufügen. Sie werden
wie im vorherigen Schritt anschließend zur
Eingabe einer weiteren Seriennummer
aufgefordert. Wiederholen Sie diesen
Schritt für alle Ihre Seriennummern.
Geben Sie 0 ein, wenn das Eingeben von
Seriennummern beendet ist.
Hinweis: Geben Sie zum Zurücksetzen der
Seriennummer 2 ein.
Drücken Sie 1 für „Weiter“, 2 für „Zurück“,
3 für „Abbrechen“ oder 5 für „Neuanzeige“ [1]
Geben Sie 1 ein, um die Installation
fortzusetzen.
Drücken Sie die EINGABETASTE, um den Text zu lesen
[drücken Sie zum Beenden q]
Die Produktlizenzvereinbarung wird
angezeigt. Drücken Sie die EINGABETASTE,
um die Vereinbarung zu lesen.
Adobe LiveCycle ES
Anhang – Installieren der Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren von LiveCycle ES 133
Eingabeaufforderung
Beschreibung
Wählen Sie eine der folgenden Optionen aus:
Wenn Sie Bedingungen der
Produktlizenzvereinbarung
einverstanden sind, geben Sie 1 ein.
[ ] 1 – Ich akzeptiere die Bedingungen der
Lizenzvereinbarung.
[X] 2 – Ich akzeptiere die Bedingungen der
Lizenzvereinbarung nicht.
Geben Sie [0] ein, wenn Sie das Lesen der
Produktlizenzvereinbarung beendet
haben.
Zur Auswahl eines Elements geben Sie dessen
Nummer ein bzw. 0, wenn Sie fertig sind: [0]
Drücken Sie 1 für „Weiter“, 2 für „Zurück“,
3 für „Abbrechen“ oder 5 für „Neuanzeige“ [1]
Geben Sie 1 ein, um die Installation
fortzusetzen.
Adobe LiveCycle ES
Wählen Sie das Betriebssystem aus,
für das Sie die Konfiguration durchführen.
Auswahl des Betriebssystems
Durch Auswählen eines Betriebssystems
aus der unten angezeigten Liste teilen Sie dem
Installationsprogramm mit, welche native
Umgebung konfiguriert werden soll.
Für welche Konfiguration ist diese Installation gedacht?
Wählen Sie eine der folgenden Optionen aus:
[X] 1 – Windows
[ ] 2 – Linux
[ ] 3 – Solaris
[ ] 4 – AIX
Zur Auswahl eines Elements geben Sie dessen
Nummer ein bzw. 0, wenn Sie fertig sind: [0]
Drücken Sie 1 für „Weiter“, 2 für „Zurück“, 3 für „Abbrechen“
oder 5 für „Neuanzeige“ [1]
Geben Sie 1 ein, um die Installation
fortzusetzen.
Adobe LiveCycle ES
Anhang – Installieren der Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren von LiveCycle ES 134
Eingabeaufforderung
Beschreibung
Adobe LiveCycle ES
(PDF Generator ES nur für Windows)
Unterstützung nativer Anwendungen für LiveCycle
PDF Generator ES
Wenn Sie 1 eingeben, um die
Unterstützung nativer Anwendungen
für PDF Generator ES zu aktivieren,
überprüft die Software die installierte
Version von Adobe Acrobat®. Wenn Acrobat
nicht installiert ist, akzeptieren Sie die
Aufforderung, Acrobat 9.0 jetzt
zu installieren.
LiveCycle PDF Generator ES kann Dateien der
Anwendungen Microsoft Office Word, Adobe Photoshop,
AutoCAD sowie anderer nativer Anwendungen
in Adobe PDF konvertieren.
Wählen Sie eine der folgenden Optionen aus:
Ausführliche Informationen zur Unterstützung nativer
Anwendungen finden Sie in der Dokumentation.
[ ] 1 – Ja, die Unterstützung nativer Anwendungen
für LiveCycle PDF Generator ES aktivieren.
[X ] 2 – Nein, keine Unterstützung nativer Anwendungen
für LiveCycle PDF Generator ES aktivieren. (Diese Option
für Clusterbereitstellungen wählen)
Wenn Sie die Installation in einer
Clusterumgebung durchführen,
geben Sie 2 ein, um die
Unterstützung nativer Anwendungen
für PDF Generator ES nicht zu aktivieren.
Geben Sie [0] ein, wenn Sie Ihre Auswahl
getroffen haben.
Zur Auswahl eines Elements geben Sie dessen
Nummer ein bzw. 0, wenn Sie fertig sind: [ ]
Drücken Sie 1 für „Weiter“, 2 für „Zurück“,
3 für „Abbrechen“ oder 5 für „Neuanzeige“ [1]
Drücken Sie die Eingabetaste,
um die Installation fortzusetzen.
Adobe LiveCycle ES
Anhang – Installieren der Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Installieren von LiveCycle ES 135
Eingabeaufforderung
Beschreibung
Adobe LiveCycle ES
Drücken Sie 1, um LiveCycle ES
zu installieren.
Zusammenfassung vor der Installation
Lesen Sie die nachstehenden
Zusammenfassungsinformationen.
Adobe LiveCycle ES wird an folgendem Speicherort
installiert:
/opt/adobe/livecycle8.2
Die Installation umfasst die folgenden Funktionen:
●
Adobe LiveCycle Foundation
●
Adobe LiveCycle Configuration Manager
●
LiveCycle ES SDK
●
Adobe LiveCycle Forms ES
●
Adobe LiveCycle Reader Extensions ES
●
Adobe LiveCycle Process Management ES
●
Adobe LiveCycle ES Business Activity Monitoring
●
Adobe LiveCycle Output ES
●
Adobe LiveCycle Rights Management ES
●
Adobe LiveCycle Digital Signatures ES
●
Adobe LiveCycle PDF Generator ES
●
Adobe LiveCycle PDF Generator 3D ES
●
Adobe LiveCycle Barcoded Forms ES
●
Adobe LiveCycle ES Connector for IBM FileNet
●
Adobe LiveCycle ES Connector for EMC Documentum
●
Adobe LiveCycle ES Connector
for IBM Content Manager
Drücken Sie die EINGABETASTE, um den Text zu lesen.
Drücken Sie 1 für „Weiter“, 2 für „Zurück“,
3 für „Abbrechen“ oder 5 für „Neuanzeige“ [1]
Zusammenfassung vor der Installation ->
Lesen Sie die Informationen. LiveCycle ES
wird mit den folgenden Funktionen
am folgenden Speicherort installiert.
Der Installationsstatus wird angezeigt.
Hinweis: Der Installationsspeicherort
und die angegebenen
Lösungskomponenten
variieren abhängig
von Ihrem Lizenzschlüssel
und dem angegebenen
Installationsverzeichnis.
Adobe LiveCycle ES
Anhang – Installieren der Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Fehlerprotokolle 136
Eingabeaufforderung
Beschreibung
Drücken Sie die EINGABETASTE, um den Text zu lesen
[drücken Sie zum Beenden q]
Nach Abschluss der Installation werden die
Anmerkungen zu dieser Version angezeigt.
Drücken Sie 1 für „Weiter“, 2 für „Zurück“,
3 für „Abbrechen“ oder 5 für „Neuanzeige“ [1]
Wählen Sie eine der folgenden Optionen aus:
[X] 1 – LiveCycle Configuration Manager starten
[ ] 2 – LiveCycle Configuration Manager nicht starten
Zur Auswahl eines Elements geben Sie dessen
Nummer ein bzw. 0, wenn Sie fertig sind: [0]
Die Zusammenfassung nach der
Installation wird angezeigt.
Geben Sie 1 ein, um LiveCycle
Configuration Manager zu starten,
oder 2 und anschließend [0] ein,
um die Installation zu beenden.
Drücken Sie 3 für „Fertigstellen“ oder
5 für „Neuanzeige“ [3]
Fehlerprotokolle
Wenn ein Fehler auftritt, können Sie das Installationsprotokoll „adobe_lc8.2_server_install.log“
im temporären Verzeichnis des Systems (TEMP oder TMP) überprüfen.
Informationen zu Fehlern, die während der Installation ggf. auftreten, finden Sie unter „Fehlerbehebung“
auf Seite 117.
Deinstallieren von LiveCycle ES im Konsolenmodus
Wenn Sie die LiveCycle ES-Umgebung deinstallieren müssen, öffnen Sie eine Eingabeaufforderung,
wechseln zum Verzeichnis „[LiveCycle8.2-Stammverzeichnis]/_uninst/server“ und führen den Ihrem
Betriebssystem entsprechenden Befehl aus:
●
(Windows) ./windows.*.bin - console
●
(Linux) ./linux.*.bin - console
●
(UNIX) ./solaris.*.bin - console
●
(AIX) ./aix.*.bin - console
Nächste Schritte
Sie müssen LiveCycle ES jetzt für die Bereitstellung konfigurieren. (Siehe „Konfigurieren von LiveCycle ES
für die Bereitstellung“ auf Seite 21 oder „Anhang – LCM-Befehlszeilenschnittstelle“ auf Seite 137.)
B
Anhang – LCM-Befehlszeilenschnittstelle
LiveCycle ES bietet eine Befehlszeilenschnittstelle (Command Line Interface, CLI) für LiveCycle Configuration
Manager. Die Befehlszeilenschnittstelle sollte nur von erfahrenen LiveCycle ES-Benutzern oder z. B. in
Serverumgebungen verwendet werden, die die Verwendung der grafischen Benutzeroberfläche
von LiveCycle Configuration Manager nicht unterstützen.
Reihenfolge der Vorgänge
Die LiveCycle Configuration Manager-Befehlszeilenschnittstelle muss eine mit der grafischen Version von
LiveCycle Configuration Manager identische Vorgangsreihenfolge einhalten. Stellen Sie sicher, dass Sie die
Vorgänge über die Befehlszeile in dieser Reihenfolge ausführen:
1. Konfigurieren Sie LiveCycle ES.
2. Konfigurieren Sie den Anwendungsserver.
3. Stellen Sie LiveCycle ES bereit.
4. Initialisieren Sie LiveCycle ES.
5. Initialisieren Sie LiveCycle ES Business Activity Monitoring.
6. Stellen Sie LiveCycle ES-Komponenten bereit.
Vorsicht: Sie müssen Ihren WebSphere Application Server nach Abschluss der über die
Befehlszeilenschnittstelle durchgeführten Vorgänge für LiveCycle Configuration Manager
neu starten.
Eigenschaftendatei der Befehlszeilenschnittstelle
Die LiveCycle Configuration Manager-Befehlszeilenschnittstelle benötigt eine
Eigenschaftendatei mit den definierten Eigenschaften Ihrer LiveCycle ES-Umgebung.
Die Vorlage für die Eigenschaftendatei, cli_propertyFile_template.txt, befindet sich im Ordner
[LiveCycleES­Stammverzeichnis]/configurationManager/bin. Sie müssen eine Kopie dieser Datei erstellen
und die Werte bearbeiten. Sie können diese Datei basierend auf den LiveCycle Configuration ManagerVorgängen anpassen, die Sie verwenden möchten. Im folgenden Abschnitt werden die benötigten
Eigenschaften und Werte beschrieben.
Hinweis: Wenn Sie die grafische Version von LiveCycle Configuration Manager verwenden
und sich später für die Befehlszeilenschnittstellen-Version entscheiden,
können Sie die von der grafischen Version erstellte Eigenschaftendatei als
Eigenschaftendatei für die Befehlszeilenschnittstellen-Version verwenden. Wenn Sie
„[LiveCycleES­Stammverzeichnis]/configurationManager/bin/ConfigurationManager.bat“
ausführen, wird die Datei „userValues.properties“ im Verzeichnis
„[LiveCycleES­Stammverzeichnis]/configurationManager/config“ erstellt. Sie können
diese Datei kopieren, in „userValuesForCLI.properties“ umbenennen und als Eingabe
für die Befehlszeilenschnittstelle von LiveCycle Configuration Manager verwenden.
137
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Allgemeine Eigenschaften 138
Allgemeine Eigenschaften
Die allgemeinen Eigenschaften sind wie folgt:
Spezifische Eigenschaften für WebSphere: Erforderlich für die Vorgänge „Anwendungsserver
konfigurieren“, „LiveCycle bereitstellen“, „Anwendungsservertopologie überprüfen“ und
„Anwendungsserverkonfigurationen überprüfen“.
LiveCycle Server-spezifische Eigenschaften: Erforderlich für die Vorgänge „LiveCycle initialisieren“
und „LiveCycle-Komponenten bereitstellen“.
Die in der Tabelle aufgeführten Eigenschaften sind für die folgenden Vorgänge erforderlich:
●
LiveCycle initialisieren
●
LiveCycle-Komponenten bereitstellen
Spezifische Eigenschaften für WebSphere
Eigenschaft
Werte
Beschreibung
targetServer.topologyType
Server oder Cluster
Der Typ der
Anwendungsservertopologie,
für die Sie LiveCycle ES
bereitstellen.
targetServer.name
Zeichenfolge
Der Name, der dem
Anwendungsserverknoten
oder ­cluster zugewiesen wird.
targetServer.adminHost
Standard:
Der Hostname des Servers,
auf dem der WebSphereAnwendungsserver installiert ist.
localhost
targetServer.adminPort
Ganzzahl
Die Anschlussnummer, die der
WebSphere-Administrationsserver
auf SOAP-Anforderungen
überwacht.
targetServer.adminUserID
Zeichenfolge
Die Administrator-ID
für den Zugriff auf den
WebSphere-Anwendungsserver.
localServer.appServerRootDir
Standard:
Das Stammverzeichnis der
Anwendungsserverinstanz,
die lokal konfiguriert wird
(auf der LiveCycle ES
bereitgestellt werden soll oder
die für die Kommunikation
mit einem Remote-Server
verwendet wird, auf dem
LiveCycle ES bereitgestellt
werden soll).
(Windows) C:\Programme\
WebSphere\AppServer
(Linux, Solaris)
/opt/IBM/WebSphere/
AppServer
(AIX) /usr/IBM/WebSphere/
AppServer
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von LiveCycle ES-Eigenschaften 139
LiveCycle Server-spezifische Eigenschaften
Eigenschaft
Werte
Beschreibung
LCHost
Zeichenfolge
Der Hostname des Servers,
auf dem LiveCycle ES
bereitgestellt wird.
LCPort
Ganzzahl
Die Webanschlussnummer,
an der LiveCycle ES
bereitgestellt wird.
excludedSolutionComponents
Wählen Sie einen Wert aus:
(Optional) Wählen Sie
die LiveCycle ESLösungskomponenten aus,
die Sie nicht konfigurieren
möchten. Geben Sie die
ausgeschlossenen
Komponenten in einer
durch Kommas getrennten
Liste an.
Zeichenfolge. Die Werte
umfassen:
ALC-LFS-Forms,
ALC-LFSBusinessActivityMonitoring,
ALC-LFSConnectorEMCDocumentum,
ALC-LFS-ConnectorIBMFileNet,
ALC-LFSConnectorIBMContentManager,
ALC-LFS-ContentServices,
ALC-LFS-DigitalSignatures,
ALC-LFS-DataCapture,
ALC-LFS-Output,
ALC-LFS-PDFGenerator,
ALC-LFS-PDFGenerator3D,
ALC-LFS-ProcessManagement,
ALC-LFS-ReaderExtensions,
ALC-LFS-RightsManagement
Konfigurieren von LiveCycle ES-Eigenschaften
Diese Eigenschaften beziehen sich ausschließlich auf den Konfigurationsvorgang für LiveCycle.
Eigenschaft
Werte
Beschreibung
AdobeFontsDir
Zeichenfolge
Speicherort des Verzeichnisses
für Adobe-Serverschriftarten.
Auf diesen Pfad muss
von dem Server, auf dem die
Bereitstellung erfolgen soll,
zugegriffen werden können.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren von LiveCycle ES-Eigenschaften 140
Eigenschaft
Werte
Beschreibung
customerFontsDir
Zeichenfolge
Speicherort des Verzeichnisses
für Kundenschriftarten.
Auf diesen Pfad muss
von dem Server, auf dem die
Bereitstellung erfolgen soll,
zugegriffen werden können.
systemFontsDir
Zeichenfolge
Speicherort des Verzeichnisses
für Systemschriftarten.
Mit einem Semikolon als
Trennzeichen können
mehrere Verzeichnisse
für Systemschriftarten
angegeben werden.
Auf diese Pfade muss von dem
Server, auf dem die Bereitstellung
erfolgen soll, zugegriffen
werden können.
LCTempDir
Zeichenfolge
Speicherort des temporären
Verzeichnisses. Auf diesen Pfad
muss von dem Server, auf dem
die Bereitstellung erfolgen soll,
zugegriffen werden können.
LCGlobalDocStorageDir
Zeichenfolge
Das Stammverzeichnis des
globalen Dokumentenspeichers.
Geben Sie einen Pfad zu einem
freigegebenen NFS-Verzeichnis
an, in dem dauerhaft genutzte
Dokumente gespeichert
werden, um sie zwischen allen
Clusterknoten gemeinsam
zu nutzen.
Geben Sie diese Eigenschaft
nur an, wenn LiveCycle ESProdukte in einer
Clusterumgebung bereitgestellt
werden. Auf diesen Pfad muss
von dem Server, auf dem die
Bereitstellung erfolgen soll,
zugegriffen werden können.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren oder Überprüfen von Anwendungsservereigenschaften 141
Eigenschaft
Werte
Beschreibung
enableFIPS
„true“ oder „false“
Durch das Aktivieren der FIPSOption (Federal Information
Processing Standards) wird der
Datenschutz auf gemäß
FIPS 140-2 zugelassene
Algorithmen eingeschränkt,
die das Verschlüsselungsmodul
"RSA BSAFE Crypto-J 3.5.2"
in Verbindung mit dem
FIPS 140­2­Überprüfungszertifik
at Nr. 590 verwenden. Aktivieren
Sie diese Option nur, wenn es
erforderlich ist, dass FIPS
erzwungen wird.
Standard:
false
contentServices.rootDir
Zeichenfolge
Ist erforderlich, wenn Sie nur
LiveCycle-Content Services ES
konfigurieren.
Geben Sie das von
Content Services ES verwendete
Stammverzeichnis an.
Konfigurieren oder Überprüfen von Anwendungsservereigenschaften
LiveCycle Configuration Manager kann Ihren WebSphere-Anwendungsserver den LiveCycle ESAnforderungen entsprechend konfigurieren oder überprüfen.
Diese Eigenschaften sind für die folgenden Vorgänge erforderlich:
●
Anwendungsserver konfigurieren
●
Anwendungsservertopologie überprüfen
●
Anwendungsserverkonfigurationen überprüfen
●
Datenbankverbindung überprüfen
Hinweis: Sie müssen den Abschnitt mit den WebSphere-spezifischen Eigenschaften konfigurieren.
Weitere Informationen finden Sie unter „Allgemeine Eigenschaften“ auf Seite 138.
Eigenschaft
Werte
Beschreibung
jvm.initialHeapSize
Standard:
Die anfängliche Heapgröße
(in MB) für die JVM.
512
jvm.maxHeapSize
Standard:
1024
jms.MEClusterName
Zeichenfolge
Die maximale Heap-Größe
(in MB) für die JVM.
(Nur Cluster) Der JMS MEClustername.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Konfigurieren oder Überprüfen von Anwendungsservereigenschaften 142
Eigenschaft
Werte
Beschreibung
classpath.targetServer.
javaHome
Zeichenfolge
Für die Konfiguration des
Zielanwendungsservers ist der
Speicherort von „Java Home“
erforderlich, der zum Ausführen
des Zielanwendungsservers
verwendet wird.
Auf diesen Pfad muss von dem
Server, der konfiguriert wird,
zugegriffen werden können.
classpath.targetServer.
pop3JarPath
Zeichenfolge
Pfad zur Pop3-JAR-Datei, auf die
der Zielanwendungsserver
zugreifen kann. Auf diesen
Pfad muss von dem Server,
der konfiguriert wird, zugegriffen
werden können.
datasource.dbType
Wählen Sie:
Der Typ der Datenbank,
der für LiveCycle ES
konfiguriert wird.
●
oracle
●
mysql
●
sqlserver
●
db2
datasource.dbName
Zeichenfolge
Der Name der Datenbank.
datasource.dbHost
Zeichenfolge
Der Hostname oder die
IP­Adresse des Servers, auf dem
sich die Datenbank befindet.
datasource.dbPort
Ganzzahl
Der Datenbankanschluss,
den LiveCycle ES für die
Kommunikation mit der
Datenbank verwendet.
datasource.dbUser
Zeichenfolge
Die Benutzer-ID, die LiveCycle ES
für den Zugriff auf die Datenbank
verwendet.
datasource.dbPassword
Zeichenfolge
Das Kennwort, das mit der
DatenbankbenutzerID verknüpft ist.
datasource.target.driverPath
Zeichenfolge
Der JDBC-Treiber im
Anwendungsserververzeichnis
„lib“. Auf diesen unbedingt
gültigen Pfad muss von dem
Server, der konfiguriert wird,
zugegriffen werden können.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Bereitstellen von LiveCycle-Eigenschaften 143
Eigenschaft
Werte
Beschreibung
datasource.local.driverPath
Zeichenfolge
Lokaler JDBC-Treiber. Dieser
Wert dient ausschließlich
zum Testen der direkten
Datenbankverbindung.
jms.MEClusterName
Zeichenfolge
Nur für WebSphere-Cluster
erforderlich.
Geben Sie den JMS MEClusternamen an.
Bereitstellen von LiveCycle-Eigenschaften
Diese Eigenschaften beziehen sich ausschließlich auf den Bereitstellungsvorgang für LiveCycle.
Hinweis: Sie müssen den Abschnitt „LiveCycle-Serverinformationen“ konfigurieren. (Siehe „Allgemeine
Eigenschaften“ auf Seite 138.)
Initialisieren von LiveCycle-Eigenschaften
Diese Eigenschaften beziehen sich ausschließlich auf den Initialisierungsvorgang für LiveCycle.
Hinweis: Sie müssen den Abschnitt „LiveCycle-Serverinformationen“ konfigurieren. (Siehe „Allgemeine
Eigenschaften“ auf Seite 138.)
Initialisieren von BAM-Eigenschaften
Diese Eigenschaften beziehen sich ausschließlich auf den Initialisierungsvorgang für BAM.
Hinweis: LiveCycle ES Business Activity Monitoring ist eine optionale Lösungskomponente von
LiveCycle ES.
Eigenschaft
Werte
Beschreibung
BAMHost
Zeichenfolge
Der Hostname des Servers,
auf dem Business Activity
Monitoring bereitgestellt
und ausgeführt wird.
BAMPort
Ganzzahl
Die Anschlussnummer, die der
BAM Server auf Anforderungen
überwacht.
BAMAdminUserID
Zeichenfolge
Die Business Activity MonitoringAdministrator-ID zum Herstellen
der Verbindung mit dem
BAM Server.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Bereitstellen von LiveCycle-Komponenteneigenschaften 144
Eigenschaft
Werte
Beschreibung
BAMAdminPassword
Zeichenfolge
Das Business Activity
MonitoringAdministratorkennwort
zum Herstellen der Verbindung
mit dem BAM Server.
databaseType
Wählen Sie eine Datenbank aus:
Der Typ der Datenbank,
in der LiveCycle ES Business
Activity Monitoring-Daten
erfasst.
oracle
mysql
sqlserver
db2
Bereitstellen von LiveCycle-Komponenteneigenschaften
Die in der Tabelle aufgeführten Eigenschaften gelten für die folgenden Vorgänge:
●
LiveCycle-Komponenten bereitstellen
●
LiveCycle-Komponentenbereitstellung überprüfen
●
LiveCycle-Server überprüfen
Hinweis: Sie müssen den Abschnitt „LiveCycle-Serverinformationen“ konfigurieren. (Siehe „Allgemeine
Eigenschaften“ auf Seite 138.)
Eigenschaft
Werte
Beschreibung
LCAdminUserID
Zeichenfolge
Die dem LiveCycleAdministratorbenutzer
zuzuweisende Benutzer-ID.
Diese Benutzer-ID dient zum
Anmelden an der LiveCycle
Administration Console.
LCAdminPassword
Zeichenfolge
Das dem LiveCycleAdministratorbenutzer
zuzuweisende Kennwort.
Dieses Kennwort dient zum
Anmelden an der LiveCycle
Administration Console.
Verwendung der Befehlszeilenschnittstelle
Nachdem Sie die Eigenschaftendatei konfiguriert haben, müssen Sie zum Ordner
„[LiveCycleES­Stammverzeichnis]/configurationManager/bin“ wechseln.
Um eine vollständige Beschreibung der Befehle der LiveCycle Configuration ManagerBefehlszeilenschnittstelle anzuzeigen, geben Sie configurationManagerCLI help ein.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Verwendung der Befehlszeilenschnittstelle 145
Hinweis: Die LiveCycle Configuration Manager-Befehlszeilenschnittstelle erfordert, dass das Sun™ Java™
Software Development Kit (JDK) 1.5.0_11 oder höher installiert ist, die Umgebungsvariable
JAVA_HOME konfiguriert ist und PATH auf den Speicherort zeigt, an dem das JDK installiert ist.
Weitere Informationen finden Sie im Handbuch Vorbereiten der Installation von LiveCycle ES
für Ihre Einzelserver- oder Clusterumgebung.
„LiveCycle konfigurieren“ über die Befehlszeilenschnittstelle
Der Vorgang „LiveCycle konfigurieren“ erfordert die folgende Syntax:
configureLiveCycle -f [Eigenschaftendatei]
Dabei gilt:
●
-f [Eigenschaftendatei] ist eine Eigenschaftendatei, die die erforderlichen Argumente
enthält. Weitere Informationen zum Erstellen einer Eigenschaftendatei finden Sie unter
„Eigenschaftendatei der Befehlszeilenschnittstelle“ auf Seite 137.
„Anwendungsserver konfigurieren“ über die Befehlszeilenschnittstelle
Der Vorgang „Anwendungsserver konfigurieren“ für WebSphere erfordert die folgende Syntax:
configureApplicationServer -targetServer_AdminPassword [Kennwort] -f
[Eigenschaftendatei] [-skip [Liste mit den zu überspringenden
Konfigurationen]]
Dabei gilt:
●
-targetServer_AdminPassword [Kennwort]: Ermöglicht das Festlegen des
Administratorkennworts in der Befehlszeile. Wenn dieses Argument vorhanden ist,
setzt es die Eigenschaft „targetServer.adminPassword“ in der Eigenschaftendatei außer Kraft.
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
●
-skip [Liste mit den zu überspringenden Konfigurationen]: Über diesen
optionalen Parameter können Sie die Anwendungsserverkomponenten angeben, die Sie nicht
konfigurieren wollen. Geben Sie die ausgeschlossenen Komponenten in einer durch Kommas
getrennten Liste an. Gültige Optionen sind „JMS“, „Datasource“ oder „Core“.
„LiveCycle bereitstellen“ über die Befehlszeilenschnittstelle
Der Vorgang „LiveCycle bereitstellen“ erfordert die folgende Syntax:
deployLiveCycle -f [Eigenschaftendatei]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Weitere Informationen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei
der Befehlszeilenschnittstelle“ auf Seite 137.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Verwendung der Befehlszeilenschnittstelle 146
„LiveCycle initialisieren“ über die Befehlszeilenschnittstelle
Der Vorgang „LiveCycle initialisieren“ erfordert die folgende Syntax:
initializeLiveCycle -f [Eigenschaftendatei]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
„Business Activity Monitoring initialisieren“ über die Befehlszeilenschnittstelle
Der Vorgang „Business Activity Monitoring initialisieren“ erfordert die folgende Syntax:
initializeBAM -f [Eigenschaftendatei]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
„LiveCycle-Komponenten bereitstellen“ über die Befehlszeilenschnittstelle
Der Vorgang „LiveCycle-Komponenten bereitstellen“ erfordert die folgende Syntax:
deployLiveCycleComponents -f [Eigenschaftendatei]
-targetServer_AdminPassword [password]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
●
-targetServer_AdminPassword [Kennwort]: Ermöglicht das Festlegen des
Administratorkennworts in der Befehlszeile. Wenn dieses Argument vorhanden ist,
setzt es die Eigenschaft „targetServer.adminPassword“ in der Eigenschaftendatei außer Kraft.
„Anwendungsservertopologie überprüfen“ über die Befehlszeilenschnittstelle
Der Vorgang „Anwendungsserver konfigurieren“ ist optional und erfordert die folgende Syntax:
validateApplicationServerTopology -f [Eigenschaftendatei]
-targetServer_AdminPassword [Kennwort]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
●
-targetServer_AdminPassword [Kennwort]: Ermöglicht das Festlegen des
Administratorkennworts in der Befehlszeile. Wenn dieses Argument vorhanden ist,
setzt es die Eigenschaft „targetServer.adminPassword“ in der Eigenschaftendatei außer Kraft.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Verwendung der Befehlszeilenschnittstelle 147
„Datenbankverbindung überprüfen“ über die Befehlszeilenschnittstelle
Der Vorgang „Datenbankverbindung überprüfen“ ist optional und erfordert die folgende Syntax:
validateDBConnectivity -f [Eigenschaftendatei] -datasource_dbPasssword
[password]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
●
-datasource_dbPassword [Kennwort]: Ermöglicht das Festlegen des
Datenbankbenutzerkennworts in der Befehlszeile. Wenn dieses Argument vorhanden ist,
setzt es die Eigenschaft „datasource.dbPassword“ in der Eigenschaftendatei außer Kraft.
„Anwendungsserverkonfigurationen überprüfen“ über die
Befehlszeilenschnittstelle
Der Vorgang „Anwendungsserverkonfigurationen überprüfen“ ist optional und erfordert die folgende
Syntax:
validateApplicationServerConfigurations -f [Eigenschaftendatei]
-targetServer_AdminPassword [Kennwort]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
●
-targetServer_AdminPassword [Kennwort]: Ermöglicht das Festlegen des
Administratorkennworts in der Befehlszeile. Wenn dieses Argument vorhanden ist,
setzt es die Eigenschaft „targetServer.adminPassword“ in der Eigenschaftendatei außer Kraft.
„LiveCycle-Server überprüfen“ über die Befehlszeilenschnittstelle
Der Vorgang „LiveCycle-Server überprüfen“ ist optional und erfordert die folgende Syntax:
validateLiveCycleServer -f [Eigenschaftendatei]
-targetServer_AdminPassword [password]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
●
-targetServer_AdminPassword [Kennwort]: Ermöglicht das Festlegen des
Administratorkennworts in der Befehlszeile. Wenn dieses Argument vorhanden ist,
setzt es die Eigenschaft „targetServer.adminPassword“ in der Eigenschaftendatei außer Kraft.
Adobe LiveCycle ES
Anhang – LCM-Befehlszeilenschnittstelle
Installieren und Bereitstellen von LiveCycle ES für WebSphere
Verwendungsbeispiele 148
„LiveCycle-Komponentenbereitstellung überprüfen“ über die
Befehlszeilenschnittstelle
Der Vorgang „LiveCycle-Komponentenbereitstellung überprüfen“ ist optional und erfordert die folgende
Syntax:
validateLiveCycleComponentDeployment -f [Eigenschaftendatei]
-targetServer_AdminPassword [Kennwort]
Dabei gilt:
●
-f [Eigenschaftendatei]: Eine Eigenschaftendatei, die die erforderlichen Argumente enthält.
Anweisungen zum Erstellen einer Eigenschaftendatei finden Sie unter „Eigenschaftendatei der
Befehlszeilenschnittstelle“ auf Seite 137.
●
-targetServer_AdminPassword [Kennwort]: Ermöglicht das Festlegen des
Administratorkennworts in der Befehlszeile. Wenn dieses Argument vorhanden ist,
setzt es die Eigenschaft „targetServer.adminPassword“ in der Eigenschaftendatei außer Kraft.
Verwendungsbeispiele
Geben Sie in „C:\Adobe\LiveCycle8.2\configurationManager\bin“ Folgendes ein:
./configurationManagerCLI ConfigureLiveCycle -f
Befehlszeilenschnittstelle-Eigenschaftendatei.txt
Befehlszeilenschnittstelle-Eigenschaftendatei.txt ist der Name der von Ihnen erstellen
Eigenschaftendatei.
Fehlerprotokolle
Falls ein Fehler auftritt, können Sie die Fehlerprotokolle der Befehlszeilenschnittstelle im Ordner
„[LiveCycleES-Stammverzeichnis]\configurationManager\log“ überprüfen. Die Protokolldatei wird gemäß
einer Benennungsrichtlinie beispielsweise mit „lcmCLI.0.log“ benannt, wobei die Nummer im Dateinamen
erhöht wird, sobald die Protokolldateien erneuert werden.
Nächste Schritte
Wenn Sie LiveCycle ES mithilfe der LiveCycle Configuration Manager-Befehlszeilenschnittstelle
konfiguriert und bereitgestellt haben, können Sie jetzt wie folgt vorgehen:
●
Überprüfen Sie die Bereitstellung. (Siehe „Abschließende Einrichtung für LiveCycle
Rights Management ES“ auf Seite 71.)
●
Greifen Sie auf die LiveCycle Administration Console zu. (Siehe „Zugreifen auf LiveCycle Administration
Console“ auf Seite 59.)
●
Konfigurieren Sie LiveCycle ES-Lösungskomponenten für den Zugriff auf LDAP. (Siehe „Konfigurieren
von LiveCycle ES für den LDAP-Zugriff“ auf Seite 71.)
●
Deinstallieren Sie LiveCycle ES. (Siehe „Deinstallieren von LiveCycle ES“ auf Seite 93.)
Wenn Sie den Anwendungsserver nicht für die Bereitstellung konfiguriert haben, müssen Sie diesen jetzt
konfigurieren. (Siehe „Manuelles Konfigurieren von WebSphere“ auf Seite 30.)