// $Id: $

/**
 * @file
 * README file for Hydra.
 * @ingroup hydra
 */ 
 
/**
 * This needs translation!
 */
 
1.  Introduzione
2.  Installazione e disinstallazione
2.1  Prima dell'installazione
2.2  Installazione
2.3  Dopo l'installazione
2.4  Disinstallazione


----
1.  Introduzione

Hydra è un sistema invasivo che neccessita di alcuni accorgimenti perché possa
funzionare correttamente.
Alcune cose da tenere in considerazione quando si vuole realizzare un network
Hydra:

- una volta che un'installazione Drupal diventa network Hydra non è più possibile
  tornare indietro in maniera automatica
- non è possibile convertire un sito già avviato, con una configurazione più o
  meno complessa, in un network Hydra in maniera automatica
- deve essere chiaro all'amministratore Hydra quale configurazione deve avere
  il database per la condivisione o meno delle risorse
- tutte le tabelle di un'installazione Hydra devono avere il prefisso.
  "shared_" è il prefisso di default del sito master, salvo le tabelle che,
  in generale, sono specifiche sito per sito
- il sistema ha delle limitazioni e a sua volta ne impone, per mantenere il
  più possibile solidità, scalabilità e gestibilità
- la creazione e la prima configurazione dei nuovi siti avviene tramite XMLRPC,
  per cui è vitale che il server permetta questo tipo di comunicazione
  
...


----
2.  Installazione e disinstallazione

L'installazione base di Drupal può essere fatta solo dopo aver effettuato delle
modifiche al file settings.php.
Una volta che Drupal è installato, il modulo Hydra deve essere attivato per primo.
  
----
2.1  Prima dell'installazione

Prima di procedere all'installazione di Drupal è neccessario:

- copiare il file di configurazione "settings.php.all" dalla directory "misc" del
  modulo Hydra alla directory "sites/all", rinominandolo in "settings.php"
- copiare il file di configurazione "settings.php.default" dalla directory "misc"
  del modulo Hydra alla directory "sites/default", rinominandolo in "settings.php"

Il primo file contiene le impostazioni comuni a tutti i siti del network, come
ad esempio la configurazione della connessione al database (che deve essere
modificata per rispecchiare quella corrente). Inoltre, è presente una routine
che, in maniera automatica, imposta i prefissi per le tabelle condivise da tutti
i siti.
Il secondo file è la configurazione specifica del sito master, nel quale sono
definiti i prefissi specifici di questo sito.
La configurazione stabilisce che ogni modulo che genera tabelle - installato
dal sito master - le crei con il prefisso "shared_", rendendole quindi condivise
con gli altri siti (sempre che questi non le definiscano, all'interno del proprio
"settings.php", con un proprio prefisso).
In linea di principio si definiscono "shared_" le tabelle che hanno riferimenti
espliciti a nodi, utenti e tassonomie (se sono condivisi). Le tabelle specifiche
di Hydra devono essere "shared_".
Le altre tabelle avranno il prefisso specificato nel file "settings.inc" presente
nella directory del modulo. Il nome di default è "master".

----
2.2  Installazione

Per installare Drupal e il modulo Hydra seguire le procedure standard.
Il modulo Hydra deve essere installato nella directory "sites/all/modules".
Durante l'installazione del modulo, il sito master verrà inserito automaticamente
all'interno della lista dei siti Hydra, e gli verrà riconosciuto lo status di
"master". Il nome del sito, che sarà lo stesso usato per il prefisso delle tabelle,
è specificato nel file "settings.inc" presente nella directory del modulo.
Il nome di default è "master".

----
2.3  Dopo l'installazione

Per poter creare siti, il web server deve poter scrivere all'interno della 
directory "sites". E' neccessario provvedere a che ciò sia possibile.
Come già accennato nel file README.txt, è vivamente consigliato che il primo sito
del network - dopo il master - sia il template, così da garantire il massimo grado
di pulizia dei nuovi siti.
Prima di creare il sito, verificare la correttezza dell'impostazione di copia
delle tabelle del sito template all'indirizzo "admin/hydra/settings/template".

----
2.4  Disinstallazione

Pur lasciando inalterate le tabelle specifiche dei siti creati fino a quel momento,
la disinstallazione del modulo Hydra comporta la perdita delle informazioni
relative al network (elenco dei siti, stato di condivisione di nodi e utenti, ecc.). 
