[[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].


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

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

=== 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]


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