產品 | 指令類型 |
---|---|
MultiSite | multiutil 次指令 |
平台 |
---|
UNIX |
Windows |
–exp/ort
[–cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [–p/assword ] password [–max/size max-packet-size
[–lim/it num-packets ] ]
{ { –sh/ip| –fsh/ip }
–wor/kdir directory [ –sc/lass storage-class ]
[–pex/pire date ]
[–not/ify email ]
| –out { packet-file-pname | staging-area-pname } }
replica ...
–imp/ort
[–cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [ –p/assword] password
{ –rec/eive[ –sc/lass storage-class ]
| { packet-file-pname | staging-area-pname } ... }
[ -plug/epoch ]
將具有一或多個同層級抄本的抄本同步化,其程序有三個階段:
更新封包內容:
無論如何,syncreplica –export 都會建立單一的邏輯更新封包以用於所有指定的目的地;這個封包僅可用來更新那些特定抄本。
MultiSite 專為有效更新抄本而設計。syncreplica –export 試圖排除之前已經傳送的作業。(然而,多次傳送作業到相同的抄本也無妨;第一項作業會被匯入,後續的相同作業會被忽略。)
syncreplica –export 將暫存檔儲存在您以 –workdir 選項指定的目錄中。這個目錄不可已經存在,而且在建立匯出封包之後被刪除。
一個更新封包套用到與接收封包的同步化伺服器相關聯的適當抄本。您不必指定特定的抄本或儲存體位置。
匯入程序以正確的次序套用更新封包。因此,您可以在指令行上以任何次序指定封包。
在匯入階段期間,未針對一般資料庫作業鎖定資料庫抄本,但是會針對所有 其他 MultiSite 作業加以鎖定。
syncreplica –import 在下列狀況中不處理更新封包:
在這些情況中,syncreplica –import 會顯示一項說明訊息。
在某些情況中,syncreplica –import 開始套用作業到一個抄本,但卻失敗並出現錯誤訊息。例如,另一個程序可能已鎖定資料庫,造成匯入失敗。在取消鎖定資料庫之後,您可以執行 syncreplica –import 以重新處理整個更新封包。
匯入已經順利處理的更新封包並無妨礙;相同的變更不會進行兩次。
如果 syncreplica –import 的單一呼叫可將一個封包順利套用到所有與同步化伺服器相關聯的目標抄本,當指令完成其工作時,會刪除更新封包。如果以多個 syncreplica –import 指令處理封包,該封包不會被刪除。
Rational® ClearQuest®連結鉤不會為了回應封包匯入期間所作的變更而發動。
syncreplica 解決在不同抄本建立的物件之間的命名衝突。
syncreplica 未通知 Rational ClearQuest 抄本更新的使用者。所有作用中使用者透過在 Rational ClearQuest 中的一般資料庫輪詢常式,可在幾秒內看到更新。
如果無法遞送封包,會透過儲存及轉遞機能傳送至起源之抄本的同步化伺服器。郵件訊息會傳送給儲存及轉遞管理者。一再試圖遞送封包全部失敗,分配的時間過期之後,就會發生這種情況;目的地主機不明或是資料檔不存在,也會發生這種情況。儲存及轉遞配置設定會指定期限、管理者的電子郵件位址以及通知程式。
您必須有 Super User 專用權。
網站:現行網站。如果在這個主機上有多個網站,則 –site 是必要的。
系列:無預設值;您必須指定系列。
綱目儲存庫系列:系列名稱為 MASTR。
–limit 選項限制 syncreplica 產生的封包數目;每一個封包不大於 max-packet-size。當您的儲存體儲存區或暫置區的磁碟空間有限制時,會使用此選項。
使用 –fship(強制移轉)呼叫移轉伺服器立即傳送更新封包。使用 –ship 不會呼叫這個伺服器。
不會自動遞送更新封包;要使用適當的方法加以遞送。您可以使用 –out 建立封包,並使用儲存及轉遞機能來加以遞送。
date-time 引數可以擁有下列任一格式:
依照當地時區,以 24 小時制指定時間。如果省略時間,預設值是 00:00:00。如果省略 date,預設值是 today。如果省略世紀、年份或特定日期,則會使用最近的世紀、年份或日期。如果您希望不論時區為何,都將時間解析成相同時刻,請指定 UTC。您可以使用加號 (+) 或減號 (-) 運算子來指定 UTC 時間的正負時差。如果您指定 UTC,而不含小時或分鐘時差,預設值是格林威治標準時間 (GMT)。(1970 年 1 月 1 日世界標準時間 (UTC) 之前的日期無效。)
若在未啟用電子郵件通知的 Windows 主機上發生失敗,Windows Event Viewer 中會顯示一則訊息。這個訊息包含以此選項指定的 e-mail-address 值,以及要求通知這位使用者作業狀態的一項注意事項。
網站:現行網站。如果在這個主機上有多個網站,則 –site 是必要的。
系列:無預設值;您必須指定系列。
綱目儲存庫系列:系列名稱為 MASTR。
掃描現行主機的儲存體儲存區。專用於與此主機相關聯的抄本且未經處理的任何更新封包,都會被套用到主機上適當的抄本。利用 –sclass,syncreplica 僅掃描指定的儲存類別之儲存體儲存區。
如果 syncreplica 找到任何抄本建立封包,它會傳送郵件給儲存及轉遞管理者。(如果現行主機是 Windows 主機,且未啟用電子郵件通知,則 Windows 事件檢視器中會顯示訊息。)使用 mkreplica 匯入這些抄本建立封包。
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