Installing LQE and LDX on WebSphere Liberty Server

Edit online

Review the following steps to install the LQE or LDX with WebSphere Liberty Server.

Procedure

  1. Rename the new lqe.war or ldx.war file as lqe.war.zip or ldx.war.zip.
  2. Stop the WebSphere Liberty Server.
  3. Take a back up of one of the following files if you want to revert the patch.
    • <LQE_installation_directory>\server\liberty\servers\clm\apps\lqe.war.zip
    • <LQE_installation_directory>\server\liberty\servers\clm\apps\ldx.war.zip
  4. Delete one of the following set of files.
    Option Description
    Lifecycle Query Engine
    • <LQE_installation_directory>\server\liberty\servers\clm\apps\lqe.war.zip
    • <LQE_installation_directory>\server\liberty\clmServerTemplate\apps\lqe.war.zip
    Link Index Provider
    • <LDX_installation_directory>\server\liberty\servers\clm\apps\ldx.war.zip
    • <LDX_installation_directory>\server\liberty\clmServerTemplate\apps\ldx.war.zip
  5. Delete one of the following set of directories:
    Option Description
    Lifecycle Query Engine
    • <LQE_installation_directory>\server\liberty\servers\clm\apps\lqe.war
    • <LQE_installation_directory>\server\liberty\clmServerTemplate\apps\lqe.war
    Link Index Provider
    • <LDX_installation_directory>\server\liberty\servers\clm\apps\ldx.war
    • <LDX_installation_directory>\server\liberty\clmServerTemplate\apps\ldx.war
  6. Place the new lqe.war.zip or ldx.war.zip file in the following directories:
    • <LQE_installation_directory>\server\liberty\servers\clm\apps
    • <LQE_installation_directory>\server\liberty\clmServerTemplate\apps
  7. Unzip the new lqe.war.zip or ldx.war.zip file into the following directories:
    Option Description
    Lifecycle Query Engine
    • <LQE_installation_directory>\server\liberty\servers\clm\apps\lqe.war
    • <LQE_installation_directory>\server\liberty\clmServerTemplate\apps\lqe.war
    Link Index Provider
    • <LDX_installation_directory>\server\liberty\servers\clm\apps\ldx.war
    • <LDX_installation_directory>\server\liberty\clmServerTemplate\apps\ldx.war
  8. Start the server.
  9. To verify that the patch is successfully installed, complete the following steps:
    1. After the server starts, open the Lifecycle Query Engine or Link Index Provider home page.
    2. After the server starts, open the Lifecycle Query Engine or Link Index Provider home page.

What to do next

  1. The Lifecycle Query Engine or Link Index Provider automatically detects whether it is required to migrate data from an existing instance. If data migration is required, a Start Migration button is displays on the main Lifecycle Query Engine or Link Index Provider page at https://<server:port>/lqe/web/admin/data-sources or https://<server:port>/lqe/web/admin/data-sources. If the button is displayed, click Start Migration.
  2. Reindex the data sources as required.
  3. Add clm_undeploy.py and clm_undeploy_distributed.py files using the following steps:
    1. If you want to revert the patch, take a back up of the following files:
      • <server_installation_directory>/server/was/clm_undeploy.py
      • <server_installation_directory>/server/was/clm_undeploy_distributed.py
    2. Delete the following files:
      • <server_installation_directory>/server/was/clm_undeploy.py
      • <server_installation_directory>/server/was/clm_undeploy_distributed.py
    3. Place the new clm_undeploy.py file in <server_installation_directory>/server/was.
    4. Place the new clm_undeploy_distributed.py file in <server_installation_directory>/server/was.