source: installer/INSTALL.en.txt @ 12ad7b2

918-git-images-111dconfigfileconfigure-oglivegit-imageslgromero-new-oglivemainmaint-cronmount-efivarfsmultivmmultivm-ogboot-installerogClonningEngineogboot-installer-jenkinsoglive-ipv6test-python-scriptsticket-301ticket-50ticket-50-oldticket-577ticket-585ticket-611ticket-612ticket-693ticket-700ubu24tplunification2use-local-agent-oglivevarios-instalacionwebconsole3
Last change on this file since 12ad7b2 was 2c5d6a3, checked in by Ramón M. Gómez <ramongomez@…>, 6 years ago

#857: Basic compatibillity notes.

  • Property mode set to 100644
File size: 3.9 KB
RevLine 
[2c5d6a3]1Installing OpenGnsys Server 1.1.1 (Espeto)
2==========================================
[d4871ae]3
[ea01a0db]4Before installation
5-------------------
[d4871ae]6
[2c5d6a3]7OpenGnsys Server 1.1.1 (codename "Espeto") is meant to be installed under Ubuntu Server 16.04 LTS or newer, though it has also been tested under operating systems based on CentOS 7 (read COMPATIBILITY.en.txt for more details).
[d4871ae]8
[ea01a0db]9Network connection is needed in order to download the required packages, the source code and the preconfigured client.
10
11Minimum storage requirements:
12- 100 MB in /tmp (for the installation process)
13- 600 MB in /var/lib/tftpboot (or /srv in Debian systems) for every installed ogLive client.
14- 250 MB in the installation folder (/opt/opengnsys) plus 600 MB for every downloaded ISO image.
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
18
19Installing
20----------
[d4871ae]21
[ea01a0db]22To 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
[d4871ae]23
[ea01a0db]24Unpacking example:
25        tar xvzf opengnsys-Version.tar.gz
26        cd opengnsys/installer
[d4871ae]27
[ea01a0db]28Downloading examples:
[d4871ae]29
[ea01a0db]30    * Download with wget.
31        wget https://raw.githubusercontent.com/opengnsys/OpenGnsys/master/installer/opengnsys_installer.sh
[d4871ae]32
[ea01a0db]33    * Download with curl.
34        curl https://raw.githubusercontent.com/opengnsys/OpenGnsys/master/installer/opengnsys_installer.sh -o opengnsys_installer.sh
[d4871ae]35
36
[ea01a0db]37You must be root to run the installation script:
38        sudo bash opengnsys_installer.sh
[d4871ae]39
40
[ea01a0db]41The 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):
42    * MySQL root password
43    * Web console user and OpenGnsys Super Administrator
44    * Web console user's password
45    * Client's password for accessing remote services
46    * Choose which ogLive clients to install.
47
48The following processes will be carried out:
49    * Gathering of the basic network parameters.
50    * Checking installed packages.
51    * Downloading and installing dependencies.
52    * Creating OpenGnsys basic folder sctructure.
53    * Downloading code from the repository to a temporal folder (/tmp/opengnsys_installer). In upcoming releases this process will not be necessary.
54    * Compiling and installing OpenGnsys services.
55    * Basic configuration of OpenGnsys network services (DHCP, PXE and Samba) using the existing configuration templates.
56    * Copying additional server management files.
57    * Creating database and configuring OpenGnsys administration console web server.
58    * Copying administration console pages.
59    * Copying OpenGnsys client folder structure.
60    * Downloading OpenGnsys client initial image.
61    * Basic configuration of OpenGnsys services using network parameters.
62
63Once the installation process is finished, you can start working with the system:
64    * Configuring DHCP.
65    * Adding information in the administration console.
66    * Customizing administration scripts.
67    * Creating start menus for the clients.
68
69
70
71Updating / upgrading
72--------------------
[d4871ae]73
[ea01a0db]74There is a system self-upgrading script with the following features:
75    * Network connection is needed to obtain the latest updates / upgrades.
76    * If the script updates itself, then it must be run once again.
77    * Services depending on the operating system will not be updated.
78    * Configuration files will not be modified.
[d4871ae]79
[ea01a0db]80You must be root to run this script:
81    sudo /opt/opengnsys/lib/opengnsys_update.sh
82 
[d4871ae]83
84
[ea01a0db]85Uninstalling
86------------
[d4871ae]87
[ea01a0db]88There is also an uninstallation script to remove the OpenGnsys components:
89    * OpenGnsys files and database will be deleted.
90    * Operating system packages and their configuration files will be preserved.
91    * The image folder and its content will not be deleted.
[d4871ae]92
[ea01a0db]93You must be root to run this script:
94    sudo /opt/opengnsys/lib/opengnsys_uninstall.sh
[d4871ae]95
Note: See TracBrowser for help on using the repository browser.