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

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

OpenGnsys Server 1.1.1 (codename Espeto) is meant to be installed under Ubuntu Server 18.04 LTS or newer (some tests have been done on CentOS 7-based systems).

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) or after downloading it directly from https://raw.githubusercontent.com/opengnsys/OpenGnsys/master/installer/opengnsys_installer.sh

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

Downloading examples:

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

    * Download with curl.
	curl https://raw.githubusercontent.com/opengnsys/OpenGnsys/VERSION/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.
    * Downloading 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
--------------------

Warning: if you are going to upgrade OpenGnsys from a version earlier than 1.1.1 (Espeto), you must first upgrade Ubuntu to version 18.04 LTS and restart the server.

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