LiveCycle ES4 SP1 | Core | Quick Fix 1178-050

Posted on April 19, 2017

• During upgrade process, Configuration Manager fails with timeout. (Ref# NPR-16326)

DSC deployment takes a variable time due to which it might fail. To change the timeout of DSC operations such as Install, Load, Start, and Stop, you need to set the adobe.component.registry.timeout using the JVM argument with the -D option. The value for the key is specified in seconds. For example: -Dadobe.component.registry.timeout=300

You can also change the timeouts at the component level using the following three properties:

1. adobe.all-component.timeout: overwrites the timeouts of all the Services of the Product.
2. adobe.<serviceName>.timeout: overwrites the timeout only for the service (<serviceName>) mentioned in the key. If the value at service level is set, then using this command only overwrites the timeout value for the specified service if it is set at Application level.
3. adobe.<serviceName>.<operationName>.timeout: It only overwrites the timeout for the specific service's operation(<serviceName>.<operationName>) mentioned in the key. If the value is set at Operation level, then using this command only overwrites the timeout value for the specified service if it is set at Application level or Service level.

Examples:

Use the following commands to set the timeout at component level:

1. To set all services's operations timeout to 600 sec: 
   set "JAVA_OPTS=%JAVA_OPTS% -Dadobe.all-component.timeout=600"
2. To set the DesigntimeService operation values timeout to 500 sec, use:
   set "JAVA_OPTS=%JAVA_OPTS% -Dadobe.DesigntimeService.timeout=500"
3. To set the DesigntimeService's previewLCA operation values timeout to 700 sec, use:
   set "JAVA_OPTS=%JAVA_OPTS% -Dadobe.DesigntimeService.previewLCA.timeout=700"
4. To set the DSC operations such as load, install, and so on to 600 sec, use:
   set "JAVA_OPTS=%JAVA_OPTS% -Dadobe.component.registry.timeout=600" 

Prerequisites to installing the QF

• Adobe LiveCycle ES4 SP1 (11.0.1)

Installing and configuring the QF

1. Take a backup of the <LiveCycle_root>/deploy folder. It is required if you decide to uninstall the quick fix.
2. Stop your application server.
3. Extract the QF archive file to your hard drive.
4. In the directory named according to the operating system that you are using:
   
   • Windows
     Navigate to the appropriate directory on the installation media or folder on your hard disk where you copied the installer, and double-click the lces4_qf_install.exe file.
     • (Windows 32-bit) CDROM_Installers\Windows\Disk1\InstData\VM
     • (Windows 64-bit) CDROM_Installers\Windows_64Bit\Disk1\InstData\VM
   • Linux, Solaris, AIX
     Navigate to the appropriate directory, and from a command prompt, type ./lces4_qf_install.bin.
     • (Linux) CDROM_Installers/Disk1/InstData/NoVM
     • (Solaris) CDROM_Installers/Disk1/InstData/NoVM
     • (AIX) CDROM_Installers/Disk1/InstData/VM
       

   This launches an install wizard that guides you through the installation.

5. On the Introduction panel, click Next.
6. 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 LiveCycle ES4 SP1 is currently installed, and click Next.
7. Read the Quick Fix Patch Summary information and click Next.
8. Read the Pre-Installation Summary information and click Install.
9. When the installation is complete, click Next to apply the quick fix updates to your installed files.
10. The Start Configuration Manager checkbox is selected by default. Click Done to run the Configuration Manager.

    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 [LiveCycle root]/configurationManager/bin directory.

11. (JBoss only) If you are using connectors, edit the classpath mentioned in the following files and update the version of commons-collections-3.1.jar with commons-collections-3.2.2.jar:
    • ConfigurationManager.bat/sh,
      
    • ConfigurationManager.lax,
      
    • ConfigurationManager_IPv6.lax,
      
    • ConfigurationManagerCLI.bat/sh
12. Depending on your application server, choose one of the following documents and follow the instructions in the Configuring and Deploying LiveCycle section.
    • Installing and Deploying LiveCycle ES4 for JBoss
    • Installing and Deploying LiveCycle ES4 for WebSphere
    • Installing and Deploying LiveCycle ES4 for WebLogic
13. (JBoss only) After installing the patch and configuring the server, delete tmp and work directories of JBoss application server.
    
14. Restart the server machine.

Impacted LiveCycle modules

• LiveCycle Core