Instalación
Una instalación es una carpeta que contiene una versión de Toba. Originalmente una instalación puede correr una o más Instancias de distintos Proyectos.
Actualmente la mayor diferencia pasa por la concepción del proyecto como aplicación, con lo cual ya no se suelen correr varios proyectos por instancia
sino que se corre la aplicación
y algún proyecto auxiliar (ej: toba_usuarios
)
ATENCION: La carpeta no debe encontrarse dentro del DOCUMENT ROOT de apache, toba posee archivos de configuración y otros elementos que no deben ser accedidos desde afuera del servidor. El acceso web debe realizarse sobre puntos acotados que se configuran explícitamente.
Desatendida
Para llevar a cabo una instalación desatendida, esto es sin pedir de manera interactiva los parametros, lo cual es mas útil para entornos script, consultar la ayuda del comando para verificar los argumentos a ser provistos vía toba/bin/instalar --help
Creación manual
Luego de haber realizado el download del código vía composer y fijado las variables de entorno como se menciona aquí, debemos inicializar nuestra instalación. Para ello vamos a crearla, esto es atravesar una serie de preguntas para crear las configuraciones iniciales (este es el mecanismo de más bajo nivel):
toba instalacion crear
Allí se pregunta por el Grupo de desarrollo a utilizar. Luego es necesario configurar al menos una base de datos:
toba base registrar -d toba
Una configuración típica para este comando sería:
MOTOR: postgres7
HOST/PROFILE: localhost
USUARIO: postgres
CLAVE: **********
BASE: toba
Distribución de Carpetas
toba
- bin: Lugar donde reside el comando de consola
toba
- doc: Documentación interna del proyecto
- php: Código de Toba
- proyectos: Árbol de directorio de los distintos Proyectos básicos.
- www: Contiene archivos estáticos (imagenes, css, javascript, etc.)
- bin: Lugar donde reside el comando de consola
instalacion: Carpeta que contiene detalles de esta instalación puntual
Detalles de la configuración
En la carpeta principal de la aplicación existe una carpeta no versionada llamada instalacion que contiene todas las configuraciones de la instalación realizada incluyendo la de las instancias contenidas. Existen dos configuraciones principales de una instalación:
Qué Instancias tiene definidas, determinado por carpetas
$dir/instalacion/i__nombre
dondenombre
es la identificación de la instancia.Qué bases de datos se utilizan en la instalación, se definen en el archivo
$dir/instalacion/bases.ini
.Configuraciones varias, globales a toda la instancia en el archivo
$dir/instalacion/instalacion.ini
.