Definitions

Status
Not open for further replies.

KitchM

Member
Jul 15, 2019
168
6
18
I am having trouble with understanding the meaning of words used in the FusionPBX inteface.

I should mention that I have a server with FusionPBX installed, and I have a Yealink W60B base station (PoE) and a Yealink W56H handset with its base. The handset base appears to be only powered by USB, so it is plugged into the server.

During configuration I ran across a few words that are a little confusing. First is the word "domain". Under Domains, the documents show "...domain(tenant)". ???

Another is under Accounts>Devices. What are devices? Under Extensions we read "Extensions define the information needed for an endpoint such as a hard phone, soft phone or some other device to connect to the SIP server." Now they appear to be an endpoint. ???

Under Gateways, it states "Gateways define the location and settings for other VoIP servers or Providers." So the mention of providers and servers is confusing. My provider would be the company who gives me the SIP trunk. My server would be the computer upon which I install FusionPBX.

Can anyone help explain to me? Thanks.
 

Adrian Fretwell

Well-Known Member
Aug 13, 2017
1,498
413
83
Most often, FusionPBX is used at a mulit-tenant PBX, this means that multiple different customers call all use the same hardware/software to run their telephone system, completely isolated from each other.

A "Domain" is a name that you allocate to any given customer or tenant. Usually this domain is a Fully Qualified Domain Name (FQDN) like customer1.mysystem.co.uk. So you can have many tenants if you wish:
customer1.mysystem.co.uk.
customer2.mysystem.co.uk.
customer3.mysystem.co.uk.
customer4.mysystem.co.uk.

So typically a SIP URI for extension 201 on customer1 may look like <sip:201@customer1.mysystem.co.uk>

A device is a record that defines a physical endpoint, it holds the configuration details for that endpoint so it can be auto-provisioned with the correct extension number / password etc. You do not need to set up device records if you provision your endpoints manually (not recommended for a large system).

Under gateways, ignore providers, it is just a way of quickly setting up gateways to provider that pay to be there.

The gateway record is just where you enter all the relevant details that are required by your SIP provider to allow you to connect.

I hope that helps a little.
 

KitchM

Member
Jul 15, 2019
168
6
18
Thank you for your explanation.

Before I go further, please let me point out a simple fact of the world of computer. Just like society, we cannot converse without agreeing to the definitions of the words we use. When any person or organization co-ops a word for their own proprietary usage, we all lose.

In the case of the word domain, it must be clearly defined as to the usage intended. Whenever we speak within the category of anything having to do with computing, the word domain has a particular meaning. I found a good example of the possibilities from Wikipedia where it lists the following likely candidates, all having to do with computing:
Administrative domain - Probably not
Broadcast domain, in computer networking, a group of special-purpose addresses to receive network announcements - No
Network domain, a named grouping of hosts and servers with managed login, access to resources, and permissions. - Maybe
Domain name, a label that identifies a realm of administrative autonomy, authority, or control within the Internet - Probably not

So within this, I would guess that number three is most likely within our context. However, your explanation seems to favor the last one, such as an FQDN which we use to identify locations on the Internet. But herein lies a problem.

As discussed elsewhere, there is no absolute need to use an FQDN to separate Tenants. We can use internal addressing instead of Internet names. Because of this, the usage is clearly confusing and needs to be updated to say what it means.

BTW, in client/server environments such as this one, we should not forget the common use of the word client.

In any case, the problem appears to stem from the concept of multi-tenancy. It is a good and highly-valuable feature, but it should not be allowed to override the basics of a PBX.

We must first understand the concept of a single phone number PBX which is used to direct calls to various extensions. Since a SIP trunk can handle many concurrent calls at the same time, a single phone number can serve many extensions. This is key, and I am sure the programmers meant such to be the foundational concept.

I place my vote for domain to be replaced with the word entity, or something similar. Further, there is no reason that the PBX software cannot keep them separate by a simply number or name, such as 1,2,3 or company A, B, C.

Again from Wikipedia, we see the following usages of device:
Device, a component of personal computer hardware
Device file, an interface of a device driver
Peripheral, any device attached to a computer that expands its functionality
There is also use as an electronic component.

The idea of a device being an endpoint is okay for you and I, but I do not like it for the reason that it is not in common English usage and so would tend to confused the Newbie.

To make it worse, a server is a device and a telephone is a device and a router is a device and a switch is a device; all of which may most likely be used in the PBX arena. So if we mean a telephone, then we should just say that. The use of nebulous terms confuses the issue, and once again we all lose.

I received this from our friend Barry in tech support:
A quick search for âDevicesâ in the documentation does appear to omit a definition unless a device other than telephonic device is discussed, for example, network âDeviceâ or Firewall âDeviceâ. I will discuss the omission with our Tech writer. At this point, you can assume âdeviceâ means telephonic (Desk or wireless phone, softphone, conference phone, etc.) unless otherwise specified. However, once inside the program, under the âAccountsâ drop-down menu then select âDevicesâ it explains, âDevices are endpoints that register one or more extensions. They are added to the list manually or automatically when the device requests the provisioning information over HTTP/HTTPS.â The Tech writer did not explicitly state "telephonic device" in the description, I assume because the software is used for controlling telephones.

It does clearly show the problem with the current documentation, and I will continue to offer my help in this regard. We will see how that comes out.

In any case, thanks again.
 
Status
Not open for further replies.