Convalida dei feed TRS e dell'indice Lifecycle Query Engine o Link Index Provider

Convalida tutti i feed TRS (Tracked Resource Set) registrati nel Lifecycle Query Engine o nell'indice LDX quando i report di Report Builder non mostrano gli artefatti previsti. La convalida di questi elementi può aiutare a diagnosticare e risolvere i problemi ed evitare la reindicizzazione dei provider di dati.

Informazioni su questa attività

Attenzione: non utilizzare la convalida per ripristinare il sistema a seguito di un'operazione di reindicizzazione non riuscita verificatasi durante la fase di rimozione. In questi casi, è possibile che alcuni dati siano già stati cancellati e che la convalida non riesca a recuperarli. Per indicazioni su come scegliere tra la convalida e la reindicizzazione, consultare la sezione "Scegliere tra la convalida e la reindicizzazione ".

È possibile eseguire la convalida solo dei feed TRS, per i quali la convalida è supportata dalle applicazioni, nelle seguenti situazioni:

In un report mancano le risorse utente.
Un report include artefatti obsoleti (stantii).
Un report mostra lo stesso artefatto più di una volta, eventualmente con valori di attributi diversi o con il vecchio e il nuovo nome.
Una vista dell'applicazione e un report corrispondente in Jazz® Reporting ServiceJRS) mostrano un numero diverso di artefatti.
Un report include gli artefatti eliminati.
Lifecycle Query Engine o LDX mostra le risorse saltate.
Suggerimento: Per verificare che non ci siano risorse saltate, assicurarsi che l'opzione Convalida artefatti sia selezionata.

La convalida di tutti i feed TRS registrati nel Lifecycle Query Engine o nell'indice LDX può aumentare la fiducia nella qualità dei report e aiutarti a risolvere i problemi legati a elementi mancanti, obsoleti o in eccesso. TRS Validation funziona in modo autonomo, senza accedere al Lifecycle Query Engine o a LDX. Confronta solo i contenuti effettivi e quelli previsti nel feed TRS.

Nota:

Non eseguire più di un'operazione di convalida del TRS alla volta per un determinato TRS.
Se il server delle applicazioni viene arrestato durante un'operazione di convalida TRS, al riavvio del server la convalida TRS non viene riavviata automaticamente e rimane in uno stato indefinito. Un amministratore deve impostare l'opzione per cancellare la cache all'avvio di una nuova convalida.
Se sono state configurate Engineering Lifecycle Management applicazioni in un ambiente cluster, la convalida del TRS fallisce se un nodo o un'applicazione viene spenta quando la convalida del TRS è ancora in corso. È necessario riavviare la convalida TRS.

Le fasi di convalida dei feed TRS sono diverse tra le applicazioni di Engineering Lifecycle Management. Completate i passi di questo argomento per l'applicazione di cui volete convalidare l'alimentazione.

Convalida dei feed TRS delle applicazioni
Motore di ricerca del ciclo di vita o fornitore di indici dei collegamenti

Per saperne di più sulla convalida prima di eseguirla, consultate le seguenti risorse:

Report affidabili con l' Jazz Reporting Service : come risolvere i problemi relativi ai dati (articolo su Jazz.net )

Per una descrizione dei feed TRS in Engineering Lifecycle Management, consultare la sezione "Aggiunta di feed TRS per applicazioni di gestione del ciclo di vita ".

Convalida dei feed TRS delle applicazioni

Convalida i feed TRS nella pagina Convalida feed TRS nella sezione Amministrazione del Jazz Team Server, Engineering Workflow Management, Rhapsody Model Manager, Engineering Requirements Management DOORS Next, Engineering Test Management, e Global Configuration Management applicazione.

Informazioni su questa attività

Di seguito sono riportati alcuni esempi di feed TRS:

