Firebird DocsetFirebird Database DocsFirebird 1.0 Quick Start → Testing your installation
Firebird home Firebird home Prev: Installing FirebirdHome: Firebird DocsetUp: Firebird 1.0 Quick StartNext: Other things you need

Testing your installation

Pinging the server
Checking that the Firebird server is running

If everything works as designed, the Firebird server process will be running on your server upon completion of the installation. It will start up automatically whenever you restart your server.

At this point, it is assumed that you will use the recommended TCP/IP protocol for your Firebird client/server network.

Note

For information about using NetBEUI protocol in an all-Windows environment, refer to Chapter 6, Network Configuration in the Using Firebird manual.

Warning

IPX/SPX networks are not supported by Firebird.

Pinging the server

Usually, the first thing you will want to do once installation is complete is ping the server. This just gives you a reality check to ensure that your client machine is able to see the host machine in your network. For example, if your server's IP address in the domain that is visible to your client is 192.13.14.1, go to a command shell and type the command

ping 192.13.14.1

substituting this example IP address for the IP address that your server is broadcasting.

Warning

If you get a timeout message, study the Using Firebird manual – Chapter 6: Network Configuration, and Chapter 7: Troubleshooting Connections – for further instructions.

Note that if you are connecting to the server from a local client – that is, a client running on the same machine as the server – you can ping the virtual TCP/IP loopback server:

ping localhost –or– ping 127.0.0.1

Checking that the Firebird server is running

After installation, Firebird server should be running as a service on Windows NT, 2000 or XP or on Linux.

Windows NT4, 2000 and XP

Open Control Panel -> Services (NT) or Control Panel -> Administrative Tools -> Services (2000, XP).

This illustration shows the Services applet display on Windows 2000. The appearance may vary from one Windows server edition to another.

If the Guardian is running (as shown in the screenshot, over) it may have a different service name because of version changes.

Note

On Windows 2000 and XP, the Guardian is a convenience rather than a necessity, since these two operating systems have the facility to watch and restart services. It is recommended that you keep Guardian active for other platforms if a SYSDBA is not available to restart the server manually in the event that it is stopped for some reason.

Windows 9x or ME

On Windows 9x or ME Firebird server should be running as an application, monitored by the Guardian. The Guardian's icon should appear in the tray with a green graphic. If the icon is flashing or showing as a red graphic, it indicates that Guardian is either attempting to start the server or has failed.

If you used an installation kit that installed but did not automatically start the Guardian and the Firebird server, you can set it up as follows:

  1. Locate the executable file for the Guardian program (ibguard.exe) and create a shortcut for it in the Startup area of your machine's Start Menu.

  2. Open the Properties dialog of the shortcut and go to the field where the command line is.

  3. Edit the command line so it reads as follows:

    ibguard.exe -a

  4. Save and close the Properties dialog.

  5. Double-click on the shortcut to start the Guardian. The Guardian will proceed to start ibserver.exe.

The Guardian should start up automatically next time you boot your Windows 9x or ME machine.

Alternatively, you can use a Control Panel applet to control the starting and stopping of the Firebird server.

Windows Control Panel applets

Pre-1.0 distributions of Firebird for Windows kits installed the InterBase Manager applet into the Control Panel of operating systems that support services. It was omitted from Firebird 1.0 because a number of Firebird-specific “Firebird [Server] Manager” implementations became available through open source channels. From version 1.0.3 onward, a control panel applet is again included in the distribution. Whilst the applet is not essential, it does provide a convenient way to start and stop the server.

Unfortunately, the bundled applet only works on Windows NT, 2000 and XP. On Windows 9x and ME it fires an unstoppable series of error messages. But... there's a free third-party applet that can help you out. So if you're in one of these situations:

  • You use Firebird 1.0 or 1.0.2 and don't want to upgrade to at least 1.0.3; or

  • You run Firebird under Windows 9x or ME

and you still want a handy applet like this, don't use the version that comes with your Firebird installation, but visit this webpage:

and download the “old” FirebirdSQL Service Manager fbmgr-setup.exe.

This applet looks different from the above screenshot, but offers the same functionality.

Note

The FirebirdSQL Service Manager screen says it supports 1.0 and 1.5, but that's incorrect. Only use it for 1.0 versions.

Posix servers

Use the top command in a command shell to inspect the running processes interactively. If a Firebird Superserver is running, you should see a process named ibguard. This is the Guardian process. Further, there will be one main and zero or more child processes named ibserver.

For Classic Server versions, the process name is gds_inet_server. There will be one instance of this process running for each network connection. Note that if there are no active connections, or if there are only direct local connections, you won't find gds_inet_server in the process list.

The following screen shows the output of top, restricted by grep to show only processes with names starting with the characters ib:

frodo:/inkomend/firebird # top -b -n1 | grep ib
 2587 firebird  24   0  1232 1232 1028 S  0.0  0.3   0:00.00 ibguard
 2588 firebird  15   0  4124 4120 2092 S  0.0  0.9   0:00.04 ibserver
 2589 firebird  15   0  4124 4120 2092 S  0.0  0.9   0:00.00 ibserver
 2604 firebird  15   0  4124 4120 2092 S  0.0  0.9   0:00.00 ibserver
 2605 firebird  15   0  4124 4120 2092 S  0.0  0.9   0:00.02 ibserver
 2606 firebird  15   0  4124 4120 2092 S  0.0  0.9   0:00.00 ibserver
 2607 firebird  15   0  4124 4120 2092 S  0.0  0.9   0:00.00 ibserver

If you run Classic Server, grep for gds instead.

As an alternative to top, you can use ps -ax or ps -aux and pipe the output to grep.

Prev: Installing FirebirdHome: Firebird DocsetUp: Firebird 1.0 Quick StartNext: Other things you need
Firebird DocsetFirebird Database DocsFirebird 1.0 Quick Start → Testing your installation