Quick Start Guide - Register Server
To register a new or duplicate an existing server entry within FB TraceManager 3, click the Register/Duplicate Server button in the toolbar of section 1 in the Main Screen.
Enter the following information:
|•||Display name: This is the string shown in the list of servers.|
|•||Host name: Server name or IP address of the computer hosting the Firebird server.|
New in V3.0: Leave it blank, if you want to connect to a Firebird Embedded Server.
|•||Port: TCP port of the Firebird server. Default is 3050.|
|•||User name: Name of the Firebird user you want to use for the Service Manager attachment.|
|•||Password: The user's password. The password will be stored encrypted in the FB TraceManager 3 database to suppress misuse in case someone is connecting to the FB TraceManager 3 database directly, e.g. via third-party tools like isql, Database Workbench, FlameRobin etc.|
|•||Client-Library: Specify an optional Firebird client library to be used in context of this particular server attachment. This will be used at run-time for the per-database connection in Register Database, if it is empty there.|
New in V3.0: Point the client library to a Firebird Embedded engine library, if you want to connect to a Firebird Embedded Server
|•||Auto connect: Select this option if you want to connect to a particular server upon program start automatically.|
|•||Description: In the Description tab, you can enter a multi-line text to better describe your attachment.|
The user name and password are optional to support Firebird trusted authentication on Windows platform.
Upon clicking on Finish, FB TraceManager 3 checks if the provided attachment information points to a Firebird 2.5 (or higher) installation. If this is the case, then FB TraceManager 3 allows you to register the server right away. If you are trying to connect to a server prior Firebird 2.5, then e.g. the following confirmation dialog is shown.
If you click on Yes, then you still can register the server, although you won't be able to connect to the server, as long as you don't replace the provided Firebird server installation with Firebird 2.5 or higher. Registering a pre Firebird 2.5 server might be useful for using the Database Monitoring capabilities.
Important: Due to a regression in the Trace API in Firebird 2.5.1 (see Firebird tracker) it is not recommended to use FB TraceManager with Firebird 2.5.1! This can lead to unexpected Firebird server and/or FB TraceManager crashes. Thus, starting with FB TraceManager V2.6, we explicitly disallow Trace API attachments against a Firebird 2.5.1 server. Firebird 2.5.0 and Firebird 2.5.2 (Snapshot) don't show this particular problem.
What's next: The next QSG section Register Database will show you how to register a database for per-database monitoring.