Instalación

bauble.classic es un programa independiente de la plataforma software pues puede funcionar en sistemas unix como Linux y MacOSX así como en 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

Si sigue los siguientes pasos, se encontrará con Bauble instalado en un entorno virtual, todas la dependencias Python estarán instalada localmente y no entrarán en conflicto con otros programas Python que puedan estar el la misma computadora.

Si por cualquier razón quisiera usted borrar Bauble, lo único que tiene que hacer es borrar el entorno virtual, que es una carpeta, con todo su contenido.

Instalación en Linux

  1. Bajar el archivo devinstall.sh y ejecutarlo:

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

    Nota: El archivo de instalación no bajará ningún conector de base de datos. Si quiere utilizar otra base de datos diferente que SQLite, tendrá que instalar un conector extra.

    Si tiene interés, puede examinar el archivo para ver qué es lo que hace. Muy sintético: primero examina eventuales problemas que no se pueden solucionar en un entorno virtual, luego crea el entorno con nombre bacl, baja todo el código fuente y conecta la copia local con la linea de producción bauble-1.0 en github, luego instala bauble, solucionando todas dependencias Python, y finalmente crea un archivo de arranque en la carpeta ~/bin.

    Si el proceso terminó sin errores, ya puede arrancar bauble:

    ~/bin/bauble

    Si usted desea ponerse al día con la última versión publicada:

    ~/bin/bauble -u

    El mismo archivo devinstall.sh puede ser utilizado para pasar a otra linea de producción. Sin embargo al momento solo hay bauble-1.0.

  2. Utilizando Unity, abra un terminal, arranque bauble, su icono aparecerá en el lanzador, y puede ahora pegarlo para que quede a disposición.

  3. Si quiere utilizar el conector por defecto de la base de datos SQLite, o si ni idea tiene de que quiere decir eso, puede ignorar este paso. Pero si ha decidido conectarse a otra base de datos, será necesario instalar el conector correspondiente.

    Para utilizar PostgreSQL, activar el entorno virtual e instalar psycopg2 con las instrucciones siguientes.

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

    Podría ser necesario resolver dependencias. Cómo hacerlo, depende de cual distribución Linux utiliza, y en que versión. Averigüe la documentación.

Siguiente…

Conectarse a una base de datos.

Instalar en MacOSX

Siendo MacOSX una versión de unix, todo funciona como en Linux, pues más o menos.

Una dificultad presente con MacOSX es que hay muchas versiones del sistema operativo, y que la puesta al día no es automática ni gratuita, así que varios sistemas siguen funcionando con versiones obsoletas.

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.

Primer paso, construir en MacOSX un entorno reconocible como unix:

  1. herramienta de desarrollo: xcode. por favor averigue en la wikipedia cual es la versión de xcode adapta a su mac.
  2. gestor de paquetes: homebrew (o si utiliza un sistema más viejo, tigerbrew).

siendo instalado lo de arriba, ejecutar:

brew doctor

asegúrese de haber entendido los problemas que serás reportados, y corríjalos. pygtk necesita xquartz y brew no puede solucionar la dependencia en manera automatica. use bre para instalar xquartz:

brew install Caskroom/cask/xquartz

y finalmente instalar las últimas dependencias:

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

siga las instrucciones relativas a como activar lo que acaba de instalar.

ahora puede seguir como en una normal máquina unix, y para eso tenemos un archivo de instalación. Lea las instrucciones para Linux, las siga, y disfrute.

Siguiente…

Conectarse a una base de datos.

Instalar en 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.

Por favor reporte cualquier problema. Ayuda para preparar un paquete de instalación será muy apreciada.

Nota

Bauble ha sido comprobado con W-XP, W7 y W8. Muy probablemente funciona también con otras versiones de Windows.

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.

los pasos de instalación en Windows:

  1. baje e instale git desde:

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

    Direct link to download git

    todas opciones por defecto están bien, excepto que queremos poder encontrar git desde la línea de mando Windows:

    _images/git3.png

  2. baje e instale Python 2.7 (32 bit) desde:

    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.

    Cuando instala Python, ponga sus programas en el PATH:

    _images/python3.png

  3. baje e instale pygtk desde el repositorio siguiente (se requiere python 32bit). vamos a necesitar versión «all in one»:

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

    Direct link to download PyGTK

    hágase una instalación completa, incluyéndolo absolutamente todo:

    _images/pygtk1.png

  4. (opcional) descargar e instalar un conector de base de datos además que sqlite3.

    En Windows no es nada fácil instalar psycopg2 desde las fuentes. Por favor evítese complicaciones y utilice un paquete precompilado:

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

    Direct link to download psycopg2

  5. REINICIALICE

    así es Windows, cambió cosas en el sistema, hay que reiniciar!

  6. baje y ejecute el archivo batch:

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

    esto pone una copia del repositorio bauble.classic en su equipo, en la carpeta Local\github\Bauble. conectada con la linea de producción 1.0, en seguida crea un entorno virtual en que finalmente instala bauble.

    you can also run devinstall.bat passing it as argument the numerical part of the production line you want to follow.

  7. descarga también el archivo para poner al día su instalación:

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

    las versiones de Bauble después de la 1.0.40 averiguan, al arrancar, si hay una versión más recién en el repositorio central.

    cuando quiera poner al día su instalación, abra una ventana de terminal y ejecute 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.

Siguiente…

Conectarse a una base de datos.

Troubleshooting the Install

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

    The following packages are required by Bauble

    • SQLAlchemy
    • lxml

    The following packages are optional:

    • 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.

Siguiente…

Conectarse a una base de datos.