Configuring a SIP AG Interface
You can configure a SIG AG interface to connect SIP users to the IMS for voice, data, and multimedia services.
Context
If users want to connect to the IMS for voice, data, and multimedia services, a SIP AG interface must be configured for registration on the IMS. SIP AG users connect to the IMS through the SIP AG interface to use voice, data, and multimedia services.
To allow the SIP AG and IMS network to exchange media and signaling streams, set the media and signaling IP addresses, signaling port number, and transmission protocol.
Procedure
- Run:
system-view
The system view is displayed.
- Run:
voice
The voice view is displayed.
- Run:
SIP AG SIP AG-interface-id
A SIP AG interface is created and the SIP AG interface view is displayed.
- Set mandatory parameters on the SIP AG interface.
Parameter
Command
Remarks
Media IP address
media-addr { media-ip | addr-name media-addr-name }
The media IP address of the SIP AG interface must be obtained from the media IP address pool.
By default, no media IP address or media IP address name is configured for a SIP AG.
Signaling IP address and signaling port number
signalling-addr { signal-ip | addr-name signal-addr-name } signal-port
The signaling IP address of the SIP AG interface must be obtained from the signaling IP address pool.
By default, no signaling port number is configured for a SIP AG interface.
Parameters of the primary proxy serverNOTE:The four parameters for the primary proxy server cannot be configured simultaneously. Only the latest configuration takes effect.
Static IP address
primary-proxy-addr static static-ip-address static-ip-address-port [ secondary static-ip-address2 ]
By default, no static IP address is configured for the primary proxy server.
DNS-A domain name and port number
primary-proxy-addr dns-a dns-a-domain-name dns-a-port-number
When this command is used to configure the primary proxy server, the SIP AG can be redirected for registration.
By default, no DNS-A domain name or port number is configured for the primary proxy server.
DNS-NAPTR domain name
primary-proxy-addr dns-naptr dns-naptr-domain-name
When this command is used to configure the primary proxy server, the SIP AG can be redirected for registration.
By default, no DNS-NAPTR domain name is configured for the primary proxy server.
DNS-SRV domain name
primary-proxy-addr dns-srv dns-srv-domain-name
When this command is used to configure the primary proxy server, the SIP AG can be redirected for registration.
By default, no DNS-SRV domain name is configured for the primary proxy server.
- Run:
reset
The SIP AG is reset.
Exercise caution when you run this command because resetting a SIP AG affects running services.
Do not frequently modify SIP AG interface parameters. Reset the SIP AG to make the configuration take effect.
- Run:
quit
Return to the voice view.
- (Optional) Run:
local-digitmap name-value { append | type { normal | emergency | scc | direct-centrex | second-centrex } }body-value
The digitmap is configured.
- (Optional) Set optional parameters on the SIP AG interface.
Parameter Command Remarks The SIP AG interface view is displayed
SIP AG SIP AG-interface-id
Enter the SIP AG interface ID that is created in step 3 and run this command to enter the SIP AG interface view. If a new SIP AG interface ID is entered, this command creates the SIP AG interface and displays the SIP AG interface view.
Transmission protocol
transfer transfer-protocol
Enumerated type. The values are as follows:- TCP: specifies the Transmission Control Protocol (TCP) as the transmission protocol.
- UDP: specifies UDP as the transmission protocol.
- SCTP: specifies SCTP as the transmission protocol.
By default, a SIP AG interface uses the User Datagram Protocol (UDP) protocol as the transmission protocol.
Home domain name
home-domain home-domain-value
By default, no home domain name is configured for a SIP AG interface.
Description description description By default, no description is configured for a SIP AG interface. Profile index profile profile-index By default, the profile index of a SIP AG interface is 1. Domain name ag-domain ag-domain-name By default, no domain name is configured for a SIP AG interface. Conference factory URI conference-factory-uri uri By default, no conference factory URI is configured for a SIP AG interface. Authentication parameters Authentication mode auth mode mode-value Enumerated type. The values are as follows:By default, the authentication mode is user.- interface: configures all the users connected to a SIP AG to share the same authentication user name.
- user: specifies an IP Multimedia Subsystem Private Identity (IMPI) for a user.
Authentication user name and password auth username auth-username password { cipher cipher-password | ha1 cipher cipher-password } By default, no authentication user name or password is configured for a SIP AG user. Timer value digitmap-timer { long long-timer-value | short short-timer-value | start start-timer-value } By default, the value of a digitmap long timer is 20s, the value of a digitmap short timer is 4s, and the value of a digitmap start timer is 20s. DTMF parameters dtmf-transmission-mode { throughly | erase } By default, the DTMF transmission mode is transparent transmission. Fax/Modem parameters Fax/Modem codec negotiation mode fax-modem common negotiation-mode { negotiate | self-switch } By default, the fax/modem codec negotiation mode is negotiation. Packetization interval in transparent transmission mode fax-modem common rtp-interval { 5ms | 10ms | 20ms | 30ms } By default, the packetization interval in transparent transmission mode is 10 ms. VBD attribute type fax-modem common vbd-attribute-type { chinatelecom | extchinatelecom | ietf | v152 } By default, the VBD attribute type is V.152. VBD codec mode fax-modem common vbd-codec { g711a | g711u } By default, the VBD codec mode is A-law algorithm in G.711. VBD payload type fax-modem common vbd-pt-type { dynamic | static } By default, the VBD payload type is static. Fax transmission mode fax-modem fax transmission-mode { throughly | t38 } By default, the fax transmission mode of a SIP AG interface is transparent transmission. Modem transmission mode fax-modem modem transmission-mode { throughly | relay } By default, the modem transmission mode of a SIP AG interface is transparent transmission. Parameters of the secondary proxy server Static IP address and port number secondary-proxy-addr static static-ip-address static-ip-address-port [ secondary static-ip-address2 ] By default, no static IP address or port number is configured for the secondary proxy server.
DNS-A domain name and port number secondary-proxy-addr dns-a dns-a-domain-name dns-a-port-number By default, no DNS-A domain name or port number is configured for the secondary proxy server.
DNS-NAPTR domain name secondary-proxy-addr dns-naptr dns-naptr-domain-name By default, no DNS-NAPTR domain name is configured for the secondary proxy server.
DNS-SRV domain name secondary-proxy-addr dns-srv dns-srv-domain-name By default, no DNS-SRV domain name is configured for the secondary proxy server.
Mode used for sending DHCP Request messages proxy-dhcp-option option-value By default, the mode used for sending DHCP Request messages is none. Control points ag number-parameter name value Different control points may use different value ranges. For details, see ag number-parameter. String parameters ag string-parameter strpara-name strpara-value For details about string parameters, see ag string-parameter. RFC 2833 transmission RFC 2833 DTMF transmission nte-dtmf { enable | disable } By default, RFC 2833 DTMF transmission is enabled. RFC 2833 fax and modem transmission nte-fax-modem { enable | disable } By default, RFC 2833 fax and modem transmission is enabled. RFC 2833 hookflash transmission nte-flash-hook { enable | disable } By default, RFC 2833 hookflash transmission is disabled. Mode in which RFC 2833 transmission is started based on negotiation nte-negotiation-mode mode-value By default, RFC 2833 redundancy transmission is started based on negotiation in passive-nego mode. Proxy functions Mode used by a SIP AG to detect a proxy server proxy-detect-mode { option | probe | register } By default, a SIP AG uses the probe mode to detect a proxy server. Mode in which a SIP AG is dual homed to proxy servers proxy-dual-home { disable | manual-switchover | auto-switchover } By default, a SIP AG supports dual homing but does not support automatic switchover. Mode used by a SIP AG to update the proxy server address proxy-refresh-mode { no-switch | defer | immediate } By default, a SIP AG updates the proxy server IP address after a delay (defer mode).
Registration of a SIP AG with the specified proxy server proxy-switchover { primary | secondary } To maintain or troubleshoot the current proxy server, run this command. RFC 2198 redundancy transmission Mode in which RFC 2198 redundancy transmission is started redundancy-negotiation-mode negotiation-mode By default, RFC 2198 redundancy transmission is started in no-initiative-start mode. Transmission of RFC 2833 audio data using RFC 2198 redundancy transmission redundancy-nte { enable | disable } By default, a SIP AG is disabled from using RFC 2198 redundancy transmission to transmit the RFC 2833 audio data. Mode in which RFC 2198 redundancy transmission is started redundancy-start-mode mode-value By default, RFC 2198 redundancy transmission is started in ordinary mode. VBD transmission using RFC 2198 redundancy transmission redundancy-vbd { enable | disable } By default, a SIP AG is enabled to transmit VBD using RFC 2198 redundancy transmission. Voice transmission using RFC 2198 redundancy transmission redundancy-voice { enable | disable } By default, a SIP AG does not use RFC 2198 redundancy transmission to transmit voice.
Registrar URI register-server-uri uri By default, no registrar URI is configured for a SIP AG. Ringing parameters ring-mode index ringmode-name [ cadence-ring cadencering-value | initial-ring initialring-value ] * By default, ringing parameters of a SIP AG is empty. SCTP stack parameters sctp { assoc-maximum-retransmission assoc-max-retrans | checksum-arithmetic checksum-arith | heartbeat-interval hb-interval | high-congestion-level high-congestion-level-value | in-stream-number in-stream-num | low-congestion-level low-congestion-level-value | maximum-init-retransmission max-init-retrans | no-congestion-level no-congestion-level-value | out-stream-number out-stream-num | path-maximum-retransmission path-max-retrans | rto-alpha rto-alpha-value | rto-beta rto-beta-value | rto-init rto-init-value | rto-maximum rto-max | valid-cookie-life valid-cookie-life-value } After SCTP stack parameters are set, reset the SIP AG to make SCTP stack parameters take effect. SDP negotiation mode sdp-negotiation-mode { local | remote } By default, the remote priority mode is used for SDP negotiation. Index of the service logic used by a SIP AG service-logic service-logic-index By default, the service logic index of a SIP AG is 0. Mapping between a call scenario and a status code status-code-mapping scene status-code After configuring the status code of a call scenario, reset the SIP AG to make the configuration take effect. MWI subscription function MWI subscription function subscribe mwi { enable | disable } By default, the MWI subscription function is disabled. Register status subscription function subscribe reg { enable | disable } By default, the register status subscription function is disabled. UA profile subscription function subscribe ua-profile { enable | disable } By default, the UA profile subscription function is enabled on a SIP AG.
Codec priority, codec value, and packetization interval user-defined-profile codec-priority pri-value codec-value pt-value Run the profile command to set profile to 0. If you change the priority of a codec value, priorities of other codec values are also changed. Control point with a specified sequence number user-defined-profile number-parameter strpara-no strpara-value Sets the control point with a specified sequence number for a SIP AG. Priority of a service type user-defined-profile service-priority pri-value srvid-value If you change the priority of a service type, priorities of other service types are also changed. - Run:
save
The configuration is saved.