BuildForge Help

Language Settings for the Management Console and Agent

This topic describes how Build Forge configures language settings for the Management Console, agent, and engine components.

Management Console Language Settings

The language setting for the current user determines the language used to display interface controls in the Management Console.

The Management Console language setting for a user account is set as follows:

Root user
The installation program creates a root user account that the administrator uses to log in to the console the first time.
On initial log in, the language setting for the root user is based on the operating system language for the Build Forge engine host.
Language default for other users
For administrator-created user accounts, the default console language is initially set using the language preference of the Web browser that the user logs in on. (This is a configuration setting of the Web browser, not Build Forge.)
If the administrator does not change the language preference for the user (Administration >Users >Language), it is inherited from the Web browser.
LDAP-created user accounts always use the language preference configured for the Web browser.
Changing the default user language
After logging in to the console, the administrator may select a different language setting for individual Build Forge users (Administration > Users > Language).
If language preferences for users are configured in this way, the Management Console displays interface controls in the language selected for the user regardless of the language configured for the Web browser.

Agent and Build Forge Engine Language Settings

The operating system language for the Build Forge engine host dictates:

Regardless of how the language is set for the Management Console (either through the Web browser or as a Build Forge user preference), the agent logs data for system messages and job output in the operating system language of the Build Forge engine host.

To avoid mixed languages in the Management Console interface, the language selected for the Management Console must match the language used by the Build Forge engine host.

Recommended Language Setup

Build Forge recommends using the same language for the Web browser, the operating system on the Management Console host, and the Build Forge user to ensure that the language displayed in the Management Console matches the language that the agent uses to log data for system messages and job output.