wiki:En:ManualInstalacionOpengnsys

Version 18 (modified by paqui, 12 years ago) (diff)

--

TOC?

OpenGnSys Server Installation Manual

Note

It is assumed OpenGnSys Server will be installed in a GNU/Linux distro, Ubuntu 10.04 Server LTS.

The scripts and installation files OpenGnSys components are available in OpenGnSys Installer.

Check the OpenGnSys Server installation compatibility list.

Install Version

The current version is version 1.0.2 and it is recommended using the installation script (see "Installation Script").

Installation Methods

There are three basic ways OpenGnSys installation:

  • Installation script. Which uses Subversion to download the application.
  • Starting from a tar.gz This application is now complete.
  • Installation step by step manual. It is obvious the installation script and install each component.

After installation is helpful to review the init configuration?. Especially important if we change the server IP OpenGnSys.

Installation Script

NOTE: Before running the script, if you uses a proxy for Internet access, it is recommended review the information at the end of this document to enable the use of Subversion with proxy.

OpenGnSys installation is done by running the installation script opengnsys_installer.sh, which can be downloaded directly from http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh

  1. Download the script. Examples with various tools:
    1. Download with wget.
         wget http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
      
    2. Download with curl.
         curl http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh
      
    3. Download with a web browser. Click on the link http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh and save the file as opengnsys_installer.sh
  1. Basic Configuration
    1. For security reasons, it is very important modify defaults users and passwords to access to the system. For this, edit the installation file opengnsys_installer.sh and change the values of configuration variables:
      • MYSQL_ROOT_PASSWORD - MySQL user password root.
      • OPENGNSYS_DB_USER - OpenGnSys access user and OpenGnsys super-user.
      • OPENGNSYS_DB_PASSWD - User password.
      • OPENGNSYS_CLIENT_PASSWD - Remote services password client.
  1. Installation process.
    1. Recommended change the users and default passwords by editing 'opengnsys_installer.sh' file. Search variables MYSQL_ROOT_PASSWORD, OPENGNSYS_DB_USER, OPENGNSYS_DB_PASSWD and OPENGNSYS_CLIENT_PASSWD. Change the values you want.
    2. The script must be run as root:
         sudo bash opengnsys_installer.sh
      
  1. Check the configuration files.

Installation from tar.gz

  1. If we do not have access to Subversion, i.e., we are behind a proxy, we will have to download the package tgz from the web.
    1. Access to http://www.opengnsys.es/browser/tags
    2. Window will be open, informing you can not see the package, only download.
  2. Load it on the server where we will install it.
  3. Descompress the file tar.gz (tar zxvf name_of_file.tar.gz).
  4. Change the name of subdirectory to opengnsys.
  5. Create the subdirectory opengnsys_installer at /tmp.
  6. Move the subdirectory opengnsys to /tmp/opengnsys_installer.
  7. Change to user root sudo su
  8. Setting proxy to server. i.e.: export http_proxy="http://proxy.us.es:3128"
  9. We recommended change the users and passwords by default editing the installer opengnsys_installer.sh. Find the variables MYSQL_ROOT_PASSWORD, OPENGNSYS_DB_USER, OPENGNSYS_DB_PASSWD, and OPENGNSYS_CLIENT_PASSWD. Change to desired values.
  10. Run the script /tmp/opengnsys_installer/opengnsys/installer/opengnsys_installer.sh

Manual Installation step by step

For details of all the processes performed by the scripts for manual installation of the system OpenGnSys see Manual Installation

Init Configuration

  1. Check config files.
    1. /opt/opengnsys/etc/ogAdmServer.cfg - OpenGnSys Server config file
    2. /opt/opengnsys/etc/ogAdmRepo.cfg - OpenGnSys Repository config file
    3. /opt/opengnsys/etc/ogAdmAgent.cfg - OpenGnSys Agent config file
    4. /opt/opengnsys/client/etc/ogAdmClient.cfg - OpenGnSys Client config file
    5. /opt/opengnsys/www/controlacceso.php - OpenGnSys Web Admin Console config file
  2. Configure server DHCP and restart the service.
  3. Optionally, check Samba config in /etc/samba
  4. Access as Administrador in Web Admin Console.
    1. Use the user and password set in the installer to access to database (variables OPENGNSYS_DB_USER and OPENGNSYS_DB_PASSWD).
    2. Check the default organizaed configuration and default user.
  5. Access as user in Web Admin Console.
    1. Use the user and password configured as administrador in the Organizational Unit.
    2. Check the server IP in section "Servidores->Servidor OpenGnSys (Default)".
    3. If you change the configuration, you must to restart the server: sudo /etc/init.d/opengnsys restart

