Cloning the LQE1 instance to create another instance named LQE2

Generate a cloned instance named LQE 2 from a backup of the original Lifecycle Query Engine instance (LQE 1). To configure an Lifecycle Query Engine backup schedule, see Backing up and restoring Lifecycle Query Engine and Link Index Provider.

Note: Context root of LQE 2 must be the same as LQE 1.

A backup contains all the type system model in Lifecycle Query Engine and a copy of the indexed data.

Procedure

  1. Run an Lifecycle Query Engine backup on the original LQE instance (LQE 1).
  2. Install Lifecycle Query Engine in a new servlet engine. You do not need to configure a new Jazz® Team Server or application server.
  3. Create a relational database for the new Lifecycle Query Engine instance (LQE2).
  4. Before you start the LQE 2 instance for the first time, complete the following steps:
    1. Copy the following folders from the LQE 1 instance to the LQE 2 instance:
      • Copy /datasets into conf/lqe
      • Copy /metadata into conf/lqe
    2. Copy the lqe.key and lqe.node.id files from the LQE1 instance into the conf/lqe folder in the LQE2 instance.
    3. In the /server/conf/lqe/lqe.properties file of the LQE2 instance, set this Lifecycle Query Engine property: lqe.restore=true
    4. Optional: Specify a name for the new installation, such as LQE2. In the lqe.node.id file in the new installation, edit the lqe.node.name property to specify the new name. Do not change the lqe.node.id property.
  5. Start the LQE 2 instance and configure the database connection.

    It might take a while for the LQE 2 instance to start.

    1. Go to the JTS Setup page at https://[fully qualified hostname]:9443/jts/setup
    2. Select Custom Setup and advance through the pages until you reach the Register Applications page. Do not change any of the existing values.
    3. On the Register Applications page, register the new LQE installation.
      1. Click Add Application.
      2. In the Discovery URL field, enter the https://[fully qualified hostname]:[port]/lqe/scr value using the hostname and port of the new Lifecycle Query Engine installation.
      3. In the Application Instance field, enter a name that is different from any of the existing Lifecycle Query Engine installations. The name does not need to match the context root of the installation.
    4. Finish JTS setup. Do not change any of the existing values.
    5. Go to https://host:port/lqe. A configuration page is shown. Enter the database connection information for a new, empty Lifecycle Query Engine database. Do not use the same database as the LQE1 instance.
    6. Save your changes.
    The Lifecycle Query Engine home page is shown, which lists the data providers for the LQE 2 instance.
  6. Validate the LQE 2 instance. Go to the Lifecycle Query Engine page for the LQE 2 instance and verify that the same data providers are configured for both instances. Verify that the data providers update successfully.

Results

You now have two Lifecycle Query Engine instances that contain the same-indexed data and historical trend data. You can now reindex the LQE 2 instance. The LQE 1 instance handles reporting requests and continues to collect historical trend data.