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.
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:
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.
Ad esempio, se ClearQuest è integrato con IBM Rational Team Concert e IBM Rational Quality Manager, e vengono ridenominati sia Jazz Team Server for Rational Team Concert sia il server Rational Quality Manager, è necessario eseguire il tool con l'opzione -remapconfigfiles due volte: una volta per riassociare gli URL per i link di risorsa utente Rational Team Concert e una volta per riassociare gli URI per i link di risorsa utente Rational Quality Manager.
Ad esempio, se ClearQuest è integrato con IBM Rational Team Concert e IBM Rational Quality Manager, e vengono ridenominati sia Jazz Team Server for Rational Team Concert sia il server Rational Quality Manager, è necessario eseguire il tool con l'opzione -update due volte: una volta per riassociare gli URL per i link di risorsa utente Rational Team Concert e una volta per riassociare gli URI per i link di risorsa utente Rational Quality Manager.
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.
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.
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.
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:
dove:
Ad esempio, clm_server_rename_20120405_211711.
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.
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
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/
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/