Le presenti istruzioni sono semplicemente intese a facilitare le operazioni di installazione per un utente di media esperienza, facendo riferimento ad una configurazione arbitraria che dovrebbe funzionare in ogni caso. Naturalmente la relativa procedura va modificata ove tale configurazione cambi, così come è possibile che Knomos sia installato con successo anche utilizzando passi o elementi diversi.

1) Requisiti

Nella configurazione suggerita sono già dati per installati e funzionanti:
- Apache 1.3.x o 2.0.x (http://httpd.apache.org) [con supporto di PHP e mod_dav (se si vogliono gestire i documenti via web)]
- Mysql 3.x.x o 4.x.x (www.mysql.com)
- PHP 4.3.10 (www.php.net) [compilato almeno con le seguenti opzioni: --with-mysql -with-zlib]
- mod_dav (http://www.webdav.org/mod_dav/, se si vogliono gestire i documenti via web)

Ove gli stessi non lo siano, si prega prima di ogni altra operazione di fare riferimento ai rispettivi siti sopraindicati, ovvero a quanto diversamente disposibile su Internet, su come procurarseli, installarli e configurarli.

2) Installazione

* Copiare il contenuto della directory in cui si trova il presente file dopo la scompattazione (knomos/) nella directory htdocs/ di Apache, oppure in una sua sottodirectory, oppure in una directory raggiungibile dall'utente con cui gira la vostra versione di Apache (di default "nobody").

Nel seguito del presente testo tale directory viene indicato come [/path-apache/knomos]. Naturalmente, tale indicazione va letta come un riferimento alla directory prescelta come sopra.

* Creare un utente all'interno del DBMS Mysql, con il seguente comando:
# mysql -u root -p mysql
Password: [Inserire la password di root del DBMS Myslq]
> GRANT SELECT , INSERT , UPDATE , DELETE , CREATE , DROP , FILE , INDEX , ALTER , CREATE TEMPORARY TABLES ON * . * TO 'knomos_user'@'%'
IDENTIFIED BY 'knomos_password'
WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 ;


dove:
knomos_user: e' l'utente dedicato a knomos, come ad esempio: 'knomos'
knomos_password: è la passwor dell'utente., come ad esempio: 'knomos'

* Creare il database dedicato a knomos con il seguente comando:
# mysqladmin -u knomos -p create knomos_db
Password: [Inserire la password di root del DBMS Myslq]

* Creare il database dedicato allo storico di knomos con il seguente comando:
# mysqladmin -u knomos -p create knomos_db_history
Password: [Inserire la password di root del DBMS Myslq]

* Modificare con un editor il file httpd.conf di Apache, per creare un Virtual Host. Ad esempio come segue:
<VirtualHost *:80>
 ServerAdmin root
 DocumentRoot [/path-apache/knomos/]
 ServerName localhost
 ErrorLog logs/knomos-error_log
 CustomLog logs/knomos-access_log common
 DirectoryIndex login.php main.php index.php
</VirtualHost>

NB: in questo esempio l'opzione "ServerName" farà si che Knomos sia raggiungibile solamente dalla macchina locale. E' consigliabile utilizzare l'indirizzo IP della macchina su cui è installato Knomos.

* Riavviare il servizio di Apache.

* Lanciare un Web browser e collegarsi all'URL: 
		http://[url_base definito in config.php]/

* Seguire le indicazioni a video, utilizzando ove necessario i dati precedentemente inseriti quali knomos_user, knomos_password, knomos_db e knomos_db_history. Attenzione all'inserimento corretto di knomos_db e knomos_db_history: se i due database non sono stati precedentemente creati si riceverà una pagina di errore; in questo caso sarà necessario premere il pulsante di back del browser.

* Per il resto fare riferimento a quando indicato dall'interfaccia utente e dall'help e documentazione del programma che sia disponibile all'interno del programma stesso e/o sul sito http://www.knomos.org.

* Eventuali problemi o esperienze d'uso, ivi compreso per quanto riguarda l'installazione, possono essere segnalati e discussi sui forum all'indirizzo indicato dal sito suddetto.

					***
