Firebird Database Server 1.5.4
==============================

Questo documento contiene istruzioni per
l'installazione di Firebird 1.5 su piattaforma
Win32. Questa documentazione si riferisce dunque al
solo processo di installazione, e non a Firebird 1.5
in generale.


Indice
------

o Prima di installare
o Installazione su sistemi contenenti Firebird 2.0
o Nuove caratteristiche del programma di installazione
o Funzionalit di installazione obsolete
o Disinstallazione
o Altre informazioni
o Installazione batch da un file di comandi


Prima di installare
-------------------

Si raccomanda di DISINSTALLARE qualunque versione
preesistente di Firebird 1.0, 1.5, 2.0 o InterBase
prima di installare questa versione.


Installazione su sistemi contenenti Firebird 2.0
------------------------------------------------

Il programma di installazione di Firebird 1.5.4
 in grado di rilevare automaticamente se un server
Firebird 2 risulta installato. In questo caso, il
programma vi avvertir e vi dar la possibilit di
annullare l'installazione. Se si prosegue, il programma
rilever un'istanza di Firebird Super Server in
esecuzione e si interromper. Tenete presente, tuttavia,
che il programma non  in grado di rilevare un'istanza
di Firebird Classic, e in quel caso proseguir. Per
questo motivo,  bene verificare quale tipo di server
si sta usando qualora il programma di installazione
ne rilevi uno.


Nuove caratteristiche del programma di installazione 1.5.4
----------------------------------------------------------

o In caso esista gi un file firebird.conf, il
  programma di installazione non lo sovrascriver ma
  creer un nuovo file chiamato:

  firebird.conf.default.

  Il file firebird.conf esistente non verr
  modificato. Questo al fine di garantire il
  mantenimento di eventuali restrizioni di accesso
  dopo un aggiornamento.

o Il programma di installazione  ora disponibile
  anche in Bosniaco, Spagnolo, Italiano, Polacco
  e Russo.
  
  Nota 1 - I nomi delle lingue disponibili sono
  elencati in ordine alfabetico, ciascuno espresso
  nella lingua stessa.
  
  Nota 2 - Non tutti i caratteri saranno sempre visibili.
  Tipicamente, le lingue est-europee non saranno
  utilizzabili da utenti dell'europa occidentale.


Nuove caratteristiche del programma di installazione 1.5.3
----------------------------------------------------------

Il programma di installazione (e SOLO il programma
di installazione, non Firebird, al momento) pu
essere eseguito in diverse lingue supplementari, tra
cui l'italiano.


Nuove caratteristiche del programma di installazione 1.5
--------------------------------------------------------

o Questo programma di installazione combina Firebird
  Classic e Firebird Super Server, e consente di scegliere
  quale dei due installare (ma non entrambi allo stesso
  tempo). Per passare da una tipologia all'altra 
  necessario disinstallare e reinstallare.
  
o Le regole per l'installazione della libreria client sono
  notevolmente cambiate. Le nnovit sono dettagliate nel
  file doc/README.Win32LibraryInstallation.txt.
  
  Per via di queste modifiche, il programma di installazione
  effettua un controllo sull'esistenza di una versione
  precedente di Firebird o InterBase.
  
  - Se c' gi installato Firebird 1.5, il programma
    tenter una sovrascrittura, fermandosi se il server
     in esecuzione.
    
  - Se c' un'altra versione di Firebird o InterBase, il
    programma vi avvertir. Se decidete di proseguire,
    Firebird verr installato e le sue chiavi di registro
    configurate, ma non ne verr impostato l'avvio
    automatico come servizio n come applicazione. Questo
    passaggio andr fatto manualmente.
    
  - Il programma di installazione accetta un nuovo
    parametro /force sulla riga di comando, che permette
    a chi ne ha un buon motivo di saltare i controlli
    descritti sopra.


Funzionalit di installazione obsolete
--------------------------------------

o Firebird 1.0 usava la chiave di registro
  HKLM\SOFTWARE\FirebirdSQL, che  ora
  obsoleta e verr eliminata dl programma di
  installazione. Se avete applicazioni che
  fanno affidamento sul contenuto di tale chiave,
  dovrete aggiungerla manualmente (anche se 
  preferibile modificare le applicazioni perch
  usino la nuova chiave).
  
o Le primissime versioni release candidate di
  Firebird 1.5 installavano la libreria client
  fbclient.dll nella cartella di sistema. Questa
  pratica  ora considerata obsoleta. Il programma
  offre un'opzione per installare la libreria client
  nella cartella di sistema, ma vi suggeriamo di
  non adottarla e invece modificare, se necessario,
  le applicazioni perch cerchino la libreria client
  nel percorso corretto.


Disinstallazione
----------------

