Configure subscriber connection information

This step is mandatory if you are adding new subscribers and the Number status field is set to Normal, Ported to, or Non-geographic. Otherwise there are no mandatory fields to fill in and you can ignore this step.

Enter the following information.


Parameter

Description
Call Agent signaling type The type of signaling used by this subscriber's telephone to connect to the NE. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Values:
  • Analog line/T1 CAS
  • ISDN PRI
  • SIP
If the task you are using has already added access hardware and is now adding new subscribers to use this hardware, this field is read-only.

The value ISDN PRI is not valid if you are configuring connection information for Business Group Lines.
The value SIP is not valid if you are configuring connection information for PBX Lines.

Flash-hook call services provided by This field is visible only if Call Agent signaling type is set to SIP. Specifies whether this SIP subscriber can flash-hook, and use Call Services provided by the MetaSwitch NE that require a flash-hook (such as Call Waiting). Values:
  • MetaSwitch
    The subscriber's SIP device supports flash-hooking, and can use these call services. The subscriber cannot use multiple SIP registrations; the value of Maximum simultaneous registrations is ignored and only one registration is permitted.
  • Endpoint
    The subscriber's SIP device does not support flash-hooking. (SIP devices may support these call services natively.)
Gateway The Trunk / Access Gateway or Subscriber Gateway that owns the Access Device that this line uses to connect to the NE. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS. Click on the search button at the end of the field to choose from access devices on Trunk / Access Gateways or access devices on Subscriber Gateways. Then select from the displayed list of gateways of the specified type. As a short-cut to select the gateway, you can type match details into the field and click on the search button to select from a list of items that match these details. Match details can be a text string, a wildcard string such as B*, or a range such as CA-FL. If the task you are using has already added access hardware and is now adding a new subscriber to use this hardware, this field is read-only.
Access Device The Access Device that this line uses to connect to the NE. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS. Click on the search button at the end of the field to choose from Access Devices on the gateway specified in the Gateway field. If the gateway contains only one Access Device, this device is selected automatically and there is no need to change it. As a short-cut to select the Access Device, you can type match details into the field and click on the search button to select from a list of items that match these details. Match details can be a text string, a wildcard string such as B*, or a range such as CA-FL. If the task you are using has already added access hardware and is now adding a new subscriber to use this hardware, this field is read-only.
First Access Line number This field appears only if Call Agent signaling type is set to Analog line/T1 CAS. Select the Access Line number on the specified Access Device to be used for the first subscriber; the remaining subscribers will be given consecutive lines on the same access device. Either type in the number (which must not match the access line number used by any other subscriber on this access device), or click on the ellipsis symbol at the end of the field to select from the list of numbers not currently in use. The highest line number that you can specify depends on the access device type: for an IAD it is the number of voice ports configured, for an IDT Port it is 2048, and for other devices it is a configured parameter on the access device. If you click on the ellipsis symbol, the dialog box that appears offers 'manual selection' or 'automatic selection'.
  • If you select 'automatic selection', the EMS will assign the subscriber the next free access line number for this device.
  • If you select 'manual selection', the following dialog box presents sub-ranges of access line numbers. Select the sub-range from which the number should be taken and click on Next. In the next dialog box, select a number and click on OK to accept this number. (If no number is shown, this indicates that there are no free numbers in the range; click on Back and select a different number range.)
ISDN Interface

This field is not applicable if you are configuring connection information for Business Group Lines.
If you are configuring multiple PBX Lines, do not set this field. Each PBX Line must have its own ISDN PRI; you cannot configure two PBX Lines using the same ISDN PRI.

The ISDN Primary Rate Interface that this subscriber uses to connect to the NE. This field appears, and must be supplied, only if the Call Agent signaling type field is set to ISDN PRI. Select from the displayed list of ISDN Primary Rate Interfaces that have Usage set to Access (trunk PRIs cannot be used for subscriber access). As a short-cut to select the ISDN PRI, you can type match details into the field and click on the search button to select from a list of items that match these details. If there are more than 200 PRIs, the list initially shows only the first 200, but you will be able to access any PRI by supplying match details to narrow down the search. Match details can be a text string, a wildcard string such as B*, or a range such as CA-FL. If the task you are using has already added access hardware and is now adding new subscribers to use this hardware, this field is read-only.
Cascade fault monitoring level on apply This field appears only if the Call Agent signaling type field is set to ISDN PRI, you have changed the value of the ISDN Interface field, and Fault monitoring level is set to Suppress alarms (level 5). Specifies whether to set Fault monitoring level in the specified ISDN PRI object and its underlying DS1 and TDM Ports to match the value on this subscriber. Values:
  • True
    Set Fault monitoring level on the ISDN PRI and all the underlying ports to match the value specified for this subscriber.
  • False
    Leave Fault monitoring level unchanged on the underlying objects.