Updating OpenGnSys

Run opengnsys_update.sh script to update all OpenGnSys components from the Subversion repository:

sudo bash /opt/opengnsys/lib/opengnsys_update.sh

Follow the instructions.

Uninstalling OpenGnSys

Run opengnsys_uninstall.sh script to uninstall all OpenGnSys components:

sudo bash /opt/opengnsys/lib/opengnsys_uninstall.sh

Follow the instructions.

OpenGnSys settings to use external services

Server dhcp external

By default, OpenGnsys version 1.0.2 use Grub4Dos instead of PXELinux for booting clients. You need to incorporate the following line to configure DHCP service with Grub4Dos.

use-host-decl-names on; next-server ip_opengnsys; filename "grldr"; }}}

If you wish to coexist some servers, you can specify with differents next-server lines in differents groups.

To change the server of a client, you only have to cut/paste client from one group to another.

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 ...
 }

If you want to used PXELinux, you should be replaced filename to configure DHCP with PXELinux:

filename  "pxelinux.0";

Also, for compatibility with PXELinux, Web Console Admin Server should be referenced to the boot appropiate process, including the next simbolic link:

sudo ln -fs /opt/opengnsys/www/principal/boot_pxelinux.php boot.php

Proposed installation of components

Proposed to modify the installation program to automate the process of the two main components of OpenGnSys Project. The format of the setting script opengnsys-installer.sh can be:

opengnsys_installer.sh [ all | server | repo IPServer DistribuciónCliente ]

As the parameter:

  • server – including the services:
    • OpenGnSys Server (ogAdmServer, ogAdmAgent)
    • Web Console (Apache, MySQL, web pages)
    • Boot (DHCP, TFTP, client generator)
  • repo – including the services:
    • Repo Server (ogAdmRepo)
    • File Server (NFS)
    • OpenGnSys Client Components
    • You need to know the ip of the server and the type of distribution of Ubuntu that will be use on the clients.
  • all – installation compact in the same computer (optional value and by default).

Configure http y snv (if needed)

  • Export proxy variable:
    export http_proxy="http://proxy.xxx.es:puerto"
    
  • Check proxy, install subversion and wget:
    apt-get update
    apt-get install subversion wget
    
  • Configure subversion to use proxy.
    vi /etc/subversion/servers
    #edit section [global], in line 142:
    
    [global]
    
    http-proxy-host = proxy.xxx.es
    
    http-proxy-port = 3128
    
    http-timeout = 10
    
    # note: there should not be commented line between [global] and http-proxy-host 
    # note: there should not be blanks and tabs before http-proxy-host
    
    

Change server IP and OpenGnsys

  • Operating System:
/etc/network/interfaces
/etc/hosts
/etc/resolv.conf
/etc/dhcp3/dhcpd.conf




/opt/opengnsys/etc/ogAdmAgent.cfg
/opt/opengnsys/etc/ogAdmRepo.cfg
/opt/opengnsys/etc/ogAdmServer.cfg
/opt/opengnsys/client/etc/ogAdmclient.cfg

/opt/opengnsys/www/controlacceso.php
/etc/init.d/networking restart
/etc/init.d/dhcp3-server restart
/etc/init.d/opengnsys restart
# or restart the system.

Access to OpenGnsys Web Admin Console to modify the config

Click on University icon and select environment variable. 
Modify "IP del servidor de administración" value.

Modify organizational units

Button Repositorios -> propiedades -> cambiar IP.
If needed, modify network properties and multicast direction in classroom properties.
If needed, modify clients IP.
Force a netboot for updating the boot information.

Update images torrent

Delete files .sum and .torrent 

Optional: Remove php cron services from Ubuntu Server

Remove file /etc/cron.d/php5