Installazione

bauble.classic è un programma multipiattaforma e funziona su macchine unix (Linux e MacOSX) ma anche su Windows.

To install Bauble first requires that you install its dependencies that cannot be installed automatically. These include virtualenvwrapper, PyGTK and pip. Python and GTK+, you probably already have. As long as you have these packages installed then Bauble should be able to install the rest of its dependencies by itself.

Nota

Seguendo le seguenti istruzioni di installazione si ottiene un Bauble installato in un ambiente Python virtuale, tutte le dipendenze saranno installate localmente e non entreranno in conflitto con altri programmi Python che possono essere sullo stesso elaborator.

se dovessi in seguito decidere di rimuovere Bauble, basterà rimuovere l’ambiente virtuale, che è una directory, con tutto il suo contenuto.

Installare su Linux

  1. Scaricare il programmino devinstall.sh ed eseguirlo:

    https://raw.githubusercontent.com/Bauble/bauble.classic/master/scripts/devinstall.sh

    Nota bene: il programmino di cui sopra non installerà alcun connettore a base dati. Questo è lasciato per un passo successivo.

    A titolo d’informazione, il programmino esegue i seguenti passi: installa le dipendenze che non possono essere soddisfatte in un ambiente virtuale, crea poi l’ambiente virtuale, di nome bacl (che sta per ba(uble.)cl(assic)), scarica i sorgenti e connette il checkout git alla linea di produzione bauble-1.0, dopo di che procede con la sua installazione, che implica lo scaricare tutte le dipendenze. Questo può prender tempo. Infine crea un programmino di avvio di nome bauble, nella directory ~/bin dell’utente corrente.

    Se il programmino di installazione termina senza errori, si può ora avviare bauble:

    ~/bin/bauble

    o aggiornare bauble all’ultima versione rilasciata nella linea di produzione:

    ~/bin/bauble -u

    Lo stesso programmino puoi utilizzarlo per cambiare ad un’altra linea di produzione, anche se al momento c’è solo la bauble-1.0.

  2. su Uniti, apri un terminale, avvia bauble, la sua icona (un diamante verde) apparirà nel launcher, e se si vuole lo si può saldare al launcher.

  3. If you would like to use the default SQLite database or you don’t know what this means then you can skip this step. If you would like to use a database backend other than the default SQLite backend then you will also need to install a database connector.

    Se si desidera utilizzare un database PostgreSQL, si attivi l’ambiente virtuale e si installi psycopg2 con i seguenti comandi:

    source ~/.virtualenvs/bacl/bin/activate
pip install -U psycopg2

    Potrebbe essere necessario risolvere delle dipendenze. Come farlo, dipende dalla distribuzione Linux che si sta utilizzando. Consultare la documentazione corrispondente.

Next…

Connettersi ad una base dati.

Installare su MacOSX

Considerando che MacOSX è unix, la maggior parte dei passi sono uguali al caso Linux, diciamo così.

Una difficoltà importante su MacOSX è che ci sono davvero moltissime versioni diverse di questo sistema operativo e non ci è possibile sostenerle tutte, inoltre Apple «l’impresa» tiene aggiornate solo le ultime due versioni, così che su quelle precedente potrebbe essere difficile o impossibile installare software recente.

Last time we tested, some of the dependencies could not be installed on MacOSX 10.5 and we assume similar problems would present themselves on older OSX versions. Bauble has been successfully tested with 10.7 and 10.9.

Prima di tutto, è necessario completare quello che è un normale ambiente di sviluppo unix, che non è presente in un mac così come esce dal negozio.

  1. attrezzi di sviluppo: xcode. verificare sulla wikipedia quale versione è adatta al mac in questione.
  2. gestore di pacchetti: homebrew (su versioni più vecchie esiste tigerbrew).

avendo installato le precedenti, eseguire:

brew doctor

assicurati di aver capito il messaggio di errore, in modo da poter correggere la situazione. pygtk ha bisogno di xquartz e brew non è in grado di risolvere questa dipendenza. per installare xquartz puoi utilizzare brew, o quello che preferisci:

brew install Caskroom/cask/xquartz

ed ora installare le ultime dipendenze:

brew install git
brew install pygtk  # takes time and installs all dependencies

seguire le istruzioni su come attivare quanto installato.

il resto segue come su una normale macchina unix, puoi utilizzare lo stesso devinstall.sh. Leggi le istruzioni per Linux, seguile, buon utilizzo.

Next…

