IBM Support

TM1 10.2.2. FP7 - Managing TM1 server shutdown due to network delays that cause transaction log update failures

Product Documentation


Abstract

As of TM1 10.2.2 Fix Pack 7 (FP7), you can prevent automatic TM1 server shutdowns when network issues block access to transaction logs. This feature is enabled through the use of three new tm1s.cfg parameters.

Content

Planning Analytics users can manage server shutdown behavior when the system encounters network delays during transaction log updates. Previously, when a network failure occurred, TM1 would automatically self-terminate. The new FileRetry.FileSpec, FileRetry.Count, and FileRetry.Delay tm1s.cfg parameters allow users to prevent the automatic server shutdown. Enabling this feature defers the shutdown, while the server attempts to reestablish access to the transaction logs.

FileRetry.FileSpec

  • Specifies the directory path(s) of the affected log files.
  • String value
  • Default value is <empty>

FileRetry.Count
  • Specifies the number of retry attempts.
  • Integer value
  • Default value: 5

FileRetry.Delay
  • Specifies the delay (in milliseconds) between retry attempts.
  • Integer value
  • Default value: 2000

All three parameters are "dynamic" and are refreshed in the background. To enable the feature, specify the directory path of the affected files in the FileRetry.FileSpec parameter. Use a semi-colon delimiter to specify multiple paths.

Examples:
  1. FileRetry.FileSpec=c:\production\model
    All files in the "c:\production\model" directory and below have the retry logic applied on a write failure.
  2. FileRetry.FileSpec=c:\production\model\Logs
    All files in the "c:\production\model\Logs" directory and below have the retry logic applied on a write failure.
  3. FileRetry.FileSpec=c:\production\model\Logs;\\network.ibm.com\production\Logs
    All files in the "c:\production\model\Logs" directory and the network share of \\network.ibm.com\production\Logs and below have the retry logic applied on a write failure.

Note: Messages are written to the server log at the WARN level when this logic is enabled.
  • "Error writing to <FILENAME>, retry in progress." is written when a write operation failed and a retry attempt is in-progress.
  • "Error writing to <FILENAME>, retry attempt failed." is written when the retry attempt failed.

[{"Product":{"code":"SS9RXT","label":"Cognos TM1"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"TM1 Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"10.2.2","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
17 June 2018

UID

swg27049567