Questo manuale e' distribuito insieme alla versione di Webschool 0.9 e puo' essere utilizzato secondo la licenza GNU free Documentation License (http://www.gnu.org/licenses/licenses.html).
Webschool 0.9 nasce dall'esperienza acquisita nell'ambito di alcuni istituti scolastici come software per la gestione di un sito istituzionale.

Autore:                         Luciano Apolito
Supporto tecnico:       Roberto Gigli
Sito internet:                 http://www.linuxap.it/
Email:                             info@linuxap.it
Anno                             2002/2003

Manuale di installazione

Windows
    - Installazione automatica con setup
    - Installazione manuale

Linux

    - Installazione da riga di comando
    - Installazione da riga di comando e dal webserver

Tutti
   - Installazione su un webserver da remoto

software necessario
- web server Apache;
- linguaggio PHP 4.x ;
- server SQL MySQL dalla 3.x;
- modulo php4_mysql per la connessione al database.
- L'opzione "register_globals" del php.ini su "On".
- il CMS PhPNuke 6.0

Windows

Installazione automatica con setup
1) Lanciare easyphp1-6_setup.exe presente nella dir download di questo sito.
Il software puo' anche essere scaricato qui: http://www.easyphp.org/  nella versione 1.6 o successiva
2) Lanciare setup.exe dopo aver scaricato da questo sito il pacchetto relativo nell'area download

il setup di webschool comprende i file e gli archivi sql sia di PhpNuke6.0 che di webschool 0.9.  La directory da scegliere per l'installazione e' la dir antecedente a quella pubblica dove volete installare ilsoftware. 
Es: c:/Programmi/EasyPhP. Il software verrà installato nella dir  c:/Programmi/EasyPHP/www

3) Avviare EasyPhp da Start-->Programmi se non avviato in fase di installazione, altrimenti cliccare sull'icona in basso a destra sulla barra di stata con una 'e' nera e avvia.
4) Aprire il PhpMyAdmin mediante il browser all'indirizzo http://localhost/mysql
5) Aggiungere un database vuoto. es. webschool
6) Cliccare su home ed aggiungere un utente con password con privilegi ampi
7) Tornare in home e riavviare il mysql
8) lanciare l'url: http://localhost/install.php e seguire le schermate di installazione
8) cancellare il file nella dir pubblica install.php e la dir install e i file sql

Installazione manuale
1) Lanciare easyphp1-6_setup.exe

2) Creare due dir temporanee sul proprio harddisk per lo scompattamento dei file di         PhPnuke 6.0 e WebSchool-0.9

md c:\phpnuke
md c:\webschool

3) dentro la dir temporanea phpnuke scompattare gli archivi PHP-Nuke-6.0.tar.gz
(usare un decompattatore per file tar, winzip 8.x supporta questi archivi)

4)portarsi dentro la dir temporanea webschool e scompattare gli archivi webschool-0.9.zip

5) copiare il contenuto della dir html e della dir sql  presente nella cartella c:/phpnuke  nella dir pubblica scelta.
es. C:/Programmi/EasyPHP/www/

6) copiare il contenuto della dir html e della dir sql presente nella cartella c:/webschool  nella dir pubblica scelta.
es. C:/Programmi/EasyPHP/www/

7) Avviare EasyPhp da Start-->Programmi se non avviato in fase di installazione, altrimenti cliccare sull'icona in basso a destra sulla barra di stata con una 'e' nera e avvia.
8) Aprire il PhpMyAdmin mediante il browser all'indirizzo http://localhost/mysql

9) Aggiungere un database vuoto. es. webschool

10) Cliccare su home ed aggiungere un utente con password con privilegi ampi

11) Tornare in home e riavviare il mysql

12) lanciare l'url: http://localhost/install.php e seguire le schermate di installazione

13) cancellare il file nella dir pubblica install.php e la dir install e i file sql

Installazione da riga di comando
(gli esempi sono riferiti ad una distribuzione Red-Hat 7...9)

1) Creare una dir nella root pubblica.
Es. mkdir /var/www/html/webschool

2) Creare due dir temporanee per lo scompattamento dei file
Es. mkdir /usr/src/phpnuke
mkdir /usr/src/webschool

