The Realms add-on module is designed to simplify the process of grouping customers that use one or different partners according to the logical areas. The Realm - the ending after
@(at) sign that is used as customer login in their Internet service, e.g.
@managed.com is a Realm entity.
The add-on can be installed in two methods: via the CLI or the Web UI of your Splynx server.
To install the add-on via CLI, the following commands can be used:
apt-get update apt-get install splynx-realms
To install the add-on from the Web UI, navigate to
Config → Integrations → Add-ons:
Locate or search for the
splynx-realms add-on and click the Install icon in the Actions column:
OK, confirm button to begin the installation process:
After the installation process has completed, all parameters for the add-on can be found in
Config → Integrations → Modules list.
Locate or search for the
splynx-realms add-on module and click the
(Edit) icon in the Actions column:
Double check if Entry points status for portal parameter is
The configuration of add-on Entry points can be found in
Config → Integrations → Modules list, near the
splynx-realms module item in the Actions column. Click the (Edit entry points) icon. More information about Modules list can be found here.
Add new Realm values to the existing Partner (-s)
Administration → Splynx → Partners:
Locate the necessary Partner and click the Edit icon:
In the new window in the Realms field, specify the required values and save changes.
Each value should start on a new line. Additionally, you have the option to include the
@ (at) sign at the beginning of the value. However, be aware that this won't result in duplicated characters in the
Service login format;
One partner can have multiple Realms. The Realms names are not unique, it means that the same Realm can be used by many Partners.
Select the particular Realm in the Internet service
Customers → List, locate the necessary customer and open their profile. Navigate to Services tab and click the Edit icon near the Internet Service:
In a new window, find the Realm field and click the
Afterward, select the appropriate Realm value from the drop-down list, click the
Select button and save the changes.
You can only choose a Realm that is associated with a specific partner the customer is affiliated with.
Then, check if the
Service login has been changed:
Or erase the particular Realm value in the Partner configuration window. Please do not forget to save the changes:
Show all customers according to the specific Realm
Customers → List and in the Search field type in the name of a Realm to show the customers' relation:
In case the Realm field is disabled in the list of customers, click the breadcrumbs icon at the top right of the table and enable its toggle: