Consola Administrativa

El objetivo de la consola es llevar a cabo el mantenimiento de los elementos centrales del entorno: Instalacion, Instancia y Proyecto.

Configuracion de la consola

Definir las VARIABLES de ENTORNO:
- toba_dir [obligatoria] : Directorio donde se encuentra instalado el toba.
- toba_instancia [opcional]: Instancia por defecto. Si no existe hay que agregar -i en los comandos que utilicen instancias (casi todos).
- toba_proyecto [opcional]: Proyecto por defecto. Si no existe hay que agregar -p en los comandos que utilicen proyectos.
Agregar en el PATH
- El intérprete de PHP: Chequear la existencia del intérprete con el comando php -v
- La carpeta /bin del directorio donde se encuentra instalado el toba. Chequear la configuración invocando el comando toba
- El cliente de svn de linea de comandos. Esto es solo necesario si los proyectos se versionan bajo SVN. Chequear la configuración invocando el comando svn help

Configuración avanzada

Cuando se cuenta con dos o más versiones distintas de toba en una misma máquina es necesario crear distintos ambientes para la administración de los mismos.

La forma de crear estos ambientes es no incluir ninguna variable de entorno ni modificar el PATH en las configuraciones por defecto del sistema, sino relegarlo a la ejecución puntual de comandos. Por ejemplo si se cuenta con dos instalaciones totalmente distintas de toba toba_0.9.0 y toba_0.9.1 se crearían dos archivos ejecutables, uno que inicie el ambiente para la versión 0.9.0 de toba y el otro para la 0.9.1

Utilizando Windows

    @echo off
    REM Archivo toba_0.9.0.bat
    set toba_dir=d:\proyectos\toba_0.9.0
    set toba_instancia=desarrollo
    d:
    set PATH=%PATH%;%toba_dir%/bin
    cd %toba_dir%

    @echo off
    REM Archivo toba_0.9.1.bat
    set toba_dir=d:\proyectos\toba_0.9.1
    set toba_instancia=desarrollo
    d:
    set PATH=%PATH%;%toba_dir%/bin
    cd %toba_dir%

A la hora de usar uno u otro ambiente ejecutar el .bat adecuado, por ej:

    C:\>toba_0.9.1.bat

Utilizando linux

    #Archivo toba_0.9.0
    export toba_dir=/home/usuario/proyectos/toba_0.9.0
    export toba_instancia=desarrollo
    export PATH="$toba_dir/bin:$PATH"
    cd $toba_dir

    #Archivo toba_0.9.1
    export toba_dir=/home/usuario/proyectos/toba_0.9.1
    export toba_instancia=desarrollo
    export PATH="$toba_dir/bin:$PATH"
    cd $toba_dir

Es importante ejecutar el comando precedido por un punto y un espacio para que las modificaciones a las variables de entorno se apliquen durante toda la sesión de consola. Por ejemplo suponiendo que los archivos se encuentran en /home/usuario:

    . /home/usuario/toba_0.9.0

Crea el ambiente para la versión 0.9.0

Forma alternativa

Una forma de evitar olvidos y errores seteando estas variables, es crear un comando por instalación que sea la puerta de entrada a la misma. Así no se utilizaría el comando toba para las operaciones administrativas sino mas bien uno relacionado con la versión utilizada, por ejemplo toba_trunk o toba_costos. Por ejemplo usando bash, se podria crear el comando toba_trunk y ponerlo en /usr/bin:

    export toba_dir=/home/usuario/proyectos/toba
    export toba_instancia=desarrollo
    $toba_dir/bin/toba $*

Y cada vez que se necesita ejecutar un comando de instalación se utiliza el comando toba_trunk en lugar de toba

SIU-Toba