Risorse degli utentiJTS (TRS 2.0): Questo feed contiene informazioni sugli utenti di Jazz Team Server. Se un report sugli utenti del sistema non mostra i risultati attesi e si conferma che 10 utenti sono registrati nel repository, l'attività di convalida verifica se il feed TRS ha 10 riferimenti distinti agli utenti.
Risorse del processoEngineering Workflow Management (TRS 2.0): Se un report non mostra le aree del progetto, le aree del team o le iterazioni che ci si aspetta, l'attività di convalida può aiutare a determinare se sono assenti da questo feed TRS. Se un utente esegue un report che non include gli artefatti di un progetto a cui appartiene, la convalida del feed TRS può risolvere il problema dell'autorizzazione. Dopo la convalida, il report mostra tutti i dati previsti.
RisorseGlobal Configuration Management (TRS 2.0): Questo feed contiene informazioni sulle modifiche alle configurazioni globali, ad esempio quando sono state create, aggiornate o eliminate.

Suggerimento: Si consiglia di eseguire la convalida quando il server non è sotto carico. È preferibile eseguire la manutenzione quando nessuno apporta modifiche al server. La convalida è un'operazione potenzialmente pesante, che consuma molta memoria e tempo di processore.

Procedura

Aprire la pagina di amministrazione dell'applicazione per il feed TRS da convalidare:
- Server Jazz Team : https://host:port/jts/admin
- Engineering Workflow Management oppure Rhapsody Model Manager : https://host:port/ccm/admin
- Engineering Requirements Management DOORS Next: https://host:port/rm/admin
- Engineering Test Management: https://host:port/qm/admin
- Global Configuration Management: https://host:port/gc/admin
Nella barra degli strumenti, fare clic su Diagnostica alimentazione TRS.
Nella finestra di dialogo Convalida, fare clic su Convalida artefatti e configurazioni. Il TRS viene letto e convalidato.

Nota:
È possibile utilizzare uno strumento di convalida alternativo di Engineering Test Management per correggere automaticamente eventuali discrepanze. Lo strumento richiede una proprietà avanzata prima di avviare il processo di convalida.

Per impostare la proprietà, accedere alla pagina di amministrazione di 'https://host:port/qm/admin e trovare la sezione Proprietà avanzate . Quindi, modificare l'opzione Risolvi automaticamente le discrepanze per la proprietà 'com.ibm.rqm.oslc.trs.validator.TRSValidationWatchdog in true.

Per quanto riguarda la convalida di DOORS Next TRS:

Per eseguire la DOORS Next convalida TRS, è necessario impostare la proprietà avanzata della directory della cache del disco di convalida delle selezioni prima della convalida.

Nota: Per eseguire TRS Validation per le risorse DOORS Next, è necessario impostare la proprietà avanzata Selections Validation disk cache directory, che punta a una directory sull'application server. Questa directory contiene i dati della cache delle selezioni di configurazione, che potrebbero essere di grandi dimensioni. Se è necessario riposizionare la directory della cache, è possibile farlo modificando il valore della proprietà. Dopo aver modificato il valore della proprietà, è necessario selezionare l'opzione Cancella dati memorizzati nella cache durante la successiva convalida.

Risultati

Per informazioni dettagliate sull'algoritmo di convalida TRS, sull'interpretazione dei risultati della convalida e sulle migliori pratiche, consultare la sezione "Processo e risultati della convalida TRS".

Operazioni successive

Se il problema persiste, chiedere a un amministratore di Lifecycle Query Engine o LDX di convalidare l'indice di Lifecycle Query Engine o LDX.

Per monitorare l'attività del feed TRS e individuare eventuali problemi di elaborazione, è possibile accedere alla pagina "TRS Core Metrics Monitor" all'indirizzo https://host_name:port/lqe/web/health/trs-core-metrics. Questa pagina mostra i dati in tempo reale relativi a ciascun feed TRS, tra cui lo stato di elaborazione, le velocità, la produttività e eventuali blocchi. È inoltre possibile configurare l'impostazione " Frequenza di aggiornamento delle metriche (in secondi)" per ciascun feed TRS, al fine di generare aggiornamenti periodici per l'indicizzazione LQE, l'elaborazione del registro delle modifiche e le operazioni di eliminazione. Se non si verifica alcun aggiornamento entro l'intervallo configurato, il sistema genera un aggiornamento per evitare che l'elaborazione TRS sembri bloccata e per migliorare l'affidabilità dell'indicizzazione.

