4.283 ent-assoc
Use this command to configure the SCTP associations in the IPAPSOCK table. This command associates the local host and local port to a remote host and remote port in the IPAPSOCK table. This command provides the association to transport protocol data units and adapter layer peer messages. Each association is connected to a process on the far end.
Parameters
- alhost (optional)
- Name of alternate local host. When specified, this parameter configures the SCTP association as a multi-homed endpoint.
- link (optional)
- The signaling link for this 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:
- a
Example
ent-assoc:aname=assoc1:lhost=gw105.nc.tekelec.com:lport=1030 :rhost=gw100.nc.tekelec.com:rport=1030:adapter=m3ua
ent-assoc:aname=assoc1:lhost=gw105.nc.tekelec.com:lport=1030 :rhost=gw100.nc.tekelec.com:rport=1030:adapter=diam
Dependencies
The value specified for the aname parameter must already exist in the IP Socket/Association (IPAPSOCK) table.
The hostnames specified in the lhost and alhost parameters must refer to different IP addresses.
The IP host names specified in the lhost and alhost parameters must exist in the IP Host table and must be provisioned as local to this EAGLE.
The hostnames specified in the lhost and alhost parameters must refer to IP addresses on the same IP card.
If the m2patset parameter is specified, then the adapter=m2pa parameter must be specified.
If the card is running an IPLIMI application, then an association with adapter=sua or m3ua cannot be assigned as a value for the lhost parameter. If the card is running the DEIRHC GPL, then the adapter type must be DIAM.
Association connection parameters (lhost, rhost, lport, rport) must be unique.
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.
There is a maximum of 50 connections (association-to-AS assignments + sockets) per Local Host on IPGWx cards.
A maximum of 4000 connections (association-to-AS assignments + sockets) are allowed per system.
If the value specified for the lhost parameter refers to an IPSG card or a DEIR card running the DEIRHC GPL, then the link parameter cannot be specified.
The value specified for the link parameter must be valid for the card and application type:
- Link A—card running the SS7IPGW or IPGWI application
- Links A - A7 and B - B7—card running the IPLIMI application
A maximum of 32 associations can be provisioned on an IPSG card.
The value specified for the host parameter must begin with an alphabetic character and can contain a..z, A..Z, 0..9, - (hyphen), or . (period). If the host name contains a hyphen, then the host name must be enclosed within quotation marks.
LHOST with REALM and RHOST with REALM are mandatory parameters for an association with adapter type DIAM.
RHOST is a mandatory parameter for a DIAM association.
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.
RHOST must be present in the IPHOST table.
Remote IP address (RHOST) must not exist in the IPLINK table.
The IP Socket/Association (IPAPSOCK) table cannot contain more than 4000 entries.
The requested buffer size increase cannot exceed the
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.
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.
Association name must be unique
The alhost or lhost should be present in IP link table
Notes
The IPAPSOCK table is used to associate the Local Host/Local Port to a Remote Host/Remote Port. This fully specifies the connection.
For a diameter association, the IPAPSOCK table is used to associate the Local Host/Local Realm/Local Port to a Remote Host/Remote Realm/Remote Port. This fully specifies the diameter connection.
SCTP associations can be configured as either uni-homed or multi-homed
endpoints. Uni-homed endpoints are SCTP associations configured with the lhost parameter specified and the alhost parameter not specified. In this case, the
lhost represents an IP address that
corresponds to either the A or B or C or D network of the IP application card (see
chg-ip-lnk
). Multi-homed endpoints are SCTP
associations configured with both the lhost and
alhost parameters specified. In this case,
the lhost represents an IP address corresponding
to one of the networks (A, B, C or D) of the IP card while the alhost represents an IP address corresponding to the
other network of the same IP card.
If a valid lhost parameter is specified that equates to a valid IP address, the lhost maps directly to a card location in the IP Link table, which can then determine the card’s application (IPLIMx or SS7IPGWx). If the application is an IPLIMx, two additional validation checks are made:
- The adapter parameter value must equal m3ua or m2pa.
- The ipliml2 value for the IPLIMx signaling link must be the same as the association adapter parameter value.
- The ipliml2 value for an IPLIMx signaling link cannot be set to m3ua.
If the determination of the application running on the
card or the signal link cannot be performed when the
ent-assoc
command is executed, the
check will be performed by the
chg-assoc
command.
An association with an adapter value of m2pa cannot be assigned to an SS7IPGW or IPGWI host.
There are fields in the IPAPSOCK table that receive
default values even though there are no parameters on this command for changing
those fields. If a different value is desired, the
chg-assoc
command must be used. The
chg-assoc
command can also be used if
the hostnames are too long to fit on the command line with other parameters.
The fields in question and their default values are:
- open=no
- alw=no
- rmode=lin
- rmin=120
- rmax=800
- rtimes=10
- cwmin=3000
- ver=rfc
- istrms=2
- ostrms=2
For the M2PA RFC feature, when the application is IPLIMx and the adapter=m2pa parameter is specified, the supported M2PA version is set to M2PA RFC by default.
For the S13/S13' EIR feature, if the E5-SM8G-B card is running the DEIRHC GPL, an adapter other than diam cannot be specified.
Output
ent-assoc:aname=assoc1:lhost=gw105.nc.tekelec.com:lport=1030
:rhost=gw100.nc.tekelec.com:rport=1030:adapter=m3ua
rlghncxa03w 04-02-17 15:35:05 EST EAGLE 31.3.0
ENT-ASSOC: MASP A - COMPLTD
;
Related Topics