Connecting Lifecycle Query Engine to applications that use the same Jazz Team Server

Lifecycle Query Engine (LQE) can index data from any lifecycle management tool that supports the Tracked Resource Set (TRS) specification. If LQE and its data sources share the same Jazz™ Team Server (JTS), it's easy to configure the communication because JTS can share settings with LQE.

Before you begin

Ensure that LQE functional user (lqe_user) was created in the JTS, as described in Connecting Lifecycle Query Engine to applications that use a different Jazz Team Server.

Procedure

  1. From the LQE administration page, go to Data Sources at http://<host_name>:<port>/lqe/web/admin/data-sources. This page shows the live status of the data sources that LQE is connected to.
    Screen capture of the data sources panel showing a data source being indexed.
  2. Click Add Data Source.
    Screen capture of the Add Data Source wizard.
    If you ran the setup wizard, the TRS feeds for applications that share the JTS with LQE are listed on the page in this format: https://server:port/tool/trs. Some feeds contain application resources. Process feeds contain data for timelines, iterations, projects, and teams.
    1. Select the data source that you want to add. To see what TRS feeds are provided by the applications in IBM Engineering Lifecycle Management, read about Choosing what Tracked Resource Set feeds to add to Lifecycle Query Engine. The table in this topic helps you decide what TRS feeds to configure.
    2. Enter a label as an identifier for the data source.
    3. Optional: Specify the date and time for the initial indexing. If you leave the fields blank, the index is created as soon as the wizard finishes. In a test lab environment, LQE can index 50,000 artifacts in less than 1 hour. Depending on your hardware and configuration, you might experience a slower indexing rate.
      Note: You can index multiple data sources simultaneously. Each one runs on its own thread. Alternatively, you can schedule the initial indexing of multiple data sources to run one after the other.
    4. For applications that use the same JTS as LQE, authentication is not necessary. If you want to change the authentication type, select what authentication to use.
  3. Configure the data source.
    Screen capture of the "Configure Data Source" panel of the Add Data Source wizard
    Hover over the question marks next to the property labels to find out details about the properties and their values.
    • The refresh rate specifies how often LQE attempts to access the data source to refresh the index. A data source that is not updated frequently can have a slower refresh rate than a data source that is updated continuously. Increasing the refresh rate has a performance impact.
    • The refresh rate specifies how often LQE attempts to access the data source to refresh the index. A data source that is not updated frequently can have a slower refresh rate than a data source that is updated continuously. Increasing the refresh rate has a performance impact.
    • The number of threads to fetch artifacts when adding or reindexing the data source should be between 2 and 4. Each thread is roughly equivalent to one user using the LQE server. On Intel systems, if you use more than 4 threads, the improvement in data retrieval speed is minimal.
    • The option to continue with change log processing if resources are skipped, allows LQEto log an error and continue indexing after encountering a resource that cannot be indexed. This option is selected by default. If you disable it, the indexing process stops when a resource cannot be indexed.
  4. Click Save to start indexing or to activate the indexing schedule.

What to do next

To stop indexing a data source, click the name of the data source in the list, and click the Pause indexing icon.
Screen capture of the Pause indexing button on the data source page.

Feedback