5.1 Considerations when configuring and deploying AEM forms on JEE

5.1.1 General Considerations

  • For IPv6, run IPv6 Configuration Manager. For detailed information, see IPv6 support section in prepare to install guide .

  • You can override the default font for the Configuration Manager by adding the following JVM argument in [aem-forms root]\configurationManager\bin\ConfigurationManager.bat (Windows) or [aem-forms root]\configurationManager\bin\ConfigurationManager.sh (Linux, UNIX):

    -Dlcm.font.override=<FONT_FAMILY _NAME>

    For example:

    -Dlcm.font.override=SansSerif

    Restart the Configuration Manager after adding the JVM argument.

  • During configuration, if you must reset the data in Configuration Manager by using the Reset to Default option, ensure that you relaunch the Configuration Manager. Otherwise, you may encounter some missing configuration screens.

  • During configuration, you must provide the location of the JDBC drivers for your database. The Oracle, SQL Server, and DB2 drivers are in the [aem-forms root] /lib/db/ [database] directory.

  • Temporary directory: Do not specify a shared network directory as your temporary directory on cluster configurations. It is recommended to use local directory as a temporary directory. The temporary directory should exist on every node of the cluster and the path of the temporary directory should be same for every node of the cluster.

  • Global Document Storage (GDS) directory: Specify the GDS directory that meets the requirements outlined in the Preparing to Install (Single Server or Server Cluster). For latest documentation, see http://www.adobe.com/go/learn_aemforms_tutorials_61_en .

  • On cluster environments, several steps need to be performed manually in addition to the automatic configuration that Configuration Manager performs.

5.1.2 CLI versus GUI versions of Configuration Manager

This section describes the GUI version of Configuration Manager. For instructions about using the command line interface (CLI) version of Configuration Manager, see 12 Appendix - Configuration Manager Command Line Interface .

Configuration task

Configuration Manager GUI

Configuration Manager CLI

Manual

Configure AEM forms on JEE

Yes

Yes

No

Configure application server

Only WebLogic and WebSphere application servers can be configured using Configuration Manager.

Yes

Yes

Yes

(WebLogic only) Package JDBC Modules into AEM forms on JEE EARs

Yes

No

Yes

Validate application server configuration

Only WebLogic and WebSphere application server configurations can be validated using Configuration Manager.

Yes

Yes

Yes

Deploy AEM forms on JEE EARs

AEM forms on JEE EARs can be deployed only on WebLogic and WebSphere application servers using Configuration Manager.

Yes

Yes

Yes

Initialize AEM forms on JEE database

Yes

Yes

No

Validate AEM forms on JEE Server connection

Yes

Yes

No

Deploy AEM forms on JEE components

Yes

Yes

No

Validate AEM forms on JEE component deployment

Yes

Yes

Yes

Configure AEM forms on JEE components

Yes

Yes

Yes

5.1.3 Considerations for WebLogic application server

  • If you plan to use Configuration Manager to configure the application server or deploy to the application server, the application server must be manually started and running prior to running the Configuration Manager. You can also configure an application server that is installed on a different computer.

  • Ensure that you have assigned listen addresses for Administration Server, Node Manager, and Managed Servers, before running Configuration Manager on dual stack machines (IPV6 and IPV4 supported). If you have not already done this, assign listen addresses and restart each of them. For more information, see the Configuring a WebLogic Server section in the Preparing to Install AEM forms on JEE guide.

  • To secure the data sources, select Package JDBC Modules into AEM forms on JEE EARs (secure datasources).

    Note: Do not select this task if your AEM forms on JEE implementation is required to handle XML Forms. Alternatively, perform the steps in the Technote at http://kb2.adobe.com/cps/844/cpsid_84435.html to secure access to JNDI artifacts on your WebLogic application server.
  • Configuration Manager does not support deployment or undeployment of EAR files with custom file names. If your EAR files use a custom file name, you must manually deploy and undeploy them to the application server.

  • If you are configuring a remote application server, ensure that an application server is also installed on the same computer as Configuration Manager so that Configuration Manager can use the application server library files.

5.1.4 Considerations while configuring AEM forms on JEE Server Clusters

  • You cannot configure settings for IPv6-based clusters using Configuration Manager.

    Note: If your WebLogic cluster is IPv6-based, see 6 Manually Configuring a WebLogic Server Cluster
  • It is recommended that you have local server fonts and customer fonts directories at the same path on each node in the cluster. Having shared fonts directories instead of local fonts directories may cause performance issues.

5.1.5 Set the date, time, and time zone

Setting the date, time, and time zone on all servers connected to your AEM forms on JEE environment will ensure that time-dependent modules, such as Digital Signatures and Acrobat Reader DC extensions function correctly. For example, if a signature appears to have been created in the future, it will not validate.

Servers that require time synchronization are database servers, LDAP servers, HTTP servers and J2EE servers (Application servers).

Note: Ensure that all the machines used in a AEM forms on JEE cluster are time synchronized.

5.1.6 Considerations for upgrading repository

  • Take backup of the [CRX_home] folder.

  • Open the Web Bundles console and delete the com.day.crx.sling.server bundle. The default URL of Web Bundles console is http://[server]:[port]/lc/system/console/bundles

  • Download and unzip the CRX to OAK migration utility. The utility is available at https://helpx.adobe.com/content/dam/help/en/aem-forms/6-1/crx2oak-1.2.10.jar.zip.

// Ethnio survey code removed