AEM 6.5 Forms Service Pack installation instructions aem-form-patch-installation-instructions
Release information
What is included in Experience Manager Forms 6.5
Adobe Experience Manager (AEM) Forms service pack includes new and upgraded features, such as key customer-requested enhancements, performance, stability, and security improvements. AEM Forms release service packs at a regular interval to provide latest features and improvements. Depending on your technology stack, choose one of the following paths to download and install service pack on your environment:
- Adobe releases a full installer every sixth service pack. AEM 6.5 Forms Service Pack 18 (6.5.18.0) is the latest JEE full installer. The full installer supports new platforms while the regular service pack installer includes new features, bug fixed and general improvements. If you are performing a fresh installation or planning to use latest software for your AEM 6.5 Forms on JEE environment, Adobe recommends using AEM 6.5.18.0 Forms on JEE full installer released on 31 August 2023 instead of AEM 6.5 Forms installer released on 08 April 2019 or AEM 6.5.12.0 Forms Installer released on 03 March 2022. After using the full installer, install the latest service pack.
- The AEM Forms feature, such as Adaptive Forms, available in AEM 6.5 QuickStart, are intended for exploration and evaluation purposes only. For production use, it is essential to obtain a valid license for AEM Forms.
Download and install Service Pack on an AEM Form on JEE environment download-and-install-for-jee-service-pack
- Back up your CRX Repository, Database Schema, and GDS (Global Document Storage).
- Back up the <AEM_forms_root>/deploy folder.
note note |
---|
NOTE |
Before running the AEM service pack installer, make sure you have write-access privileges on AEM installation directory. |
- Download and install the 64-bit version of Microsoft Visual C++ Redistributable packages for Visual Studio 2015, 2017, 2019, and 2022 on the computer where AEM 6.5 Forms is installed.
note note |
---|
NOTE |
Ensure that you install the Redistributable, even if a previous version is installed, to guarantee the availability of the latest version. |
-
Stop your application server.
-
Extract the AEM Forms on JEE Service Pack installer archive to your hard drive:
-
Windows
Navigate to the appropriate directory on the installation media or folder on your hard disk where you copied the installer, and double-click theaemforms65_cfp_install.exe
file.- (Windows 32-bit)
Windows\Disk1\InstData\VM
- (Windows 64-bit)
Windows_64Bit
\Disk1\InstData\VM
- (Windows 32-bit)
-
Linux®
Navigate to the appropriate directory, and from a shell and type./aem65_cfp_install.bin
.- (Linux®)
Linux/Disk1/InstData/NoVM
- (Linux®)
This launches an install wizard that guides you through the installation.
-
-
On the Introduction panel, click Next.
-
On the Choose Install Folder screen, verify that the default location displayed is correct for your existing installation, or click Browse to select the alternate folder where AEM forms is installed, and click Next.
-
Read the Service Pack summary information and click Next.
-
Read the Pre-Installation Summary information and click Install.
-
When the installation is complete, click Next to apply the quick fix updates to your installed files.
-
[For Windows only]: Perform one of the following step:
-
Either deselect the Start Configuration Manager option before you click Done. Run Configuration Manager by using the ConfigurationManager.bat file in
[aem-forms root]\configurationManager\bin
. -
Or deselect the Start Configuration Manager option before you click Done. Before running Configuration Manager using ConfigurationManager.exe or ConfigurationManager_IPv6.exe, navigate to
<AEMForms_Install_Dir>\configurationManager\bin
directory and replace the ConfigurationManager.lax and ConfigurationManager_IPV6.lax with the latest ConfigurationManager.lax and ConfigurationManager_IPV6.lax files.note note NOTE - Updating or replacing the ConfigurationManager.bat file helps you to avoid updating the .lax files manually.
-
-
[For Unix-based only]: The Start Configuration Manager check box is selected by default. Click Done to run the Configuration Manager instantly or to run Configuration Manager later, deselect the Start Configuration Manager option before you click Done. You can start Configuration Manager later using the appropriate script in the
[AEM_forms_root]/configurationManager/bin
directory. -
Depending on your application server, choose one of the following documents and follow the instructions in the Configuring and Deploying AEM forms section.
- Installing and Deploying AEM forms for JBoss®
- Installing and Deploying AEM forms for WebSphere®
- Installing and Deploying AEM Forms for WebLogic
- Installing and Deploying AEM forms for JBoss® Cluster
- Installing and Deploying AEM forms for WebSphere® Cluster
- Installing and Deploying AEM Forms for WebLogic Cluster
note note |
---|
NOTE |
After installing AEM Forms on JEE service pack, you need to remove the Forms add-on package from crx-repository\install folder before restarting the appserver. Download the latest Forms add-on package from the Software Distribution portal. |
note note |
---|
NOTE |
|
To download and install the servlet fragment:
-
If you have not downloaded the fragment, download it from Software Distribution.
-
Start the application server, wait for logs to stabilize and check the bundle state.
-
Open Web Console Bundles. The default URL is
http://[Server]:[Port]/system/console/bundles
. -
Click Install/Update. Choose the downloaded fragment,
org.apache.felix.http.servlet-api-1.2.0_fragment_full.jar
. Click Install or Update. Wait for the application server to stabilize -
Stop the application server.
- Restart the instance before installation if the instance is in update mode (when the instance was updated from an earlier version). Adobe recommends a restart if the current uptime for an instance is high.
- Before installing, take a snapshot or a fresh backup of your Experience Manager instance.
- Download the service pack from Software Distribution.
- Open Package Manager, then select Upload Package to upload the package. To know more, see Package Manager.
- Select the package, then select Install.
Automatic installation
There are two different methods that you can use to automatically install ExperienceManager service pack.
-
Place the package into
../crx-quickstart/install
folder when the server is available online.
The package is automatically installed. -
Use the HTTP API from Package Manager. Use
cmd=install&recursive=true
so that the nested packages are installed.note note NOTE Experience Manager service pack does not support Bootstrap installation. Validate the installation
To know the platforms that are certified to work with this release, see the technical requirements.
- The product information page (
/system/console/productinfo
) displays the updated version stringAdobe Experience Manager (spversion)
under Installed Products. - All OSGi bundles are either ACTIVE or FRAGMENT in theOSGi Console (Use Web Console:
/system/console/bundles
). - The OSGi bundle
org.apache.jackrabbit.oak-core
is version 1.22.14 or later (Use WebConsole:/system/console/bundles
).
- The product information page (
- Ensure that you have installed the Experience Manager service pack.
- Download the corresponding Forms add-on package listed at AEM Forms releases for your operating system.
- Install the Forms add-on package as described in Installing AEM Forms add-on packages.
- If you use letters in Experience Manager 6.5 Forms, install the latest AEMFD Compatibility package.
Download and install Service Pack on an AEM Form on OSGi environment download-and-install-for-osgi-service-pack
- Back up your CRX Repository and Database Schema.
note note |
---|
NOTE |
If you install AEM Forms service pack for relational database, it is mandatory to take backup of DB_schema. |
- Download and install the 64-bit version of Microsoft Visual C++ Redistributable packages for Visual Studio 2015, 2017, 2019, and 2022 on the computer where AEM 6.5 Forms is installed.
note note |
---|
NOTE |
Ensure that you install the Redistributable, even if a previous version is installed, to guarantee the availability of the latest version. |
- Restart the instance before installation if the instance is in update mode (when the instance was updated from an earlier version). Adobe recommends a restart if the current uptime for an instance is high.
- Before installing, take a snapshot or a fresh backup of your Experience Manager instance.
- Download the service pack from Software Distribution.
- Open Package Manager, then select Upload Package to upload the package. To know more, see Package Manager.
- Select the package, then select Install.
Automatic installation
There are two different methods that you can use to automatically install Experience Manager service pack.
-
Place the package into
../crx-quickstart/install
folder when the server is available online. The package is automatically installed. -
Use the HTTP API from Package Manager. Use
cmd=install&recursive=true
so that the nested packages are installed.note note NOTE Experience Manager service pack does not support Bootstrap installation. Validate the installation
To know the platforms that are certified to work with this release, see the technical requirements.
-
The product information page (
/system/console/productinfo
) displays the updated version stringAdobe Experience Manager (spversion)
under Installed Products. -
All OSGi bundles are either ACTIVE or FRAGMENT in the OSGi Console (Use Web Console:
/system/console/bundles
).- The OSGi bundle
org.apache.jackrabbit.oak-core
is version 1.22.14 or later (Use Web Console:/system/console/bundles
).
- The OSGi bundle
-
- Ensure that you have installed the Experience Manager service pack.
- Download the corresponding Forms add-on package listed at AEM Forms releases for your operating system.
- Install the Forms add-on package as described in Installing AEM Forms add-on packages.
- If you use letters in Experience Manager 6.5 Forms, install the latest AEMFD Compatibility package.
Troubleshooting
-
If Dialog on Package Manager UI exits during the installation of the service pack, wait for error logs to stabilize before accessing the deployment. Wait for the specific logs related to the uninstall of the updater bundle before being assured that the installations are successful. Typically, this issue occurs in Safari browser but can intermittently occur on any browser.
-
Check the monitor logs (error.log) once the installation is complete for any activity. Wait for few minutes until there is no activity in the logs. Restart the AEM instance.
-
In case you get a service-unavailable error after installing the AEM Forms 6.5.15.0 or later service pack, install the servlet fragment and bundle to fix the error.