Advanced Provisioner - Configuration Tabs - Lines

Description: The purpose of this article is to provide a detailed overview of the Lines configuration tab, which is accessible for all devices eligible for provisioning within the Advance Provisioner App.

The Advance Provisioner App serves as the primary digital workspace for configuring advanced settings on provisioned devices. For every device from any manufacturer, there is a roster of configuration tabs, each containing different parameters. Once you have added a new device, you will have the opportunity to customize a distinct set of configuration tabs tailored to that specific device. 

In all the tabs, parameters can be classified into two types: 

• those that require manual input of values.
• those that provide a dropdown list of options.

Certain fields may initially contain pre-filled values inherited from server and account settings. These inherited values may vary depending on the specific server and account configurations.

Within this article, we will examine the Lines configuration tab and its parameters available for customization.

Lines Configuration Tab

The parameters available within each Configuration tab may vary depending on the brand and specific device. This article covers all the potential parameters you might encounter within the tab this article is focused on.

This configuration tab is one of the five primary "account settings" tabs that can be set at the account level, ensuring that all newly added devices will adopt the parameters you have defined. 

Account settings are not global. There is a global default (which is the Inherits from Defaults value) which are static settings on the Provisioner. Account Settings are account defaults the admin for the account wishes to be applied on all devices in a given account.

Account administrators have access to Provider Settings, which is a level of defaults above Account Settings. All devices inherit settings in this order: 
Global → Provider/Reseller → Account → Device. 

To learn more about the Account Settings tab, you can refer to the corresponding section of an article accessible through this link.

When configuring a device, this configuration tab will be the initial default view.

Here, you can find a column that indicates the number of lines accessible for each device. Within the Advance Provisioner App's interface, these lines are represented as a table of lines. 

