| 1 | Installing OpenGnsys Server v 1.0.5 |
|---|
| 2 | ======================================= |
|---|
| 3 | |
|---|
| 4 | Before installation |
|---|
| 5 | ------------------- |
|---|
| 6 | |
|---|
| 7 | OpenGnsys Server 1.0.5 is meant to be installed under Ubuntu Server 12.04 LTS or newer, though it has also been tested under operating systems based on Fedora 20 |
|---|
| 8 | |
|---|
| 9 | Network connection is needed in order to download the required packages, the source code and the preconfigured client. |
|---|
| 10 | |
|---|
| 11 | Minimum storage requirements: |
|---|
| 12 | - 100 MB in /tmp (for the installation process) |
|---|
| 13 | - 450 MB in /var/lib/tftpboot (or /srv in Debian systems) |
|---|
| 14 | - 500 MB in the installation folder (/opt/opengnsys) in addition to the space required for logging (100 MB if ogLive client is already downloaded). |
|---|
| 15 | - Enough disk space for the image repository in /opt/opengnsys/images (it is recommended to mount it on an independent file system) |
|---|
| 16 | |
|---|
| 17 | Installation |
|---|
| 18 | ------------ |
|---|
| 19 | |
|---|
| 20 | To install OpenGnsys, run opengnsys_installer.sh after unpacking the release file (opengnsys-release.tar.gz) o downloading it directly from https://opengnsys.es/svn/trunk/installer/opengnsys_installer.sh. |
|---|
| 21 | |
|---|
| 22 | Unpacking example: |
|---|
| 23 | tar xvzf opengnsys-1.0.5.tar.gz |
|---|
| 24 | cd opengnsys/installer |
|---|
| 25 | |
|---|
| 26 | Download examples: |
|---|
| 27 | |
|---|
| 28 | * Download with wget. |
|---|
| 29 | wget https://opengnsys.es/svn/trunk/installer/opengnsys_installer.sh -O opengnsys_installer.sh |
|---|
| 30 | |
|---|
| 31 | * Download with curl. |
|---|
| 32 | curl https://opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh |
|---|
| 33 | |
|---|
| 34 | |
|---|
| 35 | You must be root to run the installation script: |
|---|
| 36 | sudo bash opengnsys_installer.sh |
|---|
| 37 | |
|---|
| 38 | |
|---|
| 39 | 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): |
|---|
| 40 | * MySQL root password |
|---|
| 41 | * Web console user and OpenGnsys Super Administrator |
|---|
| 42 | * Web console user's password |
|---|
| 43 | * Client's password for accessing remote services |
|---|
| 44 | |
|---|
| 45 | The following processes will be carried out: |
|---|
| 46 | * Gathering of the basic network parameters. |
|---|
| 47 | * Checking the installed packages. |
|---|
| 48 | * Downloading and installing dependencies. |
|---|
| 49 | * Creating OpenGnsys basic folder sctructure. |
|---|
| 50 | * Download the code repository to a temporal folder (/tmp/opengnsys_installer). In upcoming releases this process will not be necessary. |
|---|
| 51 | * Compiling and installing OpenGnsys services. |
|---|
| 52 | * Basic configuration of OpenGnsys network services (DHCP, PXE and Samba) using the existing configuration templates. |
|---|
| 53 | * Copying additional server management files. |
|---|
| 54 | * Creating the database and configuring OpenGnsys administration console web server. |
|---|
| 55 | * Copying web administration console pages. |
|---|
| 56 | * Copying the OpenGnsys client folder structure. |
|---|
| 57 | * Downloading OpenGnsys client initial image. |
|---|
| 58 | * Basic configuration of OpenGnsys services using network parameters. |
|---|
| 59 | |
|---|
| 60 | Once the installation is finished you can start working with the system: |
|---|
| 61 | * Configuring DHCP. |
|---|
| 62 | * Adding information in the administration console. |
|---|
| 63 | * Customizing administration scripts. |
|---|
| 64 | * Creating start menus for the clients. |
|---|
| 65 | |
|---|
| 66 | |
|---|
| 67 | |
|---|
| 68 | Updating / upgrading |
|---|
| 69 | -------------------- |
|---|
| 70 | |
|---|
| 71 | There is a system self-upgrading script with the following features: |
|---|
| 72 | * Network connection is needed to obtain the latest updates / upgrades. |
|---|
| 73 | * If the script updates itself, then it must be run once again. |
|---|
| 74 | * Services depending on the operating system will not be updated. |
|---|
| 75 | * Configuration files will not be modified. |
|---|
| 76 | |
|---|
| 77 | You must be root to run this script: |
|---|
| 78 | sudo /opt/opengnsys/lib/opengnsys_update.sh |
|---|
| 79 | |
|---|
| 80 | |
|---|
| 81 | |
|---|
| 82 | Uninstall |
|---|
| 83 | --------- |
|---|
| 84 | |
|---|
| 85 | There is also an uninstall script for the OpenGnsys components: |
|---|
| 86 | * OpenGnsys files and data base will be deleted. |
|---|
| 87 | * Packages belonging to the operating system and their configuration files will be preserved. |
|---|
| 88 | * The image folder and its content will not be deleted. |
|---|
| 89 | |
|---|
| 90 | You must be root to run this script: |
|---|
| 91 | sudo /opt/opengnsys/lib/opengnsys_uninstall.sh |
|---|
| 92 | |
|---|
