[[TOC(heading=Índice)]]

= OGAgent: agente OpenGnsys para sistema operativo =

== Descripción general ==

OGAgent es un nuevo programa agente compilado para instalar en los sistemas operativos de los equipos clientes y que incluye un servicio REST propio preparado para ''conversar'' mediante mensajes asíncronos en formato JSON con el servicio REST de su servidor OpenGnsys.


== Sistemas operativos soportados ==

||= Sistemas operativos =||= Fichero OGAgent =||
||Ubuntu, Debian y derivados||ogagent_''Version''_all.deb||
||Red Hat, Fedora y derivados||ogagent-''Version''.noarch.rpm||
||SuSE y OpenSuSE ||ogagent-opensuse-''Version''.noarch.rpm||
||MS-Windows ||OGAgentSetup-''Version''.exe||



== Instalación ==

Descargar el fichero correspondiente al sistema operativo utilizado desde el formulario de propiedades de ordenadores de la consola de administración web de OpenGnsys


=== Sistemas operativos Ubuntu, Debian y derivados ===

Ejecutar las siguientes operaciones como usuario administrador (usando {{{sudo}}}).

 1. Instalar dependencias ('''Nota''': revisar dependencias para Ubuntu 12.04):
 {{{
sudo apt-get install -y libxss1 policykit-1 python python-requests python-qt4 python-six python-prctl
}}}
 1. Instalar el agente descargado:
 {{{
sudo dpkg -i ogagent_Version_all.deb
}}}
 1. Configurar el agente, incluyendo la dirección IP del servidor OpenGnsys:
 {{{
sudo sed -i "0,/remote=/ s,remote=.*,remote=https://IPServidorOpenGnsys/opengnsys/rest/," /usr/share/OGAgent/cfg/ogagent.cfg
}}}
 1. Iniciar el servicio (se iniciará automáticamente en el proceso de arranque):
 {{{
sudo service ogagent start
}}}

=== Sistemas operativos Red Hat, Fedora y derivados ===

Ejecutar las siguientes operaciones como usuario {{{root}}} o como administrador (usando {{{sudo}}}).

 1. Instalar el agente descargado:
 {{{
yum install ogagent-Version.noarch.rpm
}}}
 1. Configurar el agente, incluyendo la dirección IP del servidor OpenGnsys:
 {{{
sed -i "0,/remote=/ s,remote=.*,remote=https://IPServidorOpenGnsys/opengnsys/rest/," /usr/share/OGAgent/cfg/ogagent.cfg
}}}
 1. Puede ser necesario corregir permisos antes de iniciar el servicio:
 {{{
chmod +x /etc/init.d/ogagent
}}}
 1. Iniciar el servicio (se iniciará automáticamente en el proceso de arranque):
 {{{
service ogagent start
}}}


=== Sistemas operativos OpenSuSE ===

 ''(en preparación)''

=== Sistemas operativos Windows ===

Ejecutar las siguientes operaciones como usuario administrador.

 1. Instalar el agente descargado, ejecutando:
 {{{
OGAgentSetup-Version.exe
}}}
 1. Seguir las instrucciones del instalador.
 1. Editar el fichero de configuación {{{C:\Program Files\OGAgent\cfg\ogagent.cfg}}} (o {{{C:\Archivos de programa\OGAgent\cfg\ogagent.cfg}}}) y modificar el valor de la cláusula {{{remote}}} de la sección {{{[OGAgent]}}} inclyendo la dirección IP del servidor OpenGnsys.
 1. Iniciar el servicio (se iniciará automáticamente en el proceso de arranque):
 {{{
NET START OGAgent
}}}


== Mensajes entre OpenGnsys Server y OGAgent ==

OGAgent para OpenGnsys 1.1.0 tiene incorporadas las siguientes operaciones:

 * Operaciones atendidas (''pull''):

   ||= Ruta =||= Método =||= Descripción =||= Respuesta JSON =||
   ||{{{/opengnsys/status}}}||GET||notificación del estado del equipo|| ... ||
   ||{{{/opengnsys/poweroff}}}||GET||operación de apagado del cliente||''(por definir)''||
   ||{{{/opengnsys/reboot}}}||GET||operación de reinicio del cliente||''(por definir)''||

 * Notificaciones enviadas al servidor (''push''):

   ||= Ruta =||= Método =||= Descripción =||= Mensaje JSON =||
   ||{{{/opengnsys/started}}}||POST||Inicio del servicio OGAgent||{{{ {'ip':'IP','mac':'MAC'} }}}||
   ||{{{/opengnsys/stopped}}}||POST||Parada del servicio OGAgent||{{{ {'ip':'IP','mac':'MAC'} }}}||
   ||{{{/opengnsys/loggedin}}}||POST||Usuario inicia sesión en escritorio||{{{ {'ip':'IP','user':'Usuario'} }}}||
   ||{{{/opengnsys/loggedout}}}||POST||Usuario finaliza sesión en escritorio||{{{ {'ip':'IP','user':'Usuario'} }}}||


== Banco de pruebas ==

||= SO Cliente =||= Escritorio =||= Comentarios =||
||CentOS 7||No||Correcto, sin notificar el estado de inicio de sesión||
||Fedora 23||GNOME 3||Correcto, sin notificar el estado de inicio de sesión||
||Ubuntu 14.04||Unity||Correcto||
||Ubuntu 12.04||Unity||Falta alguna dependencia y no se inicia el servicio||
||Windows 7||-||Correcto||
||Windows 10||-||Correcto, pero el sistema no notifica cierre de sesión||