[[TranslatedPages]]
[[TOC(heading=Índice)]]

= Instalación de OpenGnSys Server =

== Notas iniciales ==

En primer lugar se debe '''revisar la [wiki:CompatibilidadInstalacionServer lista de compatibilidad para instalación de OpenGnSys Server]''' para comprobar las distribuciones GNU/Linux compatibles con la versión de [http://www.opengnsys.es/ OpenGnSys Server] que se desea instalar.


== Versión a Instalar ==

La '''versión''' actual '''aconsejada''' es '''OpenGnSys 1.0.4a''' y está disponible para descarga el fichero comprimido [download:opengnsys-1.0.4a-r3386.tar.gz]


== Formas de instalación ==

Hay tres maneras básicas de instalación de [http://www.opengnsys.es/ OpenGnSys]:
 * Ejecutar el script de instalación, el cual hace uso de Subversion para descargar la aplicación.
 * A partir de un fichero comprimido tipo {{{tar.gz}}} con la aplicación completa.
 * Instalación manual paso a paso, obviando el script de instalación e instalando componente a componente.

Tras la instalación es conveniente repasar la [wiki:ManualInstalacionOpenGNSys#Configuraci%C3%B3nInicial configuración inicial], especialmente si se modifica la IP el servidor OpenGnSys.

=== Script de instalación ===

''NOTA'': Si usas proxy para el acceso a Internet, antes de ejecutar el script, revisa la información al final de este documento para activar el uso de Subversión con proxy.


 1. '''Descargar el script de instalación'''

   * Ejemplos de descarga del script.
     a. Descargar con wget:
   {{{
wget http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
}}}
     a. Descargar con curl:
   {{{
curl http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh
}}}
     a. Descargar con un navegador web: pulsar en el enlace [http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh] y guardar el archivo con el nombre {{{opengnsys_installer.sh}}}

 2. '''Configuración básica'''
   a. Como medida de seguridad, resulta '''muy importante''' modificar los usuarios y claves por defecto de acceso al sistema. Para ello, editar el fichero de instalación {{{opengnsys_installer.sh}}} y modificar los valores de las variables de configuración:
     * {{{MYSQL_ROOT_PASSWORD}}} - clave del usuario {{{root}}} de MySQL.
     * {{{OPENGNSYS_DB_USER}}} - usuario de acceso y super-administrador de OpenGnSys.
     * {{{OPENGNSYS_DB_PASSWD}}} - clave del usuario.
     * {{{OPENGNSYS_CLIENT_PASSWD}}} - clave de acceso del cliente a servicios remotos.

 3. '''Proceso de instalación'''
   a. Ejecutar el script como usuario {{{root}}}:
   {{{
sudo bash opengnsys_installer.sh
}}}

 4. '''Revisar los ficheros de configuración.'''

=== Instalación desde un tar.gz ===

Para instalar una determinada revisión de OpenGnSys, debe descargarse el fichero comprimido] con el contenido de dicha versión y realizar los siguientes pasos:
 1. Acceder a [http://www.opengnsys.es/downloads] y descargar el fichero ''{{{opengnsys-Versión.tar.gz}}}'' de la revisión deseada.
 2. Descomprimir el fichero, ejecutando: {{{tar xvzf }}}''{{{opengnsys-Versión.tar.gz}}}''
 3. Cambiar al subdirectorio del instalador, ejecutando: {{{cd opengnsys/installer}}}
 4. Como medida de seguridad, resulta '''muy importante''' modificar los usuarios y claves por defecto de acceso al sistema. Para ello, editar el fichero de instalación {{{opengnsys_installer.sh}}} y modificar los valores de las variables de configuración:
     * {{{MYSQL_ROOT_PASSWORD}}} - clave del usuario {{{root}}} de MySQL.
     * {{{OPENGNSYS_DB_USER}}} - usuario de acceso y super-administrador de OpenGnSys.
     * {{{OPENGNSYS_DB_PASSWD}}} - clave del usuario.
     * {{{OPENGNSYS_CLIENT_PASSWD}}} - clave de acceso del cliente a servicios remotos.
 5. Ejecutar el script de instalación como usuario {{{root}}}:
   {{{
sudo bash opengnsys_installer.sh
}}}
   '''Nota:''' En algunos entornos privados es necesario configurar el proxy de conexión para ejecutar el instalador, en tal caso ejecutar:
   {{{
http_proxy="http://IPProxy:PuertoProxy" sudo bash opengnsys_installer.sh
}}}
 6. Revisar los ficheros de configuración.

=== Instalación manual paso a paso ===

Para conocer en detalle todos los procesos que realizan los scripts para la instalación manual del sistema [http://www.opengnsys.es OpenGnSys] ver en [wiki:InstalacionManual Instalación Manual]

== Configuración Inicial ==

   1. Revise los ficheros de configuraciones.
         1. {{{/opt/opengnsys/etc/ogAdmServer.cfg}}} - configuración de OpenGnSys Server
         2. {{{/opt/opengnsys/etc/ogAdmRepo.cfg}}} - configuración de OpenGnSys Repository
         3. {{{/opt/opengnsys/etc/ogAdmAgent.cfg}}} - configuración de OpenGnSys Agent
         4. {{{/opt/opengnsys/client/etc/ogAdmClient.cfg}}} - configuración de OpenGnSys Client
         5. {{{/opt/opengnsys/www/controlacceso.php}}} - configuración de OpenGnSys Web Admin Console
   2. Configure el servidor de DHCP y reinicie el servicio.
   3. Opcionalmente, revise la configuración de Samba en el directorio {{{/etc/samba}}}
   4. Entre como Administrador en la consola web del servidor.
         1. Utilice el usuario y clave establecidos en el instalador para acceso a la base de datos (variables {{{OPENGNSYS_DB_USER}}} y {{{OPENGNSYS_DB_PASSWD}}}).
         2. Revise la organización que está configurada por defecto y el usuario por defecto. 
   5. Entre como un usuario en la consola web del servidor.
         1. Utilice el usuario y la clave que haya configurado como administrador de la Unidad Organizativa correspondiente.
         2. Revise que el dato de IP del servidor es correcto en la sección "Servidores->Servidor OpenGnSys (Default)".
         3. Si cambia la configuración, reinicie el servidor: {{{sudo /etc/init.d/opengnsys restart}}}



== Actualizar [http://www.opengnsys.es/ OpenGnSys] ==

Desde la versión 1.0.1 se dispone de un script de auto-actualización del sistema, con las siguientes características:
 * Es necesario conexión a Internet para obtener las últimas actualizaciones.
 * No se actualizan los servicios asociados al sistema operativo.
 * No se modifican los ficheros de configuración.

Para realizar la actualización, el script debe ser ejecutado como usuario root:
 {{{
sudo /opt/opengnsys/lib/opengnsys_update.sh
}}}

Si el script se actualiza a sí mismo, pedirá automáticamente que vuelva a ser ejecutado para terminar de actualizar todo el sistema.


== Desinstalar [http://www.opengnsys.es/ OpenGnSys] ==

Asimismo, desde la versión 1.0.1 también existe un script de desinstalación de los componentes de OpenGnSys, con las siguientes características:
 * Se eliminan los ficheros de OpenGnSys y su base de datos.
 * No se eliminan ni paquetes del sistema operativo ni sus ficheros de configuración.
 * No se elimina el directorio de las imágenes {{{/opt/opengnsys/images}}}, ni su contenido.

Para realizar la desinstalación, ejecutar el script como usuario root:
 {{{
sudo /opt/opengnsys/lib/opengnsys_uninstall.sh
}}}

'''Nota:''' para poder recuperar los datos, se recomienda realizar copia de seguridad de los ficheros del sistema y de la base de datos antes de ejecutar la desinstalación.



== Configuración de OpenGnSys para usar servicios externos ==

=== Servicio DHCP externo ===

Desde la versión 1.0.2 de OpenGnSys se utiliza por defecto Grub4Dos en vez PXELinux para realizar el proceso de arranque de los clientes. Incluir las siguientes líneas para configurar el servicio DHCP con Grub4Dos.
{{{
# habilitamos la transferencia del nombre por dhcp.
use-host-decl-names on;
# asignamos el servicio pxe con:
next-server ip_opengnsys;
filename  "grldr";
}}}

Si deseamos que convivan dos o más servidores, por ejemplo uno en producción y otro en pruebas o incluso OpenGnSys con "otro" podemos indicarlo con diferentes líneas nex-server en diferentes grupos respectivamente. Cambiar el servidor de un cliente es tan fácil como hacer un cut/paste de los datos del cliente de un grupo a otro. 
{{{
group {
   next-server [ip_servidor_1];
   host pc1 {
      option host-name "xxx.es";
      hardware ethernet xx:xx:xx:xx:xx:xx;
      fixed-address xxx.xxx.xxx.xxx;
      filename "grldr";
   }
   host pc2 ....
 }
group {
   next-server [ip_servidor_2];
   host pc3 {
      option host-name "xxx.es";
      hardware ethernet xx:xx:xx:xx:xx:xx;
      fixed-address xxx.xxx.xxx.xxx;
      filename "grldr";
   }
   host pc4 ...
 }
}}}

En caso de querer seguir utilizando PXELinux, debe sustituirse la cláusula {{{filename}}} para configurar DHCP con PXELinux, como se indica a continuación:
{{{
filename  "pxelinux.0";
}}}
Asimismo, para mantener la compatibilidad con PXELinux, el servidor de la Consola de Administración Web debe hacer referencia al proceso adecuado de gestión de arranque, incluyendo el siguiente enlace simbólico:
{{{
sudo ln -fs /opt/opengnsys/www/principal/boot_pxelinux.php boot.php
}}}


== Cambio de dirección IP de OpenGnSys Server ==

A partir de la versión OpenGnSys 1.0.3, se dispone de un script de administración para automatizar el proceso de cambio de dirección IP del módulo !OpenGnSys Server en máquinas con varias interfaces de red.

Para realizar el cambio de IP de OpenGnSys Server, ejecutar el script {{{setserveraddr}}} desde una terminal del servidor:
 {{{
sudo /opt/opengnsys/bin/setserveraddr InterfazRed
}}}

Siendo el parámetro {{{InterfazRed}}} el nombre de la interfaz de red que tiene asignada la IP deseada (por ejemplo: {{{eth0}}}, {{{eth1}}}). Para obtener los datos de interfaces de red activas y sus direcciones IP asociadas, ejecutar la orden:
 {{{
sudo ifconfig
}}}

En caso de que sea necesario modificar la dirección IP del repositorio por defecto, debe accederse a la consola de administración web de OpenGnSys para modificar algunos parámetros de configuración.
 1. Modificar dirección IP del repositorio.
    Pulsar en el botón Servidores, botón derecho sobre el nombre del repositorio, elegir Propiedades, modificar el campo Dirección IP y pulsar el botón Aceptar.
 1. Forzar la configuración de arranque remoto en los laboratorios afectados por el cambio de repositorio.
    Pulsar el botón Aulas, botón derecho sobre el nombre de aula, elegir la opción Netboot avanzado y pulsar sobre el botón Guardar.


== Configurando la conectividad http y svn en entornos que lo necesiten ==

* Exportamos la variable que identifica al proxy a usar.
{{{
export http_proxy="http://proxy.xxx.es:puerto"
}}}

* Comprobamos el uso del proxy, instalando el paquete subversion y wget, con el comando:   
{{{
apt-get update
apt-get install subversion wget
}}}

* Configuramos el subversion para que utilice también el proxy.
{{{
vi /etc/subversion/servers
#editamos la sección [global], en la linea 142, para que quede como:

[global]

http-proxy-host = proxy.xxx.es

http-proxy-port = 3128

http-timeout = 10

# nota: no debe haber ninguna línea comentada entre [global] y el http-proxy-host 
# nota: no debe haber espacios en blanco ni tabuladores delante de http-proxy-host

}}}


== Opcional: Eliminando el servicio php cron del ubuntu server ==

Eliminar el fichero /etc/cron.d/php5



== Propuesta instalación de componentes (en preparación) ==

Se propone modificar el programa de instalación para automatizar el proceso de los 2 componentes principales del Proyecto OpenGnSys. El formato del script de instalación {{{opengnsys-installer.sh }}} puede ser:
   {{{
opengnsys_installer.sh [ all | server | repo IPServidor DistribuciónCliente ]
   }}}

Siendo los parámetros:
 * '''{{{server}}}''' - que incluye los servicios:
   * Servidor OpenGnSys (ogAdmServer, ogAdmAgent)
   * Condola web (Apache, MySQL, páginas web)
   * Arranque (DHCP, TFTP, generador del cliente)
 * '''{{{repo}}}''' - que incluye los servicios:
   * Servidor de repositorio (ogAdmRepo)
   * Servidor de ficheros (NFS)
   * Componentes del Cliente OpenGnSys
   * Necesita conocer la IP del servidor principal y el tipo de distribución de Ubuntu que será usado en los clientes.
 * '''{{{all}}}''' - instalación compacta en la misma máquina (valor opcional y por defecto).