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
   

2. Instalar el agente descargado:

   sudo dpkg -i ogagent_Version_all.deb
   

3. 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
   

4. 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
   

2. 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
   

3. Puede ser necesario corregir permisos antes de iniciar el servicio:

   chmod +x /etc/init.d/ogagent
   

4. 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
   

2. Seguir las instrucciones del instalador.
3. 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.
4. 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:

• Notificaciones enviadas al servidor (push):

Ruta	Método	Descripción	Mensaje JSON
/opengnsys/started	POST	Inicio del servicio OGAgent	{"ip":"IP","mac":"MAC","ostype":"SO","osversion":"Versión","secret":"Clave"}
/opengnsys/stopped	POST	Parada del servicio OGAgent	{"ip":"IP","mac":"MAC","ostype":"TipoSO","osversion":"VersionSO"}
/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"}

Nota: La clave de sesión se genera aleatoriamente en la operación de inicio del servicio agente, se envía al servidor para que éste la almacene y posteriormente pueda ser utilizada como parámetro de seguridad en las peticiones atendidas por el propio agente.

• Operaciones atendidas (pull):

Ruta	Método	Descripción	Respuesta JSON
/opengnsys/status	GET	Notificación del estado del equipo	{'status':'XXX','loggedin':bool}
/opengnsys/poweroff?secret=Clave	GET	Operación de apagado del cliente	(por definir)
/opengnsys/reboot?secret=Clave	GET	Operación de reinicio del cliente	(por definir)
/opengnsys/script?secret=Clave	POST	Operación de ejecución de script Python en el cliente (codificado en Base64)	{"script":"CadenaBase64"}

Estados definidos

Estado	Descripción
LNX	Sistema operativo GNU/Linux
WIN	Sistema operativo Windows
OSX	Sistema operativo Mac OS X (aún no soportado)
OPG	Cliente OpenGnsys esperando órdenes (aún no soportado)
BSY	Cliente OpenGnsys ocupado ejecutando alguna orden (aún no soportado)

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 16.04	Unity	Correcto
Ubuntu 14.04	Unity	Correcto
Ubuntu 14.04	Lxde	Correcto, sin notificar salida de la sesión
Ubuntu 12.04	Unity	Falta alguna dependencia y no se inicia el servicio
Windows 7	-	Correcto
Windows 10	-	Correcto