Moving a Firebird Database

KB035 - Moving a Firebird Database between Servers

This article provides instructions on how to install and configure Firebird on a new server and then move the existing database from the old server to the new server. It is only applicable to Volume installations that use the Firebird database software.

Recommendations

To allow for optimal performance install Firebird on a dedicated server. If the server is also used as a Domain Controller and\or Exchange, it is recommended to move the database onto a dedicated disk.

Perform a Pack on the database before moving it. Details on how to perform a Pack can be found here.

Before starting the installation, temporarily turn off UAC (User Account Control) on the server as this can interfere with certain aspects of the installation.

Under normal operations a reboot of the server should not be required throughout this procedure. However, if any errors are encountered reboot the server before trying again.

After the database move, keep Firebird disabled on the old server to prevent users accessing and updating an old database.

Prerequisites

Make sure a backup has been completed successfully before attempting to move the database. Details on how to perform a backup can be found here.

Make sure the internal firewall on the new server has port 3050 open for the Firebird service.

Please Note: Never try to backup/copy a Firebird database directly whilst the Firebird Server service is running on the server. This will corrupt the database copy and potentially the database.

Please Note: Corruption to the database may occur if the database is approximately 100GB or more in size and it is being copied to an external USB hard disk using Windows XP. Other commercial file copy applications are available that do not have this restriction. This issue is not apparent on Windows 7 or above.


Installing and configuring Volume on the new server


1.

Download the Volume installation files onto the new server and run the installer. Head here to download the Volume application installer. If required, contact support@watermarktech.co.uk for download instructions.


2.

Run the Volume installation wizard, accept the License Agreement and click 'Next'.

Moving a Firebird Database 1


3.

Keep the default Destination Location and click 'Next'.

Moving a Firebird Database 2


4.

Select “Server OCR Indexer” from the drop down and click 'Next'.

Moving a Firebird Database 3


5.

Select if Virtual Printers and Microsoft Office Add-In are required as part of the Volume installation. Also select if Volume is to be used to open TIFF files. Leave VolumeRemote and Microsoft SQL Server unticked.

Click 'Install' to complete the installation.

Moving a Firebird Database 4


6.

The installer will create a blank database WHATNOPAPER in c:\volumeFinance_database\. Navigate to this location and delete this database.

Moving a Firebird Database 5


7.

Set the Firebird install folder to have full permissions in Windows.

Moving a Firebird Database 6


Moving and configuring the database


8.

Stop Firebird from running on the NEW server by stopping the Firebird services. Open 'services.msc' and locate the 'Firebird Server - DefaultInstance' and 'Firebird Guardian - DefaultInstance' services. Right-click on each service and select 'Stop'. Once the services have stopped, disable them by double clicking on each service and change the start-up type to 'Disabled'.

Moving a Firebird Database 7


9.

Stop Firebird from running on the OLD server by stopping the Firebird services.

Stop the 'Firebird Server - DefaultInstance' and 'Firebird Guardian - DefaultInstance' services. Right-click on each service and select 'Stop'. Once the services have stopped, disable them by double clicking on each service and change the start-up type to 'Disabled'.

Please Note: Do not attempt to copy the Firebird database whilst the Firebird services are running on either server.


10.

Copy the Firebird database from the old server to the new server. The default location of the database is 'c:\volumeFinance_database\whatnopaper.fdb'. The name and location of the database on the old server may be different due to its original configuration. The default location for the copied database on the new server is 'c:\volumeFinance_database\'. However if the new server has a specific disk assigned for the database, make sure the database is copied across to the appropriate location on the assigned disk.


11.

Once the database has been moved, re-enable and start Firebird on the new server. Open 'services.msc' on the new server and locate the 'Firebird Server - DefaultInstance' and 'Firebird Guardian - DefaultInstance' services. Right-click on each service and select 'Start'.

Note: It is recommended to keep Firebird disabled on the old server to prevent users accessing and updating an old database.

Moving a Firebird Database 8


12.

Browse to the location of the copied database file on the new server, and double click on it. Check the connection parameters are correct and click 'OK'. The database location will be updated automatically in the aliases.conf configuration file and registry.

Moving a Firebird Database 9


13.

Make sure the Volume Login prompt appears and that you can successfully log into Volume from the new server itself.

Moving a Firebird Database 10


Configuring the backup job


14.

Reconfigure the backup on the new server. Browse to 'C:\Program Files(x86)\WatermarkTech\volumeFinance\' on the new server and double click on 'volumeAdmin.exe'. If the server is running in a virtual environment, tick 'Disable Direct Disk Access' to improve performance. If the server is using physical disks, leave this option unticked.

Moving a Firebird Database 11


15.

Select the 'Backup Batch Files' tab.

Moving a Firebird Database 12


16.

Make sure the volumeAdmin.exe location path is correct and also specify the location of the backup. Check the database Alias at the bottom to make sure the correct database is selected for this backup. This will only apply if the server has multiple databases.

Moving a Firebird Database 13


17.

Click 'Create Batch File' and save the batch file into the same location as the backup.

Moving a Firebird Database 14


18.

Create a Windows Scheduled Task to call the backup batch file at an appropriate time to complete before the main system backup takes place. Timings for this may need to be adjusted in the future as the database grows in size and therefore the backup takes longer.

Please Note: Test the backup procedure from the Windows Scheduled Task by right clicking on it and selecting Run.  Also check that the task will run successfully when not logged into Windows and pick a Windows account that is not likely to change in the future.

A *.nbk file will appear in the relevant backup location upon successful completion.

Please Note: To prevent corruption of the Firebird database, make sure its location is excluded from any AV software installed on the server and also that it is excluded from the main system backup. Only the *.nbk file created via the batch file should be backed up as part of the main backup.


Configuring the OCR service


The following steps are to set up Optical Character Recognition for use in the "Word Search" functionality.

19.

Reconfigure the OCR service on the new server. Open 'services.msc' and locate the 'WatermarkTechnologies_volumeServer3_Service' service.  Right-click on the service and select 'Stop'.

Moving a Firebird Database 15


20.

Locate the volumeServer Monitor icon on the desktop, right click on it and select 'Run as administrator'.

Moving a Firebird Database 16


20.

Within the volumeServer Monitor, start the service by clicking on the green icon in the bottom right hand corner.

Moving a Firebird Database 17


21.

Configure the times for when Night Time Page Processing is to run and then click 'Start'. To test that OCR is working, briefly switch Day Time Page Processing on. Remember to turn this off after testing.

Moving a Firebird Database 18


Client Connection Configuration


22. (Client connection configuration)

If the database has been moved to a new server with a different IP address/server name, each client installation of Volume will require updating in order to point to the new location of the database.

NOTE: For clarification on which of the two methods to use and what your database alias and server name are called, contact the individual or organisation that is responsible for your IT support.

This can be done by either:-

Method 1

Create a text file called 'volumeAcuutech.ini' and save it into the installation folder for Volume on the client.

E.g. c:\program files\watermarktech\volumefinance\volumeAcuutech.ini

Now launch Volume and enter the database alias (default is whatnopaper) and server name. This will populate volumeAcuutech.ini which can then be copied and used for other installations.

Moving a Firebird Database 19

Method 2

Browse across the network to the server that holds your Volume database.

Navigate to the Volume database folder and double click on the database file whatnopaper.fdb

Your new client installation will then establish a connection with the server and remember it going forward.


23.

If the new server's IP address/server name remains the same as the old server, no further configuration is required on the client machines.

hello world!
Posted in: 

Leave a comment

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Accreditations

ISO 27001 certification highlighting information security management complianceISO 9001 certification document for quality management systems
hello world!
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram