Best Practices for Clock Configuration Updates

These best practices should be followed when applying configuration updates. The best practices ensure that clock updates are applied correctly. When the updates are correctly applied, the clocks will resume normal operations and be able to communicate with the application.

  1. A configuration update should never change this parameter in the top-level directory. This parameter should not be applied to all the clocks.
    Name Configuration Parameter Description
    Reader Name wbsynch.webservice.serverName

    The reader name of the clock as defined in the application.

  2. Only include new settings or settings that require modification. Do not supply all the parameters contained in the original configuration.

    Configuration updates are delta files except for clock.xml. Upgrading from a major release requires a line-by-line analysis of each configuration file provided for the new version to ensure your functionality and configuration is preserved. For example, there are large deltas/differences between versions 6.2.3 and 6.2.4 which could affect your configuration. There is currently no upgrade evaluation available in the installer for this clock. As a result, an upgrade requires careful consideration and an analysis of the differences in configuration between your current version and the new upgrade version.

  3. Subsequent updates must contain any previous changes that you want to retain. For example, if update.1 had a custom configuration provided in the settings.conf file, this custom configuration must be carried forward in all subsequent update directories (for example, update.2, update.3). Subsequent directories include those directories provided in both software and configuration type updates.
  4. Configuration updates can be applied with the same rules as software updates. The updates can be targeted to all clocks, specific clock types, specific clocks within a clock type or specific clocks. See Applying Clock Software Updates Overview.