Motore di interrogazione del ciclo di vita o fornitore di indici di collegamento

Convalida l'indice Lifecycle Query Engine o LDX per confrontarlo con un feed TRS proveniente da un'applicazione di Engineering Lifecycle Management. Questo task trova gli artefatti mancanti, obsoleti o in eccesso.

Attività preliminari

Se si esegue l'aggiornamento da una versione precedente, aggiungere le seguenti proprietà al file 'JazzInstallDir/server/conf/log4j2.xml per garantire che i log di convalida utilizzino il formato più recente.

# Validation Task
<Configuration name="ApplicationLogging" status="error" monitorInterval="10">
    <Properties>
        <Property name="pattern">%d{ISO8601} [%30t] %5p %-50.50c %X{Tid} - %m%n</Property>
        <Property name="ansipattern">%d{ISO8601} [%-5.5t] %5p %c{1} %X{Tid} %highlight{%m}%n</Property>
        <Property name="app">lqe</Property>
        <Property name="dir">logs</Property>
    </Properties>
	<Appenders>
	<!-- Validation task log file -->
		<RollingFile name="lqeValidationTaskLog" filename="${dir}/${app}-validation.log" filePattern="${dir}/${app}-validation-%i.log">
			<PatternLayout pattern="${pattern}"/>
			<Policies>
				<SizeBasedTriggeringPolicy size="10 MB"/>
			</Policies>
			<DefaultRolloverStrategy max="5"/>
		</RollingFile>
	</Appenders>
	<Loggers>
		<!-- Validation logging -->
		<Logger name="VALIDATION" level="INFO" additivity="false">
			<AppenderRef ref="lqeValidationTaskLog"/>
		</Logger>
	</Loggers>
</Configuration>

Informazioni su questa attività

Gli amministratori dell'applicazione Engineering Lifecycle Management potrebbero chiedere di convalidare l'indice Lifecycle Query Engine o LDX dopo aver convalidato i feed TRS.

Prima di convalidare l'indice di Lifecycle Query Engine, considerate i seguenti punti:

Eseguire questa attività quando il carico del sistema è basso. Il tempo necessario per la convalida dipende dalle dimensioni dell'indice.
Non convalidare tutti i fornitori di dati TRS contemporaneamente. Convalidare i grandi fornitori di dati in giorni separati.
Convalidare solo un feed TRS per un fornitore di dati (applicazioneEngineering Lifecycle Management ) alla volta. Per le applicazioni di Engineering Lifecycle Management che hanno più di un feed TRS, eseguire una convalida separata per ciascun feed.
Gli amministratori possono eseguire regolarmente la convalida di Lifecycle Query Engine o LDX per verificare se i dati di Lifecycle Query Engine o LDX sono sincronizzati con il feed TRS del fornitore di dati. Ad esempio, se si esegue la convalida settimanale e le risorse dello stesso tipo vengono registrate come mancanti, è necessario controllare l'applicazione che fornisce i dati. Potrebbe essere necessario modificare o configurare un'impostazione in tale applicazione. Se l'attività di convalida viene eseguita per alcuni mesi senza segnalare alcun problema, è possibile estendere la pianificazione della convalida. Ad esempio, è possibile eseguire l'attività mensilmente.

Per interrompere una convalida in corso, riavviare il Lifecycle Query Engine o il server LDX.

Procedura

Aprire la pagina Fornitori di dati: https://host:port/lqe/web/admin/data-sources
Fare clic sul nome del feed TRS da convalidare.
Fai clic su «Convalida» nell'intestazione della pagina.
Opzionale: Scegliere quando convalidare il fornitore di dati selezionando una data e un'ora.
Fai clic su "Convalida" e segui le istruzioni.

