Sites correspond to an organisation in the underlying ERP5 Interface a site, because organisations can have geocoordinates. Sites are used to locate computers on a map.
Start by logging in to the SlapOS Dashboard.
Locate the Sites entry on the side panel which will take you to the list of declared sites.
To add a new site, locate the Add button in the subheader. Click to add a new site.
Give a name to your site (organisation), then click Proceed
You will be forwarded to the new site you created. Notice it does not have any geocoordinates yet and the status fields for computers and partitions on this site are also grey (indicating no info available or no items)
Next, find the site's geocoordinates (for example using gps-coordinates.net), add them to the site and click Save. You will have to refresh the page for the map to update.
Projects in the SlapOS Dashboard correspond to Projects in the underlying ERP5 interface. Projects are required to be able to clearly distinguish computers in a network.
To continue, click on Projects in the side menu. Then click Add as before when adding a site.
Give the project a name and an optional description. Click Proceed to continue.
Once the project is created you can see that also no computers or partitions are associated to the project directly after creation.
Networks correspond to Computer Networks in the underlying ERP5 interface and are also required to clearly distinguish computers being used.
To continue, click on the Networks entry on the side menu. Once on the list of networks, click Add to add a network.
Give the network a nae and Save to continue.
Once the network is created you will see it also has no computers or partitions associated right after creation.
After creating sites, networks and projects you can now start associating the computers in your network.
Head to your list of servers using the Servers entry in the side menu. As mentioned in the beginning you should at least have one node available so it can be associated. Click on the server to continue.
On the server configuration page it should now be possible to select the network previously created. Select it and click Save to continue.
To associate a server with a site and project, click the Transfer button in the subheader.
In the dialog you can see the current site and location (if they have been set). Select the site and location you want to transfer this server to, then click Proceed. Note, you can also only set a single parameter, but while is not necessary to have both a site and project for a server to have a clear association of all machines, they should all both have a site and project declared.
Back on your server menu you can now see that the server has been transferred to the site and project chosen. Head to the Dashboard landing page by clicking on Home on the side menu.
Note, that the map now shows your server which as moved to the specified site. The right hand table will show a list with all sites. The two icons for computers and partitions show the aggregated status over all computers associated to this site. As mentioned elsewhere:
You can now access the list of computers and partitions through the site, project and network menues.
To open a site either click on Sites in the side menu or on the Dashboard widget next to the map. Locate a site to open the site of computers and installed partitions.
Click on Projects on the side menu to see the list of projects and aggregate status for computers and partitions associated to a project.
Click on Networks on the side menu to see the list of networks and aggreate status for computers and partitions associated with a network.