Shared Configuration Properties

Shared configuration properties are system configuration values that are used across all servers in an EnterWorks installation, such as file paths, security settings, etc.

Fresh installs of EnterWorks versions 10.2 and later automatically store some shared configuration properties values in both the EPIM database and in the sharedConfig.properties files. Values stored in the EPIM database can be edited from the EnterWorks Classic UI. EnterWorks systems prior to version 10.2 that have been upgraded to 10.2 or later may have been configured with this capability.

  • If this capability is not configured, EnterWorks will continue to use the shared configuration property settings in the sharedConfig.properties files.

  • If this capability has been configured, EnterWorks will use the shared configuration property settings in both the EPIM database and the sharedConfig.properties files. The settings in both places must be identical.

To determine if EnterWorks has been configured to use the shared configuration values in the EPIM database:

  1. In the Classic UI, open the Feature bar, open the System folder, and select Shared Configuration. The Shared Configuration List will appear.

  2. Search for the setting: epim.external.date.format. If it appears in the list, the capability has already been configured.

For instructions on configuring this capability, please see the EnterWorks Installation Guide.

WARNING: If this capability has been configured, some EnterWorks functions will use values from the EPIM database, while others will use the values in the sharedConfig.properties files. Each time a value is changed, you will have to ensure that the values in the sharedConfig.properties files and the EPIM database are identical.

Editing Shared Configuration Properties

Any time a change is made to shared configuration properties, the EnterWorks services must be restarted.

To modify the shared configuration properties:

  1. If EnterWorks has been configured to use the shared configuration properties in the EPIM database, modify the Shared Configuration List:

    1. Log into EnterWorks Classic as a user with Administrative privileges.

    2. In the Feature bar, open the System tab and select Shared Configuration. The Shared Configuration List will appear.

    3. Search for the desired setting. Descriptions of properties are provided in the Description column. For more information on a particular setting, please contact your EnterWorks account representative.

      Tip: If a field value is too long to be seen comfortably, double-click it and the property will be opened in the editor where the value can be seen in its entirety.

    4. Not all shared configuration properties are included in the EPIM database. Those that are not included in the EPIM database do not appear in the Shared Configuration List. Skip these settings for now. You will be updating them in the sharedConfiguration.properties files in a later step in this procedure.

      If the setting is in the list:

      1. Double-click the setting. A Shared Configuration Editor will appear.

      2. Set the Value as desired, then click the Save button.

    5. When you are finished editing the configuration values, click the Close button.

  2. Edit the sharedConfig.properties files.

    1. Search all servers that are running one of the following services to find all the sharedConfig.properties files:

      • EnableServerTomcat

      • EnableServerWildflyController

      • EnableServerWildflyWorker<n>

    2. Edit each of the sharedConfig.properties files as desired.

    3. Save and close the files.

  3. Clear the data cache and restart EnterWorks services.