clm_server_rename.pl

Questo tool aggiorna i link di risorsa utente di URI pubblico Jazz Team Server per la Rational Solution for CLM (Collaborative Lifecycle Management). Specificamente, il tool aggiorna gli URI memorizzati nei file di configurazione del server Web IBM Rational ClearQuest. Il tool aggiorna anche gli URI memorizzati nei record OSLCLink nel database utente ClearQuest.

Riepilogo

cqperl clm_server_rename.pl -username username -password password [ -dbset dbset ] -dbname dbname –oldprefix oldprefix –newprefix newprefix [ -remapconfigfiles | -preview number | -update ] [ -help ] [ -man ]

Descrizione

A partire dai prodotti della versione 4.0 per la Rational Solution for CLM (Collaborative Lifecycle Management), gli amministratori possono modificare l'URI pubblico di un Jazz Team Server o di un'applicazione Rational Solution for CLM dopo la distribuzione utilizzando l'operazione di ridenominazione del server. Tali modifiche richiedono delle modifiche corrispondenti alle risorse Rational Solution for CLM basate sull'URI. Per ClearQuest Bridge, questi link di risorsa utente per le risorse del prodotto Rational Solution for CLM (IBM Rational Team Concert, IBM Rational Quality Manager e IBM Rational DOORS Next Generation) sono memorizzati nei file di configurazione del server Web ClearQuest e nei record OSLCLink nel database utente ClearQuest.

Ci sono diversi tipi di link per le risorse utente in Rational Solution for CLM:
  • Link strutturali - descrivono le relazioni tra risorse o risorse utente e sono necessari per mantenere la tracciabilità e l'integrità dei dati.
  • Link incorporati - sono URI che possono essere inclusi in un campo di testo o nel nodo di una risorsa. I link incorporati possono essere link ancorati o link in testo semplice.
    • Link ancorati - sono visualizzati a un utente come collegamenti ipertestuali navigabili. Ad esempio, in un widget rich text, questi link sono dichiarati come tali e sono di norma memorizzati in una struttura come <a href=...>.
    • Link di testo semplice - sono URI digitati in un widget di testo ma che non vengono riprodotti come collegamenti ipertestuali navigabili.

ClearQuest fornisce il tool clm_server_rename.pl per riassociare i link strutturali URI memorizzati nei file di configurazione web ClearQuest e nei record OSLCLink. Utilizzare il tool per riassociare il protocollo, il nome host, il numero porta e il contesto applicativo dei link strutturali.

Esecuzione del tool

È necessario disporre di privilegi di amministratore locale e dei privilegi di Super utente ClearQuest per eseguire il tool clm_server_rename.pl.

Il tool si trova in questa directory nel file cqweb.war:

home_profilo_WAS\installedApps\cellanodo\TeamEAR.ear\cqweb.war\WEB-INF\classes

Il programma cqperl.exe si trova nella directory dove è installato ClearQuest.

Prima di eseguire il tool clm_server_rename.pl, è buona prassi impostare la variabile di ambiente TEMP su un directory dove si dispone dell'accesso in scrittura. Altrimenti, assicurarsi di disporre dell'accesso in scrittura nella directory dove si sta eseguendo il tool.

È necessario eseguire il tool più volte.

Consultare Riassociazione degli URI dopo aver ridenominato un server CLM per i dettagli completi della procedura.

Consultare la sezione Opzioni e argomenti per una descrizione delle opzioni di riga comandi.

Limitazioni

Il tool clm_server_rename.pl riassocia solo i link strutturali che sono memorizzati nei file di configurazione del server Web ClearQuest e nei record OSLCLink. Il tool non riassocia i link incorporati che sono memorizzati nei record ClearQuest. Tali link di ancoraggio incorporati possono essere inclusi negli allegati di record o nei campi quali le descrizioni o le note. A seconda dello schema, questi campi possono diventare di sola lettura dopo l'inoltro o dopo l'aggiunta di una nota. Questo significa che i link di ancoraggio incorporati rimarranno interrotti dopo l'esecuzione del tool. È possibile scrivere del codice per correggere questi link, se necessario.

Un esempio di un link di ancoraggio incorporato che rimane interrotto dopo l'esecuzione del tool coinvolge l'integrazione Rational Solution for CLM tra Rational ClearQuest e Rational Quality Manager. Quando una risorsa utente Rational Quality Manager viene collegata a un record ClearQuest, Rational Quality Manager inserisce un link di URI alla risorsa utente nel campo di descrizione del record.

Opzioni ed argomenti

