The plugin_customization.ini file sets the default value of the preferences used on the client system.
The plugin_customization.ini is a Java
™ properties file that contains preference settings. Each preference is identified by a node name and a key. Some preferences can define nodes between the root node and the key.
The format of each line is the following:
root nodename/ [optional intermediate node/] preference name=preference value
To add a new default preference, add a new line to the file specifying the node names, preference name, and value.
For example, to set an update policy file, first identify the node associated with the preference (org.eclipse.update.core
), the preference name (updatePolicyURL
), and the desired value (http://w3.myserver.com/policy.xml
Then add the line org.eclipse.update.core/updatePolicyURL=http://w3.myserver.com/policy.xml
As a Java
properties file, content is expected in ISO-8859-1 encoding. Any characters not in the ISO-8859-1 encoding are specified using Unicode escape syntax. Refer to the Javadoc for the java.util.Properties
class for more information.
The plugin_customization.ini file resides in the install dir
/rcp directory. The default settings in the file are as follows:
Properties include the following.
The ssoEnabled and ssoAllowed values can be set only before the platform is run. After the platform is run, these options can no longer be changed.
Determines whether users have the option of turning single sign-on on or off. The default value is true, indicating that single sign-on is enabled. If set to false, single sign-on is disabled. The value of this preference is relevant only if ssoAllowed is true.com.ibm.rcp.platform/portalServerAddress=address
Determines whether users have the option of using single sign-on. The default value is true, indicating that users can use single sign-on. If set to false, users cannot use single sign-on. You can set this preference value during the client installation or later using a managed setting. This preference is not surfaced to users.org.eclipse.help.base/help_home=/org.eclipse.help.base/doc/rcp_help_home.html
Defines the home page that is displayed when the Help Contents are opened. It is useful if you want to replace the home page for product- or application-related content.com.ibm.rcp.security.auth/loginEnabled=value
Values are as follows:
When a single sign-on login is detected, the client displays a "Failed to log in" message and forces the user to exit the platform. This value is the default value. Delete
Note: In restricted workbench mode, the user cannot recover the password because the desktop is locked down by Lotus® Expeditor. It is recommended that the administrator uses the Delete policy for restricted workbench users.
Deletes the keystore (without prompting the user) and creates a new one. The user might experience data loss but is not forced to exit the platform.Prompt
Prompts whether to delete the keystore and continue or exit. If the user does not delete the keystore, the user cannot access the platform.
For information about how to manage the plugin_customization.ini file, see the managing properties files topic in the following sections:
Managing using a Client Management serverManaging Rich Clients using the Portal serverManaging using another management systemParent topic: Modifying platform configuration files