3) portarsi dentro la dir temporanea /usr/src/phpnuke e scompattare gli archivi PHP-Nuke-6.0.tar.gz
Es. cd /usr/src/phpnuke
tar xvfz PHP-Nuke-6.0.tar.gz
copiare il contenuto della dir html del phpnuke6.0 dalla nella dir pubblica creata in precedenza
Es.  /bin/cp /usr/src/phpnuke/html/* /var/www/html/webschool -Rp

4) portarsi dentro la dir temporanea /usr/src/webschool e scompattare gli archivi webschool-0.9.zip
Es. cd /usr/src/webschool
unzip webschool-0.9.zip
copiare il contenuto della dir html del webschool-0.9 dalla nella dir pubblica creata in precedenza confermando la sovrascrittura dei file.
Es /bin/cp /usr/src/webschool-0.9/html/* /var/www/html/webschool -Rp

5) creare un database mysql
es. mysqladmin create NOME_DB -uNOME_UTENTE -pPASSWORD
se non avete creato un utente:

$mysql -uroot [-p]
>grant all privileges on NOME_DB.* to NOME_UTENTE@localhost identified by 'PASSWORD';
>create database NOME_DB;
>flush privileges;

6) importare gli sql di phpnuke6.0 e webschool-0.9
mysql webschool -uNOME_UTENTE -pPASSWORD </usr/src/phpnuke/sql/nuke.sql
mysql webschool -uNOME_UTENTE -pPASSWORD </usr/src/webschool/sql/webschool-0.9.sql

7) modificare le variabili del file /var/www/html/webschool/config.php
$dbhost ="localhost";
$dbuname ="NOME_UTENTE";
$dbpass ="PASSWORD";
$dbname ="NOME_DB";
$prefix ="nuke";
$user_prefix ="nuke";
$dbtype ="MySQL";

8) modificare il file /var/www/html/webschool/includes/filemanager/config.php
// Filemanager
// Configurazione delle directory
// $basedir= percorso assoluto della dir
// $webdir = percorso relativo

$basedir="/var/www/html/webschool/pagine/";
$webdir="/webschool/pagine/";

9) controllare i permessi dei file /var/www/html/webschool/config.php e
/var/www/html/webschool/includes/filemanager/config.php e metterli in sola lettura
chmod 644

10) cancellare il file /var/www/html/webschool/install.php e la dir /var/www/html/webschool/install

Installazione da riga di comando e dal webserver
(gli esempi sono riferiti ad una distribuzione Red-Hat 7...9)

1) Creare una dir nella root pubblica.
Es. mkdir /var/www/html/webschool

2) Creare due dir temporanee per lo scompattamento dei file
Es. mkdir /usr/src/phpnuke
mkdir /usr/src/webschool

3) portarsi dentro la dir temporanea /usr/src/phpnuke e scompattare gli archivi PHP-Nuke-6.0.tar.gz
Es. cd /usr/src/phpnuke
tar xvfz PHP-Nuke-6.0.tar.gz

copiare il contenuto della dir html del phpnuke6.0 dalla nella dir pubblica creata
in precedenza

Es. /bin/cp /usr/src/phpnuke/html/* /var/www/html/webschool -Rp

4) portarsi dentro la dir temporanea /usr/src/webschool e scompattare gli archivi webschool-0.9.zip
Es.cd /usr/src/webschool
unzip webschool-0.9.zip

copiare il contenuto della dir html del webschool-0.9 dalla nella dir pubblica creata
in precedenza confermando la sovrascrittura dei file.

Es. /bin/cp /usr/src/webschool-0.9/html/* /var/www/html/webschool -Rp

5) copiare gli archivi sql del phpnuke e del webschool nella dir pubblica
Es. /bin/cp /usr/src/phpnuke/sql/nuke.sql /var/www/html/webschool
/bin/cp /usr/src/webschool/sql/webschool-0.9.sql /var/www/html/webschool/webschool.sql

6) creare un database mysql
es. mysqladmin create NOME_DB -uNOME_UTENTE -pPASSWORD
se non avete creato un utente:

$mysql -uroot [-p]
>grant all privileges on NOME_DB.* to NOME_UTENTE@localhost identified by 'PASSWORD';
>create database NOME_DB;
>flush privileges;

7) andare con un browser sull'url locale

Es. http://localhost/webschool/install.php
e seguire le istruzioni delle schermate

8) controllare i permessi dei file /var/www/html/webschool/config.php e /var/www/html/webschool/includes/filemanager/config.php e metterli in sola lettura

chmod 644

9) cancellare il file /var/www/html/webschool/install.php e la dir /var/www/html/webschool/install

Installazione su un webserver da remoto
Se si dispone di uno spazio presso un provider e' possibile installare
webschool direttamente da remoto.Il server dovra' offrire i servizi php, mysql. In genere vi sara' stato assegnato un nome di un database SQL per la  gestione dei vostri dati.

1) Creare due dir temporanee sul proprio harddisk per lo scompattamento dei file
Es. linux
mkdir /usr/src/phpnuke
mkdir /usr/src/webschool

windows
md c:\phpnuke
md c:\webschool


2) portarsi dentro la dir temporanea phpnuke e scompattare gli archivi PHP-Nuke-6.0.tar.gz
Es.linux
cd /usr/src/phpnuke
tar xvfz PHP-Nuke-6.0.tar.gz

windows
(usare un decompattatore per file tar)


3) portarsi dentro la dir temporanea webschool e scompattare gli archivi webschool-0.9.zip
Es. linux
cd /usr/src/webschool
unzip webschool-0.9.zip

windows
(usare un decompattatore per file zip)

4) trasferimento in ftp o ssh dei files del phpnuke presenti nella dir phpnuke/html
5) trasferimento in ftp o ssh del file sql del phpnuke (phpnuke/sql/nuke.sql)
6) trasferimento in ftp o ssh dei files del webschool presenti nella dir webschool/html
sovrascrivendo i file esistenti

7) trasferimento in ftp o ssh del file sql del webschool (webschool/sql/webschool.sql)

8) dal browser lanciare il proprio url e il file install.php
Es.http://mio.sito.com/install.php
seguire la procedura consigliata ed adattare i permessi richiesti in alcuni files e directory.

9) controllare i permessi dei file /var/www/html/webschool/config.php e
/var/www/html/webschool/includes/filemanager/config.php e metterli in sola lettura

chmod 644

10) cancellare il file /var/www/html/webschool/install.php e la dir /var/www/html/webschool/install