Prodotto | Tipo di comando |
---|---|
MultiSite | comando secondario multiutil |
Piattaforma |
---|
UNIX® |
Windows® |
–exp/ort
[ –cl/an nome-gruppo ] [ –site nome-sito ] –fam/ily nome-famiglia
–u/ser nome utente [–p/assword ] password [–max/size dimensione-pacchetto-massima
[–lim/it num-pacchetti ] ]
{ { –sh/ip| –fsh/ip }
–wor/kdir directory [ –sc/lass classe-memorizzazione ]
[–pex/pire data ]
[–not/ify email ]
| –out { nomep-file-pacchetto | nomep-area-gestione temporanea } }
replica ...
–imp/ort
[ –cl/an nome-gruppo ] [ –site nome-sito ] –fam/ily nome-famiglia
–u/ser nome utente [ –p/assword] password
{ –rec/eive[ –sc/lass classe-memorizzazione ]
| { nomep-file-pacchetto | nomep-area-gestione temporanea } ... }
[ -plug/epoch ]
La sincronizzazione di una replica con una o più repliche di pari livello è un processo di tre fasi:
Contenuto di un pacchetto di aggiornamento:
In tutti i casi, syncreplica –export crea un pacchetto logico singolo di aggiornamento in tutte le destinazioni specificate; il pacchetto può essere utilizzato per aggiornare solo quelle repliche particolari.
MultiSite è progettato per l'aggiornamento efficace delle repliche. syncreplica –export tenta di escludere le operazioni inviate precedentemente. (Tuttavia, non comporta alcun danno inviare un'operazione più volte alla stessa replica; la prima operazione viene importata e le operazioni identiche successive sono ignorate.)
syncreplica –export memorizza i file temporanei nella directory specificata con l'opzione –workdir. Questa directory non deve già esistere e viene eliminata in seguito alla creazione del pacchetto di esportazione.
Un pacchetto di aggiornamento viene applicato alle repliche appropriate associate al server di sincronizzazione che ha ricevuto il pacchetto. Non è necessario specificare le repliche particolari o le ubicazioni di memorizzazione.
Il processo di importazione si applica ai pacchetti di aggiornamenti nell'ordine corretto. Quindi, è possibile specificare i pacchetti in qualsiasi ordine sulla riga comandi.
La replica di database non è bloccata per le operazioni normali di database durante la fase di importazione, ma è bloccata per tutte le altre operazioni MultiSite.
syncreplica –import non elabora nessun pacchetto di aggiornamento nelle situazioni seguenti:
In questi casi, syncreplica –import visualizza un messaggio informativo.
In alcuni casi, syncreplica –import comincia ad applicare le operazioni ad una replica, ma non riesce restituendo un messaggio di errore. Ad esempio, un altro processo ha bloccato il database, provocando l'errore di importazione. Dopo avere sbloccato il database, è possibile eseguire syncreplica –import per elaborare nuovamente l'intero pacchetto di aggiornamento.
L'importazione di pacchetti di aggiornamento già elaborati correttamente non provoca alcun danno; la stessa modifica non verrà eseguita due volte.
Se un singolo richiamo di syncreplica –import applica correttamente un pacchetto a tutte le repliche di destinazione associate con il server di sincronizzazione, il pacchetto di aggiornamento viene eliminato al completamento del comando. Se il pacchetto viene elaborato con più comandi syncreplica –import, esso non viene eliminato.
Gli hook di Rational ClearQuest non vengono attivati in risposta alle modifiche eseguite durante l'importazione del pacchetto.
syncreplica risolve i conflitti di denominazione tra gli oggetti creati in repliche diverse.
syncreplica non informa gli utenti Rational ClearQuest sugli aggiornamenti alle repliche. Tutti gli utenti attivi visualizzano gli aggiornamenti entro pochi secondi, mediante le routine di polling database normali in Rational ClearQuest
Se un pacchetto non può essere consegnato, esso viene inviato mediante la funzione di memorizzazione e inoltro al server di sincronizzazione per la replica di origine. Viene inviato un messaggio di posta all'amministratore di memorizzazione e inoltro. Questo si verifica dopo vari tentativi di consegna del pacchetto tutti non riusciti quando il tempo assegnato è scaduto; ciò si verifica anche quando l'host di destinazione è sconosciuto o il file di dati non esiste. Le impostazioni di configurazione di memorizzazione ed inoltro specificano il periodo di scadenza, l'indirizzo e-mail dell'amministratore e il programma di notifica.
Sito: il sito corrente. Se esiste più di un sito in questo host, –site è obbligatorio.
Famiglia: nessun valore predefinito; è necessario specificare una famiglia.
Famiglia di repository di schemi: il nome della famiglia è MASTR.
L'opzione –limit limita il numero dei pacchetti generati da syncreplica; ogni pacchetto non è superiore al valore dimensione-pacchetto-massima. Utilizzare questa opzione quando lo spazio su disco per il vano di memoria o l'area di gestione temporanea è limitata.
L'uso di –fship (force ship) richiama il server di invio per inviare il pacchetto di aggiornamento immediatamente. L'uso di –ship non richiama questo server.
I pacchetti di aggiornamento non sono consegnati automaticamente; utilizzare un metodo appropriato per distribuirli. È possibile creare un pacchetto utilizzando –out e distribuirlo mediante la funzione di di memorizzazione e inoltro.
L'argomento data-ora può disporre di uno dei seguenti formati:
Specificare l'ora nel formato 24 ore, relativa al fuso orario locale. Se si omette l'ora, il valore predefinito è 00:00:00. se si omette la data, il valore predefinito è today. Se si omette il secolo, l'anno o una data specifica, viene utilizzata quella più recente. Specificare UTC se si desidera utilizzare l'ora da risolvere simultaneamente senza considerare il fuso orario. Utilizzare l'operatore più (+) o meno (-) per specificare la variazione positiva o negativa per l'ora UTC. Se si specifica UTC senza le variazioni dei minuti e delle ore, l'impostazione predefinita è GMT (Greenwich Mean Time). (Le date precedenti al 1° Gennaio 1970 UTC (Universal Coordinated Time) non sono valide.)
Se si verifica un errore su un host Windows che non ha la notifica e-mail abilitata, viene visualizzato un messaggio nel Visualizzatore di eventi Windows. Il messaggio include il valore indirizzo-e-mail specificato con questa opzione e una nota che richiede a questo utente di essere informato sullo stato dell'operazione.
Sito: il sito corrente. Se esiste più di un sito in questo host, –site è obbligatorio.
Famiglia: nessun valore predefinito; è necessario specificare una famiglia.
Famiglia di repository di schemi: il nome della famiglia è MASTR.
Esegue la scansione dei vani di memoria dell'host corrente. Ogni pacchetto di aggiornamento non elaborato inteso per le repliche associate a questo host, viene applicato alla replica appropriata nell'host. Con l'opzione –sclass, il comando syncreplica esegue la scansione solo dei vani di memoria della classe di memorizzazione specificata.
Se syncreplica trova un pacchetto di creazione della replica, esso invia un messaggio di posta all'amministratore di memorizzazione e inoltro. (Se l'host corrente è un host Windows e la funzione di notifica e-mail non è abilitata, viene visualizzato un messaggio nel Visualizzatore eventi di Windows.) Utilizzare il comando mkreplica per importare questi pacchetti di creazione della replica.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family SAMPL -user susan -p passwd -out c:\cqms\sanfran_hub_sync.xml
sanfran_hub
Multiutil: Packet file `c:\cqms\sanfran_hub_sync.xml' generated
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -maxsize 500mb -workdir c:\work
-ship -sclass cq_default sanfran_hub
Multiutil: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-55-16.xml' generated
multiutil: Shipping order
"C:\temp\cqms\ms_ship\outgoing\sh_o_sync_BOSTON_HUB_26-March-02_
10-55-16.xml" generated.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -password p -maxsize 500mb -workdir
c:\work -fship -sclass cq_default sanfran_hub
Multiutil: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-56-43.xml' generated
multiutil: Shipping order "C:\cqms\ms_ship\outgoing\sh_o_sync_
BOSTON_HUB_26-March-02_10-56-43.xml" generated.
multiutil: Attempting to forward/deliver generated packets...
multiutil: -- Forwarded/delivered packet
C:\cqms\ms_ship\outgoing\sync_BOSTON_HUB_26-March-02_10-
---- NOTE: consult the NT event log for errors.
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV
-user jcole -p passwd -receive -sclass cq_storage
Multiutil: 4 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet C:\temp\cqms\ms_ship\incoming\sync_
boston_hub_22-January-02_11-10-34.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xm
Multiutil: 1 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet c:\cqms\sanfran_hub_sync.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xml
Multiutil: The UPDATE_PACKET packet sent from boston_hub at
2002-01-22 15:15:50 is destined for schema revision 2, not 1;
re-execute syncreplica after site admin has upgraded database.
Multiutil: 2 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: Preserving packet c:\cqms\sanfran_hub_sync.xml.
multiutil syncreplica -import -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -receive
Multiutil: 1 transactions from SANFRAN_HUB have been replayed
into the MASTR database
Multiutil: 2 transactions from SANFRAN_HUB have been replayed
into the DEV database
Multiutil: Deleting packet C:\temp\cqms\ms_ship\incoming\sync_
SANFRAN_HUB_07-February-02_11-24-49.xml