[[TranslatedPages]]
[[TOC]]

= OpenGnSys Server Installation Manual =

== Note ==

It is assumed [wiki:WikiStart/en OpenGnSys] Server will be installed in a GNU/Linux distro, Ubuntu 10.04 Server LTS.

The scripts and installation files [wiki:WikiStart/en OpenGnSys] components are available in [browser:trunk/installer OpenGnSys Installer].

Check the [wiki:CompatibilidadInstalacionServer/en OpenGnSys Server installation compatibility list].

== Install Version ==

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


== Installation Methods ==

There are three basic ways [wiki:WikiStart/en 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 [wiki:ConfigInicial/en 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.

[wiki:WikiStart/en OpenGnSys] installation is done by running the installation script [browser:trunk/installer/opengnsys_installer.sh 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:
    a. Download with wget. 
         {{{ 
            wget http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
         }}}
    a. Download with curl.
         {{{ 
            curl http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh
         }}}
    a. 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}}}

 2. '''Basic Configuration'''
   a. 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.

3. Installation process. 
    a. 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.
    a. The script must be run as {{{root}}}:
    {{{
   sudo bash opengnsys_installer.sh
}}}


 4. '''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.
   a. Access to [http://www.opengnsys.es/browser/tags] 
   a. Window will be open, informing you can not see the package, only download.
 1. Load it on the server where we will install it.
 1. Descompress the file tar.gz (`tar zxvf name_of_file.tar.gz`).
 1. Change the name of subdirectory to `opengnsys`.
 1. Create the subdirectory `opengnsys_installer` at `/tmp`.
 1. Move the subdirectory `opengnsys` to `/tmp/opengnsys_installer`.
 1. Change to user root `sudo su`
 1. Setting proxy to server. i.e.: `export http_proxy="http://proxy.us.es:3128"`
 1. 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.
 1. 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 [wiki:WikiStart/en OpenGnSys] see [wiki:InstalacionManual 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 [wiki:WikiStart/en 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 [wiki:WikiStart/en 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 ===

 1. Add to file /var/lib/tftpboot/pxelinux.cfg/default the identification [wiki:WikiStart/en OpenGnSys] server (ip adress), with repo=xxx.xxx.xxx.xxx
{{{
LABEL pxe
KERNEL linux
APPEND initrd=initrd.gz ip=dhcp ro vga=788 irqpoll acpi=on repo=172.17.36.29
}}}
 1. In the configuration file external dhcp server: 
{{{
# Enables the transfer of the name by dhcp.
use-host-decl-names on;
# Assign the service pxe:
next-server ip_opengnsys;
}}}


=== Server pxe external ===

 1. Copy files initrd and linux from /var/lib/tftpboot to server pxe external.
 1. Copy or integrate the initrd linux parameters (/var/lib/tftpboot/pxelinux.cfg/default), also including the parameter repo=xxx.xxx.xxx.xxx. to server pxe external. (where xxx.xxx.xxx.xxx is the OpenGnSys server ip)


== 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).