blob: 84492e6ea98fbeffd0db6504042c4ba3b9ba416b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
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
|
