用于运行 UpdateSecurityLabels 命令行实用程序的配置
在运行 UpdateSecurityLabels 命令行实用程序前，需要某些特性配置决策。可以设置以下特性来建立能够运行实用程序、设置程序运行方式、增强其性能等的用户。
 |
启用“修改安全标签”审计事件将大大增加 UpdateSecurityLabels 命令行实用程序的运行时间。有关详细信息，请参阅为审计启用安全标签事件。
|
wt.properties
下表列出了在 wt.properties 文件中找到的特性：
|
特性
|
说明
|
||
|---|---|---|---|
|
wt.access.UpdateSecurityLabels.authorizedParticipant
|
可选，但建议限制访问权限。
对于已授权运行 UpdateSecurityLabels 命令行实用程序的 LDAP 授权用户、用户定义的组或数据库中的组织，将此特性设置为其 UFID。
默认情况下，此特性设置为站点管理员组。
|
||
|
wt.access.UpdateSecurityLabels.chunkSize
|
可选。
设置此特性以指示在启动第二个分块之前，第一个分块中更新的对象的最大数量。设置此特性可在处理大量更新时提高性能。例如，如果您正在对 100,000 个对象运行实用程序，则可将分块大小设置为将被处理的 5000 和 20 个分块。如果其中的一个分块失败，则只需要对该块进行重新处理，所有其他成功的块可以继续。
默认情况下，此特性设置为 1000。
|
||
|
wt.access.UpdateSecurityLabels.noChangeValue
|
可选。
设置此特性以指示所要使用的字符串将某些安全标签值保持不变，而非将其设置为指定值。
默认情况下，不会设置该特性。
|
||
|
wt.access.UpdateSecurityLabelsReport.file
|
必填。
设置此特性以在执行 UpdateSecurityLabels 命令行实用程序时指定输出文件的名称和位置。输出文件是一个制表符分隔值 (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
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 方法服务器。