Added win32 installation notes.

doc/install_win32.txt

@@ -0,0 +1,149 @@
+-----------------------------------------------------------
+Firebird 1.5 installation notes
+-----------------------------------------------------------
+
+1. GENERIC INFORMATION
+
+  The distribution of the version 1.5 has a number of
+  changes as compared with 1.0.
+
+1.1. Some files were renamed, namely:
+
+  ibserver.exe -> fbserver.exe (SS architecture)
+  ibguard.exe -> fbguard.exe
+  interbase.msg -> firebird.msg
+  interbase.log -> firebird.log
+  isc4.gdb -> security.fdb
+
+  Regarding the last item, it should be mentioned that
+  now the recommended extension for database files is
+  ".fdb" to avoid possible conflicts with "system restore"
+  feature of Windows ME/XP operating systems.
+
+1.2. Changes in the client library
+
+  Now the client library is named "fbclient.dll". To provide a
+  compatibility with existing applications, a gateway library
+  "gds32.dll" is included in the distribution kit. This library
+  doesn't have any code but just redirects all calls to
+  fbclient.dll. Hence for old applications you must to have both
+  fbclient.dll and gds32.dll in the program directory or OS system
+  directory. It's recommended to use native fbclient.dll library
+  in newly developed applications. All server utilities (gbak,
+  gfix, etc) uses only fbclient.dll and do not require gds32.dll.
+
+1.3. New configuration file
+
+  inconfig file is no longer used and it has been replaced with
+  firebird.conf, which is a part of new configuration manager and
+  allows you to use both old and some new options. You can see
+  the list of all supported configuration options (as well as
+  their default values) in the distributed version of this file.
+  
+
+1.4. Classic Server (CS)
+
+  Since Firebird 1.5, Classic engine is included in win32
+  distributions. The file of this server version is named
+  fb_inet_server.exe and support TCP/IP and NetBEUI network
+  protocols (local protocol is not supported). The usage of
+  the Classic engine doesn't differ from its SS variant,
+  except of the architecture specifics (one server process
+  is running per client connection).
+
+1.5. Ability to install and work with existent IB/FB1 server
+
+  There were some changes done in the system object names
+  to allow FB 1.5 to be installed and used on the computer
+  which already has IB/FB1 installed. FB 1.5 also uses
+  another registry keys. If you setup the server to use
+  different network ports, you also can run a few server
+  instances simultaneously or run FB 1.5 in the same time
+  with IB/FB1.
+
+1.6. Compatibility with previous versions
+
+  Name of the local IPC port is no longer compatible, i.e.
+  with default server settings you cannot connect to it from
+  applications using old client library (gds32.dll). If
+  necessary, you can setup the server to use old name of the
+  IPC map via the configuration file.
+
+  New version uses updated ODS (10.1). It doens't cause any
+  incompatibilities with previous versions, but you should be
+  aware of this fact. ODS upgrade is automatically performed
+  on the first connection to ODS 10.0 database. If upgrade
+  was unsuccessful (for any reason), the appropriate message
+  is written to firebird.log and ODS version kept unchanged.
+  Regardless of the above, backup/restore is still the
+  recommended procedure of migrating databases to the new
+  version of the server.
+
+  Since a number of bugs has been fixed, the behaviour of the
+  database may change after downgrading from v1.5 to v1.0.
+  The datailed information of all such issues (as well as
+  appropriate recommendations) will be published separately.
+
+  Some specifics of the server work have been changed in v1.5.
+  For more detailed information see configuration file
+  (firebird.conf) and release notes (WhatsNew.txt).
+
+2. INSTALLATION
+
+  The installation of FB 1.5 doesn't practically differ from
+  previous versions.
+
+2.1. Required steps
+
+  If you don't have a special setup program (it's distributed
+  separately) the steps are the following:
+
+  - unzip the archive into the separate directory (since a few 
+    file names were changed, it doesn't make sense to unzip
+    v1.5 files into the directory with IB/FB1)
+  - change the current directory to <root>\bin (here and below 
+    <root> is the directory where v1.5 files are located)
+  - run instreg.exe:
+      instreg.exe install <root>
+    it causes the installation path to be written into the registry
+    (HKLM\Software\Firebird\FirebirdSQL\CurrentVersion)
+  - if you want to register a service, run also instsvc.exe:
+      instsvc.exe install <root>
+  - optionally, you should copy both fbclient.dll and gds32.dll
+    to the OS system directory
+
+2.2. Installation of CS
+
+  To install the CS engine, the only difference is the additional
+  option for instsvc.exe:
+      instsvc.exe install <root> -classic
+
+  It means that you may have only one copy of the engine (either
+  fbserver.exe or fb_inet_server.exe) to be installed as a service.
+
+2.3. Simplified setup
+
+  If you don't need a registered service, then you may avoid running
+  both instreg.exe and instsvc.exe. In this case you should just unzip
+  the archive into a separate directory and run the server:
+    fbserver.exe -a
+  It should treat its parent directory as a root directory in this
+  case.
+
+2.4. Uninstallation
+
+  To remove FB 1.5 you should:
+
+  - stop the server
+  - run "instreg.exe remove"
+  - run "instsvc.exe remove"
+  - delete installation directory
+  - delete fbclient.dll and gds32.dll from the OS system directory
+
+3. INFORMATION ABOUT THIS VERSION
+
+  All changes included in FB 1.5 are briefly described in file:
+    <root>\doc\WhatsNew.txt
+  Full documentation about new features and bugfixes will be
+  published in the official Release Notes, which will be available
+  in the final release.