Anzeigen  *
bc
Configuring LiveCycle® Application
Server Clusters Using WebSphere® 5.1
Adobe® LiveCycle®
June 2007
Version 7.2
© 2007 Adobe Systems Incorporated. All rights reserved.
Adobe® LiveCycle® 7.2 Configuring LiveCycle Application Server Clusters Using WebSphere® 5.1 for Microsoft® Windows®, Linux®, and UNIX®
Edition 2.0, June 2007
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 and company logos in sample material or in the sample forms included in this software are for
demonstration purposes only and are not intended to refer to any actual organization.
Adobe, the Adobe logo, LiveCycle, and Reader 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.
Oracle is a trademark of Oracle Corporation and may be registered in certain jurisdictions.
SUSE is a trademark of Novell, Inc. in the United States and other countries.
Sun, Java, and Solaris are trademarks or registered trademark of Sun Microsystems, Inc. in the United States and other countries.
Microsoft, Windows, and Windows Server are either registered trademarks or trademarks of Microsoft Corporation in the United States
and/or 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.
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.
Contents
Preface .......................................................................................................................................... 6
Who should read this guide? ..................................................................................................................................................... 6
Versions.............................................................................................................................................................................................. 6
Conventions used in this guide................................................................................................................................................. 6
Related documentation ............................................................................................................................................................... 7
Updated LiveCycle product information ............................................................................................................................... 8
1
Overview ...................................................................................................................................... 9
About clustering application servers ...................................................................................................................................... 9
Failover ......................................................................................................................................................................................10
Load balancing .......................................................................................................................................................................10
Web server load balancing .................................................................................................................................................10
Scalability..................................................................................................................................................................................10
WebSphere and distributed sessions....................................................................................................................................11
Terminology ...................................................................................................................................................................................11
Clustering LiveCycle products .................................................................................................................................................11
Supported topologies.................................................................................................................................................................12
Combining the web, application, and database servers .........................................................................................12
Combining the web and application servers...............................................................................................................12
Combining the application and database servers .....................................................................................................13
Separate web, application, and database servers......................................................................................................13
Adding additional web servers .........................................................................................................................................13
Adding additional application servers ...........................................................................................................................13
Multiple JVMs ..........................................................................................................................................................................14
Messaging topologies ..........................................................................................................................................................14
Embedded JMS.................................................................................................................................................................14
Using WebSphere MQ....................................................................................................................................................15
Unsupported topologies ...........................................................................................................................................................16
2
Configuring the Application Servers ....................................................................................... 17
Preparing to configure ...............................................................................................................................................................17
Installing the Deployment Manager .....................................................................................................................................17
Installing WebSphere Application Server............................................................................................................................17
Installing the WebSphere FixPacks..................................................................................................................................19
Creating an endorsed directory........................................................................................................................................19
Configuring the shared libraries.......................................................................................................................................19
Increasing the SOAP time-out .................................................................................................................................................21
Preparing WebSphere MQ ........................................................................................................................................................21
Installing the required software .......................................................................................................................................22
Configuring WebSphere MQ .............................................................................................................................................25
Setting the MQ_INSTALL_ROOT.......................................................................................................................................27
3
Configuring the Web Servers.................................................................................................... 28
Preparing for installation...........................................................................................................................................................28
Installing the web server ...........................................................................................................................................................28
Generating and updating the IBM HTTP Server plug-in ................................................................................................29
3
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
4
Contents
4
Configuring WebSphere Clusters............................................................................................. 30
Federating all nodes....................................................................................................................................................................30
Creating clusters by using the Deployment Manager....................................................................................................30
Setting up clusters .......................................................................................................................................................................31
Configuring cluster members..................................................................................................................................................32
Starting clusters ............................................................................................................................................................................32
5
Maintaining a WebSphere Cluster ........................................................................................... 33
Shutting down and restarting nodes and clusters...........................................................................................................33
Adding and removing nodes ...................................................................................................................................................33
Adding nodes ..........................................................................................................................................................................33
Removing nodes ....................................................................................................................................................................34
6
Configuring the Database......................................................................................................... 36
Installing database drivers ........................................................................................................................................................36
Configuring the databases .......................................................................................................................................................37
Configuring Oracle databases...........................................................................................................................................37
Configuring DB2 databases................................................................................................................................................37
Configuring a DB2 database for concurrent usage ...................................................................................................39
Configuring SQL Server databases ..................................................................................................................................39
Installing JTA stored procedures................................................................................................................................40
Enabling XA transactions for Windows Server 2003...........................................................................................41
Configuring datasources ...........................................................................................................................................................41
Configuring the Oracle data source ................................................................................................................................42
Configuring the DB2 data source.....................................................................................................................................43
Configuring the SQL Server data source .......................................................................................................................45
7
Configuring Security for LiveCycle Policy Server.................................................................... 48
8
Configuring Messaging and Security....................................................................................... 50
Configuring JMS resources for LiveCycle Policy Server..................................................................................................50
Configuring JMS resources with embedded messaging.........................................................................................50
Configuring JMS resources for WebSphere MQ .........................................................................................................52
Configuring messaging for other LiveCycle products ....................................................................................................55
Configuring JMS resources with embedded messaging.........................................................................................55
Configuring JMS resources for WebSphere MQ .........................................................................................................60
Configuring JMS resources ..........................................................................................................................................60
Creating WebSphere MQ queue destinations ......................................................................................................60
Creating WebSphere MQ topic destinations.........................................................................................................62
Creating a queue connection factory.......................................................................................................................63
Creating topic connection factories .........................................................................................................................64
Configuring the listener ports.....................................................................................................................................66
Configuring WebSphere MQ JMS provider for Watched Folder ....................................................................68
Checking your WebSphere MQ configuration ............................................................................................................68
9
Configuration Requirements.................................................................................................... 69
Large document handling ........................................................................................................................................................69
Common elements between LiveCycle products ............................................................................................................69
Configuring LiveCycle Workflow properties ......................................................................................................................69
Scheduler property definition and values that can be added...............................................................................69
Cache configuration properties........................................................................................................................................71
Adding property definitions ..............................................................................................................................................72
Email receiver configuration..............................................................................................................................................73
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
9
Contents
5
Configuration Requirements (Continued)
LiveCycle Policy Server caching configuration setup .....................................................................................................73
Configuring caching properties for User Management .................................................................................................73
Configuring JVM properties .....................................................................................................................................................74
10 Deploying LiveCycle Products .................................................................................................. 75
Assembling LiveCycle.ear for LiveCycle PDF Generator in a cluster..........................................................................75
About deploying LiveCycle products to a cluster ............................................................................................................75
Summary of deployable components ..................................................................................................................................75
Deploying LiveCycle products.................................................................................................................................................76
Starting the application .............................................................................................................................................................80
Verifying the LiveCycle Forms deployment........................................................................................................................80
Bootstrapping LiveCycle products.........................................................................................................................................81
Viewing log files............................................................................................................................................................................82
11 Issues with Clustering ............................................................................................................... 83
Failed to acquire job exception in WebSphere .................................................................................................................83
ORB threadpool for LiveCycle Policy Server and LiveCycle Document Security...................................................83
LiveCycle Forms preferences do not get propagated ....................................................................................................83
LiveCycle Reader Extensions UI is not supported in a cluster......................................................................................84
Preface
This document explains how to deploy an Adobe® LiveCycle® server product in a IBM® WebSphere®
Application Server 5.1 clustered environment.
Who should read this guide?
This guide provides information for administrators or developers responsible for installing, configuring,
administering, or deploying LiveCycle products. The information provided is based on the assumption that
anyone reading this guide is familiar with WebSphere Application Server, RedHat Linux®, SUSE™ Linux,
Microsoft® Windows®, AIX®, or Sun™ Solaris™ operating systems, MySQL, Oracle®, DB2®, or SQL Server
database servers, and web environments.
Versions
This document describes clustering for LiveCycle 7.2.x.
Conventions used in this guide
This guide uses the following naming conventions for common file paths.
Name
Default value
Description
[LiveCycle root]
Windows:
C:\Adobe\LiveCycle\
The installation directory that is used
for all LiveCycle products. The
installation directory contains
subdirectories for Adobe
Configuration Manager, product
SDKs, and each LiveCycle product
installed (along with the product
documentation).
Linux and UNIX®:
/opt/adobe/livecycle/
[appserver root]
Windows:
C:\Program Files\WebSphere\AppServer
Linux and UNIX:
/opt/WebSphere/AppServer
[dbserver root]
Depends on the database type and your
specification during installation.
The home directory of the
application server that runs the
LiveCycle products.
The location where the LiveCycle
database server is installed.
6
Adobe LiveCycle
Preface
Configuring LiveCycle Application Server Clusters Using WebSphere
Related documentation
Name
Default value
Description
[product root]
Windows:
C:\Adobe\LiveCycle\Assembler
C:\Adobe\LiveCycle\pdfgenerator
C:\Adobe\LiveCycle\Workflow
C:\Adobe\LiveCycle\Forms
C:\Adobe\LiveCycle\Print
C:\Adobe\LiveCycle\Formmanager
The directories where
product-specific directories and files
(such as documentation, uninstall
files, samples, and license
information) are located.
Linux, UNIX:
/opt/adobe/livecycle/assembler
/opt/adobe/livecycle/pdfgenerator
/opt/adobe/livecycle/workflow
/opt/adobe/livecycle/forms
/opt/adobe/livecycle/print
/opt/adobe/livecycle/formmanager
Most of the information about directory locations in this guide is cross-platform (all file names and paths
are case-sensitive on Linux). Any platform-specific information is indicated as required.
Related documentation
This document should be used in conjunction with the Installing and Configuring LiveCycle guide or the
Installing and Configuring LiveCycle Security Products guide for your application server. Throughout this
document, specific sections in these installing and configuring guides are listed when more detailed
information is available.
The Installing and Configuring LiveCycle 7.2.x guides apply to the following products:
●
Adobe LiveCycle Assembler 7.2.1
●
Adobe LiveCycle Forms 7.2
●
Adobe LiveCycle Form Manager 7.2.2
●
Adobe LiveCycle PDF Generator 7.2 and 7.2.2
●
Adobe LiveCycle Print 7.2
●
Adobe LiveCycle Workflow 7.2.2
●
Adobe LiveCycle Workflow Designer 7.2.2
●
Watched Folder 1.2
The Installing and Configuring LiveCycle Security Products guides apply to the following products:
●
Adobe LiveCycle Document Security 7.2 and 7.2.2
●
Adobe LiveCycle Reader® Extensions 7.2
●
Adobe LiveCycle Policy Server7.2
7
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Preface
Updated LiveCycle product information
Updated LiveCycle product information
Adobe Systems has posted a Knowledge Center article to communicate any updated LiveCycle product
information with customers. You can access the article at:
www.adobe.com/support/products/enterprise/knowledgecenter/c4811.pdf.
8
1
Overview
This section describes the benefits and issues associated with setting up clusters.
About clustering application servers
A cluster is a group of application server instances running simultaneously, which act like a single system
enabling load distribution, load balancing, scalability, high availability, and failover. Within a cluster,
multiple server instances can run on the same computer (known as a vertical cluster) or be located on
different computers (known as a horizontal cluster), or they can form a combination of both horizontal and
vertical clusters. With clustering, client work can be distributed across several nodes instead of being
handled by a single application server.
In a clustered configuration, application server instances are server members of the cluster, all of which
must have identical application components deployed on them. However, other than the configured
applications, cluster members do not have to share any other configuration parameters. For example, you
can cluster multiple server instances on one computer, with a single instance on another computer,
provided they are all running WebSphere 5.1.
By clustering, you can achieve one or more of the following benefits. How you implement clustering
determines which benefits are achieved:
●
Failover
●
Load balancing
●
Load distribution
●
Scalability
9
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Overview
Failover
10
Failover
Failover allows one application server instance to act as a backup to a failed application server instance
and resume processing the task, thereby enabling one application server to carry on processing. Some
products, such as LiveCycle Workflow, can recover process states at the step and process levels.
Load balancing
Load balancing is a technique used to distribute processing and communications activity evenly across a
number of systems so that no single device is overwhelmed. If one server starts to get congested or
overloaded, requests are forwarded to another server with more capacity.
Application server load balancing is useful for managing the load between application server tiers.
Application servers can be configured to use a weighted round-robin routing policy that ensures routing
distribution based on the set of server weights that have been assigned to the members of a cluster.
Configuring all servers in the cluster to have the same weight produces a load distribution in which all
servers receive the same number of requests and this configuration is recommended when all nodes in
the cluster have similar hardware configurations. Weighting some servers more heavily sends more
requests to these servers than the lower weight value servers.
Preferred routing configurations can also be configured to ensure, for example, that only cluster members
on that node are selected (using the round-robin weight method) and cluster members on remote nodes
are selected only if a local server is not available. Application server load balancing is best used when
balancing is needed between tiers.
Web server load balancing
Web server load balancing is useful for queuing and throttling requests. For IBM HTTP Server, the two most
commonly used methods for load balancing and single-system imaging are Round-Robin DNS and the
IBM eNetwork Dispatcher.
Round-Robin DNS is a relatively simple method of load balancing, where a DNS (Domain Name System)
server provides a name to address resolution and is always involved when a host name is included in a
URL. A Round-Robin DNS server has the capability of resolving one single host name into multiple IP
addresses, such that requests for a single URL (containing a host name) actually reference different web
servers. The client requests a name resolution for the host name, but in fact receives different IP addresses,
thus spreading the load among the web servers. In a simple configuration, the Round-Robin DNS server
cycles through the list of available servers.
The IBM eNetwork Dispatcher provides load balancing services by routing TCP/IP session requests to
different servers in a cluster, using advisor services to query and evaluate the load of each of the servers in
the cluster. The manager service routes clients' requests to a web server based on the current load
information received from these advisor services. The web servers process the requests and respond
directly to the clients.
Scalability
Scalability in a cluster is the capability of an administrator to increase the capacity of the application
dynamically to meet the demand without interrupting or negatively impacting service. WebSphere
clusters allow administrators to remove nodes from a cluster in order to upgrade components, such as
memory, or to add nodes to the cluster without bringing down the cluster itself.
Adobe LiveCycle
Overview
Configuring LiveCycle Application Server Clusters Using WebSphere
WebSphere and distributed sessions
11
WebSphere and distributed sessions
The HTTP protocol is a stateless protocol. However, an HTTP session provides the ability to track a series of
requests and associate those requests with a specific user, thereby allowing applications to appear
stateful. Furthermore, applications store user information and other information, which means that they
need to track sessions in some way, such as through cookies or URL rewriting. In the cluster environment
where multiple nodes can serve user requests, it is very important that user Hot Standby Cluster
information is available during all requests by ensuring that up-to-date session data is available at all of
the nodes. Several different scenarios are used to achieve this requirement:
Persistence to database: In this scenario, all of the session data is stored in a database. If one server
node fails, other servers can retrieve session data from the database and continue processing client
requests. In this scenario, session data survives the crash of a server.
Memory to memory: In this scenario, all of the session data is stored in memory at each node, and
some kind of replication service replicates the session data among nodes. Most application servers
provide peer-to peer-replication. WebSphere provides three models of memory-to-memory
replication:
●
Buddy system of single replica
●
Dedicated replication server
●
Peer-to-peer replication
The WebSphere Distributed Replication Service is used to replicate data among distributed processes in a
cell; however, session replication is only scalable when used with relatively small data sized objects or
small numbers of objects.
Terminology
WebSphere uses specific terminology, which is defined here to avoid confusion:
Server: Represents an instance of a Java™ virtual machine (JVM).
Node: Represents a physical system running one or more WebSphere servers.
Cell: Represents a logical grouping of multiple nodes for administrative purposes.
Cluster: Represents a logical grouping of multiple application servers within a cell for administration,
application deployment, load balancing, and failover purposes.
Federation: The process of joining a stand-alone WebSphere node to a WebSphere cell.
Clustering LiveCycle products
If you install a LiveCycle product on an application server cluster, here are a few things you must know:
●
(All LiveCycle products except LiveCycle PDF Generator Professional and
LiveCycle PDF Generator Elements) You are required to install the product on only one system, not
necessarily a server. After configuring the LiveCycle product, you can deploy it to the cluster.
●
(LiveCycle PDF Generator Professional and LiveCycle PDF Generator Elements) You must install the
product on each node of the cluster.
●
LiveCycle must be clustered by using a homogeneous topology (all nodes in the cluster must be
configured identically) on each application server it is deployed to. You can ensure that all modules are
configured identically by configuring run-time properties in the single-installation staging area.
Adobe LiveCycle
Overview
Configuring LiveCycle Application Server Clusters Using WebSphere
Supported topologies
12
●
The configuration is deployed using the single entity approach; all nodes in a cluster are deployed as if
deploying to a single node.
●
Server clustering is supported by WebSphere Application Server ND and WebSphere Application Server
Enterprise. Clustering is not supported by WebSphere Base or WebSphere Application Server Express.
For more information, see the appropriate chapter in this guide for the LiveCycle product you are
clustering.
Caution: LiveCycle requires that all nodes in the cluster run the same operating system.
Clustering LiveCycle products involves the following tasks:
1. Installing the web servers
2. Installing instances of WebSphere Application Server
3. Installing the Deployment Manager
4. Creating the cluster
●
Starting the Deployment Manager
●
Federating nodes into the cell
●
Creating the cluster using Deployment Manager
●
Setting up the cluster
●
Configuring the cluster members
●
Starting the cluster
5. Deploying applications
6. Generating the WebSphere HTTP plug-in
7. Starting the HTTP server
Supported topologies
The following sections discuss various topologies, both clustered and non-clustered, that can be
employed.
Combining the web, application, and database servers
This topology consists of a web server, an application server, and a database server on the same node. This
topology is the simplest one and must be used for development only.
Combining the web and application servers
This topology can be considered for production in cases where the load on the user interface (including
the web tier) is minimal, with a small number of users.
Combining the web and application servers means that all Enterprise Java Bean (EJB) look-ups are local,
and therefore reduces the overhead of doing a remote look-up. Also, it reduces network overhead of a
round trip between the web tier and the application tier.
Adobe LiveCycle
Overview
Configuring LiveCycle Application Server Clusters Using WebSphere
Combining the application and database servers
13
However, with both servers on the same node, if the web tier is compromised, both tiers are compromised,
and if the web tier experiences a heavy load, the application server processing is affected and vice versa.
User response time is usually affected in situations when users need to wait a significant amount of time to
get a page back due to all server resources (that is, CPU and/or memory) being consumed by the
application server. If the web tier has a large session size, the application could be deprived of the memory
required to process messages off the Java Message Service (JMS) layer.
Combining the application and database servers
The simplest topology that should be considered for a production environment is a web server and
combined application server with database server. Use this topology only if you are sure that your
database load will be minimal. In this scenario, the web server is providing a redirection to the application
server. The advantages of this topology are low cost, low complexity, and no need for load balancing. The
disadvantages of this topology are little redundancy, low scalability, inability to perform updates and
upgrades, and possible low performance due to too many CPU processes.
Separate web, application, and database servers
This topology is the most common in production systems because it allows allocation of separate
resources to each of the tiers. In this case, the web server acts as a proxy to the web tier on the application
server that hosts the web components. This level of indirection provides additional security by securing
the application server even if the web server is compromised.
Adding additional web servers
You can add additional web servers for scalability and failover. When using multiple web servers, the
WebSphere HTTP plug-in configuration file must be applied to each web server. Failure to do so after
introducing a new application will likely cause a 404 File Not Found error to occur when a user tries to
access the web application.
Adding additional application servers
This topology is used in most large-scale production systems where the application servers are clustered
to provide high availability and, based on the application server capabilities, failover and load balancing.
Clustering application servers has these benefits:
●
Allows you to use cheaper hardware configurations and still achieve higher performance
●
Allows you to upgrade software on servers without downtime
●
Provides higher availability (that is, if one server fails, the other nodes in the cluster pick up the
processing)
●
Provides the ability to leverage load balancing algorithms on the web server (by using load balancers)
as well as on the EJB tier for processing requests
●
Can provide faster average scalability and throughput
LiveCycle products are typically CPU-bound and, as a result, performance gains are better achieved by
adding more application servers than by adding more memory or disk space to an existing server.
Adobe LiveCycle
Overview
Configuring LiveCycle Application Server Clusters Using WebSphere
Multiple JVMs
14
Multiple JVMs
Vertical scaling of multiple JVMs offers the following advantages:
Better utilization of CPU resources: An instance of an application server runs in a single JVM process.
However, the inherent concurrency limitations of a JVM process prevent it from fully utilizing the
processing power of a machine. Creating additional JVM processes provides multiple thread pools,
each corresponding to the JVM process associated with each application server process. This
correspondence avoids concurrency limitations and lets the application server use the full processing
power of the machine.
Load balancing: Vertical scaling topologies can use the WebSphere Application Server workload
management facility.
Process failover: A vertical scaling topology also provides failover support among application server
cluster members. If one application server instance goes offline, the other instances on the machine
continue to process client requests.
For more information on vertical clustering, go to the IBM website at
http://publib.boulder.ibm.com/infocenter/wasinfo/v5r1//index.jsp?topic=/com.ibm.websphere.nd.doc/in
fo/ae/ae/ctop_vertscale.html
Messaging topologies
The following sections discuss various messaging topologies that can be employed.
Embedded JMS
Embedded JMS is not recommended for WebSphere Application Server clusters. Although embedded JMS
can function in a cluster, data cannot be effectively shared between embedded JMS nodes in a cluster.
Also, because nodes are not handled as a single entity, deployment is unsatisfactory and failover is not
supported. Finally, embedded JMS is not scalable. In a production environment, WebSphere MQ
messaging is required.
You can configure embedded JMS in various messaging topologies:
●
Single WebSphere Application Server, with a single embedded JMS server
●
Multiple WebSphere Application Servers, with a single embedded JMS server
●
Multiple WebSphere Application Servers, each with their own embedded JMS server
A single JMS server in a single or multiserver environment is simple to configure and does not require JMS
Server Management. Because the data store (where messages are stored) is not available for tuning and/or
management, the single JMS server cannot be tuned as it is started, nor can it be managed by the
WebSphere Application Server.
Using a JMS server for each WebSphere Application Server is the preferred configuration for clustering
WebSphere Application Servers, even though the JMS servers are not clustered. It provides redundancy
with minimal additional configuration. However, all messages are node-locked; that is, if one JMS server on
a WebSphere Application Server fails, its messages remain on the node and cannot be recovered unless
the server recovers. Also, you cannot load balance because each JMS server is local to the WebSphere
Application Server.
Adobe LiveCycle
Overview
Configuring LiveCycle Application Server Clusters Using WebSphere
Messaging topologies
15
Depending on which topology is selected, the configuration of connection factories and topics will be
configured differently.
JMS server implementation
Topic configuration
Single WebSphere Application
Server and a single JMS server
Because this configuration has one embedded JMS server, the
topics can be defined at the cell level.
Multiple WebSphere Application
Servers and a single JMS server
With only one embedded JMS server, the topics need to be at the
node level on a server within the cluster running the JMS server
and both topic connection factories pointing to that JMS server.
Some LiveCycle products, such as LiveCycle Forms and
LiveCycle Form Manager do not support this topology.
Multiple WebSphere Application
Servers, each with their own JMS
In this configuration, the connection factories and topics need to
be defined at the node level to leverage the individual JMS servers.
Using WebSphere MQ
In various topologies, you can configure these components:
●
Multiple WebSphere MQ managers
●
One WebSphere MQ manager per WebSphere Application Server cluster; WebSphere MQ in
parent-child mode
It is recommended that the WebSphere MQ is installed on a separate server from any of the cluster nodes.
The WebSphere MQ client and JMS are installed on each WebSphere Application Server node in the
cluster.
Multiple WebSphere MQ managers
You can configure the WebSphere Application Server to connect to another WebSphere MQ server if the
queue manager fails. To implement this configuration, all WebSphere MQ queue managers need to be
configured. There will be more processes to manage because each WebSphere MQ needs the queue
manager, queue broker, and message listener configured. Although multiple WebSphere MQ servers may
be running, this configuration does not support failover because a message delivered to one queue
manager from one WebSphere Application Server can only be processed by that WebSphere MQ queue
manager.
One WebSphere MQ manager per WebSphere Application Server cluster; WebSphere MQ in
parent-child mode
When installing a WebSphere MQ manager per WebSphere Application Server cluster in parent-child
mode, there is effectively one WebSphere MQ manager per cluster of WebSphere Application Servers.
Therefore, the topics need to be defined at the node level, and the topic connection factory needs to be
configured with Clone Support enabled and a specific Client ID set for the connection factory. If the parent
queue manager fails, the child queue manager processes future messages without having to reconfigure
the WebSphere Application Servers. However, there is additional configuration overhead of setting up
broker communication and broker topology.
Adobe LiveCycle
Overview
Configuring LiveCycle Application Server Clusters Using WebSphere
Unsupported topologies
16
Depending on which topology you select, the configuration of connection factories and topics will be
configured differently.
WebSphere MQ
Topic configuration
One WebSphere MQ per WebSphere
Application Server
In this configuration, the topics need to be defined at the
node level. Because there is a single WebSphere MQ manager
per server, the connection factories need to be defined at the
node level to leverage both WebSphere MQ queue managers.
One WebSphere MQ per WebSphere
Application Server cluster; WebSphere
MQ in parent-child mode
In this configuration, there is effectively one WebSphere MQ
manager per cluster of WebSphere Application Servers, so
the topics need to be defined at the node level, and the topic
connection factory needs to be configured with Clone
Support enabled and a Client ID needs to be set for the
connection factory.
For details about the topology setup, see Chapter 2 of the Pub-Sub User guide at
www-306.ibm.com/software/integration/mqfamily/library/manualsa/.
Unsupported topologies
The following topologies are not supported for LiveCycle.
Splitting the web container / EJB container
Splitting LiveCycle servers into presentation/business logic tiers and running them on distributed
computers is not supported.
Geographically distributed configuration
Many applications locate their systems geographically to help distribute the load and provide an added
level of redundancy. LiveCycle does not support this configuration because LiveCycle components cannot
be pulled apart to run on different hosts; LiveCycle is deployed as a monolithic application.
2
Configuring the Application Servers
You can install the WebSphere Application Server Base on each node in the cluster. The Deployment
Manager is to be installed on a separate system but not on one of the clustered nodes.
Preparing to configure
Before installing WebSphere, the following configuration tasks must be performed:
Disk space: Ensure that the partition that will hold the application server has 10 GB of free disk space.
Note: IBM AIX maintenance-level packages are extracted to /usr/sys/ist.images and can be up
to 1 GB.
IP address settings: All of the computers must have a fixed IP address and must be in the same DNS.
AIX port setting: If you are using AIX, the WebSphere default port 9090 conflicts with the AIX service
called wsmserver. In this case, a transport_BindException is generated and the product does not
deploy effectively. You must change the wsmserver port to a number other than 9090. To do so, edit
the /etc/services file by searching for the following line and changing 9090 to another port
number, such as 9091:
wsmserver 9090/tcp
Swap Space: You must increase the amount of swap space configured on your OS to 2 GB of swap
space for each 8 MB of RAM installed on the computer. You must make this change to each computer in
the cluster.
Installing the Deployment Manager
You must install the Deployment Manager (WebSphere Application Server Network Deployment) on an
administrative system. For information on installing the Deployment Manager see:
http://publib.boulder.ibm.com/infocenter/wasinfo/v5r1//index.jsp?topic=/com.ibm.websphere.nd.do
c/info/welcome_nd.html
Installing WebSphere Application Server
You must install WebSphere Application Server version 5.1.1.5 for running LiveCycle products. The
administrator user account that is being used to perform the WebSphere installation must have a user
name up to 12 characters in length.
The WebSphere embedded messaging server is supported for use in development environments where
server workloads are expected to be low. However, in production environments you must install
WebSphere MQ. The embedded messaging server option is not required when WebSphere MQ is installed.
The following steps detail how to install WebSphere Application Server. It is assumed that you have
downloaded and unzipped the installation file to an installation directory, and have opened a system
terminal and navigated to that directory.
Then, for each WebSphere Application Server node, perform the following procedure.
17
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Installing WebSphere Application Server
18
➤ To install WebSphere Application Server 5.1:
1. Run the installation program (install.exe, install.sh, or lauchpad.sh) from the appropriate directory for
your operating system.
2. Select Install the product.
3. Accept the License Agreement.
4. If you are installing WebSphere under AIX, errors may appear about missing filesets, such as
X11.fnt.ucs.ttf*, which are AIX Windows Unicode TrueType fonts. You can ignore these error
messages.
5. Select the Custom installation, and then select only the following features:
●
Application Server
●
Administration
●
●
●
Scripted Administration
●
Administrative Console
Ant and Deployment Tools
●
Deploy Tool
●
Ant Utilities
Web Server Plug-ins
●
●
Plug-in for IBM HTTP Server v2.0
Performance and Analysis Tools
●
Tivoli Performance Viewer
●
Dynamic Cache Monitor
●
Performance Servlet
●
Log Analyzer
Note: Be sure to deselect IBM HTTP Server version 1.3.28 and Plug-In for IBM HTTP Server 1.3.28,
which are enabled by default, and select Plug-In for IBM HTTP Server v2.0.
6. Specify the directory where WebSphere will be installed. On some operating systems, you may have to
specify the location of your HTTP server.
7. In the Node Name box, specify the name of the server and, in the Host Name or IP Address box,
specify the fully qualified host name or the IP address of the server. The Install Wizard confirms the
packages to be installed.
8. Click Next.
9. After the installation is complete, select whether to register the product.
10. Click Next, and then click Finish.
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Installing the WebSphere FixPacks
19
Installing the WebSphere FixPacks
Installing Fix Pack 1 upgrades your installation of WebSphere Application Server 5.1 to version 5.1.1. You
can obtain the Fix Pack from IBM at this location:
www-1.ibm.com/support/docview.wss?rs=180&context=SSEQTP&uid=swg24007195
Installing Cumulative Fix 5 upgrades version 5.1.1 to version 5.1.1.5. You can obtain Cumulative Fix 5 from
IBM at this location:
www-1.ibm.com/support/docview.wss?rs=180&uid=swg27006879
Creating an endorsed directory
If you have not installed LiveCycle, you must do so now before continuing.
You must create an endorsed directory in the WebSphere directory. The endorsed directory must be
placed in the same location, within the WebSphere directory, on each node that will be in the cluster and
on the Deployment Manager.
➤ To create an endorsed directory:
1. Navigate to the [appserver root]/java/jre/lib directory and create a directory called endorsed.
2. Copy the following files from the [LiveCycle root]/components/um/endorsed directory to the endorsed
directory you just created:
●
dom3-xercesImpl-2.4.0.jar
●
dom3-xml-apis-2.4.0.jar
●
xalan-2.4.1.jar
3. (Solaris) Move the [appserver root]/java/jre/lib/xml.jar file to the /java/jre/lib directory.
Note: For more information, see the Adobe Knowledge Center article c4863, LiveCycle Forms issues with
WebSphere.
Configuring the shared libraries
You must copy the DocumentServicesLibrary.jar file to the WebSphere directory on each base node in the
cluster, and then configure WebSphere shared libraries. You also need to configure a new classloader that
uses the shared library.
Note: All of tasks in this section must be performed for each node in the cluster. You must also copy the
Document Services Library file and configure the shared library files on the Deployment Manager.
Please ensure that you use the same directory path for all servers.
➤ (All products except LiveCycle Policy Server) To configure the DocumentServicesLibrary file:
1. Copy the DocumentServicesLibrary.jar file from the [LiveCycle root]/components/csa/websphere
/lib/adobe directory to the [appserver root]/optionalLibraries directory.
2. In the WebSphere Administrative Console navigation tree, select Environment > Shared Libraries and
click New.
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the shared libraries
3. On the Configuration page, specify the following information:
●
Under Scope, select all nodes and servers and change the scope to Cell.
●
In the Name box, type DocumentServicesLibrary.
●
In the Classpath box, type
[appserver root]/optionalLibraries/DocumentServicesLibrary.jar.
Then click Apply.
4. Click OK, and then save your changes to the Master Configuration.
➤ (LiveCycle Policy Server only) To configure the shared library files:
1. For each node in the cluster, copy the edc-server-spi.jar file from [LiveCycle
root]/policyserver/sdk/spi-lib/edc-server-spi.jar to the [appserver_root]/optionalLibraries directory.
2. In the WebSphere Administrative Console navigation tree, select Environment > Shared Libraries.
3. Click Browse Servers, select the server you are using for LiveCycle Policy Server, and then click OK.
4. Click Apply, and then click New.
5. On the Configuration page, type the following information:
●
Under Scope, select all nodes and servers and change the scope to Cell.
●
In the Name box, type EDCApplication
●
In the Classpath box, type
[appserver_root]/optionalLibraries/edc-server-spi.jar
then click Apply.
6. Click OK, and then click Save.
7. Save changes to the Master Configuration.
➤ To configure the classloader:
1. In the WebSphere Administrative Console navigation tree, select Servers > Application Servers.
2. Click the server instance that you are configuring (for example, server1).
3. In the Configuration tab under Additional Properties, click Classloader.
4. Click New. In the Class loader mode list, keep the default value Parent_First, and click OK.
5. On the page that appears, click the Classloader Id link of the newly created classloader instance.
6. On the page that appears, under Additional Properties, click Libraries and click Add.
7. In the Library Name list, select DocumentServicesLibrary and click OK.
8. (LiveCycle Policy Server only) In the Library Name list, select EDCApplication and click OK.
9. Save your changes to the Master Configuration.
10. Repeat steps 1 - 9 for each server in the cluster.
20
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Increasing the SOAP time-out
21
➤ (LiveCycle PDF Generator) To set the JVM properties:
1. In the WebSphere Administrative Console navigation tree, select Servers > Application Servers.
2. Click the server instance that you are configuring (for example, server1).
3. Click Process Definition and under Additional Properties, select Java Virtual Machine.
4. Under Additional properties, select Custom Properties and click New.
5. In the Name box, type java.io.tmpdir, and in the Value box, type a shared directory location that
is accessible to all servers in the cluster, and click OK.
6. Click New and in the Name box, type com.ibm.websphere.ejbcontainer.poolSize.
7. (LiveCycle PDF Generator for PostScript) In the Value box, type
pdfg-ps-all#adobe-PsToPdfEjb.jar#PsToPdfDequeue=1,3:*=40,100
8. (LiveCycle PDF Generator Professional or LiveCycle PDF Generator Elements) In the Value box, type
pdfg-all#aaes-ejb.jar#Dequeue=1,1:pdfg-all#adobe-PsToPdfEjb.jar#PsToPdfDeq
ueue=1,3:*=40,100
9. Click OK.
➤ (LiveCycle Policy Server only) To update the qname.jar file
1. Copy the jax-qname.jar from the [LiveCycle root]/PolicyServer/sdk/lib/WebSphere directory to the
[appserver root]/lib directory.
2. Delete the qname.jar file from the [appserver root]/lib directory. You must stop the application server to
do this step.
Increasing the SOAP time-out
For each node in the cluster and on the Deployment Manager, you must increase the default SOAP
time-out by editing the soap.client.props file.
Edit the soap.client.props file. You can find the file under this location:
[appserver root]/AppServer/properties (for stand-alone server)
[appserver root]/DeploymentManager/properties (for managed servers)
The default value for the com.ibm.SOAP.requestTimeout property is 180 seconds. You must change the
value to 1800, and then restart the server or the Deployment Manager and all of the nodes.
Preparing WebSphere MQ
This section applies only to LiveCycle Form Manager, LiveCycle Workflow, LiveCycle PDF Generator,
and Watched Folder (for use with LiveCycle Workflow and LiveCycle Assembler).
If you are using WebSphere 5.1.1.5 as your application server, you must install WebSphere MQ in
production environments and in development environments where server workloads are expected to be
high. In development environments where you expect low server workloads, you can use the WebSphere
embedded messaging server.
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Installing the required software
22
This section describes how to configure WebSphere MQ 5.3.0.1 in a non-clustered environment.
In this guide, [MQ_root] indicates the location at which WebSphere MQ is installed. The default installation
location varies depending on the operating system you are using:
●
(Windows) c:\Program Files\ibm\WebSphere MQ
●
(Solaris, Linux) /opt/mqm
●
(AIX) /usr/mqm
Installing the required software
You must install all of the required software according to the following procedure before proceeding with
the rest of the instructions in this section.
Note: WebSphere MQ and WebSphere Application Server do not need to be installed on the same
computer.
➤ To install the required software:
1. Ensure that the patch levels are correct for the operating system. Computers running AIX require
version 51-007 or later.
2. If you are installing WebSphere MQ on a computer that is running WebSphere Application Server, stop
the application server before the installation.
3. If you are installing WebSphere MQ on a computer that has WebSphere Application Server installed, go
to the [appserver root]\bin directory and run the setupCmdLine script to ensure that the environment
variables are set correctly.
4. If you are installing WebSphere MQ on a computer that does not have WebSphere Application Server
installed, install WebSphere MQ Client and Java Messaging on the machine where WebSphere
Application Server is installed.
5. Proceed to “To install WebSphere MQ on Windows:” on page 22 or “To install WebSphere MQ on UNIX:”
on page 23.
➤ To install WebSphere MQ on Windows:
1. Start the WebSphere MQ 5.3.0.1 installer.
2. If you are installing WebSphere MQ on a computer that does not have WebSphere Application Server
or Embedded Messaging installed, proceed to step 4.
If you are installing WebSphere MQ on a computer that has WebSphere Application Server installed
with Embedded Messaging, you are prompted to either modify or remove it. Select Remove, click Next
and, when prompted to either keep or remove existing queues, select Keep.
3. After the removal of the Embedded Messaging server is complete, start the installer again and select a
Custom installation.
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Installing the required software
23
4. On the Features panel of the installer, ensure that Server, Client, Java Messaging, and Development
Toolkit are all selected for installation and proceed with the installation.
Note: If you have installed WebSphere MQ on a computer that does not have WebSphere Application
Server installed, you must also install WebSphere MQ Client and Java Messaging on the
computer running WebSphere Application Server.
Note: For computers with both WebSphere Application Server and WebSphere MQ, the MQ client and
Java Messaging must be installed on all nodes in the cluster and the Deployment Manager. They
must be installed in the same location on each server, and the MQ_INSTALL_ROOT must be set
at the node level for each node in the cluster as well as the Deployment Manager.
5. When the installation is complete, the Prepare WebSphere MQ Wizard appears. Use the wizard to
configure MQ for your environment.
6. Proceed to “To complete the post-installation tasks:” on page 23.
➤ To install WebSphere MQ on UNIX:
1. Read and follow the WebSphere MQ Quick Beginnings document for the operating system on which
you plan to install WebSphere MQ.
2. When given the option, install Server, Client, and Java Messaging.
3. If you have installed WebSphere MQ on a computer that does not have WebSphere Application Server
installed, install WebSphere MQ Client and Java Messaging on the computer running WebSphere
Application Server.
4. Proceed to “To complete the post-installation tasks:” on page 23.
➤ To complete the post-installation tasks:
1. (Windows) Stop WebSphere MQ and use Task Manager to stop any tasks that begin with “amq”.
2. From a command prompt, install Fix Pack 10 (formerly CSD10). Fix Pack 10 is required for the
installation of the Java Messaging support, which is required by LiveCycle products. You can obtain the
Fix Pack from IBM at this location:
http://www-1.ibm.com/support/docview.wss?rs=171&context=SSFKSJ&context=SSWHKB&q1=CS
D10&uid=swg24009688&loc=en_US&cs=utf-8&lang=en
3. Define a local user and add the user to the mqm group, which was created during the WebSphere MQ
install. The user name must be less than 12 characters long. You will later select this user when
configuring the JMS connection factories in WebSphere Application Server.
On Windows, the WebSphere MQ install creates both the mqm group and a user named
MUSR_MQADMIN. Do not alter this user, because WebSphere MQ uses it to run some services. If you
have altered this user, run the following command from the [MQ_root]\bin folder to reset it:
amqmsrvn -regserver
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Installing the required software
24
4. (UNIX) Log on using the mqm user account you created and update the CLASSPATH,
MQ_JAVA_INSTALL_PATH, MQ_JAVA_DATA_PATH, and LD_LIBRARY_PATH, as required, from a
command prompt. For example, under Solaris, the paths could look like this:
●
export
CLASSPATH=/opt/mqm/java/lib/com.ibm.mq.jar:/opt/mqm/java/lib/com.ibm.mqj
ms.jar:/opt/mqm/java/lib/connector.jar:/opt/mqm/java/lib/jms.jar:/opt/mq
m/java/lib/jndi.jar:/opt/mqm/java/lib/jta.jar:/opt/mqm/java
●
export MQ_JAVA_INSTALL_PATH=/opt/mqm/java
●
export MQ_JAVA_DATA_PATH=/var/mqm
●
export LD_LIBRARY_PATH=/opt/mqm/java/lib
5. Copy the following scripts from the [LiveCycle root]/configurationManager/scripts/mq_server directory
to the [MQ_root]/bin directory:
●
configure_MQ
●
LC_Queues.mqsc
●
setMqClasspath
●
start_MQ
Note: (UNIX) Copy the scripts using the mqm user account you created when you installed WebSphere
MQ.
6. Copy the LC_JmsDefs.scp script from the [LiveCycle root]/configurationManager/scripts/mq_server
directory to the [MQ_root]/Java/bin directory.
Note: (UNIX) Copy the scripts using the mqm user account you created when you installed WebSphere
MQ.
7. From a command prompt, run the following script:
●
(Windows) From the directory containing the configure_MQ.bat file, enter the following command:
configure_MQ.bat queue_manager_name
where queue_manager_name is an appropriate queue manager name for the node.
●
(UNIX) From the directory containing the configure_MQ.sh file, enter the following command:
configure_MQ.sh queue_manager_name MQ_root MQ_Java_data_path
where queue_manager_name is an appropriate queue manager name for the node, MQ_root is
the location at which WebSphere MQ is installed (by default, /usr/mqm), and
MQ_Java_data_path is the data install path (by default, /var/mqm).
Note: If you close or lose this prompt for any reason, you must run the setMqClasspath script by
entering the following command in any subsequent command windows that you use to
administer WebSphere MQ:
●
(Windows) setMqClasspath.bat
●
(UNIX) setMqClasspath.sh MQ_root MQ_Java_data_path
Note: (UNIX) Run the script using the mqm user account you created when you installed WebSphere
MQ.
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring WebSphere MQ
25
Configuring WebSphere MQ
After you install WebSphere MQ, you must configure it so that the application server can access it.
➤ To configure WebSphere MQ:
1. Create the cfstore directory. The location of the directory will differ depending on your operating
system:
●
(Windows) C:\cfstore
●
(UNIX) /opt/cfstore
2. (UNIX) Under the /opt/cfstore directory create two additional directories named jms and topic.
3. Modify the JMSAdmin.config file, located in the [MQ_root]\Java\bin directory:
●
Uncomment the
INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory setting,
and comment out the rest of the INITIAL_CONTEXT_FACTORY settings. This is the setting to use a
filestore. If you want to use LDAP or WebSphere JNDI, see the appropriate IBM documentation.
●
Set the PROVIDER_URL property and create the corresponding directory on your computer:
●
(Windows) PROVIDER_URL=file:/C:/cfstore
●
(UNIX) PROVIDER_URL=file:/opt/cfstore
Note: If you are running on Windows, ensure that the path does not contain backslash characters (\).
Replace any backslash characters with forward slash characters (/).
4. Create JMS definitions by opening a command prompt and navigating to the [MQ_root]\java\bin
directory, and then run the following script:
JMSAdmin < LC_JmsDefs.scp
Note: This step should be performed for the first queue manager only.
Note: (UNIX) Run the script using the mqm user account you created when you installed WebSphere
MQ.
5. Start the MQ services or daemons by navigating to the [MQ_root]/bin directory and entering the
following command:
●
(Windows) start_MQ.bat queue_manager_name
●
(UNIX) start_MQ.sh queue_manager_name port
Note: (UNIX) Run the script using the mqm user account you created when you installed WebSphere
MQ.
The port number you provide will be required when configuring WebSphere Application Server
queues and topics, so be sure to select an available port. The default port number for WebSphere MQ is
1414.
If you receive a message that the queue manager is already running, ignore this message. If you need
to restart MQ services or daemons, run the start_MQ script again.
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring WebSphere MQ
26
6. (Windows) Start the message listener service:
●
Select Start > All Programs > IBM WebSphere MQ > WebSphere MQ Services.
●
Expand WebSphere MQ Services and right-click the queue manager you created in “To complete
the post-installation tasks:” on page 23.
●
Select New > Listener.
●
On the Parameters tab, set Protocol to TCP, set Port to an available port number, set Local Address
to the address of the computer where MQ is installed, and then click OK.
●
To start the listener, in the right pane, right-click the listener you just created and select All Tasks >
Start.
7. (Windows) Add a custom service in MQ Services by selecting Start > All Programs > IBM Websphere
MQ > Websphere MQ Services.
8. (Windows) Click Websphere MQ Services > [your queue manager], right-click Custom Services, and
select New > Custom Service.
9. (Windows) Specify the following values for the properties in the dialog box:
●
Service Name: queue_manager_name Broker
●
Start Command: strmqbrk -m queue_manager_name
●
End Command: endmqbrk -m queue_manager_name
●
Execution: COMMAND
●
Startup: AFTER
10. (Windows) Right-click your queue manager, and then select All Tasks > Stop.
11. (Windows) Right-click your queue manager, and then select All Tasks > Start.
Note: To properly start MQ, use the MQ Services Console to ensure that both the listener and the
broker are started.
12. For each queue manager, perform steps 13 to 15.
13. Highlight the queue manager. Notice that it is set to start Manually.
14. Right-click the queue manager and select Properties.
15. In the Startup Type box, select Automatic.
16. (UNIX) Start the broker by running the following command from the [MQ root]/bin directory:
strmqbrk -m queue_manager_name
Note: (UNIX) Run the script using the mqm user account you created when you installed WebSphere
MQ.
17. (Optional) Verify the publish-subscribe setup by navigating to the [MQ_root]\java\bin directory and
running the PSIVTRun.bat (Windows) or the PSIVTRun.sh file (UNIX) by entering the following
command:
PSIVTRun –nojndi –m queue_manager_name -t
Note: (UNIX) Run the script using the mqm user account you created when you installed WebSphere
MQ.
Adobe LiveCycle
Configuring the Application Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Setting the MQ_INSTALL_ROOT
27
18. Verify that the administration channel exists on WebSphere MQ for the Queue manager by navigating
to the [MQ_root]/bin directory and performing the following steps:
●
Run the runmqsc queue_manager_name command.
●
Ensure that the SYSTEM.ADMIN.SVRCONN channel exists by entering the following command:
dis chl (SYSTEM.ADMIN*) all
●
If the channel does not exist, create it by entering the following command:
define channel(SYSTEM.ADMIN.SVRCONN) chltype(SVRCONN)
●
Ensure that security is disabled by entering the following command:
alter channel(SYSTEM.ADMIN.SVRCONN) chltype(SVRCONN) mcauser('mqm')
●
Refresh the security cache by entering the following command:
refresh security(*)
●
Exit by entering the command end
Note: (UNIX) Run the script using the mqm user account you created when you installed WebSphere
MQ.
19. If all of the preceding steps were successful, restart WebSphere Application Server.
Setting the MQ_INSTALL_ROOT
The following procedure must be performed after the cluster has been created.
You must now set the MQ_INSTALL_ROOT to the location of the MQ installation for the Deployment
Manager and each node in the cluster.
➤ To set the MQ_INSTALL_ROOT environment variable:
1. Log in to WebSphere Administrative Console (by default, http://server_name:9090/admin)
2. Click Browse Nodes, select a member of the cluster and, in the navigation tree, select Environment >
Manage WebSphere Variables.
3. In the right pane, select MQ_INSTALL_ROOT, set the Value property to the location where you
installed WebSphere MQ, and click OK.
4. Save your changes to the master configuration.
3
Configuring the Web Servers
It is recommended that you use IBM HTTP server that ships with the WebSphere Application Server.
Preparing for installation
Before you install the web server, the following configuration tasks must be performed:
Server domain: If you are using a domain architecture, ensure that the server is not a member of any
domain other than the same domain as the LDAP server.
Java JRE: IBM HTTP Server installation is a GUI-based Java application that requires the installation of
the IBM Java Runtime Environment. After it is installed, define a system environment variable called
JAVA_HOME that points to the installation of the JRE.
Create local user: In Microsoft Windows, if you plan to run the HTTP server as a service, you can create
a local account and make this account a part of the local administrators group.
Installing the web server
The following steps detail how to install IBM HTTP 2.0 server. For information on installing and configuring
other IBM supported web servers such as Apache, Microsoft IIS and Sun Java System Web Server, see
http://publib.boulder.ibm.com/infocenter/wasinfo/v5r1//index.jsp?topic=/com.ibm.websphere.base.doc/
info/aes/ae/tins_manualWebServer.html
It is assumed that you have downloaded and unzipped the installation file to an installation directory, and
have opened a system terminal and navigated to that directory.
Note: This procedure can be used to upgrade the current version of IBM HTTP Server by replacing the
existing installation.
➤ To install the web server:
1. From the command prompt, type java –jar setup.jar.
2. Specify the language used for the installation (for example, type English).
3. Accept the terms of the license agreement.
4. Select the directory where the server will be installed, and then select Custom installation.
5. Select the following products:
●
●
HTTP Server Base
●
Application Files
●
Documentation
Base Extensions
●
Security
6. Select the languages you want your web server to support.
28
Adobe LiveCycle
Configuring the Web Servers
Configuring LiveCycle Application Server Clusters Using WebSphere
Generating and updating the IBM HTTP Server plug-in
29
7. If your operating system allows you to run the server as a service, in the User ID box, enter the user
account to run the service under and, in the password and password verification boxes, type the user
account password.
8. On the Summary screen, click Next.
9. Click Finish.
If you are running Windows, when the installation is complete, reboot the server.
IBM HTTP Server should now be running. By default, IBM HTTP Server runs on port 80. If you already have
another web server running on the computer and listening on port 80, you need to shut down the other
server and then navigate to http://[localhost]/, where you will see the server Welcome page.
Generating and updating the IBM HTTP Server plug-in
After deploying all of your applications, the IBM HTTP Server plug-in (plugin-cfg.xml) file must be
regenerated and then deployed to all of the web servers.
➤ To regenerate the IBM HTTP Server plug-in:
1. In a web browser, type the URL to the Deployment Manager; for example, type:
http://<servername>:9090/admin
2. In the left frame, select Environment, and then click the Update Web Server Plugin link.
3. Click OK.
➤ To deploy the WebSphere HTTP Server plug-in to all web servers:
1. From the application server, copy the plugin-cfg.xml file (this file is created in the
[Appserver]\DeploymentManager\config\cells directory) to the appropriate directory on the web server.
The last line in the web server's configuration file named httpd.conf points to where the plug-in
expects to find the configuration file, as in the following example:
WebSpherePluginConfig "C:\WASV5\DeploymentManager/config/cells/plugin-cfg.xml".
2. From the application server, copy the mod_was_ap20_http.dll file located in the [Appserver]\bin
directory to the modules directory of all web servers. For example, in Windows the directory would be
C:\Program Files\IBMHTTPServer\modules.
3. Edit the httpd.conf file on all web servers, adding references to the mod_was_ap20_http.dll and
plugin-cfg.xml files; for example, type the following lines:
LoadModule_was_ap_20_module "[webserver root]\bin\mod_was_ap20_http.dll"
WebSpherePluginConfig "[webserver root]\conf\plugin-cfg.xml"
where [webserver root] specifies the directory where the IBM HTTP server is installed.
4. Restart the IBM HTTP Server service.
Note: If you have another IIS API plug-in, it may conflict with the IBM HTTP plug-in.
4
Configuring WebSphere Clusters
Creating WebSphere clusters involves the following tasks:
●
Federating the nodes
●
Creating clusters using the Deployment Manager
●
Setting up the clusters
●
Adding ports to the host alias list
Federating all nodes
After a node is federated to a WebSphere Deployment Manager, the WebSphere Administrative Console is
removed and a node agent is installed. The Deployment Manager communicates with individual servers
on nodes by using the node agent. (See www-1.ibm.com/support/docview.wss?uid=swg21145880.)
In order to federate the nodes, stop the servers on each node and ensure that the Deployment Manager is
running. Check to ensure that you can ping the Deployment Manager from each node by name, not
simply by IP address. It is also important to ensure that the server system clocks are synchronized to within
5 minutes of each other.
From a command prompt, navigate to the bin directory under the installation root of a node where the
WebSphere Application Server base is installed. Run the addNode script (addNode.bat for Windows,
addNode.sh for Linux/UNIX) and use the computer name as a parameter; for example, type:
addNode.bat [DeploymentManagerMachineName] [DeploymentManagerPort]
In addition to federating the node to the cell, addNode also starts the node agent process. After the node
is federated to a cell, the node agent is started with the startNode command, which is also located in the
application server bin directory. During this process, the node being federated communicates to the
Deployment Manager using port 8879, by default.
The node agent pings all of the application servers on a node. When the node agent detects that the
application server is not available, it tries to stop and restart the application server. It is a good idea to add
the node agent as an operating system daemon process in UNIX. You can add the node agent as a service
in Windows by using WASService, available in the bin directory of the base application server
installation.
Creating clusters by using the Deployment Manager
Log in to the Administrative Console of the Deployment Manager computer. By default, the Administrative
Console web application listens on port 9090.
➤ To create a cluster using the Deployment Manager:
1. In a web browser, type the URL of the Deployment Manager; for example, type
http://<servername>:9090/admin.
2. In the left frame, expand the Servers menu and click the Clusters link.
30
Adobe LiveCycle
Configuring WebSphere Clusters
Configuring LiveCycle Application Server Clusters Using WebSphere
Setting up clusters
31
3. Click the New button and click Next.
4. In the Step 1: Enter Basic Cluster Information window, type the name of the cluster; for example, type
myCluster.
5. Select the following options, and then click Next:
●
Prefer local enabled
●
Create Replication Domain for this cluster
●
Do not include an existing server in this cluster
6. In the Step 2: Create New Clustered Servers window, enter a unique name for the server to be added to
the cluster.
7. In the Select Node list, select the node that will contain the new cluster member.
8. In the Weight box, type the server weight. Servers with a higher value receive a larger share of the
cluster’s workload.
9. Select Generate Unique Http Ports, select Create Replication Entry in this Server, and then select
Default application server template.
10. In the list, select a template, and then click Apply.
11. Repeat steps 6 to 10 for each additional server in the cluster, and then click Next.
12. In the Step 3: Summary window, click Finish. A warning appears stating that changes have been made
to the local configuration.
13. Click Save.
14. In the Save to Master Configuration window, select Synchronize changes with Nodes and click Save.
Setting up clusters
For newly created servers, add the port numbers to the default host alias list.
➤ To add the port numbers to the default host alias list:
1. In the navigation tree, select Servers > Application Servers and select the primary server.
2. Select Web Container > HTTP Transports, and then verify that the port is in use.
3. Navigate back to Application Servers and repeat the previous step for each additional server.
4. Select Environment > Virtual Hosts.
5. Click Default Host in the Work-Area panel.
6. Scroll down and select Host Aliases, and then click New.
7. In the New window, enter the host name and port number for the primary server in the areas specified
and then click OK.
Adobe LiveCycle
Configuring WebSphere Clusters
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring cluster members
8. Repeat step 7 for each additional server.
Note: Ensure that each virtual host port number is unique for each server in the cluster.
9. Save your changes.
Configuring cluster members
Each cluster member must be configured for the new cluster.
➤ To configure a cluster member:
1. In the navigation frame, select Servers > Application Servers.
2. Select the server you are clustering, select Web Container. Under General Properties, select Enable
Servlet Caching, and then click OK.
3. Select Web Container > Session Management.
4. Under Additional Properties, click Distributed Environment Settings, then select Memory to
Memory Replication and also click the link.
5. Select Select replicator from the following domain and select your cluster.
6. In the second list, select the name of the replicator. When configuring server1, the replicator will be
server2 and, when configuring server2, the replicator will be server1.
7. Ensure that Runtime Mode is set to Both client and server.
8. Select Custom Tuning Parameters. Select the Very High option to optimize the tuning level for
performance.
9. Click OK.
10. Save your changes.
11. Repeat steps 1 to 9 for all cluster members.
Starting clusters
Now that the cluster has been created, it must be started manually.
➤ To start the cluster:
1. In a web browser, type the URL to Deployment Manager; for example, type:
http://<servername>:9090/admin
2. In the left frame, select Servers, and then click the Clusters link.
3. Select the cluster and click Start. The servers start in parallel. Alternatively, you can click Ripplestart,
which starts the servers in sequence.
32
5
Maintaining a WebSphere Cluster
This section describes typical tasks that are required for maintaining WebSphere clusters.
Shutting down and restarting nodes and clusters
The procedures below detail how to shut down and restart servers in a cluster.
➤ To shut down a cluster:
1. In a web browser, type the URL to the Deployment Manager; for example, type:
http://<servername>:9090/admin
2. In the left frame, select Servers and click the Clusters link.
3. Select the cluster and click Stop.
➤ To shut down a node:
1. In a web browser, type the URL to the Deployment Manager; for example, type:
http://<servername>:9090/admin
2. In the left frame, select System Administration and click Nodes.
3. Select the node and click Stop.
➤ To restart the nodes and the cluster:
1. Navigate to the bin directory of the application server on each node and run the startNode command:
●
(Windows) startNode.bat
●
(Linux, UNIX) startNode.sh
2. In a web browser, type the URL to the Deployment Manager; for example, type:
http://<servername>:9090/admin
3. In the Deployment Manager console, start the cluster by navigating to Servers > Clusters. Select the
cluster and click Start.
Adding and removing nodes
The procedures below detail how to add a node to or remove a node from an existing WebSphere cell
(with multiple nodes).
Adding nodes
In order to federate a node, start the servers on the new node and ensure that the Deployment Manager is
running. Check to ensure that you can ping the Deployment Manager from the new node by name, not
33
Adobe LiveCycle
Maintaining a WebSphere Cluster
Configuring LiveCycle Application Server Clusters Using WebSphere
Removing nodes
34
simply by IP address. It is also important to ensure that the server system clocks are synchronized so that
they are within 5 minutes of each other.
➤ To add a node to an existing cluster:
1. In a web browser, type the URL to the Deployment Manager; for example, type
http://<servername>:9090/admin
2. Expand the Servers menu in the left frame and click the Clusters link.
3. To view the members, click the cluster.
4. Click New and, in the Member name box, type the name of the application server.
5. In the Select Node list, select the node that will contain the new cluster member.
6. In the Weight box, type the server weight. Servers with higher values receive a larger share of the
cluster’s workload.
7. Select Generate Unique Http Ports, and then click Apply.
8. Click Next, and then click Finish. A warning appears stating that changes have been made to the local
configuration.
9. Click Save.
10. In the Save to Master Configuration window, select Synchronize changes with Nodes and click
Save.
11. Start the newly added server.
12. Stop all servers in the cluster. (See “Shutting down and restarting nodes and clusters” on page 33.)
13. Start all servers in the cluster. (See “Shutting down and restarting nodes and clusters” on page 33.)
14. In the Deployment Manager, list all of the Enterprise Applications. Select Applications > Enterprise
Applications. All deployed applications should now be started.
Removing nodes
Nodes can be removed using script files on each of the nodes.
➤ To remove a node from a cluster:
1. Verify that the Deployment Manager is running.
2. On each node, navigate to the bin directory of the application server and run the appropriate
removeNode and cleanup scripts:
●
(Windows) removeNode.bat
●
(Linux, UNIX) removeNode.sh
●
(Windows) cleanupNode.bat
●
(Linux, UNIX) cleanupNode.sh
Adobe LiveCycle
Maintaining a WebSphere Cluster
Configuring LiveCycle Application Server Clusters Using WebSphere
3. In a web browser, type the URL to the Deployment Manager; for example, type:
http://<servername>:9090/admin
4. In the left frame, select System Administration and click the Nodes link.
5. Verify that the node has been removed.
Removing nodes
35
6
Configuring the Database
Before installing some LiveCycle products to the cluster, the database must be configured. See the
installing and configuring guide for the LiveCycle product you are clustering.
To configure the database, you must have a database server installed and a database created. For more
information on creating and installing databases for LiveCycle products, see the installing and configuring
guide for the LiveCycle product you are clustering.
Installing database drivers
If you are installing an Oracle or DB2 database, you must install database drivers to the installation
directories of the application server. Drivers are required to enable Configuration Manager and the
application server to connect to the LiveCycle database. You need to install the drivers for the type of
database that you use for the LiveCycle database. These drivers have to be installed on the same [appserver
root] location for all nodes.
Caution: For LiveCycle Policy Server, the WebSphere embedded drivers are not supported for the MS SQL
Server 2000 SP 3 database. You can only use the Microsoft database drivers. These drivers are
available from the Microsoft website. For other LiveCycle products, you can use either the
embedded drivers or the Microsoft drivers. Configuration Manager does not support the
Microsoft drivers, so configuration can only be done manually. The data source creation will fail
when Configuration Manager is used.
➤ To install the Oracle driver:
1. Download the Oracle 10g (10.2.0.1) driver from
http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/htdocs/jdbc_10201.html.
2. In the [appserver root] directory, create a directory named db_driver.
3. Copy the ojdbc14.jar file that you downloaded to the [appserver root]/db_driver directory.
➤ To install the DB2 driver:
1. In the [appserver root] directory, create a directory named db_driver
2. Copy the db2jcc_license_cu.jar and db2jcc.jar files from the [dbserver root]/java directory, for example
[dbserver root]/ibm/Sqllib/java (Windows) or [dbserver root]/java (Linux, UNIX), to the
[appserver root]/db_driver directory.
➤ To install the Microsoft drivers:
1. Download the MS SQL Server 2000 SP 3 database drivers from
www.microsoft.com/downloads/details.aspx?familyid=07287B11-0502-461A-B138-2AA54BFDC03A&d
isplaylang=en.
2. In the [appserver root] directory, create a directory named db_driver.
3. Copy the msbase.jar, mssqlserver.jar, and msutil.jar files that you downloaded to the [appserver
root]/db_driver directory.
36
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the Database
Configuring the databases
37
Configuring the databases
This section describes how to set up the database that stores LiveCycle configuration information and
run-time data. The procedures described in this section apply to all LiveCycle products that use
User Management. If you previously configured the database for deploying other LiveCycle products, you
do not need to perform the tasks again.
Note: User Management is an optional feature for LiveCycle Forms.
If this is the first installation of a LiveCycle product, you must create an empty database. All of the tables
required to support LiveCycle products will be created by Configuration Manager when you initialize the
database.
Before creating the database, you must ensure that you have read the pre-installation requirements and
have the required software installed. Also note that if you are installing LiveCycle Policy Server along with
other LiveCycle products, two databases and two data sources are required.
Configuring Oracle databases
If you prefer not to use the default database that was created when you installed Oracle 9i or 10g, create a
new database using the Database Configuration Assistant tool. You must create a database that uses the
UTF-8 character set if the LiveCycle user records database authenticates against an LDAP directory that
uses UTF-8 characters.
You must also create a new user on the database. For deployments on Linux and UNIX, the user name must
not exceed 8 characters and, on Windows, it must not exceed 12 characters. This user name and password
will be used again when you create the data source.
For both Oracle 9i and Oracle 10g, the user account must be assigned both the CONNECT and RESOURCE
roles. For Oracle 9i, the user account must be granted the ACCESS_ANY_WORKSPACE, CREATE VIEW, and
UNLIMITED TABLESPACE system privileges. For Oracle 10g, the user account must be granted the
ACCESS_ANY_WORKSPACE, CREATE SESSION, CREATE SYNONYM, CREATE VIEW, and UNLIMITED
TABLESPACE system privileges.
For information about using Oracle9i or 10g, see the Oracle 9i or 10g user documentation.
Configuring DB2 databases
Create a DB2 database by running the script provided in this section. The script is tuned for a system that
will use 1 GB of memory for the database. If your system has a different amount of memory dedicated for
the database, see the DB2 documentation for details on configuring your system settings.
You must also create a user with SYSADM and DBADM privileges that can be used when configuring the
data source on the application server. For information about creating a user, see the DB2 documentation.
For deployments on Linux and UNIX, the user name must not exceed 8 characters and, on Windows, it
must not exceed 12 characters.
The user name and password of the new user you create on the database are used again when you create
the data source.
After you create the database, you must configure it to enable concurrent usage.
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring DB2 databases
38
➤ To create a DB2 database:
1. On the computer that hosts DB2, create a new text file that includes the following DB2 script:
create database dbname using codeset utf-8 territory default;
connect to dbname;
CREATE BUFFERPOOL "BP8K" SIZE 50000 PAGESIZE 8192 NOT EXTENDED STORAGE;
connect reset;
connect to dbname;
CREATE TEMPORARY TABLESPACE DBNAME_TEMP_8K IN DATABASE PARTITION GROUP
IBMTEMPGROUP PAGESIZE 8192 MANAGED BY SYSTEM USING
('DB2_root\DBNAME_TEMP')
EXTENTSIZE 32 PREFETCHSIZE 16 BUFFERPOOL BP8K;
CREATE REGULAR TABLESPACE DBNAME_DATA_8K IN DATABASE PARTITION GROUP
IBMDEFAULTGROUP PAGESIZE 8192 MANAGED BY DATABASE USING
(FILE'DB2_root\DBNAME_DATA'9000) EXTENTSIZE 16 PREFETCHSIZE 16 BUFFERPOOL
BP8K;
commit work;
connect reset;
connect to dbname;
alter bufferpool ibmdefaultbp immediate size 96000;
alter bufferpool bp8k immediate size 32000;
commit work;
connect reset;
update db cfg for dbname using dbheap 4000;
update db cfg for dbname using logbufsz 2048;
update db cfg for dbname using locklist 2000;
update db cfg for dbname using chngpgs_thresh 40;
update db cfg for dbname using logfilsiz 4000;
deactivate database dbname;
activate database dbname;
2. Make the following changes to the script:
●
Replace the instances of dbname and DBNAME with the name that you want for the LiveCycle
database.
●
Replace DB2_root with the path to the root directory where DB2 is installed.
●
Ensure that no commands include line breaks and each command is terminated by a semicolon (“;”).
●
Change 9000 in the following line based on your database size:
(FILE'DB2_root\DBNAME_DATA'9000)
This number specifies the minimum number of pages required to initialize the database. You can
also change this number using the DB2 administration tools after initializing the database.
3. Save the text file in a location that DB2 Command Line Processor can access.
4. Open a command prompt.
5. (Windows) Enter the following command to open DB2 Command Line Processor:
db2cmd
6. Enter the following command to run the script:
db2 -tf <path_to_script_file>/<script_file_name>
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring a DB2 database for concurrent usage
39
Configuring a DB2 database for concurrent usage
If you are using a DB2 database, you must configure it for multiple-user scenarios.
➤ To configure the DB2 database for concurrent usage:
1. Start DB2 Control Center:
●
(Windows) Select Start > Programs > IBM DB2 > General Administration Tools > Control
Center.
●
(Linux and UNIX) From a command prompt, enter the command db2jcc
2. In the DB2 Control Center object tree, click All Databases.
3. Right-click the database you created for LiveCycle products and click Configuration Advisor.
4. Follow the steps in the Configuration Advisor wizard and ensure that the properties in the following
table are set.
DB2 property
Required value
Workload type
Mixed
Average number of SQL transactions Fewer than 10
per unit of work
Database Administration Priority
Faster transaction performance
Populated Database
Set according to the current state of the database. The
database is not populated if the database has not yet been
initialized using Configuration Manager.
Isolation Level
Cursor Stability
Configuring SQL Server databases
You can create a SQL Server database that LiveCycle products use to store run-time and configuration
data. For information on creating a SQL Server database, refer to the SQL Server documentation. LiveCycle
products support SQL Server 2000 SP3a and SP4.
Create a SQL Server database and create a user with DB_OWNER privileges that can be used when
configuring the data source on the application server. For information about creating the database and
user, see the SQL Server documentation.
The SQL Server database can be configured with the Windows or SQL Server authentication types.
You must also install JTA stored procedures on SQL Server. The embedded Connect JDBC driver is shipped
with WebSphere Application Server in two parts. The JAR files are included in the main product installation
and are updated automatically when the application server is updated. However, the stored procedures
for JTA are found on a CD that is separate from the main installation. Because the stored procedures for JTA
must reside on your machines running SQL Server, which might be separate from your machines that run
WebSphere Application Server, you must install the stored procedures manually. (See “Installing JTA
stored procedures” on page 40.) If SQL Server runs on Windows 2003, you need to enable XA transactions
at the operating system level. (See “Enabling XA transactions for Windows Server 2003” on page 41.)
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring SQL Server databases
40
Installing JTA stored procedures
LiveCycle products deployed on WebSphere use a database driver to connect to the SQL Server database.
This driver requires stored procedures for JTA on the SQL Server computer. You need to obtain and install
updated SQL Server install files for JTA stored procedures.
➤ To install JTA stored procedures:
1. Download the ConnectJDBC33-JTA.zip file from the
ftp://ftp.software.ibm.com/software/websphere/info/tools/DataDirect/datadirect.htm website. This
file applies to SQL Server 2000 when connecting from WebSphere version 5.1 and later.
2. Extract the ConnectJDBC33-JTA.zip file to a directory on the SQL Server computer.
3. Obtain and install the SQL Server 2000 Driver for JDBC SP3 from:
http://www.microsoft.com/downloads/details.aspx?familyid=07287B11-0502-461A-B138-2AA54BFDC
03A&displaylang=en
4. Copy the sqljdbc.dll file from the [extracted location]\SQLServer JTA\32-bit directory to the [install
directory]\Microsoft SQL Server\MSSQL\Binn directory, where [install directory] is the location where
SQL Server is installed.
Note: If the SQL Server computer uses a 64-bit architecture, copy the sqljdbc.dll file from the [extracted
location]\SQLServer JTA\64-bit directory.
5. Log in to SQL Server 2000 Query Analyzer using a user account that is a member of the sysadmin
group. The default member is sa.
6. In the menu of available databases, ensure that master is selected.
7. Open the instjdbc.sql file from the [extracted location]\SQLServer JTA\32-bit directory, and then
execute it.
Note: If the SQL Server computer uses a 64-bit architecture, execute the instjdbc.sql file from the
[extracted location]\SQLServer JTA\64-bit directory
If you are running this query for the first time, you will see several messages that indicate “xp_xxx”
cannot be dropped. These messages are warnings and do not indicate that the installation failed. The
last message should read “instxa.sql completed successfully.”
The instjdbc.sql script generates many messages. In general, these messages can be ignored; however,
the system administrator should scan the output for any messages that may indicate an execution
error. The last message should indicate that instjdbc.sql ran successfully. The script fails when there is
insufficient space available in the master database to store the JDBC XA procedures or to log changes
to existing procedures.
8. Ensure that MS DTC is started for SQL Server 2000:
●
Start SQL Server Service Manager.
●
In the Services list, select Distributed Transaction Coordinator.
●
Click Start/Continue.
●
If you want MS DTC to start automatically when the computer starts, select Auto-start service
when OS starts.
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring datasources
41
Enabling XA transactions for Windows Server 2003
If you are running SQL Server 2000 on the Windows Server 2003 Enterprise Edition operating system, XA
transactions must be enabled at the operating system level. Before you perform the tasks in this section,
you must verify whether XA transactions are already enabled for Windows Server 2003.
To enable XA transactions on the operating system, you need to perform the following tasks:
●
Enable XA transactions for the MS DTC.
●
Create a registry entry for the sqljdbc.dll database drivers file that you are using.
➤ To enable XA transactions for MS DTC:
1. Select Start > Programs > Administrative Tools > Component Services.
2. Select Component Services > Computers.
3. Right-click the computer name that you want to support for XA transactions and click Properties.
4. Click the MSDTC tab and click Security Configuration.
5. Under Security Settings, select Enable XA Transactions.
➤ To create registry entries for the driver file:
1. Use a registry editor (such as regedit) to navigate to the registry key named
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\XADLL.
2. Create a new String Value registry named value that has the following properties:
Name: sqljdbc.dll
Type: String (REG_SZ)
Value: The full path name (including the file name) of the DLL file:
[install directory]\Microsoft SQL Server\MSSQL\Binn\sqljdbc.dll
3. Restart the computer so that the changes to the registry take effect.
Configuring datasources
WebSphere can be configured to run with an Oracle, DB2, or SQL Server database. The configuration
differs slightly for each database.
If you are installing LiveCycle Policy Server and any other LiveCycle application that requires a datasource,
you are required to create two datasources as detailed in the following procedures.
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the Oracle data source
42
Configuring the Oracle data source
Before performing the following procedure, you must have already created an Oracle database and a user
on the database.
To enable WebSphere and your LiveCycle deployment to connect to the Oracle database, you must
complete the following tasks:
●
Configure JDBC information.
●
Configure J2C authentication information.
●
Create a data source on WebSphere.
➤ To create a data source on WebSphere:
1. In the WebSphere Administrative Console navigation tree, select Environment > Manage WebSphere
Variables.
2. To set the variable scope, select Cell and click Apply.
3. Click New. In Name box, type ORACLE_JDBC_DRIVER_PATH and, in the Value box, type:
${WAS_INSTALL_ROOT}/db_driver
This directory was created when you prepared the WebSphere environment. (See “Installing database
drivers” on page 36.)
4. Click Apply, and then save your changes to the Master Configuration.
5. In the navigation tree, select Resources > JDBC Providers.
6. For Scope, select Cell and click Apply.
7. Click New, select Oracle JDBC Driver in the list, click Apply, and then click Apply again.
8. Under Additional Properties, select Data Sources.
9. Click New and, in the Name box, type a name for the data source (for example, LiveCycleDS).
10. (All Products except LiveCycle Policy Server) In the JNDI Name field, type IDP_DS and click Apply.
11. (LiveCycle Policy Server) In the JNDI Name field, type EDC_DS and click Apply.
12. Under Related Items, select J2C Authentication Data Entries.
13. Click New and, in the Alias box, type a name (for example, MyAlias).
14. Type the user ID and password that corresponds with the user you created on the database, click
Apply, click OK, and then save your changes to the Master Configuration.
15. Navigate back to Resources > JDBC Providers > Oracle JDBC Driver > Data Sources > LiveCycleDS.
16. Under General Properties, set both Component-managed Authentication Alias and
Container-managed Authentication Alias to [computer_name]/MyAlias.
17. Under Additional Properties, click Custom Properties and select URL.
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the DB2 data source
43
18. In the Value box, type the following value:
jdbc:oracle:thin:@[server name]:[port]:[service name]
where [server name] is your Oracle 9i or Oracle 10g server name, [port] is the port for the Oracle
installation and [service name] is your database.
19. (LiveCycle PDF Generator) Navigate back to JDBC Providers > Oracle JDBP Driver > Data Sources >
LiveCycleDS.
20. (LiveCycle PDF Generator) Under Additional Properties, select Connection Pool and in the Max
Connections box, type 30.
21. (LiveCycle PDF Generator)Click Apply, click OK, and then click Save.
22. Click Apply, and then save your changes to the Master Configuration.
23. To test the data source connection, navigate to Resources > JDBC Providers > Oracle JDBC Driver >
Data Sources.
24. Select the check box next to the data source you created and click Test Connection. A message is
displayed describing the test results.
Configuring the DB2 data source
Before performing the following procedure, you must have already created a DB2 database and a user on
the database.
To enable WebSphere and your LiveCycle deployment to connect to the DB2 database, you must complete
the following tasks:
●
Configure JDBC information.
●
Configure J2C authentication information.
●
Create a data source on WebSphere.
➤ To set up a data source on WebSphere:
1. In the WebSphere Administrative Console navigation tree, select Environment > Manage WebSphere
Variables.
2. To set the variable scope, select Cell and click Apply. The scope needs to be the same as the scope of
the JDBC provider that you configure later in this task.
3. Click New. In Name box, type DB2_JDBC_DRIVER_PATH and, in the Value box, type:
${WAS_INSTALL_ROOT}/db_driver
This directory was created when you prepared the WebSphere environment. (See “Installing database
drivers” on page 36.)
4. Click OK, and then save your changes to the Master Configuration.
5. In the navigation tree, select Resources > JDBC Providers.
6. For Scope, select Cell and in the right panel, click New, select DB2 Universal JDBC Driver Provider in
the list, click Apply, and then click Apply again.
7. Under Additional Properties, select Data Sources.
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the DB2 data source
44
8. Click New and type a name for the data source (for example, LiveCycleDS).
9. (All Products except LiveCycle Policy Server) In the JNDI Name field, type IDP_DS and click Apply.
10. (LiveCycle Policy Server) In the JNDI Name field, type EDC_DS and click Apply.
11. Under Related Items, select J2C Authentication Data Entries.
12. Click New and, in the Alias box, type a name (for example, MyAlias).
13. Type the user ID and password that correspond with the user credentials that can access the database
and click Apply.
14. Save your changes to the Master Configuration.
15. Navigate back to Resources > JDBC Providers > DB2 Universal JDBC Driver Provider > Data
Sources and select the name for the data source (for example, LiveCycleDS).
16. Under General Properties, set both Component-managed Authentication Alias and
Container-Managed Authentication Alias to [computer_name]/MyAlias.
17. From Mapping-Configuration Alias, select DefaultPrincipalMapping and click Apply.
18. Under Additional Properties, click Custom Properties and specify values for the following properties:
databaseName: The database name of the DB2 database in which the LiveCycle database resides.
serverName: The name or IP address of the DB2 server to which you are connecting.
portNumber: The port of the DB2 server to which you are connecting. The default value is 50000.
resultSetHoldability: Specifies whether cursors remain open after a commit operation. Set to 1.
driverType: Determines which driver to use for connections. Set to 4.
19. (LiveCycle PDF Generator) Navigate back to JDBC Providers > DB2 Universal JDBC Driver Provider >
Data Sources > LiveCycleDS.
20. (LiveCycle PDF Generator) Under Additional Properties, select Connection Pool and, in the Max
Connections box, type 30.
21. (LiveCycle PDF Generator) Click Apply, click OK, and then click Save.
22. Save your changes to the Master Configuration.
23. Restart the application server so that it picks up the db2jdbc jar files.
24. To test the data source connection, navigate to Resources > JDBC Providers > DB2 Universal JDBC
Driver Provider > Data Sources.
25. Select the check box next to the data source you created and click Test Connection.
A message is displayed describing the test results. If the test connection fails and you are using
WebSphere variables for the path to the db2jdbc jar files, try providing the full file system path to the files.
26. If you already had a data source configured and created a new one, stop and restart the application
server.
Note: If the test results indicate failure, please restart the nodes and the servers, and then test the
connection again.
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the SQL Server data source
45
Configuring the SQL Server data source
Before performing the following procedure, you must have already created a SQL Server database and a
user on the database.
To enable WebSphere and your LiveCycle deployment to connect to the SQL Server database, you must
complete the following tasks:
●
Configure JDBC information.
●
Configure J2C authentication information.
●
Create a data source on WebSphere.
➤ (All Products except LiveCycle Policy Server) To configure JDBC information:
1. In the WebSphere Administrative Console navigation tree, select Resources > JDBC Providers.
2. For Scope, select Cell and click Apply.
3. Click New. From the JDBC Providers menu, select WebSphere embedded ConnectJDBC driver for
MS SQL Server and click Apply.
4. In the Name box, type:
SQL Server JDBC Provider
5. In the Implementation Classname box, type:
com.ibm.websphere.jdbcx.sqlserver.SQLServerDataSource
➤ (LiveCycle Policy Server only) To configure JDBC information:
1. In the WebSphere Administrative Console navigation tree, select Resources > JDBC Providers.
2. For Scope, select Cell and click Apply.
3. Click New. From the JDBC Providers menu, select User-defined JDBC Provider and click Apply.
4. In the Name box, type:
SQL Server JDBC Provider
5. In the Classpath box, type the following paths:
[appserver root]\db_driver\msbase.jar
[appserver root]\db_driver\mssqlserver.jar
[appserver root]\db_driver\msutil.jar
6. In the Implementation Classname box, type:
com.microsoft.jdbcx.sqlserver.SQLServerDataSource
➤ (All products) To configure J2C authentication information:
1. In the WebSphere Administrative Console navigation tree, select Security > JAAS Configuration >
J2C Authentication Data.
2. Click New and, in the Alias box, enter a name for the alias (for example, SQLServer).
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the SQL Server data source
46
3. In the User ID box, enter the user name of the user account you created on the database and, in the
Password box, enter the corresponding password.
4. Click Apply, click OK, and then save to the Master Configuration.
➤ (All products except LiveCycle Policy Server) To configure a SQL Server data source:
1. In the WebSphere Administrative Console navigation tree, select Resources > JDBC Providers.
2. Click SQL Server JDBC Provider and, under Additional Properties, select Data Sources.
3. Click New.
4. In the Name box, enter a name for the data source (for example, LiveCycleDS).
5. In the JNDI Name field, type IDP_DS and click Apply.
6. In the Datasource Helper Classname box, type:
com.ibm.websphere.rsadapter.WSConnectJDBCDataStoreHelper
Note: This box may be auto populated when the new data source page is opened.
7. In the Component-managed Authentication Alias and Container-managed Authentication Alias
menus, select the SQL Server alias that you created in step 2 of “(All products) To configure J2C
authentication information:” on page 45.
8. In the Mapping-Configuration Alias menu, select DefaultPrincipalMapping and click Apply.
9. Under Additional Properties, click Connection Pool, change the value of Max Connections to 30.
10. In the Connection Timeout box, type 1800, and then click OK.
11. Navigate to JDBC Providers > WebSphere embedded ConnectJDBC driver for MS SQL Server >
Data Sources > Additional Properties.
12. Click Custom Properties, click serverName and, in the Value box, type the name of the server where
your SQL Server database resides, and then click OK.
13. In Custom Properties, click databaseName and, in the Value box, enter the name of your SQL Server
database, and then click OK.
14. In Custom Properties, click Select Method and, in the Value box, type cursor, and then click OK.
15. In Custom Properties, click enable2Phase.
16. In the value box, type true and click OK.
17. In Custom Properties, ensure that preTestSQLString is set to an appropriate value. For example, type:
SQL SELECT 1 FROM DUAL
18. In Custom Properties, click SendStringParameterAsUnicode.
19. In the Value box, type true and click OK.
20. Save your changes to the Master Configuration.
21. Test your connection by navigating to Resources > JDBC Providers > SQL Server JDBC Provider >
Data Sources and clicking Test Connection.
Adobe LiveCycle
Configuring the Database
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring the SQL Server data source
47
➤ (LiveCycle Policy Server only) To configure an SQL Server data source:
1. In the WebSphere Administrative Console navigation tree, select Security > JAAS Configuration >
J2C Authentication Data.
2. Click SQL Server JDBC Provider and, under Additional Properties, select Data Sources.
3. Click New, and in the Alias box, enter a name for the data source (for example, EDC_SQL_Server).
4. In the JNDI Name field, type EDC_DS.
5. In the Statement Cache Size box, type 100.
6. In the Datasource Helper Classname box, type:
com.ibm.websphere.rsadapter.WSConnectJDBCDataStoreHelper
7. In the Component-managed Authentication Alias and Container-managed Authentication Alias
menus, select the SQL Server alias that you created in step 3.
8. In the Mapping-Configuration Alias menu, select DefaultPrincipalMapping and click Apply.
9. Under Additional Properties, click Connection Pool, change the value of Max Connections to 30,
and then click OK.
10. Under Additional Properties, click Custom Properties, click serverName and, in the Value box, type
the name of the server where your SQL Server database resides, and then click OK.
11. In Custom Properties, click databaseName and, in the Value box, enter the name of your SQL Server
database, and then click OK.
12. In Custom Properties, click portNumber and type the SQL Server database port number, and then
click OK.
13. In Custom Properties, click Select Method and, in the Value box, type cursor, and then click OK.
14. In Custom Properties, click enable2Phase.
15. In the value box, type true and click OK.
16. In Custom Properties, ensure that preTestSQLString is set to an appropriate value. For example, type:
SQL SELECT 1 FROM DUAL
17. In the Value box, type true and click OK.
18. Save your changes to the Master Configuration.
19. Test your connection by navigating to Resources > JDBC Providers > SQL Server JDBC Provider >
Data Sources and clicking Test Connection.
7
Configuring Security for LiveCycle Policy Server
Administrators and users must be authenticated to access LiveCycle Policy Server features.
LiveCycle Policy Server supports form-based authentication and basic authentication.
LiveCycle Policy Server uses form-based JAAS authentication by default.
To implement basic authentication, you use the LiveCycle Policy Server SDK to integrate a custom
authentication service provider. For more information, see the LiveCycle Policy Server Developing Custom
Applications guide or contact Adobe Customer Support.
Note: LDAP exchanges information in clear text. You should configure WebSphere to send authentication
information over an SSL connection.
You must configure the JAAS application login module properties by performing the following tasks.
➤ To create the application login:
1. In the WebSphere Administration Console navigation tree, click Security > JAAS Configuration >
Application Logins > New.
2. In the Alias box, type UsernamePwd_Auth and click OK.
3. Save your changes.
➤ To configure the application login module:
1. In the WebSphere Administration Console navigation tree, select Security > JAAS Configuration >
Application Logins > UsernamePwd_Auth > JAAS Login Modules > New.
2. In the Module Classname box, type the following value and then click OK:
com.adobe.edc.server.provider.authentication.login.LDAPLoginModule
3. Save your changes.
➤ To set custom properties for the application login:
1. In the WebSphere Administration Console navigation tree, select Security > JAAS Configuration >
Application Logins >UsernamePwd_Auth > JAAS Login Modules >
com.adobe.edc.server.provider.authentication.login.LDAPLoginModule > Custom Properties >
New.
2. Create a new entry for each Name-Value pair listed in the following tables. A description is not needed.
You should save the configuration after you specify the property value.
Required values for Sun ONE
Name
Value
Debug
False
java.naming.factory.initial
com.sun.jndi.ldap.LdapCtxFactory
48
Adobe LiveCycle
Configuring Security for LiveCycle Policy Server
Configuring LiveCycle Application Server Clusters Using WebSphere
Name
Value
java.naming.security.authentication
simple
user.provider.url
ldap://myLDAP.mycompany.com:port
userDNPrefix
Configure according to your LDAP server (for example, uid=).
userDNSuffix
Configure according to your LDAP server (for example,
ou=people,o=mycompany.com).
Required values for Active Directory
Name
Value
Debug
False
java.naming.factory.initial
com.sun.jndi.ldap.LdapCtxFactory
java.naming.security.authentication
simple
user.provider.url
ldap://myLDAP.mycompany.com:port
searchUser
true
searchUsingAnonymousBind
false
binduser
[user name]
bindpassword
[password]
basedn
[basedn]
searchfilterPrefix
[your search filter prefix]
searchfilterSuffix
[your search filter suffix]
49
8
Configuring Messaging and Security
You must install and configure either WebSphere embedded messaging or WebSphere MQ, and then
configure JMS resources.
Configuring JMS resources for LiveCycle Policy Server
If you installed and configured WebSphere MQ, follow the procedures in “Configuring JMS resources for
WebSphere MQ” on page 52.
If you did not install and configure WebSphere MQ, follow the procedures in ““Configuring JMS resources
with embedded messaging” on page 50.
Configuring JMS resources with embedded messaging
This section describes how to manually configure JMS resources for WebSphere. If you are not using SQL
Server 2000, you can also use Configuration Manager to automatically perform this task.
To configure JMS resources for WebSphere using embedded messaging, you must complete the following
tasks:
●
Add required queues to the WebSphere embedded JMS server.
●
Set up WebSphere queue connection factories.
●
Set up WebSphere queue destinations.
●
Set up WebSphere listener ports.
➤ To add required queues to the WebSphere embedded JMS server:
1. In the WebSphere Administrative Console navigation tree, select Servers > Application Servers.
2. Select your server and, under Additional Properties, select Server Components.
3. Select JMS Servers, add EDC_Event_Queue to the Queue names list, and then click OK.
➤ To set up WebSphere queue connection factories:
1. In the WebSphere Administrative Console navigation tree, select Resources > WebSphere JMS
Provider.
2. For Scope, select Cell, and then click Apply.
If there are multiple application servers installed, ensure that Node and Server are not selected.
3. Under Additional Properties, click WebSphere Queue Connection Factories, and then click New.
50
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources with embedded messaging
51
4. Set the following properties and click OK:
Name: EDCEventQCF
JNDI Name: jms/EDCEventQCF
XA Enabled: Deselect this option.
5. In the table, select the connection factory you just created.
6. Under Additional Properties, click Connection Pool, set the following properties, and then click OK:
Connection Timeout: 180
Max Connections: 30
Min Connections: 10
Purge Policy: FallingConnectionOnly
7. Save your changes to the Master Configuration.
➤ To set up WebSphere queue destinations:
1. In the WebSphere Administrative Console navigation tree, select Resources > WebSphere JMS
Provider.
2. Under Additional Properties, select WebSphere Queue Destinations, click New, set the following
properties, and then click OK:
Name: EDC_Event_Queue
JNDI Name: queue/EDC_Event_Queue
Persistence: Persistent
➤ To set up WebSphere listener ports:
1. In the WebSphere Administrative Console navigation tree, select Servers > Application Servers and,
in the table, select your server.
2. Under Additional Properties, select Message Listener Service, under Additional Properties, select
Listener Ports, and then click New.
3. Set the following properties and click OK:
Name: EDCEventListenerPort
Connection factory JNDI Name: jms/EDCEventQCF
Destination JNDI Name: queue/EDC_Event_Queue
Maximum sessions: 10
Maximum retries: 100
4. Save your changes to the Master Configuration.
5. Shut down and restart WebSphere Application Server.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
52
Configuring JMS resources for WebSphere MQ
This section only applies if you installed and configured WebSphere MQ as described in “Preparing
WebSphere MQ” on page 21.
This section describes how to configure a single WebSphere MQ 5.3.0.1 server. You can also use
Configuration Manager to automatically perform this task.
In this guide, [MQ_root] indicates the location where WebSphere MQ is installed. The default install
location varies depending on the operating system you are using:
●
(Windows) C:\Program Files\ibm\WebSphere MQ
●
(Solaris and Linux) /opt/mqm
●
(AIX) /usr/mqm
The procedures in this section describe how to configure a J2C Authentication Data Entry (for the local
user you created in step 3 on page 23), and a queue connection factory for WebSphere MQ.
To configure JMS resources for WebSphere using WebSphere MQ, you must complete the following tasks:
●
Create the J2C Authentication Data Entry.
●
Create a queue connection factory.
●
Configure the session pool.
●
Configure the connection pool.
●
Create a queue destination.
●
Configure the listener ports.
●
Check your WebSphere MQ configuration.
➤ To create a J2C Authentication Data Entry:
1. In the navigation tree of the WebSphere Administration Console, click Security > JAAS Configuration
> J2C Authentication Data.
2. In the right pane, click New.
3. Set the Alias property to a meaningful name, such as mquser.
4. Set the User ID and Password properties to the user name and password you created in step 3 on page
23.
5. Click OK and save your changes to the master configuration.
➤ To create a queue connection factory:
1. In the WebSphere Administrative Console navigation tree, click Resources > WebSphere MQ JMS
Provider.
2. In the right pane, set Scope to Cell and click Apply.
3. Click WebSphere MQ Queue Connection Factories.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
53
4. Click New, specify the following values for the properties of the new queue connection, and then click
OK.
Name: EDCEventQCF
JNDI Name: jms/EDCEventQCF
Category: LiveCycle
Container-managed Authentication Alias: MQ_user_alias
Mapping-Configuration Alias: DefaultPrincipalMapping
Queue Manager: queue_manager_name
Host: MQ_host
Port: MQ_port
Channel: SYSTEM.DEF.SVRCONN
Transport Type: CLIENT
XA enabled: Select the check box.
XA enabled: Select the check box.
➤ To configure the session pool:
1. Click the name of the queue connection factory that you just created.
2. In the Additional Properties section, click Session Pools.
3. Specify the following values for the properties of the session pool, and then click OK.
Connection Timeout: 180
Max Connections: 10
Min Connections: 10
➤ To configure the connection pool:
1. Click the name of the queue connection factory that you just created.
2. In the Additional Properties section, click Connection Pool.
3. Specify the following values for the properties of the connection pool, and then click OK.
Connection Timeout: 180
Max Connections: 10
Min Connections: 10
➤ To create a queue destination:
1. In the WebSphere Administrative Console navigation tree, click Resources > WebSphere MQ JMS
Provider.
2. In the right pane, set Scope to Cell and click Apply.
3. Click WebSphere MQ Queue Destinations.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
54
4. Click New, specify the following values for the properties, and then click OK.
Name: EDC_Event_Queue
JNDI Name: queue/EDC_Event_Queue
Base Queue Manager: queue_manager_name
Queue Manager Host: MQ_Host
Queue Manager Port: MQ_port
Server Connection Channel Name: SYSTEM.DEF.SVRCONN
User ID: MQ_userid
Password: password for MQ_userid
5. Save your changes to the Master Configuration.
➤ To set up the listener ports:
1. In the WebSphere Administrative Console navigation tree, click Servers > Application Servers.
2. In the right pane, click the name of the server.
3. Click Message Listener Service, click Listener Ports, and then click New.
4. Set the following properties, and then click OK:
Name: EDCEventListenerPort
Connection Factory JNDI Name: jms/EDCEventQCF
Destination JNDI Name: queue/EDC_Event_Queue
Maximum Sessions: 10
Maximum Retries: 100
5. Repeat steps 1 to 4 for each server in the cluster.
6. Save your changes to the Master Configuration.
➤ To check your WebSphere MQ configuration:
1. Stop and restart WebSphere Application Server.
2. In WebSphere Administrative Console, click Resources > WebSphere MQ JMS Provider.
3. Click WebSphere MQ Queue Destinations.
4. Click one of the queues that you created using this guide.
5. Under Additional Properties, click MQ Config and check that no errors are appearing in the Messages
area at the top of the page.
6. Repeat steps 4 and 5 for the other queues that you created using this guide.
7. In the WebSphere Administrative Console navigation tree, click Servers > Application Servers.
8. In the right pane, click the name of the server.
9. Click Message Listener Service.
10. Click Listener Ports and check that the listener port is started.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring messaging for other LiveCycle products
55
Configuring messaging for other LiveCycle products
If you are using WebSphere 5.1.1.5 with LiveCycle Workflow or LiveCycle Form Manager, or installing
LiveCycle PDF Generator to work with LiveCycle Workflow, you must install and configure WebSphere MQ.
(See “Configuring JMS resources for WebSphere MQ” on page 60.)
If you are using WebSphere 5.1.1.5 with LiveCycle products other than LiveCycle Workflow or
LiveCycle Form Manager, you must configure WebSphere embedded messaging. (See “Configuring JMS
resources with embedded messaging” on page 55.)
Configuring JMS resources with embedded messaging
To configure JMS resources for WebSphere using embedded messaging, you must complete the following
tasks:
●
Add required queues to the WebSphere embedded JMS server.
●
Set up WebSphere queue connection factories.
●
Set up WebSphere topic connection factories
●
Set up Websphere queue destinations
●
Set up WebSphere topic destinations
●
Set up WebSphere listener ports
This section describes how to manually configure JMS resources for WebSphere.
➤ To add required queues to the WebSphere embedded JMS server:
1. In the WebSphere Administrative Console navigation tree, select Servers > JMS Servers.
2. Select the JMS server that you are configuring (for example, server1).
3. Under Queue names, add the following queues to the Queue names list.
Queue name
Applicable LiveCycle products
adobe_ObjectDeleteQueue
LiveCycle Form Manager or LiveCycle Workflow
adobe_PECommandQueue
LiveCycle Form Manager or LiveCycle Workflow
adobe_PEDCommandQueue
LiveCycle Form Manager or LiveCycle Workflow
adobe_PEDLongLivedQueue
LiveCycle Form Manager or LiveCycle Workflow
adobe_PEInteractionQueue
LiveCycle Form Manager or LiveCycle Workflow
adobe_PELongLivedQueue
LiveCycle Form Manager or LiveCycle Workflow
adobe_PEScheduledMsgQueue
LiveCycle Form Manager or LiveCycle Workflow
AESJobQueue
LiveCycle PDF Generator
PDFGCompletedJobsQueue
LiveCycle PDF Generator
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources with embedded messaging
56
➤ To set up WebSphere queue connection factories:
1. In the WebSphere Administrative Console navigation tree, select Resources > WebSphere JMS
Provider.
2. In the Configuration tab, under Scope, select Cell and click Apply.
3. Under Additional Properties, click WebSphere Queue Connection Factories and click New.
4. (LiveCycle Workflow, LiveCycle Form Manager) Specify the following values for the properties and click
OK:
Name: QueueConnectionFactory
JNDI Name: QueueConnectionFactory
Mapping-Configuration Alias: DefaultPrincipalMapping
XA enabled: Deselect the check box.
5. (LiveCycle Workflow, LiveCycle Form Manager) In the table, select the connection factory you created.
6. (LiveCycle Workflow, LiveCycle Form Manager) Under Additional Properties, click Connection Pool
and, in the Max Connections box, type 30, and then click OK.
7. (LiveCycle PDF Generator) In the Name box, type AESQueueConnectionFactory and, in the JNDI
Name box, type jms/QueueConnectionFactory, and then click OK.
8. Save your changes to the Master Configuration.
➤ To set up WebSphere topic connection factories:
1. In the WebSphere Administrative Console navigation tree, select Resources > WebSphere JMS
Provider, and create the following topic connection factories by completing steps 2 to 8 for each
connection factory.
(LiveCycle Workflow, LiveCycle Form Manager)
Topic connection factory
JNDI Name
Scope
Port
TopicConnectionFactory
TopicConnectionFactory
Node
POFConnectionFactory
POFConnectionFactory
Node
RegistryTopicConnectionFactory
RegistryTopicConnectionFactory
Cell
Topic connection factory
JNDI Name
Scope
Port
AESTopicConnectionFactory
jms/TopicConnectionFactory
Node
QUEUED
QUEUED
(LiveCycle PDF Generator)
2. Set the Scope as indicated in the table in step 1.
3. Under Additional Properties, click WebSphere Topic Connection Factories and click New.
4. In the Name and JNDI name boxes, type the values as indicated in the table above.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources with embedded messaging
57
5. For all of the topic connection factories, in the Mapping-Configuration Alias list, select
DefaultPrincipalMapping.
6. Set the Port as indicated in the table above and click OK.
7. Under Additional Properties, click Connection Pool and, in the Max Connections box, type 30 and
click OK.
8. Under Additional Properties, click Session Pools and, in the Max Connections box, type 30 and click
OK.
9. Save your changes to the Master Configuration.
➤ To set up Websphere queue destinations:
1. In the WebSphere Administrative Console navigation tree, select Resources > WebSphere JMS
Provider, and create the following queue destinations by completing steps 2 to 4 for each queue
destination.
(LiveCycle Workflow, LiveCycle Form Manager)
Queue destination
JNDI name
Scope
adobe_ObjectDeleteQueue
adobe_ObjectDeleteQueue
Cell
adobe_PECommandQueue
adobe_PECommandQueue
Cell
adobe_PEDCommandQueue
adobe_PEDCommandQueue
Cell
adobe_PEDLongLivedQueue
adobe_PEDLongLivedQueue
Cell
adobe_PEInteractionQueue
adobe_PEInteractionQueue
Cell
adobe_PELongLivedQueue
adobe_PELongLivedQueue
Cell
adobe_PEScheduledMsgQueue
adobe_PEScheduledMsgQueue
Cell
Queue destination
JNDI name
Scope
AESJobQueue
queue/AESJobQueue
Node
PDFGCompletedJobsQueue
queue/PDFGCompletedJobsQueue
Node
(LiveCycle PDF Generator)
2. Set the Scope as indicated in the table in step 1.
3. Under Additional Properties, select WebSphere Queue Destinations and click New.
4. In the Name and JNDI Name boxes, type the values as indicated in the table in step 1, and then click
OK.
Note: If the scope is Node, repeat for each node in the cluster.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources with embedded messaging
➤ To set up WebSphere topic destinations:
1. In the WebSphere Administrative Console navigation tree, select Resources > WebSphere JMS
Provider, and create the following topic destinations by completing steps 2 to 7 for each topic
destination.
(LiveCycle Form Manager, LiveCycle Workflow)
Name and topic destination
JNDI name
Scope
adobe_POFObjectTopic
topic/adobe_POFObjectTopic
Node
adobe_POFSchemaTopic
topic/adobe_POFSchemaTopic
Node
adobe_ProcessEventTopic
topic/adobe_ProcessEventTopic
Node
adobe_TaskEventTopic
topic/adobe_TaskEventTopic
Node
adobe_TemplateEventTopic
topic/adobe_TemplateEventTopic
Node
adobe_RegistryCacheMonitorTopic
topic/adobe_RegistryCacheMonitorTopic
Cell
Name and topic destination
JNDI name
Scope
AesConfigUpdatesTopic
topic/AesConfigUpdatesTopic
Node
Name and topic destination
JNDI name
Scope
WatchedFolderConfigManagerTopic
topic/WatchedFolderConfigManagerTopic
Node
(LiveCycle PDF Generator)
(Watched Folder)
2. Set the Scope as indicated in the table in step 1.
3. Under Additional Properties, select WebSphere Topic Destinations and click New.
4. In the Name, JNDI name, and Topic boxes, type the values as indicated in the table in step 1.
5. In the Priority list, select APPLICATION DEFINED.
6. In the Expiry list, select APPLICATION DEFINED.
7. In the Persistence list, select PERSISTENT.
For adobe_RegistryCacheMonitorTopic, in the Persistence list, select NON PERSISTENT.
For AesConfigUpdatesTopic, in the Persistence list, select APPLICATION DEFINED.
58
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources with embedded messaging
59
➤ To set up WebSphere listener ports:
1. In the WebSphere Administrative Console navigation tree, select Servers > Application Servers and,
in the table, select the server instance that you are configuring.
2. Under Additional Properties, select Message Listener Service and create the following listener ports
by completing steps 3 to 4 for each listener port.
(LiveCycle Workflow, LiveCycle Form Manager)
Listener port
Connection factory JNDI name
Destination JNDI name
AdobeMDBListener
QueueConnectionFactory
queue/adobe_PECommand
Queue
AdobeMDBPATListener
TopicConnectionFactory
topic/adobe_POFObjectTopic
AdobeTemplateEventMDB
TopicListener
TopicConnectionFactory
topic/adobe_TemplateEvent
Topic
AdobeMDBTopicListener
TopicConnectionFactory
topic/adobe_ProcessEventType
adobe_RegistryCacheMonitor
MDBPort
RegistryTopicConnection
Factory
topic/adobe_RegistryCache
MonitorTopic
adobe_TaskEventTopicListener TopicConnectionFactory
topic/adobe_TaskEventTopic
(LiveCycle PDF Generator)
Listener port
Connection factory JNDI name
Destination JNDI name
DequeuePort
jms/QueueConnectionFactory
queue/AESJobQueue
ConfigUpdatesListenerPort
jms/TopicConnectionFactory
topic/AesConfigUpdatesTopic
PDFGCompletedJobsListener
Port
jms/QueueConnectionFactory
queue/PDFGCompletedJobs
Queue
PsDequeuePort
jms/QueueConnectionFactory
queue/AESJobQueue
Listener port
Connection factory JNDI name
Destination JNDI name
WatchedFolderTopicListener
jms/TopicConnectionFactory
topic/WatchedFolderConfig
ManagerTopic
(Watched Folder)
3. Under Additional Properties, select Listener Ports and click New.
4. In the Name, Connection factory JNDI name, and Destination JNDI name boxes, type the values as
indicated in the table above, and then set the Initial State to Started.
5. For PsDequeuePort, in the Maximum Sessions box, type 3.
6. In the Maximum messages box, type the following value and click OK:
●
(LiveCycle PDF Generator) 1
●
(All other LiveCycle products) 5
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
60
7. In the Maximum retries box, type the following value and click OK:
●
(LiveCycle PDF Generator) 0
●
(All other LiveCycle products) 10
8. Save your changes to the Master Configuration.
9. Shut down and restart the cluster.
Configuring JMS resources for WebSphere MQ
This section describes how to configure JMS resources for WebSphere MQ. This section assumes that you
have already installed and prepared WebSphere MQ for deployment.
Configuring JMS resources
This section applies to LiveCycle Form Manager, LiveCycle Workflow, LiveCycle PDF Generator, and
Watched Folder only.
You must create four destinations and connection factories for WebSphere MQ, as described in the
following sections:
●
“Creating WebSphere MQ queue destinations” on page 60
●
“Creating WebSphere MQ topic destinations” on page 62
●
“Creating a queue connection factory” on page 63
●
“Creating topic connection factories” on page 64
●
“Configuring WebSphere MQ JMS provider for Watched Folder” on page 68
If you are using WebSphere 5.1.1.5 as your application server with LiveCycle Workflow, you must configure
WebSphere MQ 5.3.0.1.
This section describes how to configure WebSphere MQ 5.3.0.1. In this document, [MQ_root] indicates the
location where WebSphere MQ is installed. The default install location varies depending on the operating
system you are using:
●
(Windows) c:\Program Files\ibm\WebSphere MQ
●
(Solaris, Linux) /opt/mqm
●
(AIX) /usr/mqm
Before you perform the procedures in this section, you must have already installed WebSphere MQ and
performed preliminary configurations.
Creating WebSphere MQ queue destinations
The following procedure describes how to create the queue destinations required for WebSphere MQ.
➤ To create the WebSphere MQ queue destinations:
1. In the navigation tree of the WebSphere Administrative Console, click Resources > WebSphere MQ
JMS Provider.
2. In the right pane, under Scope, select Cell and click Apply.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
61
3. Click WebSphere MQ Queue Destinations.
4. Click New and create the following queue destinations by completing step 5 for each queue
destination.
(LiveCycle Workflow, LiveCycle Form Manager)
Queue destination name
JNDI name
Base queue name
adobe_ObjectDeleteQueue
queue/adobe_ObjectDeleteQueue
ADOBE.WORKFLOW.OBJECT
_DELETE.QUEUE
adobe_PECommandQueue
queue/adobe_PECommandQueue
ADOBE.WORKFLOW.PE
_COMMAND.QUEUE
adobe_PEDCommandQueue
queue/adobe_PEDCommandQueue
ADOBE.WORKFLOW.PED
_COMMAND.QUEUE
adobe_PEDLongLivedQueue
queue/adobe_PEDLongLivedQueue
ADOBE.WORKFLOW.PED
_LONGLIVED.QUEUE
adobe_PEInteractionQueue
queue/adobe_PEInteractionQueue
ADOBE.WORKFLOW.PE
_INTERACTION.QUEUE
adobe_PELongLivedQueue
queue/adobe_PELongLivedQueue
ADOBE.WORKFLOW.PE
_LONGLIVED.QUEUE
adobe_PEScheduledMsg
Queue
queue/adobe_PEScheduledMsg
Queue
ADOBE.WORKFLOW.PE
_SCHEDULEDMSG.QUEUE
(LiveCycle PDF Generator)
Queue destination name
JNDI name
Base queue name
AESJobQueue
queue/AESJobQueue
ADOBE.PDFG.AESJOB.
QUEUE
PDFGCompletedJobsQueue
queue/PDFGCompletedJobsQueue
ADOBE.PDFG.PDFG
COMPLETEDJOBS.QUEUE
5. Specify the following values for the properties, and then click OK:
Scope: Cell
Category: LiveCycle
Base Queue Manager Name: queue_manager_name (queue manager created in step 7 on page
24)
Queue Manager Host: MQ_host
Queue Manager Port: MQ_port (port specified in step 5 on page 25 for UNIX or in step 6 on page
26 for Windows)
Server Connection Channel Name: SYSTEM.DEF.SVRCONN
User ID: MQ_userid (as created in step 3 on page 23)
Password: password for MQ_userid
6. Save your changes to the master configuration.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
62
Creating WebSphere MQ topic destinations
The following procedure describes how to create the topic destinations required for WebSphere MQ.
➤ To create the WebSphere MQ topic destinations:
1. In the navigation tree of the WebSphere Administrative Console, select Resources > WebSphere MQ
JMS Provider.
2. In the right pane, set the Scope as indicated in the table below.
3. Select WebSphere MQ Topic Destinations.
4. Click New and create the following topic destination by completing step 5 for each topic destination.
(LiveCycle Workflow, LiveCycle Form Manager)
Scope
Name
JNDI name
Base topic name
Cell
adobe_Registry
CacheMonitorTopic
topic/adobe_Registry
CacheMonitorTopic
MQJMS/ADOBE/EBXML/REGISTRY_CAC
HE_MONITOR_TOPIC
Server
adobe_POFObject
Topic
topic/adobe_POFObject
Topic
MQJMS/ADOBE/WORKFLOW/POF_
OBJECT_TOPIC
Server
adobe_POFSchema topic/adobe_POFSchema
Topic
Topic
MQJMS/ADOBE/WORKFLOW/POF_
SCHEMA_TOPIC
Server
adobe_Process
EventTopic
topic/adobe_Process
EventTopic
MQJMS/ADOBE/WORKFLOW/PROCESS_
EVENT_TOPIC
Server
adobe_TaskEvent
Topic
topic/adobe_TaskEvent
Topic
MQJMS/ADOBE/WORKFLOW/TASK_
EVENT_TOPIC
Server
adobe_Template
EventTopic
topic/adobe_Template
EventTopic
MQJMS/ADOBE/WORKFLOW/TEMPLATE
_EVENT_TOPIC
(LiveCycle PDF Generator)
Scope
Name
JNDI name
Base topic name
Cell
AesConfigUpdates
Topic
topic/AesConfigUpdates
Topic
MQJMS/ADOBE/PDFG/AESCONFIGUPD
ATES_TOPIC
(Watched Folder)
Scope
Name
JNDI name
Base topic name
Server
WatchedFolder
ConfigManager
Topic
topic/WatchedFolder
ConfigManagerTopic
MQJMS/ADOBE/WATCHEDFOLDER/CON
FIG/_MANAGER_TOPIC
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
63
5. Specify the following values for the properties, and then click OK:
Scope: Scope (Scope specified in previous step)
Category: LiveCycle
Persistence: PERSISTENT
Name: Name (name specified in previous step)
JNDI name: JNDI name (JNDI name specified in previous step)
Base topic name: Base topic name (base topic name specified in previous step)
6. Save your changes to the master configuration.
Creating a queue connection factory
The procedures in this section describe how to configure a J2C Authentication Data Entry (for the local
user you created in step 3 on page 23), and a queue connection factory for WebSphere MQ.
When you complete this procedure, you must also configure the session pools and connection pool. (See
“To configure the session pool:” on page 64 and “To configure the connection pool:” on page 64.)
➤ To create a J2C Authentication Data Entry:
1. In the navigation tree of the WebSphere Administration Console, click Security > JAAS Configuration
> J2C Authentication Data.
2. In the right pane, click New.
3. Set the Alias property to a meaningful name, such as mquser.
4. Set the User ID and Password properties to the user name and password you created in step 3 on
page 23.
5. Click OK and save your changes to the master configuration.
➤ To create a queue connection factory:
1. In the navigation tree of the WebSphere Administrative Console, click Resources > WebSphere MQ
JMS Provider.
2. In the right pane, set Scope to Cell and click Apply.
3. Click WebSphere MQ Queue Connection Factories.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
64
4. Click New, specify the following values for the properties of the new queue connection, and then click
OK.
(LiveCycle Workflow, LiveCycle Form Manager) Name: QueueConnectionFactory
(LiveCycle Workflow, LiveCycle Form Manager) JNDI Name: QueueConnectionFactory
(LiveCycle PDF Generator) Name: AESQueueConnectionFactory
(LiveCycle PDF Generator) JNDI Name: jms/QueueConnectionFactory
Category: LiveCycle
Container-managed Authentication Alias: MQ_user_alias.
Queue Manager: queue_manager_name
Host: MQ_host
Port: MQ_port
Channel: SYSTEM.DEF.SVRCONN
Transport Type: CLIENT
XA enabled: Deselect the check box for QueueConnectionFactory.
XA enabled: Select the check box for AESQueueConnectionFactory.
➤ To configure the session pool:
1. Click the name of the queue connection factory that you just created.
2. In the Additional Properties section, click Session Pools.
3. Specify the following values for the properties of the session pool, and then click OK.
Connection Timeout: 180
Max Connections: 10
Min Connections: 10
➤ To configure the connection pool:
1. Click the name of the queue connection factory that you just created.
2. In the Additional Properties section, click Connection Pool.
3. Specify the following values for the properties of the connection pool, and then click OK.
Connection Timeout: 180
Max Connections: 10
Min Connections: 10
Creating topic connection factories
The following procedure describes how to create topic connection factories for WebSphere MQ. When you
complete this procedure, you must also configure the session pools and connection pools. (See “To
configure the session pools:” on page 66 and “To configure the connection pools:” on page 66.)
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
65
➤ To create a topic connection factory:
1. In the navigation tree of the WebSphere Administrative Console, click Resources > WebSphere MQ
JMS Provider.
2. In the right pane, set Scope to either Cell or Server, as indicated in the table below.
3. Select WebSphere MQ Topic Connection Factories.
4. Click New and create the following topic connection factories by completing step 5 for each topic
connection.
(LiveCycle Workflow, LiveCycle Form Manager)
Scope
Name
JNDI name
Category
Cell
RegistryTopicConnectionFactory
RegistryTopicConnectionFactory
LiveCycle
Server
POFConnectionFactory
POFConnectionFactory
LiveCycle
Server
TopicConnectionFactory
TopicConnectionFactory
LiveCycle
(LiveCycle PDF Generator)
Scope
Name
JNDI name
Category
Cell
AESTopicConnectionFactory
jms/TopicConnectionFactory
LiveCycle
5. Specify the following values for the properties, and then click OK:
Container-managed Authentication Alias: MQ_user_alias (alias you created in step 3 on page 63)
Host: MQ_host
Port: MQ_port
Transport Type: CLIENT
Channel: SYSTEM.DEF.SVRCONN
Queue Manager: queue_manager_name
Broker Control Queue: SYSTEM.BROKER.CONTROL.QUEUE
Broker Queue Manager: queue_manager_name
Broker Publication Queue: SYSTEM.BROKER.DEFAULT.STREAM
Broker Subscription Queue: SYSTEM.JMS.ND.SUBSCRIBER.QUEUE
Broker CC Subscription Queue: SYSTEM.JMS.ND.CC.SUBSCRIBER.QUEUE
Broker Version: Basic
Clone Support: Deselect the check box.
6. Save your changes to the master configuration.
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
66
➤ To configure the connection pools:
1. Click the name of one of the topic connection factories that you just created.
2. In the Additional Properties section, click Connection Pool.
3. Specify the following values for the properties of the connection pool, and then click OK:
Connection Timeout: 180
Max Connections: 10
Min Connections: 10
4. Repeat this procedure for each of the topic connection factories.
➤ To configure the session pools:
1. Click the name of one of the topic connection factories that you just created.
2. Under the Additional Properties section, click Session Pools.
3. Specify the following values for properties of the session pool, and then click OK:
Connection Timeout: 180
Max Connections: 10
Min Connections: 10
4. Repeat this procedure for each of the topic connection factories.
Configuring the listener ports
You must configure several listener ports for each server defined in the cluster.
➤ To configure the listener ports:
1. In the navigation tree of the WebSphere Administrative Console, click Servers > Application Servers.
2. In the right pane, click the name of the server.
3. Click Message Listener Service.
4. Click Listener Ports.
5. Click New and create the following listener ports by completing step 6 for each listener port.
(LiveCycle Workflow, LiveCycle Form Manager)
Name
Connection factory JNDI
name
AdobeMDBListener
QueueConnectionFactory
queue/adobe_PECommand
Queue
AdobeMDBPATListener
TopicConnectionFactory
topic/adobe_POFObjectTopic
AdobeMDBTopicListener
TopicConnectionFactory
topic/adobe_ProcessEventType
Destination JNDI name
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JMS resources for WebSphere MQ
67
Connection factory JNDI
name
Destination JNDI name
AdobeTemplateEventMDBTopic
Listener
TopicConnectionFactory
topic/adobe_TemplateEventTopic
adobe_RegistryCacheMonitor
MDBPort
RegistryTopicConnection
Factory
topic/adobe_RegistryCacheMonitor
Topic
adobe_TaskEventTopicListener
TopicConnectionFactory
topic/adobe_TaskEventTopic
Connection factory JNDI
name
Destination JNDI name
Name
(LiveCycle PDF Generator)
Name
DequeuePort
jms/QueueConnection
Factory
queue/adobe_AESJobQueue
ConfigUpdatesListenerPort
jms/TopicConnection
Factory
topic/AESConfigUpdatesTopic
PDFGCompletedJobsListener
Port
jms/QueueConnection
Factory
queue/PDFGCompletedJobsQueue
PsDequeuePort
jms/QueueConnection
Factory
queue/adobe_AESJobQueue
(Watched Folder)
Listener port
WatchedFolderTopicListener
Connection factory JNDI
name
Destination JNDI name
jms/TopicConnection
Factory
topic/WatchedFolderConfig
ManagerTopic
6. Specify the following values for the properties, and then click OK:
Initial State: Started
Maximum sessions: 5
Maximum retries: 10
Maximum messages: 1
Adobe LiveCycle
Configuring Messaging and Security
Configuring LiveCycle Application Server Clusters Using WebSphere
Checking your WebSphere MQ configuration
68
Configuring WebSphere MQ JMS provider for Watched Folder
The following procedure describes how to configure WebSphere MQ JMS providers for Watched Folder.
➤ To configure Websphere MQ for Watched Folder:
1. Run the JMSAdmin tool to create JMS MQ Definitions for WatchedFolderConfigManagerTopic.
2. Navigate to the [MQ_Root]/java/bin directory (where [MQ_Root] is the installation of your Websphere
MQ). The default location of [MQ_Root] is C:\Program Files\ibm\WebSphere MQ or /usr/mqm.
3. From a command prompt, enter the following command:
●
(Linux, UNIX) JMSAdmin
●
(Windows) JMSAdmin.exe
4. From the InitCtx> prompt, type:
DEFINE T(topic/WatchedFolderConfigManagerTopic) bver(V1)
TOPIC(MQJMS/ADOBE/WATCHEDFOLDER/CONFIG_MANAGER_TOPIC)
5. From the InitCtx> prompt, type: END
Note: If you receive the message “unable to bind object,” ensure that you have write access to the
cfstore/topic directory.
Checking your WebSphere MQ configuration
Before proceeding with installing other products, check that WebSphere MQ is configured properly.
➤ To check your configuration:
1. Stop and start WebSphere Application Server.
2. In the WebSphere Administrative Console navigation tree, click Resources > WebSphere MQ JMS
Provider.
3. Ensure that your scope is set to Cell.
4. Click WebSphere MQ Queue Destinations.
5. Click one of the queues that you created using this guide.
6. Under Additional Properties, click MQ Config and check that no errors appear in the Messages area at
the top of the page.
7. Repeat steps 5 and 6 for each queue that you created using this document.
8. In the navigation tree, select Servers > Application Servers.
9. In the right pane, click the name of the server.
10. Click Message Listener Service.
11. Click Listener Ports and check that all of the listener ports are started.
9
Configuration Requirements
The following section details configuration requirements for using LiveCycle products in a clustered
environment.
Large document handling
For large document handling in LiveCycle Form Manager, an NFS shared directory, which allows all nodes
to read and write to it, has to be created and mounted. On Windows servers, create a shared directory and
allow all nodes read and write access to it.
Common elements between LiveCycle products
The following section details common configuration elements for LiveCycle Workflow, LiveCycle Form
Manager and LiveCycle Forms.
Configuring LiveCycle Workflow properties
This section only applies to LiveCycle Workflow and LiveCycle Form Manager.
LiveCycle Workflow requires two properties files to be configured for clustering:
●
adobe-workflow.properties
●
adobe-pof.properties
These files are installed to the [LiveCycle root]/Workflow/workflowproperties directory. To configure these
files you must copy the contents of this folder to the [workflow properties] directory on each server in the
cluster.
➤ To copy the properties files:
1. Navigate to [appserver root] and create a directory called workflowproperties.
Note: This directory is referenced as [workflow properties] in this section.
2. Copy the contents of the [LiveCycle root]/Workflow/workflowproperties directory to the [workflow
properties] directory.
Scheduler property definition and values that can be added
LiveCycle Workflow bundles the Quartz scheduler in its implementation to provide functionality for
persistent timers. The quartz timers are stored in the QRTZ_tables. The scheduler, however, must be
configured to work in a clustered setup to connect to the database to handle its timers. These
configurations are in the adobe-workflow.properties file.
69
Adobe LiveCycle
Configuration Requirements
Configuring LiveCycle Application Server Clusters Using WebSphere
Scheduler property definition and values that can be added
70
➤ To configure the scheduler properties definition:
1. Navigate to the [workflow properties] directory and open the adobe-workflow.properties file in a text
editor.
2. Configure the following scheduler properties:
adobe.workflow.scheduler.java.naming.factory.initial: This property specifies the initial context
factory. Set this property to com.ibm.websphere.naming.WsInitialContextFactory.
adobe.workflow.scheduler.java.naming.provider.url: The JNDI provider URL is dependent on the
application server used; for WebSphere, use:
iiop://host:bootstrap port
The bootstrap port can be found for each server through the admin console by selecting Application
Server > [server name] > Ports > Bootstrap Address.
adobe.workflow.scheduler.bootstrap.wait_time_mins: This is the time the scheduler waits after
bootstrap is done and after initialization prior to starting the scheduler service. The delay is needed
because of an issue in Quartz, where the immediate start of the scheduler upon initialization results in
timer jobs already scheduled not being picked for processing. The default is 60 seconds.
adobe.workflow.scheduler. startup.wait_time_secs: This is the time the scheduler waits after
bootstrapping and initialization, but prior to starting the scheduler service. The delay is needed
because of an issue in Quartz, where the immediate start of the scheduler upon initialization results in
timer jobs already scheduled not being picked for processing. The default is 60 seconds.
adobe.workflow.scheduler.startup.threads: This is the number of threads used by the scheduler.
The default is 15.
adobe.workflow.scheduler.jdbc.delegate: The JDBC delegate driver to be used to connect to the
database. The following values are available.
Delegate value
Databases supported
org.quartz.impl.jdbcjobstore.
StdJDBCDelegate
Used for most JDBC-compliant drivers. This works
for Oracle 9i, Oracle 10G, and MySQL.
org.quartz.impl.jdbcjobstore.
MSSQLDelegate
Must be used when SQL Server is used as the
database to connect to.
org.quartz.impl.jdbcjobstore.
PostgreSQLDelegate
For PostgreSQL database.
org.quartz.impl.jdbcjobstore.
WebSphereDelegate
When WebSphere database drivers are used in the
application server rather than the database vendor
provided drivers
org.quartz.impl.jdbcjobstore.
oracle.OracleDelegate
For Oracle drivers, although the standard JDBC
driver delegate works fine.
Note: The default is org.quartz.impl.jdbcjobstore.StdJDBCDelegate, which works for all
databases except SQL Server.
adobe.workflow.scheduler.isClustered: This property must be set to true if you have multiple
instances of Quartz using same set of database tables. Set this value to true.
adobe.workflow.scheduler.instanceId: Each instance in the cluster must have a unique instance ID.
Set this value to AUTO.
3. Configure adobe-workflow.properties for each server in the cluster.
Adobe LiveCycle
Configuration Requirements
Configuring LiveCycle Application Server Clusters Using WebSphere
Cache configuration properties
71
Cache configuration properties
For clustering, LiveCycle Workflow Server supports Swarm Cache, which is an implementation based on
JGroups that provides the cache capabilities needed in a clustered environment. The cache is configured
in the adobe-pof.properties file. This file must be placed on each server in the cluster.
➤ To configure the cache configuration properties:
1. Navigate to the [workflow properties] directory and open the adobe-pof.properties file in a text editor.
2. Configure the following cache properties:
adobe.pof.cache.provider: If the value of hashmap is selected prior to server startup, the server starts
up using a hashmap as a cache. If the value of swarm is used, the server uses the swarm cache
implementation bundled.
adobe.pof.cache.logging-enabled: If the value of true is selected, all of the additions, updates, and
removals of data elements in the cache are logged by LiveCycle Workflow. Note that these are logged
by the LiveCycle Workflow codebase; these do not enable the logging for the swarm cache
implementation (that is, TCP or UDP connections and communication).
adobe.pof.cache.swarm.cluster-enabled: The value of true indicates to the cache to use TCP
configurations and a value of ‘false’ indicates usage of UDP configuration.
adobe.pof.cache.swarm.cluster-tcp-config: This property is used to configure TCP communication
between various cache nodes in the cluster.
adobe.pof.cache.swarm.cluster-udp-config: The property is used to configure UDP communication
between various cache nodes in the cluster.
For LiveCycle Workflow, set the following values:
Property name
Values
adobe.pof.cache.provider
swarm
adobe.pof.cache.logging-enabled
false <default>, true
adobe.pof.cache.swarm.cluster-enabled
true
adobe.pof.cache.swarm.cluster-tcp-config
see the example (below)
adobe.pof.cache.swarm.cluster-udp-config
leave empty
Example: TCP configuration
The following is an example for a cluster containing two servers called ServerA and ServerB.
In the adobe-pof.properties file for ServerA, configure your adobe.pof.cache.swarm.cluster-tcp-config
string as follows:
TCP(bind_addr=serverA;start_port=7800):TCPPING(initial_hosts=serverB[780
0];port_range=5;timeout=3000;num_initial_members=5):FD:VERIFY_SUSPECT(ti
meout=1500;down_thread=false;up_thread=false):pbcast.NAKACK(gc_lag=100;r
etransmit_timeout=600,1200,2400,4800;up_thread=true;down_thread=true):pb
cast.STABLE(desired_avg_gossip=20000;max_bytes=0;stability_delay=1000;up
_thread=false;down_thread=false):pbcast.GMS(join_timeout=5000;join_retry
_timeout=2000;shun=false;print_local_addr=true;up_thread=true;down_threa
d=true):pbcast.STATE_TRANSFER(up_thread=true;down_thread=true)
Adobe LiveCycle
Configuration Requirements
Configuring LiveCycle Application Server Clusters Using WebSphere
Adding property definitions
72
In the adobe-pof.properties file for ServerB, configure your adobe.pof.cache.swarm.cluster-tcp-config
string as follows:
TCP(bind_addr=serverB;start_port=7800):TCPPING(initial_hosts=serverA[780
0];port_range=5;timeout=3000;num_initial_members=5):FD:VERIFY_SUSPECT(ti
meout=1500;down_thread=false;up_thread=false):pbcast.NAKACK(gc_lag=100;r
etransmit_timeout=600,1200,2400,4800;up_thread=true;down_thread=true):pb
cast.STABLE(desired_avg_gossip=20000;max_bytes=0;stability_delay=1000;up
_thread=false;down_thread=false):pbcast.GMS(join_timeout=5000;join_retry
_timeout=2000;shun=false;print_local_addr=true;up_thread=true;down_threa
d=true):pbcast.STATE_TRANSFER(up_thread=true;down_thread=true)
3. Change the values of ServerA and ServerB as required for your cluster.
4. Configure adobe-pof.properties configurations for each server in the cluster.
Adding property definitions
This section only applies to LiveCycle Workflow and LiveCycle Form Manager.
Property definitions define settings that enhance the system's use of the JVM by specifying command line
arguments to pass to the JVM code that starts the application server process.
➤ To add the properties to the WebSphere Server cluster:
1. Log in to the Administrative Console for your WebSphere cluster.
2. On each server, navigate to Application Servers > [server name].
3. On the Configuration tab, under Additional properties select Process Definition.
4. Under Additional Properties, click Java Virtual Machine and, in the Generic JVM arguments box, type
the following:
(LiveCycle Workflow and LiveCycle Form Manager) Add the following code:
-Djava.awt.headless=true -Dclient.encoding.override=UTF-8
-Dadobe.workflow.engine.publish-process-events=false
(LiveCycle Form Manager) Add the following:
-Dcom.adobe.fm.lucene.enabled=false
5. Add the following JVM argument to point to your adobe-workflow.properties file:
-Dadobe.workflow.properties=[workflow
properties]/adobe-workflow.properties
where [workflow properties] is the workflowproperties directory location.
6. Add the following JVM argument to point to your adobe-pof.properties file:
-Dadobe-pof.properties=[workflow properties]/adobe-pof.properties
where [workflow properties] is the workflowproperties directory location.
7. Click Apply, click Apply again, and then save your changes to the Master Configuration.
8. Save and restart the cluster. For information on how to restart the cluster, see “Shutting down and
restarting nodes and clusters” on page 33.
Adobe LiveCycle
Configuration Requirements
Configuring LiveCycle Application Server Clusters Using WebSphere
Email receiver configuration
73
Email receiver configuration
When all servers in a LiveCycle Workflow cluster are configured to process incoming email messages, a
form that is emailed to LiveCycle Workflow Server to initiate a process will initiate multiple instances of the
process. To avoid this situation, you must configure each server in the cluster so that only one server
processes email messages. By default, all servers in the cluster are configured to process email messages.
The following property must be added to the JVM arguments on each server except the server that you
want to process email messages using the following command:
-Dcom.adobe.workflow.email.runInboxReader=false
For information on how to add property definitions, see “Adding property definitions” on page 72.
LiveCycle Policy Server caching configuration setup
Create a file called edccache.properties with the following entries and copy it to the [profile
root]/properties directory on each node. LiveCycle Policy Server caches many complex objects in memory,
therefore, it is important that in a cluster, all of the LLiveCycle Policy Server instances have the same
version of cached objects. LiveCycle Policy Server uses a multicast protocol to communicate among cache
managers and update cache entries.
#cluster based caching
# This entry tells the maximum number of each type of object to cache. The
value depends on the machine capacity and allocated JVM memory.
edc.cache.size=200
# This entry specifies whether LiveCycle Policy Server is configured in a
cluster environment or as stand-alone server. This entry is very important.
edc.cluster=true
# This entry defines the multicast IP address. The server uses this entry
only when edc.cluster is set to true. Please refer to your system
administrator in order to set the following address values.
edc.cluster.multicast.address=231.12.21.132
Configuring caching properties for User Management
This section only applies to LiveCycle Workflow and LiveCycle Form Manager.
You must configure User Management caching if you have LiveCycle Form Managerr or
LiveCycle Workflow installed.
➤ To configure caching properties for User Management:
1. Navigate to [appserver root]\properties and create a file named umcache.properties.
Adobe LiveCycle
Configuration Requirements
Configuring LiveCycle Application Server Clusters Using WebSphere
Configuring JVM properties
74
2. Copy the following text and save it into the umcache.properties file:
#cluster based caching
# This entry tells the maximum number of each type of object to cache. The
#value depends on the machine capacity and allocated JVM memory.
um.cache.size=200
# This entry specifies that UM is running in a clustered environment
um.cluster=true
# This entry defines the multicast IP address. The server uses this entry
#only when um.cluster is set to true. Please refer to your system
#administrator in order to set the following address values.
um.cluster.multicast.address=231.13.22.132
3. Configure the umcache.properties file for each server in the cluster.
Configuring JVM properties
You will now have to configure the Java Virtual Machine.
Note: If you anticipate a high load on your LiveCycle Server you should also increase the Default disposal
time-out (in seconds) value to 1800 in the LiveCycle product. You can set this value by running the
LiveCycle Configuration manager and modifying the default value in the Data Manager Module
Configuration screen. Refer to the LiveCycle Installation and Configuration guides for more
information on running the LiveCycle configuration Manager.
➤ (LiveCycle PDF Generator) To set up custom JVM properties
1. Specify the following attributes:
Name=java.io.tmpdir
Value=[path to a common shared location with read-write access to all the
nodes in the cluster]
2. Click New.
3. (LiveCycle PDF Generator Professional or LiveCycle PDF Generator Elements) Specify the following
attributes:
Name=com.ibm.websphere.ejbcontainer.poolSize
Value=pdfg-all#aaes-ejb.jar#Dequeue=1,1:pdfg-all#adobe-PsToPdfEjb.jar
#PsToPdfDequeue=1,3:*=40,100
4. (LiveCycle PDF Generator for PostScript) Specify the following attributes:
Name=com.ibm.websphere.ejbcontainer.poolSize
Value=pdfg-ps-all#adobe-PsToPdfEjb.jar#PsToPdfDequeue=1,3:*=40,100
5. Click Apply and then click Save.
10
Deploying LiveCycle Products
This chapter describes how to deploy your LiveCycle products to WebSphere.
●
“About deploying LiveCycle products to a cluster” on page 75
●
“Deploying LiveCycle products” on page 76
●
“Starting the application” on page 80
Assembling LiveCycle.ear for LiveCycle PDF Generator in a cluster
When assembling the LiveCycle.ear file for deployment to a cluster, you must ensure that the LiveCycle
temp and Global Storage directory are specified, and they must point to the same NFS shared directory
used when defining the JVM argument java.io.tempdir.
About deploying LiveCycle products to a cluster
Before you deploy LiveCycle products, ensure that you have met the following requirements:
●
You have installed the required software and files and know the location of the directories you will be
working with.
●
You have run Configuration Manager to configure and assemble the products according to your
system and application server requirements. If you need to make any further changes to the properties
after deployment, you can run Configuration Manager to make the changes, and then redeploy the
updated EAR file. For more information, see the Installing and Configuring LiveCycle for WebSphere and
Installing and Configuring LiveCycle Security Products for WebSphere guides.
If you are using an external web server, see your web server documentation for information regarding the
configuration required to allow access to the application server.
This chapter refers to the WebSphere home directory as [appserver root]. This directory is the same as the
one specified for the WAS_HOME environment variable. Similarly, [LiveCycle root] refers to the location
where LiveCycle products and components are installed.
Summary of deployable components
During the deployment process, you need to deploy the following components.
Component
LiveCycle product
adobe-Assembler7.ear
LiveCycle Assembler
adobe-FontManager.ear
All products except LiveCycle Policy Server
adobe-printSubmitter.ear
LiveCycle Print sample application
FormsIVS.ear
LiveCycle Forms sample application
75
Adobe LiveCycle
Deploying LiveCycle Products
Configuring LiveCycle Application Server Clusters Using WebSphere
Deploying LiveCycle products
Component
LiveCycle product
LCM.ear
All
LiveCycle.ear
All products except LiveCycle Policy Server
LiveCycle-security.ear
LiveCycle Reader Extensions
76
LiveCycle Document Security
adobe-CredentialSecurityEJB.ear
LiveCycle Document Security
edc-server.ear
LiveCycle Policy Server
pdfg-all.ear
LiveCycle PDF Generator Professional and
LiveCycle PDF Generator Elements
pdfg-ps-all.ear
LiveCycle PDF Generator for PostScript
Note: FormsIVS is not designed for clustering.
Note: The LiveCycle Reader Extensions UI is not supported in a cluster; however, the API is supported.
Deploying LiveCycle products
You deploy LiveCycle products to WebSphere by deploying the component EAR files to the cluster using
the WebSphere Administrative Console.
Before deploying to WebSphere, you must start the application server on your computer. After deploying
the required components, you must stop and restart the application server before starting any services.
➤ To deploy the EAR files:
1. Copy the following files from the [LiveCycle root]/configurationManager/export directory to the
[appserver root]/installableApps directory of any of the managed nodes or the Deployment Manager:
●
(All products except LiveCycle Policy Server) LiveCycle.ear
●
(All products except LiveCycle Policy Server) adobe-FontManager.ear
●
(LiveCycle Assembler) adobe-Assembler7.ear
●
(LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements)pdfg-all.ear
●
(LiveCycle PDF Generator for PostScript) pdfg-ps-all.ear
●
(LiveCycle Reader Extensions, LiveCycle Document Security) LiveCycle-security.ear
●
(LiveCycle Print) adobe-printSubmitter.ear
●
(LiveCycle Policy Server) edc-server.ear
2. Copy the LCM.ear file from the [LiveCycle root]/configurationManager/deploy/websphere directory to
the [appserver root]/installableApps directory.
3. Copy the FormsIVS.ear file from [LiveCycle root]/components/forms/samples/common to the [appserver
root]/installableApps directory.
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Deploying LiveCycle Products
Deploying LiveCycle products
77
➤ (LiveCycle Print) To deploy the adobe-printSubmitter.ear file:
1. In the WebSphere Administrative Console navigation tree, select Applications > Install New
Application.
2. Click Browse to navigate to the [appserver root]/InstallableApps directory, select
adobe-printSubmitter.ear, and then click Open or OK (depending on your operating system).
3. Continue to click Next, until you reach the step Map Modules to Application Servers, and select all
the modules. Then click Next again.
4. In the Clusters and Servers step, select the cluster and click Apply.
5. Click Next to continue, accepting the default values that are displayed on each screen, and then click
Finish.
6. Save to the master configuration, and ensure that you select Synchronize changes with nodes.
➤ (LiveCycle Forms) To deploy the FormsIVS.ear file:
1. In the WebSphere Administrative Console navigation tree, select Applications > Install New
Application.
2. Click Browse to navigate to the [appserver root]/InstallableApps directory, select FormsIVS.ear, and
then click Open or OK (depending on your operating system).
3. Continue to click Next, until you reach the step Map Modules to Application Servers, and select all
the modules, then click Next again.
4. In the Clusters and Servers step, select the cluster and click Apply.
5. Click Next to continue, accepting the default values that are displayed on each screen, and then click
Finish.
6. Save to the master configuration. Ensure that you select Synchronize changes with nodes.
➤ (All products except LiveCycle Policy Server) To deploy the adobe-FontManager.ear file:
1. In the WebSphere Administrative Console navigation tree, select Applications > Install New
Application.
2. Click Browse to navigate to the [appserver root]/InstallableApps directory, select
adobe-FontManager.ear, and then click Open or OK (depending on your operating system).
3. Click Next, and select Generate Default Bindings.
4. Continue to click Next, until you reach the step Map Modules to Application Servers, and select all
the modules. Then click Next again.
5. In the Clusters and Servers step, select the cluster and click Apply.
6. Click Next to continue, accepting the default values that are displayed on each screen, and then click
Finish.
7. Save to the master configuration. Ensure that you select Synchronize changes with nodes.
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Deploying LiveCycle Products
Deploying LiveCycle products
78
➤ (All products except LiveCycle Policy Server) To deploy the LiveCycle.ear file:
1. In the navigation tree, select Applications > Install New Application.
2. Click Browse to navigate to the [appserver root]/InstallableApps directory, select LiveCycle.ear, and
then click Open or OK (depending on your operating system).
3. Click Next, and select Generate Default Bindings.
4. Continue to click Next, until you reach the step Map Modules to Application Servers, and select all
the module. Then click Next again.
5. In the Clusters and Servers step, select the cluster and click Apply.
6. Click Next to continue, accepting the default values that are displayed on each screen.
7. (LiveCycle Assembler) On the Provide JNDI Names for Bean screen, for the
AdobeIDP2UI_MonitorComponent EJB, type the JNDI name,
ejb/AdobeIDP2UI_MonitorComponent, and then click Next.
8. Click Finish.
9. Save to the master configuration. Ensure that you select Synchronize changes with nodes.
➤ To deploy the LCM.ear file:
1. In the WebSphere Administrative Console navigation tree, select Applications > Install New
Application.
2. Click Browse to navigate to the [appserver root]/InstallableApps directory, select LCM.ear, and then
click Open or OK (depending on your operating system).
3. Click Next, and select Generate Default Bindings.
4. Continue to click Next until you reach the step Map Modules to Application Servers, and select all
the modules. Then click Next again.
5. In the Clusters and Servers step, select the cluster and click Apply.
6. Click Next to continue, accepting the default values that are displayed on each screen, and then click
Finish.
7. Save to the master configuration. Ensure that you select Synchronize changes with nodes.
➤ (LiveCycle Reader Extensions, LiveCycle Document Security) To deploy the LiveCycle-security.ear
file:
1. In the WebSphere Administrative Console navigation tree, select Applications > Install New
Application.
2. Click Browse to navigate to the [appserver root]/InstallableApps directory, select
LiveCycle-security.ear, and then click Open or OK (depending on your operating system).
3. Click Next, and select Generate Default Bindings.
4. Continue to click Next until you reach the step Map Modules to Application Servers, and select all
the module. Then click Next again.
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Deploying LiveCycle Products
Deploying LiveCycle products
79
5. In the Clusters and Servers step, select the cluster and click Apply.
6. Click Next to continue, accepting the default values that are displayed on each screen, and then click
Finish.
7. Save to the master configuration. Ensure that you select Synchronize changes with nodes.
➤ (LiveCycle Policy Server) To deploy the edc-server.ear file:
1. In the WebSphere Administrative Console navigation tree, select Applications > Install New
Application.
2. Click Browse to navigate to the [AppServer root]/installableApps directory and select edc-server.ear.
3. Click Next, and select Generate Default Bindings.
4. Click Next, accept the default values that are displayed and then click Finish.
5. Click Save to Master Configuration, and then click Save.
6. In the WebSphere Administrative Console navigation tree, select Applications > Enterprise
Applications and select EDC Application.
7. In the Classloader Mode list, select Parent Last and click Apply.
8. Under Additional Properties, select Libraries and click Add.
9. In the Library Name list, select EDCApplication.
10. Click Apply and save your changes to the Master Configuration.
11. Stop the server and restart WebSphere.
➤ (LiveCycle PDF Generator) To deploy the pdfg-all.ear or pdfg-ps-all.ear files:
1. In the navigation tree, select Applications > Install New Application.
2. (LiveCycle PDF Generator Professional and LiveCycle PDF Generator Elements)Click Browse to
navigate to the [appserver root]/InstallableApps directory, select pdfg-all.ear, and then click Open.
3. (LiveCycle PDF Generator for PostScript)Click Browse to navigate to the [appserver
root]/InstallableApps directory, select pdfg-ps-all.ear, and then click Open.
4. Click Next, accept the default values that are displayed on the first two screens and, in the Step 1:
Provide options to perform the installation screen, select Deploy EJBs.
5. Click Next. On the Map Modules to Servers step, select all the modules.
6. In the Clusters and Servers step, select the cluster and click Apply.
7. Click Next to continue, accept the default values that are displayed on each screen, and then click
Finish.
8. Click Save to Master Configuration. Ensure that synchronize changes with nodes is selected, and
then click Save.
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Deploying LiveCycle Products
Starting the application
80
➤ (LiveCycle Assembler) To deploy the adobe-Assembler7.ear:
1. In the navigation tree, select Applications > Install New Application.
2. Click Browse to navigate to the [appserver root]/InstallableApps directory, select
adobe-Assembler7.ear, and then click Open.
3. Click Next, and select Generate Default Bindings.
4. Click Next. On the Step 8: Map Modules to Servers step, select all the modules.
5. In the Clusters and Servers step, select the cluster and the node containing the web server and click
Apply.
6. Save to the master configuration.
Now that all of the applications have been deployed, you must now update the web server plug-in file. See
“Generating and updating the IBM HTTP Server plug-in” on page 29.
Starting the application
After deploying the product, you need to start the applications. When the red “X” beside the name of the
application changes to a green arrow, the application has been deployed and started successfully.
WebSphere displays an error message if it cannot start the application.
For information about WebSphere error messages, refer to your WebSphere Application Server
documentation.
➤ To start an application in WebSphere:
1. In the WebSphere Administrative Console navigation tree, select Applications > Enterprise
Applications.
2. Select any or all of the applications you want to start.
3. Click Start. The red X beside the status of each application changes to a green arrow, indicating that
the application is running.
Tip: Wait several minutes between deploying the LiveCycle.ear and starting the application. This waiting
period allows adequate time for WebSphere to copy the files to each node in the cluster. The EAR file
may not start if not fully deployed.
Verifying the LiveCycle Forms deployment
You can verify that LiveCycle Forms has been deployed properly and is running by deploying the
Installation Verification sample application that is installed with the product.
The sample application (FormsIVS.ear) is in the [LiveCycle root]/components/forms/samples/common
directory.
Note: For information about using the sample application, click the Help link in the Samples page in the
web browser.
Adobe LiveCycle
Deploying LiveCycle Products
Configuring LiveCycle Application Server Clusters Using WebSphere
Bootstrapping LiveCycle products
81
➤ To deploy the LiveCycle Forms Installation and Verification sample application:
1. In the navigation tree, select Applications > Enterprise Applications, and then select FormsIVS.
2. Click Start. The red X beside the name of each application changes to a green arrow, indicating that the
application is running.
3. Start the application by typing http://hostname:portnumber/FormsIVS in the URL line of a
web browser.
Bootstrapping LiveCycle products
After the LiveCycle product is deployed in the cluster, you need to bootstrap. You can run the bootstrap
process from any of the nodes. However, first you need to find the JNDI server name and port number. You
can find this information by running the dumpnamespace.bat file from the bin directory where the
application server is installed.
➤ To bootstrap using Configuration Manager:
1. Go to the Adobe install directory and run Configuration Manager.
2. In the Choose a Language box, select English and click OK.
3. In the Welcome screen, click Next.
4. Select Custom Configuration Wizard and click Next.
5. Under Configuration Preferences, select either Use previously entered values or Revert to default
values and click Next.
6. Under Task Selection, select Bootstrap Database, deselect all other options, and then click Next.
7. In the Enter Application Server Configuration Details screen, specify the following properties:
●
In the Hostname box, enter the host name of the node.
●
In the SOAP Port box, type the SOAP port which can be found under Application Servers >
Node > End Points > SOAP CONNECTOR ADDRESS.
●
Server instance name
●
Local App Server root directory of the ND machine
Then click Next.
8. Enter the application server URL.
9. Enter one of the servers and the port number. To retrieve the port number for your node select Servers
> Application Server > [node name] > Webcontainer > HTTP transports.
10. Click Next.
11. Do not deploy the LCM.ear file. Click Next.
12. Click Initialize Database, and when bootstrapping is finished, click Finish.
Adobe LiveCycle
Deploying LiveCycle Products
Configuring LiveCycle Application Server Clusters Using WebSphere
Viewing log files
82
Viewing log files
Events, such as run-time or startup errors, are recorded to the application server log files. If you have
problems deploying to the application server, you can use the log files to help you find the problem. You
can open the log files using any text editor.
The following log files are located in the [appserver root]/logs/servername directory:
●
SystemErr.log
●
SystemOut.log
●
StartServer.log
11
Issues with Clustering
This section contains issues that may occur in your cluster.
Failed to acquire job exception in WebSphere
In WebSphere clusters, a “Failed to acquire job” exception appears in the log file if you execute a directory
synchronization immediately after the server nodes start up. You need to ensure that the directory sync
did perform correctly; if it did not, invoke a directory sync again.
ORB threadpool for LiveCycle Policy Server and
LiveCycle Document Security
In typical cluster configurations and configurations where LiveCycle Policy Server is used with
LiveCycle Document Security, a threadpool for ORB connections set to 50 (default) concurrent threads is
likely inadequate to handle the load. Administrators should increase this threadpool size to as great a
number of concurrent threads as their applications require, typically 125 or more. For high availability
configurations, this guideline applies to each node in the cluster. For example, if one system goes down in
a two-node cluster, the remaining node can still accommodate the application’s maximum number of
concurrent connections.
LiveCycle Forms preferences do not get propagated
Changes to LiveCycle Forms preferences do not get propagated among the cluster nodes when
LiveCycle Forms is configured with or without database options. You must update the preferences for all
nodes in the cluster individually.
➤ To update the LiveCycle Forms preferences:
1. Open a browser and navigate to:
(LiveCycle Forms with database option)
http://[nodeIP]:[port]/adminui
(LiveCycle Forms without database option)
http://[nodeIP]:[port]/FormServerAdmin/settings.html
Where [nodeIP] is the IP address of the node, and [port] is the node’s port number.
2. (LiveCycle Forms with database option) Log in to the LiveCycle Administration Console, click Services,
and then click Adobe LiveCycle Forms.
3. Perform the required changes to the LiveCycle Forms preferences.
4. Click Save.
5. Repeat steps 1 to 4 for each node in the cluster.
83
Adobe LiveCycle
Configuring LiveCycle Application Server Clusters Using WebSphere
Issues with Clustering
LiveCycle Reader Extensions UI is not supported in a cluster
LiveCycle Reader Extensions UI is not supported in a cluster
The LiveCycle Reader Extensions user interface is not supported in a clustered environment. Only the
LiveCycle Reader Extensions API is supported in a clustered environment.
84
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement