I N S T A L L A T I O N N O T E S

But you should be aware that you cannot access the same database from multiple embedded servers simultaneously, because they have SuperServer architecture and hence exclusively lock attached databases.

File structure for the Embedded Server

Just copy fbembed.dll into the directory where your application resides. Then rename it to either fbclient.dll or gds32.dll, depending on your database connectivity software. Make copies having both names if you will need to use the server tools (isql, gbak, etc.)

You should also copy firebird.msg, firebird.conf (if necessary) and ib_util.dll to the same directory.

If external libraries, are required for your application, e.g. INTL support (fbintl.dll) or UDF libraries, they should be located apart from the application directory. To be able to use them, place them into a directory tree which emulates the Firebird server one, i.e., in subdirectories named /intl and /udf directly beneath the directory where the Firebird root files are.

Important

Don't overlook the need to have the Microsoft® Visual C and Visual C++ runtimes (msvcrt.dll and msvcpp60.dll, respectively) present in the system directory.

Example

D:\my_app\app.exe

D:\my_app\gds32.dll (renamed fbembed.dll)

D:\my_app\fbclient.dll (renamed fbembed.dll)

D:\my_app\firebird.conf

D:\my_app\aliases.conf

D:\my_app\isql.exe

D:\my_app\ib_util.dll

D:\my_app\gbak.exe

D:\my_app\firebird.msg

D:\my_app\intl\fbintl.dll

D:\my_app\udf\fbudf.dll

Then, start your application. It will use the embedded server as a client library and will be able to access local databases.

Note

Provided you set up the directory structure according to these rules, it will not be necessary to configure the RootDirectory explicitly in firebird.conf. However, if you decide to deploy the embedded server and your application in some different directory structure, be sure to read the document README_embedded.txt of the Embedded Server distribution first, for instructions about additional configuration.

Other Win32 Issues

Winsock2

Firebird requires WinSock2. All Win32 platforms should have this, except for Win95. A test for the Winsock2 library is made during install. If it is not found the install will fail. To find out how to go about upgrading, visit this link.

78