TM1 language configuration

IBM® Planning Analytics automatically configures language for the IBM TM1® Server, client user interfaces, and messages by detecting the current language of the operating system user account or web browser where they are running. You can override this automatic configuration and configure TM1 Server to use a specific language from any of the supported languages.

For details about supported languages, see TM1 language codes.

Automatic detection of language

TM1 uses the following process to automatically detect and configure language at runtime:

  1. The TM1 Server and clients that run in Microsoft Windows try to detect and use the language that is configured in the locale of the operating system for the current user. On Windows, this is configured with Regional and Language Options. The detected language will be used if it matches one of the supported languages.
    Important: By default, any TM1 Server that you start with IBM Cognos Configuration is initially configured to run as a Windows service using the Windows Local System reserved user account. If you want the TM1 Server to use the language based on a specific user account, change the service to run as that user and configure the language for the user with the Windows Regional and Language Options. For details, see Changing TM1 services to run as a specific user account on Windows.
  2. The server and client components also check for an override based on the TM1 Language configuration parameter:
    • The server checks the Language parameter in the Tm1s.cfg configuration file. If a valid language code is configured, that language is used for the server messages.
    • The client components check the Language parameter in the Tm1p.ini configuration file. If a valid language code is configured, that language is used in the user interface.
  3. If the language configured in any of the above does not match a valid supported language, English is used.

Language configuration for TM1 components

Languages are set separately for the following TM1 components.

Table 1. Summary of language configuration for TM1 components
Component Language Configuration
TM1 Server

Use the Language parameter in the Tm1s.cfg file to configure a specific language for a TM1 Server.

For details, see Configuring language for the IBM TM1 Server

TM1 Architect,

TM1 Perspectives

Use the Language parameter in the Tm1p.ini file to configure a specific language for TM1 clients that run on Microsoft Windows.

For details, see Configuring language for TM1 clients on Windows
TM1 Web

Use the language settings in your web browser to select a specific language for TM1 Web.

For details, see Configuring web browser language for TM1 Web