-username username
Nome di accesso di un utente amministrativo con privilegi di Super utente.
-password password
Password di un utente amministrativo con privilegi di Super utente.
-dbset dbset
Nome della connessione database.
-dbname dbname
Nome del database utente.
–oldprefix oldprefix
Specifica una stringa URI esistente. Il formato URI deve iniziare con http e includere il contesto dell'applicazione seguito da una barra (/).
–newprefix newprefix
Specifica una nuova stringa URI per sostituire la stringa URI esistente specificata dall'opzione -oldprefix. Il formato URI deve iniziare con http e includere il contesto dell'applicazione seguito da una barra (/).
-remapconfigfiles
Importante: Quando si utilizza questa opzione, è necessario eseguire il tool nella directory in cui è installato il tool.

Riassocia i link di risorsa utente URI pubblico di Jazz Team Server per le applicazioni Rational Solution for CLM. Specificamente, questa opzione riassocia gli URI memorizzati nei file di configurazione del server Web ClearQuest. Il tool crea una copia dei file di configurazione prima di riassociare gli URI.

Dopo l'esecuzione del tool con questa opzione, è necessario riavviare il server Web ClearQuest. La comunicazione tra server del server Web viene quindi riconfigurata e gli utenti possono creare dei nuovi link di URI alle risorse utente Rational Solution for CLM. Tuttavia, seguire i link esistenti alle risorse utente Rational Solution for CLM non funzionerà finché non si esegue nuovamente il tool con l'opzione -update.

-preview number
Visualizza un'anteprima delle modifiche che verranno apportate al numero (number) di record OSLCLink nel database ClearQuest che contengono la stringa URI oldprefix. Notifica anche il numero totale di record OSLCLink che contengono la stringa URI oldprefix. Quando viene utilizzata questa opzione, non viene apportata alcuna modifica al database utente.
-update
Aggiorna i link di URI pubblico Jazz Team Server per le risorse utente Rational Solution for CLM. Specificamente, questa opzione aggiorna gli URI memorizzati nei record OSLCLink ClearQuest.

Quando viene eseguito con questa opzione, il tool cattura le modifiche ai record OSLCLink in un file di log. Se la variabile di ambiente TEMP è impostata, il file di log viene scritto nella directory specificata; altrimenti, il file di log viene scritto nella directory da cui lo si sta eseguendo, a condizione di disporre dell'accesso in scrittura. Per il file di log viene utilizzata la seguente convenzione di denominazione dei file:

clm_server_rename_yyyymmdd_hhmmss.txt

dove:

yyyymmdd
La data in cui il tool viene eseguito, specificato come anno, mese e giorno
hhmmss
L'ora in cui il tool viene eseguito, specificato come ore, minuti, secondi

Ad esempio, clm_server_rename_20120405_211711.

Esempi

  • Per il server denominato MyCQWebServer, riassociare i link di risorsa utente di URI Jazz Team Server nei file di configurazione del server Web ClearQuest che corrispondono alla stringa URI specificata di seguito.

    C:\was_profiles\MyCQWebServer\installedApps\Node02Cell\TeamEAR.ear\cqweb.war\WEB-INF\classes>cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix https://clm7.mycompany.com/ccm/ -newprefix https://clm7.mycompany.com/jazz/ -remapconfigfiles

    Started: Remapping URIs in config file friendsconfig.rdf.
    Completed: Remapping URIs in config file friendsconfig.rdf.

    Started: Remapping URIs in config file project-area-links.rdf.
    Completed: Remapping URIs in config file project-area-links.rdf.

    Started: Remapping URIs in config file oauth-consumers.rdf.
    Completed: Remapping URIs in config file oauth-consumers.rdf.

  • Visualizzare in anteprima cinque record OSLCLink nel database ClearQuest che corrispondono alla stringa URI specificata successivamente e come si presenterebbero i record in caso di modifica del contesto dell'applicazione da jazz a ccm.

    cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix https://servername.com:9443/jazz/ -newprefix https://servername.com:9443/ccm/ -preview 5

  • Modificare il protocollo nell'URI nei record OSLCLink ClearQuest che corrispondono alla stringa URI specificata successivamente da http a https.

    cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://servername.com:9443/jazz/

  • Modificare il nome server nell'URI nei record OSLCLink ClearQuest che corrispondono alla stringa URI specificata successivamente da servername a newservername.

    cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://newservername.com:9443/jazz/

Consultare anche

Riassociazione degli URI dopo aver ridenominato un server CLM, Modifica dell'URL pubblico utilizzando la ridenominazione del server


Feedback