PTC RV&S Server Properties in is.properties
Property
Description
mksis.smtp.authentication=
Specifies the type of mail relay to be used. Set the value to true to send mails using the closed mail relay. Setting this property to false enables the application to send e-mails using the open mail relay.
mksis.smtp.ssl.enabled=
Specifies whether to enable or disable the use of TLS protocol. Set the value to true to enable TLS encryption on the SMTP server. You can use this option only when your SMTP server is configured with TLS encryption using the Signer certificate. If your SMTP server is configured with TLS encryption, then you can use the keytool.exe command to import the Signer certificates (custom root CAs or custom intermediate CAs) from the SMTP server into your trusted keystore. The keytool.exe command is located in your JRE/JDK folder.

%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

You must repeat the command for all the CAs.
mksis.logging.email.from=
Specifies the authentication user name of the sender.
mksis.logging.emailfrom.password=
Specifies the password (in plain-text) of the e-mail sender. You must run the encryption utility after you save and close the is.properties file to encrypt the password.
mksis.logging.email.server.hostname=
Specifies the name of the SMTP server.
mksis.logging.email.server.port=
Specifies the port number to be used by the SMTP mail relay.
mksis.clear.port=
Clear text port number. To disable clear port, set policy to 0. (You can retain old port number in comment.)
Port number must not exceed 65535. Numbers less than 1024 may require extra privileges on Linux machines.
If you specify port number already in use on server machine, PTC RV&S Server shuts down when you try to run it.
Default is 7001.
mksis.secure.port=
Secure (TLS or SSL) port number. To disable secure port, set policy to 0. (You can retain old port number in comment.)
Port number must not exceed 65535. Numbers less than 1024 may require extra privileges on Linux machines.
If you specify port number already in use on server machine, PTC RV&S Server shuts down when you try to run it.
If specified to a value other than 0, the secure port is used.
* 
Defining a secure port does not mean it is the only port that is open. You can have clear and secure ports open at the same time.
Default is 0.
mksis.secure.specifiedCipherSuites=
Specifies a comma separated list of encryption ciphers.
* 
If at least one of the list entries is valid, the server will start; however, the server log displays a warning message about the invalid value(s). If all of the list entries are invalid, the server will not start.
The following is an example that specifies 256-bit ciphers: mksis.secure.specifiedCipherSuites=TLS_RSA_WITH_AES_256_CBC_SHA, TLS_DHE_DSS_WITH_AES_256_CBC_SHA
* 
Upgrading the JVM to support the specified list of encryption ciphers requires downloading and installing the Java Cryptography Extension Unlimited Strength Jurisdiction Policy Files.
The package contains instructions from Oracle on how to install it into JDKs. This needs to be performed on both the client and server JVMs. The location to install the Java Cryptography Extension Ciphers for PTC RV&S client and server is:
<jdk_installdir>\lib\security
mksis.secure.specifiedTLSProtocols=
Comma-separated list of supported TLS protocol versions. Valid values are TLSv1.2 and TLSv1.3.
Defaults to TLSv1.2 and TLSv1.3 if no value is specified.
The protocol versions SSLv2, SSLv3, TLSv1.1, and TLSv1.0 are not supported.
* 
Windchill RV&S 13.0.0.0 and later releases support TLSv1.3 protocol. If you are connecting older clients to a WIndchill RV&S 13.0.0.0 server configured with TLSv1.3 protocol, you must update the value of the -Dhttps.protocols Java option in the IntegrityClient.lax file to TLSv1.2,TLSv1.3. This file is located in the <clientInstallDir>\bin directory. Connections to a server configured with TLSv1.3 protocol are successful only if the value of -Dhttps.protocols option is updated appropriately.
mksis.bindAddr=
Instructs the server to bind only to the specified IP address. The address must be a valid dotted-quad value.
If setting both mksis.bindAddr and mksis.hostname, ensure that the two settings correspond.
By default, the server binds to all interfaces it finds on startup.
mksis.url.protocol=
Protocol for hyperlinks to PTC RV&S Server, such as those that appear in e-mails and event triggers. Possible values are http (clear) and https (secure). If only one port used, correct value used for port regardless of value specified in property. If both ports used, you must specify either a clear or secure protocol.
Default is http.
mksis.privatekey.password=
Password for recovering private key for server's certificate from certificate store. Password must match one found in certificate store. Property used only if secure port enabled.
mksis.rmi.maxExecutorThreads=
Maximum number of executor threads that the RMI subsystem may use. The system starts with a minimal number of threads and adds more as needed, up to the specified limit.
Default is 300.
mksis.adminStagingServer=
Specifies whether PTC RV&S Server functions as production server or staging server. Valid options are true or false. If false, PTC RV&S Server functions as standard production server. If true, PTC RV&S Server functions as staging server that you can use to test your workflow configuration and migrate it to production server.
Default is false (that is, PTC RV&S Server operates as standard production server).
mksis.adminStagingServerDisplayName=
Display name of staging server. For example, if using two-stage staging server configuration, two staging servers can be named Development Server and Test Server. If no value specified, display name is Staging Server.
mksis.startup.si=
Start configuration management feature set. Valid settings are true or false. Default is true.
mksis.startup.im=
Start workflows and documents feature set. Valid settings are true or false. Default is true.
mksis.licensePath=
Absolute path to FlexNet license file.
mksis.reduceLicenseSocketUsage=
Determines whether PTC RV&S Server uses only one socket to connect to license server. Valid settings are true or false.
* 
When property true, cannot use license pooling or duplicate license checkout features.
Default is false.
mksis.imLicenseGroup=
Group name used to capture workflow and document seat licenses.
Default is IntegrityManagerGroup.
* 
Property required for seat licensing.
mksis.siLicenseGroup=
Group name used to capture configuration management seat licenses.
Default is SourceIntegrityGroup.
* 
Property required for seat licensing.
mksis.customerInfo.customerNumber=
Customer number assigned by PTC, for example 341. This information displays on the PTC RV&S landing page in the Web UI.
Default is populated by license.dat file during product installation.
If value not found during product installation, then default value is blank.
mksis.customerInfo.installSiteNumber=
Install site number assigned by PTC, for example 201824. This information displays on the PTC RV&S landing page in the Web UI.
Default is populated by license.dat file during product installation.
If value not found during product installation, then default value is blank.
mksis.customerInfo.contractNumbers=
Contract numbers assigned by PTC, for example 5A10201,2A154191,7A324030. This information displays on the PTC RV&S landing page in the Web UI.
Multiple values are comma-delimited.
Default is populated by license.dat file during product installation.
If value not found during product installation, then default value is blank.
mksis.apiSession.defaultUser=
mksis.apiSession.defaultPassword=
Specifies default session credentials made available to any server-side use of the API, for example, in a local API session within triggers.
mksis.default.compressionEnabled=false
Overrides compression default for connections not having more specific override defined (see properties mksis.<alias>.compressionEnabled or mksis.<hostname>.<port>.compressionEnabled).
PTC RV&Scan compress data for transfer over network. Compression is recommended for use over low bandwidth networks. It is not recommended for high bandwidth networks because time required to compress and decompress data can outweigh bandwidth savings.
By default, compression enabled for connections between FSA proxies and their corresponding servers based on assumption that proxies and servers are typically connected over low bandwidth networks. By default, compression disabled for all other connections based on assumption that they are over high bandwidth networks. Override defaults if they do not suit your environment.
mksis.<alias>.compressionEnabled=
mksis.<hostname>.<port>.compressionEnabled=
Overrides compression default for connection to specific server. Server can be specified using a proxy alias from mksis.proxylist property or using host name and port, for example:
mksis.FieldOffice.compressionEnabled=false
mksis.1.2.43.65:7001.compressionEnabled=true
mksis.proxyList=
Proxy list enables proxying for one or more remote servers. Proxies defined by using alias or in format serverhostname:port. If set, mksis.proxyList tells server it is proxy and requires proxy license from FlexNet server. Do not set property if not licensed for FSA.
* 
Define only one alias per real server. Recommended practice to use alias unlikely to change rather than host name because aliases provide consistent way to address dynamically configured hosts.
Compose aliases using only uppercase letters (A…Z), lowercase letters (a…z), numbers (0…9), and hyphens (-), for example:
mksis.proxyList=FieldOffice,ThirdPartyOffice
* 
If you change name in proxy list, saved proxy data lost. To avoid loss of data, use aliases.
mksis.<alias>.targetServerID=<hostname:port>
If you used alias in proxy list, you must define host name and port number for it. Aliases may be nested to fixed depth of 20. Aliases may also resolve or redirect client alias or server ID usage. Each alias must have explicit definition in this form, for example:
mksis.FieldOffice.targetServerID=1.2.43.65:7001
* 
Do not select alias or IP address that resolves to valid property key or prefix name (for example, do not use alias such as proxyCache).
mksis.proxy.default.adminUser=
User name for default administrative user who controls permissions and access to information on proxied connection. Default administrative user must be valid user on remote system.
* 
Proxy administrative user should have restricted set of ACL permissions. Allow only Login, OpenProject, and FetchRevision permissions. Permissions may be set globally or only for projects you want proxy to access. Deny all other permissions.
mksis.proxy.default.adminPassword=
Password for default administrative user.
* 
Default administrative password must be valid password for administrative user on remote system.
mksis.proxy.<serverAlias>.adminUser=
User name for administrative user who controls permissions and access to information on specified target server alias. If property not specified, default administrative user used.
mksis.proxy.<serverAlias>.adminPassword=
Password for administrative user for specified target server alias.
mksis.idleDisconnectTimeout=
Number of minutes without any transactions that the PTC RV&S Server waits before deciding the PTC RV&S Client is no longer active. When the time expires, each concurrent license in use and connection to the server are released (independent of one another).
Value of 0 indicates idle disconnect disabled. Minimum value when idle disconnect enabled is 60; if value greater than 0 but less than 60, idle disconnect timeout assumed to be 60 minutes.
Default is 0.
mksis.http.session.timeout=
Number of seconds HTTP session can remain inactive before it expires. Default is 3600 (1 hour).
If mksis.web.heartbeat property set to true, HTTP session for the Web interface remains active even after specified time has passed.
mksis.web.heartbeat=
Causes the Web interface to keep HTTP sessions alive while browser window still active. If false, all HTTP sessions expire after time specified in mksis.http.session.timeout property. Default is true.
* 
Disabling this property prevents server alert messages from appearing in the Web interface.
mksis.web.historySize=
Number of views saved in history list for each Web interface user who has active session.
Default is 10.
* 
Increasing number affects amount of memory required by server.
mksis.httpd.documentRoot=
Root directory to get customized web content from.
Default is installdir/data/public_html.
mksis.hostname=
Host name to appear in e-mail notifications and change packages instead of default domain name, for example, mksis.hostname=www.domain.com. Host name also appears in client-generated e-mail that contains PTC RV&S client URL and Web URL hyperlinks.
If unset, system prompts PTC RV&S Server for host name of machine it resides on.
mksis.hostnameuseip=
If true, property prompts PTC RV&S Server for IP address and then uses IP address in e-mail notifications and change packages instead of default domain name. Also affects client-generated e-mail that contains PTC RV&S client URL and Web URL hyperlinks.
If domain name set through mksis.hostname, IP address cannot display in e-mail notifications or change package information.
Default is false.
java.system.property.smtpencoding=
Character set used when sending e-mail.
Default is UTF-8.
mksis.repository.backuptime=
Causes PTC RV&S Server to make backup of embedded Derby database automatically every 24 hours using system clock on server machine. Most recently backed up database files are stored in installdir/data/derby.db/backup. Requirement because Derby has no special backup procedures if database in use during normal file system backup.
By default, property causes backup operation to occur each night at midnight (00:00). You can change value that sets time; format is HH:MM, where HH is hours from 0–23, and MM is minutes from 0–59. For example, if regular database backup runs at 23:00, you could set automatic backup time to 22:30. By default mksis.repository.backuptime=00:00.
java.security.property.networkaddress.cache.ttl=
Number of seconds to cache successful DNS name lookups.
Default is 60.
java.security.property.networkaddress.cache.negative.ttl=
Number of seconds to cache unsuccessful DNS name lookups.
Default is 60.
mksis.monitorInterval=
Configures the number of seconds for the stacktrace monitor to poll for the runstacktrace file, located in <Windchill RV&S Server>/data/runstacktrace.
Default is 30.
mksis.auditor.si=
Configures auditing of configuration management operations on PTC RV&S Server.
Default is false.
mksis.auditor.im=
Configures auditing of workflow and document operations on PTC RV&S Server.
Default is false.
mksis.auditor.is=
Configures auditing of PTC RV&S Server operations.
* 
This property must be set to true for the purging or archiving operation to be recorded in the audit log.
Default is false.
mksis.auditor.sd=
Configures auditing of Deploy operations.
Default is false.
* 
In Integrity 10.8 and later, the Staging and Deploy functionality properties are no longer supported.
mksis.auditlogbackupdir=
Path to audit log backup directory. Target directory must have write permissions. You can redefine default to directory of your choice.
Default is installdir/data/audit, where installdir is path to directory where you installed PTC RV&S Server.
mks.dynamicPool.config=
Configures database connecting to dynamic pool. (To be modified only if connections to database are dropping due to network or database problems.) Rather than waiting for time period specified in refreshTestMinutes, following properties can be added in event of connection problems:
testConnsOnReserve=true
testConnsOnRelease=true
mks.datasource.waitSeconds
Number of seconds that the PTC RV&S Server waits to retry connecting to the database.
Default value is 120 seconds and the minimum value is 20 seconds.
mks.dbUser=
Name of database user for connection pool. Default value is configured during installation based on selected database and properties.
mks.dbPassword=
Password for database connection pool. Default value is configured based on selected database.
mksis.clear.port=
Clear text port number. To disable clear port, set policy to 0. (You can retain old port number in comment.)
Port number must not exceed 65535. Numbers less than 1024 may require extra privileges on Linux machines.
If you specify port number already in use on server machine, PTC RV&S Server shuts down when you try to run it.
Default is 7001.
mksis.helpSystemRedirectURL
This property is applicable to Windchill RV&S 12.3.0.0 client or later versions of clients connecting to the current server.
Prefix of the PTC RV&S URL where users are redirected for PTC RV&S help when it is not installed on the default server, for example, http://server:port or https://server:port.
Default value is blank (users are not redirected to a different server).
* 
The property value must begin with http:// or https://.
mksis.oldhelpSystemRedirectURL
This property is applicable to client versions older than Windchill RV&S 12.3.0.0 connecting to the current server.
Prefix of the Integrity Lifecycle Manager URL where users are redirected for Integrity Lifecycle Manager help when it is not installed on the default server, for example, http://server:port or https://server:port.
Default value is blank (users are not redirected to a different server).
* 
The property value must begin with http:// or https://.
ldap.read.timeout
Number of seconds PTC RV&S waits before getting data from LDAP. Default is 60.
mksis.throttle.list=<alias1>,<alias2>,...
Throttle list enables throttling for outgoing traffic to one or more remote clients and servers.
Throttling is defined by using aliases where you compose aliases using only uppercase letters (A…Z), lowercase letters (a…z), numbers (0…9), and hyphens (-). Throttling aliases are specified using a comma separated list.
For each throttle alias, you must configure the iprange, max, or lowPriorityMax , and optionally configure maxRTT (maximum round trip time).
For example, mksis.throttle.list=fsa1, directRemoteUsers, localTeam
* 
You must define only one alias per IP address range.
mksis.throttle.<alias>.IPrange=
Indicates the range of IP address of remote hosts.
For example,
mksis.throttle.fsa1.iprange=10.1.0.123.
This indicates throttling is done to the specified IP range, which is 10.1.0.123
mksis.throttle.directRemoteUsers.iprange=10.2.0.*
This indicates throttling is done to the specified IP range, which is 10.2.0.1, 10.2.0.2, and so on in this case.
* 
IP range has only one value and cannot include multiple comma-separated values.
mksis.throttle.<alias>.max=
Indicates the maximum limit of data that can continuously be sent per second. where values are in bytes per second as displayed by an external transfer.
For example,
mksis.throttle.fsa1.max=12000000
Indicates a maximum of 12MBps bulk data transfer.
* 
Ensure to take into account traffic in both directions when planning for throttling limits.
mksis.throttle.<alias>.lowPriorityMax=
Indicates the maximum amount of data that can be sent for low priority operations such as bulk data file transfers where values are displayed in bytes per second.
For example,
mksis.throttle.fsa1.lowPriorityMax=10000000
Indicates a maximum of 10MBps bulk data transfer.
* 
The lowPriorityMax value would be set to 80% of the max value if it is not specified.
PTC recommends following these best practices when transferring data for low priority operations:
Check the amount of network bandwidth available with the server machine.
Throttle the amount of data as per the network bandwidth associated with the sever.
Ensure that no more than 80% of maximum bandwidth is allocated to low priority operations and the remaining bandwidth is reserved for non-low priority operation.
During bandwidth allocation, consider all aliases defined in the mksis.throttle.list parameter as the mksis.throttle <alias> max parameters will be applied to individual lists.
* 
PTC RV&S attempts to match the values set in the throttling parameters.
mksis.throttle.<alias>.MaxRTT=
Indicates maximum round trip time of the network.
You can define the optional property if the maxRTT displayed at startup time in logs is lower than the actual maximum RTT towards the IP range for the specified alias.
A larger maxRTT has an impact on the memory usage because more memory is allocated to achieve the network throughput.
mksis.http.protocol.upgrade
Specifies whether HTTP/2 protocol must be used. Valid settings are true or false. If set to true, HTTP/2 will be used only if the PTC RV&S environment is set up in secure mode. HTTP/2 support is available only for browser-based clients. Default is false.
mksis.rmi.transport
Specifies whether HTTP/2 protocol must be used. Valid setting is http. If set to http, HTTP/2 will be used for the Swing and CLI clients, only if the PTC RV&S environment is set up in secure mode.
For more information, see Configuring HTTP2 Protocol.
mksis.rmi.connectiontimeout
Specifies the timeout duration in seconds for RMI thread from the Proxy FSA server application to the main PTC RV&S server.
In case of low bandwidth or high latency network environment, the RMI threads from the PTC RV&S FSA Server application may get blocked for longer duration while connecting to the main server. Depending on the network bandwidth or latency, you can adjust the value of this property.
Setting the value to 0 disables the timeout and the application threads wait indefinitely till the connection with the server is successful.
mksis.patch.download.attempts
Specifies the maximum number of attempts for the proxy server makes to download the client-side CPS or HotFix zip file from the main PTC RV&S server.
The client-side CPS or HotFix zip file cached on the proxy server may be incomplete or corrupt if the connection between the two servers is interrupted before the file is downloaded completely from the main server. This setting specifies the maximum number of attempts the proxy server makes for downloading the CPS or HotFix zip file, if an incomplete copy is detected on the proxy server. If the proxy server is unable to deploy the CPS or HotFix successfully even after multiple attempts, check the network stability.
Default value of the property is 10. Setting the property value to 0 disables the retry attempts.
mksis.rmi.connectionRetryCount
Specifies the maximum number of connections attempts the application makes when connecting with the PTC RV&S client, the PTC RV&S proxy server, and the PTC RV&S main server. If the connection attempts exceed the retry count, the application assumes that it is not able to connect to the PTC RV&S client, proxy server, and the main server.
* 
If value of the property is not specified or if it is set to 0, then the retry count is disabled and only a single connection attempt is made.
The retry count is ignored if the connection timeout is disabled. In this case, the IntegrityClient.rmi.connectiontimeout client property and the mksis.rmi.connectiontimeout server or proxy server property do not have any impact on the system.
Was this helpful?