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


Ignore:
Timestamp:
May 6, 2014, 9:22:21 PM (8 years ago)
Author:
mgrondona
Comment:

Agregada la información, falta dar formato.

Legend:

Unmodified
Added
Removed
Modified
  • DocumentacionUsuario1.0.5/Instalacion

    v1 v1  
     1= Instalación =
     2
     3== Obtener el sistema ==
     4
     5El 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.
     6
     7Para 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.
     8
     9=== Descargar fichero tar.gz de OpenGnSys ===
     10
     111) Actualizar los repositiorios de paquetes
     12
     13''ogAdministrator# sudo apt-get update''
     14
     152) Instalar los programas de descarga.
     16La 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
     17 
     18''ogAdministrator# sudo apt-get install wget subversion''
     19
     20
     213) Comprobamos la última revisión estable del programa.
     22
     23''ogAdministrator#  svn info http://opengnsys.es/svn/trunk''
     24
     254) Descarga y descompresión del código del OpenGnSys Server versión 1.0.5rc1.
     26
     27''ogAdministrator#  cd /tmp''
     28
     29''ogAdministrator#  wget -c http://www.opengnsys.es/downloads/opengnsys-1.0.5-rc1-r4258-install-oglive-1.0.4.tar.gz ''
     30
     31''ogAdministrator#  tar xvzf opengnsys-1.0.5-rc1-r4258-install-oglive-1.0.4.tar.gz''
     32
     33''ogAdministrator#  cd opengnsys/installer''
     34
     35== Instalación ==
     36
     37=== Configuración de la instalación ===
     38
     39Como medida de seguridad, resulta muy importante modificar los usuarios y claves por defecto de acceso al sistema. 
     40
     41Aunque 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.
     42
     43El fichero de instalación se puede localizar, tras las instrucciones del apartado anterior, en /tmp/opengnsys/installer/opengnsys_installer.sh
     44
     45''ogAdministrator# sudo vi /tmp/opengnsys/installer/opengnsys_installer.sh''
     46
     47
     48Los valores de las variables de configuración que permiten su modificación cd son:
     49
     50MYSQL_ROOT_PASSWORD: clave del usuario root de MySQL.
     51
     52OPENGNSYS_DB_USER: usuario de acceso y super-administrador de OpenGnSys.
     53
     54OPENGNSYS_DB_PASSWD: clave del usuario de administración.
     55
     56OPENGNSYS_CLIENT_PASSWD: clave de acceso del cliente a servicios remotos.
     57
     58
     59
     60=== Ejecutar la instalación ===
     61
     62Ejecutar el script opengnsys_installer.sh para realizar el proceso de instalación estándar de OpenGnSys:
     63''
     64ogAdministrator#  sudo bash /tmp/opengnsys/installer/opengnsys_installer.sh''
     65
     66OpenGnSys Installer realiza los siguientes pasos:
     67
     68Guarda un histórico de operaciones en el archivo /tmp/opengnsys_installation.log
     69Descarga las dependencias del sistema operativo, si es necesario.
     70Crea la estructura de directorios de OpenGnSys bajo el directorio /opt/opengnsys
     71Hace una configuración por defecto de los servicios del sistema.
     72Genera la documentación de la API de programación.
     73Instala la imagen de cliente.
     74Compila, instala y arranca los servicios de OpenGnSys.
     75Muestra un resumen de la instalación.
     76
     77El siguiente ejemplo presenta la salida de la orden para comprobar la estructura de directorios creada por OpenGnSys Installer.
     78
     79''$ ls -l /opt/opengnsys''
     80
     81total 36
     82
     83drwxr-xr-x  2 root root      4096 jul 10 10:55 bin
     84
     85drwxr-xr-x 10 root root      4096 jul 10 10:56 client
     86
     87drwxr-xr-x  2 root root      4096 jul 10 10:56 doc
     88
     89drwxr-xr-x  2 root root      4096 jul  5 16:28 etc
     90
     91drwxrwxr-x  5 root opengnsys 4096 jun 28 09:46 images
     92
     93drwxr-xr-x  2 root root      4096 jul 10 10:56 lib
     94
     95drwxr-xr-x  4 root root      4096 jul 10 10:55 log
     96
     97drwxr-xr-x  2 root root      4096 jul 10 10:56 sbin
     98
     99lrwxrwxrwx  1 root root        17 jul  4 13:38 tftpboot -> /var/lib/tftpboot
     100
     101drwxr-xr-x 16 root root      4096 jul 10 10:56 www
     102
     103
     104Para comprobar la versión de la aplicación instalada:
     105
     106''ogAdministrator# cat /opt/opengnsys/doc/VERSION.txt''
     107
     108Crear una copia del log de la instalación.
     109
     110''ogAdministrator#  sudo cp /tmp/opengnsys_installation.log /root/''
     111
     112
     113=== Configuración por defecto ===
     114
     115El 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.
     116
     117OpenGnSys Installer realiza la siguiente configuración por defecto para los servicios del sistema:
     118
     119* 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”).
     120* 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.
     121* Genera una serie de plantillas por defecto para el servicio de arranque por PXE.
     122* Configura los servicios de la interfaz de administración web.
     123* Prepara el sistema de archivos Samba utilizado por OpenGnSys Repository.
     124* Genera ficheros auxiliares del Cron para gestión automática.
     125
     126Asimismo, también se genera la siguiente configuración por defecto para la interfaz OpenGnSys Web Administrator:
     127
     128* Usuario y clave del súper-administrador definidos en la edición del script de instalación.
     129* Crea una Universidad (Organización) por defecto constituida por una Unidad Organizativa por defecto, permitiendo el acceso al usuario predefinido.
     130* Se definen los datos del servidor y del repositorio por defecto.
     131
     132=== Ficheros de configuración de OpenGnSys ===
     133
     134OpenGnSys 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:
     135
     136OpenGnSys Server: /opt/opengnsys/etc/ogAdmServer.cfg
     137
     138OpenGnSys Repository: /opt/opengnsys/etc/ogAdmRepo.cfg
     139
     140OpenGnSys Cron Agent: /opt/opengnsys/etc/ogAdmAgent.cfg
     141
     142OpenGnSys Client: /opt/opengnsys/client/etc/ogAdmClient.cfg
     143
     144OpenGnSys Web Administrator: /opt/opengnsys/www/controlacceso.php
     145
     146El 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):
     147
     148''$ sudo cat /opt/opengnsys/etc/ogAdmServer.cfg''
     149
     150ServidorAdm=192.168.2.10
     151
     152PUERTO=2008
     153
     154USUARIO=usuarioadministrador
     155
     156PASSWORD=claveadministrador
     157
     158datasource=localhost
     159
     160CATALOG=ogAdmBD