source: doc/INSTALL.en.txt @ 9ac7993

Installing OpenGnsys Server 1.1.1 (codename "Espeto")
=====================================================

Before installation
-------------------

OpenGnsys Server 1.1.1 (Espeto) is mean to be installed under Ubuntu Server 16.04 LTS or newer, though it has also been tested under operating systems based on CentOS 7.

Network connection is needed in order to download the required packages, the source code and the preconfigured client.

Minimum storage requirements:
- 100 MB in /tmp (for the installation process)
- 600 MB in /var/lib/tftpboot (or /srv in Debian systems) for every installed ogLive client.
- 250 MB in the installation folder (/opt/opengnsys) plus 600 MB for every downloaded ISO image.
- Enough disk space for the image repository in /opt/opengnsys/images (it is recommended to mount it on an independent file system)



Installing
----------

To install OpenGnsys, run opengnsys_installer.sh script after unpacking the release file (opengnsys-release.tar.gz) o downloading it directly from https://raw.githubusercontent.com/opengnsys/OpenGnsys/devel/installer/opengnsys_installer.sh

Unpacking example:
        tar xvzf opengnsys-1.1.0.tar.gz
        cd opengnsys/installer

Download examples:

    * Download with wget.
        wget https://raw.githubusercontent.com/opengnsys/OpenGnsys/devel/installer/opengnsys_installer.sh

    * Download with curl.
        curl https://raw.githubusercontent.com/opengnsys/OpenGnsys/devel/installer/opengnsys_installer.sh -o opengnsys_installer.sh


You must be root to run the installation script:
        sudo bash opengnsys_installer.sh


The following information will be requested in order to configure the access to the service (a default value will be introduced if no parameter is indicated):
    * MySQL root password
    * Web console user and OpenGnsys Super Administrator
    * Web console user's password
    * Client's password for accessing remote services
    * Choose which ogLive clients to install.


The following processes will be carried out:
    * Gathering of the basic network parameters.
    * Checking installed packages.
    * Downloading and installing dependencies.
    * Creating OpenGnsys basic folder sctructure.
    * Download code from the repository to a temporal folder (/tmp/opengnsys_installer). In upcoming releases this process will not be necessary.
    * Compiling and installing OpenGnsys services.
    * Basic configuration of OpenGnsys network services (DHCP, PXE and Samba) using the existing configuration templates.
    * Copying additional server management files.
    * Creating database and configuring OpenGnsys administration console web server.
    * Copying administration console pages.
    * Copying OpenGnsys client folder structure.
    * Downloading OpenGnsys client initial image.
    * Basic configuration of OpenGnsys services using network parameters.

Once the installation process is finished, you can start working with the system:
    * Configuring DHCP.
    * Adding information in the administration console.
    * Customizing administration scripts.
    * Creating start menus for the clients.



Updating / upgrading
--------------------

There is a system self-upgrading script with the following features:
    * Network connection is needed to obtain the latest updates / upgrades.
    * If the script updates itself, then it must be run once again.
    * Services depending on the operating system will not be updated.
    * Configuration files will not be modified.

You must be root to run this script:
    sudo /opt/opengnsys/lib/opengnsys_update.sh
 


Uninstalling
------------

There is also an uninstallation script to remove the OpenGnsys components:
    * OpenGnsys files and database will be deleted. 
    * Operating system packages and their configuration files will be preserved.
    * The image folder and its content will not be deleted.

You must be root to run this script:
    sudo /opt/opengnsys/lib/opengnsys_uninstall.sh