4.1 Considerations when configuring and deploying AEM forms on JEE

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

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

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

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

4.1.3 Considerations for WebSphere 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 deploying components to WebSphere on a localized instance of the Windows operating system, the Configuration Manager deployment process reaches approximately 7% completion and then adobe-livecycle-websphere.ear fails to deploy. You must perform additional steps described in the Miscellaneous Errors section of the adobe-livecycle-websphere.ear fails to deploy article.

  • If you are installing in a distributed environment to a secured server, you will encounter SSL handshake exceptions when running Configuration Manager. To avoid this error, run the following executable file before running Configuration Manager: [appserver root] /bin/retrieveSigners.bat. The retrieveSigners utility retrieves the certificates from the WebSphere Deployment Manager server and adds them to the local server’s trust store. See the article Retrieving signers using the retrieveSigners utility at the client available from the IBM Information Center.

  • Some Configuration Manager screens require you to provide the SOAP port of the application server or the deployment manager. For more information on how to determine SOAP ports of your WebSphere application server, see this blog .

  • 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. In an environment where a remote application server is installed on Linux, AIX, or Solaris and AEM forms on JEE is installed on Windows environment, copy the appropriate database driver from [aem-forms root]\lib to the [appserver root]/universalDriver/lib folder of the remote server.

  • You can determine the JNDI port number by logging in to WebSphere Administrative Console. On WebSphere admin console, click Servers > Server Types > WebSphere application servers > [server name] > Communications > Ports. You will need to provide the value for BOOTSTRAP_ADDRESS when you configure the application server using Configuration Manager.

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

4.1.5 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