Setting up a GERT Network

This is a section on how to set up a GERT network on your Minecraft server. A video version of the following text is linked below. Direct links to the necessary files are found at the end.

How to Set up a GERT Network on Your Server

Setting up a GERTi network

https://youtu.be/U5-weAgZ-co This video explains how to set up a GERTi network. I recommend watching it if you are unclear on any details.

In order for GERTi to function properly, it should be running on a computer with the CPU architecture set to Lua 5.3. If you run into issues during setup or use, please begin by checking the CPU arch of the involved computers.

For GERTi to function properly, you must have at least 2 computers with wired/wireless/linked network cards. One computer will be the Master Network Controller (MNC) and must have GERTiMNC.lua in the /etc/rc.d folder. For optimal performance and stability, I recommend that GERTiMNC.lua be run on startup, which may be accomplished by entering 'rc GERTiMNC enable' into the OpenOS shell. If you do not want to autorun on startup, please type 'rc GERTiMNC start' into the OpenOS shell every time you restart the MNC.

For all other computers you desire to connect to GERT, they must have GERTiClient.lua in their /lib or /usr/lib folders. Computers that will be directly running programs using GERT need not perform any additional steps. To expand the network and ensure that all clients can be reached, we recommend that all computers be fitted with GERTiClient.lua, and use an autorun.lua script that calls local GERTi = require("GERTiClient"). This will ensure that as many computers as possible are connected to the GERT network.

If you wish to have the recommended minimum 3 computer setup (1 MNC and 2 or more clients), simply follow the instructions above. If you want to set up a network with just two computers or use network services, then you must install MNCAPI on the MNC. After this, the MNC can be used as a client (not recommended for larger deployments), or network services can be installed on the MNC. MNCAPI must be installed as either /lib/GERTiClient.lua or /usr/lib/GERTiClient.lua in order to function properly. If it's not named correctly and installed in the appropriate place, the MNC will not be able to recognize it and it will not correctly enable client and network services on the MNC.

If you wish to enable DNS, simply download the DNS file to /etc/rc.d/DNS.lua and either run rc DNS enable once, or run rc DNS start after starting the MNC after each restart.

If you just want to link computers between your server, you are now done! If you want to connect your server to GERTe and enable communications outside of Minecraft, you must follow the steps below.

Connecting to GERTe

1. Contact MajGenRelativity to obtain a GERTe address and key. You may open an issue on this repository asking for one, or you may go to https://discord.gg/f7VYMfJ and ask there.
2. The MNC computer must have an internet card.
3. The MNC must have GERTeAPI.lua in /lib, and it must have peers.geds in the same folder as GERTiMNC.lua
4. The MNC must have GERTconfig.cfg in the same folder as GERTiMNC.lua, and the file should have two lines. One line must have the GERTe address, which is formatted like xxxx.yyyy, and the second line must have your GERTe key. Please do not tell others your key, as that allows them to access the GERT network as you.

Now your network is fully set up, and you may enjoy using all the programs that support GERT!

GERTiClient.lua

GERTiMNC.lua

MNCAPI

DNS

GERTeAPI.lua