o Si consiglia di distinstallare il prodotto nel modo
  consueto, tramite il Pannello di Controllo. In
  alternativa,  sufficiente eseguire unins000.exe
  dalla cartella di installazione.

o Se Firebird  in esecuzione come applicazione (e non
  come servizio), si raccomanda di arrestare
  manualmente il server prima di procedere con la
  disinstallazione. Questo  necessario in quanto il
  programma di disinstallazione non  in grado di
  arrestare un'applicazione in esecuzione. Se il
  server  attivo, la disinstallazione si interromper
  con un errore e sar necessario ripulire manualmente
  il sistema dai file residui.


Altre informazioni
------------------

  Firebird richiede Winsock 2. Winsock 2  presente in
  tutte le piattaforme Windows a 32 bit, eccetto
  Windows 95. Il programma di installazione verifica
  la presenza di Winsock 2 e termina con un errore in
  caso di esito negativo. In questo caso si consiglia
  di visitare questo sito:
  
    http://support.microsoft.com/default.aspx?scid=kb;EN-US;q177719

  per maggiori informazioni su come aggiornare
  Winsock.


Installazione batch da un file di comandi
-----------------------------------------

Il programma di installazione pu essere eseguito come
parte di un file di comandi. Sono accettati i seguenti
parametri:


/SP-
  Disattiva la richiesta di conferma iniziale.
  
/SILENT, /VERYSILENT
  Quando il programma di installazione lavora in modalit
  silent, mostra soltanto una finestra con il progresso
  dell'installazione. In modalit very silent, nemmeno quella.
  Tutto il resto funziona normalmente; ad esempio, eventuali
  messaggi di errore compaiono come al solito, e anche la
  richiesta iniziale (a meno che non sia stata disattivata
  tramite il parametro /SP-).
  
  Se  richiesto un riavvio del sistema, ed  stato indicato
  il parametro /NORESTART (ved. oltre), il programma di
  installazione chieder conferma se in modalit silent,
  ma effettuer il riavvio senza chiedere conferma se in
  modalit very silent.
  
/NORESTART
  Fa in modo che il programma di installazione non causi mai
  un riavvio, nemmeno se necessario.
  
/DIR="percorso"
  Serve ad indicare un percorso di installazione diverso da
  quello predefinito. Occorre indicare un percorso assoluto.
  
/GROUP="nome"
  Serve ad indicare un nome di cartella diverso da quello
  predefinito per il menu Start.
  
/NOICONS
  Fa s che la voce "Non creare una cartella nel menu
  Avvio/Start" sia inizialmente disattivata.
  
/COMPONENTS="elenco di nomi separati da virgola"
  Per indicare i componenti da installare.
  Si pu scegliere tra:
    ServerComponent,
    ServerComponent\SuperServerComponent, 
    ServerComponent\ClassicServerComponent,
    DevAdminComponent e
    ClientComponent

  L'indicazione di questo parametro sulla riga di comando
  implica l'impostazione di una installazione di tipo
  personalizzato. Un'installazione completa richiede
  di combinare pi componenti; ad esempio:
  
  /COMPONENTS="ServerComponent, 
               ServerComponent\SuperServerComponent,  
               DevAdminComponent, ClientComponent"

  L'esempio sopra configura una installazione Super Server
  completa.
  
/FORCE
  Impone al programma di installazione di ignorare il
  risultato dei controlli su eventuali installazioni precedenti.
  Il programma tenter di installare e configurare Firebird
  1.5 come se non ci fosse alcuna versione di Firebird o
  InterBase preesistente sul computer.
  
  Questa modalit pu essere utile in caso si abbia
  un'installazione rovinata che non  possibile
  disinstallare. Oppure, pu essere un altro modo per
  rovinare installazioni perfettamente funzionanti, a
  scelta.
  
/NOCPL
  Non installa l'applet Firebird nel Pannello di Controllo.
  Questo pu essere utile in due casi:
  
  o Spesso installare l'applet richiede il successivo
    riavvio del sistema, cosa che potreste voler evitare.
    
  o Potreste voler usare un applet alternativo.

/NOGDS32
  Disattiva la possibilit di installare una copia della
  libreria client nella cartella di sistema, anche nei casi
  in cui l'analisi preventiva delle precedenti installazioni
  lo ammetta.
  
/COPYFBCLIENT
  Causa la copia della libreria fbclient.dll nella cartella di
  sistema. Questa modalit  consigliata solo nei casi in cui
  ci sia la certezza di lavorare, da questo computer, con
  una sole versione di server Firebird. Nei casi in cui sia
  possibile che le vostre applicazioni debbano accedere a versioni
  diverse di Firebird,  bene non avere la libreria client
  condivisa tra tutte. Maggiori dettagli (solo in inglese):
  
    doc/README.Win32LibraryInstallation.txt