Mentre Lifecycle Query Engine o LDX legge il feed TRS, viene visualizzato questo messaggio: Waiting for a response from the data provider. passaggio può richiedere un po' di tempo, a seconda del numero di risorse presenti nel feed. Si tratta di un comportamento previsto e non è necessario intervenire.
Opzionale: Pianificare regolarmente le attività di convalida di Lifecycle Query Engine o LDX.
1. Fai clic su «Modifica programma» nella sezione «Programma di convalida ».
2. Selezionare la casella di controllo Abilita pianificazione.
3. Specificare l'ora e i giorni della settimana in cui si desidera eseguire la convalida.
4. Selezionare la casella di controllo "Ripristina l'ultimo evento elaborato" per ricominciare la convalida dall'inizio del feed TRS.
  
  Nota: selezionando "Ripristina l'ultimo evento elaborato" non vengono eliminati i dati indicizzati. La convalida può richiedere più tempo, soprattutto nel caso di feed TRS di grandi dimensioni, poiché tutti gli eventi vengono esaminati. Se questa opzione non è selezionata, Lifecycle Query Engine verifica solo gli eventi verificatisi dall'ultima esecuzione della verifica.
  Quando si seleziona "Ripristina l'ultimo evento elaborato ", Lifecycle Query Engine :
  - Elimina l'ID dell'ultimo evento convalidato precedentemente memorizzato.
  - Riavvia la convalida dall'inizio del flusso TRS.
  - Convalida tutte le risorse presenti nel feed TRS, non solo quelle modificate dall'ultima esecuzione.
5. Fai clic su «Convalida» per avviare la procedura.
Quando si attiva una pianificazione di convalida per un feed TRS e questa è la prossima attività pianificata, l'ora di convalida pianificata viene visualizzata nella colonna Attività pianificate della pagina Fornitori di dati.

Risultati

Quando la convalida termina, i risultati vengono pubblicati nella pagina Fornitori di dati, a 'https://host:port/lqe/web/admin/data-sources. Fare clic sul link di stato di un fornitore di dati:

Nella pagina Stato del fornitore di dati, è possibile vedere quante risorse sono state aggiornate (perché mancanti o stantie) e quante risorse extra sono state rimosse.

Nella scheda Panoramica, fare clic su Scarica registri per recuperare tutti i registri di Lifecycle Query Engine o LDX per questo provider di dati.

I file di log di convalida sono denominati 'lqe-validation-<encoded_data_source_URL>.log. I registri elencano le discrepanze delle risorse nelle seguenti categorie:

Risorse mancanti: Queste risorse sono incluse nel feed TRS ma non nell'indice Lifecycle Query Engine o LDX. Il processo di convalida recupera nuovamente queste risorse per risolvere la discrepanza.
Risorse obsolete: Le risorse nel feed TRS sono più recenti delle risorse nell'indice Lifecycle Query Engine o LDX. Il processo di convalida recupera nuovamente queste risorse per risolvere la discrepanza.
Risorse extra: Queste risorse sono incluse nell'indice Lifecycle Query Engine o LDX, ma non nel feed TRS. Il processo di convalida elimina queste risorse per risolvere la discrepanza.

È possibile attivare la notifica via e-mail per gli eventi di convalida. Per ulteriori informazioni, consultare la sezione "Configurazione delle notifiche via e-mail per gli eventi di Lifecycle Query Engine ".

Se dopo la convalida si notano ancora discrepanze nel contenuto di un report, è opportuno considerare una reindicizzazione.

Dopo aver fatto clic su "Convalida", non verranno più indicizzati ulteriori cambiamenti relativi a quel fornitore di dati. Se si è programmato di eseguire la convalida in un secondo momento, non verranno elaborate modifiche dal momento in cui si fa clic sul pulsante di convalida, fino al termine della convalida.

Per maggiori informazioni, guardate il seguente video: