Lifecycle Query Engine configuration properties
Administrators can configure the way Lifecycle Query Engine operates by using the properties in the Lifecycle Query Engine Administration pages or release configuration (lqe.releaseconfig.properties) file.
For more information on the release configuration file, see Configuring Lifecycle Query Engine and connecting to external databases by using properties files.
SPARQL Service page
This table lists the
properties in the
page along with the corresponding release configuration file properties and their description.
| UI property | Release configuration file property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|---|
| SPARQL Service Configuration - Query | ||||
| Query Service Enabled | query.accessControlEnabled | Enable or disable query services. | LQE Jena | Enabled |
| Query Result Set Limit | query.resultSetLimit | Limit the query result size to this value. | LQE Jena | 3000 |
| Enforce Query Result Set Limit | query.resultSetLimitEnabled | Enforce the limit query result size. | LQE Jena | Enabled |
| Query Timeout (seconds) | query.timeout | Length of time until the query is forced to timeout | LQE Jena | 600 seconds |
| Elapsed time past the timeout for a rogue query (seconds) | query.rogueQueryLimitSeconds | Length of time after the query times out before Lifecycle Query Engine determines that the query is rogue | LQE Jena | 180 seconds |
| HTTP Response Caching Enabled | query.httpResponseCachingEnabled | Enable the HTTP cache-control response header ("cache-control"). | LQE Jena | Enabled |
| HTTP Response Max Age (seconds) | query.httpResponseMaxAgeSeconds | HTTP cache response header for the maximum time before a cached copy of a resource expires (max-age) | LQE Jena | 120 |
| Query Result Caching Enabled | query.resultCachingEnabled | Enable Lifecycle Query Engine query result caching. | LQE Jena | Enabled |
| Query Result Cache Expiration (seconds) | query.resultCacheExpirationSeconds | Maximum time to keep Lifecycle Query Engine query cache results | LQE Jena | 120 |
| Forcefully cancel rogue queries when detected | query.rogueQueryRestart | Stop a rogue query when it is detected. | LQE Jena | Enabled |
| SPARQL Service Configuration - Timeout Monitoring | ||||
| Default Query Timeouts Warning Threshold (% Usage 1-99) | query.timeoutsLow | Minimum percentage of query timeouts before the warning threshold is reached | LQE Jena | 5 |
| Default Query Timeouts Critical Threshold (% Usage: 1-99) | query.timeoutsHigh | The minimum percentage of query timeouts before the critical threshold is reached | LQE Jena | 20 |
| The hour of each day to generate query reports (1-24) | query.reportHourOfDay | The hour of the day to send notifications about timed out queries | LQE Jena | 24 |
| SPARQL Service Configuration - Load Shedding | ||||
| Query Load Shedding Enabled | query.loadEnabled | Enable or disable query load shedding. | LQE Jena | Enabled |
| Default Memory Warning Threshold (% Usage: 1-99) | query.memoryLow | Memory warning threshold | LQE Jena | 75 |
| Default CPU Warning Threshold (% Usage 1-99) | query.cpuLow | CPU warning threshold | LQE Jena | 75 |
| Default Native Memory Warning Threshold (% Usage: 1-99) | query.phyLow | Native memory warning threshold | LQE Jena | 75 |
| Default System CPU Warning Threshold (% Usage 1-99) | query.sysLow | System CPU warning threshold | LQE Jena | 75 |
| Default Memory Critical Threshold (% Usage: 1-99) | query.memoryHigh | Memory critical threshold | LQE Jena | 95 |
| Default CPU Critical Threshold (% Usage: 1-99) | query.cpuHigh | CPU critical threshold | LQE Jena | 95 |
| Default Native Memory Critical Threshold (% Usage: 1-99) | query.phyHigh | Native memory critical threshold | LQE Jena | 95 |
| Default System CPU Critical Threshold (% Usage: 1-99) | query.sysHigh | System CPU critical threshold | LQE Jena | 95 |
| Max time of a fast query (milliseconds) | query.fastQueryLimitMilliseconds | The execution time for a query to be considered a fast query for load shedding. | LQE Jena | 3000 |
| SPARQL Service Configuration - Access Control | ||||
| Ignore data provider Access Controls | query.accessControlEnabled | Enable or disable access control. | LQE Jena | Disabled |
Compaction pages
This table lists the
properties in the Lifecycle Query Engine> Administration>
Compaction pages along with the corresponding release configuration file
properties and their description.
| UI property | Release configuration file property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|---|
| Compaction Properties | ||||
| Enable Compactions | compaction.enable | Enable compaction. | LQE Jena | Enabled |
| Run Node | compaction.nodeid | Lifecycle Query Engine node ID to compact | LQE Jena | Blank |
| Run Days | compaction.days | Days on which to execute a compaction. | LQE Jena | Saturday |
| Run Time | compaction.time | Time to do compaction. | LQE Jena | 2:00AM |
Advanced Properties page
This table lists the
properties in the page along with
the corresponding release configuration file properties and their description.
| UI property | Release configuration file property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|---|
| Advanced Properties Configuration - HTTP | ||||
| Connection Timeout (seconds) | app.http.connectionTimeout | HTTP connection timeout | LQE Jena and LQE relational store | 60 |
| Socket Timeout (seconds) | app.http.socketTimeout | HTTP socket timeout | LQE Jena and LQE relational store | 300 |
| Advanced Properties Configuration - TRS Processing | ||||
| Create Index for Full Text Search | dataset.provider.useFtsIndexes | Clear this checkbox to disable creation of the text indexes. Jazz® Reporting Service
reports that use Lifecycle Query Engine as the data source do not use the full-text search
(FTS) capability that is provided by the Lucene library. Link Index Provider also does not
use FTS. After you disable FTS, the Full Text Search tab is not present on
the LQE Query page. Note:
|
LQE Jena and LQE relational store | Enabled |
| Advanced Properties Configuration - NTP Time Synchronization | ||||
| NTP Server Address | app.ntp.server | Network time protocol server URL | LQE Jena and LQE relational store | Blank |
| Maximum Allowed Offset (milliseconds) | app.ntp.max.interval | The maximum difference allowed in milliseconds between server times | LQE Jena and LQE relational store | 300000 |
| Advanced Properties Configuration - Troubleshooting | ||||
| Expiration period for downloaded TRS feeds (hours) | app.downloadlink.timeout | The number of hours to keep a TRS feed download before deleting it from the file system. | LQE Jena and LQE relational store | 48 |
| Number of slowest queries to receive in email | query.maxQueries | The number, which must be between 1 and 999, of slowest queries that are emailed to the Jazz Reporting Service admin. | LQE Jena and LQE relational store | 10 |
Internal Properties page
This table lists the
properties in the page along with the corresponding release configuration file
properties and their description.
Note: You can view the internal properties by clicking the
Show Internal Properties button in the Advanced
Properties page.
Note: You can view the internal properties by clicking the Show Internal
Properties button in the Advanced Properties page.
| UI property | Release configuration file property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|---|
| Internal Properties Configuration - Query | ||||
| Stream Result Set | query.streamingResultsEnabled | Enable or disable query result streaming. | LQE Jena | Disabled |
| Validate Text Query Pattern | query.validateFtsPattern | Notify users about unsupported characters in an FTS query. | LQE Jena | Disabled |
| Maximum SPARQL Query Log Size (bytes) | query.logStringLimit | Limit the maximum length of the SPARQL query which Lifecycle Query Engine logs. | LQE Jena | 10240 bytes |
| Minimum Text Match Score | query.ftsMinScore | Set the minimum full-text search score for the query results. | LQE Jena | 0 |
| Maximum Text Query Bindings | query.ftsMaxBindings | Limit the number of Lucene results, which get bound in a SPARQL execution. | LQE Jena | 10000 |
| Maximum Text Query Clauses | dataset.provider.ftsMaxClause | Maximum number of clauses in a full-text search query. | LQE Jena | 1024 |
| Text Index Language | dataset.provider.ftsLang | Specify a language used for full-text search. Note: Only applicable to the Japanese
language.
|
LQE Jena | English |
| Maximum Pending Writebacks | dataset.provider.maxPendingWritebacks | A Journal is a Jena TDB write-ahead log, and this property is the threshold when stack suspension is enabled if the number of transactions in the journal exceed this maximum. | LQE Jena | 50 |
| Heap Usage Threshold | dataset.provider.heapUsageThreshold | This value, representing a percentage, indicates the threshold the JVM heap must reach before incoming activities are suspended if Suspension Enabled is enabled. For example, if Suspension Enabled is checked, and the value of the Heap Usage Threshold is 0.85, all incoming activities are suspended when the JVM heap utilization reaches 85% of maximum heap space. | LQE Jena | 0.85 |
| Heap Suspension Enabled | dataset.provider.heapSuspensionEnabled | Enables or disables suspension of incoming queries when the heap utilization reaches the percentage value that is specified in Heap Usage Threshold | LQE Jena | Disabled |
| Stack Suspension Enabled | dataset.provider.stackSuspensionEnabled | Enables or disables suspension of incoming queries when the number of pending Journal Writebacks reaches the value that is specified in Maximum Pending Writebacks | LQE Jena | Enabled |
| Suspend Timeout (seconds) | dataset.provider.suspendedTimeout | The maximum amount of time in seconds that incoming queries must be suspended. | LQE Jena | 800 seconds |
| Remove Temporary Properties | dataset.provider.removeTempProperties | Indicate whether Lifecycle Query Engine must remove temporary internal properties from graphs before the graph is committed. | LQE Jena | Enabled |
| Filter Internal Properties | dataset.provider.filterInternalProperties | Indicate whether Lifecycle Query Engine must filter internal metadata from query results. | LQE Jena | Enabled |
| Disable All Data History Filter | query.disableMetricFilter | When querying the historical data partition without a configuration context, return trend data from any configuration context instead of only trend data collected without a configuration context. | LQE Jena | Disabled |
| Show missing, skipped, and out of date resources on the Query Statistics page. When enabled, queries might run slower. | query.traceConfigs | Run a report completeness check on all queries. Note: This setting must be used only for
troubleshooting or debugging.
|
LQE Jena | Disabled |
| Internal Properties Configuration - HTTP | ||||
| ACP Connection Timeout (seconds) | query.acp.httpConnectionTimeout | ACP HTTP connection timeout | LQE Jena | 5 seconds |
| ACP Socket Timeout (seconds) | query.acp.socketTimeout | ACP HTTP socket timeout | LQE Jena | 5 seconds |
| Maximum Total Connections | app.http.maxTotalConnections | Maximum number of HTTP connections | LQE Jena | 250 |
| Maximum Connections Per Route | app.http.maxConnectionsPerRoute | Maximum number of HTTP connections per route | LQE Jena | 50 |
| Internal Properties Configuration - TRS Processing | ||||
| Selections Relational Database Batch Size | lqe.indexer.selectionsBatchSize | The number of selects (selects in a selection) allowed in each batch of updates to the RDB. | LQE Jena | 425 |
| Enable Selections Relational Database Batch | lqe.indexer.selectionsBatchEnabled | Choose to enable batching of inserts - it appears to be slower in some database vendors. | LQE Jena | Enabled |
| Selections Relational Database Maximum Retries per Batch | lqe.indexer.selectionsMaxRetries | The maximum number of retries on each batch of updates to the RDB. | LQE Jena | 3 |
| Selections Cache Expiration (seconds) | lqe.indexer.selectionsCacheExp | The time in the seconds after which the entries in the selections cache expires. | LQE Jena | 120 |
| JDBC Page Size for Selections Queries | app.jdbc.selectionsPageSize | The number of results that are sent over the network at a time to Lifecycle Query Engine when querying the database for indexed configuration data. These are internal queries for Lifecycle Query Engine to assemble data, and the value does not affect the results that are returned by Lifecycle Query Engine reports. | LQE Jena | 500 |
| Write Queue Size | indexer.batchDescriptorQueueSize | Maximum number of batches that an indexing agent has queued for writing at any point. Beyond that the agent waits for the writer to catch up. | LQE Jena | 25 |
| Batch Size for Writes | indexer.batchSize | The number of triples that are allowed in each batch of updates to the Jena TDB. | LQE Jena | 2500 |
| Batches Between Status Writes | indexer.batchesBetweenStatusWrites | The number of batch writes that must happen before the indexing agent writes its status to the database. A value of 0 indicates that the status must be updated on every batch write. | LQE Jena | 4 |
| Process Queue Size | indexer.fetcherTaskQueueSize | Maximum number of fetcher tasks that an indexing agent has queued for fetching at any point. | LQE Jena | 100 |
| Strict Syntax Mode | indexer.fetcherStrictSyntaxEnabled | If disabled, Lifecycle Query Engine drops invalid triples from resources when possible. If enabled, syntax errors are not ignored. Any resources with syntax errors show up as errors. | LQE Jena | Disabled |
| Use Dynamic Fetcher Thread Count | indexer.dynamicFetcherThreadCountEnabled | When enabled, the indexer keeps adding fetcher threads until it sees that a new thread didn't improve the fetch rate. | LQE Jena | Disabled |
| Batch Queue Size | indexer.namedGraphUpdateQueueSize | Batch queue size for writing - default is 2500 triples per batch, 1 batch = 1 commit | LQE Jena | 500 |
| Deletion Task Query Timeout (seconds) | indexer.deletionTaskQueryTimeout | The SPARQL query timeout (in seconds) for the query to execute deletion and cleanup tasks. | LQE Jena | 1200 |
| Deletion Task Query Limit | indexer.deletionTaskQueryLimit | Batch size for deletions, for example if 1000, the agent queries for 1000 resources to delete, delete them, then repeat until there are no more to delete. | LQE Jena | 1000 |
| Deletion Task Query Retry Attempts | indexer.deletionTaskQueryRetries | Lifecycle Query Engine must execute queries to find items to delete when removing a data provider. This method returns the number of attempts for each deletion task query if it times out. | LQE Jena | 3 |
| TRS HTTP Cache Enabled (requires restart) | indexer.trsHttpResponseCacheEnabled | Choose to enable the TRS HTTP response cache. | LQE Jena and LQE relational store | Enabled |
| TRS HTTP Cache Max Entries | indexer.trsHttpResponseCacheMaxEntries | The maximum number of entries allowed in the TRS HTTP response cache. | LQE Jena and LQE relational store | 100 |
| Data Providers Refresh Interval (seconds) | indexer.datasources.refresh.interval | The interval period in which the data providers page results refresh. | LQE Jena and LQE relational store | 4 |
| String Truncation and Logging of Large Resources Enabled | indexer.content.threshold.enabled | Choose to enable logging resources whose content goes over a specific threshold. | LQE Jena and LQE relational store | Enabled |
| Minimum Size of a Large Resource (bytes) | indexer.content.threshold.length | The threshold length (in bytes) of the content is to be logged. | LQE Jena and LQE relational store | 2500000 |
| String Truncation Length for Large Resources (characters) | indexer.string.truncation.length | The number of characters to truncate from string literals in incoming data. | LQE Jena and LQE relational store | 5000 |
| Maximum Number of TRS Download Files to Keep for Each Data Provider | indexer.max.trs.download.files | The maximum number of TRSDownload files created during validation to be kept in the file system. | LQE Jena and LQE relational store | 5 |
| Maximum number of fetched pages to be loaded in memory | indexer.fetched.pages.threshold | The maximum number of pages to be added to the model in memory, all the other pages go to disk. | LQE Jena and LQE relational store | 100 |
| Maximum Number of Change Log Entries to Store for Verification | indexer.maxPreviousChangeEntries | The maximum number of change events to be stored for the verification of the previous change log entries against the TRS feed. If the number of change log entries that are processed goes over the threshold, then no entries are stored and there is no verification during the next Change Log Task. | LQE Jena and LQE relational store | 10000 |
| Internal Properties Configuration - Health Metrics | ||||
| Health Metrics Maximum Age (ms) | app.metrics.maxAge | Maximum age for metrics in milliseconds before they are scrubbed from database. | LQE Jena and LQE relational store | 604800000 milliseconds |
| Health Metrics Scrubber Period (ms) | app.metrics.scrubberPeriod | The time in milliseconds when the scrubber wakes up to scrub the database. | LQE Jena and LQE relational store | 7200000 milliseconds |
| Health Metrics Graph Count Period (ms) | dataset.provider.graphCountMetricWriteInterval | How frequently graph count metrics are written. | LQE Jena and LQE relational store | 60000 milliseconds |
| Maximum Number of Query Health Metrics | app.metrics.maxQueryMetrics | Maximum number of query metrics kept in the database | LQE Jena and LQE relational store | 500 |
| Memory and Dataset Health Metrics Push Rate (seconds) | app.memoryAndDatasetMetricsPushRateSeconds | The number of seconds between updates to the memory and dataset metrics | LQE Jena and LQE relational store | 60 seconds |
| Maximum Number of Metric Delivery Attempts | app.metrics.maxDispatchAttempts | The maximum number of times the dispatcher attempts to deliver any individual metric to a destination. | LQE Jena and LQE relational store | 3 |
| Delay Before Retrying Failed Metric Delivery (seconds) | app.metrics.dispatchRetryDelay | The number of seconds to wait before retrying a failed metric delivery. | LQE Jena and LQE relational store | 20 |
| Number of days to be included in the Validation Feed | app.metrics.validationFeedNumDays | The number of days to be included in the validation feed. | LQE Jena and LQE relational store | 30 |
| Internal Properties Configuration - Authorization | ||||
| Anonymous Feed Access Enabled | app.authorization.annonymousFeedAccessEnabled | Enable or disable feed access. | LQE Jena and LQE relational store | Disabled |
| Internal Properties Configuration - Access Control | ||||
| LDAP Group Synchronizer Interval (minutes) | app.ldap.group.synch.interval.minutes | Period the LDAP groups are synchronized with LDAP directories | LQE Jena and LQE relational store | 30 minutes |
| Access Context List Refresh Rate (minutes) | app.acl.refreshRateMinutes | Period when the Access Context Lists are refreshed. | LQE Jena and LQE relational store | 15 minutes |
| Use case-insensitive user ID matching | app.ac.case.insensitive | Manually set user ID case-insensitive matching. Indicate to Lifecycle Query Engine to use case-insensitive comparisons for user IDs in access control. | LQE Jena and LQE relational store | Disabled |
| Access Context Synchronizer Refresh Rate (minutes) | app.acsync.refreshRateMinutes |
Period that Access Contexts are synchronized with Jazz Team Server membership (in minutes). You can change this default interval from to reduce the refresh time of project membership information. For example, before you add members to a project in an Engineering Lifecycle Management application, you might change this interval to 1 minute so that the new project members can see the information that they need in Report Builder sooner. After LQE refreshes, change the interval back to its previous or default value. |
LQE Jena and LQE relational store | 15 |
| JTS Properties Synchronizer Refresh Rate (minutes) | app.jtssync.refreshRateMinutes | Period a background process wakes up to monitor changes to the Use case-insensitive user ID matching property in JTS | LQE Jena and LQE relational store | 25 |
| Internal Properties Configuration - User Search | ||||
| User Search Maximum Number of Users Returned | app.user.search.max.results | The maximum number of users to display from an LDAP search. | LQE Jena and LQE relational store | 100 |
| User Search Timeout (seconds) | app.user.search.timeout.secs | The timeout value for ldap user search and selection (seconds) | LQE Jena and LQE relational store | 20 seconds |
| Internal Properties Configuration - Horizontal Scaling | ||||
| Node Heartbeat Interval (ms) | app.heartbeat.interval | Interval of time between node heartbeat correspondence | LQE Jena and LQE relational store | 60000 milliseconds |
| Missed Heartbeat Threshold (heartbeats) | app.heartbeat.threshold | Number of heartbeats missed until the node is considered offline. | LQE Jena and LQE relational store | 5 heartbeats |
| Configuration Refresh Rate (ms) | app.kvreader.refreshRateMillis | The Key Value Reader refresh rate for configuration changes in milliseconds | LQE Jena and LQE relational store | 1000 |
| User Metadata Refresh Rate (ms) | app.kvreader.userprefs.refreshRateMillis | The Key Value Reader refresh rate for user preference changes in milliseconds | LQE Jena and LQE relational store | 60000 |
| Vocabulary Refresh Rate (ms) | app.kvreader.vocab.refreshRateMillis | The Key Value Reader refresh rate for vocabulary changes in milliseconds | LQE Jena and LQE relational store | 60000 |
| Node Metadata Refresh Rate (ms) | app.kvreader.cache.refreshRateMillis | The Key Value Reader refresh rate for node metadata changes in milliseconds | LQE Jena and LQE relational store | 10000 |
| TRS Processing Metadata Refresh Rate (ms) | app.kvreader.state.refreshRateMillis | The Key Value Reader refresh rate for TRS state changes in milliseconds | LQE Jena and LQE relational store | 1000 |
| Temporary Data Refresh Rate (ms) | app.kvreader.temp.refreshRateMillis | The Key Value Reader refresh rate for temporary data changes in milliseconds | LQE Jena and LQE relational store | 1000 |
| Internal Properties Configuration - Load and Health Monitoring | ||||
| Monitor Native System Memory Load | app.load.monitorNativeMem | Enable monitoring native memory (RAM) usage by using the JMX data published by the JVM. | LQE Jena and LQE relational store | Disabled |
| Monitor CPU Usage Load | app.load.monitorCpu | Enable monitoring system and application CPU usage by using the JMX data that is published by the JVM. | LQE Jena and LQE relational store | Disabled |
| Load Monitor Refresh Rate (milliseconds) | app.load.refreshRateSeconds | The frequency in which the load monitor checks the system in milliseconds. | LQE Jena and LQE relational store | 60000 |
| Disk usage warning threshold (1-99%) | app.disk.low | If disk space usage is lesser than this percentage, then the disk usage is considered okay. | LQE Jena and LQE relational store | 75 |
| Disk usage critical threshold (1-99%) | app.disk.high | If disk space usage is higher than this percentage, then the disk usage is considered to be high. | LQE Jena and LQE relational store | 90 |
| Internal Properties Configuration - Backup | ||||
| Backup Database In Multiple Blocks | app.backup.prop.useBlocks | When backing up indexed configuration data, query for it in sorted blocks instead of all at once. | LQE Jena and LQE relational store | Disabled |
| Block Size for Database Backup (rows) | app.backup.prop.blockSize | The maximum size of each individual block to query for, if multiple blocks are used during the backup. | LQE Jena and LQE relational store | 1000000 |
| JDBC Fetch Size for Database Backup (rows) | app.backup.prop.fetchSize | The number of results that are sent over the network at a time to Lifecycle Query Engine when querying the database to back up indexed configuration data. | LQE Jena and LQE relational store | 1000 |
| Expected size of compressed backups (% of uncompressed size) | app.backup.prop.compressedSize | Estimates the required disk space to start a compressed backup. | LQE Jena and LQE relational store | 25 |
| Internal Properties Configuration - Compaction | ||||
| Maximum Heap MB (0 for 25% of current JVM heap) | app.compaction.maxHeapMB | The maximum heap for the compaction process | LQE Jena and LQE relational store | 4096 |
| Internal Properties Configuration - History Jobs | ||||
| Number of History Job Threads | app.historyJobs.numThreads | Specifies the number of threads to use for running history jobs. | LQE Jena and LQE relational store | 1 |
| History Job Timeout (seconds) | app.historyJobs.queryTimeout | The query timeout for metric jobs (in seconds) | LQE Jena and LQE relational store | 300 |
| Internal Properties Configuration - REST APIs | ||||
| Maximum time to keep response files on disk (in hours) | app.api.selconfig.maxTimePersistResponse | The maximum time the response of the Selection and Configuration APIs can be kept (in hours) | LQE Jena and LQE relational store | 24 |
| Maximum time to cache responses (in minutes) | app.api.selconfig.maxTimeCachingResponse | The maximum time the response of the Selection and Configuration APIs can be reused (in minutes) | LQE Jena and LQE relational store | 2 |
| Maximum number of elements per page | app.api.selconfig.maxPerPage | The maximum number of elements per page to be returned by the API. | LQE Jena and LQE relational store | 10000 |
| Number of REST API tasks threads | app.api.selconfig.numThreads | The number of threads for the Paging API executor. | LQE Jena and LQE relational store | 1 |
| Remove archived JTS users from email notifications | app.api.notification.remove.archived.jts.users | When sending notification emails, do not send to any recipient whose email address matches an archived user in JTS. | LQE Jena and LQE relational store | Enabled |
Backup pages
This table lists the
properties in the Lifecycle Query Engine> Administration>
Backup pages along with the corresponding release configuration file properties
and their description.
| UI property | Release configuration file property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|---|
| Backup Properties | ||||
| Enable Backups | backup.enable | Enable backup. | LQE Jena | Disabled |
| Run Node | backup.nodeid | Lifecycle Query Engine node ID to back up. | LQE Jena | Blank |
| Run Days | backup.days | Days on which to execute a backup. | LQE Jena | All Disabled |
| Run Time | backup.time | Time to do backup. | LQE Jena | 12:00AM |
| Compress Backups | backup.compressed | Enable backup compression. | LQE Jena | Disabled |
| Backup directory on server | backup.pathOnServer | Set the path on the server for backup data. | LQE Jena | Blank |
Notifications page
This table lists the
properties in the Lifecycle Query Engine> Administration>
Notifications page along with the corresponding release configuration file
properties and their description.
| UI property | Release configuration file property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|---|
| Notification Properties | ||||
| Backup events | notification.backupSuccessful.enabled | Receive email notifications when backup events are successful. | LQE Jena | Disabled |
| Backup events | notification.backupWarnings.enabled | Receive email notifications when backup event warnings are encountered. | LQE Jena | Disabled |
| Backup events | notification.backupFailures.enabled | Receive email notifications when backup event failures are encountered. | LQE Jena | Disabled |
| Daily Query Performance events | notification.queryLoadSuccessful.enabled | Receive email notifications when daily query performance events are successful. | LQE Jena | Disabled |
| Daily Query Performance events | notification.queryLoadWarnings.enabled | Receive email notifications when daily query performance event warnings are encountered. | LQE Jena | Disabled |
| Daily Query Performance events | notification.queryLoadFailures.enabled | Receive email notifications when daily query performance event failures are encountered. | LQE Jena | Disabled |
| Data provider events | notification.datasourceSuccessful.enabled | Receive email notifications when data provider events are successful. | LQE Jena and LQE relational store | Disabled |
| Data provider events | notification.datasourceWarnings.enabled | Receive email notifications when data provider event warnings are encountered. | LQE Jena and LQE relational store | Disabled |
| Data provider events | notification.datasourceFailures.enabled | Receive email notifications when data provider event failures are encountered. | LQE Jena and LQE relational store | Disabled |
| Disk usage events | notification.loadSuccessful.enabled | Receive email notifications when disk usage events are successful. | LQE Jena | Disabled |
| Disk usage events | notification.loadWarnings.enabled | Receive email notifications when disk usage event warnings are encountered. | LQE Jena | Disabled |
| Disk usage events | notification.loadFailures.enabled | Receive email notifications when disk usage event failures are encountered. | Lifecycle Query Engine Jena | Disabled |
| Load Monitoring events | notification.loadSuccessful.enabled | Receive email notifications when load monitoring events are successful. | Lifecycle Query Engine Jena | Disabled |
| Load Monitoring events | notification.loadWarnings.enabled | Receive email notifications when load monitoring event warnings are encountered. | LQE Jena | Disabled |
| Load Monitoring events | notification.loadFailures.enabled | Receive email notifications when load monitoring event failures are encountered. | LQE Jena | Disabled |
| Recipients | notification.recipients | The list of email recipients for notification messages | LQE Jena and LQE relational store | email addresses |
JVM System Properties
| UI property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|
| lqe.config.location | Path location of the configuration data and index location for Lifecycle Query Engine | LQE Jena and LQE relational store | ...\server\conf\lqe |
| lqe.sparql.queryLicenseCheckEnabled | Check for operation com.ibm.team.jis.lifecycle.queryPathin the license |
LQE Jena | false |
| lqe.cba.roleCheckDisabled | A workaround for a Liberty bug that causes the user role check to
throw an NPE when container authentication is used. When set to true, all users are assumed to have
JazzAdminroles. |
LQE Jena and LQE relational store | false |
| lqe.http.useAcceptHeader20 | A workaround for tools that failed with TRS 2.0 accept headers. | LQE Jena and LQE relational store | true |
| lqe.backup.table.blocksize | Modify the blocksize to export relational tables (particularly the selects table) to improve Lifecycle Query Engine export performance. | LQE Jena | 1000000 |
| lqe.restore.table.blocksize | Modify the blocksize to import from a backup the relational tables (particularly the selects table) to improve Lifecycle Query Engine import performance. | LQE Jena | 650 |
| lqe.LRUConfigCache.size | Modify the LRU versioned resource (selects) cache size. | LQE Jena | 500000 |
| lqe.lucene.nio | Force Lucene to use the java.nio's FileChannel's positional read, which allows multiple threads to read from the same file without synchronizing. | LQE Jena and LQE relational store | false |
| lqe.indexing.compareEtag | Compare etags for Selections type. | LQE Jena and LQE relational store | false |
| lqe.recalcGraphCount | Property to recalculate the graph count. | LQE Jena and LQE relational store | false |
| lqe.jena.direct.mode | Set Apache Jena direct or memory mapped mode | LQE Jena | false |
| com.ibm.team.repository.transport.client.protocol | Override the transport client protocol. | LQE Jena and LQE relational store | SSL_TLS,TLS,SSL |
| lqe.indexer.retryInvalidUpdates.blocksize | Refetch invalid updates after a few minutes. This is blocksize for these invalid updates. | LQE Jena and LQE relational store | 1000 |
| lqe.indexer.retrySkipped.blocksize | For skipped resources due to socket timeouts and similar recoverable causes, retry the skipped resources later. This is blocksize for these skipped resources. | LQE Jena and LQE relational store | 1000 |
| tdb:settings or tdb.settings | Apply custom Apache Jena TDB settings to the JVM used for compaction. | LQE Jena | Not set. |
JVM System Properties (Internal development use only)
| UI property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|
| lqe.testDiscoverResourceGroups | For special test conditions where an indexTdb is created by extracting a previous index. | LQE Jena | false |
| mocha.tdb.root | Path location of a TDB index for mocha to server as a TRS | LQE Jena | Blank |
lqe.properties (Internal development use only)
| UI property | Definition | Lifecycle Query Engine database type | Default value |
|---|---|---|---|
| lqe.recalcGraphCount | Property to recalculate the graph count. | LQE Jena and LQE relational store | false |
| lqe.data.root | Specify the location where the Lifecycle Query Engine must create the data directories. | LQE Jena and LQE relational store | Directory path |
| lqe.use.external.datasource | If set to true, Lifecycle Query Engine looks for a JDBC Datasource named 'jdbc/LQEDB' | LQE Jena and LQE relational store | false |
| lqe.restore | Restore a Lifecycle Query Engine instance from a recent and previous Lifecycle Query Engine backup. | LQE Jena and LQE relational store | false |
| lqe.configMode | Use this property if you need to register Lifecycle Query Engine with a different Jazz Team Server or if you need to reregister with the same Jazz Team Server. | LQE Jena and LQE relational store | false |
| lqe.minimum.trs.refresh.rate | An administrator is prevented from setting a TRS refresh rate lesser than this value. | LQE Jena and LQE relational store | 60 secs |
| lqe.temp.directory | A path location where the Lifecycle Query Engine must create temporary data. | LQE Jena and LQE relational store | Directory path |
| lqe.locale.override | Lifecycle Query Engine determines the language and locale for its web UI by using the language preferences set in the web browser. The lqe.locale.override property forces an override over the locale from the web browser. | LQE Jena and LQE relational store | en_US |
| lqe.disable.secure.cookies | Authentication-related cookies that are used by Lifecycle Query Engine are secure and are not sent over an unsecured connection. To access Lifecycle Query Engine using HTTP instead of HTTPS, disable secure cookies by changing the value of this property to true. | LQE Jena and LQE relational store | false |
| lqe.resetLastProcessed | A property to reset the last processed event for a TRS to the cutoff event specified in the base log. | LQE Jena and LQE relational store | trs url |
| lqe.appTitle | An LDX property to set the application title in Lifecycle Query Engine | LQE Jena and LQE relational store | Link Index Provider |
| lqe.hideServiceDiscover | A Link Index Provider property to disable default service discovery. | LQE Jena and LQE relational store | true |
| lqe.noSetupWizard | An LDX property to not use the Lifecycle Query Engine setup wizard. | LQE Jena and LQE relational store | false |
| lqe.linkIndexProvider | An LDX property to force Link Index Provider capabilities. | LQE Jena and LQE relational store | true |