Shared Configuration Properties

Overview

Shared configuration properties are system configuration values that are used across all servers in an EnterWorks installation, such as file paths, security and settings. These properties are stored in sharedConfig.properties files and, depending on the version of EnterWorks you are running, some are stored in the EPIM database.

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, see the EnterWorks Installation Guide.

Editing Shared Configuration Properties

Any time a change is made to values in sharedConfig.properties files, the EnterWorks services need to 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 about a particular setting, 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:
   Warning: EnterWorks has multiple sharedConfig.properties files, in various folders, on various servers. These files each have some settings that are unique to that file. Do NOT copy one sharedConfig.properties file over another. When you need to update sharedConfig.properties files, edit each one.
   1. On each server running one of the following services:

      • EnableServerTomcat

      • EnableServerWildflyController

      • EnableServerWildflyWorker<n>

      search the folder:

      <drive>:\Enterworks\EnableServer

      to find all the sharedConfig.properties files.
   2. Edit each of the sharedConfig.properties files as desired.
   3. Save and close the files.
3. Restart EnterWorks services.