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.

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

OpenGnSys installation is done by running the installation script opengnsys_installer.sh, which can be downloaded directly from ​http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt

1. Download the script. Examples with various tools:
   1. Download with wget.

         wget http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh
      

   2. Download with curl.

         curl http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh
      

   3. Download with a web browser. Click on the link above and save the file opengnsys_installer.sh name.

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

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

Updating OpenGnSys

1. With access to Subversion
   1. Download the file opengnsys_update.
2. Without access to Subversion
   1. Download the update with a computer that having full access to the subdirectory trunk. svn co http://www.opengnsys.es/svn/trunk
   2. Copy to the computer where you want to update.
   3. Move to the subdirectory installer.
3. Run sudo ./opengnsys_update.sh.

Uninstalling OpenGnSys

1. Backup of database sql ogBDAdmin opengnsys.
2. Remove the database ogBDAdmin
3. Remove mysql: sudo aptitude --purge remove mysql-server
4. Stop the og daemon: /etc/init.d/opengnsys stop

OpenGnSys settings to use external services

Server dhcp external

1. Add to file /var/lib/tftpboot/pxelinux.cfg/default the identification 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
   

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