Get Started with Administering AEM forms on JEE

Update the license type for the deployment

As part of the AEM forms installation process, you used Configuration Manager to configure and deploy the AEM forms modules that you require. By default, those modules are configured with a 60-day evaluation license. Use the Change License page in administration console to change the license type for the deployment. The currently deployed modules are displayed on the Change License page.

The Change License page displays information about your license:

  • The current license type

  • The date and time the license was last updated

  • Who performed the last update

  • The current status of the license

  • The date that AEM forms was installed

  • The date the current license will expire

Note: The license change applies to all deployed modules. Before you change the license type, undeploy any modules that are not licensed. Do not select the Production license type if the list of deployed modules contains modules other than the ones you purchased from Adobe.

Update the license type

  1. In administration console, click Licensing.

  2. Read the AEM forms end-user license agreement, select I Accept if you agree with the terms of the agreement, and then click Next.

  3. On the Change License page, select a license type:

    • EVAL: 60-day evaluation license

    • DEV: Perpetual development license

    • NFR: 2-year evaluation license

    • IDEV: 1-year subscription to the Adobe Developer Program

    • Production: Perpetual license

  4. Select Yes, License Change Is Valid for All Deployed Modules.

  5. Click Confirm License Change. A message appears, stating that the license was updated successfully.

Configure general AEM forms settings

The Core Configurations page in administration console provides settings that can help improve system performance. After configuring or updating these settings, restart your application server.

For information about enabling safe backup mode, see Enabling and disabling safe backup mode .

Note: The files in the temp directory and the long-lived documents in the global document storage (GDS) root directory may contain sensitive user information, such as information that requires special credentials when accessed by using the APIs or user interfaces. Therefore, it is important that this directory is properly secured by using whatever methods are available to the operating system. It is recommended that only the operating system account that is used to run the application server has read and write access to this directory.

  1. In administration console, click Settings > Core System Settings > Configurations.

  2. On the Core Configurations page, change the options as required and click OK. For details about the options, see Core Configurations options .

Core Configurations options

Location of temp directory
The directory path where AEM forms will create product temporary files. If the value of this setting is empty, the location defaults to the system temp directory. Ensure that the temp directory is a writable folder.
Note: Ensure that the temporary directory is on the local file system. AEM forms does not support a temporary directory at a remote location.

Global document storage root directory
The global document storage (GDS) root directory is used for the following purposes:

  • Storing long-lived documents. Long-lived documents do not have an expiration time and persist until they are removed (for example, the PDF files used within a workflow process). The long-lived documents are a critical part of the overall system state. If some or all these documents are lost or corrupted, the forms server may become unstable. Therefore, it is important that this directory is stored on a RAID device.

  • Storing temporary documents needed during processing.

    Note: You can also enable document storage in the AEM forms database. However, system performance is better when you use the GDS.

  • Transferring documents between nodes in a cluster. If you are running AEM forms in a clustered environment, this directory must be accessible from all nodes within the cluster.

  • Receiving incoming parameters from remote API calls.

If you do not specify a GDS root directory, the directory defaults to an application server directory:

  • [JBOSS_HOME] /server/<server>/svcnative/DocumentStorage

  • [WEBSPHERE_HOME] /installedApps/adobe/ [server] /DocumentStorage

  • [WEBLOGIC_HOME] /user_projects/<domain>/ [server] /adobe/AEMformsserver/DocumentStorage

Important: Changing the value of the GDS root directory setting should be done with special care. The GDS directory is used to store both long-lived files used within a process as well as critical AEM forms product components. Changing the location of the GDS directory is a major system change. Incorrectly configuring the location of the GDS directory will render AEM forms inoperative and may require a complete reinstallation of AEM forms. If you specify a new location for the GDS directory, the application server needs to be shut down and the data migrated before the server can be restarted. The system administrator must move all files from the old location to the new location but keep the internal directory structure.
Important: Do not specify the same directory for the temp directory and the GDS directory.

For additional information about the GDS directory, see Preparing to Install AEM forms (Single Server) .

Location of the Adobe Server Fonts directory
Type the path to the directory that contains the Adobe server fonts. These fonts are installed with AEM forms. The default location for these fonts is the [aem-forms root] /fonts directory. If this directory is not accessible, you can copy the fonts elsewhere and use this setting to specify the new location.

Location of the Customer Fonts directory
Type the path to a directory that contains additional fonts that you want to use.
Note: Fonts are picked from the Windows system font cache and a system restart is required to update the cache. After specifying the Customer font directory, ensure that you restart the system on which AEM forms is installed.

Location of the System Fonts directory
Type the path to the fonts directory that your operating system provided. Multiple directories can be added, separated by a semicolon (;).

