Adding an M3UA or SUA Association

This procedure is used to configure M3UA or SUA associations using the ent-assoc command. The combination of a local host, local SCTP port, remote host and remote SCTP port defines an association. M3UA and SUA associations are assigned to cards running either the SS7IPGW or IPGWI applications (IPGWx 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. The value for the link parameter for M3UA or SUA associations is A.

Note:

The port 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, either m3ua or sua. The adapter parameter is optional. The default value for the adapter parameter is m3ua.

:alhost – The alternate local host name.

The adapter=m2pa and m2patset parameters can be used only when configuring M2PA associations. Perform the Adding an M2PA Association or Adding an IPSG M2PA Association procedures to configure M2PA associations.

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 a M3UA or SUA Association procedure.

These fields and their default values are shown in Table 4-7.

Table 4-7 M3UA and SUA Association Fields and Default Values

open=no

rmax=800

cwmin=3000

alw=no

uaps=10

istrms=2

rmode=lin

rtimes=10

ostrms=2

rmin=120

bufsize=16 rtxthr=0 rhostval=relaxed  

An M3UA or SUA association can contain an alternate remote host. The alternate remote host is provisioned with the rhostand rhostype=alternate parameters of the chg-assoc command. A primary remote host can be provisioned on this procedure by specifying the rhost parameter with the ent-assoc command. To provision an alternate remote host for an M3UA or SUA association, perform Changing the Attributes of a M3UA or SUA Association.

The size of the buffers on the E5-ENET card is shown in the following list.

  • E5-ENET Card - 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 M3UA or SUA 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 M3UA or SUA association.

The EAGLE can contain a maximum of 4000 connections (association to application server assignments).

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 signaling link being assigned to the association must be in service. This state is shown in the rept-stat-slk output with the entries IS-NR in the PST field and Avail in the SST field.

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 the rtrv-assoc command was entered.
  • Enter the canc-cmd without the trm parameter at the terminal where the rtrv-assoc command was entered.
  • Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-assoc command was entered, from another terminal other that the terminal where the rtrv-assoc command was entered. To enter the canc-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 the rtrv-secu-trm command. The user’s permissions can be verified with the rtrv-user or rtrv-secu-user commands.

For more information about the canc-cmd command, go to Commands User's Guide.

  1. Display the associations in the database using the rtrv-assoc command. This is an example of possible output.
    
    rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
                    CARD IPLNK
    ANAME           LOC  PORT  LINK ADAPTER LPORT RPORT OPEN ALW
    swbel32         1201 A     A    M3UA    1030  2345  YES  YES
    a2              1305 A     A    SUA     1030  2345  YES  YES
    a3              1307 A     A    SUA     1030  2346  YES  YES
    assoc3          1203 A     A1   M2PA    2048  1030  NO   NO
    
    Perform one of these actions.
    • If SUA associations are assigned to the desired IP link (shown by the entries in the CARD LOC and IPLNK PORT columns for an association whose ADAPTER value is SUA in the rtrv-assoc output), continue the procedure with 5.
    • If M3UA associations are assigned to the desired IP link (shown by the entries in the CARD LOC and IPLNK PORT columns for an association whose ADAPTER value is M3UA in the rtrv-assoc output), continue the procedure with 2.
    • If the desired IP link is not shown in the rtrv-assoc output, continue the procedure with 3.
  2. Display the signaling links assigned to the card that the new M3UA association will be assigned to by entering the rtrv-slk command with the card location displayed in 1. For this example, enter this command.

    rtrv-slk:loc=1201

    The following is an example of the possible output.

    rlghncxa03w 08-04-06 10:07:25 GMT EAGLE5 38.0.0
    
    LOC  LINK LSN         SLC TYPE
    1201 A    lsn1        0   SS7IPGW
    

    If the value in the TYPE column is either SS7IPGW or IPGWI, continue the procedure with 5.

    If the value in the TYPE column is IPSG, the links and host assigned to this card cannot be used in this procedure. If you wish to use this card to configure an M3UA association, perform the Adding an IPSG M3UA Association procedure.

    If you do not wish to use this card to configure an M3UA association, perform one of these actions.
    • Choose another card from the rtrv-assoc output in 1 and repeat this step.
    • Continue the procedure with 3 to choose another IPGWx card and IP link for the new association.
  3. Display the IP links in the database by entering the rtrv-ip-lnk command. The following is an example of the possible output.
    
    rlghncxa03w 08-12-28 21:14:37 GMT EAGLE5 40.0.0
    LOC   PORT IPADDR          SUBMASK         DUPLEX  SPEED MACTYPE AUTO MCAST
    1201  A    192.1.1.10      255.255.255.128 HALF    10    802.3   NO   NO
    1201  B    --------------- --------------- HALF    10    DIX     NO   NO
    1203  A    192.1.1.12      255.255.255.0   ----    ---   DIX     YES  NO
    1203  B    --------------- --------------- HALF    10    DIX     NO   NO
    1205  A    192.1.1.14      255.255.255.0   FULL    100   DIX     NO   NO
    1205  B    --------------- --------------- HALF    10    DIX     NO   NO
    2101  A    192.1.1.20      255.255.255.0   FULL    100   DIX     NO   NO
    2101  B    --------------- --------------- HALF    10    DIX     NO   NO
    2103  A    192.1.1.22      255.255.255.0   FULL    100   DIX     NO   NO
    2103  B    --------------- --------------- HALF    10    DIX     NO   NO
    2105  A    192.1.1.24      255.255.255.0   FULL    100   DIX     NO   NO
    2105  B    --------------- --------------- HALF    10    DIX     NO   NO
    2205  A    192.1.1.30      255.255.255.0   FULL    100   DIX     NO   NO
    2205  B    --------------- --------------- HALF    10    DIX     NO   NO
    2207  A    192.1.1.32      255.255.255.0   FULL    100   DIX     NO   NO
    2207  B    --------------- --------------- HALF    10    DIX     NO   NO
    2213  A    192.1.1.50      255.255.255.0   FULL    100   DIX     NO   NO
    2213  B    --------------- --------------- HALF    10    DIX     NO   NO
    2301  A    192.1.1.52      255.255.255.0   FULL    100   DIX     NO   NO
    2301  B    --------------- --------------- HALF    10    DIX     NO   NO
    
    IP-LNK   table is (20 of 2048) 1% full.
    

    If the required IP link is not in the database, add the IP link using the Configuring an IP Link procedure.

  4. Verify that the local host name to be assigned to the association is in the database by using the rtrv-ip-host:display=all command. The following is an example of the possible output.
    
    rlghncxa03w 13-06-28 21:15:37 GMT EAGLE5 45.0.0
    
    LOCAL IPADDR    LOCAL HOST
    192.1.1.10      IPNODE1-1201
    192.1.1.12      IPNODE1-1203
    192.1.1.14      IPNODE1-1205
    192.1.1.20      IPNODE2-1201
    192.1.1.22      IPNODE2-1203
    192.1.1.24      IPNODE2-1205
    192.1.1.30      KC-HLR1
    192.1.1.32      KC-HLR2
    192.1.1.50      DN-MSC1
    192.1.1.52      DN-MSC2
    
    REMOTE IPADDR   REMOTE HOST
    150.1.1.5       NCDEPTECONOMIC_DEVELOPMENT. SOUTHEASTERN_COORIDOR_ASHVL. GOV
    
    IP Host table is (11 of 4096) .26% full
    

    The IP address of the IP link should be assigned to the local host name that will be assigned to the association.

    The values of the lhost and alhost parameters must be in the LOCAL HOST column in the rtrv-ip-host output.

    If the required hostname is not in the database, add the IP host name using the Adding an IP Host procedure.

  5. Verify the available buffer size for the IP card that will contain the association being added in this procedure by entering the rtrv-assoc command with the local host name assigned to the association being added. For this example, enter this command.

    Note:

    If a newIP host was added in 4, continue the procedure with6.

    rtrv-assoc:lhost="IPNODE2-1305"

    This is an example of the possible output.

    
    rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
                    CARD IPLNK
    ANAME           LOC  PORT  LINK ADAPTER LPORT RPORT OPEN ALW
    a2              1305 A     A    SUA     1030  2345  YES  YES 
    
    IP Appl Sock/Assoc table is (8 of 4000) 1% full
    Assoc Buffer Space Used (16 KB of 800 KB) on LOC = 1305
    

    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.

    The default buffer value for an M3UA or SUA association is 16.

    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 M3UA or SUA Association procedure.

  6. Add the associations using the ent-assoc command. For this example, enter these commands.

    ent-assoc:aname=assoc1:lhost=gw105.nc.tekelec.com:lport=1030: rhost=gw100.nc.tekelec.com:rport=1030:adapter=m3ua:link=a

    These are the rules that apply to adding M3UA or SUA associations that are assigned to IPGWx signaling links.
    • The B Ethernet interface can be used with E5-ENET cards.
    • Each local host on an IPGWx card can contain a maximum of 50 connections (association – application server assignments).
    • The EAGLE can contain a maximum of 4000 connections (association – application server assignments).
    • 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 M3UA or SUA association.
    • If the new association is to be activated in this procedure with the chg-assoc command, the association must contain values for the lhost, rhost, lport, and rport parameters.
    • If the lhost and alhost are specified, the lhost parameter value represents the IP address corresponding to one of the network interfaces (A or B) on the IP card while the alhost parameter value represents the IP address corresponding to the other network interface of the same IP card.
    • The default value for the adapter parameter is m3ua.
    • The port parameter can be used in place of the link parameter to specify the signaling link assigned to the association.

    When each of these commands have successfully completed, this message should appear.

    
    rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
    ENT-ASSOC: MASP A - COMPLTD
    

    Note:

    If the association added in step 6 is not being activated in this procedure, skip step 7 and go to step 8.
  7. Activate the association added in 6 by entering the chg-assoc command with the association name specified in 6 and the open=yes and alw=yes parameters. For example, enter this command.

    chg-assoc:aname=assoc1:open=yes:alw=yes

    When this command has successfully completed, this message should appear.

    
    rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 36.0.0
    CHG-ASSOC: MASP A - COMPLTD
    
  8. Verify the changes using the rtrv-assoc command specifying the association name specified in 6 and 7. For this example, enter these commands.

    rtrv-assoc:aname=assoc1

    This is an example of possible output.

    
    rlghncxa03w 09-05-28 09:12:36 GMT EAGLE5 41.0.0
    ANAME assoc1
          LOC      1305          IPLNK PORT  A          LINK  A
          ADAPTER  M3UA          VER         M3UA RFC
          LHOST    gw105.nc.tekelec.com
          ALHOST   ---
          RHOST    gw100.nc.tekelec.com
          ARHOST   ---
          LPORT    1030          RPORT       1030
          ISTRMS   2             OSTRMS      2          BUFSIZE  16
          RMODE    LIN           RMIN        120        RMAX     800
          RTIMES   10            CWMIN       3000       UAPS     10
          OPEN     YES           ALW         YES        RTXTHR   0
          RHOSTVAL RELAXED
    
    IP Appl Sock table is (5 of 4000) 1% full
    Assoc Buffer Space Used (16 KB of 800 KB) on LOC = 1305
    
  9. Back up the new changes, using the chg-db:action=backup:dest=fixed command. These messages should appear; the active Maintenance and Administration Subsystem Processor (MASP) appears first.
    
    BACKUP (FIXED) : MASP A - Backup starts on active MASP.
    BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
    BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
    BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.
    

Figure 4-11 Adding an IPGWx M3UA or SUA Association



Sheet 1 of 4



Sheet 2 of 4



Sheet 3 of 4



Sheet 4 of 4