shipping.conf

儲存及轉遞配置檔

適用性

產品 指令類型
MultiSite MultiSite 資料結構
平台
UNIX®

用法概要

/var/adm/rational/clearcase/config/shipping.conf

說明

這個檔案可以控制每一個主機中儲存及轉遞機能的作業。此檔案由備註行(開頭為 #)及一或多個配置項目所組成,並且可以包含下文說明的配置項目。部分情況下,如有項目遺漏,相對應的儲存及轉遞作業就會失敗;但有時預設項目已經寫在程式中。

MultiSite 的安裝作業可建立檔案 ccase-home-dir/config/services/shipping.conf.template,其中所有這些項目都已經定義完成。如果 /var/adm/rational/clearcase/config/shipping.conf 不存在,安裝作業會以複製範本檔的方式來建立它。如果 /var/adm/rational/clearcase/config/shipping.conf 存在,安裝作業會請您將現有檔案與範本比較,再進行任何必要的變更。

註: 如果 MultiSite 或 Rational® Shipping Server 不是安裝在預設的安裝目錄 (/opt/rational/clearcase),則必須編輯 shipping.conf 檔,將 /opt/rational/clearcase 改為安裝目錄的路徑名稱。

封包大小

MAX-DATA-SIZE size [ k | m | g ]

預設值(及最大值):2097151 KB (2GB-1KB)

控制個別邏輯封包的分割成為多個實體封包。限制實體封包的大小能夠增進在部分網路中遞送封包的可靠性。size 整數(含選用的 kmg 字尾)指定實體封包檔的大小上限。k 指定 KB,m 指定 MB,g 指定 GB。省略字尾則指定 KB。指定 0(零)也是代表使用預設值。

這個值由下列指令使用(除非您也指定 –maxsize):

當您呼叫 mkreplicasyncreplica 搭配 –out 時,並不使用這個值;您必須使用 –maxsize 來限制封包大小。

通知

NOTIFICATION-PROGRAM e-mail-program-pathname

預設值/opt/rational/clearcase/bin/notify。 如果沒有 NOTIFICATION-PROGRAM 項目存在,則也會使用這個程式。

下列情況會呼叫電子郵件程式:

郵件程式的呼叫方式如下:

e-mail-program-pathname–s subject –f message-file addr ...

管理者的位址

ADMINISTRATOR e-mail-address

預設值root

在本端主機管理儲存及轉遞機能之管理者的電子郵件位址。

如有通知中列出的情況,就會有郵件訊息傳送到指定的位址。配置檔可以包含多個 ADMINISTRATOR 項目;訊息會傳送到所有指定的郵件位址。

儲存體儲存區及傳回儲存區

STORAGE-BAY storage-class directory-pathname

RETURN-BAY storage-class directory-pathname

預設值:使用 –sclass 選項的 multiutil 指令使用 cq_default 儲存類別,以用於未指定至任何儲存類別的封包,以及未配置其儲存類別的封包。mkordershipping_server 指令使用 –default 儲存類別,以用於未指定至任何儲存類別的封包,以及未配置其儲存類別的封包。

這些指令行可定義儲存體儲存區及傳回儲存區的目錄。儲存體儲存區可以保留送出及送入的更新封包, 及儲存類別的移轉順序。傳回儲存區可保留因為無法分送到所有指定的目的地,而傳回原處當中的送入或送出的封包。

您可以使用多個 STORAGE-BAYRETURN-BAY 項目,來定義儲存類別的多個儲存區。shipping_server 能根據儲存區的磁碟分割區中可用的磁碟空間,為每一個封包選取一個儲存區。您指定儲存區的次序不具影響。

註: 最多可建立 64 種儲存類別,其名稱會區分大小寫。

MultiSite 安裝作業可建立具名為 –default 的預設儲存類別。這個類別的儲存體儲存區及傳回儲存區建立在本端主機的 /var/adm/rational/clearcase/shipping 目錄中。 每一個儲存區各包含具名為 incomingoutgoing 的子目錄,用來保留進入及送出的封包。移轉作業會在這些子目錄中尋找封包。使用儲存及轉遞機能之前,請先確定用來建立移轉目錄的 磁碟分割區有足夠的可用空間,能容納所預期的建立複本封包及更新封包。為避免 VOB 資料庫有可能毀損(例如將包含 VOB 資料庫的磁碟分割區填滿便有可能造成這樣的結果),請將儲存體儲存區放在未包含 VOB 儲存目錄的磁碟分割區。

使用 –sclass 選項的 multiutil 指令使用 cq_default 儲存類別,以用於未指定至任何儲存類別的封包,以及未配置其儲存類別的封包。cq_default 儲存類別在 MultiSite 安裝時不會建立。 mkordershipping_server 指令使用 –default 儲存類別,以用於未指定至任何儲存類別的封包,以及未配置其儲存類別的封包。您可以為 Rational ClearQuest® MultiSite 封包建立其他的儲存類別,但必須對 Rational ClearQuest MultiSite 封包及 Rational ClearCase® MultiSite 封包使用不同的儲存類別。

您必須利用 Linux® 和 UNIX 系統的標準 mkdir 指令來建立 directory-pathname。同時,您也必須在新的儲存區中建立 incomingoutgoing 目錄。放在儲存區中的封包會獲得指派與儲存區本身 相同的擁有者、群組及讀寫許可權。(對於儲存區的執行許可權及任何特殊許可權則被忽略。)請務必調整這些許可權(必要的話),以便順利執行 MultiSite 的指令,來處理封包,並且防範未獲授權者的存取。

註: incomingoutgoing 目錄必須位在相同的檔案系統。

期限

EXPIRATION storage-class number-of-days

EXPIRATION–default number-of-days

預設值–default 為 14 日;cq_default 則無(您必須指定期限)。

為與指定儲存類別相關聯的移轉順序指定期限(以日為單位)。這個時期從產生移轉順序的時候開始。如果封包無法在指定的天數以內分送到所有的目的地,該封包就會傳回到原始的傳送主機,並且會有一或多份電子郵件訊息傳送出去(請參閱管理者的位址通知等章節的說明)。

若將 cq_default 指定為儲存類別,可以替未指定給任何儲存類別的移轉順序, 及未配置儲存類別的移轉順序設定期限。例外:若以 mkorder 指令建立移轉順序, 但並未指定儲存類別時,則該移轉順序具有與 –default 儲存類別相關聯的期限。

使用 0(零)表示未指定期限,因此會不斷地重新嘗試遞送。

這項設定被 –pexpire 選項置換為 syncreplicamkreplica

shipping_server 程式不會重試封包的遞送。EXPIRATION 規格只有在您排定定期呼叫 移轉伺服器,以試圖遞送任何未分送封包的情形下才有用。

封包的遞送

ROUTE next-hop host ...

ROUTE next-hop –default

預設值:無。

控制封包的網路遞送。最終目的地是任何一個 host 引數的封包,會被傳送到具名 next-hop 的主機。 這個主機負責最終將封包遞送到目的地(或其他的轉遞)。next-hophost 可以是主機名稱(必須為不同網域中的主機所能使用)或數值的 IP 位址。

您可以在配置檔中併入多個 ROUTE 項目。特殊關鍵字 –default 可容納未在其他 ROUTE 項目中指定的所有主機。

Receipt 處理常式

RECEIPT-HANDLER storage-class script-pathname

預設值:無。

指定移轉伺服器為儲存體儲存區接收的每一個封包所執行的 Script。

shipping_server 將所接收的每一個封包作如下的處理:

  1. 讀取 shipping.conf 檔,以尋找對封包而言適當的 RECEIPT-HANDLER 項目。
    • 如果封包與儲存類別相關聯,並且該儲存類別有 RECEIPT-HANDLER 項目,shipping_server 會使用該項目中指定的 script-pathname。如果未針對儲存類別定義 receipt 處理常式,但是定義了預設的 receipt 處理常式,就會為該封包呼叫預設的 receipt 處理常式。
    • 如果封包並未與儲存類別相關聯,並且 –default 儲存類別有 RECEIPT-HANDLER 的值,shipping_server 就會使用該值。
  2. 以如下的方式呼叫 receipt 處理常式:

    script-pname [ –d/ata packet-file-pname ] [ –a/ctual shipping-order-pname ] [ –s/class storage-class ] –o/rigin hostname

    其中

    script-pname RECEIPT-HANDLER 項目中所指定的 Script。
    –d/ata packet-file-pname 封包的位置。唯有封包以此主機作為目的地時,才使用這個選項。
    –a/ctual shipping-order-pname 移轉順序的位置。唯有封包以另一個主機作為目的地時,才使用這個選項。
    –s/class storage-class 與封包相關聯的儲存類別。唯有建立封包時建立與儲存類別的關聯性,才使用這個選項。
    –o/rigin hostname 最先傳出該封包的主機名稱。
    註: 如果封包專用於本端主機及另一個主機,就會同時使用 –data–actual 參數。該封包會在主機中的複本匯入,再轉遞到下一個目的地。

埠號

CLEARCASE_MIN_PORT port-number CLEARCASE_MAX_PORT port-number

預設值:無。

請注意: 只能在可穿透防火牆進行通訊,並且是以 MultiSite shipping-server-only 選項所安裝的主機中設定這些項目。如果要在防火牆系統使用移轉伺服器,您必須也在 clearcase Script 中設定 CLEARCASE_MIN_PORT 及 CLEARCASE_MAX_PORT 環境變數。

這些項目可指定供移轉伺服器對防火牆系統使用的埠範圍;在移轉伺服器的環境中是以環境變數的形式所設定。

設定其值的準則如下:

無法聯繫主機的逾時期間

DOWNHOST-TIMEOUT minutes

預設值:零。

指定移轉伺服器嘗試與先前識別為無法聯繫的目標主機通訊之前,先等候的分鐘數。

移轉伺服器嘗試將封包傳送到目標主機時,如果判斷該主機無法聯繫,就會在 /var/adm/rational/clearcase/shipping/ms_downhost 目錄中建立檔案。檔案名稱就是無法聯繫的主機名稱。 如果下列其中一個參數的值不是零,在未來的移轉作業期間,移轉伺服器會檢查目錄來尋找目標主機:

如果兩個參數值都是非零,移轉伺服器就會使用 DOWNHOST-TIMEOUT

如果在 ms_downhost 目錄中找到目標主機,且目前的時間與前次修改檔案的時間差距小於移轉伺服器的逾時值,移轉伺服器便不會嘗試將封包傳給目標主機。 如果差距大於或等於逾時值,移轉伺服器會嘗試將封包傳給目標主機。 如果 DOWNHOST-TIMEOUT 和 SHP_DOWNHOST_TIMEOUT_RETRY 環境變數的值都是非零,移轉伺服器會嘗試將封包傳給目標主機。 (將封包傳送到無法聯繫之主機的每一次嘗試約需 30 秒。)


意見