mirror of
https://github.com/FirebirdSQL/firebird.git
synced 2025-01-23 19:23:03 +01:00
191 lines
5.6 KiB
Plaintext
191 lines
5.6 KiB
Plaintext
Firebird Database Server 2.0 ALPHA 1
|
|
==================================================
|
|
|
|
** IMPORTANT **
|
|
|
|
See note below regarding installation over
|
|
older versions of Firebird
|
|
|
|
** ********* **
|
|
|
|
This document is a guide to installing this package of
|
|
Firebird 2.0 Alpha 1 on the Win32 platform. These notes
|
|
refer to the installation package itself, rather than
|
|
Firebird 2.0 in general.
|
|
|
|
|
|
Contents
|
|
--------
|
|
|
|
o Before installation
|
|
o Installing on systems with older versions of Firebird
|
|
o Installing on systems with Firebird 2.0
|
|
o New features of the installer
|
|
o Deprecated features related to installation
|
|
o Uninstallation
|
|
o Other Notes
|
|
o Installation from a batch file
|
|
|
|
|
|
Before installation
|
|
-------------------
|
|
|
|
It is recommended that you UNINSTALL all previous
|
|
versions of Firebird or InterBase before installing
|
|
this package.
|
|
|
|
|
|
Installation on systems with older version of Firebird
|
|
------------------------------------------------------
|
|
|
|
The security database has been changed. The new
|
|
database is called security2.fdb and uses a
|
|
strengthened password encryption algorithm. You can
|
|
find out more info about the new security features in
|
|
doc/README.sha1.txt.
|
|
|
|
The new database structure and the changed encryption
|
|
presents several migration problems for sites that have
|
|
many user ids. The installer makes no attempt to carry
|
|
out this migration. For Alpha 1 it must be done
|
|
manually. A possible migration technique is available
|
|
in misc/upgrade/security/. A future test release will
|
|
address the issue of user migration more fully.
|
|
|
|
|
|
Installing on systems with Firebird 2.0 Alpha 1
|
|
-----------------------------------------------
|
|
|
|
The installer cannot automatically detect if a
|
|
Firebird 2.0 Alpha 1 server is running. Therefore you
|
|
will receive no warning until the installer attempts
|
|
to overwrite an active file.
|
|
|
|
|
|
New features of the installer in Firebird 2.0.0 Alpha 1
|
|
-------------------------------------------------------
|
|
|
|
There are no new installer features in Alpha 1.
|
|
|
|
|
|
New features of the installer in Firebird 1.5.2
|
|
-----------------------------------------------
|
|
|
|
Support for several languages has been added to the
|
|
installer. This support extends ONLY to the
|
|
installation process.
|
|
|
|
|
|
New features of the installer in Firebird 1.5
|
|
---------------------------------------------
|
|
|
|
o This installer now combines the super server and
|
|
classic server binaries into a single installation
|
|
package. You can choose to install one or the other,
|
|
but not both. To switch server type you need to
|
|
uninstall and re-install.
|
|
|
|
o The rules for library installation have changed
|
|
considerably. They are explained in detail in
|
|
.\docs\README.Win32LibraryInstallation.txt
|
|
which will be available to you after installation.
|
|
|
|
As a result of these new rules the installer
|
|
checks for an existing install of Firebird or
|
|
InterBase.
|
|
|
|
- If Firebird 1.5 is already installed
|
|
it will attempt to install over it. If
|
|
the server is running it will halt the install.
|
|
|
|
- If another version of Firebird or InterBase is
|
|
already installed it will warn the user. If
|
|
the user continues the installer will install
|
|
Firebird and set up registry entries but it
|
|
will not configure Firebird to run, either as
|
|
a service or as an application. This must
|
|
be done manually.
|
|
|
|
- The installer has a new commandline option
|
|
/force
|
|
which allows those with a 'devil may care'
|
|
attitude to override the above.
|
|
|
|
|
|
o If an amended firebird.conf exists in the
|
|
installation directory it is saved as:
|
|
firebird.conf.saved.n
|
|
where n is a number. The installer always installs
|
|
the default firebird.conf file. This is to guarantee
|
|
consistency to the installation process. Otherwise
|
|
the installer would have to parse the existing (and
|
|
possibly broken) configuration file.
|
|
|
|
|
|
Deprecated Features related to installation
|
|
-------------------------------------------
|
|
|
|
o Firebird 1.0 reserved a new registry key for
|
|
Firebird use. It was:
|
|
|
|
HKLM\SOFTWARE\FirebirdSQL
|
|
This is now deprecated and will be deleted by the
|
|
installer. If you have applications which rely
|
|
on this key you should add it back manually.
|
|
However, it is preferable if you rebuild your
|
|
application to read the new key.
|
|
|
|
o Earlier Firebird 1.5 release candidates installed
|
|
fbclient.dll in the <system> directory. This
|
|
practice is now deprecated. An option to install
|
|
it into the <system> directory is available at
|
|
install time. However, it is preferable if you
|
|
rebuild your applications to conform to the new
|
|
usage of fbclient.
|
|
|
|
|
|
Uninstallation
|
|
--------------
|
|
|
|
o It is preferred that this package be uninstalled
|
|
correctly using the uninstallation application
|
|
supplied. This can be called from the Control Panel.
|
|
Alternatively it can be uninstalled by running
|
|
unins000.exe directly from the installation
|
|
directory.
|
|
|
|
o If Firebird is running as an application (instead of
|
|
as a service) it is recommended that you manually
|
|
stop the server before running the uninstaller. This
|
|
is because the uninstaller cannot stop a running
|
|
application. If a server is running during the
|
|
uninstall the uninstall will complete with errors.
|
|
You will have to delete the remnants by hand.
|
|
|
|
|
|
Other Notes
|
|
-----------
|
|
|
|
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. You can visit
|
|
this link:
|
|
|
|
http://support.microsoft.com/default.aspx?scid=kb;EN-US;q177719
|
|
|
|
to find out how to go about upgrading.
|
|
|
|
|
|
Installation from a batch file
|
|
------------------------------
|
|
|
|
The setup program can be run from a batch file.
|
|
Please see this document:
|
|
|
|
installation_scripted.txt
|
|
|
|
for full details.
|
|
|
|
|