Connettersi ad una base dati.

Installare su Windows

The Windows installer used to be a «batteries-included» installer, installing everything needed to run Bauble. The current maintainer of bauble.classic cannot run Windows applications. If you want to run the latest version of bauble on Windows: download and install the dependencies and then install Bauble from the source package.

Please report any trouble and help with packaging will be very welcome.

Nota

Bauble è stato provato con successo su WXP, W7 e W8. Molto probabilmente funziona anche su altre versioni, ma non è stato provato.

Nota

Direct download links are given for all needed components. They have been tested in September 2015, but things change with time. If any of the direct download links stops working, please ring the bell, so we can update the information here.

i passi per l’installazione su Windows:

  1. scaricare ad installare git (viene con un paio di cose buone come sh e vi), prendendolo da:

    https://git-scm.com/download/win

    Direct link to download git

    quasi tutte le opzioni per difetto stanno bene: c’è bisogno di specificare che si vuol eseguire git dalla linea di comando Windows.

    _images/git3.png

  2. scaricare ed installare

    http://www.python.org

    Direct link to download Python

    Bauble has been developed and tested using Python 2.x. It will definitely not run on Python 3.x. If you are interested in helping port to Python 3.x, please contact the Bauble maintainers.

    durante l’installazione di Python, includere Python nel PATH:

    _images/python3.png

  3. scaricare pygtk dalla fonte seguente. (richiede python a 32bit). Fare attenzione a scaricare la versione «all in one»:

    http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/

    Direct link to download PyGTK

    fare una installazione completa, includendo assolutamente tutto:

    _images/pygtk1.png

  4. (opzionale) scaricare ed installare connettori database al lato di sqlite3, presente per difetto.

    Su Windows, NON è facile installare psycopg2 dai suoi sorgenti utilizzando pip, per piacere evitar problemi ed utilizzare un pacchetto precompilato da:

    http://initd.org/psycopg/docs/install.html

    Direct link to download psycopg2

  5. REINIZIALIZZARE

    Giovani, questo è Windows, c’è bisogno di reinizializzare il sistema perché i cambiamenti abbiano effetto!

  6. scaricare ed eseguire il programmino batch:

    https://raw.githubusercontent.com/Bauble/bauble.classic/master/scripts/devinstall.bat

    this will pull the bauble.classic repository on github to your home directory, under Local\github\Bauble, checkout the bauble-1.0 production line, create a virtual environment and install bauble into it.

    puoi anche eseguire devinstall.bat passandogli la parte numerica della linea di produzione che si vuol seguire.

  7. scaricare il programmino batch, per restare aggiornati con la linea di produzione scelta:

    https://raw.githubusercontent.com/Bauble/bauble.classic/master/scripts/bauble-update.bat

    if you are on a recent Bauble installation, each time you start the program, Bauble will check on the development site and alert you of any newer bauble release within your chosen production line.

    in ogni momento che si voglia aggiornare l’installazione, basterà aprire la finestra con la linea di comando ed eseguire bauble-update.bat

  8. you can now start bauble using the bauble.lnk shortcut that the installation procedure copies to the Scripts directory of the virtual environment:

    %HOMEDRIVE%%HOMEPATH%\.virtualenv\bacl\Scripts\bauble.lnk

If you would like to generate and print PDF reports using Bauble’s default report generator then you will need to download and install Apache FOP. After extracting the FOP archive you will need to include the directory you extracted to in your PATH.

Next…

Connettersi ad una base dati.

Problemi durante l’installazione

  1. What are the packages that are installed by Bauble:

    I seguenti pacchetti sono richiesti da Bauble

    • SQLAlchemy
    • lxml

    I seguienti pacchetti sono opzionali:

    • Mako - required by the template based report generator
    • gdata - required by the Picasa photos InfoBox

  2. Couldn’t install lxml.

    The lxml packages have to be compile with a C compiler. If you don’t have a Make sure the libxml and libxsl packages are installed. Installing the Cython packages. On Linux you will have to install the gcc package. On Windows there should be a precompiled version available at http://pypi.python.org/pypi/lxml/2.1.1

  3. Couldn’t install gdata.

    For some reason the Google’s gdata package lists itself in the Python Package Index but doesn’t work properly with the easy_install command. You can download the latest gdata package from:

    http://code.google.com/p/gdata-python-client/downloads/list

    Unzip it and run python setup.py installw in the folder you unzip it to.

Next…

Connettersi ad una base dati.