Changes between Initial Version and Version 1 of DocumentacionUsuario1.0.5/Instalacion

Timestamp:

May 6, 2014, 9:22:21 PM (10 years ago)

Author:

mgrondona

Comment:

Agregada la información, falta dar formato.

DocumentacionUsuario1.0.5/Instalacion

@@ +1 @@
+= Instalación =
+
+== Obtener el sistema ==
+
+El sistema OpenGnSys puede descargarse completamente en un fichero comprimido con formato tar.gz o bien solo obtener el programa de instalación que descargará todos los ficheros necesarios. Asimismo, desde la versión 1.0.4 es posible descargar previamente la imagen ISO que se envía al cliente en el proceso de arranque.
+
+Para hacer más cómodo y rápido el proceso de instalación del servidor OpenGnSys en este curso, se explicará el primer método indicado. Es decir, se descargará la aplicación OpenGnSys en formato tar.gz para posteriormente ejecutar el instalador, el cual se encargará de instalar las dependencias del sistema operativo, así como la descarga de la imagen ISO que contiene el cliente de OpenGnSys. 
+
+=== Descargar fichero tar.gz de OpenGnSys ===
+
+1) Actualizar los repositiorios de paquetes
+
+''ogAdministrator# sudo apt-get update''
+
+2) Instalar los programas de descarga.
+La aplicación de OpenGnSys se distribuye desde Internet, por lo tanto es necesario instalar previamente en el ogAdministrator alguna herramienta de descarga: se propone la herramienta Wget y las utilidades Subversion 
+ 
+''ogAdministrator# sudo apt-get install wget subversion''
+
+
+3) Comprobamos la última revisión estable del programa.
+
+''ogAdministrator#  svn info http://opengnsys.es/svn/trunk''
+
+4) Descarga y descompresión del código del OpenGnSys Server versión 1.0.5rc1.
+
+''ogAdministrator#  cd /tmp''
+
+''ogAdministrator#  wget -c http://www.opengnsys.es/downloads/opengnsys-1.0.5-rc1-r4258-install-oglive-1.0.4.tar.gz ''
+
+''ogAdministrator#  tar xvzf opengnsys-1.0.5-rc1-r4258-install-oglive-1.0.4.tar.gz''
+
+''ogAdministrator#  cd opengnsys/installer''
+
+== Instalación ==
+
+=== Configuración de la instalación ===
+
+Como medida de seguridad, resulta muy importante modificar los usuarios y claves por defecto de acceso al sistema.  
+
+Aunque en este curso básico de OpenGnSys se usarán los valores por defecto, se recomienda visualizar el archivo de instalación y analizar los valores de las variables de configuración que se encuentran al principio del código.  Esta recomendación se realizada debido a que en una instalación en entornos en producción se deberá editar estas variables por seguridad.
+
+El fichero de instalación se puede localizar, tras las instrucciones del apartado anterior, en /tmp/opengnsys/installer/opengnsys_installer.sh
+
+''ogAdministrator# sudo vi /tmp/opengnsys/installer/opengnsys_installer.sh''
+
+
+Los valores de las variables de configuración que permiten su modificación cd son:
+
+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 de administración.
+
+OPENGNSYS_CLIENT_PASSWD: clave de acceso del cliente a servicios remotos.
+
+
+
+=== Ejecutar la instalación ===
+
+Ejecutar el script opengnsys_installer.sh para realizar el proceso de instalación estándar de OpenGnSys:
+''
+ogAdministrator#  sudo bash /tmp/opengnsys/installer/opengnsys_installer.sh''
+
+OpenGnSys Installer realiza los siguientes pasos:
+
+Guarda un histórico de operaciones en el archivo /tmp/opengnsys_installation.log
+Descarga las dependencias del sistema operativo, si es necesario.
+Crea la estructura de directorios de OpenGnSys bajo el directorio /opt/opengnsys
+Hace una configuración por defecto de los servicios del sistema.
+Genera la documentación de la API de programación.
+Instala la imagen de cliente.
+Compila, instala y arranca los servicios de OpenGnSys.
+Muestra un resumen de la instalación.
+
+El siguiente ejemplo presenta la salida de la orden para comprobar la estructura de directorios creada por OpenGnSys Installer.
+
+''$ ls -l /opt/opengnsys''
+
+total 36
+
+drwxr-xr-x  2 root root      4096 jul 10 10:55 bin
+
+drwxr-xr-x 10 root root      4096 jul 10 10:56 client
+
+drwxr-xr-x  2 root root      4096 jul 10 10:56 doc
+
+drwxr-xr-x  2 root root      4096 jul  5 16:28 etc
+
+drwxrwxr-x  5 root opengnsys 4096 jun 28 09:46 images
+
+drwxr-xr-x  2 root root      4096 jul 10 10:56 lib
+
+drwxr-xr-x  4 root root      4096 jul 10 10:55 log
+
+drwxr-xr-x  2 root root      4096 jul 10 10:56 sbin
+
+lrwxrwxrwx  1 root root        17 jul  4 13:38 tftpboot -> /var/lib/tftpboot
+
+drwxr-xr-x 16 root root      4096 jul 10 10:56 www
+
+
+Para comprobar la versión de la aplicación instalada:
+
+''ogAdministrator# cat /opt/opengnsys/doc/VERSION.txt''
+
+Crear una copia del log de la instalación.
+
+''ogAdministrator#  sudo cp /tmp/opengnsys_installation.log /root/''
+
+
+=== Configuración por defecto ===
+
+El script de instalación realiza una configuración por defecto para los servicios principales del sistema. Se recomienda revisar los parámetros generados, para poder personalizar la configuración de los módulos del sistema.
+
+OpenGnSys Installer realiza la siguiente configuración por defecto para los servicios del sistema:
+
+* Configura y activa OpenGnSys Server, OpenGnSys Repository y OpenGnSys Cron Agent en el propio servidor con la IP de la primera interfaz de red (normalmente “eth0”).
+* Configura el servicio DHCP estático utilizando los parámetros de la primera interfaz de red (eth0), indica que el servidor de arranque será la propia máquina y crea un ejemplo de patrón para editar los datos necesarios para cada cliente.
+* Genera una serie de plantillas por defecto para el servicio de arranque por PXE.
+* Configura los servicios de la interfaz de administración web.
+* Prepara el sistema de archivos Samba utilizado por OpenGnSys Repository.
+* Genera ficheros auxiliares del Cron para gestión automática.
+
+Asimismo, también se genera la siguiente configuración por defecto para la interfaz OpenGnSys Web Administrator:
+
+* Usuario y clave del súper-administrador definidos en la edición del script de instalación.
+* Crea una Universidad (Organización) por defecto constituida por una Unidad Organizativa por defecto, permitiendo el acceso al usuario predefinido.
+* Se definen los datos del servidor y del repositorio por defecto.
+
+=== Ficheros de configuración de OpenGnSys ===
+
+OpenGnSys consta actualmente de un fichero de configuración para cada componente del sistema, lo que posibilita su distribución en varias máquinas. Los datos de configuración son muy comprensibles y se localizan en los siguientes ficheros de texto:
+
+OpenGnSys Server: /opt/opengnsys/etc/ogAdmServer.cfg
+
+OpenGnSys Repository: /opt/opengnsys/etc/ogAdmRepo.cfg
+
+OpenGnSys Cron Agent: /opt/opengnsys/etc/ogAdmAgent.cfg
+
+OpenGnSys Client: /opt/opengnsys/client/etc/ogAdmClient.cfg
+
+OpenGnSys Web Administrator: /opt/opengnsys/www/controlacceso.php
+
+El siguiente ejemplo muestra el fichero ogAdmServer.cfg con la configuración de OpenGnSys Server por defecto para el presente curso (nótese que se utiliza el valor recomendado para la dirección IP del servidor):
+
+''$ sudo cat /opt/opengnsys/etc/ogAdmServer.cfg''
+
+ServidorAdm=192.168.2.10
+
+PUERTO=2008
+
+USUARIO=usuarioadministrador
+
+PASSWORD=claveadministrador
+
+datasource=localhost
+
+CATALOG=ogAdmBD