Using MBeans to Modify Property Values
To change the value of a property in a property file, you can use the PropertiesManager MBean. Using this MBean allows you to change values of properties that existing in a Windchill property file.
Windchill uses standard Java properties to dynamically configure many optional or site-dependent settings. Windchill supports several property files. The primary property file, wt.properties, is located in the <Windchill>/codebase directory, where it is available for downloading into clients. It contains properties that affect both client and server Java classes.
Properties that should be available only to server-side classes are located in separate property files. For example, properties that control access to the database, including the database password, are located outside the codebase directory in the <Windchill>/db directory as db.properties.
The following are common Windchill property files:
• wt.properties
Windchill classes use wt.properties to control the runtime behavior of the Windchill system. These properties are usually read when a class is first loaded and are used to configure status settings within that class.
• db.properties
The Windchill database connection layer uses db.properties to access the database.
|
|
To add properties and corresponding values to a property file, use the xconfmanager utility. For information about the xconfmanager utility, see Using the xconfmanager Utility. |
To change a property value using JConsole, complete the following steps:
2. Select com.ptc from the tree.
3. Select the Properties MBean.
The Properties MBean expands to display all its child nodes.
4. Navigate to and select the property file you want to modify.
5. Select the Operations node.
This node displays all operations available for this configuration file in the right panel.
6. Locate the setProperty button.
To the right of this button are two fields; one for providing the property name and the other for providing the property value.
|
|
You can view the configuration file containing property names from the PropertiesManager MBean by clicking viewFile button on the Operations node. This allows you to view the read only version of the configuration file.
|
7. Enter the name of the property you want to modify, ensuring it is typed as shown in the configuration file.
8. Enter the new value for the property.
|
|
You can review pending changes by clicking reviewPendingChanges from the PropertiesManager MBean Operations node.
|
9. After entering the property name and value, click setProperty.
|
|
You can cancel any pending changes by clicking clearPendingChanges from the PropertiesManager MBean Operations node. This resets any recently modified properties back to their former values.
|
10. When you are satisfied with your changes, click applyPendingChanges from the PropertiesManager MBean Operations node to apply the changes.
Your changes are written to the site.xconf file and the affected property files are regenerated using your changes. Backup copies of XCONF files are saved in the .xconf-backup directory where Windchill is installed. Backup copies of the property files are also saved in the .xconf-backup directory. Examples of backup copy property file names are tools.000.properties, tools.001.properties, db.000.properties, wt.000.properties, and wt.001.properties. The properties with values selected to be the default are excluded from the changed property file.
|
|
The regenerated property files are used to set system properties when the system is next restarted.
|
