Version 16 (modified by 12 years ago) (diff) | ,
---|
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.2a 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
- Download the script. Examples with various tools:
- Download with wget.
wget http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
- Download with curl.
curl http://www.opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh
- 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
- Download with wget.
- Basic Configuration
- 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:
- For security reasons, it is very important modify defaults users and passwords to access to the system. For this, edit the installation file
- Installation process.
- 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.
- The script must be run as
root
:sudo bash opengnsys_installer.sh
- Check the configuration files.
Installation from tar.gz
- 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.
- Access to http://www.opengnsys.es/browser/tags
- Window will be open, informing you can not see the package, only download.
- Load it on the server where we will install it.
- Descompress the file tar.gz (
tar zxvf name_of_file.tar.gz
). - Change the name of subdirectory to
opengnsys
. - Create the subdirectory
opengnsys_installer
at/tmp
. - Move the subdirectory
opengnsys
to/tmp/opengnsys_installer
. - Change to user root
sudo su
- Setting proxy to server. i.e.:
export http_proxy="http://proxy.us.es:3128"
- 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. - 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
- Check config files.
/opt/opengnsys/etc/ogAdmServer.cfg
- OpenGnSys Server config file/opt/opengnsys/etc/ogAdmRepo.cfg
- OpenGnSys Repository config file/opt/opengnsys/etc/ogAdmAgent.cfg
- OpenGnSys Agent config file/opt/opengnsys/client/etc/ogAdmClient.cfg
- OpenGnSys Client config file/opt/opengnsys/www/controlacceso.php
- OpenGnSys Web Admin Console config file
- Configure server DHCP and restart the service.
- Optionally, check Samba config in
/etc/samba
- Access as Administrador in Web Admin Console.
- Use the user and password set in the installer to access to database (variables
OPENGNSYS_DB_USER
andOPENGNSYS_DB_PASSWD
). - Check the default organizaed configuration and default user.
- Use the user and password set in the installer to access to database (variables
- Access as user in Web Admin Console.
- Use the user and password configured as administrador in the Organizational Unit.
- Check the server IP in section "Servidores->Servidor OpenGnSys (Default)".
- 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
- 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
- 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
- Copy files initrd and linux from /var/lib/tftpboot to server pxe external.
- 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).