Instancias

Una instancia contiene los metadatos de un conjunto de proyectos, incluyendo entre ellos al mismo Editor (ya que TobaConsumeToba). Por esto recibe el nombre de instanciación de un proyecto, ya que un Proyecto puede estar contenido en muchas instancias diferentes.

Una instancia puede contener distintos proyectos. La instancia posee metadatos propios como los Usuarios que no pertenecen a un proyecto particular sino que son globales a la instancia y se relacionan con los distintos proyectos en diferentes roles. Una vez exportada la instancia la definición de estos metadatos se encuentran en el directorio global dentro de la carpeta i__nombre. Aquellos metadatos de la instancia pero referidos a un proyecto particular se exportan a la carpeta p__nombreproyecto.

Configuración

Una instancia posee un nombre (desarrollo, produccion, testing, etc) y con ese nombre debe existir una carpeta i__nombre en el directorio toba/instalacion. Esta carpeta posee el archivo instancia.ini que contiene

• base: La base de datos que se va a utilizar para almacenar los metadatos, es un puntero hacia las bases definidas en la Instalación.
• proyectos: La lista de proyectos que se incluyen en la instancia
• Una sección por proyecto, para poder indicar:
  • url: Especificar en caso que el alias del proyecto difiera de su id.
  • path: Especificar en caso de que el proyecto se encuentre fuera del directorio proyectos de Toba.

Por ejemplo:

    [legalizaciones]
    url = /mi_legalizaciones
    path = /var/proyectos/legalizaciones

Comandos útiles

Creación de una instancia

La administración de las instancias se realiza bajo la consola, la variable de entorno toba_instancia determina que instancia se utiliza implícitamente en estos comandos. En particular cuando se cuenta con una Instalación inicial es necesario definir los parámetros de una instancia, para eso se ejecuta:

toba instancia crear

Se selecciona una base ya definida (Si no se encuentra ninguna ver la creación de una instalación ), luego se crea la base de datos asociada a la instancia y se pide ingresar un usuario para posteriormente poder ingresar al ambiente.

Regeneración de una instancia

Para ver la instancia actual ejecutar:

    toba instancia info

Luego de definir las configuraciones de la instancia es posible regenerar todos los proyectos definidos en una instancia particular. Para esto se utiliza el siguiente comando:

    toba instancia regenerar

Este comando pide dos confirmaciones: primeramente pregunta si se quieren exportar los metadatos locales (es seguro responder que sí, ya que sino se pierde toda la información relacionada con los usuarios y demás actividad local). Luego, si la base ya existía, pide la confirmación de la regeneración, ya que la base necesita ser borrada para volver a cargarse, este proceso no tiene vuelta atrás excepto que se haya exportado la base anteriormente.

Exportación de la instancia

Cuando se habla de exportar la instancia, implica exportar los metadatos propios de la instancia y los metadatos de los proyectos contenidos:

    toba instancia exportar

Si solo se desea exportar los metadatos propios de la instancia y NO los de sus proyectos:

    toba instancia exportar_local

Administración gráfica

Es posible administrar gráficamente la instancia utilizando el proyecto toba_usuarios