Login to the boom Workbench

The first screen you get after starting the boom Workbench is the login dialog. To successfully start the Workbench you have to provide the following information:

Host The hostname is mandatory!
Port The Port is optional! If no port is provided, the standard port will be used.
If a port is provided, hostname and port have to be separated by a colon ":".
Example: localhost:23022, blixx26:23022
Username user name is case-insensitive
Password password is case-sensitive
Initial Account is admin/admin

Note: Multiple logins of the same user are prevented.

login screen


Extended Login

There are three special modes to start the GUI in large environments or as Recovery Console.

Maintenance Mode:
The Maintenance Mode gives the possibility to start the GUI without loading any indications. The "Source Groups" view shows the number of active/closed indication for every host/source. There is no automatic update of this view. The context menu of a selected host/source lets you perform options such as cleaning (close/archive) indications of a selected host/source e.g. in case of a message storm.

In the "Source Groups" view select a source. Right-click provides the following options:
Load Indications (Selected): Loads all indications of the selected group into the active indication view
Close Indications (Selected): Closes all indications of the selected group
Archive Closed Indications (selected): Archives all closed indications
Reload All Indications: Refreshes/updates the "Source Groups" view
Ignore Closed Indications:
This mode allows you to load only active indications (i.e. history functions like graphs won't work).

Ignore all Indications:
This mode starts the GUI without loading any indications.


Setting Default Login Parameters for the boom Client

It is possible to configure the boom Client to use specified parameters like boom server hostname, port, login name and password as default values. Just add the following parameters to the boomgui.ini configuration file which is located in the boom Client installation directory:


boomgui.ini

Parameter Description
BOOMGUI_LOGLEVEL Use loglevel 1 to 4
BOOM_HOST Default Host name is used for the very first login. After the first successful login, the Login Dialog remembers the last Host.
If no default Host is configured, ‘localhost’ is the default.
BOOM_PORT Default Port is used for the very first login. After the first successful login, the Login Dialog remembers the last Port.
If no default Port is configured, ‘23022’ is the default.
BOOM_USER User name - Predefine the user name in the Login Dialog
BOOM_PASS User password - Predefine the password in the Login Dialog.
BOOM_LOGDIR Directory for UI Logfiles.
Please note: this directory must exist before logging into the boom UI.
Default: <boom client installation directory>:<login_user>_<host>
BOOM_PROFILE_DIR Directory for the boom user profile.
Default: <boom client installation directory>:<login_user>_<host>

Example default boomgui.ini

	C:\Programme\boomgui\boomgui.ini
	-data
	@noDefault
	-BOOMGUI_LOGLEVEL
	1
	-vmargs
	-Dfile.encoding=UTF8
	-Xmx512M
	

Example customized boomgui.ini

	e.g. C:\Programme\boomgui\boomgui.ini
	-data
	@noDefault
	-BOOMGUI_LOGLEVEL
	2
	-BOOM_HOST
	Localhost
	-BOOM_PORT
	23022
	-BOOM_USER
	op1
	-BOOM_PASS
	op1
	-BOOM_LOGDIR
	boom\log
	-BOOM_PROFILE_DIR
	boom\profile
	-vmargs
	-Dfile.encoding=UTF8
	-Xmx512M
	

Note: All boom specific parameters are case sensitive and has to be inserted before the Java specific part (that means before --vmargs) and after "@noDefault". Furthermore every parameter, name and value has to be inserted into its own line.



Login problems

General error messages:

"Connection refused: connect" Server is not available or server is not running.
"login/password invalid" Incorrect login and/or password.
"Rejected. 'user' already connected from 'IPAddress'" User is already connected from same/different system.
"Max number of clients reached." Maximum number of concurrent licensed users is reached.