# FreeSBIE README

G.U.F.I (Gruppo Utenti FreeBSD Italia)

    dev@freesbie.org

2002, 2003
G.U.F.I (Gruppo Utenti FreeBSD Italia)

## Cos'è FreeSBIE?

FreeSBIE è un sistema su Live CD, capace cioè di caricarsi da un CD all'avvio del computer, senza bisogno di installazioni né di hard disk.

E' basato sul sistema operativo FreeBSD.

Il progetto ha due scopi principali:

- Sviluppare una suite di script utili a creare il proprio CD, con tutte le personalizzazioni del caso.

- Rendere disponibile un file immagine ISO pronto per la masterizzazione.

E' sviluppato dal Gruppo Utenti FreeBSD Italia. L'home page del progetto si trova a http://www.freesbie.org.

Informazioni e documentazione sul progetto sono disponibili nell'home page dello stesso. Qualora si desiderino ulteriori chiarimenti si possono trovare gli sviluppatori del programma su IRC nel canale #freesbie della rete Azzurra (server irc.azzurra.org) . È disponibile anche una mailing-list all'indirizzo freesbie@gufi.org . Ulteriori informazioni per iscriversi alla mailing list si trovano nell'home page del progetto. La lingua parlata all'interno della mailing list è l'inglese. Si può ricercare nell'archivio della mailing list all'indirizzo http://www.gufi.org/ricerca.php3?dove=ml:gufi

Sull'home page del progetto si trovano informazioni per l'accesso in lettura al repository CVS.

## Utilizzo

Per avviare la creazione della ISO è sufficiente lanciare gli script in ordine numerico ed eseguire ordinatamente i passaggi. Per la creazione del file .iso è richiesta la presenza di &man.mkisofs.8; e naturalmente per masterizzare l'immagine è necessario &man.burncd.8; o &man.cdrecord.1;

## Contenuto del pacchetto e descrizione degli scripts

La directory principale contiene i seguenti scripts:

           0.rmdir.sh
           1.mkdir.sh
           2.buildworld.sh
           3.installworld.sh
           4.buildkernel.sh
           5.patchfiles.sh
           6.packages.sh
           7.customuser.sh
           8.mkiso.sh

Gli scripts sono numerati secondo il normale ordine di esecuzione e al momento non hanno i bit di esecuzione attivato, quindi per lanciarli basta scrivere:

           &prompt.root;sh N.scriptname.sh

`config.sh` - (obbligatorio)Parametri da editare:

- FREESBIEBASEDIR - La directory che conterrà il filesystem

- LOCALDIR - La directory che contiene gli scripts. Solitamente questa &egrave $PWD (current directory). Ovviamente non può coincidere ne' essere interna a FREESBIEBASEDIR

- PATHISO - Percorso completo dell'immagine finale (suggerito da droid)

`0.rmdir.sh` - (facoltativo) Pulisce FREESBIEBASEDIR. È utile quando questa diventa inutile.

`1.mkdir.sh` - (obbligatorio) Crea FREEBSDBASEDIR and l'albero di base delle directory usando &man.mtree.8;.

`2.buildworld.sh` - (obbligatorio) `cd /usr/src && make buildworld` ;) Questo passo diviene opzionale se e solo se è già stato eseguito un buildworld (senza clean) e soprattutto se i sorgenti non sono stati aggiornato dopo questo buildworld. Se non hai capito, eseguilo lo stesso! :)

`3.installworld.sh` - (obbligatorio) Installa i file e le directory nella futura `/etc`, poi ovviamente il world, ed aggiorna il sysinstall (lo aggiorner sul vostro sistema, dopodichè lo copierà).

`4.kernel.sh` - (obbligatorio) Compila e installa "alla vecchia maniera" il kernel personalizzato. I sorgenti nel CVS contengono ora la nuova procedura.

`5.patchfiles.sh` - (obbligatorio) Copia file di configurazione necessari al corretto avvio.

`6.packages.sh` - (facoltativo) Permette all'utente di selezionare i pacchetti da inserire nel cd, da un elenco dei pacchetti installati sul sistema. Le dipendenze vengono trovate ed inserite automaticamente. Occhio a qualche caso particolare [...]

`7.customuser.sh` - (facoltativo) L'idea dello script è di installare workaround noti per far funzionare qualche pacchetto. Nel mio caso è già presente un workaround per XKB sotto X

`8.mkiso.sh` - (obbligatorio) Prepara i files che popoleranno i vari mfs, e crea la iso avviabile. La iso è ovviamente masterizzabile con qualsiasi programma.

Altri scripts da ricordare sono:

`floppy_backup.sh` - Nella directory `/files/scripts` del live cd, è utile per salvare su dischetto alcune directory di particolare importanza. Le directory che si possono salvare sono: `/etc , /usr/local/etc , /var , /root e /dev`

`floppy_restore.sh` - Questo script provvede al restore dei dati da floppy, e viene eseguito in fase di avvio. Può essere avviato a mano in qualsiasi momento.

`create_vnodes.sh` - Nella directory `/scripts` del live cd, serve a creare dei virtual nodes con estensione .flp sulle slices già presenti nel sistema fisico, in modo da poter salvare informazioni su disco fisso. Quando viene eseguito, questo script chiede il mount point per le immagini .flp, quindi quali virtual nodes desideriamo creare e quanto grandi vogliamo che siano (in MB). Alla fine della procedura, si avr&agrave: un immagine .flp nella directory `freebsd/` del mount point che abbiamo selezionato. Al prossimo avvio, FreeSBIE troverà questo file e lo userà come virtual node per il filesystem che abbiamo scelto, senza quindi montare quest'ultimo come Memory Filesystem.

## Conclusioni

Per qualsiasi altro chiarimento il team di sviluppo è a vostra disposizione nel canale #freesbie su AzzurraNET (irc.azzurra.org).

G.U.F.I