Prodotto | Tipo di comando |
---|---|
MultiSite | Struttura dati MultiSite |
Piattaforma |
---|
UNIX |
/var/adm/rational/clearcase/config/shipping.conf
Questo file controlla le operazioni della funzione di memorizzazione ed inoltro su ogni host. Il file è costituito da righe di commento (che iniziano con il simbolo #) e una o più voci di configurazione ed esso può contenere le voci di configurazione descritte di seguito. In alcuni casi, l'operazione di memorizzazione ed inoltro corrispondente non riesce se una voce risulta mancante; in altri casi, esiste un valore predefinito codificato.
L'installazione di MultiSite crea il ccase-home-dir/config/services/shipping.conf.template, in cui sono definite tutte le voci. Se il file /var/adm/rational/clearcase/config/shipping.conf non esiste, l'installazione lo crea copiando il file di modello. Se il file /var/adm/rational/clearcase/config/shipping.conf esiste, l'installazione informa l'utente di confrontare il file esistente con il file di modello ed esegue ogni modifica necessaria.
MAX-DATA-SIZE dimensione [ k | m | g ]
Valore predefinito (e massimo): 2097151 KB (2GB-1KB)
Controlla la suddivisione dei pacchetti logici individuali in più pacchetti fisici. Limitando la dimensione dei pacchetti fisici è possibile migliorare l'affidabilità della consegna dei pacchetti in alcune reti. Il numero intero dimensione (con il suffisso facoltativo k, m o g) specifica la dimensione massima per un file del pacchetto fisico. k indica KB (kilobyte); m indica MB (megabyte); g indica GB (gigabyte). L'omissione del suffisso indica KB. Anche specificando 0 (zero) viene utilizzato il valore predefinito.
Questo valore è utilizzato dai seguenti comandi (a meno che non si specifichi –maxsize):
Quando si richiama mkreplica o syncreplica con –out, questo valore non è utilizzato ed è necessario utilizzare –maxsize per limitare la dimensione del pacchetto.
NOTIFICATION-PROGRAM nome percorso-programma-e-mail
Valore predefinito: /opt/rational/clearcase/bin/notify. Questo programma è utilizzato anche se non esiste una voce NOTIFICATION-PROGRAM.
Il programma di posta elettronica deve essere richiamato in queste circostanze:
Il programma di posta deve essere richiamato nel modo seguente:
nome percorso-programma-e-mail–s oggetto –f file-messaggio indirizzo ...
ADMINISTRATOR indirizzo-e-mail
Valore predefinito: root
L'indirizzo di posta elettronica dell'amministratore che gestisce la funzione di di memorizzazione e inoltro sull'host locale.
Viene inviato un messaggio di posta all'indirizzo specificato nelle circostanze elencate in Notifica. Il file di configurazione può contenere più voci ADMINISTRATOR; i messaggi sono inviati a tutti gli indirizzi di posta specificati.
STORAGE-BAY classe-memorizzazione nome percorso-directory
RETURN-BAY classe-memorizzazione nome percorso-directory
Valore predefinito: i comandi multiutil che utilizzano l'opzione –sclass utilizzano la classe di memorizzazione cq_default per i pacchetti che non sono assegnati ad alcuna classe di memorizzazione e per i pacchetti la cui classe di memorizzazione non è configurata. I comandi mkorder e shipping_server utilizzano la classe di memorizzazione –default per i pacchetti che non sono assegnati ad alcuna classe di memorizzazione e per i pacchetti la cui classe di memorizzazione non è configurata.
Queste righe definiscono le directory del vano di memoria e del vano di restituzione. Un vano di memoria detiene i pacchetti in entrata e in uscita e gli ordini di invio per una classe di memorizzazione. Un vano di restituzione detiene i pacchetti in entrata e in uscita che stanno per essere restituiti alla rispettiva origine, in quanto non è stato possibile distribuirli a tutte le destinazioni specificate.
È possibile utilizzare più voci STORAGE-BAY e RETURN-BAY per definire più vani per ogni classe di memorizzazione. shipping_server selezionare uno dei vani per ogni pacchetto basato sullo spazio su disco disponibile nelle partizioni del disco dei vani. L'ordine con cui vengono specificati i vani non è importante.
L'installazione di MultiSite crea una classe di memorizzazione predefinita denominata –default. Il vano di memoria e il vano di restituzione per questa classe sono creati sull'host locale nella directory /var/adm/rational/clearcase/shipping. Ogni vano contiene directory secondarie denominate incoming e outgoing, che detengono i pacchetti in entrata e in uscita. Le operazioni di invio ricercano i pacchetti in tali directory secondarie. Prima di utilizzare la funzione di memorizzazione e inoltro, verificare che la partizione del disco in cui viene creata la directory di invio disponga di spazio libero sufficiente per i pacchetti di aggiornamento e di creazione della replica anticipata. Per evitare un possibile danneggiamento del database VOB, che può essere provocato completando la partizione del disco che contiene il database VOB, posizionare il vano di memoria in una partizione del disco che non contiene le directory di memorizzazione VOB.
I comandi multiutil che utilizzando l'opzione –sclass utilizzano la classe di memorizzazione cq_default per i pacchetti che non sono assegnati ad alcuna classe di memorizzazione e per i pacchetti la cui classe di memorizzazione non è configurata. La classe di memorizzazione cq_default non viene creata quando è installato MultiSite. I comandi mkorder e shipping_server utilizzano la classe di memorizzazione –default per i pacchetti che non sono assegnati ad alcuna classe di memorizzazione e per i pacchetti la cui classe di memorizzazione non è configurata. È possibile creare classi di memorizzazione aggiuntive per i pacchetti Rational ClearQuest MultiSite, ma è necessario utilizzare classi di memorizzazione diverse per i pacchetti Rational ClearQuest MultiSite e per i pacchetti Rational ClearCase MultiSite.
È necessario creare nome percorso-directory con un comando mkdir standard di Linux e UNIX. È anche necessario creare le directory incoming e outgoing nel nuovo vano. Ai pacchetti collocati in un vano vengono assegnati lo stesso proprietario, gli stessi gruppi e autorizzazioni alla lettura-scrittura del vano stesso. (L'autorizzazione all'esecuzione e qualsiasi altra autorizzazione speciale del vano viene ignorata.) Modificare tali autorizzazioni (se necessario) per abilitare l'esecuzione corretta dei comandi MultiSite per elaborare i pacchetti e per impedire accessi non autorizzati.
EXPIRATION classe-memorizzazione numero-di-giorni
EXPIRATION–default numero-di-giorni
Valore predefinito: 14 giorni per –default; nessuno per cq_default (è necessario specificare un periodo di scadenza).
Specifica il periodo di scadenza (in giorni) per gli ordini di invio associati alla classe di memorizzazione specificata. Questo periodo comincia quando è stato generato l'ordine di invio. Se un pacchetto non può essere consegnato a tutte le destinazioni entro il numero di giorni specificato, esso viene restituito all'host di invio originale e sono inviati uno o più messaggi di posta elettronica (consultare le descrizioni nelle sezioni Indirizzo amministratore e Notifica).
Se si specifica cq_default come classe di memorizzazione, il periodo di scadenza viene impostato per gli ordini di invio che sono assegnati ad alcuna classe di memorizzazione e per gli ordini di invio la cui classe di memorizzazione non è configurata. Eccezione: quando si genera un ordine di invio con il comando mkorder e non si specifica una classe di memorizzazione, l'ordine di invio presenta un periodo di scadenza associato alla classe di memorizzazione –default.
Il valore 0 (zero) indica che non esiste una scadenza e la consegna viene tentata indefinitamente.
Questa impostazione è sovrascritta dall'opzione –pexpire in syncreplica o mkreplica.
Il programma shipping_server non riprova la consegna del pacchetto. La specifica EXPIRATION è utile solo se vengono pianificati richiami periodici del server di invio per tentare la consegna di ogni pacchetto non consegnato.
ROUTE hop-successivo host ...
ROUTE hop-successivo –default
Valore predefinito: nessuno.
Controlla l'instradamento di rete dei pacchetti. I pacchetti la cui destinazione finale è uno degli argomenti host sono inviati all'host denominato hop-successivo. Questo host è responsabile della consegna finale del pacchetto alle destinazioni (o inoltri aggiuntivi). hop-successivo e host possono essere nomi host (che devono poter essere utilizzati dagli host in domini diversi) o indirizzi IP numerici.
È possibile includere più voci ROUTE nel file di configurazione. La parola chiave speciale –default inserisce tutti gli host che non sono specificati in un'altra voce ROUTE.
RECEIPT-HANDLER classe-memorizzazione nome percorso-script
Valore predefinito: nessuno.
Specifica uno script per il server di invio da eseguire per ogni pacchetto ricevuto in un vano di memoria.
shipping_server gestisce ogni pacchetto ricevuto nel modo seguente:
nomep-script [ –d/ata nomep-file-pacchetto ] [ –a/ctual nomep-ordine-invio ] [ –s/class classe-memorizzazione ] –o/rigin nome host
dove
nomep-script | Lo script specificato nella voce RECEIPT-HANDLER. |
–d/ata nomep-file-pacchetto | L'ubicazione del pacchetto. Questa opzione è utilizzata solo quando il pacchetto è destinato a questo host. |
–a/ctual nomep-ordine-invio | L'ubicazione dell'ordine di invio. Questa opzione è utilizzata solo quando il pacchetto è destinato ad un altro host. |
–s/class classe-memorizzazione | La classe di memorizzazione associata al pacchetto. Questa opzione è utilizzata solo se il pacchetto era associato ad una classe di memorizzazione quando è stato creato. |
–o/rigin nome host | Il nome dell'host da cui il pacchetto è stato inviato in precedenza. |
CLEARCASE_MIN_PORT numero-porta CLEARCASE_MAX_PORT numero-porta
Valore predefinito: nessuno.
Queste voci indicano l'intervallo di porte per il server di invio da utilizzare su un sistema firewall ed essi sono impostati come variabili di a ambiente nell'ambiente del server di invio.
Istruzioni per l'impostazione dei valori:
DOWNHOST-TIMEOUT minuti
Valore predefinito: Zero.
Specifica il numero di minuti di attesa del server di invio prima di provare a contattare l'host di destinazione precedentemente identificato come non raggiungibile.
Se il server di invio tenta di inviare un pacchetto ad un host di destinazione e determina che tale host non è raggiungibile, esso crea un file nella directory /var/adm/rational/clearcase/shipping/ms_downhost. Il nome del file è il nome dell'host non raggiungibile. Se il valore di uno dei seguenti parametri è diverso da zero, il server di invio controlla la directory per gli host di destinazione durante le operazioni di invio future.
Se entrambi i parametri hanno un valore diverso da zero, il server di invio utilizza DOWNHOST-TIMEOUT.
Se l'host di destinazione viene rilevato nella directory ms_downhost e la differenza tra l'ora corrente e l'ora dell'ultima modifica del file è inferiore al valore di timeout sull'host del server di invio, il server di invio non tenta di inviare i pacchetti all'host di destinazione. Se la differenza è uguale o maggiore del valore di timeout, il server di invio tenta di inviare i pacchetti ad un host di destinazione. Se né DOWNHOST-TIMEOUT né la variabile di ambiente SHP_DOWNHOST_TIMEOUT_RETRY dispone di un valore diverso da zero, il server di invio tenta di inviare il pacchetto all'host di destinazione. (Ogni tentativo di inviare un pacchetto ad un host non raggiungibile richiede circa 30 secondi.)