PTC RV&S Agent Configuration Properties
This topic lists configuration properties that affect the operation of the PTC RV&S Agent. These properties are located in:
installdir/config/agent.properties
 |
When specifying values for directories or file paths, you must use a single forward slash.
|
For changes to this configuration properties file to take effect, the PTC RV&S Agent must be restarted.
|
PTC RV&S Agent Property
|
Description
|
|---|---|
|
mksagent.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 Agent shuts down when you try to run it. Default is 9101.
|
|
mksagent.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 the remote machine, PTC RV&S Agent shuts down when you try to run it.
If specified to value other than 0, secure port used and only port that can be open on server. Default is 0.
|
|
mksagent.privatekey.password
|
Password for recovering private key for server's certificate from certificate store. Password must match one found in certificate store. Policy used only if secure port enabled.
|
|
mksagent.smtpserver.hostname
|
Name of mail server used by event trigger environment bean method sendMail(). Default is property not enabled.
|
|
mksagent.smtpserver.port
|
Port of mail server used by event trigger environment bean method sendMail(). Default port is 25.
|
|
mksagent.triggers.environmentVariables
|
File containing runtime properties for event trigger environment beans. Default is data/triggers/env.properties.
|
|
java.system.property.smtpencoding
|
Character set used when sending e-mail. Default is UTF-8.
|
|
java.security.property.networkaddress.cache.ttl
|
Number of seconds to cache successful connections to directory servers for failover. Default is 60.
|
|
java.security.property.networkaddress.cache.negative
|
Number of seconds to cache unsuccessful connections to directory servers for failover. Default is 60.
|
|
mksagent.apiSession.defaultHostname
mksagent.apiSession.defaultPort
mksagent.apiSession.defaultUser
mksagent.apiSession.defaultPassword
|
Properties that define the default integrations API session available from the trigger environment bean.
|
|
mksagent.rmi.connectiontimeout
|
Specifies the timeout duration in seconds for RMI thread from the agent 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 agent 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 for this property.
Setting the value to 0 disables the timeout and the application threads wait indefinitely till the connection with the server is successful.
|
|
mksagent.patch.download.attempts
|
Specifies the maximum number of attempts the agent makes to download client-side CPS or HotFix zip file from the PTC RV&S main server.
The download operation for the CPS or HotFix file on the agent may not complete if the connection between the server and the agent is interrupted before the file is downloaded completely from the server. This may result in the agent getting an incomplete or corrupt CPS or Hotfix zip file.
This setting specifies the maximum number of attempts by the agent to download the CPS or HotFix zip file, if an incomplete copy is detected on the agent. If the agent is not able to deploy the CPS or HotFix successfully even after multiple attempts, check the network stability.
Default value of the property is 10. Setting the value of the property to 0 disables the retry attempts.
|