This document explains how to categorize computers in your network.
To follow the steps outlined below, you need to have access to a SlapOS Master (setting up a SlapOS Master) and at least a first network node to categorize (installing a SlapOS node).
Allocation Scope can be set on a computer in the SlapOS Dashboard. It is a base category in ERP5 (you can check with superuser privileges on the ERP5 interface at [IPv4]/erp5/portal_categories/allocation_scope). In the SlapOS Dashboard, allocation scope is a parameter settable on a computer denoting its accessability.
Log into the SlapOS Dashboard.
Locate the Servers entry on the side menu to access the list of servers. Click on one of the available servers to access its configuration parameters.
On the configuration parameters, note the Allocation Scope parameter on the right hand side. It determines to whome the server can provide software instantiation services. The following options are possible:
To change the scope, select one of the available options and click Save
Note, that extending the number of allocation scopes is possible. However, for setting user permissions, it is better to use projects and/or organisations.
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.
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 name 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 the list of servers using the Servers entry in the side menu. As mentioned in the beginning you should have at least one server available so it can be associated. Click on this 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 site and project declared on a server, they should have both be defined to have a clear association.
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:
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.