Use DN for identification

This field is not applicable if you are configuring connection information for PBX Lines.

Specifies whether the subscriber registers using their directory number instead of a textual user name. This field appears only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. When this field is set to False, the SIP user name prefix is mandatory. When this field is set to True, the SIP user name prefix field is hidden.
SIP user name prefix

This field is not applicable if you are configuring connection information for PBX Lines.

This field appears only if Call Agent signaling type is set to SIP and Use DN for identification is not set to True. It is mandatory if Use DN for identification is set to False. A prefix to be used for SIP user names. The first character must be a letter (either uppercase or lowercase). Each subscriber will be given a user name starting with this prefix, followed by a number starting at 1 to distinguish between them. This field represents the user part of the SIP URI, not including the prefix or domain name. None of the names generated using this prefix can match any other SIP user name with the same domain name.
SIP domain name

This field is not applicable if you are configuring connection information for PBX Lines.

The SIP subscriber's domain name. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. Set this field to match the domain name configured on the SIP device; typically this is a DNS hostname that resolves to the MetaSwitch NE's virtual IP address, or the IP address of a Session Border Controller through which the device accesses the NE.
Maximum simultaneous registrations This field appears only if Call Agent signaling type is set to SIP. The maximum number of SIP devices that can register at the same time using this subscriber's details. See the description of SIP Call Forking in the Call Services Manual for more information. Choose Use default or specify a value in the range 1 - 32. A value of 1 means that the subscriber can have only one device registered at a time. If you allow multiple registrations, by specifying a value greater than 1, the subscriber must not use the Personal Communication Manager service (specified in the child Personal Communication Manager Service object) or flash-hook call services provided by MetaSwitch (specified in the field Flash-hook call services provided by).
Media Gateway Model

This field is not applicable if you are configuring connection information for PBX Lines.

The Media Gateway Model used by this subscriber. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. Choose Use default or select from the displayed list of SIP Media Gateway Models. To indicate that the Media Gateway Model should be selected by matching against the SIP User Agent string provided when the SIP device registers with the MetaSwitch NE, select Derived from SIP User Agent from the list. If you change the Media Gateway Model for a subscriber who is already in a call, this call continues using the existing model. The new model is used from the start of the subscriber's next call.
SIP authentication required

This field is not applicable if you are configuring connection information for PBX Lines.

Specifies whether this subscriber uses SIP authentication (and must supply authentication parameters in SIP signaling messages). This field appears, and must be supplied, only if Call Agent signaling type is set to SIP. If you are adding new subscribers or enabling SIP authentication for existing subscribers, you must also specify an initial password for the subscribers in the New SIP password and Confirm new SIP password fields. You can then update the subscribers separately to provide individual passwords for each one.
New SIP password

This field is not applicable if you are configuring connection information for PBX Lines.

The password that this subscriber uses with his or her SIP phone to register. The password is not displayed in the EMS and you cannot view it, although you can change it to a new value if necessary. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP. If you are updating existing subscribers who already use SIP authentication, leave this field unchanged. Otherwise, specify a text string of 6 - 15 characters. This is used as an initial password for the subscribers; you can then update the subscribers separately to provide individual passwords for each one.
Confirm new SIP password

This field is not applicable if you are configuring connection information for PBX Lines.

This field appears, and must be supplied, only if Call Agent signaling type is set to SIP. To confirm that you have typed the new password correctly, type it again in this field. The characters you type must exactly match the characters you typed in the New SIP password field.
Preferred location of Trunk Gateway This field appears only if Call Agent signaling type is set to SIP. Specifies the location for Trunk / Access Gateways that should be used to route calls for this object where possible (to reduce unnecessary long-distance traffic when a call can be routed on the switch). Select from the displayed list of available Location objects or None (no location).
Number of subscribers Specify the number of subscribers to be added. The maximum number of subscribers you can add depends on the access lines available on the access device you have selected; there must be a continuous range of free lines available. For example, if you select port 3 on a device that has 8 ports and no other ports on this device are in use, you will be able to add a maximum of 6 subscribers (on ports 3 - 8). However, if you select port 3 and port 6 is already in use, you will be able to add only 3 subscribers (on ports 3 - 5).

If you are adding Business Group Lines, the maximum number of subscribers is also limited by the number of free directory numbers in the parent Business Group Number Block, in the same way as for the free lines on the access device.
If you are adding PBX Lines and the Call Agent signaling type field is set to ISDN PRI, this field is set to 1 because you can add only one PBX Line for each ISDN PRI.