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


Requisitos de creación
----------------------
Sisitema operativo Linux con los siguientes paquetes instalados:
- Subversion
- Python, librerías PyQt4
- 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:
	cd src
	./update.sh
	cd ..

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

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

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

- Subir los nuevos ficheros .deb, .rpm y .exe generados en el 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:
  - 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
  - Descargar e instalar el agente:
	sudo dpkg -i 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
  - Puede ser necesario activar descargas desde cualquier sitio en Menú /
Preferencias del sistema / Seguridad y privacidad / Pestaña General.
  - 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:
	ogConfigureOsAgent NDisco Npart


