Changes between Version 72 and Version 73 of ManualInstalacion

Timestamp:

Jun 28, 2011, 2:32:23 PM (13 years ago)

Author:

ramon

Comment:

Instalación, actualización y desinstalación de OpenGnSys 1.0.1

ManualInstalacion

@@ -6 +6 @@
 == Notas iniciales ==
 
-Actualmente, [http://www.opengnsys.es/ OpenGnSys Server] solo debe ser instalado sobre una distribución GNU/Linux Ubuntu (a partir de la versión 9.04), aunque se recomienda utilizar la versión Ubuntu 10.04 LTS Server, tanto de 32 como de 64 bits (también se ha probado la instalación sobre un versión Ubuntu Desktop).
-
-
-Esta página está estructurada de la siguiente manera:
-
-* Instalación de Opengnsys desde un scripts.
-* Instalación de !OpenGnsys desde un tar.gz
-* Configuración Inicial
-* Actualización de Opengnsys.
-* Desistalación de !OpenGnsys.
-* Información extra de los servicios de red usados por !OpenGnsys.
-* Configuración del proxy (http y svn) en entornos en que se requiera.
+Actualmente, [http://www.opengnsys.es/ OpenGnSys Server] solo debe ser instalado sobre una distribución GNU/Linux Ubuntu (a partir de la versión 9.04), aunque se recomienda utilizar la versión Ubuntu 10.04 LTS Server, tanto de 32 como de 64 bits (también se ha probado la instalación en versión de Ubuntu 10.10 y 11.04, además de en distribuciones Ubuntu Desktop).
+
 
 == Versión a Instalar ==
 
-La '''versión''' actual '''aconsejada'''  es la '''versión 1.0 ''' desde el  scripts de instalación que se indica en el apartado de "Script de instalación"
-
+La '''versión''' actual '''aconsejada'''  es la '''versión 1.0.1''' y se recomienda utilizar el script de instalación (ver apartado "Script de instalación").
 
 
@@ -30 +19 @@
  * 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, obbviando el script de instalación e instalando componente a componente.
+ * 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 scripts, revisa la información al final de este documento para activar el uso de subversión con proxy.
+
+''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.
 
  
-La versión del trunk (1.0) sólo se puede instalar ejecutando el scripts de instalación automática opengnsys_installer.sh que se indican seguidamente.
- 1. '''Ejemplos de descarga.'''
-
-   * Ejemplos de descarga del script de la versión 1.0 
-     a. Descargar con wget la versión 1.0
+ 1. '''Descargar el script de instalación'''
+
+   * Ejemplos de descarga del script.
+     a. Descargar con wget:
    {{{
 wget http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh
 }}}
-     a. Descargar con curl la version 1.0
+     a. Descargar con curl:
    {{{
 curl http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh
 }}}
-     a. Descargar con un navegador web: pulsar en el enlace siguiente y guardar el archivo con el nombre {{{opengnsys_installer.sh}}}
-[http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt]
+     a. Descargar con un navegador web: pulsar en el enlace [http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt] y guardar el archivo con el nombre {{{opengnsys_installer.sh}}}
+
  
  2. '''Configuración básica'''
@@ -62 +51 @@
  3. '''Proceso de instalación'''
    a. Ejecutar el script como usuario {{{root}}}:
-{{{
+   {{{
 sudo bash opengnsys_installer.sh
 }}}
@@ -70 +59 @@
 === 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/browser/tags] y descargar el fichero ''{{{opengnsys-Versión.tar.gz}}}'' de la revisión deseada.
+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}}}
@@ -96 +85 @@
 
    1. Revise los ficheros de configuraciones.
-         1. /opt/opengnsys/etc/ogAdmServer.cfg
-         2. /opt/opengnsys/etc/ogAdmRepo.cfg
-         3. /opt/opengnsys/client/etc/ogAdmClient.cfg
-         4. /opt/opengnsys/www/controlacceso.php 
-   2. Revise la exportación de ficheros por NFS (por defecto sólo se permite el acceso a los clientes de la misma subred del servidor)
-         1. /etc/exports 
-   3. Configure el servidor de DHCP y reinicie el servicio.
+         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. Usuario: usuog y como Password: passusuog
+         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. Usuario: opengnsys y como Password: opengnsys
-         2. Revise lo que se refiere a Servidores->Servidor OpenGnSys (Default), que tenga puesta la IP del servidor correctamente.
-         3. Si cambia la configuración reinicie el servidor: sudo /etc/init.d/opengnsys restart 
+         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}}}
 
 
@@ -115 +104 @@
 == Actualizar [http://www.opengnsys.es/ OpenGnSys] ==
 
-Puede utilizarse el script [browser:trunk/installer/opengnsys_update.sh opengnsys_update.sh] para realizar la actualización de los ficheros del proyecto a la última revisión en desarrollo. Sin embargo, dicho script no ejecuta modificaciones en la base de datos ni recompila los servicios, debiendo realizar estas operaciones "a mano".
-
-El proceso automático para actualizar es:
- 1. Descargar el script de actualización directamente de la dirección: [http://www.opengnsys.es/browser/trunk/installer/opengnsys_update.sh?format=txt]
- 1. Ejecutar el script tecleando: {{{sudo ./opengnsys_update.sh}}} (se requiere acceso a Internet).
-
-Para completar la actualización en los casos especiales de que se modifique la estructura de la base de datos o sea necesario recompilar algún servicio, deben seguirse los pasos:
- 1. Descargar el repositorio de código ejecutando: {{{svn checkout http://www.opengnsys.es/svn/trunk opengnsys}}}
- 2. Revisar y modificar (en su caso) el fichero de creación de la base de datos y aplicar los cambios.
- 3. Revisar los directorios de los distintos servicios y (si fuese necesario) recompilar, copiar los ejecutables y reiniciar los servicios.
- 
-== Desinstalando [http://www.opengnsys.es/ OpenGnSys] ==
-
-Se ha creado el script [browser:trunk/installer/opengnsys_uninstall.sh opengnsys_uninstall.sh] para realizar la desinstalación del Proyecto OpenGnSys. Por lo tanto, para desinstalar realizar los siguientes pasos.
- 1. Hacer copia de seguridad de la base de datos SQL.
- 1. Descargar el script de desinstalación directamente de la dirección: [http://www.opengnsys.es/browser/trunk/installer/opengnsys_uninstall.sh?format=txt]
- 1. Editar el script y modificar los valores de las variables que configuran el acceso a la base de datos.
- 1. Ejecutar el script: {{{sudo ./opengnsys_uninstall.sh}}}
- 1. Parar los servicios auxiliares que dejen de ser necesarios (DHCP, PXE, NFS, Apache, MyQSL).
- 1. El programa de desinstalación no elimina las imágenes creadas, por lo tanto, si se considera necesario, debe borrarse manualmente el directorio {{{/opt/opengnsys/images}}}
+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 ===
+=== Servicio DHCP externo ===
 
  1. En el servidor DHCP externo: