10.10 Configuring Client Settings Mode

An administrator with the Settings page navigation rights can configure multiple clients with different settings using the Identity Manager dashboard. Administrator can decide to save these configurations using the following modes as part of application configuration:

Using File System

By default, the client settings directory is stored in the <tomcat_base_folder>/conf folder when the directory is not configured. The clients settings configuration can also be stored in a clients settings directory under the User Home folder. The administrator needs to add the com.netiq.idmdash.client.settings.directory in the ism-configuration.properties file with the appropriate value.

NOTE:You can set client settings directory as %user.home% to create the client settings directory under the User Home folder. You can also set the client setting directory as %catalina.base% to create the client setting folder under <tomcat_base_folder> folder. If you do not set the client settings directory, the directory is created under the <tomcat_base_folder>/conf folder.

Using Database

Administrator can also store the configuration in the CLIENT_SETTINGS table in the identity applications database.

By default, the client settings configuration is stored in File System mode. The administrator can specify the mode of saving the configuration in the ism-configuration.properties file. Add the com.netiq.idmdash.client.settings.store.preference with an appropriate value in the ism-configuration.properties file. If you want to change the mode to database, set the property value to database. To return to the default mode, either set the property value to file or remove the property com.netiq.idmdash.client.settings.store.preference=database from the ism-configuration.properties file.


  • Always select the database mode for saving the client settings configuration on each node of the cluster environment for each node to share the settings.

  • To copy the client settings from File System to Database mode or vice versa, use the MigrationSettings migration utility as instructed in Copying the Client Settings.

  • If you modify the client settings mode, you must also set the com.netiq.idm.rbpm.updateConfig-On-StartUp property to true in the ism-configuration.properties file. By default, the property is set to false. Setting this property to true ensures that the application configurations are correctly refreshed and updated in the database after Tomcat is restarted.