特定管理 > 確保資料安全性 > 安全性標籤與協定 > 使用 UpdateSecurityLabels 指令行公用程式 > 執行 UpdateSecurityLabels 指令行公用程式的組態
  
執行 UpdateSecurityLabels 指令行公用程式的組態
執行 UpdateSecurityLabels 指令行公用程式之前,需要做出某些內容組態決定。可以設定下列內容以建立可以執行公用程式、設定公用程式的執行方式、增強效能等的使用者。
* 
啟用「修改安全性標籤」稽核事件會大幅增加 UpdateSecurityLabels 指令行公用程式的執行時間。如需詳細資訊,請參閱針對稽核啟用安全性標籤事件
wt.properties
下表列出在 wt.properties 檔案中找到的內容:
屬性
描述
wt.access.UpdateSecurityLabels.authorizedParticipant
選用,但建議限制存取。
將此內容設定為資料庫內 LDAP、使用者定義群組或組織中已獲授權可以執行 UpdateSecurityLabels 指令行公用程式之授權使用者的 UFID。
依預設,此內容設定為網站管理員群組。
wt.access.UpdateSecurityLabels.chunkSize
選用。
設定此內容以指示在啟動一個區塊之前,要在另一個區塊中更新的最大物件數。當處理大量更新時,設定此內容可改善效能。例如,如果您正針對 100,000 個物件執行公用程式,您可將區塊大小設定為 5000,如此可以處理 20 個區塊。如果在其中一個區塊中發生失敗,只有該區塊需要重新處理,而其他所有成功的區塊都可以繼續。
依預設,此內容設為 1000。
wt.access.UpdateSecurityLabels.noChangeValue
選用。
設定此內容可指示要用於保持某些安全性標籤值不變,而非將其設定為指定值的字串。
* 
將字串設定為不是任何已配置安全性標籤之有效安全性標籤值的值。對於自訂安全性標籤,這包括空字串。如果您將內容設定為符合任何安全性標籤值的值,該值不會變更。
依預設,不會設定此內容。
wt.access.UpdateSecurityLabelsReport.file
必要。
設定此內容可在執行 UpdateSecurityLabels 指令行公用程式時指定輸出檔案的名稱與位置。輸出檔案是 tab 分隔值 (TSV) 檔案。為檔案名稱附加 Java 虛擬機器識別元 (%jid)、執行緒識別元 (%tid) 或以毫秒為單位的時間 (%time),或全部三個值,以確保每個輸出檔案都有唯一的檔案名稱。
依預設,會將內容設定為在 Windchill 記錄目錄中產生輸出檔案。預設值為 wt.access.UpdateSecurityLabelsReport.file=$(wt.logs.dir)$(dir.sep)CLT_Report-%time-%jid-%tid.tsv
wt.access.UpdateSecurityLabelsReport.maximumFileSize
選用。
設定此內容可核對輸出檔案的最大檔案大小 (以位元組為單位)。以字串格式指定內容值,例如 10MB、15KB、1GB。
依預設,內容會設定為 10MB。當檔案大小超過臨界值時,會以檔案名稱中加上後綴 '_x' 來產生新輸出檔案,其中 'x' 是檔案編號。
wt.access.UpdateSecurityLabelsReport.maxNoOfFiles
選用。
設定此內容可指定在變換期間將保留的輸出檔案的最大數目。當產生的輸出檔案數達到指定限制時,會以檔案名稱中加上後綴 '_x' 來產生新輸出檔案,其中 'x' 是檔案編號。
依預設,此內容會設定為 10 個檔案。
如需有關設定內容的詳細資訊,請參閱使用 xconfmanager 公用程式
log4jMethodServer.properties
下表列出在 log4jMethodServer.properties 檔案中現成可用的內容:
屬性
描述
logger.UpdateSecurityLabelsReport.additivity
選用。
設定此內容可確定除了輸出檔案以外,是否將資訊寫入到應用伺服器記錄。
依預設,此內容會設定為 True
logger.UpdateSecurityLabelsReport.level
必要。
設定此內容可決定在輸出檔案中包含的詳細資訊層級。可用的值如下:
trace:顯示每個處理的物件的輸入檔案位置、摘要行及狀況。
info:顯示個別物件的輸入檔案位置、摘要行及所發生的任何失敗或錯誤。
error:顯示個別物件的輸入檔案位置及所發生的任何失敗或錯誤。
依預設,此內容會設定為 info
欲在 log4jMethodServer.properties 檔案中設定內容,請完成下列步驟:
1. 導覽至下列來源檔案:<Windchill>/codebase/WEB-INF/log4jMethodServer.properties
2. log4jMethodServer.properties 檔案複製到下列位置:
<Windchill>/wtSafeArea/siteMod/codebase/WEB-INF
<Windchill>/wtSafeArea/ptcOrig/codebase/WEB-INF
3. 在文字編輯器中開啟 <Windchill>/wtSafeArea/siteMod/codebase/WEB-INF/log4jMethodServer.properties 檔案。
4. log4jMethodServer.properties 檔案中,UpdateSecurityLabels 的記錄程式組態依預設會在指令行公用程式中按如下所示定義:
logger.UpdateSecurityLabelsReport.name = wt.access.UpdateSecurityLabelsReport
logger.UpdateSecurityLabelsReport.level = info
logger.UpdateSecurityLabelsReport.additivity = true
5. [選用] 根據需要設定層級,並如上表所述控制可加性:
logger.UpdateSecurityLabelsReport.level = trace
logger.UpdateSecurityLabelsReport.additivity = false
6. 儲存並關閉。
7. 從 windchill shell 中,執行下列指令以將您更新後的檔案複製到安裝目錄:
ant -f bin/swmaint.xml installSiteChanges
8. 重新啟動 Windchill 應用伺服器。