Location of Data Services Configuration file
Specifies the location of the services-config.xml file. By default, this file is embedded in the adobe-core- appserver .ear file and is not user-accessible. A copy of the default services-config.xml file is located in [aem-forms root] \sdk\misc\DataServices\Server-Configuration. If you changed this file and moved it, type the new location in this field.

The Data Services configuration file allows customization of Data Services settings, such as authentication type and debug output.

This setting is empty by default.

Default document max inline size (bytes)
The maximum number of bytes kept in memory when passing documents between various AEM forms components. Use this setting for performance tuning. Documents that are smaller than this number are stored in memory and persisted in the database. Documents that exceed this maximum are stored on the hard drive.

This setting is mandatory. The default value is 65536 bytes.

Default document disposal timeout (seconds)
The maximum amount of time, in seconds, during which a document being passed between various AEM forms components is considered active. After this time has passed, files that are used to store this document are subject to removal. Use this setting to control the usage of disk space.

This setting is mandatory. The default value is 600 seconds.

Document sweep interval (seconds)
The amount of time, in seconds, between attempts to delete files that are no longer needed and were used to pass document data between services.

This setting is mandatory. The default value is 30 seconds.

Enable FIPS
Select this option to enable FIPS mode. Federal Information Processing Standard (FIPS) 140-2 is a U.S. government-defined cryptology standard. When running in FIPS mode, AEM forms restricts data protection to FIPS 140-2 approved algorithms by using the RSA BSAFE Crypto-C 2.1 encryption module.

FIPS mode does not support encryption algorithms that are used in Adobe Acrobat® versions earlier than 7.0. If FIPS mode is enabled and you use the Encryption service to encrypt the PDF by using a password with a compatibility level set to Acrobat 5, the encryption attempt will fail with an error.

In general, when FIPS is enabled, the Assembler service will not apply password encryption to any document. If this is attempted, a FIPSModeException is thrown indicating that "Password encryption is not permitted in FIPS mode." Additionally, the Document Description XML (DDX) PDFsFromBookmarks element is not supported in FIPS mode when the base document is password-encrypted.

Note: AEM forms software does not validate code to ensure FIPS compatibility. It provides a FIPS operation mode so that FIPS-approved algorithms are used for cryptographic services from the FIPS-approved libraries (RSA).

Enable WSDL
Select this option to enable Web Service Definition Language (WSDL) generation for all services that are part of AEM forms.

Enable this option in development environments, where developers use WSDL generation to build their client applications. You may choose to disable WSDL generation in a production environment to avoid exposing a service’s internal details.

Enable document storage in the database
Select this option to store long-lived documents in the AEM forms database. Enabling this option does not remove the need for a GDS directory. However, choosing this option simplifies AEM forms backups. If you use just the GDS, a backup involves putting the AEM formsAEM forms system into backup mode and then completing the backups of the database and the GDS. If you select the database option, the backup involves completing the database backup for a new install or completing the database backup and the one time backup of the GDS for an upgrade. Additional management of your database may be required to purge jobs and data compared to a GDS only configuration. (See Backup options when database is used for document storage .)

Enable DSC invocation statistic
When this option is selected, AEM forms tracks invocation statistics such as the number of invocations, amount of time taken to invoke, and number of errors in invocations. This information is stored in a JMX bean so that you can use Java™ JConsole or third-party software to look at the statistics. If you do not want to see these statistics, deselect this option to improve AEM forms performance.

Enable RDS
Selecting this option enables the Remote Development Services (RDS) servlet within AEM forms. When this option is enabled, client-side tools can interact with Data Services to do things like deploy or undeploy models to create destinations and endpoints, or to find out which models have been deployed into endpoints. By default, this option is not selected.

Allow non secured RDS request
When this option is selected, RDS requests do not need to use https. By default, this option is not selected and all communications to Data Services need to be https requests.

Allow non secured document upload from Flex applications:
The file upload servlet used to upload documents from Adobe Flex® applications to AEM forms requires that users are authenticated and authorized before they can upload documents. The user must be assigned the Document Upload Application User role or another role that includes the Document Upload permission. This helps prevent unauthorized users from uploading documents to the AEM forms server. Select this option if you want to disable this security feature in a development environment or for backwards compatibility with previous versions of AEM forms. By default, this option is not selected. For details, see “Invoking AEM forms Using AEM forms Remoting" in Programming with AEM forms .

Allow non secured document upload from Java SDK applications:
HTTP DocumentManager uploads must be secured. By default, HTTP uploads require that users are authenticated and authorized before they can upload documents. The user must be assigned the Services User role or another role that contains the Service Invoke permission. This helps prevent unauthorized users from uploading documents to the forms server. Select this option if you want to disable this security feature in a development environment, for backwards compatibility with previous versions of AEM forms, or based on your firewall setup. By default, this option is not selected. For details, see “Invoking AEM forms Using the Java API" in Programming with AEM forms .

// Ethnio survey code removed