Gestisce le informazioni sulla serie di database e sulla connessione database nel registro ClearQuest sul
sistema UNIX e Linux
Riepilogo
Il comando cqreg si trova nella directory bin della directory di installazione ClearQuest.
- Notificare le informazioni di connessione per le serie di database e i database registrati:
- cqreg show [ -dbset dbset_name | -all ]
[ -terse | -errors | -verbose ] [ -help ] [ -effort_only ] [ -force
] [ -home cq_home ] [ -version cq_version ]
[ -cq_databases cq_databases ]
- Associare una directory di installazione ClearQuest
a una directory di registro database:
- cqreg initialize [ -associate ] [ registry_directory ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- Registrare una serie di database e i database nel registro ClearQuest:
- cqreg add_dbset -v/endor db_vendor [ -s/erver db_server ]
[ -d/atabase db_name ] [ [ -u/ser user -p/assword password ]
] [ -dbset dbset_name ] [ -co connect_options ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- Annullare la registrazione di una serie di database e dei database dal registro ClearQuest:
- cqreg drop_dbset [ -dbset dbset_name ] [
-help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- Aggiornare il registro database con le informazioni nel repository di schemi:
- cqreg refresh [ -dbset dbset_name | -all
] [ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
Descrizione
È possibile creare, eliminare e spostare
i database ClearQuest solo su
un sistema Windows utilizzando
il Tool di manutenzione oppure il Designer. Si utilizza il comando cqreg per
gestire le informazioni di connessione associate alle serie di database e ai database ClearQuest
in modo da poter accedere ai database sul sistema UNIX e Linux.
Il comando cqreg consente di eseguire queste attività:
- Notificare le informazioni sui database registrati
- Associare una directory di installazione ClearQuest a una
directory di registro database
- Stabilire una connessione a un repository di schemi e aggiornare il registro database dopo che un database
è stato creato o eliminato utilizzando il Tool di manutenzione o il Designer
È anche possibile
aggiungere e rimuovere connessioni database dal client ClearQuest
in esecuzione su un sistema UNIX o Linux.
Opzioni ed argomenti
- -dbset dbset_name
- Nome della connessione database. Per impostazione predefinita, questa è la versione ClearQuest.
- -all
- Esegue il comando su tutte le serie di database e i database in esse contenuti.
- -verbose
- -errors
- -terse
- Controlla la quantità di output visualizzata dal comando. Se omesso, per impostazione predefinita è -errors.
- -effort_only
- Visualizza cosa fa il sottocomando senza eseguire l'azione associata.
- -force
- Forza il sottocomando a sostituire i dati o i file di registro esistenti che altrimenti non verrebbero sovrascritti.
- -home cq_home
- Identifica la directory di installazione di ClearQuest. Questo valore sovrascrive il valore
della variabile di ambiente $CQ_HOME, se impostata.
- -version version
- Utilizzare con il sottocomando cqreg show per identificare la versione del
prodotto ClearQuest a cui si applica il
sottocomando. Se questa opzione viene omessa, viene utilizzata la versione associata alla
release corrente.
- -cq_databases cq_databases
- Specifica l'ubicazione di directory nella quale vengono memorizzate le connessioni
database. Questo valore sovrascrive il valore della variabile di ambiente $CQ_DATABASES, se impostata.
- -associate
- Utilizzare con il sottocomando cqreg initialize per associare
la directory di installazione ClearQuest con
una directory di registro database. Se questa opzione viene omessa, il sottocomando cqreg
initialize inizializza solo la directory di registro, senza effettuare l'associazione.
- registry_directory
- Utilizzare con il sottocomando cqreg initialize per specificare la
directory di registro. Se questa opzione viene omessa, viene utilizzato uno
dei seguenti valori, elencati in ordine decrescente:
- Il valore di -cq_databases cq_databases,
se specificato
- Il valore della variabile di ambiente $CQ_DATABASES, se impostata
- Il valore predefinito
- -v/endor db_vendor
- Il fornitore del database. Sono validi i seguenti valori:
- -s/erver server
- Il server di database.
- -d/atabase db_name
- Per DB2 e SQL Server,
il nome del database utilizzato per il repository di schemi. Per Oracle,
il SID (System Identifier) del sistema di gestione database.
- -u/ser user_name
- Il nome utente per accedere al database.
- -p/assword password
- La password per accedere al database.
- -co connect_options
- Le opzioni di connessione. Rivolgersi all'amministratore di sistema per le opzioni
di connessione specifiche per l'ambiente. Consultare anche l'argomento della guida relativo all'amministrazione di Rational ClearQuest nelle proprietà del database del fornitore.
- -help
- Visualizza informazioni sull'utilizzo
Sottocomandi
- cqreg show
- Notifica le informazioni di connessione per le serie di database e i database registrati.
- cqreg initialize
- Associa una directory di installazione ClearQuest
a una directory di registro database. Se il file .Databases già esiste quando
si esegue il sottocomando cqreg initialize, esso non viene sostituito a
meno che non si utilizzi l'opzione -force.
Attenzione: Il sottocomando cqreg initialize viene
eseguito come parte dell'installazione di ClearQuest.
Eseguire questo sottocomando solo se si desidera associare una directory di installazione ClearQuest a una directory di registro database differente.
- cqreg add_dbset
- Registrare una serie di database e i database nel registro ClearQuest o
aggiornare le informazioni di connessione esistenti. Eseguire questo sottocomando dopo aver creato il repository di schemi e i database
utente utilizzando il Designer.
- cqreg register
- Questo sottocomando è obsoleto. Utilizzare invece il comando cqreg add_dbset .
- cqreg drop_dbset
- Annullare la registrazione di una serie di database e dei database dal registro ClearQuest. Eseguire
questo sottocomando dopo che una serie di database è stata spostata a un host
differente per annullare la registrazione della serie di database. Eseguire quindi il comando cqreg add_dbset per
registrare la serie di database sul nuovo host.
Se non si specifica un
nome connessione con, rispettivamente, l'opzione e l'argomento -dbset dbset_name
quando si esegue il sottocomando cqreg drop_dbset, viene utilizzata la
connessione predefinita.
- cqreg unregister
- Questo sottocomando è obsoleto. Utilizzare invece il comando cqreg drop_dbset .
- cqreg refresh
- Aggiorna il registro database dalle informazioni nel repository di
schemi. Utilizzare questo sottocomando dopo aver utilizzato il Tool di manutenzione o
il Designer per creare, modificare o eliminare un database o dopo aver
spostato i repository di schemi e i database. Se il sottocomando cqreg refresh
non ristabilisce la connessione, utilizzare i sottocomandi cqreg drop_dbset e cqreg
add_dbset per eliminare e ricreare le informazioni di connessione database.
Esempi
- Mostrare le informazioni di connessione su tutte le serie di database e tutti i database registrati:
- Aggiornare il registro database per la serie di dati UCM_dbset con le
informazioni nel repository di schemi:
cqreg refresh -dbset UCM_dbset
- I seguenti sono degli esempi di aggiunta di connessioni rispettivamente per i database Oracle, SQL
Server e DB2:
- Per Oracle:
cqreg add_dbset -v Oracle -s cqtest1 -d CQ1 -u admin -p admin_pwd -dbset CQ_DEV1 -co "PORT=50100"
- Per SQL Server:
cqreg add_dbset -v SQL_Server -s cqtest2 -d msitea -u admin -p pwd -dbset CQ_DEV1
- Per DB2:
cqreg add_dbset -v DB2 -s db2tcpnode -d msiteb -u admin -p pwd -dbset CQ_DEV3
- Annullare la registrazione della serie di database UCM_dbset:
cqreg drop_dbset -dbset UCM_dbset