Flush data and reload configurations

This topic describes how to refresh server data, reload a configuration, and reset watermarks. These actions ensure an effective synchronization and help improve performance.

In this topic:

Flush server data

During iterations, data is collected and cached from the connectors. By flushing the server data, you clear out the cached data that was collected from the connectors.

Data is cached to improve performance. The following data is cached:

• Property enumerations
• Property lists
• Type property lists
• Type lists
• Project lists

The Flush server cache action fetches the latest metadata from endpoint servers such as Jira and OpenText Application Quality Management. We recommend that you flush the cache periodically to ensure that metadata changes are detected on the integrated/synced systems. If the system's metadata did not change, flushing is not required.

To clear and refresh the server data:

1. Click the Actions button in the top banner.
2. Select Flush Server Cache.
3. Alternatively, stop and restart the Connect service.

Reload a configuration

This section describes how to reload a configuration. Reloading a configuration:

• Stops all running connections.
• Reloads the entire connect data structure into memory from the connect database.
• Restarts any connection that was previously running.

To reload a configuration:

1. Click the Actions button in the top banner. Select Reload Configuration.

Reset watermarks

Watermarks indicate what was already synchronized. They act as a time and place marker so that the connector can compare what was updated, added, or deleted after the previous watermark was generated.

Watermarks are updated automatically. For example, after a synchronization iteration finishes, the watermark is moved forward in time.

In certain cases, you may want to manually reset a watermark. For example, if you have been synchronizing for an extended period of time and you currently need to change some of the mappings, you can reset the watermark. Resetting the watermarks ensures that all items are synchronized.

To reset watermarks:

• For a specific connection: Click the Modify Connection button adjacent to a connection name, and select Clear Water Marks… from the menu. You are prompted to confirm the action for the current connection. To clear watermarks for active connections, use the ClearWaterMarks script batch utility.
• For a specific data source: In the main dashboard's Data Sources tab, select a data source and click the Save/Clear Water Marks toolbar button. This option is not available for all data sources.

Clear watermarks by criteria

Available from version 26.3: You can clear watermarks by criteria instead of resetting all watermarks for a connection. This lets you target selected items while leaving unrelated items unchanged.

The available criteria can include date range, project map, type map, and cross-reference state. If you use date range, specify both a start date and an end date.

To clear watermarks by criteria:

1. Open the High Watermarks tab for the connection.
2. Select one or more criteria in the filter area.
3. Click Run, and review the Filtered Count column.
4. Click Clear Water Marks.
5. In the confirmation dialog, review the impact and click Confirm.

Only items that match the selected criteria are cleared. If the criteria are invalid, or if no items match, the operation is not performed and a message is displayed.

When you confirm the operation, Connect saves the selected criteria and applies them in the next connection run. The selected item versions are cleared and synchronized again during the subsequent run.