wt.properties file
To use Windchill, the following properties must be set in the wt.properties file (this is usually done at installation). Note that you must use double back slashes to specify path names in the wt.properties file. This is necessary because the string is read by a Java program.
• wt.home, which specifies the top level of the class directory structure where Windchill is installed. The default value is c:\\windchill.
• wt.server.codebase, which is used by client applications. It specifies a URL from which client applications can download server resources such as property files. Server applications may use this property when writing dynamically generated HTML to be returned to a client browser. It is used to build URLs for static resources such as images or HTML files that reside under the server’s codebase directory.
• java.rmi.server.hostname, which specifies a host name used to identify the server host. It is used by the Java RMI runtime for clients to look up the IP address of the server. It can be specified as a symbolic name, such as a fully-qualified Internet domain name, or numerically in dot notation (for example, 127.0.0.1). If not specified, the RMI runtime will use the name returned by InetAddress.getLocalHost() method, which may return a name that is not known to remote clients. We recommend that this property be set to the fully-qualified Internet domain name of the server host.
You may also want to set the following properties:
• wt.access.enforce
This property enforces access control. By default. it is true. However, if you are debugging and want to bypass access control temporarily, you can set it to false.
• wt.logs.enabled
This property enables and disables logging in applications that support it, such as the Windchill Server Manager and Method Server applications. By default, it is false. To write debugging messages to a log file, you must set it to true.
• wt.method.verboseClient and wt.method.verboseServer
These properties cause trace messages to be printed from the client-side and server-side, respectively, of the method server remote interfaces. By default, it is false. Turning on these properties causes trace information to be written to logs for debugging purposes.
Similar properties are available for the server manager: wt.manager.verboseClient and wt.manager.verboseServer.
In looking through the properties, you will see many service names followed by the word “verbose” (for example, wt.access.verboseExecution and wt.access.verbosePolicy). In general, these properties allow you to turn on debug tracing.
Setting Property Visibility
Starting Windchill 13.0.0.0, you have the enhanced flexibility to control the visibility of properties. The properties are as follows:
wt.properties.allowProps -- By default, this is an empty list. The properties without any visibility constraint to the end user, are listed here. Only the properties listed here are visible to any user.
wt.properties.restricForTrustClientsOnly -- The properties that need to be restricted to the IP-based trusted clients only, are listed here. Make sure that the properties listed here are also listed in wt.properties.allowProps. By default, this is an empty list. When a property is listed under wt.properties.restricForTrustClientsOnly but not in wt.properties.allowProps, it will not be web accessible to any user including trusted IP users.
 |
Windchill provides certain configurations OOTB. For example, a script is run to enable form-based authentication. For this functionality to work, some properties are added to wt.properties.allowProps by the script.
|
Few examples of configuring these properties are given below:
• To make the property, say xyzProperty, accessible to all users:
wt.properties.allowProps=xyzProperty
wt.properties.restricForTrustClientsOnly=#should be left empty to be accessible to all users
wt.properties.restricForTrustClientsOnly=#should be left empty to be accessible to all users
• To make the property, say xyzProperty, accessible to only IP-based trusted clients:
wt.properties.allowProps=xyzProperty
wt.properties.restricForTrustClientsOnly=xyzProperty
wt.properties.restricForTrustClientsOnly=xyzProperty
• To make certain property, say xyzProperty, not accessible to any user:
wt.properties.allowProps=#should be left empty
wt.properties.restricForTrustClientsOnly=#should be left empty
wt.properties.restricForTrustClientsOnly=#should be left empty