84.9. How to register a SIP telephone onto Abilis

The SIP telephone can be an IP phone or a softphone running on a PC. It can be registered in the Abilis private or public side.

The configuration varies depending on the telephone is behind a NAT.

Enter into the Abilis control-program or open the configuration file with the Console configurator and type the following commands.

a res:ctisip

or

s act res:ctisip

Add the CTISIP resource.

or

If the resource already exists, set it active.

s p ctisip act:yesEnable the CTISIP runtime functionalities.
a user:sip_phone pwd:sip_phone sip:yesAdd the username and password associated to the SIP telephone and enable it to SIP protocol.
s user:sip_phone sip-number:61Configure the SIP telephone number.
s user:sip_phone sip-maxses-bid:4Configure the maximum number of SIP bidirectional sessions.
save confSave the configuration.

On a working Abilis, a system restart is required to make the CTISIP resource running.

[Note]Note

It's possible to specify a FQDN in the DOMAIN parameter of the CTISIP resource. If the SIP user uses a local domain different from the one set in the CTISIP resource, you need to specify it in the User parameter SIP-DOMAIN. Usually you need to do it in this way when the Abilis has a public domain and the user need to access to it via the local area network.

[Note]Note

The previous configuration can be applied also when a SIP Proxy must register itself onto Abilis. In this case the proxy is a “normal” user like a SIP phone, but the SIP-TYPE parameter must be set up to LOCAL-PEER (e.g. s user:sip_proxy sip-type:local-peer).

[Tip]Tip

For the softphones configuration, refer to Chapter 92, Softphones.

[Tip]Tip

Interesting chapters:

Section 61.1.2, “CTISIP Registration”;

Section 61.1.3, “CTISIP INVITE messages”.

84.9.1. How to register a SIP phone supporting BLF onto Abilis

Enter into the Abilis control-program or open the configuration file with the Console configurator and type the following commands.

a res:ctisip

or

s act res:ctisip

Add the CTISIP resource.

or

If the resource already exists, set it active.

s p ctisip act:yesEnable the CTISIP runtime functionalities.
s p ctisip max-sub:200Configure the max number of subscriptions. (If we have 20 phones with BLF, and each monitors 10 phones, then we have 200 subscriptions.)
a user:sip_phone pwd:sip_phone sip:yesAdd the username and password associated to the SIP telephone and enable it to SIP protocol.
s user:sip_phone sip-number:61Configure the SIP telephone number.
s user:sip_phone sip-maxses-bid:4Configure the maximum number of SIP bidirectional sessions.
a res:http

or

s act res:http

Add the HTTP resource.

or

If the resource already exists, set it active.

s p http act:yesEnable the HTTP runtime functionalities.
s p http sesnum-p:40Change the number of HTTP sessions (If we have 40 phones with BLF).
s user:sip_phone http:yesEnable the user sip_phone to HTTP.
a http rights path:/sys/opc/ user:sip_phoneEnable the user sip_phone to access the “Operator Panel Control” link.
a res:opc

or

s act res:opc

Add the OPC resource.

or

If the resource already exists, set it active.

s p opc act:yesEnable the OPC runtime functionalities.
s p opc maxclients:40Change the number of monitors that can require information from OPC (If we have 40 phones with BLF).
s user:sip_phone opc-monitor:sipConfigure the OPC monitored service for user sip_phone. (If this parameter is set to SIP, then the user monitors only SIP interfaces).
save confSave the configuration.

On a working Abilis, a system restart is required to make the resources running.

[Important]Important

BLF requires a separated licence in CPX and needs also SoftPBX licence as it's required by OPC.

84.9.2. How to register a SIP telephone onto Abilis when the telephone is behind a NAT

Enter into the Abilis control-program or open the configuration file with the Console configurator and type the following commands.

a res:ctisip

or

s act res:ctisip

Add the CTISIP resource.

or

If the resource already exists, set it active.

s p ctisip act:yesEnable the CTISIP runtime functionalities.
a user:sip_phone pwd:sip_phone sip:yesAdd the username and password associated to the SIP telephone and enable it to SIP protocol.
s user:sip_phone sip-number:61Configure the SIP telephone number.
s user:sip_phone sip-maxses-bid:4Configure the maximum number of SIP bidirectional sessions.
s user:sip_phone sip-remote-nat:strictConfigure the NAT traversal method.
save confSave the configuration.

On a working Abilis, a system restart is required to make the CTISIP resource running.

[Note]Note

Users which are registered onto Abilis and that stays behind the same NAT, i.e. that presents themselves to the Abilis with the same IP address, can be configured (with SIP-CPO:YES) to exchange RTP directly each other, without transiting through the Abilis. In such a situation, if either puts on-hold, the other will receive RTP stream with the hold tone directly from the Abilis.

[Note]Note

It's possible to specify a FQDN in the DOMAIN parameter of the CTISIP resource. If the SIP user uses a local domain different from the one set in the CTISIP resource, you need to specify it in the User parameter SIP-DOMAIN. Usually you need to do it in this way when the Abilis has a public domain and the user need to access to it via the local area network.

[Note]Note

The previous configuration can be applied also when a SIP Server must register itself onto Abilis. In this case the proxy is a “normal” user like a SIP phone, but the SIP-TYPE parameter must be set up to LOCAL-PEER (e.g. s user:sip_proxy sip-type:local-peer).

[Tip]Tip

For the softphones configuration refer to Chapter 92, Softphones.