服务器配置 > 工作流的服务器特性 > Windchill RV&S 服务器配置特性 > is.properties 中的 Windchill RV&S 服务器 特性
is.properties 中的 Windchill RV&S 服务器 特性
特性
说明
mksis.smtp.authentication=
指定要使用的邮件转发的类型。将值设置为 true 可使用封闭式邮件转发来发送邮件。将此特性设置为 false 可使应用程序能够使用开放式邮件转发来发送电子邮件。
mksis.smtp.ssl.enabled=
指定是启用还是禁用 TLS 协议。将值设置为 true 可在 SMTP 服务器上启用 TLS 加密。仅当使用签名者许可证给 SMTP 服务器配置了 TLS 加密时，可使用该选项。如果 SMTP 服务器配置了 TLS 加密，则可以使用 keytool.exe 命令将签名者证书 (自定义根 CA 或自定义中间 CA) 从 SMTP 服务器导入受信任密钥库。keytool.exe 命令位于 JRE/JDK 文件夹中。

%jdk%\bin\keytool -importcert -alias <<SMTP Server name>> -storetype PKCS12
-keystore jdk\lib\security\cacerts
-file <custome_CA_certificate>
where
-importcert - specifies to import the certificate response
-alias - specifies the name of the entry from which to import
-file - specifies the path from which to read the CA response
必须对所有 CA 重复此命令。
mksis.logging.email.from=
指定发件人的身份验证用户名。
mksis.logging.emailfrom.password=
指定电子邮件发件人的密码 (纯文本形式)。保存并关闭 is.properties 文件后必须运行加密实用工具以将密码加密。
mksis.logging.email.server.hostname=
指定 SMTP 服务器的名称。
mksis.logging.email.server.port=
指定 SMTP 邮件转发所用的端口号。
mksis.clear.port=
明文端口号。要禁用明文端口，将策略设置为 0。(您可以在注释中保留旧端口号。)
端口号不得超过 65535。如果端口号小于 1024，则在 Linux 计算机上可能需要额外权限。
如果指定已经在服务器计算机上使用的端口号，Windchill RV&S 服务器 会在您尝试运行时关闭。
默认值为 7001。
mksis.secure.port=
安全 (TLS 或 SSL) 端口号。要禁用安全端口，将策略设置为 0。(您可以在注释中保留旧端口号。)
端口号不得超过 65535。如果端口号小于 1024，则在 Linux 计算机上可能需要额外权限。
如果指定已经在服务器计算机上使用的端口号，Windchill RV&S 服务器 会在您尝试运行时关闭。
如果指定的值不是 0，则使用安全端口。
* 
定义安全端口并不意味着它是唯一打开的端口。您可以同时打开明文端口和安全端口。
默认值为 0。
mksis.secure.specifiedCipherSuites=
指定以逗号分隔的加密密码列表。
* 
如果至少有一个列表条目是有效的，则服务器会启动；但服务器日志会显示关于无效值的警告消息。如果所有列表条目都无效，则服务器不会启动。
以下是指定 256 位密码的示例：mksis.secure.specifiedCipherSuites=TLS_RSA_WITH_AES_256_CBC_SHA, TLS_DHE_DSS_WITH_AES_256_CBC_SHA
* 
要升级 JVM 以支持指定的加密密码列表，需要下载并安装 Java Cryptography Extension 无限制权限策略文件。
包中含有 Oracle 提供的有关如何将其安装到 JDK 中的说明。需要在客户端和服务器 JVM 上均执行此操作。为 Windchill RV&S 客户端和服务器安装 Java Cryptography Extension 密码的位置为：
<jdk_installdir>\lib\security
mksis.secure.specifiedTLSProtocols=
以逗号分隔的受支持 TLS 协议版本列表。有效值为 TLSv1.2 和 TLSv1.3。
如果未指定值，则默认值为 TLSv1.2 和 TLSv1.3。
不支持的协议版本为 SSLv2、SSLv3、TLSv1.1 和 TLSv1.0。
* 
Windchill RV&S 13.0.0.0 和更高版本支持 TLSv1.3 协议。如果要将较旧的客户端连接到配置了 TLSv1.3 协议的 Windchill RV&S 13.0.0.0 服务器，则必须将 IntegrityClient.lax 文件中 -Dhttps.protocols Java 选项值更新为 TLSv1.2,TLSv1.3。此文件位于目录 <clientInstallDir>\bin 中。仅当 -Dhttps.protocols 选项的值已相应更新时，与配置了 TLSv1.3 协议的服务器的连接才会成功。
mksis.bindAddr=
指示服务器仅绑定到指定的 IP 地址。地址必须是有效的点分四组值。
如果同时设置了 mksis.bindAddr 和 mksis.hostname，请确保这两个设置相符。
默认情况下，服务器会绑定到启动时找到的所有接口。
mksis.url.protocol=
用于对 Windchill RV&S 服务器 的超链接的协议，例如出现在电子邮件和事件触发器中的超链接。可能的值为 http (明文) 和 https (安全)。如果仅使用一个端口，则对端口使用正确的值，而不考虑特性中指定的值为何。如果同时使用了两个端口，则必须指定明文协议或安全协议。
默认值为 http。
mksis.privatekey.password=
用于从证书存储恢复服务器证书私钥的密码。密码必须与证书存储中找到的密码一致。只能在启用了安全端口时使用此特性。
mksis.rmi.maxExecutorThreads=
RMI 子系统可以使用的执行程序线程的最大数目。系统从最少的线程数目开始，并根据需要增加更多线程，直至达到指定的限制。
默认值为 300。
mksis.adminStagingServer=
指定是否将 Windchill RV&S 服务器 用作生产服务器或过渡服务器。有效的选项为 true 或 false。如果为 Windchill RV&S 服务器，则 false 用作标准生产服务器。如果为 true，则 Windchill RV&S 服务器 用作过渡服务器，可用于测试工作流配置，也可以迁移到生产服务器。
默认值为 false (即，Windchill RV&S 服务器作为标准生产服务器运行)。
mksis.adminStagingServerDisplayName=
过渡服务器的显示名称。例如，如果使用两阶段过渡服务器配置，则可将两个过渡服务器命名为 Development Server 和 Test Server。如果未指定值，则显示名称为 Staging Server。
mksis.startup.si=
启动配置管理功能集。有效设置为 true 或 false。默认值为 true。
mksis.startup.im=
启动工作流和文档功能集。有效设置为 true 或 false。默认值为 true。
mksis.licensePath=
FlexNet 许可证文件的绝对路径。
mksis.reduceLicenseSocketUsage=
确定 Windchill RV&S 服务器 是否仅使用一个套接字来连接到许可证服务器。有效设置为 true 或 false。
* 
当特性为 true 时，不能使用许可证组合或重复许可证检出功能。
默认值为 false。
mksis.imLicenseGroup=
用于抓取工作流和文档席位许可证的组名。
默认值为 IntegrityManagerGroup。
* 
席位许可所需的特性。
mksis.siLicenseGroup=
用于抓取配置管理席位许可证的组名。
默认值为 SourceIntegrityGroup。
* 
席位许可所需的特性。
mksis.customerInfo.customerNumber=
由 PTC 分配的客户编号，例如 341。此信息显示在 Web UI 中的 Windchill RV&S 登陆页面上。
在产品安装过程中，默认值通过 license.dat 文件填充。
如果在产品安装过程中未找到值，则默认值为空白。
mksis.customerInfo.installSiteNumber=
由 PTC 分配的安装站点编号，例如 201824。此信息显示在 Web UI 中的 Windchill RV&S 登陆页面上。
在产品安装过程中，默认值通过 license.dat 文件填充。
如果在产品安装过程中未找到值，则默认值为空白。
mksis.customerInfo.contractNumbers=
PTC 分配的合同编号，例如 5A10201,2A154191,7A324030。此信息显示在 Web UI 中的 Windchill RV&S 登陆页面上。
多个值以逗号分隔。
在产品安装过程中，默认值通过 license.dat 文件填充。
如果在产品安装过程中未找到值，则默认值为空白。
mksis.apiSession.defaultUser=
mksis.apiSession.defaultPassword=
指定在服务器端进行任何 API 使用时可用的默认会话凭据，例如，在触发器内的本地 API 会话中使用。
mksis.default.compressionEnabled=false
覆盖未定义更具体覆盖的连接的压缩默认值 (请参阅特性 mksis.<alias>.compressionEnabled 或 mksis.<hostname>.<port>.compressionEnabled)。
Windchill RV&S 可以压缩数据以通过网络进行传输。建议在低带宽网络上使用压缩。不建议用于高带宽网络，因为压缩和解压缩数据所需的时间可能会超过带宽所节省的时间。
假设代理和服务器通常通过低带宽网络进行连接，系统默认对 FSA 代理及其相应服务器之间的连接启用压缩。假设其他所有连接均使用高带宽网络，系统会对这些连接禁用压缩。如果默认值不适合您的环境，则覆盖默认值。
mksis.<alias>.compressionEnabled=
mksis.<hostname>.<port>.compressionEnabled=
覆盖与特定服务器的连接的压缩默认值。可使用来自 mksis.proxylist 特性的代理别名或使用主机名和端口来指定服务器，例如：
mksis.FieldOffice.compressionEnabled=false
mksis.1.2.43.65:7001.compressionEnabled=true
mksis.proxyList=
代理列表可为一个或多个远程服务器启用代理。可使用别名或 serverhostname:port 格式定义代理。如果设置了该特性，则 mksis.proxyList 会告知服务器它是代理，并且需要来自 FlexNet 服务器的代理许可证。如果未获得 FSA 许可，请勿设置此特性。
* 
每个真实服务器仅定义一个别名。建议使用不太可能更改的别名，而不是主机名，因为使用别名能够以一致的方式对动态配置的主机进行寻址。
只能使用以下字符来组成别名：大写字母 (A…Z)、小写字母 (a…z)、数字 (0…9) 和连字符 (-)，例如：
mksis.proxyList=FieldOffice,ThirdPartyOffice
* 
如果在代理列表中更改了名称，则保存的代理数据会丢失。要避免数据丢失，请使用别名。
mksis.<alias>.targetServerID=<hostname:port>
如果在代理列表中使用了别名，则必须为其定义主机名和端口号。别名可以嵌套到 20 的固定深度。别名也可以解析或重定向客户端别名或服务器 ID 的使用。每个别名必须具有此形式的显式定义，例如：
mksis.FieldOffice.targetServerID=1.2.43.65:7001
* 
不要选择解析为有效特性键或前缀名称的别名或 IP 地址 (例如，不要使用 proxyCache 这样的别名)。
mksis.proxy.default.adminUser=
默认管理用户的用户名，该用户控制权限以及代理连接上的信息访问。默认管理用户必须是远程系统上的有效用户。
* 
代理管理用户所具有的 ACL 权限集应受到限制。仅允许 Login、OpenProject 和 FetchRevision 权限。权限可全局设置，也可仅针对您希望代理访问的项目进行设置。拒绝所有其他权限。
mksis.proxy.default.adminPassword=
默认管理用户的密码。
* 
对于远程系统上的管理用户，默认管理密码必须是有效密码。
mksis.proxy.<serverAlias>.adminUser=
管理用户的用户名，该用户控制权限以及对指定目标服务器别名上信息的访问。如果未指定特性，则使用默认管理用户。
mksis.proxy.<serverAlias>.adminPassword=
指定目标服务器别名的管理用户密码。
mksis.idleDisconnectTimeout=
没有任何事务处理时，Windchill RV&S 服务器 在决定 Windchill RV&S 客户端 不再处于活动状态之前所等待的分钟数。达到此时间后，使用的每个并发许可证及与服务器的连接都会被释放 (彼此之间独立)。
值为 0 表示禁用空闲断开连接。启用空闲断开连接的最小值为 60，如果值大于 0 但小于 60，则认为空闲断开连接超时时间为 60 分钟。
默认值为 0。
mksis.http.session.timeout=
HTTP 会话过期前可保持非活动状态的秒数。默认值为 3600 (1 小时)。
如果将 mksis.web.heartbeat 特性设置为 true，则即使在经过指定时间之后，Web 界面的 HTTP 会话也会保持活动状态。
mksis.web.heartbeat=
使 Web 界面在浏览器窗口仍处于活动状态时将 HTTP 会话保持为活动状态。如果为 false，则所有 HTTP 会话在 mksis.http.session.timeout 特性中指定的时间后过期。默认值为 true。
* 
禁用此特性会阻止服务器警报消息出现在 Web 界面中。
mksis.web.historySize=
每个具有活动会话的 Web 界面用户保存在历史记录列表中的视图数目。
默认值为 10。
* 
增大数目会影响服务器所需的内存量。
mksis.httpd.documentRoot=
要从中获取自定义 Web 内容的根目录。
默认值为 installdir/data/public_html。
mksis.hostname=
要在电子邮件通知和更改包中显示的主机名，而非默认域名，例如 mksis.hostname=www.domain.com。若客户端生成的电子邮件中包含 Windchill RV&S 客户端 URL 和 WEB URL 超链接，其中也会显示主机名。
如果未设置，系统会提示 Windchill RV&S 服务器 提供其所在计算机的主机名。
mksis.hostnameuseip=
如果为 true，此特性会提示 Windchill RV&S 服务器 提供 IP 地址，然后在电子邮件通知和更改包中使用 IP 地址，而非默认域名。若客户端生成的电子邮件中包含 Windchill RV&S 客户端 URL 和 WEB URL 超链接，也会受到影响。
如果通过 mksis.hostname 设置了域名，则电子邮件通知或更改包信息中无法显示 IP 地址。
默认值为 false。
java.system.property.smtpencoding=
发送电子邮件时使用的字符集。
默认值为 UTF-8。
mksis.repository.backuptime=
使 Windchill RV&S 服务器 使用服务器计算机上的系统时钟每隔 24 小时自动备份嵌入的 Derby 数据库。最近备份的数据库文件存储于 installdir/data/derby.db/backup。正常文件系统备份期间，如果数据库正在使用中，Derby 没有专门的备份过程，因而由此需求。
默认情况下，此特性会使备份操作在每日午夜 (00:00) 进行。您可以更改设置时间的值；格式为 HH:MM，其中 HH 是 0-23 的小时值，MM 是 0-59 的分钟值。例如，如果常规数据库备份在 23:00 运行，则可以将自动备份时间设置为 22:30。默认情况下为 mksis.repository.backuptime=00:00。
java.security.property.networkaddress.cache.ttl=
缓存成功的 DNS 名称查找的秒数。
默认值为 60。
java.security.property.networkaddress.cache.negative.ttl=
缓存未成功的 DNS 名称查找的秒数。
默认值为 60。
mksis.monitorInterval=
配置 stacktrace 监视器轮询 runstacktrace 文件的秒数，此文件位于 <Windchill RV&S Server>/data/runstacktrace。
默认值为 30。
mksis.auditor.si=
配置 Windchill RV&S 服务器 上配置管理操作的审计。
默认值为 false。
mksis.auditor.im=
配置 Windchill RV&S 服务器 上工作流和文档操作的审计。
默认值为 false。
mksis.auditor.is=
配置 Windchill RV&S 服务器 操作的审计。
* 
此特性必须设置为 true 才能将清除或存档操作记录在审核日志中。
默认值为 false。
mksis.auditor.sd=
配置 Deploy 操作的审计。
默认值为 false。
* 
在 Integrity 10.8 及更高版本中，不再支持分段和部署功能特性。
mksis.auditlogbackupdir=
审核日志备份目录的路径。对于目标目录必须具有写入权限。您可以将默认值重新定义为自己选择的目录。
默认值为 installdir/data/audit，其中 installdir 是您在其中安装 Windchill RV&S 服务器 的目录路径。
mks.dynamicPool.config=
配置连接到动态池的数据库。(仅当与数据库的连接因网络或数据库问题断开时才可进行修改。)发生连接问题时无需等待 refreshTestMinutes 中指定的时间段，可以添加以下特性：
testConnsOnReserve=true
testConnsOnRelease=true
mks.datasource.waitSeconds
Windchill RV&S 服务器 等待重新尝试连接到数据库的秒数。
默认值为 120 秒，最小值为 20 秒。
mks.dbUser=
连接池的数据库用户的名称。默认值在安装期间根据选定的数据库和特性进行配置。
mks.dbPassword=
数据库连接池的密码。默认值根据选定的数据库进行配置。
mksis.clear.port=
明文端口号。要禁用明文端口，将策略设置为 0。(您可以在注释中保留旧端口号。)
端口号不得超过 65535。如果端口号小于 1024，则在 Linux 计算机上可能需要额外权限。
如果指定已经在服务器计算机上使用的端口号，Windchill RV&S 服务器 会在您尝试运行时关闭。
默认值为 7001。
mksis.helpSystemRedirectURL
此特性适用于连接到当前服务器的 Windchill RV&S 12.3.0.0 客户端或更高版本的客户端。
Windchill RV&S URL 的前缀，用户会被重定向到未安装在默认服务器上的 Windchill RV&S 帮助，例如 http://server:port 或 https://server:port。
默认值为空白 (用户不会被重定向到不同的服务器)。
* 
此特性值必须以 http:// 或 https:// 开头。
mksis.oldhelpSystemRedirectURL
此特性适用于连接到当前服务器的 Windchill RV&S 12.3.0.0 之前的客户端版本。
Integrity Lifecycle Manager URL 的前缀，用户会被重定向到未安装在默认服务器上的 Integrity Lifecycle Manager 帮助，例如 http://server:port 或 https://server:port。
默认值为空白 (用户不会被重定向到不同的服务器)。
* 
此特性值必须以 http:// 或 https:// 开头。
ldap.read.timeout
在从 LDAP 获取数据之前，Windchill RV&S 等待的秒数。默认值为 60。
mksis.throttle.list=<alias1>,<alias2>,...
限制列表可对传出到一个或多个远程客户端和服务器的流量启用限制。
可以通过使用别名来定义限制，而组成别名时，只能使用以下字符：大写字母 (A…Z)、小写字母 (a…z)、数字 (0…9) 和连字符 (-)。使用以逗号分隔的列表指定限制别名。
对于每个限制别名，必须配置 iprange、max 或 lowPriorityMax，也可以选择配置 maxRTT (最大往返时间)。
例如：mksis.throttle.list=fsa1, directRemoteUsers, localTeam
* 
每个 IP 地址范围仅可定义一个别名。
mksis.throttle.<alias>.IPrange=
指示远程主机的 IP 地址范围。
例如：
• mksis.throttle.fsa1.iprange=10.1.0.123.
表示对指定的 IP 范围 (10.1.0.123) 进行限制。
• mksis.throttle.directRemoteUsers.iprange=10.2.0.*
表示对指定的 IP 范围进行限制，本例中的 IP 范围为 10.0.2.1、10.0.2.2，依次类推。
mksis.throttle.<alias>.max=
表示每秒可连续发送的数据的最大限制，其中，值以每秒字节数为单位，通过外部传输显示。
例如：
mksis.throttle.fsa1.max=12000000
表示批量数据传输最大为 12MBps。
* 
在计划限制时，确保考虑了两个方向上的流量。
mksis.throttle.<alias>.lowPriorityMax=
表示对于低优先级操作 (例如批量数据文件传输) 可发送的最大数据量，其中值以每秒字节数显示。
例如：
mksis.throttle.fsa1.lowPriorityMax=10000000
表示批量数据传输最大为 10MBps。
* 
如果未指定 lowPriorityMax 值，则该值将被设置为最大值的 80%。
PTC 建议在对低优先级操作传输数据时遵循以下最佳做法：
• 检查服务器计算机可用的网络带宽量。
• 按照与服务器关联的网络带宽来限制数据量。
• 请确保为低优先级操作分配的带宽不超过最大带宽的 80%，并且剩余带宽为非低优先级操作保留。
• 在带宽分配期间，请考虑 mksis.throttle.list 参数中定义的所有别名，因为 mksis.throttle <alias> max 参数会应用于各个列表。
* 
Windchill RV&S 会尝试与限制参数中设置的值进行匹配。
mksis.throttle.<alias>.MaxRTT=
指示网络的最大往返时间。
如果启动时在日志中显示的 maxRTT 低于指定别名 IP 范围的实际最大 RTT，则可以定义可选特性。
较大的 maxRTT 会对内存使用产生影响，因为分配了更多内存以达到网络吞吐量。
mksis.http.protocol.upgrade
指定是否必须使用 HTTP/2 协议。有效设置为 true 或 false。如果设置为 true，则仅当在安全模式下设置 Windchill RV&S 环境时，才会使用 HTTP/2。HTTP/2 支持仅适用于基于浏览器的客户端。默认值为 false。
mksis.rmi.transport
指定是否必须使用 HTTP/2 协议。有效设置为 http。如果设置为 http，则仅当在安全模式下设置 Windchill RV&S 环境时，才会对 Swing 和 CLI 客户端使用 HTTP/2。
有关详细信息，请参阅配置 HTTP2 协议。
mksis.rmi.connectiontimeout
指定 RMI 线程从代理 FSA 服务器应用程序到主 Windchill RV&S 服务器的超时持续时间 (秒)。
在带宽低或高延迟的网络环境中，Windchill RV&S FSA 服务器应用程序中的 RMI 线程在连接主服务器时可能会被阻塞较长时间。根据网络带宽或延迟，您可以调整此特性的值。
值设置为 0 将禁用超时，应用程序线程将无限期等待，直到与服务器连接成功。
这对您有帮助吗?