–exp/ort[
–cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [ –p/assword] password
[–max/size size ] [–c/omments comments ]
[–size id-block-size ] [ –thres/hold id-block-threshold ]
{
{–sh/ip | –fsh/ip} -wor/kdir temp-dir-pname
[–sc/lass storage-class ]
[ –pex/pire date-time ]
[–not/ify e-mail-addr ]
| –out packet-file-pname } hostname:site-name ...
–imp/ort
{ –site site-name–repo/sitory db-info [ –vendor
vendor-type ] db-params
}
{ [ –data/base db-info [ –vendor vendor-type ] db-params
[ –c/omments comments ] { packet-file-pname|packet-dir-path }...
–imp/ort {
[–cl/an clan-name ] [ -site site-name ] –u/ser username
[–p/assword ] password { –data/base db-info
[ –vendor vendor-type ] db-params
[ –c/omments comments ] { packet-file-pname|packet-dir-path }...
mkreplica –export 指令可能會花很長的時間。正在進行匯出時,會鎖定資料庫及綱目儲存庫。請先確定所有的使用者都已登出,然後再執行 mkreplica –export。
建立新複本的程序包含三階段:
第一次抄寫資料庫時,會啟用資料庫的作業日誌 (oplog)。要抄寫的所有作業都會記錄在 oplog。作業記載會持續到所有的複本被刪除為止,只留下原始資料庫集。其他的複本建立會被記錄在作業日誌項目中。現有的複本透過標準同步化機制瞭解新複本。
MultiSite 控制將多少個記錄 ID 數目配置給每一個複本。這項配置是透過使用 ID 區塊(ID 群組)來完成的。
依預設,在建立每一個複本時,都會提供它擁有 4096 個 ID 的 ID 區塊。當複本達到尚有 1024 個 ID 可供使用的臨界值時,會對它配置另一個擁有 4096 個 ID 的 ID 區塊,以確保所有的 ID 都是唯一的。在同步化期間,ID 區塊配置由工作中綱目儲存庫於內部處理。
視複本系列的活動層次而定,將配置給複本的 ID 區塊大小加大,可能會有幫助。例如,使用預設值,如果您嘗試送出很多個問題,第一個 4096 會順利送出,但是之後的送出作業會失敗。
當您以 mkreplica –export 指令建立複本時,如果要控制配置給複本的 ID 數目,您可以結合 –threshold 選項來使用 –size 選項。 您可以利用 chreplica 指令修改這些設定。
mkreplica –export 的每一個呼叫會都建立單一的邏輯複本建立封包。(即使您以一個 mkreplica 指令建立數個新複本,這仍然成立。)每一個封包包含一或多個複本規格,其中每一個都指出新複本的名稱以及與新複本相關聯的同步化伺服器。
使用者資料庫及綱目儲存庫在匯出階段期間會被鎖定。
–maxsize 選項將單一邏輯封包分成多個實體封包,以符合轉送媒體的限制。
鎖定: 如果已鎖定資料庫(例如,在升級程序期間),或是執行另一個 Rational ClearQuest MultiSite 作業,這個指令會失敗。
其他: 您無法將資料庫抄寫到執行不同版 MultiSite 的主機。您可以在任何站台執行 mkreplica –export;不過,仍建議您一律在工作中綱目儲存庫站台加以執行,以避免利用相同的名稱建立多個站台。
站台:現行站台。 如果在這個主機上有多個站台, 則 –site 是必要的。
系列:無預設值;您必須指定系列。
綱目儲存庫系列:不適用。您執行 mkreplica 時,所指定的使用者資料庫系列之相關聯綱目儲存庫會包含在複本建立封包中。
預設:無。
–fship(強制移轉)呼叫 shipping_server 傳送複本建立封包。–ship 將封包放置在 儲存體儲存區中。如果要傳送封包,請呼叫 shipping_server。
儲存體儲存區所在的磁碟分割 (在傳送端主機和接收端主機上)必須有等於或大於複本建立封包大小的可用空間。
預設: mkreplica 將封包放在為 cq_default 類別所指定的儲存體儲存區位置。
不會自動遞送複本建立封包;要使用適當的方法加以遞送。您可以使用 –out 建立封包,並隨後使用儲存及轉遞機能來加以遞送。
date-time 引數可以擁有下列任一格式:
依照當地時區,以 24 小時制指定時間。 如果省略時間,預設值是 00:00:00。如果省略 date,預設值是 today。 如果省略世紀、年份或特定日期,則會使用最近的世紀、年份或日期。 如果您希望不論時區為何,都將時間解析成相同時刻,請指定 UTC。 您可以使用加號 (+) 或減號 (-) 運算子來指定 UTC 時間的正負時差。如果您指定 UTC,而不含小時或分鐘時差, 預設值是格林威治標準時間 (GMT)。(1970 年 1 月 1 日世界標準時間 (UTC) 之前的日期無效。)
若在未啟用電子郵件通知的 Windows 主機上發生失敗,Windows Event Viewer 中會顯示一則訊息。這個訊息包含以此選項指定的 e-mail-address 值,以及要求通知這位使用者作業狀態的一項附註。
hostname 可以是主機的 IP 位址或是電腦名稱,例如,minuteman。 您可能必須附加 IP 網域名稱,例如,minuteman.purpledoc.com。
在 Linux 和 UNIX 系統上,請利用 uname –n 指令來顯示電腦名稱。在 Windows 上,從控制台的系統圖示可存取電腦名稱。在 Windows 2000 上,按一下網路識別標籤。在 Windows NT® Server 2003 上,按一下電腦名稱標籤。
您匯入複本時,必須為綱目儲存庫複本指定供應商資料庫的資料庫參數,並為使用者資料庫複本指定供應商資料庫。您必須先建立這些資料庫,然後再匯入複本封包。
站台:現行站台。 如果在這個主機上有多個站台, 則 –site 是必要的。
若為 DB2、Oracle 及 Microsoft SQL Server,請指定 db-info 和 db-params
每個資料庫供應商都有一個預設埠號:
供應商 | 預設埠 |
---|---|
DB2 | 50000 |
Oracle | 1521 |
Microsoft SQL Server | 1433 |
如果您的資料庫使用不同的埠,您必須利用 connect-options 參數來指定它。 比方說,如果您有使用 1526 埠的 Oracle 資料庫,請輸入下列指令:
multiutil mkreplica -imp -site SITEA -repo CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_1 admin_1 -con PORT=1526 -data CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_2 admin_2 -con PORT=1526 C:\TEMP\admin\mk_SITEA.xml
重要事項:如需供應商資料庫之支援值的相關資訊,請參閱「說明」的「管理 Rational ClearQuest」一節中的「供應商資料庫內容」主題。
multiutil mkreplica -export -clan telecomm -site boston_hub -family DEV
-u susan -p passwd -out c:\cqms\boston_hub.xml goldengate:sanfran_hub
Multiutil: Packet file `c:\cqms\boston_hub.xml' generated
multiutil mkreplica -export -clan telecomm -site boston_hub -family LAB
-user susan -p passwd -out c:\cqms\lab.xml goldengate:sanfran_hub
Multiutil: Packet file `c:\cqms\lab.xml' generated
multiutil mkreplica -export -clan testing -site tokyo -family TEST
-user masako -p passwd -fship -workdir c:\cqms\working -sclass
cq_default taronga:sydney
Multiutil: Packet file
`c:\cqms\working\mk_TOKYO_29-January-02_09-47-27.xml' generated
multiutil: Shipping order
"C:\temp\cqms\ms_ship\outgoing\sh_o_mk_TOKYO_29-January-02_09-47-27.xml"
generated.
multiutil: Attempting to forward/deliver generated packets...
multiutil: -- Forwarded/delivered packet
C:\temp\cqms\ms_ship\outgoing\mk_TOKYO_29-January-02_09-4
multiutil mkreplia -export -clan telecomm -site boston_hub -family DEV
-user susan -password passwd -c "make a new replica for sanfran_hub"
-ship -workdir c:\temp\working -sclass cq_default
-pexpire 22-November-2003
goldengate:sanfran_hub
multiutil mkreplica -import -site sanfran_hub
-repository sanfran_schemarepo
-vendor SQL_SERVER -server sb_server -dbologin jcole passwd
-database sanfran_userdb -vendor SQL_SERVER
-dbologin jcole passwd
multiutil mkreplica -import -clan testing -site sydney -user bfife
-p passwd -database syd_userdb -vendor SQL_SERVER
-dbologin bfife passwd