====== INSTALLATION OF THE FIREBIRD SERVER 2.5 ======

Since the 2.0 version, the Modus system requires the Firebird database server in version 2.5. Do wersji 1.18 system Modus pracował na serwerze Firebird w wersji 2.0. Ten rozdział zawiera wskazówki dla administratorów w zakresie aktualizacji systemu Modus do wersji 2.0 i serwera Firebird do wersji 2.5.

A significant feature of the whole procedure is the order of operations. They should be performed according to the following scheme:
<note important>For safety, copy the base files into a safe place. During this operation, it is advisable to block out the firebird service</note>
  - Ask all the users to log out from the system.
  - Make the backup of the database. 
  - De-install the Firebird server in version 2.0.
  - Install the Firebird server in version 2.5.
  - Install the Modus program in version 2.0.x.
  - reopen the database from the backup made in the 2.
  - Update the database.
  - The system is ready to work.

Below, the points 2-7 are described in detail.

<note important>The order of the whole re-installation procedure of the Firebird server and the Modus system is very important.</note>

===== COPY OF DATABASE =====
The first and most important stage of the procedure is making copy of the database on the old version of Modus and the Firebird server. **Copy has to be made before undertaking any actions related to the update.** It is linked with to change of the database file structure (so called ODS).

The copy should be performed according to the instruction from the chapter [[administrator:kopie_zapasowe|Backups]]. In the field **Description** it is worth inserting the appropriate description of the backup in order to localize it easily. 

To provide safety, it is recommended to make additional copy of the database files using the operating system. To do it, localize the catalog where you can find database files, create there a subdirectory with a name e.g. ''firebird_base_copy_2.0'', and then copy all the database files to this subdirectory. This copy serves as an additional protection in the event of emergence of any problems during re-installation of the database server.

===== DE-INSTALLATION OF THE FIREBIRD SERVER 2.0 =====
De-installation of the server can be performed in many ways. In Windows systems Windows you have to:
  * in the Start menu, in  section ''All programs'' localize the Firebird forlder 2.0, and the activate an order ''De-installation of the Firebird 2.0'';
  * or localize the folder, where the Firebird server was installed (by default it is ''C:\Program Files\Firebird\Firebird_2_0'' and run the program ''unins000.exe''.

Additionally, you should **manually delete** from the folder ''c:\WINDOWS\system32''  the client's libraries of the database server, called ''gds32.dll'' and ''fbclient.dll''. It may happen, that only one of this libraries will be installed.

===== INSTALLATION OF THE FIREBIRD SERVER 2.5 =====
Next step is an installation of the Firebird server in version 2.5. In most operating systems, installation versions can be downloaded from [[http://www.firebirdsql.org/index.php?op=files&id=engine_250| Firebird pages]]. For 32-bit**Windows systems** you can download from [[http://sourceforge.net/projects/firebird/files/firebird-win32/2.5-Release/Firebird-2.5.0.26074_1_Win32.exe/download|tutaj]]. For the 64-bit Windows versions [[http://sourceforge.net/projects/firebird/files/firebird-win64/2.5-Release/Firebird-2.5.0.26074_1_x64.exe/download|here]].

In case when, in the server, **Linux** is the operational system, there are many software packages to choose from. In order to choose the appropriate one, follow these suggestions:
  * **do not install** the firebird server by using the psckage manager (if your distribution has got the firebird server installed - uninstall it); download from the [[http://www.firebirdsql.org/index.php?op=files&id=engine_250|Firebird pages]] an appropriate package and install it manually;
  * before installation, make sure that your distribution has got a library **glibc** installed in version 2.7 or a newer one; if an update of this library will not be necessary;
  * additional hints for individual platforms yo0u can find by clicking on buttons **Installation notes for Superclassic** that are below this link;

After downloading, you have to run the installer and go through the following stages of installation.

<note>Remember that the server of the Firebird database is a **free** tool of the open-source type.</note>