System Constraints
The GSW system is designed be run on x86 architecture with a Linux based operating system, some applications may require additional graphical support like an X server to run.
...
The system should also run on WSL2 for Windows users but will NOT run on WSL1 without further syscall implementation from Microsoft.system call implementation from Microsoft.
ARM based Linux probably works but has not been tested.
Getting the Code
The source code is hosted here.
It is recommended to use git to download the source. Git should be installed with most Linux distributions (Ubuntu included), but if git is not installed run the following command:
| Code Block |
|---|
sudo apt install git |
Navigate to the directory you would like to install the source code too, in this example we will install to the user's home directory.
Then download the source code to that directory.
| Code Block |
|---|
cd ~
git clone https://github.com/WillMerges/GSW-2021 |
Building/Installing the System
Building the code requires the following dependencies:
...
| Code Block |
|---|
sudo apt install make && sudo apt install g++ |
Navigate to where you downloaded the GSW-2021 directory (in this example, the home directory) and run the following commands:
| Code Block |
|---|
chmod +x install
./install |
This will automatically install mandatory tools, create new directories, and build the source code.
Next time you wish to navigate to the GSW-2021 directory, simply type the following alias:
| Code Block |
|---|
gsw |
*NOTE: this command also sets your environment for you.
You must set the environment every time you wish to startup the system or run any new applications, e.g. you must either use the gsw alias or manually set the environment in every terminal window you use.
To manually set your environment (rather than using the gsw alias), execute the following command from the GSW-2021 directory:
| Code Block |
|---|
. setenv |
Additional Tools (Optional)
For using some UI applications (Grafana & InfluxDB), it is required that mDNS is supported. The current system uses the following programs, which are installed by default in Ubuntu 18.x.x:
- avahi-daemon (expected to started as a service at boot)
- avahi-publish (used by applications to advertise their address as a certain name, e.g. grafana.local)
If these tools are not installed, install them with the following:
| Code Block |
|---|
sudo apt install avahi-daemon && sudo apt install avahi-utils |