Note:
Press
F1
in Configuration Manager to view
Help information for the screen you are viewing.
Configuring AEM forms
-
On the Configure
Adobe Experience Manager forms(1 of 5) screen, click
Configure
and
click
Next
when done.
-
On the Configure Adobe Experience Manager forms (2 of 5)
screen, click
Next
to accept the default directory locations,
or click
Browse
to navigate to and change the directories
that AEM forms will use to access fonts, and then click
Next
.
Click
Edit configuration
to change any values
on this screen. This button is not available when the Configuration
Manager is run for the first time, but is available on the second
and subsequent runs of the Configuration Manager.
-
(Optional) To change the default location of the
Adobe server fonts directory
,
type the path or browse to the directory.
-
To change the default location of the
Customer fonts directory,
click
Browse
or
specify a new location for your customer fonts.
Note:
Your
right to use fonts provided by parties other than Adobe is governed by
the license agreements provided to you by such parties with those
fonts, and is not covered under your license to use Adobe software.
Adobe recommends that you review and ensure that you are in compliance
with all applicable non-Adobe license agreements before using non-Adobe
fonts with Adobe software, particularly with respect to use of fonts
in a server environment.
-
(Optional) To change the default location of the
System fonts directory
, type
the path or browse to the directory. To add more directories to
the list, click
Add
.
-
(Optional) To enable FIPS, ensure that Enable
FIPS
is
selected. Select this option only if you require the Federal Information
Processing Standards (FIPS) to be enforced.
-
Click
Browse
on the Configure Adobe Experience Manager
forms (3 of 5) screen to specify the
Location of the temporary directory
,
and then click
Next
.
Note:
Ensure that the temporary directory
is on the local file system. AEM forms does not support a temporary
directory at a remote location.
Note:
If
you do not specify the temporary directory, the default system-configured
temp location is used.
-
On the Configure Adobe Experience Manager forms (4 of 5)
screen, click
Browse
to specify the path for the Global Document
Storage (GDS) directory, and then click
Next
..
Note:
If
you leave the GDS directory field empty, AEM forms will create the
directory in a default location in the application server directory
tree. After you finish the configuration steps, you can access the
location from administration console > Settings > Core System Settings
> Configurations.
-
On the Configure Persistent Document Storage (5 of 5) screen,
select the option for persistent document storage in addition to
the GDS directory. Select one of the following:
-
Use GDS
:
Use the file system-based GDS for all persistent document storage.
This option provides the best performance, and a single location for
GDS.
-
Use database
: Use the AEM forms database for storing
the persistent documents and long-lived artifacts. However, the
file-system based GDS is also required. Using the database simplifies
backup and restore procedures.
Click
Configure
to
configure the AEM forms EARs with this directory information and,
after the configuration is complete, click
Next
.
Configure CRX
The CRX Configuration
screen allows you to configure the CRX repository and install it
into the adobe-livecycle-cq-author.ear EAR file.
-
Specify the path to the repository. The default location
is
[aem-forms root]
/crx-repository.
Note:
Ensure that
the CRX repository path does not contain spaces and the content
repository is available on all the nodes of the cluster. After the
configuration is complete, copy the content repository from local
node to all the nodes on the same location (as specified on the
CRX configuration screen) .
-
Select the repository type, as appropriate and keep a note
of the following points:
-
CRX3 TAR is not supported
in clustered deployments.
-
If selecting CRX3 Mongo DB, specify the Mongo database name
and URL to the database. The format of the URL is:
mongodb://<HOST>:<Port>
.
HOST:
IP address of the machine running MongoDB.
Port: Port number
used for the MongoDB. The default port number is 27017.
-
CRX3 RDB is supported only with Oracle 12c or IBM DB2 10.5
databases. Selecting this option sets the CRX repository persistence
to RDB MK (document MK) .
-
Optionally, select AEM Samples need to be installed to install
AEM samples.
-
Click
Configure
to create the required repository
files at the specified location.
Note:
If your AEM
forms on JEE server is running remotely, select
Server is running on remote host
,
and specify the path to the repository on the remote host.
Note:
Clustered
environments with relational databases are now supported for production
use under a "gated" program. If you intend to use a relational database in
a clustered environment, contact AEM Forms product team at forms_documents@adobe.com
for approval. Also ensure that the mandatory patches are
installed and configured.
Click
Next
to continue.
Note:
Once
the packages are configured, you cannot remove them by re-running the
Configuration Manager. For clean uninstallation of deployed packages,
you need to uninstall and delete the packages using Package Manager.
(Remote host only) CRX Configuration Summary
For a remote deployment, copy the content from the [
aem-forms root
]/configurationManager/export/crx-quickstart/
directory to the location on the remote host you specified on the
CRX Configuration screen.
Note:
In case of clustered deployment,
you must copy the content from the [aem-forms root]/configurationManager/export/crx-quickstart/
directory to the specified location on all cluster node hosts.
Configuring Acrobat for PDF Generator
(Windows only)
On the Configure Acrobat For PDF Generator
screen, click
Configure
to run the script that will configure
Adobe Acrobat and required environment settings. Click
Next
when
complete.
Note:
This screen will perform the desired configuration
only when Configuration Manager is running locally. You must have
Adobe Acrobat DC Pro already installed or this step will fail.
Configuration Summary
On the
Configure Adobe Experience Manager forms Summary screen, click
Next
.
Configured archives are placed in the
[aem-forms root]
/configurationManager/export
directory.
Configuring your application server and database
-
On the Application Server Configuration Details screen, provide
the information for the fields (all fields are mandatory) and then
click
Verify Server Connection
. When the verification has
completed successfully, click
Next
.
Note:
If WebSphere
Administrative Security is off, Admin User ID and Password fields
can be left blank.
Note:
When using WebSphere Cluster or
WebSphere Network Deployment server to configure a standalone WebSphere
Application server, enter the port number of the deployment manager
in the SOAP Port field.
Note:
If you are using non-default
WebSphere profile, ensure that you provide the complete path, including
the profile name, in the Local Application Server Root Directory
field.
-
On the Application Server Configuration Selection
screen, select the tasks for Configuration Manager to perform, and
click
Next
.
-
On the Server Settings Configuration screen
(appears only if Configure Server Settings was selected)
,
provide the information for the fields, and then click
Next
.
-
On the Datasource Configuration screen
(appears only if Configure Datasource option is selected)
,
provide the information for the fields and then click
Test Database Connection
.
When the connection is tested successfully, click
Next
.
You
can choose to manually configure data sources rather than allowing Configuration
Manager to configure them for you. To override automatic data source
configuration, select
Manually configure data source in the WebSphere Administrative Console before continuing
,
at the bottom of the screen.
Without exiting Configuration
Manager, go to the application server administration console, and
configure data sources as described in
9.5 Configuring the AEM forms on JEE database connectivity
in Installing
AEM forms on JEE for WebSphere Server Guide.
Note:
By
default, Configuration Manager creates datasources at node level.
To set the datasource at the server level, see how to create a JDBC
provider for your database in
9 Appendix - Manually Configuring WebSphere
in the Installing AEM forms
on JEE for WebSphere Server Guide.
-
On the Application Server Configuration screen, click
Configure
.
When the process is completed, click
Next
.
-
If you have enabled SSL, perform the following steps. These
steps change "http" to "https" in the integration URL:
-
Open Webspehere console. The default URL is [host]:<ibm_admin_port>/ibm/console.
-
Navigate to Servers > Server Types > Websphere Application
Server and select server. For example Server1.
-
In Server Infrastructure, select Java and Process Management
. Click Process Definition. In Additional Properties, select Java
Virtual Machine
-
Under Generic JVM Arguments change http to https in -Dcom.adobe.livecycle.crx.integration.url.
-
On the Application Server Configuration Validation screen,
select the tasks for validating and then click
Validate
and
select Yes on prompt to deploy adobe-lcm-lcvalidator.ear. When the
process is completed, click
Next
.
Choose installation verification sample (IVS) EAR files
(Forms, Output, Mobile Forms, and Assembler
only)On the Adobe Experience Manager forms Installation Verification
Sample (IVS) EAR files screen, you can install three service-specific
sample applications. Select
Include IVS EARs in deployment
set
and click
Next
to install these sample files.
The ear
files appear only if you have selected respective modules on the Modules
screen.
Note:
Do not deploy the IVS EAR files to
a production environment.
Deploying AEM forms on JEE EARs
On the Deploy Adobe Experience Manager forms EARs screen,
select the EAR files to deploy, and then click
Deploy
. This
operation may take several minutes to complete. When the deployment
has completed successfully, click
Next
.
Note:
If the deployment
of EARs fails with the error – The system failed to make the SOAP
RPC call: invoke – increase the SOAP timeout value as described
in
9.3 Configuring WebSphere time-out settings
and then deploy the EARs.
Note:
When Configuration Manager has started the execution of the IBM WebSphere® JACL deployment scripts, you cannot stop the deployment even if you exit or cancel Configuration Manager prior to deployment completion. No user action is required because the product EARs will be successfully deployed.
By
default, Configuration Manager deploys the EAR files to the WebSphere default
virtual host,
default_host
. To deploy the EAR files
to a different virtual host, select the target host from the Virtual
Host list.
To connect to the application server using a secure
port while running Configuration Manager, do the following tasks:
-
Add the crypto.jar file provided by IBM to the Configuration
Manager path.
-
Set the following JVM argument to disable hostname verification:
ssl.disable.url.hostname.verification.CWPKI0027I=CWPKI0027I
You
can connect to the application server using this workaround only
if you are using the default HTTPS port.
Note:
You
have to manually deploy adobe-livecycle-author.ear after configuring AEM
forms and upgrading the repository.
Initializing AEM forms on JEE database
-
On the Adobe Experience Manager forms Database Initialization
screen, verify that the hostname and port number provided for your
application server is correct and then click
Initialize
.
The database initialization task creates tables in the database,
adds default data to the tables, and creates basic roles in the database.
When the initialization has completed successfully, click
Next
. Restart
the application server manually when you are prompted to do so.
-
On the Adobe Experience Manager forms Information screen,
enter
Adobe Experience Manager forms User ID
and
Password
whose
default values are
administrator
and
password
respectively.
Note:
Before verifying
the connection to the server, verify that AEM is up and running.
If AEM is not up and running and the server is restarted, it may
lead to the corruption of repository data. Perform the following
steps to verify that AEM is up and running:
-
Watch
the error.log file for activity. Ensure that it is stable and no
more action is performed. The default path of the error.log file
is <aem-forms_root>/crx-repository/logs/error.log.
-
In the browser window, open URL http://[host]:[port]/lc/system/console/bundles,
and ensure that only one bundle is in the installed state.
Click
Verify Server Connection
,
and when complete, click
Next
.
Note:
The server information that appears on this screen
represents default values for the deployment.
Verifying
the server connection helps narrow troubleshooting in case failures occur
in the deployment or validation. If the connection test passes but deployment
or validation fails in the next few steps, connectivity issues can
be eliminated from the troubleshooting process.
Deploying Central Migration Bridge Service
On the Central Migration Bridge Service Deployment Configuration
screen, if applicable, select the
Include Central Migration Bridge Service
in deployment
option and then click
Next
.
Deploying AEM forms on JEE components
-
On the Adobe Experience Manager forms Component Deployment
screen, click
Deploy
. The components that are deployed at
this time are Java archive files that plug into the service container
that is part of AEM forms on JEE for purposes of deploying, orchestrating,
and executing services. When the deployment has completed successfully,
click
Next
.
-
On the Adobe Experience Manager forms Component Deployment
Validation screen, click
Validate
. Click
View Progress Log
to
view the validation progress and, when the validation has completed
successfully, click
Next
.
Configuring AEM forms components
On the Configure Adobe Experience Manager forms Components
screen, select the tasks to run with Configuration Manager, and
click
Next
.
Configure Connector for EMC Documentum®
Note:
In
case of a remote AEM forms on JEE deployment, you cannot configure
the Connector for EMC Documentum using Configuration Manager.
-
On the Specify Client for EMC Documentum screen, select
Configure Connector for EMC Documentum Content Server
,
and specify the following settings. Enter the details, click
Verify
,
and when complete, click
Next
to continue.
-
Choose EMC Documentum Client Version:
Select the client
version to use with the EMC Documentum Content Server.
-
EMC Documentum Client Installation Directory Path:
Click
Browse
to select
the directory path.
-
On the Specify EMC Documentum Content Server Settings screen,
enter the EMC Documentum Server details, and then click
Next
.
Press F1 for information about the details you need to enter.
-
On the Configure Connector for EMC Documentum screen, click
Configure Documentum Connector
.
When completed, click
Next
.
-
On
the Required Manual Configurations for Connector for EMC Documentum
screen, review and perform the manual steps listed and then click
Next
.
Configure Connector for IBM® Content Manager
Note:
In
case of a remote AEM forms on JEE deployment, you cannot configure
the Connector for IBM Content Manager using Configuration Manager.
-
On the Specify Client for IBM Content Manager screen, select
Configure Connector for IBM Content Manager
,
and enter a value for the IBM Content Manager Client Installation
Directory Path. Click
Verify
and when complete, click
Next
to
continue.
-
On the Specify IBM Content Manager Server Settings screen,
enter the details of the IBM Content Manager Server, and click
Next
.
-
On the Configure Connector for IBM Content Manager screen,
click
Configure IBM Content Manager Connector
. When complete,
click
Next
.
-
On
the Required Manual Configurations for Connector for IBM Content
Manager screen, review and perform the manual steps listed and then
click
Next
.
Configure Connector for IBM® FileNet
Note:
In
case of a remote AEM forms on JEE deployment, you cannot configure
the Connector for IBM FileNet using Configuration Manager.
-
On the Specify Client for IBM FileNet screen, select
Configure Client for IBM FileNet Content Manager
,
and specify the following settings.
-
Choose IBM FileNet Client Version:
Select
the client version that you want to use with the IBM FileNet Content
Server.
-
IBM FileNet Client Installation Directory Path:
Click
Browse
to
select the directory path.
Note:
The validation of IBM FIleNet
may fail if there are special characters, such as hyphen (-), underscore
(_), comma (,), or dot (.) in the directory name containing the
IBM FileNet client.
Click
Verify
, and
when complete, click
Next
to continue.
-
On the Specify IBM FileNet Content Server Settings screen,
enter the required details, and click
Next
. Press F1 for
more information.
-
On the Specify Client for IBM FileNet Process Engine screen,
enter the required details, and click
Verify
. When complete,
click
Next
.
-
On the Specify IBM FileNet Process Engine Server Settings
screen, enter the required details and click
Next
. Press
F1 for more information.
-
On the Configure Connector for IBM FileNet screen, click
Configure FileNet Connector
.
When complete, click
Next
.
-
On
the Required Manual Configurations for Connector for IBM FileNet
screen, review and perform the manual steps listed and then click
Next
.
Configure Connector for Microsoft® SharePoint®
Note:
In
case of a remote AEM forms on JEE deployment, you cannot configure
the Connector for Microsoft SharePoint using Configuration Manager.
On
the Configure Adobe Adobe Experience Manager forms Connector for Microsoft
SharePoint screen, do one of the following tasks:
-
Deselect the
Configure Adobe Experience Manager forms Connector for Microsoft SharePoint
option
to manually configure Microsoft Sharepoint later, and then click
Next
.
-
Leave the
Configure Adobe Experience Manager forms Connector for Microsoft SharePoint
option
selected. Enter the required values, and then click Configure SharePoint
Connector. When complete, click
Next
.
Note:
You can skip
this step if you want to configure the Connector for Microsoft SharePoint
later using administration console.
Configuring forms server for native file conversions
(PDF Generator only)
On the
Admin user credentials for native PDF conversions
screen,
enter the user name and password of a user with administrative privileges
on the server computer, and then click
Add user.
Note:
You
must add at least one administrative user for Windows 2008 Server.
On Windows 2008 Server, User Account Control (UAC) must be disabled
for the users you add. To disable UAC, click
Control Panel
>
User Accounts
>
Turn User Account Control on or off
and
deselect Use User Account Control (UAC) to help protect your computer,
then click
OK
. Restart the computer to apply these changes.
System readiness test for PDF Generator
On the
Document Services PDF Generator System Readiness Test
screen, click
Start
to
validate if the system has been appropriately configured for PDF Generator.
Review the System Readiness Tool Report and click
Next.
Note
that the system readiness test fails if AEM forms on JEE is deployed
on a remote machine.
Configuring Acrobat Reader DC extensions
On the Acrobat Reader DC extensions Credential Configuration
screen, specify the details that are associated with the Acrobat
Reader DC extensions credential that activates the module services.
Note:
You can skip this step at this time by selecting
Configure later using administration console
.
You can configure the Acrobat Reader DC extensions credential by
using Administration Console after you complete the deployment. (After
logging in to administration console, click
Home
>
Settings
>
Trust Store Management
>
Local Credentials
.)
Click
Configure
and then
click
Next
.
Summary, and Next Steps
Review the Configuration Manager task summary list and choose
the appropriate options:
Note:
You will see a
message on the screen to restart the server. However, do not immediately
restart. Ensure that error.log is stable and all bundles (except
signatures) are in active mode before you restart the server.
Click
Finish
to
exit the Configuration Manager.
|
|
|