Using the customer_overrides.properties file

You can create a customized properties file to override default property settings in the property files.

The customer_overrides.properties file is not changed during installation of upgrades or patches. To prevent having your customized settings overwritten, use overrides whenever possible rather than editing the property files.

If you changed property files in a previous version, either directly or by editing the associated .in files, your changes might be overwritten when a patch is applied. To prevent overwriting, create a customer_overrides.properties file.

For example, to set the value of the bp_response_timeout property in the http.properties file so that it is not affected by the bp_response_timeout property in the http.properties.in file when the setupfiles script is run, add the following line to the customer_overrides.properties file:
http.bp_response_timeout=value

In this example, the following items are used:

  • http represents the http.properties file.
  • bp_response_timeout represents the bp_response_timeout property.
  • value is the value that you want to prevent the setupfiles script from changing.

You do not need to run the setupfiles script after you change the customer_overrides.properties file. However, you do need to stop and restart Sterling B2B Integrator for the changes to take effect.

No audit trail is provided for changes that are made to the customer_overrides.properties file.

Attention: The following cdinterop files can be modified without stopping Sterling B2B Integrator because the changes take effect immediately. Therefore, you cannot use customer_overrides.properties to preserve them. Instead, save the file with a different name to create a backup:
  • cdinterop-spoe-auth.properties
  • cdinterop-spoe-policy.properties
  • cdinterop-proxy-records.properties
  • cdinterop-user-records.properties
  • cdinterop-xlate.properties
  • cdinterop-bp-timeouts.properties
  • cdinterop-log.properties
  • cdinterop-copy-defaults.properties
Note: After an iFix or a Fix Pack upgrade, the property files in the user exitdirectory may be overridden. In this case, you must retain the custom files and compare with the new files; then restore or create new custom files based on the modified files and new files.

Before You Begin

For each property that you want to override, you must have the following information:
PROPERTY_FILE_NAME_PREFIX
The name that is used in the servers.properties file to reference the actual property file.
PROPERTY_NAME
The name of the property in the specified property file.
PROPERTY_VALUE
The value that you want to assign to the property.