1. Manuals
  2. Brands
  3. Adobe Manuals
  4. Software
  5. LIVE CYCLE 7.2 - INSTALLING AND CONFIGURING LIVECYCLE FOR...
  6. Manual

Adobe LIVE CYCLE 7.2 - INSTALLING AND CONFIGURING LIVECYCLE FOR JBOSS Manual

Hide thumbs Also See for LIVE CYCLE 7.2 - INSTALLING AND CONFIGURING LIVECYCLE FOR JBOSS:
Table of Contents

Advertisement

Quick Links

Download this manual
Installing and Configuring
LiveCycle for JBoss
Adobe
LiveCycle
®
™
October 2006
Version 7.2

Advertisement

Table of Contents
loading

Related Manuals for Adobe LIVE CYCLE 7.2 - INSTALLING AND CONFIGURING LIVECYCLE FOR JBOSS

Summary of Contents for Adobe LIVE CYCLE 7.2 - INSTALLING AND CONFIGURING LIVECYCLE FOR JBOSS

  • Page 1 Installing and Configuring LiveCycle for JBoss Adobe LiveCycle ® ™ October 2006 Version 7.2...
  • Page 2 © 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.
  • Page 3 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.

  • Page 4: Table Of Contents

    Contents Preface ............................8 What’s in this guide? ..................................8 Who should read this guide? ..............................8 Conventions used in this guide..............................8 Related documentation ................................9 Updated LiveCycle product information........................10 Before You Install ........................11 About the installation, configuration, and deployment process................11 Methods for installing, configuring, and deploying LiveCycle products..............12 Upgrading LiveCycle products..............................12 About Watched Folder installation............................13...
  • Page 5 Adobe LiveCycle Contents Installing and Configuring LiveCycle for JBoss Post-deployment (Continued) LiveCycle PDF Generator post-deployment tasks ......................31 Setting up job sources .................................31 Setting Adobe PDF Printer as the default printer ......................31 Installing fonts..................................32 Setting the LiveCycle PDF Generator conversion time-out..................32 Part II: Manual Installation, Configuration and Deployment Installing LiveCycle Products....................
  • Page 6 Adobe LiveCycle Contents Installing and Configuring LiveCycle for JBoss Part III: Post-Deployment Configuration 11 Configuring SSL on JBoss......................71 Creating an SSL Credential ...............................71 Configuring SSL on JBoss .................................73 12 Manually Configuring JBoss for BAM Server................76 Installing JBoss Application Server ............................76 Creating the BAM metadata database ..........................76 User accounts ..................................76 Configuring JBoss for BAM Server............................77...
  • Page 7 Adobe LiveCycle Contents Installing and Configuring LiveCycle for JBoss D Developing Forms for LiveCycle.....................113 Publishing files from client software..........................113 Designing forms for LiveCycle products........................... 113 Using dynamic forms with LiveCycle products......................114 Embedding fonts in PDF/A-compliant forms ......................114 Uninstalling LiveCycle Products.....................115 Removing the product files from a turnkey installation .....................

  • Page 8: Preface

    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. What’s in this guide? This guide provides information about how to install and configure the following LiveCycle products on Microsoft®...

  • Page 9: Related Documentation

    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 C:\Adobe\LiveCycle\Assembler (such as documentation, uninstall C:\Adobe\LiveCycle\pdfgenerator files, samples, and license C:\Adobe\LiveCycle\Workflow information) are located. C:\Adobe\LiveCycle\Forms C:\Adobe\LiveCycle\Print C:\Adobe\LiveCycle\Formmanager Linux:...

  • Page 10: Updated Livecycle Product Information

    Adobe LiveCycle Preface Installing and Configuring LiveCycle for JBoss Updated LiveCycle product information For information about The EJB API, including descriptions and The API Reference for each product. Most API explanations of its classes and methods. References are installed as JavaDocs with each product.

  • Page 11: Before You Install

    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 ●...

  • Page 12: Methods For Installing, Configuring, And Deploying Livecycle Products

    Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Methods for installing, configuring, and deploying LiveCycle products 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 and other components and automatically performs...

  • Page 13: About Watched Folder Installation

    Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss About Watched Folder installation 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.
  • Page 14 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) Note: Your application server must have an active Internet connection to access LiveCycle Administrator.

  • Page 15: Platform And Software Combinations

    Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Platform and software combinations 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”...

  • Page 16: Additional Requirements For Livecycle Pdf Generator For Postscript

    Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Additional requirements for LiveCycle PDF Generator for PostScript 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. LiveCycle PDF Generator Elements and LiveCycle PDF Generator Professional can be extended to convert these additional file types to PDF files using the following applications: Microsoft Office 2000, XP, or 2003...

  • Page 17: Manual Installation And Deployment Checklist

    Adobe LiveCycle Before You Install Installing and Configuring LiveCycle for JBoss Manual installation and deployment checklist 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...

  • Page 18: Updated Livecycle Product Information

    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...

  • Page 19: Part I: Turnkey Installation

    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...

  • Page 20: Installing Livecycle Products Using The Turnkey Installation

    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 ●...
  • Page 21 Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation The turnkey installation creates the following Windows services: JBoss for Adobe LiveCycle ● MySQL for Adobe LiveCycle ● (LiveCycle Workflow) JBoss for Adobe LiveCycle Workflow BAM ●...
  • Page 22 Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation 12. Review the installation details, and then click Install. A summary screen appears when the product installation is completed. 13. On the summary screen, you have the following options: If you are installing only one LiveCycle product or this is the last LiveCycle product you are installing, ●...
  • Page 23 Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation 29. On the Database Initialization screen, click Initialize Database Now to connect your LiveCycle products to the database, and then click Next. 30.
  • Page 24 Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Running the turnkey installation 12. Read the license information associated with installing MySQL, select I accept the terms of the license agreement, and then click Next. 13.

  • Page 25: Modifying Livecycle Services

    Adobe LiveCycle Installing LiveCycle Products Using the Turnkey Installation Installing and Configuring LiveCycle for JBoss Modifying LiveCycle Services 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.

  • Page 26: Post-Deployment

    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 ●...

  • Page 27: Accessing User Management

    Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Accessing User Management 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. User Management provides authentication, authorization, and user management for LiveCycle products, including LiveCycle PDF Generator, LiveCycle Assembler, LiveCycle Form Manager, LiveCycle Forms, and LiveCycle Workflow.

  • Page 28: Livecycle Forms Post-Deployment Tasks

    Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss LiveCycle Forms post-deployment tasks 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.

  • Page 29: Deploying And Running The Printivs Web Application

    Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Deploying and running the PrintIVS web application 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.

  • Page 30: Running The Form Server Module Api Print Application

    Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Running the Form Server Module API Print application 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.

  • Page 31: Livecycle Form Manager Post-Deployment Tasks

    Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss LiveCycle Form Manager post-deployment tasks LiveCycle Form Manager post-deployment tasks This section describes the post-deployment tasks specific to LiveCycle Form Manager. Accessing the LiveCycle Form Manager end-user pages After you configure User Management to connect to your organization’s LDAP server, users can access the LiveCycle Form Manager end-user pages by going to the following URL: http://[host name]:[port]/fm The default port number for JBoss is 8080.

  • Page 32: Installing Fonts

    Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Installing fonts 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.
  • Page 33 Adobe LiveCycle Post-deployment Installing and Configuring LiveCycle for JBoss Setting the LiveCycle PDF Generator conversion time-out ➤ 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 ●...

  • Page 34: Part Ii: Manual Installation, Configuration And Deployment

    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...

  • Page 35: Installing Livecycle Products

    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.

  • Page 36: Installing Livecycle Pdf Generator

    Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle PDF Generator 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.
  • Page 37 Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle PDF Generator ➤ 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. ●...

  • Page 38: Installing Livecycle Products

    Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle products 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.

  • Page 39: Installing Livecycle Print

    Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing LiveCycle Print 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.

  • Page 40: Installing Watched Folder

    Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Installing Watched Folder 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.

  • Page 41: Viewing The Error Log

    Adobe LiveCycle Installing LiveCycle Products Installing and Configuring LiveCycle for JBoss Viewing the error log 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.

  • Page 42: Preparing Your Environment

    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 ●...

  • Page 43: Creating An Oracle Database

    Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Creating an Oracle database MySQL user account The MySQL user account that you create requires these privileges to access the tables in the LiveCycle database: SELECT ● INSERT ● UPDATE ●...

  • Page 44: Creating A Db2 Database

    Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Creating a DB2 database 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.

  • Page 45: Configuring A Db2 Database For Concurrent Usage

    Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Configuring a DB2 database for concurrent usage 2. Make the following changes to the script: Replace the instances of with the name that you want for the LiveCycle dbname DBNAME ●...

  • Page 46: Creating A Sql Server Database

    Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Creating a SQL Server database 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.
  • Page 47 Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Creating a JMS database on SQL Server 12. Ensure that the default database is set to the database that you created in step and that the default language is English. 13.

  • Page 48: Preparing The Application Server

    Adobe LiveCycle Preparing Your Environment Installing and Configuring LiveCycle for JBoss Preparing the application server 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.

  • Page 49: Configuring Livecycle Products For Deployment

    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 The instance of Configuration Manager that is installed with one LiveCycle product can be used with all LiveCycle products.
  • Page 50 Adobe LiveCycle Configuring LiveCycle Products for Deployment Installing and Configuring LiveCycle for JBoss 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.
  • Page 51 Adobe LiveCycle Configuring LiveCycle Products for Deployment Installing and Configuring LiveCycle for JBoss 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.
  • Page 52 Adobe LiveCycle Configuring LiveCycle Products for Deployment Installing and Configuring LiveCycle for JBoss 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).

  • Page 53: Manually Configuring Jboss

    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.

  • Page 54: Modifying The Jboss Configuration Files

    Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files 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) ●...
  • Page 55 Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files 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"...
  • Page 56 Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files <config-property type="java.lang.String" name="JmsProviderAdapterJNDI">java:/DefaultJMSProvider </config-property> </tx-connection-factory> 3. (LiveCycle PDF Generator, LiveCycle Assembler) Navigate to the [appserver root]/server/all/deploy/jms directory and unpackage the jms-ra.rar file. 4. (LiveCycle PDF Generator, LiveCycle Assembler) Navigate to the [appserver root]/server/all/deploy/jms/META-INF directory and open the ra.xml file in a text editor.
  • Page 57 Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Modifying the JBoss configuration files 5. (LiveCycle PDF Generator) Set <attribute name=”Transaction to an appropriate value for your system. To be applicable, this value Timeout”>600</attribute> must be higher than the value that will be configured at the Job Source (using Administrator after deployment).

  • Page 58: Configuring Jboss For Watched Folder

    Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring JBoss for Watched Folder 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.

  • Page 59: Configuring The Oracle Data Source

    Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the Oracle data source ➤ To create the MySQL data source file: 1. Open a text editor and create a new text file using the following code: <?xml version="1.0" encoding="UTF-8"?> <datasources>...

  • Page 60: Configuring The Db2 Data Source

    Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the DB2 data source ➤ 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.

  • Page 61: Configuring The Sql Server Data Source

    Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the SQL Server data source ➤ 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. ➤...
  • Page 62 Adobe LiveCycle Manually Configuring JBoss Installing and Configuring LiveCycle for JBoss Configuring the SQL Server data source ➤ 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.

  • Page 63: Manually Deploying To Jboss

    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 ●...

  • Page 64: Deploying To Jboss

    Adobe LiveCycle Manually Deploying to JBoss Installing and Configuring LiveCycle for JBoss Deploying to JBoss Component LiveCycle product LiveCycle.ear 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.ear...

  • Page 65: Applying The Connection Pool Patch For Watched Folder

    Adobe LiveCycle Manually Deploying to JBoss Installing and Configuring LiveCycle for JBoss Applying the connection pool patch for Watched Folder 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.

  • Page 66: Initializing The Database

    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.
  • Page 67 Adobe LiveCycle Initializing the Database Installing and Configuring LiveCycle for JBoss 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”...

  • Page 68: Configuring Livecycle Products To Access Ldap

    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.

  • Page 69: Configuring Livecycle Products With Ldaps

    Adobe LiveCycle Configuring LiveCycle Products to Access LDAP Installing and Configuring LiveCycle for JBoss Configuring LiveCycle products with LDAPS Configuring LiveCycle products with LDAPS Use the following procedure as a guideline when configuring User Management to support authentication using LDAPS. ➤...

  • Page 70: Part Iii: Post-Deployment Configuration

    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.

  • Page 71: Configuring Ssl On Jboss

    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...
  • Page 72 Adobe LiveCycle Configuring SSL on JBoss Installing and Configuring LiveCycle for JBoss Creating an SSL Credential Keytool option Description Option value The location and name of the [appserver_root]/server/all/svcnative/ads-ssl.jks -keystore keystore file. 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...

  • Page 73: Configuring Ssl On Jboss

    Adobe LiveCycle Configuring SSL on JBoss Installing and Configuring LiveCycle for JBoss Configuring SSL on JBoss ➤ 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.jks"...
  • Page 74 Adobe LiveCycle Configuring SSL on JBoss Installing and Configuring LiveCycle for JBoss Configuring SSL on JBoss 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: <!-- SSL/TLS Connector configuration using the SSL domain keystore <Connector port="8443"...
  • Page 75 Adobe LiveCycle Configuring SSL on JBoss Installing and Configuring LiveCycle for JBoss Configuring SSL on JBoss 10. Save the iiop-service.xml file. 11. Restart the application server. 12. To access Administrator using SSL, type the following URL in a web browser: https://[host name]:[port]/adminui The default port for JBoss is 8443.

  • Page 76: Manually Configuring Jboss For Bam Server

    Manually Configuring JBoss for BAM Server This chapter applies to LiveCycle Workflow licenses that permit the use of Business Activity Monitor only. This chapter describes how to create the LiveCycle Workflow Business Activity Monitor metadata database and configure the JBoss application server for BAM Server, which is a component of LiveCycle Workflow. If you are installing the products using the turnkey method, JBoss and MySQL are installed and configured automatically and you do not need to perform the procedures in this chapter.

  • Page 77: Configuring Jboss For Bam Server

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Configuring JBoss for BAM Server Configuring JBoss for BAM Server If you are installing LiveCycle Workflow and manually deploying to JBoss, you must manually install and configure JBoss for BAM Server to run correctly.

  • Page 78: Connecting Jboss To The Bam Metadata Database

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Connecting JBoss to the BAM metadata database Connecting JBoss to the BAM metadata database You must configure a connection to the Business Activity Monitor metadata database on the instance of JBoss that runs BAM Server so that it can retrieve information about the process metrics that it monitors.
  • Page 79 Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Connecting JBoss to the BAM metadata database ➤ To modify the SQL Server data-type mappings on JBoss: 1. Navigate to the [jboss bam root]/server/default/conf directory and open the standardjbosscmp-jdbc.xml file in a text editor.

  • Page 80: Connecting Jboss For Bam Server To The Livecycle Database

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Connecting JBoss for BAM Server to the LiveCycle database Connecting JBoss for BAM Server to the LiveCycle database You must configure a connection to the LiveCycle database on the instance of JBoss that runs BAM Server so that it can retrieve information about the process run-time data.
  • Page 81 Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Connecting JBoss for BAM Server to the LiveCycle database 4. Replace in the element with the password for the user <!--Insert dbPassword --> <password> name specified for the element.

  • Page 82: Configuring Required Jboss Jvm Options

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Configuring required JBoss JVM options Configuring required JBoss JVM options You must configure the Java virtual machine (JVM) to support BAM Server. ➤ To configure the JBoss JVM options: 1.

  • Page 83: Optional Jboss Jvm Options

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Optional JBoss JVM options 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] ● are the options that you want to include, in the format [JVM options] -Dcom.celequest.property.[PARAMETER]=[VALUE]...

  • Page 84: Modifying The Jboss Thread Configuration

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Modifying the JBoss thread configuration Parameter Description The mode of collation decomposition. Valid values are , and DECOMPOSITION none canonical . The default value is full canonical For more information about collation parameters, see the Sun Java documentation at...

  • Page 85: Configuring Jboss Logging

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Configuring JBoss logging 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.

  • Page 86: Customizing Port Numbers

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Customizing port numbers 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.

  • Page 87: Deploying Bam Server

    Adobe LiveCycle Manually Configuring JBoss for BAM Server Installing and Configuring LiveCycle for JBoss Deploying BAM Server 12. Change the rmi port to 11098 <attribute name="RmiPort">11098</attribute> 13. In the section, in the element Invokers to the JMX node <mbean code="org.jboss.invocation.pooled.server.PooledInvoker"name="jboss:service , change the RMIObjectPort to =invoker,type=pooled">...

  • Page 88: Part Vi: Additional Livecycle Workflow Configuration

    Part VI: Additional LiveCycle Workflow Configuration This section of the guide describes the additional configuration required for LiveCycle Workflow installations.

  • Page 89: Getting Started With Bam Server

    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 ●...

  • Page 90: Accessing Bam Workbench And Bam Dashboard

    Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Accessing BAM Workbench and BAM Dashboard 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.

  • Page 91: Importing Livecycle Workflow Metadata Definitions

    Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Importing LiveCycle Workflow metadata definitions ➤ 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.

  • Page 92: Configuring Ldap Settings For Bam Server

    Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 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.
  • Page 93 Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 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.
  • Page 94 Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 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.
  • Page 95 Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 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 if you are using either Sun ONE or Active Directory.
  • Page 96 Adobe LiveCycle Getting Started with BAM Server Installing and Configuring LiveCycle for JBoss Configuring LDAP settings for BAM Server 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.

  • Page 97: Installing Livecycle Workflow Designer

    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.

  • Page 98: Connecting To Application Servers Using Non-Default Ports

    Adobe LiveCycle Installing LiveCycle Workflow Designer Installing and Configuring LiveCycle for JBoss Connecting to application servers using non-default ports 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.
  • Page 99 Adobe LiveCycle Installing LiveCycle Workflow Designer Installing and Configuring LiveCycle for JBoss 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.

  • Page 100: Supported Platform And Software Combinations

    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 Note: LiveCycle PDF Generator Elements and LiveCycle PDF Generator Professional run only on the Windows Server 2003 Enterprise Edition platform.
  • Page 101 Adobe LiveCycle Supported Platform and Software Combinations Installing and Configuring LiveCycle for JBoss Platform Application server Database Red Hat Linux JBoss 3.2.5 J2SDK version 1.4.2_04 MS SQL Server 2000 SP3 Advanced Server JBoss 3.2.5 J2SDK version 1.4.2_04 MySQL 4.1 2.1 Update 3 JBoss 3.2.5 J2SDK version 1.4.2_04 Oracle 9i...
  • Page 102 Adobe LiveCycle Supported Platform and Software Combinations Installing and Configuring LiveCycle for JBoss Platform Application server Database IBM AIX® 5.2 IBM WebSphere 5.1.1.5 IBM JDK installed with Oracle 9i WebSphere IBM WebSphere 5.1.1.5 IBM JDK installed with Oracle 10g WebSphere IBM WebSphere 5.1.1.5 IBM JDK installed with IBM DB2 8.2...

  • Page 103: Fonts Installed With The Font Manager Module

    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.

  • Page 104: Invoking Livecycle Assembler Using Livecycle Workflow And Watched Folder

    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.

  • Page 105: Deploying Qpacs And Creating A Workflow Process

    Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Deploying QPACs and creating a workflow process Step Task Prepare the test or production collateral, which “Preparing PDF and DDX files” on page 112 includes input PDF files and a DDX file.

  • Page 106: Configuring An Assembler Qpac In A Workflow Process

    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 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.
  • Page 107 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 Type of workflow Select on Input tab Select on Output tab Using Watched Folder with a Use the Browse button to locate the Output Document Map: Click static DDX file...

  • Page 108: Creating And Configuring A Watched Folder

    Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Creating and configuring a watched folder ➤ To create a workflow that includes an Assembler QPAC: 1. Deploy the Assembler QPAC to LiveCycle Workflow Designer. (See Using LiveCycle Assembler QPACs.) 2.

  • Page 109: Creating A Jobconfig.xml File

    Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Creating a JobConfig.xml file ➤ To create and configure a watched folder: 1. Create a directory to be a watched folder on your file system on your server. 2.
  • Page 110 Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Creating a JobConfig.xml file Example C.1 A JobConfig.xml file for a dynamic DDX file <?xml version="1.0" encoding="UTF-8"?> <process-config xmlns="http://adobe.com/watchedfolder" xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance" xsi:schemaLocation="http://adobe.com/watchedfolder C:\WatchedFolder\schemas\JobConfiguration.xsd"> <process-type>myworkflow</process-type>...
  • Page 111 Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Creating a JobConfig.xml file 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”...

  • Page 112: Preparing Pdf And Ddx Files

    Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder Installing and Configuring LiveCycle for JBoss Preparing PDF and DDX files 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 element in the DDX file.

  • Page 113: D Developing Forms For Livecycle

    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.

  • Page 114: Using Dynamic Forms With Livecycle Products

    Adobe LiveCycle Developing Forms for LiveCycle Installing and Configuring LiveCycle for JBoss Using dynamic forms with LiveCycle products 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.

  • Page 115: Uninstalling Livecycle Products

    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.

  • Page 116: Removing The Product Files From A Manual Installation

    Adobe LiveCycle Uninstalling LiveCycle Products Installing and Configuring LiveCycle for JBoss Removing the product files from a manual installation 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.

  • Page 117: Enhancing Server Performance

    Enhancing Server Performance This appendix provides general tips that you can use to improve server performance when using LiveCycle products. Optimizing inline documents and impact on JVM memory If you are typically processing documents of a relatively small size, you can improve the performance associated with the document transfer speed and storage space by implementing the following LiveCycle product configurations: Increase the maximum inline size for LiveCycle products so that it is larger than the size of most...

  • Page 118: Cleaning Up Temporary Files In The Global Storage Directory

    Adobe LiveCycle Enhancing Server Performance Installing and Configuring LiveCycle for JBoss Cleaning up temporary files in the Global storage directory Example F.1 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. The server needs to be configured for the scenario where 10 jobs are run simultaneously, and each job has 9 input files and 1 result file (a total of 10 files per job, and 100 files processed simultaneously).

  • Page 119: Improving Windows Server Performance With Ldap

    Adobe LiveCycle Enhancing Server Performance Installing and Configuring LiveCycle for JBoss Improving Windows Server Performance with LDAP 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.

  • Page 120: Index

    Index Adobe LiveCycle Workflow Business Activity Monitor. See BAM entries accessing Adobe LiveCycle Workflow Designer Administrator 26 configuration file, modifying 98 BAM Workbench and BAM Dashboard 90 installing 97 Installation Verification Sample application 28 JNDI and HTTP ports 98 LiveCycle database tables 43 uninstalling 98 LiveCycle Form Manager end-user pages 31 Adobe PDF Printer, setting as default 31...
  • Page 121 Adobe LiveCycle Index Installing and Configuring LiveCycle for JBoss configuring deploying See also installing about 11, 63 about 11 BAM Server to JBoss 87 application server 53 LiveCycle Assembler sample 27 BAM Server 90 multiple LiveCycle products 12 DB2 data source for JBoss 60 PrintIVS web application 29 DB2 database for concurrent usage 45 to JBoss 64...
  • Page 122 Adobe LiveCycle Index Installing and Configuring LiveCycle for JBoss installing See also configuring LDAP about 11 configuring for BAM Server 92 applications to JBoss 64 configuring User Management with 68 database drivers for BAM Server 77 improving Windows Server performance with 119 fonts used in converted documents 32 server support 14 JBoss 48, 76...
  • Page 123 Adobe LiveCycle Index Installing and Configuring LiveCycle for JBoss QPACs thread configuration, JBoss, modifying 84 creating 10 thread settings, maximum, modifying 56 deploying 105 turnkey installation about 12 checklist 16 running 20 removing. See uninstalling uninstalling 115 repository, accessing using WebDAV clients 113 role mapping, LDAP, configuring 95 run files, modifying 54 uninstalling...

This manual is also suitable for:

Livecycle for jboss

Table of Contents