Any lifecycle management tool that supports the Tracked Resource Set (TRS) specification
can be a data provider for the Lifecycle Query Engine
(LQE) index. If the lifecycle management application has a root services document that
declares its OAuth URLs, you can register the TRS feed for that data provider by using the root
services URL. This is an easy method for adding an LQE data
provider if the application is registered with a different Jazz® Team Server than LQE.
When LQEcommunicates with the TRS provider (the lifecycle management application), it authenticates
directly with the application.
Procedure
-
From the LQE
administration page, go to Data Providers at
http://<host_name>:<port>/lqe/web/admin/data-sources.
This page shows the live status of the data providers LQE is
connected to.
-
Click Add Data Provider and select Root Services
URL.
-
Enter the root services document for the application you want to add. The format of the URL is:
https://server:port/tool/rootservices.
In the root services document, the data providers are listed in this format:
https://server:port/tool/trs. Select the
data provider that you want to add.
Note: If the data provider that you need is not listed in the
root services document, enter the service contribution resource (SCR) URL in the Root
Services URL field. For example, to add the TRS 2.0 for DNG
Resources data provider, enter
https://server:port/rm/scr instead of the
root services document.
-
Add a label as an identifier for the data provider.
- Optional:
The scheduling fields allow you to set when the initial indexing will
occur. If you leave the fields blank, the index is created as soon as the wizard finished. 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 providers simultaneously. Each one runs on its own thread.
Alternatively, you can schedule the initial indexing of multiple TRS data providers to run one after
the other.
-
Choose to specify the OAuth authentication, and click Next.
-
On the Specify Authentication Details panel, enter the OAuth Consumer
Key and Secret for the application.
-
Configure the data provider.
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 or LDX
attempts to access the data provider to refresh the index. A data provider that is not updated
frequently can have a slower refresh rate than a data provider that is updated continuously.
Increasing the refresh rate has a performance impact.
- The refresh rate specifies how often LQE or LDX
attempts to access the data provider to refresh the index. A data provider that is not updated
frequently can have a slower refresh rate than a data provider 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 provider should be
between 2 and 4. Each thread is roughly equivalent to one user using the LQE or LDX
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 LQE or LDX to
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.
What to do next
To stop indexing a data provider, click the name of the data provider
in the list, and click the Pause indexing icon.