Documentation Center

Configuring polling of the translation system

The <TmsPollingInterval> element in the TranslationManager.xml file specifies the frequency in seconds with which your translation system is polled by the Translation Manager Service to see whether translation items have been completed and can be transferred to the Content Manager. If there are no more items in progress, the Translation Job is canceled.

About this task

As performing translations is time-consuming and polling is performance intensive as it involves checking the state of each translation item in the Translation Job, it is recommended to check for completed translations no more regularly than once every two or so hours.

Procedure

  1. Open the TranslationManager.xml file in a text editor.
    By default, the file is located in your %TRIDION_HOME%\config directory.
  2. In the <TmsPollingInterval> section, enter a number. For example:
    <TmsPollingInterval>7200</TmsPollingInterval>

    The minimum <TmsPollingInterval> you can specify is 60.

  3. Save and close the file.

Throttling back the polling interval when there are multiple retrieving errors

If Translation Manager encounters multiple errors in succession when it attempts to retrieve files, it will throttle the polling interval back. This means the polling interval is increased. Throttling reduces the load on the translation management system and the Content Manager in case the errors are caused by the servers being overloaded.

Sending and retrieving files are throttled independently of each other. Throttling starts when four errors have occurred in succession. It continues until either a maximum of 10 times the configured polling interval or 15 minutes, whichever is smaller.

For example, if the polling interval is set to 1 minute:
  • the fourth error results in a polling interval being twice the configured value - 2 minutes
  • the fifth error results in the polling interval being three times the configured value - 3 minutes
  • and so on until it has polled 10 times the configured value, in this case 10 minutes
For example, if the polling interval is set to 5 minutes:
  • the fourth error results in a polling interval being twice the configured value - 10 minutes
  • the fifth error results in the polling interval being three times the configured value - 15 minutes, throttling stops as the maximum allowed interval of 15 minutes has been reached

If the polling interval set to 15 minutes or higher, no throttling is performed.

Once Translation Manager sends or retrieves a translation job without errors, the polling interval will be reset to the configured value.