Just a few days ago Firebird v3.0.0 was released, and since many will update Firebird soon I wanted to make a small guide on how to do that on Windows. Read http://www.firebirdsql.org/en/news/firebird-3-0-is-released/ for more information about the release.
In this step-by-step guide I’ll outline what needs to be done to upgrade an existing Firebird v2.5.x server to version v3.0.0
After the steps the result should be a Stock (default) installation of Firebird v3.0.0 64bit.
What this guide does not have
I will not outline the process for upgrading the security database from old to new. This is an important step many installations, so be sure to check the Getting Started Guide from firebirdsql for more info!
What needs to be done for clients/client applications
Clients should ideally not have to change their code, only copy the new FBCLIENT.DLL file that resides in the Firebird Server installation folder to the clients.
By default the folders where the fbclient.dll files are (on the Server):
64bit installation: C:\Program Files\Firebird\Firebird_3_0
32bit installation: C:\Program Files (x86)\Firebird\Firebird_3_0
32bit and 64bit client DLL’s
You must remember to take the correct DLL for your application. If you install a 64bit Firebird the 32bit dll’s needed are stored under the WOW64\ folder in the installation folder.
Steps to Upgrade Firebird
Step 1 – Download what you will need
Download the installation files from http://www.firebirdsql.org/en/downloads.
Choose the installer versions, as the installer will prepare your environment for your during installation.
Also make sure you read the Getting Started Guide for details & additional information.
Step 2 – Backup any old Databases
The file format (ODS version) changes, so be sure to backup your databases before you continue. Firebird 3 will not open old ODS format files.
Step 3- Shutdown/Uninstall old Firebird
In order to install the new Firebird v3 you need to shutdown and/or Uninstall the old one.
Shutdown and rename (leave installed if v3 installation fails for easy rollback):
Open services.msc and set Startup=Disabled for the Firebird Guardian (and the Firebird) process.
Go to C:\Program Files (x86)\Firebird and rename the “Firebird_2_5” folder to “Firebird_2_5-old”. This will make the new installer think there is no installation of Firebird on the server.
Run the uninstaller for Firebird v2.5
Step 4 – Install new Firebird Server
Run the installer you downloaded in step 1
After the installer has run, you should have a new Firebird server running on your machine as a Service.
Step 5 – Restore Databases
Using your preferred tools, restore the backed up databases.
Step 6 – Replace old fbclient.dll files
Copy the FBCLIENT.DLL file to all client machines, directories etc. The exact location depends on your client apps.
– Replace 32bit app fbclient.dll’s with new WOW64/fbclient.dll file
– Replace 64bit app fbclient.dll’s with new fbclient.dll file
And that’s about it! Test your applications and hopefully you can start enjoying the benefits of FBv3 immediately.