= OGR = ''ogr'' ó ''OpenGnSys Runner'' es un comando que se ha desarrollado para la versión 2 para facilitar el uso del engine. Se basa en ejecutar comandos que se encuentre en el directorio que marque la variable global $OG_ENGINE_DIR. Si la variable no estuviera seteada se usará por defecto el valor: '/opt/opengnsys/engine/'. La herramienta ogr facilita la creación de scripts facilitando algunas tareas repetitivas: * La ayuda: ogr es capaz de leer la documentación de los scripts y mostrarla. * Errores: cuando un script termina con un valor de retorno distinto de 0, busca en la documentación y muestra la excepción que ha ocurrido. * Mensajes de completitud: Los scripts pueden enviar a la salida de errores mensajes sobre el porcentaje de trabajo que se lleva realizado y ogr se encará de hacerlos llegar a quien corresponda. Para ello se ha creado la libreria ogr (libogr.py) que también puede ser usado por los scripts que necesiten funciones más avanzada de ogr como la ejecución de otros scripts. Esto es un pequeño adelanto pero se espera agregar más funcionalidades a esta herramienta. {{{ ogr getNumDisk ogr help getNumDisk ogr list web }}} = Engine = El engine se encarga de todas las tareas a bajo nivel de OpenGnSys. Las operaciones van desde saber que IP tiene el cliente, como crear particiones, crear imágenes, arrancar una partición, etc. En el directorio del Engine se encontrarán los distintos directorios, al que vamos a llamar módulos a partir de ahora, que tiene el engine: * net: Scripts para redes. * proto: Scripts de protocolos. * rellenar todos los que falten. * util: Aquí encontramos todos los scripts propios de está herramienta que facilitarán el uso del engine: * help: muestra la ayuda de un script. * list: muestra todos los comandos disponibles del módulo pasado como argumento. * list-modules: muestra la lista de módulos. * what-module: muestra el módulo al que pertence un script. * where-is: muestra la ruta completa hasta un script. * web: Aquí encontramos todos los scripts que se usan desde la interfaz web para manejar los clientes y por tanto tienen que trabajar en json. = Requisitos para el Engine = Los scripts que componen el engine deben cumplir una serie de requisitos para que funcionen de manera correcta con la herramienta OGR. == Lenguajes == En principio no habría restricciones para el lenguaje que se use para hacer los scripts. La restricción entraría en la instalación dentro del cliente OGLive que habría que agregar. == Documentación == Ejemplo: {{{ #/** #@fn ogr list module. #@brief Muestra la lista de script de un módulo. #@param module: módulo del que queremos mostrar la lista. #@return lista de script del módulo. #@exception ARG_REQUIRED: Argumento requerido. #@exception MODULE_NOTFOUND: Módulo no encontrado. #@version 0.1 - Primera versión para OpenGnSys. #@author Alejandro Castaño, Wadobo Software S.L. #@date 27/02/2011 #*/ }}} 1. La documentación debe ir al principio del archivo antes de cualquier código ejecutable. 1. Debe usarse la forma doxygen iniciandose con '/!**' y terminando con '*/'. 1. Los '#' son necesarios para que tanto bash, como python, como el lenguaje que se use lo tome como un comentario. 1. Cada argumento de la documentación debe empezar en una línea nueva, aunque cada argumento pueda ocupar más de una línea. 1. Tanto el autor como la fecha deben tener una versión encima, ya que se consideran fechas y autores de la correspondiente versión. == Excepciones == Cuando algo no fue como se esperaba hay que devolver un número mayor que 0. OGR considerará que el número con el que termino el script corresponderá a la posición que ocupa la excepción dentro de la documentación del script. Por ejemplo si en el ejemplo anterior el script acabará con un 1, OGR mostrará la excepción ARG_REQUIRED, si terminará con un 2, ogr mostrará la excepción MODULE_NOTFOUND. == Salida == Como el valor retorno se usa para controla las excepciones, la salida estándar se usa como la salida del comando. Por tanto cualquier información que un comando quiera devolver lo deberá hacer a través de su salida estandar que será recogida por ogr. == Salida de error == La salida de error puede usarse para dos cosas: 1. Para dar más información en caso de excepción puede usarse. Esta información sólo se mostrará en caso de excepción. 1. Si se quieren enviar mensajes de control deberá usarse la salida de error para ello. Estos mensajes tendrán un formato especial que ogr logrará reconocer y distinguir de los anteriores == Mensajes de control == === Completitud de un trabajo === Para enviar mensaje de completitud de un trabajo se deberá escribir en la salida de error con el siguiente formato: {{{ [34] Mensaje auxiliar }}} El mensaje auxiliar puede ser todo lo largo que se quiera hasta que se encuentre un salto de línea. Por ahora no hay más mensajes de control.