OGAgent: agente OpenGnsys para sistemas operativos    INSTALL.es.txt
====================================================================


Requisitos de creación
----------------------
Sisitema operativo Linux con los siguientes paquetes instalados:
- Subversion
- GNU C++, Python, librerías PyQt4
- Creación de instalador Exe (Wine 32 bits, Wine Gecko, Wine Mono, Samba Winbind, Cabextrct)
- Creación de paquetes Deb (debhelper, dpkg-dev)
- Creación de paquetes RPM (rpm-build)
- Creación de paquetes Pkg (xar, bomutils)


Crear instaladores de OGAgent
-----------------------------
- Paso previo: actaulizar componentes gráficos de PyQt para OGAgnet:
	src/update.sh

- Crear paquetes Deb y RPM para distribuciones Linux (requiere permisos de "root"):
	sudo linux/build-packages.sh

- Crear paquete Pkg para sistemas operativos macOS X:
	sudo macos/build-pkg.sh

- Crear el programa instalador para sistemas operativos Windows:
	windows/build-windows.sh

- Subir los nuevos ficheros .deb, .rpm, .pkg y .exe generados al directorio
/opt/opengnsys/www/descargas  del servidor OpenGnsys.


Instalar OGAgent en cliente modelo
----------------------------------
- Descargar el fichero correspondiente en el sistema operativo del cliente.

- Ubuntu, Debian y derivados:
  - Descargar e instalar el agente:
	sudo apt install ./ogagent_Version_all.deb
  - Configurar el agente:
	sudo sed -i "0,/remote=/ s,remote=.*,remote=https://IPServidorOpenGnsys/opengnsys/rest/," /usr/share/OGAgent/cfg/ogagent.cfg
  - Iniciar el servicio (se iniciará automáticamente en el proceso de arranque):
	sudo service ogagent start

- Red Hat, Fedora y derivados (como root):
  - Descargar e instalar el agente:
	yum install ogagent-Version.noarch.rpm    (Red Hat/CentOS)
	dnf install ogagent-Version.noarch.rpm    (Fedora)
  - Configurar el agente:
	sed -i "0,/remote=/ s,remote=.*,remote=https://IPServidorOpenGnsys/opengnsys/rest/," /usr/share/OGAgent/cfg/ogagent.cfg
  - Puede ser necesario corregir permisos antes de iniciar el servicio:
	chmod +x /etc/init.d/ogagent
  - Iniciar el servicio (se iniciará automáticamente en el proceso de arranque):
	service ogagent start

- OpenSuSE:
	(en preparación)

- Windows (como usuario administrador):
  - Descargar e instalar el agente ejecutando:
	OGAgentSetup-Version.exe
  - Seguir las instrucciones del instalador.
  - 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.
  - Iniciar el servicio (se iniciará automáticamente en el proceso de arranque):
	NET START OGAgent

- macOS:
  - Instalar dependencias:
	sudo easy_install pip
	sudo pip install netifaces requests six
  - Descargar e instalar el agente:
	sudo installer -pkg OGAgentInstaller-Version.pkg -target /
  - Descargar el paquete y usar Finder pulsando sobre el fichero para instalarlo.
  - Configurar el agente:
	sed -i "0,/remote=/ s,remote=.*,remote=https://IPServidorOpenGnsys/opengnsys/rest/," /Applications/OGAgent.app/cfg/ogagent.cfg
  - Iniciar el servicio (se iniciará automáticamente en el proceso de arranque):
	sudo ogagent start


Postconfiguración para clientes clonados
----------------------------------------
- Ejecutar manualmente o configurar automáticamente OGAgent en los clientes clonados
en el script de postconfiguración tras restuarar imagen:
	ogConfigureOgagent NDisco Npart