wiki:DocumentacionUsuario1.0.5/Instalacion

Version 1 (modified by mgrondona, 10 years ago) (diff)

Agregada la información, falta dar formato.

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