Adding an M2PA Association
This procedure is used to configure M2PA associations using the ent-assoc
command. The combination of a local host, local SCTP port, remote host and remote SCTP port defines an association. M2PA associations are assigned to cards running either the IPLIM or IPLIMI applications (IPLIMx cards).
The ent-assoc
command uses these parameters:
:aname
– The name assigned to the association. Valid association names can contain up to 15 alphanumeric characters where the first character is a letter and the remaining characters are alphanumeric characters. The aname
parameter value is not case-sensitive.
:lhost
– Local Hostname. The logical name assigned to the local host device.
:lport
– The SCTP port number for the local host.
:rhost
– Remote Hostname. The logical name assigned to the remote host device.
:rport
– The SCTP port number for the remote host.
:link
– The signaling link on the IP card. If a signaling link is not specified for a association when it is entered, the association defaults to signaling link A. If the card is an E5-ENET or E5-ENET-B card, the values for the link
parameter can be a
, a1
, a2
, a3
, a4
, a5
, a6
, a7
, b
, b1
, b2
, b3
, b4
, b5
, b6
, or b7
.
Note:
Theport
parameter can be used in place of the link
parameter to specify the signaling link on the card.
:adapter
– The adapter layer for this association, m2pa
. The adapter
parameter is optional. The default value for the adapter
parameter is m2pa
.
:alhost
– The alternate local host name.
:m2patset
– The M2PA timer set assigned to the association. The m2patset
parameter can be specified only with the adapter=m2pa
parameter. If the adapter=m2pa
parameter is specified, and the m2patset
parameter is not specified with the ent-assoc
command, the default value for the m2patset
parameter (1 - M2PA timer set 1) is assigned to the association.
Associations contain fields whose values are not assigned using the ent-assoc
command. When an association is added to the database, these fields receive their default values. If a different value is desired, the chg-assoc
command must be used. To change these values perform the Changing the Attributes of an M2PA Association procedure.
These fields and their default values are shown in Table 3-6.
Table 3-6 M2PA Association Fields and Default Values
|
|
|
|
|
|
|
|
|
|
ver=rfc
|
bufsize=200
|
rtxthr=0
|
rhostval=relaxed
|
An M2PA association that is assigned to an IPLIMx signaling link can contain a UA parameter set value (the uaps
parameter). The uaps
parameter cannot be specified with the ent-assoc
command. The default value for the uaps
parameter is 10. While the uaps
parameter value can be changed with the chg-assoc
command, the uaps
parameter value has no impact on the traffic carried by an M2PA association that is assigned to an IPLIMx signaling link.The uaps
parameter value impacts M3UA or SUA associations that are assigned to IPGWx signaling links and M2PA and M3UA associations that are assigned to IPSG cards. The uaps
parameter value is shown in the UAPS
field in the rtrv-assoc
output for an M2PA associations that is assigned to an IPLIMx signaling link.
An M2PA association can contain an alternate remote host. The alternate remote host is provisioned with the rhost
and rhostype=alternate
parameters of the chg-assoc
command. A primary remote host can be provisioned in this procedure by specifying the rhost
parameter with the ent-assoc
command. To provision an alternate remote host for an M2PA association, perform Changing the Attributes of an M2PA Association.
The size of the buffers on the on the E5-ENET and E5-ENET-B cards are shown in the following list.
- E5-ENET Card and E5-ENET-B - 3200 KB
The size of the buffers assigned to each association that is assigned to the IP card cannot exceed the maximum buffer size for the IP card. When a new association is added, the default buffer size for the association is assigned to the association. If adding the new association causes the total buffer size for all the associations on the IP card to exceed the maximum buffer size for that IP card, the ent-assoc
command will be rejected. If the you wish to add the association and the maximum buffer size for the IP card will be exceeded, the buffer size of the other associations assigned to the IP card must be decreased by performing the Changing the Buffer Size of a M2PA Association procedure. The available size of the buffers on the IP card can be verified by entering this command.
rtrv-assoc:lhost=<local host name assigned to the association being changed>
The alhost
parameter can also be used with the rtrv-assoc
command to display the available size of the buffers on the IP card.
The aname
parameter can be used with the rtrv-assoc
command to display the available size of the buffers on the IP card and the size of the buffer assigned to the association.
The value of the lhost
, rhost
, or alhost
parameters is a text string of up to 60 characters, with the first character being a letter. The command line on the terminal can contain up to 150 characters. If the host names are too long to fit on the ent-assoc
command line, perform the chg-assoc
command with the parameters and values necessary to complete the entry of the M2PA association.
The EAGLE can contain a maximum of 4000 connections (association to application server assignments).
IPLIMx cards can contain one association for each signaling link on the card. The E5-ENET card can contain a maximum of 16 signaling links, resulting in a maximum of 16 associations for this card.
The B Ethernet interface of the IP card can be used on the E5-ENET card.
If the association is to be activated in this procedure, with the chg-assoc
command, the association must contain values for the lhost
, lport
, rhost
, rport
parameters.
The ipliml2
parameter value of the signaling link assigned to the association must be m2pa
. The adapter
parameter value of the association must be m2pa
.
The signaling link being assigned to the association must be out of service. This state is shown in the rept-stat-slk
output with the entries OOS-MT
in the PST
field and Unavail
in the SST
field.
If the association is being opened in this procedure with the chg-assoc
command and the open=yes
parameter, the signaling link assigned to the association must be in the database and the ipliml2
parameter value of the signaling link assigned to the association must be m2pa
.
Uni-homed endpoints are associations configured with the lhost
parameter only. The lhost
parameter value represents an IP address that corresponds to either the A or B network interface of the IP card. Multi-homed endpoints are associations configured with both the lhost
and alhost
parameters. The lhost
parameter value represents an IP address corresponding to one of the network interfaces (A or B) of the IP card while the alhost
parameter value represents an IP address corresponding to the other network interface of the same IP card.
An alternate remote host can be configured for multi-homed associations using the rhost
and rhosttype
parameters of the chg-assoc
command. The rhost
parameter value with the rhostype=primary
parameter represents an IP address that corresponds to one of the network interfaces at the remote end while the rhost
parameter value with the rhostype=alternate
parameter represents an IP address that corresponds to the other network interface at the remote end.
Canceling the RTRV-ASSOC
Command
Because the rtrv-assoc
command used in this procedure can output information for a long period of time, the rtrv-assoc
command can be canceled and the output to the terminal stopped. There are three ways that the rtrv-assoc
command can be canceled.
-
Press the
F9
function key on the keyboard at the terminal where thertrv-assoc
command was entered. -
Enter the
canc-cmd
without thetrm
parameter at the terminal where thertrv-assoc
command was entered. -
Enter the
canc-cmd:trm=<xx>
, where<xx>
is the terminal where thertrv-assoc
command was entered, from another terminal other that the terminal where thertrv-assoc
command was entered. To enter thecanc-cmd:trm=<xx>
command, the terminal must allow Security Administration commands to be entered from it and the user must be allowed to enter Security Administration commands. The terminal’s permissions can be verified with thertrv-secu-trm
command. The user’s permissions can be verified with thertrv-user
orrtrv-secu-user
commands.
For more information about the canc-cmd
command, go to Commands User's Guide.
Figure 3-7 Adding an M2PA Association
Sheet 1 of 3
Sheet 2 of 3
Sheet 3 of 3