Upgrade Considerations

    Content Services (deprecated) EAR fails to deploy during upgrade

    Note: Adobe is migrating Adobe® LiveCycle® Content Services ES customers to the Content Repository built on the modern, modular CRX architecture, acquired during the Adobe acquisition of Day Software. The Content Repository is provided with LiveCycle Foundation and is available as of the LiveCycle ES3 release.

    While upgrading to LiveCycle, deployment of the Adobe® LiveCycle® Content Services 9 (deprecated) EAR may fail with the following exception message:

    SchemaBootstr E org.alfresco.util.LogUtil error Schema auto-update failed org.alfresco.error.AlfrescoRuntimeException: A previous schema upgrade failed or was not completed. Revert to the original database before attempting the upgrade again.

    This issue occurs when the ALF_BOOTSTRAP_LOCK table is present in the LiveCycle database.

    EAR deployment failure due to high WebSphere resource utilization

    Content Services deployment may fail during upgrade if the WebSphere application server resource utilization is high.

    To resolve this issue, perform the following procedures.

    Restoring the contents of lccs_data and the database from backup

    1. Revert to the original Content Services database by restoring the tables beginning with alf and avm from the backup copy of the database.

    2. Restore the contents of the Content Store root location from the backup copy.

    Increasing the total transaction lifetime timeout value

    1. In the WebSphere Administrative Console, click Servers > Server Types > WebSphere application servers and then click the server name.

    2. Click Container Settings > Container Services > Transaction Service.

    3. On the Configuration tab, set the value of the Total transaction lifetime timeout setting to 900 seconds.

    4. Click Apply or OK.

    5. Restart the application server.

    Deploying the EARs in a different order

    Initiate the upgrade again. Now, in Configuration Manager, deploy the Content Services EAR before deploying the other EARs.

    1. On the Deploy LiveCycle EARs screen, select adobe-contentservices.ear and then click Deploy.

    2. Once the Content Services EAR has deployed successfully, deselect adobe-contentservices.ear, select the other EARs, and click Deploy.

    EAR deployment failure due to the ALF_BOOTSTRAP_LOCK database table

    If the ALF_BOOTSTRAP_LOCK table is present in the LiveCycle database, Content Services EAR deployment may fail during upgrade.

    To resolve this issue, follow these steps:

    1. Restore the contents of lccs_data and the database from backup. See EAR deployment failure due to high WebSphere resource utilization.

    2. Delete the ALF_BOOTSTRAP_LOCK table from the LiveCycle database and reinitiate the upgrade.

    3. Deploy the Content Services EAR and then deploy the other EARs. See EAR deployment failure due to high WebSphere resource utilization.

    Content Services (deprecated) EAR file is not deployed to all nodes during upgrade

    When upgrading to Content Services on a cluster, the Content Services EAR file is deployed to the first node but not to the other cluster nodes. The following two workarounds resolve this issue, but each has its drawbacks. Review each workaround to determine which is the best solution for your environment.

    • During upgrade, while configuring the Content Services EAR file using Configuration Manager, point the Index Root directory for LiveCycle to a location different from what was specified for the previous version of LiveCycle. This workaround allows you to start all the nodes in the cluster.

      Note: With this option, the LiveCycle server can take a long time to start up if you have a lot of content saved in the Content Services repository. This is because each node of the cluster attempts to recreate the indexes.

    • While deploying the EAR files, make sure that only one of the nodes of the cluster is started and specify the details pertaining to only that node during the entire upgrade process. This step ensures that the LiveCycle server only updates the indexes rather than recreating them.

      Once the node starts successfully, manually copy the indexes directory from that node to the other nodes of the cluster where you do not plan to run Configuration Manager. Now, start the other nodes of the cluster. The Content Services EAR file will now be successfully deployed to all cluster nodes.

      Note: Although this workaround is time-consuming to implement, it ensures minimal server downtime during startup.

    // Ethnio survey code removed