2 | | ''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 $OGEDIR. Si la variable no estuviera seteada se usará por defecto el valor: '/opt/opengnsys/engine/' . En esta carpeta se encontrarán los distintos directorios, al que vamos a llamar módulos a partir de ahora, que tiene el engine: |
| 2 | ''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: |
| 3 | * La ayuda: ogr es capaz de leer la documentación de los scripts y mostrarla. |
| 4 | * 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. |
| 5 | * 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. |
| 6 | |
| 7 | 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. |
| 8 | |
| 9 | Esto es un pequeño adelanto pero se espera agregar más funcionalidades a esta herramienta. |
| 10 | |
| 11 | {{{ |
| 12 | ogr getNumDisk |
| 13 | ogr help getNumDisk |
| 14 | ogr list web |
| 15 | }}} |
| 16 | |
| 17 | = Engine = |
| 18 | |
| 19 | 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: |
7 | | * utils: Aquí encontramos todos los scripts propios de está herramienta que facilitarán el uso del engine: |
8 | | * help: muestra la ayuda. Si recibe un script como argumento se mostrará la ayuda del script. |
9 | | * list: muestra todos los comandos disponibles. Si se le pasa como argumento un módulo mostrará sólo los de el módulo en concreto. |
10 | | * listmodules: muestra la lista de módulos. |
11 | | * trace: muestra la traza que siguen los scripts. |
12 | | * debug: muestra la traza que siguen los scripts pero se pueden modificar los argumentos en cada llamada. |
13 | | * ... |
| 24 | * util: Aquí encontramos todos los scripts propios de está herramienta que facilitarán el uso del engine: |
| 25 | * help: muestra la ayuda de un script. |
| 26 | * list: muestra todos los comandos disponibles del módulo pasado como argumento. |
| 27 | * list-modules: muestra la lista de módulos. |
| 28 | * what-module: muestra el módulo al que pertence un script. |
| 29 | * where-is: muestra la ruta completa hasta un script. |
| 30 | * 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. |
23 | | = Engine = |
24 | | 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. Dentro del engine divisamos dos niveles diferenciados: |
| 57 | 1. La documentación debe ir al principio del archivo antes de cualquier código ejecutable. |
| 58 | 1. Debe usarse la forma doxygen iniciandose con '/!**' y terminando con '*/'. |
| 59 | 1. Los '#' son necesarios para que tanto bash, como python, como el lenguaje que se use lo tome como un comentario. |
| 60 | 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. |
| 61 | 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. |
33 | | * '''Scripts de alto nivel:''' Son creados principalmente en python. Realizan operaciones mucho más compleja como por ejemplo devolver toda la información sobre discos: número de discos, con cuántas particiones cada uno, tamaño, tipo, etc. Además su salida está formateada en json para la comunicación con el WebConsole. Además existe libogr que facilitará la ejecución de comandos desde los scripts python. |
| 67 | == Salida == |
| 68 | |
| 69 | 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. |
| 70 | |
| 71 | == Salida de error == |
| 72 | |
| 73 | La salida de error puede usarse para dos cosas: |
| 74 | 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. |
| 75 | 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 |
| 76 | |
| 77 | == Mensajes de control == |
| 78 | |
| 79 | === Completitud de un trabajo === |
| 80 | |
| 81 | Para enviar mensaje de completitud de un trabajo se deberá escribir en la salida de error con el siguiente formato: |
| 82 | {{{ |
| 83 | [34] Mensaje auxiliar |
| 84 | }}} |
| 85 | |
| 86 | 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. |