Within modern VoIP (or digital telephone systems, a "line" is a virtual entity created through software. These virtual lines serve as distinct channels, enabling you to initiate or receive calls autonomously, even if you possess only a single physical connection, such as an internet link. They serve as a method for effectively handling numerous simultaneous calls or communication sessions using a single device.

The number of lines may differ depending on the device. 

By pressing the pencil badge on a particular record in this table, you can seamlessly switch between the parameters within the currently active configuration tab, allowing you to configure them individually for each selected line.

The parameters within the following sections are set up individually for each line. Currently, there is no possibility to copy the settings of one line to another.

The parameters available for configuration for the selected line can be categorized into three distinct subtabs:

• Basic: this section contains the basic parameters of the line whose button was enabled in the first section.

There are seven parameters that need to be configured here:

• Enable: this parameter defines the status of the selected line. It can take one of three values.

• Inherit: by choosing this option, you allow this line to inherit its status from the Defaults.
• Enabled: by choosing this option, you will enable the chosen line irrespective of the parameters configured in the Defaults.
• Disabled: by choosing this option, you will disable the chosen line irrespective of the parameters configured in the Defaults.

• Display Name: within this field, you have the option to set a custom name for the chosen line. If you leave this field blank, the line will inherit the name set in the Account settings.
• Transport: when you click on this field, a dropdown menu will appear, presenting various choices for selecting the preferred communication protocol that the phone will use to transmit voice and data over the selected line.

By choosing the "Inherit" option, you allow this line to use the communication protocol set in the Defaults.

• Expire time: within this field, you have the option to set the time interval for the chosen line to renew its registration with the PBX.

This renewal process signals to the provider’s server that the line remains registered, active, and ready to accept incoming calls

• Voicemail number: within this field, you have the option to set a custom voicemail number for the chosen line. If you leave this field blank, the line will inherit the voicemail number set in the Defaults.
• MWI Subscription Number: you can use this field to input the mailbox number of a specific mailbox that you wish to activate using the indicator. If you don't provide a value in this field, the indicator will be activated for any voicemail box assigned to the user.
• Number of line keys: here, you can enlist the lines you want to appear on the device by entering their numbers separated by commas. If you leave this field blank, this parameter will use the line set in the Defaults.

• SIP: this section contains the SIP parameters of the line whose button was enabled in the first section.

SIP stands for Session Initiation Protocol, which is a communication protocol used in phone systems to initiate, modify, and terminate real-time sessions that involve voice, video, messaging, and other types of multimedia communication. 

SIP is widely used in Voice over Internet Protocol (VoIP) systems, which enable phone calls to be made over the internet rather than through traditional phone networks.

There are eight parameters that need to be configured here:

• SIP Realm: within this field, you have the option to set a SIP Realm for the selected line.

The SIP Realm is a domain or a namespace that identifies a set of users and devices that are registered to a particular SIP server or service provider. The SIP Realm plays a crucial role in authenticating and authorizing users to access SIP services.

• SIP Username: here, you can set a SIP Username for the selected line.
• SIP Password: here, you can set a password used to authenticate and authorize a user or device to access and use a SIP-based communication system. It ensures that only authorized users or devices can access and use the SIP services associated with the configured line.
• Primary Address: within this field, you can set a Primary Address for the selected line. If you leave this field blank, the line will inherit the Primary Address set in the Defaults.    
• Primary Port: here, you can set a Primary Port for the selected line.

A Primary Port is the main point of connection for communication

If you leave this field blank, the line will inherit the Primary Port set in the Defaults.    

• Secondary Address: within this field, you can set a Secondary Address for the selected line. If you leave this field blank, the line will inherit the Secondary Address set in the Defaults.    
• Secondary Port: here, you can set a Secondary Port for the selected line.

A Secondary Port serves as a backup or alternative in case of Primary Port failures, ensuring continuity and reliability.

If you leave this field blank, the line will inherit the Secondary Port set in the Defaults.

• Advanced: this section contains the advanced parameters of the line whose button was enabled in the first section.

There are five parameters that need to be configured here:

• Showed Missed Calls: this parameter defines whether missed calls will be shown. It can take one of three values.

• Inherit: by choosing this option, you allow this line to inherit this parameter from the Defaults.
• Enabled: by selecting this option, you will activate the display of missed calls for the selected line, regardless of the parameters set in the Defaults.
• Disabled: by selecting this option, you will deactivate the display of missed calls for the selected line, regardless of the parameters set in the Defaults.

• RTP Encryption (SRTP): this parameter defines whether RTP Encryption will be activated for the configured line.

Real-time Transport Protocol (RTP) encryption is a security measure used to ensure the privacy and integrity of live multimedia content, including audio and video streams, transmitted over the Internet or a network. RTP is frequently used in applications like Voice over Internet Protocol (VoIP) and video conferencing.

It can take one of three values.

• Inherit: by choosing this option, you allow this line to inherit this parameter from the Defaults.
• Enabled: by selecting this option, you will allow this line to use RTP encryption, regardless of the parameters set in the Defaults.
• Disabled: by selecting this option, you will forbid this line to use RTP encryption, regardless of the parameters set in the Defaults.

• RPort: this parameter defines whether the RPort mechanism will be activated for the configured line.

The RPort mechanism changes the SIP routing behavior, allowing responses to be received through a NAT (Network Address Translation) even when SIP headers use private addresses.

It can take one of three values.

• Inherit: by choosing this option, you allow this line to inherit this parameter from the Defaults.
• Enabled: by selecting this option, you will allow this line to use the RPort mechanism, regardless of the parameters set in the Defaults.
• Disabled: by selecting this option, you will forbid this line to use the RPort mechanism, regardless of the parameters set in the Defaults.

• UDP Keep Alive: this parameter defines whether the UDP-based Keep Alive mechanism will be enabled for the configured line.

Keep Alive is a mechanism used to maintain the uninterrupted functionality and responsiveness of network connections using a specific protocol for data transfer. This mechanism is based on maintaining an active network connection by periodically sending a signal or "keep-alive" message.

It can take one of three values.

• Inherit: by choosing this option, you allow this line to inherit this parameter from the Defaults.
• Enabled: by selecting this option, you will allow this line to use the UDP-based Keep Alive mechanism, regardless of the parameters set in the Defaults.
• Disabled: by selecting this option, you will forbid this line to use the UDP-based Keep Alive mechanism, regardless of the parameters set in the Defaults.

• Keep Alive Interval: this parameter defines the time interval for the chosen line to send a "keep-alive" message. If you leave this field blank, the line will inherit the Keep Alive Interval set in the Defaults.

Make sure to press the "Save" button to apply all the changes you have made to the parameters.