专业化管理 > 确保数据安全 > 安全标签和协议 > 使用 UpdateSecurityLabels 命令行实用程序 > 用于运行 UpdateSecurityLabels 命令行实用程序的配置
用于运行 UpdateSecurityLabels 命令行实用程序的配置
在运行 UpdateSecurityLabels 命令行实用程序前,需要某些特性配置决策。可以设置以下特性来建立能够运行实用程序、设置程序运行方式、增强其性能等的用户。
* 
启用“修改安全标签”审计事件将大大增加 UpdateSecurityLabels 命令行实用程序的运行时间。有关详细信息,请参阅 Windchill 帮助中心 中的“为审计启用安全标签事件”。
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 实用程序的详细信息,请参阅 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
5. [可选] 根据需要设置级别,并如上表中所述控制可加性:
logger.UpdateSecurityLabelsReport.level = trace
logger.UpdateSecurityLabelsReport.additivity = false
6. 保存并关闭。
7. 在 windchill shell 中,运行以下命令来将您的已更新文件复制到安装目录:
ant -f bin/swmaint.xml installSiteChanges
8. 重新启动 Windchill 方法服务器。
这对您有帮助吗?