執行 UpdateSecurityLabels 指令行公用程式的組態
執行 UpdateSecurityLabels 指令行公用程式之前，需要做出某些內容組態決定。可以設定下列內容以建立可以執行公用程式、設定公用程式的執行方式、增強效能等的使用者。
 |
啟用「修改安全性標籤」稽核事件會大幅增加 UpdateSecurityLabels 指令行公用程式的執行時間。如需詳細資訊，請參閱 Windchill 說明中心 中的「針對稽核啟用安全性標籤事件」。
|
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 公用程式的詳細資訊，請參閱 Windchill 說明中心中的「使用 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
logger.UpdateSecurityLabelsReport.level = info
logger.UpdateSecurityLabelsReport.additivity = true
5. [選用] 根據需要設定層級，並如上表所述控制可加性：
logger.UpdateSecurityLabelsReport.level = trace
logger.UpdateSecurityLabelsReport.additivity = false
logger.UpdateSecurityLabelsReport.additivity = false
6. 儲存並關閉。
7. 從 windchill shell 中，執行下列指令以將您更新後的檔案複製到安裝目錄：
ant -f bin/swmaint.xml installSiteChanges
8. 重新啟動 Windchill 應用伺服器。