BrainTop User's Guide

Sommario

3. Installazione

3.1 Preparazione all'installazione
3.2 Dipendenze
3.3 Procedura di installazione e note

3.1 Preparazione all'installazione

Si ricorda che le attuali versioni rilasciate di BrainTop sono estremamente sperimentali, pertanto se ne consiglia l'installazione e l'utilizzo all'interno di un ambiente operativo preposto ai test e alla sperimentazione.

Ovviamente, prima di tutto occorre prelevare l'archivio dei sorgenti della versione desiderata dalle fonti elencate nella sezione "Dove reperire i sorgenti".
Dopodiche', provvedere alla verifica dell'assoluzione delle dipendenze richieste.

3.2 Dipendenze

Buona parte delle dipendenze per la compilazione e l'esecuzione sono le stesse richieste dal window manager XFCE: si consiglia pertanto di installare questo prodotto seguendo le istruzioni ad esso relative.
Per la compilazione saranno inoltre necessarie anche le versioni "-dev" delle librerie di XFCE.
Ecco una lista (potenzialmente non completa) delle librerie e delle applicazioni richieste (notare che questi sono i nomi assegnati dal team della distribuzione Debian, e possono subire leggere variazioni a seconda della distribuzione scelta):
libxfce4mcs-dev
libxfce4mcs-client-1
libxfce4mcs-manager-1
libxfce4util-dev
libxfce4util-1
libxfcegui4-dev
libxfcegui4-1
xfce4-mcs-manager-dev
xfce4-mcs-manager
libxpm-dev
libatk1.0-0
libc6
libglib2.0-0
libgtk2.0-0
xlibs
libpango1.0-0
zlib1g
xlibs-static-pic
libxt-dev
Oltre alle librerie di XFCE, e' richiesta anche la libreria SQLite (libsqlite3-dev e libsqlite3) per la manipolazione del database centrale su cui si poggia BrainTop.

3.3 Procedura di installazione e note

Scompattare l'archivio .tar.gz in una directory a scelta.

Allo stato attuale non vengono messi a disposizione strumenti per la verifica automatica delle dipendenze e per la compilazione (il classico Makefile), ma un semplice script bash che assolve al compito della compilazione: esso e' nominato "compile_and_install", si trova nella cartella principale dei sorgenti (da non confondere con gli script omonimi che si trovano nelle altre cartelle generate dalla scompattazione dell'archivio) e va eseguito con privilegi di root in quanto andra' a spostare alcuni files in cartelle solitamente protette in scrittura dagli altri utenti.
La corretta esecuzione delle operazioni di compilazione viene segnalata attraverso stringhe di colore verde (dunque facilmente identificabili tra gli altri output propri del compilatore) che appariranno sulla consolle ove e' stato avviato lo script. La corretta sequenza delle stringhe di controllo e':

Installation tree created
BrainManager compiled and installed
BrainApplet compiled and installed
BrainSession compiled and installed
BrainSettingsManager compiled and installed
BrainSettingsManagerPlugins compiled and installed
BrainDesktop compiled and installed
BrainWindowManager compiled and installed
Database initialization
BrainTop system ready!
Run /usr/local/bin/startbrain

In caso di errore lo script si interrompera'.

L'installazione standard va a scrivere tutti i files relativi al window manager nella directory /usr/local/BrainTop (per ora tale parametro non e' personalizzabile): nel caso in cui si eseguisse una nuova installazione all'interno di un sistema ove BrainTop era gia' stato installato, la vecchia directory sarebbe completamente rimossa e rimpiazzata: tale procedura e' segnalata dalla stringa "Removing old BrainTop installation" che apparirebbe come primo output dello script "compile_and_install".

L'unico file appartenente a BrainTop e non trasferito nella directory di default e' lo script per l'avvio del window manager: esso viene copiato in /usr/local/bin sotto il nome di "startbrain", in modo da poter essere facilmente eseguito.