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:
- the language used by the Build Forge engine
- the default language for the Build Forge agent (The agent language setting
controls the language used to produce system messages and job output.)
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.