数据库中的服务器配置特性
特性
说明
mksis.collectSupportPackage.additionalFiles
使用 Collect Support Package 诊断时会收集一个固定的文件集。此参数允许您将其他文件添加到该逗号分隔列表中。如果您的系统上安装了诊断工具,PTC RV&S 支持可能会要求您修改此特性。
mksis.constraintsAPI.maxAllowedValues
限制使用约束命令时显示的允许的值的数量。如果约束值的数量超出此限制,则不会在响应中针对该约束显示允许的值。
该值可以设置为从 -1 到 10000 的任何整数。默认值为 -1,表示未定义任何限制。
mksis.databaseBackupLocation
指定嵌入式 Derby 数据库的备份路径。
默认值为 installdir/bin/backup
mksis.includeIntegrityGUILinks
控制由 PTC RV&S 客户端和服务器生成的电子邮件通知中的 PTC RV&S 客户端 URL 链接。
当设置为 true 时,integrity:// 链接包括在所有客户端和服务器生成的电子邮件通知中。PTC RV&S URL 链接显示在 http:// Web URL 链接之后。
当设置为 false 时,integrity:// 链接从客户端和服务器生成的电子邮件通知中排除。
默认值为 true (启用)。
如果启用此特性,则可以使用客户端 GUI 和 Web 界面将以下虚拟字段添加到 PTC RV&S 报告中:Current Item ID (GUI Link)Test Case ID (GUI Link)Test Step ID (GUI Link)。虚拟字段在报告中显示为超链接。禁用此特性不会影响已包含这些字段的 PTC RV&S 报告;即使已经对这些字段进行了其他编辑,包含这些字段的报告也会继续包含这些字段 (除非用户明确删除)。
* 
对此特性的更改会立即生效。
此特性对 http:// Web URL 链接没有影响。
有关 PTC RV&S 客户端 URL 链接的详情,请参阅 PTC RV&S 帮助中心
mksis.flexLicenseInterval
控制轮询 FLEX 许可证使用情况并将其记录在服务器统计信息中的频率 (以秒为单位)。如果多个 PTC RV&S 服务器指向同一个 FLEX 许可证服务器,则在一个 PTC RV&S 服务器上启用此设置。
默认值为 0 (禁用)。
mksis.groupCacheRefreshInterval
控制域的组缓存在后台的刷新频率 (以秒为单位)。允许的最小值为 300 秒。
* 
新缓存刷新特性会替换 mksis.cacheDuration特性(以前用于控制各种内部域相关值的缓存)。以前的值不会迁移至新特性。如果您已自定义 mksis.cacheDuration特性的设置,应审阅新的缓存刷新特性,以确定是否还应该在您的环境中自定义默认值。
默认值为 3600 (秒),等于一小时的间隔。
此特性是由服务器动态更新,并且新值将在保存更改后立即生效。
mksis.heartbeat
对于高可用性故障转移服务器配置,检测信号是主服务器发生故障后辅助服务器启动之前经过的秒数。
默认值为 0 (禁用)。
mksis.ldapCacheRefreshInterval
控制 LDAP 域信息在后台的刷新频率(以秒为单位)。允许的最小值为 300 秒。a
默认值为 43200 (秒),等于 12 小时的间隔。
此特性是由服务器动态更新,并且新值将在保存更改后立即生效。
mksis.logging.additional
指定要修改的其他日志记录类别。该策略的格式为 category:level[,category:level...]。此特性更改后,也会相应修改指定的类别。要禁用一个类别,请指定 -1 级别 (不移除类别)。此特性不应手动修改,而应以日志记录命令结合 --permanent 选项进行设置。
mksis.logging.count
保留的日志文件数。如果日志文件滚动时超出此数目,则最早的日志文件将被删除。只有在 log4j2.xml 文件中正确配置了日志记录时,此策略才有效。必须存在一个名为 LogToServerLog 的附加程序 ExceptionAwareRollingFile。这是新安装的默认值;但较早的安装可能需要重新配置。
默认值为 50
* 
服务器会根据此特性的更改值更新 log4j2.xml 文件。请确保文件具有所需的读写权限。如果文件不可写入,则服务器无法启动。
mksis.logging.email.from
发送日志错误电子邮件消息的电子邮件地址。
* 
地址不能包含空格。例如,PTC RV&S [email protected]PTC RV&S Administrator 是不可接受的。
如果您使用封闭式 SMTP 邮件转发,请确保在此处输入的电子邮件地址必须与在 is.properties 文件中输入的电子邮件地址匹配。
mksis.logging.email.subject
显示在日志错误电子邮件消息中的主题。
默认值为 PTC RV&S serverErrors
mksis.logging.email.threshold
指定级别的日志消息通过电子邮件发送到 mksis.logging.email.to 中列出的地址。始终发送已明确标记为用于电子邮件的日志消息。可接受的值包括:DIAGNOSTICWARNINGERRORFATAL
默认值为 FATAL
* 
要避免产生大量电子邮件,请保留默认的 FATAL 值。
mksis.logging.email.to
以逗号分隔的电子邮件地址列表,PTC RV&S 服务器日志消息将发送到其中的地址。
* 
必须配置此特性和 mksis.mailserver 才可发送日志出错消息。
mksis.logging.inmemory.errorcount
内存中保留的错误日志行数。日志输出显示最近的服务器错误。
所有行都保留在内存中,因此将大小设置得过高会影响服务器性能。
默认值为 50
mksis.logging.inmemory.linecount
内存中保留的日志行数。日志行显示最近的服务器日志输出。
所有行都保留在内存中,因此将大小设置得过高会影响服务器性能。
默认值为 500
mksis.logging.licenseExpiry.enable
控制许可证到期警告的日志记录。如果设置为 true,会定期检查 PTC RV&S 许可证,如果许可证已过期或设置为在下周内过期,则会记录警告。一封电子邮件会发送给 mksis.logging.email.to 特性中列出的管理员,显示许可证到期日期、日志消息和许可证服务器详情。
在 Linux 上,ERROR 日志级别的日志记录会写入 SYSLOG。
如果设置了 mksis.logging.email.tomksis.mailserver 特性,则电子邮件消息会显示所有 ERROR 事件 (包括许可证到期警告)。
默认值为 true
mksis.logging.rollover.ToEnd
滚动期间的日志文件命名。当日志文件大小达到上限时,该日志文件将从 server.log 重命名为 server.#.log。若设置为 true,此策略将 # 设置为比日志目录中的最大数字大 1。若设置为 false,此策略将 # 设置为 1,并且将其他所有日志文件重新依序递增编号。只有在 log4j2.xml 文件中正确配置了日志记录时,此策略才有效。
必须存在一个名为 LogToServerLog 的附加程序 ExceptionAwareRollingFile。这是新安装的默认值;但较早的安装可能需要重新配置。
默认值为 true
mksis.logging.size
日志文件滚动前的大小(以兆字节为单位)。这只是一个估计值,实际滚动可能不会立即发生。只有在 log4j2.xml 文件中正确配置了日志记录时,此策略才有效。
必须存在一个名为 LogToServerLog 的附加程序 ExceptionAwareRollingFile。这是新安装的默认值;但较早的安装可能需要重新配置。
默认值为 10
* 
服务器会根据此特性的更改值更新 log4j2.xml 文件。请确保文件具有所需的读写权限。如果文件不可写入,则服务器无法启动。
mksis.logging.syslog.enable
PTC RV&S Serverlog4j2.xml 文件中以注释掉的格式提供预设的 syslog appender 配置:
format = RFC5424
appName = RVSServer
facility = Local7
newLine = true
如果您希望启用预设配置,请执行以下操作:
mksis.logging.syslog.enable 设置为 true 并将出现的所有 LogToSyslog appender 取消注释。
重新启动服务器以重新载入在 log4j2.xml 文件中完成的配置更改。
如果您希望使用自定义配置,请执行以下操作:
mksis.logging.syslog.enable 设置为 false
手动添加所需的 SyslogAppender 配置到 log4j2.xml 文件。
重新启动服务器以重新载入在 log4j2.xml 文件中完成的配置更改。
mksis.logging.syslog.hostname
指定 syslog 主机名,错误将在其中记录到 syslog 监视程序。
默认值为 localhost
mksis.logging.syslog.port
指定用于将日志记录消息发送到 syslog 监视程序的默认 syslog 端口号。
默认值为 514
mksis.logging.syslog.protocol
指定用于将日志记录消息传输到 syslog 监视程序的协议。
默认值为 UDP
mksis.mailserver
事件触发器环境 bean 方法 sendMail() 使用的邮件服务器名称。例如,要使用 emailAdvanced.js 触发器脚本,必须设置此特性。此特性默认未启用。
用于电子邮件通知和事件触发器环境 bean 方法 sendMail() 的邮件服务器端口。默认端口为 25
用于电子邮件通知的 SMTP 服务器的主机名或 TCP/IP 地址。必须指定以启用电子邮件通知,例如,mksis.im.smtpserver=smtp1.abc.com
默认值为 :25
* 
您还可以使用此特性和 mksis.logging.email.toPTC RV&S Server 日志出错消息以电子邮件形式发送。有关详情,请参阅以下特性:
mksis.logging.email.threshold
mksis.logging.email.to
mksis.logging.email.from
mksis.logging.email.subject.
mksis.metrics.enableEndpoint
如果设置为 true,则 URL 能够以 Prometheus 指标格式提供统计数据。
该特性的默认值为 false
mksis.metrics.allowedUsers
支持管理员添加可以访问指标端点的用户。对于该特性的值,管理员可以用逗号分隔的方式添加多个用户名。
* 
要防止非活动用户访问指标,请勿将其列入允许的用户列表,或在其状态变为非活动时将其从列表中移除。
mksis.metrics.enableLatency
用于捕获主服务器和 FSA 服务器的入站和出站数据流的延迟数据。
该特性的默认值为 false
mksis.serverLicenseInterval
控制轮询服务器许可证使用情况并将其记录在服务器统计信息中的频率 (以秒为单位)。要禁用对服务器许可证使用情况数据的收集,请设置为 0
默认值为 60
mksis.statisticsInterval
服务器统计记录之间的秒数。为了帮助诊断间歇性性能问题,请降低该值。
默认值为 3600
mksis.statisticsPurge
清除服务器统计信息的持续时间。可接受的值为:weeklymonthly、或无 (如果您计划手动执行此活动)。
默认值为 weekly
mksis.thingworx.websocket.appkey
此特性仅适用于您使用 PTC Navigate Manage Traces 的情况。将此特性的值设置为您在 PTC Navigate Manage Traces 的安装和配置过程中记录下的 PTC RV&S 应用程序密钥。
有关详情,请参阅 PTC Navigate Manage Traces Installation and Configuration Guide (《PTC Navigate Manage Traces 安装和配置指南》)
mksis.thingworx.websocket.url
此特性仅适用于您使用 PTC Navigate Manage Traces 的情况。将此特性的值设置为 ThingWorx WebSocket 的 URL。WebSocket 协议必须指定安全连接 ("wss://<server>:<port>/ThingWorx/WS”)。需要 WebSocket 安全 (WSS) 连接。
有关详情,请参阅 PTC Navigate Manage Traces Installation and Configuration Guide (《PTC Navigate Manage Traces 安装和配置指南》)
mksis.triggers.environmentalVariables
包含事件触发器环境 bean 的运行时特性的文件。默认值为 data/triggers/env.properties
* 
要使任何更改生效,必须重新启动服务器。
mksis.triggers.scripts
事件触发器脚本的目录位置。
默认为 triggers/scripts
* 
要使任何更改生效,必须重新启动服务器。
mksis.userCacheRefreshInterval
控制域的用户缓存在后台的刷新频率 (以秒为单位)。允许的最小值为 300 秒。a
默认值为 3600 (秒),等于一小时的间隔。
此特性是由服务器动态更新,并且新值将在保存更改后立即生效。
mksis.webservices.tmpfile.enable
控制是否启用 Web 服务临时文件删除线程。默认值为 true,允许删除临时文件。
mksis.webservices.tmpfile.ageThreshold
确定 Web 服务临时文件在被删除之前可以存在多长时间 (以分钟为单位)。默认值为 1440(或 24 小时),允许删除 24 小时前的 Web 服务临时文件。
mksis.webservices.tmpfile.repeatDelay
确定运行 Web 服务临时文件删除线程的频率 (以分钟为单位)。默认值为 120(或 2 小时),允许每 2 小时删除一次线程。
mksis.httpSessionTimeout
为服务器的全局 HTTP 会话设置超时。如果 HTTP 会话在超时后仍处于非活动状态,则会话将过期。如果已通过 mksis.httpSessionHeartbeat 特性人为地将与 Web 界面关联的会话保持在活动状态,则可以避免此超时。若值为 0,则忽略此特性,并且 Web 界面的会话超时将成为服务器的配置值。该值以秒为单位存储。
默认值为 300
mksis.httpSessionHeartbeat
如果设置为 true,Web 界面发出“检测信号”,以在浏览器窗口打开时人为地将 HTTP 会话保持为活动状态。如果设置为 false,HTTP 会话在 mksis.httpSessionTimeout 特性指定的时间后过期。
默认值为 true
mksis.apiHttpSessionTimeout
为服务器的 API HTTP 会话设置超时。该值以秒为单位存储。
默认值为 3600
mksis.httpSessionWindow
设置在 HTTP 会话过期之前 Web 界面检测信号必须 ping 服务器的持续时间 (以秒为单位)。
有关详情,请参阅 mksis.httpSessionTimeout
mksis.concurrent.enableBatchEditParallelization
如果设置为 true,则启用并行化以执行批量编辑操作。
默认值为 false
* 
将此特性的值设置为 true 时,所有选定项将同时进行批编辑,并在第一次出现错误时终止操作。错误消息会列出遇到错误的项的项 ID。
mksis.concurrent.maxThreadsPerCPUCore
表示分配给并发执行的每个 CPU 内核线程数。
默认值为 14
最小值为 1
最大值为 16
mksis.concurrent.taskLimitForCommonPool
表示使用共用线程池并发处理的任务数目上限。超出此限制的任务将使用单独线程池执行。
默认值为 256
最小值为 8
最大值为 1024
mksis.concurrent.commonPoolRatioInPercentage
表示共用线程池使用的线程数目的百分比分配。剩余数目的线程将用于单独的线程池。
默认值为 50
最小值为 0
最大值为 100
mksis.concurrent.maxThreadsForAdditionalPool
表示为每个附加池分配的线程数。如果以编程方式完成分配,则此数值设置为 0。
默认值为 0
最小值为 0
最大值为 16
mksis.incomingRMIconnections.rate
设置服务器每分钟接受的最大并发传入 RMI 连接数。
默认值:600
最小值为 0
最大值为 1500
将策略的值设置为 0 可将其禁用。对策略的更改需要重启服务器才能生效。
这对您有帮助吗?