Configuring Adobe Experience Manager Forms on JEE on JBoss

148 Pages·2016·1.06 MB·English

by  Adobe Systems

Configuring Adobe Experience
Manager Forms on JEE on JBoss
Cluster
AEM 6.2 Forms
Legal notices
For legal notices, see http://help.adobe.com/en_US/legalnotices/index.html.
Last updated 4/21/16
Contents
About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Who should read this document? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Conventions used in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Introduction to Installation, Configuration, and Deployment Process . . . . . . . . . . . . . 4
Installation, configuration, and deployment overview . . . . . . . . . . . . . . . . . . . . . . . 4
Selecting tasks for configuring and deploying . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
AEM Forms on JEE installation and deployment list . . . . . . . . . . . . . . . . . . . . . . . 5
Configuring JBoss in a Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Preparing to install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installing JBoss Application Server software . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Installing JBoss Application Server for a horizontal cluster 8
Installing JBoss Application Server for a vertical cluster 8
Configuring Windows services for JBoss Application Servers 8
To start JBoss Application Server as a Windows service: 8
To stop JBoss Application Server as a Windows service: 8
Modifying the JBoss domain.conf file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
To modify the JBoss domain.conf file: 9
Configuring Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Configuring interface on the master node 11
Configuring interface for the slave nodes 12
Set up authentication between master and slave nodes 13
Add a user on the master node 13
Registering slave nodes to the mater node as users 14
Configure slave nodes for authentication 14
Edit the host.xml file to remove information of extra servers 14
i
About JVM Arguments 15
Configuring AEM Forms database connectivity . . . . . . . . . . . . . . . . . . . . . . . . . .16
Configuring Oracle for Adobe-preconfigured JBoss 16
Configuring the data source files 17
Configuring SQL Server for Adobe-preconfigured JBoss 17
Configuring the data source files 17
Configuring MySQL for Adobe pre-configured JBoss 18
Configuring the data source files 19
Running JBoss in a cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Start the JBoss 20
Changing the Multicast address 20
Changing the MultiCast port 21
Testing the JBoss Application Server cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
To test the JBoss Application Server cluster: 21
Installing AEM Forms modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Installation overview 23
Checking the installer 23
Check the DVD installation media 23
Check the downloaded files 24
Expand the downloaded archive files 24
Identify the version of configured CRX repository 24
Installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
Installation paths 24
Temporary directories 25
Installing on a Windows staging platform for Linux or UNIX 25
Configuring the JAVA_HOME environment variable 26
General installation notes 26
Installing AEM Forms on JEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Configuring the caching locators in clusters (caching using TCP only) . . . . . . . . . . . . .28
Modifying TCP locators 29
Install TCP locators 29
Modify the default locator port (Windows) 29
Modify the default locator port (UNIX) 30
Start the TCP locators 31
Stop TCP locators 31
Global Document Storage Directory (GDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Installing the font directories in cluster nodes . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Next steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Configuring AEM Forms for deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Considerations when configuring and deploying AEM Forms on JEE . . . . . . . . . . . . . .33
General Considerations 33
CLI versus GUI versions of Configuration Manager 34
ii
Considerations for JBoss application server 34
Considerations while configuring AEM Forms on JEE Server Clusters 35
Set the date, time, and time zone 35
Considerations for upgrading repository 35
AEM Forms on JEE pre-configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Configuring and deploying AEM Forms on JEE . . . . . . . . . . . . . . . . . . . . . . . . . .36
Configuring AEM Forms on JEE 36
Configure CRX 37
(Remote host only) CRX Configuration Summary 38
Configuring Acrobat for PDF Generator 38
Configuration Summary 39
Copy CRX Content 39
Deploying Adobe Experience Manager Forms EARs 39
Initializing Adobe Experience Manager Forms database 40
Deploying Central Migration Bridge Service 41
Deploying Adobe Experience Manager Forms components 41
Configuring Adobe Experience Manager Forms components 42
Connector for EMC Documentum 42
Connector for IBM Content Manager 42
Connector for IBM FileNet 43
Connector for Microsoft SharePoint 43
Configuring Adobe Experience Manager Forms Server for native file conversions 44
System readiness test for PDF Generator 44
Configuring Acrobat Reader DC extensions 44
Summary, and Next Steps 44
Post-deployment tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
General tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
Install Microsoft Visual C++ redistributable library 46
Configure Allowed Referers 46
Configure the serialization agent 47
Perform a system image backup 47
Configure URL and port number for client SDK 48
Restart the application server 48
Verify the deployment 48
Accessing administration console 48
Change the default password of AEM forms on JEE Administrator 49
Change the default password of AEM Administrators 49
Accessing AEM Welcome Page 50
Accessing OSGi Management Console 51
View the log files 51
Verify the AEM Forms cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Accessing module web applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Access the Acrobat Reader DC extensions web application 53
Access Workspace 53
Access HTML Workspace 53
iii
Access forms manager 53
Access PDF Generator Web Application 53
Access Document Security 54
Access the Document Security end-user web application 54
Access the Document Security administration web application 54
Assign the Document Security End User role 54
Accessing User Management 54
Configure Author and Publish instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Configure the Author instance 55
Configure the Publish instance 55
If MongoMK is selected as CRX Repository type in the Configuration Manager 55
If RDBMK is selected as CRX Repository type in the Configuration Manager 56
Configure the Publish Node 56
Communicating between the Author and Publish instances 57
Define Publish instance URL 57
Define publish instance URL for ActivationManagerImpl 57
Configure reverse replication queue 58
Define author instance URL 58
Configure IPv6 implementation 58
Install Japanese fonts for Adobe Reader 59
Configuring PDF Generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
Environment variables 59
Create a new Windows environment variable 60
Set the PATH variables on Linux or UNIX (OpenOffice only) 60
Configuring the application server to use HTTP proxy server 60
Setting the Adobe PDF Printer as the default printer 61
Set the default printer 61
Configuring Acrobat Professional (Windows-based Computers Only) 61
Configure Acrobat for use with PDF Generator 61
Validate the Acrobat installation 62
Configure native application support 62
Add temporary directories to trusted directories list in Acrobat 62
Adding fonts to PDF Generator 63
Non-AEM Forms on JEE applications 63
Adding new fonts to Windows applications only 64
Adding new fonts to other applications 64
Configuring HTML to PDF conversions 64
Configure the HTML-to-PDF conversion 64
Enable support for Unicode fonts in HTML to PDF conversions 64
Installing the Network Printer Client 66
Install the PDF Generator Network Printer Client 66
Configure PDFG Network Printer on Windows using the native Add Printer wizard
67
Install and configure the PDF Generator Network Printer Client using Proxy server
port forwarding 67
Changing File Block Settings 68
iv
Watched folder performance parameters 68
Set performance parameters for PDF Generator 68
Enable PDF Conversion for Microsoft Word document containing protected fields 69
Final setup for Document Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Configuring LDAP access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Configure User Management (Local Domain) 69
Configure User Management with LDAP (Enterprise Domain) 70
Enabling FIPS mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Turn FIPS mode on or off 71
Configuring HTML digital signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Configuring Connector for EMC Documentum . . . . . . . . . . . . . . . . . . . . . . . . . .72
Configure Connector for EMC Documentum 72
Creating the XDP MIME format in a Documentum repository 76
Create the XDP format on Documentum Content Server using Documentum Ad-
ministrator 76
Configure the Connector for EMC Documentum service to use a Documentum Ad-
ministrator 76
Add support for multiple connection brokers 77
Configuring the Connector for IBM Content Manager . . . . . . . . . . . . . . . . . . . . . .77
Configure Connector for IBM Content Manager 78
Connect using Use Credentials from process context login mode 80
Configuring the Connector for IBM FileNet . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
Enable messaging on standalone JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
Disable Draft and Submission workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
Content reference to: Uninstalling
Document Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
Configuring Load Balancing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
HTTP Connector Based Load Balancing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
Using mod_proxy 89
Using mod_headers 89
Using JSESSIONID 90
AJP Connector Based Load Balancing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
Using mod_jk 91
Using mod_proxy_ajp 93
Advanced Production Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Configuring pool size for Output and Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
Modify the existing PoolMax value 95
PDF Generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
Configuring EJB Pool Size 96
Configure the pool size for PS2PDF and Image2PDF 96
Enabling CIFS on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Enable NetBIOS over TCP/IP 97
Add additional IP addresses 97
v
Disable File and Printer Sharing on Windows Server 2008 97
Disable File and Printer Sharing on Windows Server 2012 only) 97
Appendix - Install Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
Install AEM Forms on JEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
Error logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Uninstalling AEM Forms on JEE in console mode . . . . . . . . . . . . . . . . . . . . . . . . 100
Uninstalling JBoss Application Server and MySQL for Adobe . . . . . . . . . . . . . . . . . 101
To uninstall JBoss or MySQL for AEM Forms on JEE: 101
Next Steps 101
Appendix - Configuration Manager Command Line Interface . . . . . . . . . . . . . . . . 102
Order of operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Command Line Interface property file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
General configuration properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Common properties 104
Configure AEM Forms on JEE properties 105
Configure or validate application server properties 106
Configure JBoss properties 106
Initialize AEM Forms on JEE properties 107
Deploy AEM Forms on JEE Components properties 107
Add administrator user for PDF Generator 107
Configure Connector for IBM Content Manager 108
Configure Connector for IBM FileNet 109
Configure Connector for EMC Documentum 111
Configure Connector for Microsoft SharePoint 112
Command Line Interface Usage 113
Configure CRX CLI Usage 113
Manually deploy configured EAR files 114
Initialize AEM Forms on JEE CLI Usage 114
Validate AEM Forms on JEE Server CLI Usage 114
Deploy AEM Forms on JEE Components CLI Usage 114
Validate AEM Forms on JEE Component Deployment CLI Usage 115
Check system readiness for PDF Generator 115
Adding administrator user for PDF Generator 115
Configure Connector for IBM Content Manager 115
Configure Connector for IBM FileNet 116
Configure Connector for EMC Documentum 117
Configure Connector for Microsoft SharePoint 117
Examples Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Configuration Manager CLI Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Next steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Appendix - Configuring JBoss as a Windows Service . . . . . . . . . . . . . . . . . . . . . . 119
vi
Download the Web Native Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Install the Windows service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Start and stop JBoss Application Server as a Windows service . . . . . . . . . . . . . . . . . 121
Start JBoss as a Windows service 121
Stop JBoss as a Windows service 121
Verify the installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Additional configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Appendix - Manually Configuring JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Installing the JDK for JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Set the JAVA_HOME environment variable (Windows) 123
Set the PATH environment variable (Windows) 123
Set the JAVA_HOME environment (Linux and Solaris) 124
Set the PATH environment variable (Linux and Solaris) 124
Verify JAVA_HOME environment variable setting (Windows, Linux, or Solaris) 124
Manually installing JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Starting and stopping JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Start JBoss 124
Stop JBoss 125
Modifying the JBoss configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Modify the JBoss configuration 126
Modify the domain.conf.bat file (Windows only) 126
Modify jboss.cli.bat (windows) 127
Modify the domain.conf file (JBoss with Solaris 11, Red Hat 6.5 or 7, 64-bit only)
127
Modify domain.xml file (Windows and Unix) 128
Modify the host.xml file 130
Modify the modules.xml file 131
About JVM Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Managed Domain 131
JVM settings in the domain configuration file 132
Copying jar files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
AEM Forms database connectivity for manually installed JBoss . . . . . . . . . . . . . . . . 134
Configuring MySQL for manually installed JBoss 134
Configuring the MySQL data source 135
Set MySQL as the data source 135
Edit the standardjbosscmp-jdbc.xml file 136
Configuring Oracle for manually installed JBoss 136
Install the Oracle 12c database driver 136
Set Oracle as the data source 136
Edit the lc_turnkey.xml file 139
Configuring SQL Server for manually installed JBoss 140
Configuring the SQL Server database connectivity 140
Set MSSQL as the data source 140
Configure Integrated Security on Windows 143
Next steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
vii
About This Document 1
1. About This Document
AEM Forms on JEE is an enterprise server platform that helps you automate and streamline business
processes. AEM Forms on JEE comprises the following components:
• J2EE-based Foundation provides server capabilities and runtime environment
• Tools to design, develop, and test AEM Forms on JEE Applications
• Modules and Services are deployed on AEM Forms on JEE Server and provide functional
services
For more information about the AEM Forms on JEE architecture and capabilities, see Introduction
to AEM Forms.
This document is part of a larger documentation set available at Documentation page. It is advised
that you start with the preparing guide and then move on to installation and configuration guide
depending on whether you are performing a fresh installation (single server or cluster setup) or
upgrading your existing deployment. For Turnkey deployment, which is only for evaluation
purposes, see Installing and Deploying AEM forms on JEE usingJBossTurnkey.
1.1. Who should read this document?
This guide provides information for administrators or developers who are responsible for installing,
upgrading, configuring, administering, or deploying AEM forms on JEE components. The informa-
tion provided is based on the assumption that anyone reading this guide is familiar with J2EE appli-
cation servers, operating systems, database servers, and web environments.
1.2. Conventions used in this document
The installation and configuration documentation for AEM Forms on JEE uses the following
naming conventions for common file paths.
Name Default value Description
[aem-forms root] Windows:
C:\Adobe\Adobe_Experience_Manager_Forms
Linux and Solaris:
/opt/adobe/Adobe_Experience_Manager_Forms
1