4.38 chg-assoc
Use this command to configure existing SCTP associations in the IPAPSOCK table.
Parameters
- alhost (optional)
- Alternate local host name. This parameter
configures the SCTP association as a multi-homed endpoint.
- Range:
-
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz
Any string of characters beginning with a letter and comprising up to 60 characters in length
Valid characters are a–z, A–Z, 0–9, - (dash), . (period)
none —The alhost is not configured; the SCTP association is configured as a uni-homed endpoint.
- alw (optional)
- The parameter specifies whether the connection manager should allow or disallow the association to carry SS7 traffic.
- cwmin (optional)
- Minimum congestion window. The minimum and initial sizes, in bytes, of the association’s congestion window.
- hbtimer (optional)
- Heartbeat timer in milliseconds. The Heartbeat timer value + RTO (Retransmission Time Out) is the value of heartbeat interval at which heartbeat request should be sent.
- istrms (optional)
- SCTP Inbound Stream Value. A 16-bit unsigned integer that defines the number of streams the sender allows the peer end to create in this association.
- lhost (optional)
- Local host name. The local host name as defined in the IP Host table.
- link (optional)
-
Signaling link for the association.
- Synonym:
- port
- Range:
- a, b, a1 - a63, b1 -
b63
Not all card types support all link parameter values.
See Table A-1 for valid link parameter range values for each type of card that can have assigned signaling links.
- Default:
- No change to the current value
- open (optional)
- Connection state (open or closed) that the
connection manager is to put the association in when the socket is operational.
The
chg-assoccommand allows initiation of SCTP graceful shutdown on a per association basis for IPSG M3UA associations or diameter connections (maintained in the DCONN table) . Thechg-assoc:open=nocommand aborts the association and closes the diameter connection (if associated) unless graceful shutdown is provisioned (see thechg-uapscommand). If provisioned, then SCTP graceful shutdown for an association occurs after execution ofchg-assoc:open=no.
- ostrms (optional)
- SCTP Outbound Stream Value. The 16-bit unsigned integer that defines the number of streams the sender wants to create in this association.
- rhost (optional)
- Remote host. The name of the remote host as defined in the IP Host table.
- rhosttype (optional)
- Remote host type. This parameter specifies whether
the remote host is a primary or alternate remote address.
Note:
The alternate remote address is used for multi-homed remote hosts.
- rhostval (optional)
- Remote host validation. The validation mode for
the association when an SCTP INIT/INIT-ACK message is received.
- Range:
-
- match
-
accept the message if the message contains the primary remote host value and the alternate remote host value (if the alternate remote host is provisioned). If the alternate remote host is not provisioned, then accept the message if the message contains the primary remote host value. Reject the message if it contains any IP address other than that of the primary or alternate remote host.
The rules determining the use of the relaxed and match modes depend on multiple conditions, including whether an alternate remote host is provisioned. See Table 4-4 for validation rules that are used to establish an association for the relaxed and match modes.
- relaxed
- accept the message if the IP address for the primary or alternate remote host matches the IP address, source IP address, or host name in the message
- Default:
- No change to the current value
- System Default:
- relaxed
- rmax (optional)
- Maximum retransmission timeout. The maximum value of the calculated retransmission timeout in milliseconds.
- rmin (optional)
- Minimum retransmission timeout. The minimum value of the calculated retransmission timeout in milliseconds.
- rmode (optional)
- Retransmission mode. The retransmission policy
used when packet loss is detected.
- Range:
-
- lin
- The Oracle Linear Retransmission Policy where each retransmission timeout value is the same as the initial transmission timeout, and only the slow start algorithm is used for congestion control.
- rfc
- Standard RFC 2960 algorithm in the retransmission delay doubles after each retransmission. The RFC 2960 standard for congestion control is also used.
- Default:
- No change to the current value
- System Default:
- lin
- rtimes (optional)
- Maximum retransmission retries. The number of times a data retransmission will occur before closing the association.
- rtxthr (optional)
- Retransmission threshold. The value of the retransmission threshold to tune the IP Connection Excess Retransmits alarm.
- uaps (optional)
- User adapter parameter set. The set used by the M3UA, SUA or M2PA associations for various timer and parameter values including False IP Connection Congestion Timer, UA Heartbeat Period Timer, UA Heartbeat Received Timer, ASP SNM options, ASP/AS Notifications, UA Serviceability options, and Payload Protocol Indicator byte order option.
Example
chg-assoc:aname=a1:lhost=gw105.nc.tekelec.com:lport=1030: rhost=gw100.nc.tekelec.com:rport=1030:open=yes:alw=yes:uaps=10
chg-assoc:aname=m3ua03:rtxthr=65535
chg-assoc:aname=a1:lhost=tek1.com:lport=1030:rport=1030:rhost=tek2.com: rhostval=match:rhosttype=primary
chg-assoc:aname=a1:rhost=tek.com:rhostval=relaxed:rhosttype=alternate
chg-assoc:aname=assoc1:adapter=diam
chg-assoc:aname=a1:hbtimer=1000
Dependencies
At least one optional parameter must be specified.
The value specified for the aname parameter must already exist in the IPAPSOCK table.
An association’s connection parameters (lhost, rhost, lport, rport) must be unique.
The connection state must be open=no to change the lhost, rhost, lport, rport, port, alhost, adapter, m2patset, istrms, ostrms, rmode, rmin, rmax, rtimes, cwmin, bufsize, and hbtimer parameters.
The lhost, lport, rhost, and rport parameters must be specified before the open=yes parameter can be specified. The aname parameter and at least one other optional parameter must be specified before the open=no parameter can be specified.
The value of the uaps parameter can be changed for an association if the open=yes parameter is specified.
The hostnames specified in the lhost and alhost parameters must refer to different IP addresses.
The hostnames specified in the lhost and alhost parameters must refer to IP addresses on the same IP card.
If the LHOST is defined on Port A its ALHOST must be on PORT B.
If the LHOST is defined on Port B its ALHOST must be on PORT A.
If the LHOST is defined on Port C, its ALHOST must be PORT D.
If the LHOST is defined on Port D, its ALHOST must be PORT C.
An association with an SUA or M3UA adapter cannot be specified as a local host on a card running the IPLIMI application.
An association with an M2PA adapter cannot be specified as a local host on a card running the SS7IPGW or IPGWI application.
An association with an SUA adapter cannot be specified as the local host on a card running the IPSG application.
The local host must have a signaling link assigned to its associated signaling link port before the open=yes parameter can be specified.
The adapter layer cannot be changed for an association that is already associated with an Application Server (AS).
Before the local host can be changed, the new local host must have a signaling link assigned to its associated signaling link port.
Links A-A7 and B-B7 can be specified for an E5-ENET-B or SLIC card running the IPLIMI application.
The card location for the card associated with the lhost and alhost must exist in the IP Link table.
The allowed maximum is 1 association per signaling link on IPLIMx cards.
A maximum of 50 connections (association-to-AS assignments) can be specified per local host on IPGWx cards.
A maximum of 4000 connections (association-to-AS assignments + sockets) are allowed per system.
Table 4-3 shows the maximum number of associations and links for E5-ENET-B cards.
Table 4-3 Maximum IP Associations and Links
| GPL | Max # of Associations | Max # of Links |
|---|---|---|
|
IPLHC |
16 |
16 |
|
IPGHC |
50 |
1 |
|
IPSG |
32 |
32 |
|
IPSG on SLIC |
128 |
128 |
|
DEIRHC |
32 |
- |
The rmin parameter value must be less than or equal to the rmax parameter value.
The cwmin parameter value must be less than or equal to the bufsize parameter value.
If the m2patset parameter is specified, the adapter=m2pa parameter must be specified.
The trade ratio states the quantity of associations to sockets that may be provisioned on a certain card, as follows:
- Trade Ratio = a:s
- Where: a=associations and s=sockets
The requested buffer size increase cannot exceed
available buffer space on the card. Use the
rtrv-assoc command with the aname, lhost, or
alhost parameter to display used and
total buffer space on the card.
The ver parameter can only be specified if the adapter=m2pa parameter is specified.
If the value specified for the lhost parameter indicates an IPSG card or DEIR card running the DEIRHC GPL, then the link parameter cannot be specified.
If an IPSG card is being used, and if the association is referenced by a signaling link, then new values cannot be specified for the lhost or adapter parameters.
An IPSG card running on E5--ENET-B card or DEIR card can contain a maximum of 32 associations.
An IPSG application running on the SLIC card can contain a maximum of 128 associations.
If the value specified for the aname parameter refers to an M3UA association on an IPSG card, then the alw parameter cannot be specified.
The value specified for the lhost parameter cannot change the local host for the association from an IPLIMx or IPGWx card to an IPSG card or from an IPSG card to an IPLIMx or IPGWx card.
The rhosttype=primary parameter must be specified before the rhosttype=alternate parameter can be specified.
If the rhosttype parameter is specified, then the rhost parameter must be specified.
The value specified for the alternate remote host cannot be the same as the value specified for the lhost, alhost, or rhost parameter in the same association.
The value specified for the rhost parameter cannot be the same as the value specified for the alternate remote host or for the lhost or alhost parameter in the same association.
The host name specified by the lhost parameter must exist in the IP Host table and must be provisioned as local to this EAGLE.
A valid value must be specified for the host parameter. If the host name contains a hyphen, then the host name must be enclosed within quotation marks.
Realm must be associated with the RHOST specified in the IPHOST table for diameter association.
RHOST must be present in the IPHOST table.
Remote IP address (RHOST) must not exist in the IPLINK table.
The local host name (lhost) parameter must be configured before the alternate local host name (alhost) parameter is configured.
The allowed maximum is 1 connection per signaling link on IPLIMx cards.
No two open associations can have the same value for the LHOST/LPORT parameters.
IP address associated with the LHOST and ALHOST should be of the same IP version.
IP address associated with the LHOST and RHOST should be of the same IP version.
Notes
The command that is entered cannot exceed a total of 150 characters in length.
The IPAPSOCK table is used to associate the Local Host/Local Port to a Remote Host/Remote Port. This fully specifies the connection.
If the open=yes parameter is specified, the association’s lhost and lport configuration must not match that of any open association.
If the card’s application is IPLIMI, then the adapter parameter value and the ipliml2 value for the assigned signaling link must be m2pa.
An association with an adapter value of m2pa cannot be assigned to an SS7IPGW or IPGWI host.
For diameter associations (adapter=DIAM), realm must be associated with lhost and rhost parameters before open=yes parameter can be specified.
The link parameter is not allowed with diameter associations (adapter=DIAM).
While entering arhost for an alhost, the user needs to specify rhost parameter with rhosttype= alternate.
If none is specified for either alhost or rhost, that parameter is removed from the association's entry.
To delete an arhost, the user needs to specify rhost=none with rhosttype=alternate.
The M2PA version is supported if the application is IPLIMx and the adapter=m2pa parameter is specified. When changing the association adapter type to m2pa and a version is not specified, the m2pa=rfc value is assigned by default.
Table 4-4 shows the validation rules used to establish an association.
Table 4-4 Validation Rules for Association Establishment
| RHOSTVAL | RHOST Configured | ARHOST Configured | Source Parameter in IP Header | IP Address List in INIT/INIT ACK | Host Name Address Present in INIT/INIT ACK |
|---|---|---|---|---|---|
|
RELAXED |
Y |
N |
RHOST |
NA (1 or more IP addresses can be present, not necessarily match RHOST.) |
N |
|
RELAXED |
Y |
N |
NA |
RHOST (other IP addresses can also be present) |
N |
|
RELAXED |
Y |
N |
RHOST |
NA |
RHOST |
|
MATCH |
Y |
N |
RHOST |
N |
N |
|
MATCH |
Y |
N |
RHOST |
RHOST only (no additional addresses can be present) |
N |
|
MATCH |
Y |
N |
RHOST |
NA |
RHOST only |
|
RELAXED |
Y |
Y |
RHOST or ARHOST |
NA |
N |
|
RELAXED |
Y |
Y |
NA |
RHOST or ARHOST |
N |
|
RELAXED |
Y |
Y |
Same as Hostname |
NA (Ignore any IP addresses present) |
RHOST or ARHOST |
|
MATCH |
Y |
Y |
RHOST |
ARHOST must be present. RHOST can also be present. No other additional addresses. |
N |
|
MATCH |
Y |
Y |
ARHOST |
RHOST must be present. ARHOST can also be present. No other additional addresses |
N |
Output
chg-assoc:aname=a1:lhost=gw105.nc.tekelec.com:lport=1030:rport=1030:
uaps=10:rhost=gw100.nc.tekelec.com:alw=yes:rhostval=match:rhosttype=primary
rlghncxa03w 09-03-19 15:35:05 EST EAGLE 41.0.0
CHG-ASSOC: MASP A - COMPLTD
;