bc Installing and Configuring LiveCycle for JBoss Adobe® LiveCycle™ October 2006 Version 7.
© 2006 Adobe Systems Incorporated. All rights reserved. Adobe® LiveCycle™ 7.2 Installing and Configuring LiveCycle for JBoss® for Microsoft® Windows® and Linux® Edition 1.1, October 2006 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.
Portions licensed under the Mozilla Public License Version 1.1, available at www.mozilla.org. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users.
Contents Preface .......................................................................................................................................... 8 What’s in this guide? ..................................................................................................................................................................... 8 Who should read this guide? ........................................................................................................................................
Adobe LiveCycle Installing and Configuring LiveCycle for JBoss 3 Contents 5 Post-deployment (Continued) LiveCycle PDF Generator post-deployment tasks ............................................................................................................31 Setting up job sources .........................................................................................................................................................31 Setting Adobe PDF Printer as the default printer ....................
Adobe LiveCycle Installing and Configuring LiveCycle for JBoss Contents 6 Part III: Post-Deployment Configuration 11 Configuring SSL on JBoss.......................................................................................................... 71 Creating an SSL Credential .......................................................................................................................................................71 Configuring SSL on JBoss .....................................................
Adobe LiveCycle Installing and Configuring LiveCycle for JBoss D Contents 7 Developing Forms for LiveCycle.............................................................................................113 Publishing files from client software.................................................................................................................................. 113 Designing forms for LiveCycle products................................................................................................
Preface This guide is one of several resources available to help you learn about the Adobe® LiveCycle™ suite of products. LiveCycle products help automate and accelerate the flow of business-critical information to and from customers, partners, constituents, and employees.
Adobe LiveCycle Preface Installing and Configuring LiveCycle for JBoss Related documentation Name Default value Description [product root] Windows: The directories where product-specific directories and files (such as documentation, uninstall files, samples, and license information) are located.
Adobe LiveCycle Preface Installing and Configuring LiveCycle for JBoss Updated LiveCycle product information 10 For information about See The EJB API, including descriptions and explanations of its classes and methods. The API Reference for each product. Most API References are installed as JavaDocs with each product. However, some API references are provided as PDF documents with the product.
1 Before You Install This chapter describes how to prepare your system for installing LiveCycle products: ● “About the installation, configuration, and deployment process” on page 11 ● “Methods for installing, configuring, and deploying LiveCycle products” on page 12 ● “Installing and deploying multiple LiveCycle products” on page 12 ● “System requirements” on page 13 ● “Installation, configuration, and deployment checklists” on page 16 ● “Updated LiveCycle product information” on page 18 Befor
Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Methods for installing, configuring, and deploying LiveCycle products 12 Methods for installing, configuring, and deploying LiveCycle products You can use one of the following methods for installing, configuring, and deploying LiveCycle products as well as initializing the database: Turnkey: (Windows/JBoss/MySQL) The turnkey method lets you install the files, and then run Configuration Manager to configure the EAR file an
Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss About Watched Folder installation 13 About Watched Folder installation Both LiveCycle Assembler and LiveCycle PDF Generator can use watched folder functionality as a method for initiating jobs for processing. However, LiveCycle Assembler and LiveCycle PDF Generator use different watched folder technologies.
Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Supported software Required software Supported version Application server ● JBoss Application Server 3.2.5 ● JBoss Application Server 3.2.6 (Applicable only for BAM Server, which is a component of LiveCycle Workflow Server) 14 Note: Your application server must have an active Internet connection to access LiveCycle Administrator. Web browser ● Microsoft Internet Explorer 6.0 for Windows ● Netscape 7.
Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Platform and software combinations 15 Platform and software combinations This table summarizes the software combination and database combination supported for JBoss 3.2.5. For a complete list of supported software on each operating system, see “Supported Platform and Software Combinations” on page 100.
Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Additional requirements for LiveCycle PDF Generator for PostScript 16 Before installing LiveCycle PDF Generator Elements or LiveCycle PDF Generator Professional, you must also install the software that supports the file formats for which PDF conversion support is required.
Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Manual installation and deployment checklist 17 Do not use the turnkey configuration method if you plan to enable SSL. If you require SSL, perform a manual configuration. (See “Configuring LiveCycle Products for Deployment” on page 49.) Task Topic Ensure that you have the required software installed in the target environment.
Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Updated LiveCycle product information Task Topic Configure LDAP access. “Configuring LiveCycle Products to Access LDAP” on page 68 Configure SSL on the application server, if required. “Configuring SSL on JBoss” on page 73 (LiveCycle Workflow) Create the BAM metadata database “Manually Configuring JBoss for BAM Server” on page 76 and configure the application server for BAM Server. Check the log file.
Part I: Turnkey Installation This section of the guide describes how to complete a turnkey installation of LiveCycle products For information on the manual configuration and deployment of the products, see “Manual Installation, Configuration and Deployment” on page 34.
2 Installing LiveCycle Products Using the Turnkey Installation This chapter describes how to install LiveCycle products using the turnkey method. The turnkey installation automatically performs all of the tasks required to install and configure LiveCycle products on a JBoss Application Server running on Windows. The turnkey installation performs the following tasks: ● Installs the product files ● Installs a preconfigured version of JBoss 3.2.
Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation 21 The turnkey installation creates the following Windows services: ● JBoss for Adobe LiveCycle ● MySQL for Adobe LiveCycle ● (LiveCycle Workflow) JBoss for Adobe LiveCycle Workflow BAM These services are used by Configuration Manager during the turnkey installation.
Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation 22 12. Review the installation details, and then click Install. A summary screen appears when the product installation is completed. 13.
Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation 23 29. On the Database Initialization screen, click Initialize Database Now to connect your LiveCycle products to the database, and then click Next. 30. On the Database Initialization screen, click Initialize Database Now and, when the task is complete, click Next. 31. On the Tasks Completed screen, click Finish.
Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation 24 12. Read the license information associated with installing MySQL, select I accept the terms of the license agreement, and then click Next. 13. (LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements) Enter the Microsoft Office administrator user name and password (if installed), and then click Next. 14.
Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Modifying LiveCycle Services 25 28. On the Deploy Products screen, click Next. 29. On the Deployment Instructions screen, click Next. 30. On the Database Initialization screen, click Initialize Database Now to connect your LiveCycle products to the database, and then click Next. 31. On the Tasks Completed screen, click Finish.
3 Post-deployment This chapter describes how to get started using your LiveCycle products after they have been installed, configured, and deployed to your application server: ● “Accessing Administrator” on page 26 ● “Accessing User Management” on page 27 ● “LiveCycle Assembler post-deployment tasks” on page 27 ● “LiveCycle Forms post-deployment tasks” on page 28 ● “LiveCycle Print post-deployment tasks” on page 28 ● “LiveCycle Form Manager post-deployment tasks” on page 31 ● “LiveCycle PDF Gen
Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Accessing User Management 27 Accessing User Management User Management allows administrators to maintain a database for all users and groups that are synchronized with one or more third-party user directories.
Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss LiveCycle Forms post-deployment tasks 28 LiveCycle Forms post-deployment tasks This section describes the post-deployment tasks specific to LiveCycle Forms. You can now create custom applications for LiveCycle Forms. (See the Developing Custom Applications guide.) For details on the Form Server Module, see the Form Server Module API Reference. For details on the XML Form Module API, see the XML Form Module API Reference.
Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Deploying and running the PrintIVS web application 29 In addition to running the two sample print applications, you can also invoke LiveCycle Print by using the Form Server Module API Print application. This sample Print application is a console application that invokes LiveCycle Print by using the Form Server Module API. (See “Running the Form Server Module API Print application” on page 30.
Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Running the Form Server Module API Print application 30 located in the same directory as the lcprint.bat file. (See “About the print specification” in the LiveCycle Print Getting Started guide.) One value that you must specify within the print specification is the location of the form design on which a print stream is based.
Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss LiveCycle Form Manager post-deployment tasks 31 LiveCycle Form Manager post-deployment tasks This section describes the post-deployment tasks specific to LiveCycle Form Manager.
Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Installing fonts 32 Installing fonts You can install the fonts that are used in documents converted by LiveCycle PDF Generator. Fonts may be referenced by PostScript or EPS documents, or they may be referenced by native file formats, such as those used by Microsoft Word or Microsoft Excel.
Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Setting the LiveCycle PDF Generator conversion time-out 33 ➤ To set the conversion time-out settings at the job source level: ● In Administrator, select Create PDF and, in the Specify a timeout box, type a value in seconds. By default, this value is read from the server.aes.properties file. ➤ To set the conversion time-out settings for watched folders and email sources: 1.
Part II: Manual Installation, Configuration and Deployment This section of the guide describes how to manually install, configure and deploy your LiveCycle products. For information on the automatic installation, configuration and deployment of the products, see “Installing LiveCycle Products Using the Turnkey Installation” on page 20.
4 Installing LiveCycle Products This chapter describes how to use the installation program to install LiveCycle products on a Windows or Linux operating system. If you are installing LiveCycle PDF Generator (all versions), see Installing LiveCycle PDF Generator. Note: If you are installing multiple LiveCycle products we recommend you install LiveCycle PDF Generator first.
Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle PDF Generator 36 Installing LiveCycle PDF Generator The procedure in this section applies to LiveCycle PDF Generator Professional, LiveCycle PDF Generator Elements, and LiveCycle PDF Generator for PostScript. When you run the installation program, you need the following information: ● The serial number for the product you are installing.
Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle PDF Generator 37 ➤ To install LiveCycle PDF Generator for manual deployment: 1. At the root level of the installation media, start the installation program: ● (Windows) Double-click the .exe file. ● (Linux) From a command prompt, type: file_name.bin Note: You may have to change the permissions on the install program under Linux. To do so, type: chmod +x filename.bin 2.
Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle products 38 Installing LiveCycle products This section applies only to LiveCycle Assembler, LiveCycle Forms, LiveCycle Form Manager, and LiveCycle WorkFlow. When you run an installation program, you need the following information: ● The serial number for the product you are installing. ● The type of installation and configuration you are performing.
Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle Print 39 8. Read the Product License Agreement, select I accept the terms of the license agreement, and then click Next. Note: Depending on the product you are installing, the next two steps may appear in reverse order. 9. Select the application server you are deploying the product to and click Next. Note: Do not select the option to automatically configure and deploy. 10.
Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing Watched Folder 40 4. On the Read Before Install screen, if you are upgrading from a previous version, ensure that you have complied with the upgrade instructions, and then click Next. If you are not upgrading, click Next. 5. Type the serial number in the text box and click Next. 6. Read the Product License Agreement, select I accept the terms of the license agreement, and then click Next. 7.
Adobe LiveCycle Installing and Configuring LiveCycle for JBoss Installing LiveCycle Products Viewing the error log 41 6. Accept the default location, or click Browse and navigate to the location where you want to install Watched Folder, and then click Next. 7. Review the installation details, and then click Install. A summary screen appears when the product installation is completed. 8. Ensure that the Start Configuration Manager option is not selected, and then click Finish.
5 Preparing Your Environment This chapter describes how to prepare your environment for hosting LiveCycle products. You must perform the tasks provided in this chapter before you configure LiveCycle products: ● “Creating the database” on page 42 ● “Preparing the application server” on page 48. You do not need to perform these tasks if you are performing a turnkey install.
Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Creating an Oracle database 43 MySQL user account The MySQL user account that you create requires these privileges to access the tables in the LiveCycle database: ● SELECT ● INSERT ● UPDATE ● DELETE ● CREATE ● DROP ● REFERENCES ● INDEX ● ALTER ● CREATE_TMP_TABLE ● LOCK_TABLES MySQL database server configuration To prevent issues from occurring when uploading large files to MySQL, you must set
Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Creating a DB2 database 44 The user name and password of the new user you create on the database is used again when you create the data source. For information about using Oracle 9i or 10g, see the Oracle 9i or 10g user documentation. Creating a DB2 database 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.
Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Configuring a DB2 database for concurrent usage 45 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 (“;”).
Adobe LiveCycle Installing and Configuring LiveCycle for JBoss Preparing Your Environment Creating a SQL Server database 46 Creating a SQL Server database You can create a SQL Server database that LiveCycle products will 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.
Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Creating a JMS database on SQL Server 47 12. Ensure that the default database is set to the database that you created in step 4 and that the default language is English. 13. Click the Database Access tab, select the database that you created in step 4 and, in the Permit in Database Role list, select public, and then click OK. 14. In the Confirm Password dialog box, select Blank Password and click OK. 15.
Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Preparing the application server 48 Preparing the application server You must install the application server that you will use to run LiveCycle products. You also need to perform some preliminary configuration on the application server. Installing JBoss Application Server If you are manually configuring JBoss for running LiveCycle products, you must download and install JBoss Application Server 3.2.5.
6 Configuring LiveCycle Products for Deployment This chapter describes how to configure LiveCycle products for deployment. This chapter assumes that you have installed LiveCycle products. If you have not installed the products, see “Installing LiveCycle Products” on page 35. The instance of Configuration Manager that is installed with one LiveCycle product can be used with all LiveCycle products.
Adobe LiveCycle Configuring LiveCycle Products for Deployment Installing and Configuring LiveCycle for JBoss 50 8. Ensure that only Configure and assemble LiveCycle products is selected, and then click Next. 9. On the Configure and Assemble products screen, click Next. 10. (Optional) On the Data Manager Module Configuration screen, if you are using SSL security on your application server, select Enable SSL and type the SSL credential password.
Adobe LiveCycle Configuring LiveCycle Products for Deployment Installing and Configuring LiveCycle for JBoss 51 13. (LiveCycle Forms, LiveCycle Form Manager, LiveCycle Workflow, LiveCycle Assembler) (Optional) On the Font Manager Module Configuration screen, select fonts for LiveCycle Forms to use in addition to the fonts that are included with the product. In the Fonts directory box, type the path or browse to the directory that contains the fonts to add, and then click Next.
Adobe LiveCycle Configuring LiveCycle Products for Deployment Installing and Configuring LiveCycle for JBoss 52 ● Output Type: The type of HTML output returned to the web browser. Select Full HTML to render the form within full HTML tags (a complete HTML page) or select Form Body to render the form within div tags (not a complete HTML page). ● Locale: The language to be used for validation messages sent to client devices, such as web browsers, as part of HTML transformations.
7 Manually Configuring JBoss This chapter describes how to manually configure the JBoss Application Server to prepare for the manual deployment of LiveCycle products. You can also automatically configure your application server, as part of the turnkey installation. (See “Installing LiveCycle Products Using the Turnkey Installation” on page 20.) You need to perform the following tasks: ● Modify various JBoss configuration files on the instance of JBoss that hosts LiveCycle products.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files 54 Modifying the JBoss configuration files You need to modify the following areas on the instance of JBoss that hosts LiveCycle products: ● endorsed directory ● run.bat file (Windows) or run.sh file (Linux) ● JMS ● jacorb.properties file ● EAR file class-loading isolation ● maximum threads settings ● dom4j.jar file ● cluster-service.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files 55 3. (Linux) In the run.sh file, locate the following text: # Execute the JVM "$JAVA" $JAVA_OPTS \ -classpath "$JBOSS_CLASSPATH" \ org.jboss.Main "$@" Replace the text with the following text: # Execute the JVM "$JAVA" $JAVA_OPTS -Xms128m -Xmx512m \ -classpath "$JBOSS_CLASSPATH" \ -Dorg.apache.lucene.writeLockTimeout=10000\ -Djava.endorsed.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files 56 java:/DefaultJMSProvider 3. (LiveCycle PDF Generator, LiveCycle Assembler) Navigate to the [appserver root]/server/all/deploy/jms directory and unpackage the jms-ra.rar file. 4.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files 57 5. (LiveCycle PDF Generator) Set 600 to an appropriate value for your system. To be applicable, this value must be higher than the value that will be configured at the Job Source (using Administrator after deployment). (See LiveCycle PDF Generator Administrator Help.) 6.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring JBoss for Watched Folder 58 Configuring JBoss for Watched Folder If you are deploying Watched Folder for use with LiveCycle Workflow and LiveCycle Assembler, you must perform the following procedure on the application server where LiveCycle Workflow and Watched Folder will be deployed. ➤ To configure JBoss for Watched Folder: ● Copy the jboss-watchedfolder-service.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the Oracle data source 59 ➤ To create the MySQL data source file: 1. Open a text editor and create a new text file using the following code: IDP_DS jdbc:mysql://host_name:port/database_name com.mysql.jdbc.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the DB2 data source 60 ➤ To obtain and copy the JDBC driver for Oracle 9i or 10g: 1. Obtain the ojdbc14.jar file appropriate for your database from the Oracle website at www.oracle.com/technology/software/index.html. 2. Copy the ojdbc14.jar file to the [appserver root]/server/all/lib directory. ➤ To create the Oracle data source file: 1.
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the SQL Server data source 61 ➤ To obtain and copy the JDBC driver for DB2: 1. Obtain the db2jcc.jar and db2jcc_license_cu.jar files from the DB2 installation directories. 2. Copy the files to the [appserver root]/server/all/lib directory. ➤ To create the DB2 data source file: 1. Open a text editor and create a new text file using the following code:
Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the SQL Server data source 62 ➤ To obtain and copy the JDBC driver for SQL Server: 1. Obtain and install SQL Server 2000 Driver for JDBC SP3 from the Microsoft website at www.microsoft.com/sql/downloads. 2. Copy the msbase.jar, mssqlserver.jar, and msutil.jar files from the C:\Program Files\Microsoft SQL Server 2000 Driver for JDBC\lib directory to the [appserver root]/server/all/lib directory.
8 Manually Deploying to JBoss This chapter describes how to deploy your LiveCycle products to JBoss: ● “About deploying LiveCycle products” on page 63 ● “Deploying to JBoss” on page 64 ● “Applying the connection pool patch for Watched Folder” on page 65 ● “Viewing log files” on page 65 About deploying LiveCycle products 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 directo
Adobe LiveCycle Manually Deploying to JBoss Installing and Configuring LiveCycle for JBoss Deploying to JBoss Component LiveCycle product LiveCycle.ear All adobe-Assembler7.ear LiveCycle Assembler mysql-connector-java-3.0.15-ga-bin.jar LiveCycle Assembler and LiveCycle PDF Generator FormsIVS.ear LiveCycle Forms pdfg-all.ear LiveCycle PDF Generator Professional and LiveCycle PDF Generator Elements pdfg-ps-all.ear LiveCycle PDF Generator for PostScript adobe-printSubmitter.
Adobe LiveCycle Manually Deploying to JBoss Installing and Configuring LiveCycle for JBoss Applying the connection pool patch for Watched Folder 65 8. (LiveCycle PDF Generator for PostScript) Copy the pdfg-ps-all.ear file from the [LiveCycle root]/configurationManager/export directory to the [appserver root]/server/all/deploy directory. 9. Restart JBoss to ensure that the applications start up. Note: When you start JBoss, you may see several error messages in the JBoss server log file.
9 Initializing the Database This chapter describes how to manually initialize the LiveCycle database. If you are using User Management with LiveCycle products, you must run Configuration Manager to initialize the database for integration with User Management. When you run Configuration Manager, the application server must be running. Initializing the database is a process that prepares a database for use with LiveCycle products by creating tables and optionally adding data to them.
Adobe LiveCycle Initializing the Database Installing and Configuring LiveCycle for JBoss 67 Next step You can now access User Management and Administrator. (See “Post-deployment” on page 26.) You can also configure LiveCycle products to access LDAP. (See “Configuring LiveCycle Products to Access LDAP” on page 68.) If you are using LiveCycle Workflow, you can now install LiveCycle Workflow Designer. (See “Installing LiveCycle Workflow Designer” on page 97.
10 Configuring LiveCycle Products to Access LDAP This chapter describes how to configure LiveCycle products with LDAP or LDAP over SSL (LDAPS). ● “Configuring LiveCycle products with LDAP” on page 68 ● “Configuring LiveCycle products with LDAPS” on page 69 Configuring LiveCycle products with LDAP Use the following procedure as a guideline when configuring User Management to support authentication using LDAP. ➤ To configure User Management with LDAP: 1.
Adobe LiveCycle Configuring LiveCycle Products to Access LDAP Installing and Configuring LiveCycle for JBoss Configuring LiveCycle products with LDAPS 69 Configuring LiveCycle products with LDAPS Use the following procedure as a guideline when configuring User Management to support authentication using LDAPS. ➤ To configure User Management with LDAPS: 1. Enable SSL on the directory server. For details, see the documentation provided by your directory vendor. 2.
Part III: Post-Deployment Configuration This section of the guide describes the additional configuration tasks that you need to perform after LiveCycle products are deployed to the application server and the LiveCycle database is initialized.
11 Configuring SSL on JBoss This chapter describes how to create SSL credentials and configure SSL on the application server to enhance the security of communication with your application server. The information in this chapter applies to both turnkey and manual installations. Note: It is recommended that you complete the installation, configuration and deployment of your LiveCycle products and ensure that the products are running correctly before configuring SSL on the application server.
Adobe LiveCycle Configuring SSL on JBoss Installing and Configuring LiveCycle for JBoss Creating an SSL Credential Keytool option Description Option value -keystore The location and name of the keystore file. [appserver_root]/server/all/svcnative/ads-ssl.jks 72 The location can include the absolute path of the file, or can be relative to the current directory of the command prompt where the keytool command is entered. -validity The number of days that the certificate is considered valid.
Adobe LiveCycle Configuring SSL on JBoss Installing and Configuring LiveCycle for JBoss Configuring SSL on JBoss 73 ➤ To create an SSL credential: 1. From a command prompt, navigate to [appserver_root]/server/all/svcnative. 2. Enter the following command: [JAVA_HOME]/bin/keytool -genkey -v -alias ads-credentials -keyalg RSA -keystore "ads-ssl.
Adobe LiveCycle Configuring SSL on JBoss Installing and Configuring LiveCycle for JBoss Configuring SSL on JBoss 74 3. In a text editor, open the server.xml file from the [appserver root]/server/all/deploy/jbossweb-tomcat50.sar directory, and then uncomment the following section: in the element with the password for the user name specified for the element. 5. Save the file as adobe-ds.xml in the [jboss bam root]/server/default/deploy/ directory.
Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Configuring required JBoss JVM options 82 Configuring required JBoss JVM options You must configure the Java virtual machine (JVM) to support BAM Server. ➤ To configure the JBoss JVM options: 1. Navigate to the [jboss bam root]/bin directory and open the startup script in a text editor: ● (Windows) run.bat ● (Linux) run.sh 2.
Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Optional JBoss JVM options 83 7. (Optional) Add a JAVA_OPTS setting to include optional JVM options: ● (Windows) set JAVA_OPTS=%JAVA_OPTS% [JVM options] ● (Linux) JAVA_OPTS="$JAVA_OPTS [JVM options] [JVM options] are the options that you want to include, in the format -Dcom.celequest.property.[PARAMETER]=[VALUE] For information on these options, see “Optional JBoss JVM options” on page 83. 8.
Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Modifying the JBoss thread configuration Parameter Description DECOMPOSITION The mode of collation decomposition. Valid values are none, canonical, and full. The default value is canonical. 84 For more information about collation parameters, see the Sun Java documentation at http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.
Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Configuring JBoss logging 85 Configuring JBoss logging Messages sent to Business Activity Monitor logs may also be recorded in the JBoss server.log file. By default, JBoss logs all of the messages published by BAM Server, in addition to its own messages and those of any other applications that it hosts. You can modify the JBoss log4j.
Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Customizing port numbers 86 Customizing port numbers You must modify the ports that JBoss uses so they do not conflict with ports in use by other applications on the host computer, such as the instance of JBoss that runs LiveCycle Workflow Server. ➤ To modify the ports: 1. Navigate to the [jboss bam root]/server/default/deploy/jbossweb-tomcat50.sar directory and open the server.
Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Deploying BAM Server 87 12. Change the rmi port to 11098: 11098 13. In the Invokers to the JMX node section, in the element , change the RMIObjectPort to 14444: 14444 14.
Part VI: Additional LiveCycle Workflow Configuration This section of the guide describes the additional configuration required for LiveCycle Workflow installations.
13 Getting Started with BAM Server This chapter describes how to perform the initial configuration of LiveCycle Workflow Server to enable BAM Server to monitor process activity. You must configure settings on both LiveCycle Workflow Server and BAM Server: ● “Configuring LiveCycle Workflow Server for BAM Server” on page 89 ● “Configuring BAM Server” on page 90 Configuring LiveCycle Workflow Server for BAM Server You can configure LiveCycle Workflow Server to connect to BAM Server using Administrator.
Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Accessing BAM Workbench and BAM Dashboard 90 Accessing BAM Workbench and BAM Dashboard After BAM Server is deployed and running on the application server, you can access BAM Workbench and Business Activity Monitor (BAM) Dashboard through a web browser. BAM Workbench includes tools for administering BAM Server and for setting up reports that users view in BAM Dashboard.
Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Importing LiveCycle Workflow metadata definitions 91 ➤ To configure the SMTP settings: 1. Ensure that the LiveCycle Workflow Server and the BAM Server applications are started. 2. Ensure that your BAM metadata database is started. 3. Start BAM Workbench by typing http://[host name]:[port]/celequest/workbench in the URL line of a web browser. 4.
Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 92 Configuring LDAP settings for BAM Server In addition to manually creating users and user permissions, Business Activity Monitor lets you to import user information from supported LDAP providers. You can schedule automatic synchronizations or perform manual synchronizations with the LDAP server to automatically update the existing users and roles.
Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 93 Configuring automatic LDAP synchronization You can schedule the automatic synchronization of BAM Server with the LDAP server. Synchronization ensures that the user accounts and role definitions that BAM Server caches in the BAM metadata database are up to date with the content of the LDAP server.
Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss ● Configuring LDAP settings for BAM Server 94 LDAP Principal DN Suffix: For the simple authentication method, the text you specify will be inserted after the user's login name: ● For LDAP servers that require DN login, set this to the appropriate chain of values. The first character of the suffix must be a comma (",").
Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 95 ● LDAP User LoginID: The login ID of the indicated provider. This value will become the user’s login ID in Business Activity Monitor. ● LDAP User Full Name: Enter cn if you are using either Sun ONE or Active Directory. ● LDAP User Description: Enter description if you are using either Sun ONE or Active Directory.
Adobe LiveCycle Installing and Configuring LiveCycle for JBoss Getting Started with BAM Server Configuring LDAP settings for BAM Server 96 5. Click the LDAP Synchronization tab and click Test Connection to see if the users are imported successfully. 6. Click OK. Manually synchronizing with the LDAP server You can manually synchronize BAM Server with the LDAP server at any time. Synchronization requests are queued to prevent concurrent synchronizations. ➤ To manually synchronize with the LDAP server: 1.
14 Installing LiveCycle Workflow Designer This chapter describes how to install LiveCycle Workflow Designer. Installing LiveCycle Workflow Designer You must run an installation program to install LiveCycle Workflow Designer and to configure a connection to LiveCycle Workflow Server. When you run the installation program, you need to provide the name of the server where LiveCycle Workflow Server is deployed. Before you install LiveCycle Workflow Designer, you must have J2SDK version 1.4.
Adobe LiveCycle Installing LiveCycle Workflow Designer Installing and Configuring LiveCycle for JBoss Connecting to application servers using non-default ports 98 Connecting to application servers using non-default ports The default configuration of LiveCycle Workflow Designer uses default JNDI and HTTP ports to connect to the application server. If the application server uses non-default port numbers, you must manually modify the LiveCycle Workflow Designer configuration file.
Adobe LiveCycle Installing and Configuring LiveCycle for JBoss Installing LiveCycle Workflow Designer Uninstalling LiveCycle Workflow Designer Next steps You can now deploy QPACs. (See the Creating Workflows guide or LiveCycle Workflow Designer Help.) If you have installed Watched Folder and LiveCycle Assembler, you can create workflows that involve Watched Folder using the LiveCycle Assembler QPACs. (See “Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder” on page 104.
A Supported Platform and Software Combinations This appendix provides the supported platforms and software combinations for LiveCycle products. For a summary of the platforms combinations, see “Before You Install” on page 11. Note: LiveCycle PDF Generator Elements and LiveCycle PDF Generator Professional run only on the Windows Server 2003 Enterprise Edition platform. Platform Application server JDK Database Windows Server 2003, Standard Edition JBoss 3.2.5 J2SDK version 1.4.
Adobe LiveCycle Supported Platform and Software Combinations Installing and Configuring LiveCycle for JBoss 101 Platform Application server JDK Database Red Hat Linux Advanced Server 2.1 Update 3 JBoss 3.2.5 J2SDK version 1.4.2_04 MS SQL Server 2000 SP3 JBoss 3.2.5 J2SDK version 1.4.2_04 MySQL 4.1 JBoss 3.2.5 J2SDK version 1.4.2_04 Oracle 9i JBoss 3.2.5 J2SDK version 1.4.2_04 Oracle 10g JBoss 3.2.5 J2SDK version 1.4.2_04 IBM DB2 8.2 (Version 8.1 Fix Pack 7) BEA WebLogic Server 8.
Adobe LiveCycle Supported Platform and Software Combinations Installing and Configuring LiveCycle for JBoss 102 Platform Application server JDK Database IBM AIX® 5.2 IBM WebSphere 5.1.1.5 IBM JDK installed with WebSphere Oracle 9i IBM WebSphere 5.1.1.5 IBM JDK installed with WebSphere Oracle 10g IBM WebSphere 5.1.1.5 IBM JDK installed with WebSphere IBM DB2 8.2 (Version 8.1 Fix Pack 7) IBM WebSphere 5.1.1.5 IBM JDK installed with WebSphere Oracle 9i IBM WebSphere 5.1.1.
B Fonts Installed with the Font Manager Module Some modules require access to fonts that are installed with the Font Manager Module. The Font Manager Module contains a number of bundled fonts that you can use in your custom applications. The Font Manager Module is not used when converting native documents into PDF documents or when converting PDF documents into some other format. You can add fonts to the Font Manager Module, which is subsequently packaged in the LiveCycle.ear file.
C Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder This appendix describes how to invoke LiveCycle Assembler through LiveCycle Workflow, using the LiveCycle Assembler QPACs and Watched Folder. This appendix assumes that you have installed, configured, and deployed LiveCycle Assembler, LiveCycle Workflow, and Watched Folder. Note: Watched folders can be implemented for use with LiveCycle PDF Generator, but need to be configured separately.
Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Deploying QPACs and creating a workflow process 105 Step Task See 6 Prepare the test or production collateral, which includes input PDF files and a DDX file. “Preparing PDF and DDX files” on page 112 Developing Applications for LiveCycle Assembler Document Description XML Reference 7 Submit the LiveCycle Assembler job for processing.
Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Configuring an Assembler QPAC in a workflow process 106 Configuring an Assembler QPAC in a workflow process When you create a new workflow process in LiveCycle Workflow Designer, you must create variables that will be used by the workflow process. When you add the Assembler QPAC to the workflow, you must set the action properties for the QPAC.
Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Type of workflow Configuring an Assembler QPAC in a workflow process Select on Input tab Using Watched Folder with a Use the Browse button to locate the static DDX file DDX file: Browse to the DDX file that you want to use. 107 Select on Output tab Output Document Map: Click the ellipsis button and select the variable.
Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Creating and configuring a watched folder 108 ➤ To create a workflow that includes an Assembler QPAC: 1. Deploy the Assembler QPAC to LiveCycle Workflow Designer. (See Using LiveCycle Assembler QPACs.) 2. In LiveCycle Workflow Designer, select File > New > Process Category. 3. Select the new process category and select File > New > Process Type. 4.
Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Creating a JobConfig.xml file 109 ➤ To create and configure a watched folder: 1. Create a directory to be a watched folder on your file system on your server. 2. Log into Administrator. 3. Click Services, click Watched Folder, and then click Watched Folder Management and Status. 4. Click New Watched Folder. 5.
Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Example C.1 Creating a JobConfig.xml file A JobConfig.xml file for a dynamic DDX file PAGE 111Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Creating a JobConfig.xml file 111 The content of the JobConfig.xml file maps to the variables and actions defined in the workflow process described in “Configuring an Assembler QPAC in a workflow process” on page 106. Node Description process-config The root of the job configuration file. process-type The name of the workflow process type.
Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Preparing PDF and DDX files 112 Preparing PDF and DDX files The PDF files included in the input directory or defined by the Assembler QPAC must correspond to the file pattern value defined for the source element in the DDX file.
D Developing Forms for LiveCycle This appendix provides information that is useful for form developers, including how to use WebDAV with LiveCycle Form Manager and which items LiveCycle products require for different types of forms. Publishing files from client software Form developers and form owners can use WebDAV-enabled client software to publish and access their files in the LiveCycle products repository used by LiveCycle Form Manager.
Adobe LiveCycle Developing Forms for LiveCycle Installing and Configuring LiveCycle for JBoss Using dynamic forms with LiveCycle products 114 Using dynamic forms with LiveCycle products Dynamic forms can expand or shrink to accommodate the amount of incoming data. Dynamic forms typically include buttons that request form data from LiveCycle Forms. LiveCycle Forms renders the form with the data and returns it to the client.
E Uninstalling LiveCycle Products This chapter describe how to uninstall the LiveCycle product files that were installed during a manual or turnkey installation. Removing the product files from a turnkey installation Each LiveCycle product that installed using the turnkey installation includes an uninstall program that you can use to remove the product from your computer. The uninstall program only removes the specified LiveCycle product.
Adobe LiveCycle Uninstalling LiveCycle Products Installing and Configuring LiveCycle for JBoss Removing the product files from a manual installation 116 Removing the product files from a manual installation The uninstall program located in the [product root] directory does not remove any files that you deployed to your application server or modules that are shared with other LiveCycle products.
F Enhancing Server Performance This appendix provides general tips that you can use to improve server performance when using LiveCycle products.
Adobe LiveCycle Enhancing Server Performance Installing and Configuring LiveCycle for JBoss Example F.1 Cleaning up temporary files in the Global storage directory 118 Calculating the JVM maximum heap size In this example, the current JVM maximum heap is set to 512 MB and the maximum inline size is 64 KB.
Adobe LiveCycle Enhancing Server Performance Installing and Configuring LiveCycle for JBoss Improving Windows Server Performance with LDAP 119 Improving Windows Server Performance with LDAP Using connection pooling on the search connection can decrease the number of ports need by as much as 50%, since that connection always uses the same credentials for a given domain, and the context and related objects are closed explicitly. ➤ To configure your Windows Server for connection pooling: 1. 1.
Index A accessing Administrator 26 BAM Workbench and BAM Dashboard 90 Installation Verification Sample application 28 LiveCycle database tables 43 LiveCycle Form Manager end-user pages 31 repository 113 User Management 27 action properties, Assembler QPAC 106 adding fonts for LiveCycle Forms to use 51 Adobe Administrator, accessing 26 Adobe LiveCycle Assembler deployment, verifying 27 installing 38 invoking 104 jobs, submitting for processing 112 Adobe LiveCycle database about initializing 11 connecting JBo
Adobe LiveCycle Index Installing and Configuring LiveCycle for JBoss configuring See also installing about 11 application server 53 BAM Server 90 DB2 data source for JBoss 60 DB2 database for concurrent usage 45 JBoss for BAM Server 77 JBoss for Watched Folder 58 JBoss JVM 82 job sources 31 LiveCycle products for deployment 49 LiveCycle Workflow for BAM Server 89 MySQL data source for JBoss 58 Oracle data source for JBoss 59 SQL Server data source for JBoss 61 SSL on JBoss 71, 73 User Management with LDAP
Adobe LiveCycle Index Installing and Configuring LiveCycle for JBoss installing See also configuring about 11 applications to JBoss 64 database drivers for BAM Server 77 fonts used in converted documents 32 JBoss 48, 76 LiveCycle products for manual deployment 38 LiveCycle Workflow Designer 97 multiple LiveCycle products 12 using manual method 35 using turnkey method 20 J jacorb.properties file, modifying 56 JAR files, updating dom4.
Adobe LiveCycle Index Installing and Configuring LiveCycle for JBoss 123 Q T QPACs creating 10 deploying 105 thread configuration, JBoss, modifying 84 thread settings, maximum, modifying 56 turnkey installation about 12 checklist 16 running 20 uninstalling 115 R removing.
