scruboplog

刪除抄本的作業日誌項目

適用性

產品 指令類型
MultiSite multiutil 次指令
平台
UNIX®
Windows®

用法概要

scruboplog

{ [ –cl/an clan-name ] [ –site site-name ] | [ –dbset dbset-name ] }
–fam/ily family-name  –u/ser username  –p/assword password
–before { date-time | oplog-ID }

說明

必須在很長一段時間內將作業日誌 (oplog) 項目保存在抄本中。抄本產生更新封包以傳送到所有其他抄本時,會使用這些項目。另外也需要作業日誌項目協助其他抄本從失敗中回復。

然而,您偶而可能想要刪除(清除)作業日誌項目,以便將抄本所在的硬碟空間最佳化。您也可以用 scruboplog 指令來刪除不會再使用的抄本之作業日誌。

雖然作業日誌項目只會記錄已在您的抄本中發生的變更,但經過一段時間後,這個資訊需要的空間,可能和資料本身所需要的一樣多。

在清除抄本的作業日誌項目之前,您必須確定不再需要它們,而且系列中的其他抄本具備您要從抄本的作業日誌刪除的資訊。此外,您必須先將系列中的抄本同步化,然後再清除作業日誌。

您也可以使用 scruboplog 指令,清除 ClearQuest MultiSite 環境中未部署的資料庫,並使用 ClearQuest Web 全文搜尋功能。

限制

您必須有 Super User 專用權。

選項和引數

指定群體、網站及系列

預設值
群體:在這個網站上第一個抄寫的群體。如果在這個主機上有多個登錄的 dbset 連線,則 –clan 是必要的。

網站:現行網站。如果在這個主機上有多個網站,則 –site 是必要的。

系列:無預設值;您必須指定系列。

–cl/an clan-name
抄本的群體名稱。
–site site-name
抄本的網站名稱。
–fam/ily family-name
使用者資料庫系列:建立使用者資料庫時提供的資料庫名稱。

綱目儲存庫系列:系列名稱為 MASTR

指定資料庫集及系列

您可以使用 scruboplog 指令,清除 ClearQuest MultiSite 環境中未部署的資料庫,並使用 ClearQuest Web 全文搜尋功能。

預設值
資料庫集:ClearQuest 版本。
系列:無預設值;您必須指定系列。
dbset dbset-name
資料庫連線的名稱。
fam/ily family-name
使用者資料庫系列:建立使用者資料庫時指定的資料庫名稱。
綱目儲存庫系列:系列名稱為 MASTR

指定使用者名稱及密碼

預設值
您必須指定使用者名稱和密碼。
–u/ser user
具有 Super User 專用權的使用者名稱。
–p/assword password
與指定使用者相關聯的密碼。

指定要刪除的項目

預設值
您必須指定要刪除的項目。
–before { date-time | oplog-ID }
刪除在指定的 date-timeoplog-ID 之前的所有作業日誌項目。不包含引數:不刪除在指定的日期或時間建立的作業日誌項目,也不刪除具備指定的 ID 之作業日誌項目。

oplog-ID 引數必須是整數。

為了確保您未意外刪除作業日誌,您必須在使用這個指令時指定年份。如果您未輸入年份即輸入日期,這個指令會採用目前的日曆年份;例如,若是在 2006 年 2 月,您試圖移除在 2005 年 11 月 19 日之前建立的所有作業日誌,而且您使用 19-November 的項目,scruboplog 就會將 2006 年 11 月 19 日之前建立的所有作業日誌刪除,其中包括現行年份中的所有作業日誌(因為它們全都在 2006 年 11 月之前)。

如果要顯示抄本的作業日誌,請使 dumpoplogdate-time 引數可以擁有下列任一格式:

date.time | date | time
其中:
date
= day-of-week | long-date
time
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
day-of-week
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
long-date
= d[d]month[[yy]yy]
month
= January |... |December |Jan |... |Dec

依照當地時區,以 24 小時制指定時間。如果省略時間,預設值是 00:00:00。如果省略 date,預設值是 today。如果省略世紀、年份或特定日期,則會使用最近的世紀、年份或日期。如果您希望不論時區為何,都將時間解析成相同時刻,請指定 UTC。您可以使用加號 (+) 或減號 (-) 運算子來指定 UTC 時間的正負時差。如果您指定 UTC,而不含小時或分鐘時差,預設值是格林威治標準時間 (GMT)。(1970 年 1 月 1 日世界標準時間 (UTC) 之前的日期無效。)

範例
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC

範例

在這些範例中會斷行以便於閱讀,您必須在實際的一行中輸入每一個指令。

  • 針對 boston_hub 抄本的 DEV 系列,刪除在 2002 年 1 月 21 日之前的作業日誌項目。

    multiutil scruboplog -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd -before 21-January-2002

  • 針對 tokyo 抄本的 TEST 系列,刪除 1 到 300 的作業日誌項目。

    multiutil scruboplog -clan testing -site tokyo -family TEST
    -user masako -p passwd -before 301

  • 針對 ClearQuest MultiSite 配置中未部署使用者資料庫的 CLSIC 資料庫集的 PTEST 使用者資料庫,刪除 2009 年 1 月 1 日之前的作業日誌項目:

    multiutil scruboplog -dbset CLSIC -family PTEST -user susan -p passwd -before 1-January-2009


意見