1. Database Administration - IP7 User's Guide
  2. IETF M3UA and SUA Configuration Procedures
  3. Adding an IPGWx Signaling Link

Adding an IPGWx Signaling Link

This procedure is used to add an IPGWx signaling link to the database using the ent-slk command with these parameters:

:loc – The card location of the IP card that the IP signaling link will be assigned to. The cards specified by this parameter are IP cards running the SS7IPGW or IPGWI applications.

:link – The signaling link on the card specified in the loc parameter.

:lsn – The name of the linkset that will contain the signaling link.

:slc – The signaling link code. The SLC must be unique within the linkset. It must be the same at both the EAGLE location and the distant node.

The ent-slk command contains other optional parameters that are not used to configure an IPGWx signaling link. These parameters are discussed in more detail in Commands User's Guide or in these sections.

These items must be configured in the database before an IP signaling link can be added:

  • Shelf – see "Adding a Shelf" in the Database Administration - System Management User's Guide.
  • Card – see Adding an IPGWx Card
  • Destination Point Code – see “Adding a Destination Point Code” in the Database Administration - SS7 User's Guide.
  • Linkset – see Configuring an IPGWx Linkset.

Verify that the link has been physically installed (all cable connections have been made).

To configure the EAGLE to perform circular routing detection test on the signaling links, “Configuring Circular Route Detection” procedure in Database Administration - SS7 User's Guide.

Note:

Circular route detection is not supported in ITU networks.

To provision a EAGLE with more than 1200 signaling links, the EAGLE must have certain levels of hardware installed. See the Requirements for EAGLEs Containing more than 1200 Signaling Links section for more information on these hardware requirements.

The EAGLE can contain a mixture of low-speed, E1, T1, ATM high-speed, and IP signaling links. The Determining the Number of High-Speed and Low-Speed Signaling Links section describes how to determine the quantities of the different types of signaling links the EAGLE can have.

Canceling the REPT-STAT-SLK, RTRV-LS, and RTRV-SLK Commands

Because the rept-stat-slk, rtrv-ls, and rtrv-slk commands used in this procedure can output information for a long period of time, the rept-stat-slk, rtrv-ls, and rtrv-slk commands can be canceled and the output to the terminal stopped. There are three ways that the rept-stat-slk, rtrv-ls, and rtrv-slk commands can be canceled.

  • Press the F9 function key on the keyboard at the terminal where the rept-stat-slk, rtrv-ls, or rtrv-slk commands were entered.
  • Enter the canc-cmd without the trm parameter at the terminal where the rept-stat-slk, rtrv-ls, or rtrv-slk commands were entered.
  • Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rept-stat-slk, rtrv-ls, or rtrv-slk commands were entered, from another terminal other that the terminal where the rept-stat-slk, rtrv-ls, or rtrv-slk commands 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 maximum number of signaling links the EAGLE can have and the number of signaling links that are currently provisioned by entering the rtrv-tbl-capacity command.

    This is an example of the possible output. 

    
rlghncxa03w 09-07-19 21:16:37 GMT EAGLE5 41.1.0

SLK      table is (        7 of      1200)   1% full

    Note:

    Thertrv-tbl-capacity command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by thertrv-tbl-capacity command, refer to thertrv-tbl-capacitycommand description inCommands User's Guide.

    If the addition of the new signaling link will not exceed the maximum number of signaling links the EAGLE can have, continue the procedure with 2.

    If the addition of the new signaling link will exceed the maximum number of signaling links the EAGLE can have, and the maximum number of signaling links is less than 2800, perform the Enabling the Large System # Links Controlled Feature procedure to enable the desired quantity of signaling links. After the new quantity of signaling links has been enabled, continue the procedure with 2.

    If the addition of the new signaling link will exceed the maximum number of signaling links the EAGLE can have (in this example, the maximum number of signaling links is 1200), and the maximum number of signaling links is 2800, this procedure cannot be performed. The EAGLE cannot contain more than 2800 signaling links.

  2. Display the current signaling link configuration using the rtrv-slk command. 
    
rlghncxa03w 09-07-19 21:16:37 GMT EAGLE5 41.1.0
                                   L2T               PCR  PCR
LOC  LINK LSN         SLC TYPE     SET  BPS    ECM   N1   N2
1201 B    lsa1         0  LIMDS0   1    56000  BASIC ---  -----
1203 B    lsa2         0  LIMDS0   1    56000  BASIC ---  -----
1207 A    lsn1207a     0  LIMDS0   1    56000  BASIC ---  -----
1207 B    lsn1207b     0  LIMDS0   1    56000  BASIC ---  -----

SLK table is (4 of 1200) 1% full.
  3. Display the current linkset configuration using the rtrv-ls command.

    This is an example of the possible output. 

    
rlghncxa03w 08-04-10 11:43:04 GMT EAGLE5 38.0.0

                                 L3T SLT              GWS GWS GWS
LSN          APCA   (SS7)  SCRN  SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
e1e2         001-207-000   none  1   1   no  B   6    off off off no    off
ls1305       000-005-000   none  1   1   no  A   1    off off off no    off
ls1307       000-007-000   none  1   1   no  A   1    off off off no    off
e1m1s1       001-001-001   none  1   1   no  A   7    off off off no    off
e1m1s2       001-001-002   none  1   1   no  A   7    off off off no    off

                                 L3T SLT              GWS GWS GWS
LSN          APCI   (SS7)  SCRN  SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
e1e2i        1-207-0       none  1   1   no  B   4    off off off ---   on
ls1315       0-015-0       none  1   1   no  A   1    off off off ---   off
ls1317       0-017-0       none  1   1   no  A   1    off off off ---   on
e1m2s1       1-011-1       none  1   1   no  A   7    off off off ---   off
e1m2s2       1-011-2       none  1   1   no  A   7    off off off ---   off

Link set table is (10 of 1024) 1% full.

    If the required linkset is not in the database, perform the Configuring an IPGWx Linkset to add the linkset to the database.

    If you plan to use a linkset shown in this step, continue the procedure with 4.

    If a new linkset is being added in this step, continue the procedure with 5.

  4. Display the linkset that the signaling link is being assigned to using the rtrv-ls command, specifying the name of the linkset that the signaling link is being assigned to.

    For this example, enter this command.

    rtrv-ls:lsn=lsnipgw

    This is an example of the possible output. 

    
rlghncxa03w 08-04-17 11:43:04 GMT EAGLE5 38.0.0

                                 L3T SLT              GWS GWS GWS
LSN          APCI   (SS7)  SCRN  SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsipgw       2968          none  1   1   no  A   1    off off off ---   off

           CLLI         TFATCABMLQ  MTPRSE  ASL8  SLSRSB  MULTGC  ITUTFR
           -----------  1           no      ---   1       yes     off

           IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
           yes     ---------- 10000 70     % 70      % CdPA

           LOC  LINK SLC TYPE
           1317 A     0  IPGWI

           SAPCI
           1-10-1

           SAPCN
           1234-aa
           1235-bb
           1200-zz

Link set table is (13 of 1024) 1% full.

    Linksets containing IPGWx signaling links can contain only IPGWx signaling links.

  5. Display the cards in the database using the rtrv-card command.

    This is an example of the possible output. 

    
rlghncxa03w 09-10-28 09:12:36 GMT EAGLE5 41.0.0
CARD   TYPE      APPL      LSET NAME     LINK SLC LSET NAME     LINK SLC
1102   TSM       GLS       
1103   DCM       STPLAN   
1113   GSPM      EOAM
1114   TDM-A
1115   GSPM      EOAM
1116   TDM-B
1117   MDAL
1201   LIMDS0    SS7ANSI   lsa1          B    0
1202   LIMDS0    SS7ANSI   
1203   LIMDS0    SS7ANSI   lsa2          B    0
1204   LIMDS0    SS7ANSI   
1205   LIMDS0    SS7ANSI   lsa3          A    0   
1206   LIMDS0    SS7ANSI   
1207   LIMDS0    SS7ANSI   lsn1207a      A    0   lsn1207b      B    0
1208   LIMDS0    SS7ANSI   
1212   LIMDS0    SS7ANSI   
1213   LIMDS0    SS7ANSI   
1214   LIMDS0    SS7ANSI   lsn1214a      A    0   lsa3          B    1
1215   LIMDS0    SS7ANSI   
1301   LIMDS0    ATMANSI   
1302   LIMATM    ATMANSI   
1304   LIMDS0    SS7ANSI   
1305   LIMATM    ATMANSI   
1308   LIMDS0    SS7ANSI   
1311   LIMDS0    SS7ANSI   
1313   LIMDS0    SS7ANSI   
1318   LIMATM    ATMANSI

    If the required card is not in the database, perform the Adding an IPGWx Card procedure and add the IP card to the database.

    Note:

    If the linkset that the signaling link will be added to contains themultgc=yes parameter, the application assigned to the card must beIPGWI.

    Note:

    If theIPGWx linkset contains anyIPGWx signaling links, continue the procedure with7.
  6. If you wish to assign an IPGWx signaling link to a linkset contains no signaling links, but the IPGWAPC value is no, perform the “Removing a Linkset Containing SS7 Signaling Links” procedure in the Database Administration - SS7 User's Guide and remove the linkset, then perform the Configuring an IPGWx Linkset procedure and re-enter the new linkset with the ipgwapc=yes parameter. Continue the procedure with 10.
  7. If the desired linkset, shown in the rtrv-ls output in 4, has a mate IPGWx linkset assigned, or is the mate to another IPGWx linkset, the desired linkset can contain only one signaling link.

    If the desired linkset does not have a mate IPGWx linkset assigned, or is not the mate of another IPGWx linkset, the desired linkset can contain up to 8 IPGWx signaling links. No other signaling link types can be in an IPGWx linkset.

    If you wish to assign more than one IPGWx signaling link to an IPGWx linkset that has a mate linkset assigned, the mate to this linkset must be removed. Perform the Removing a Mate IPGWx Linkset from another IPGWx Linkset procedure and remove the mate linkset from the linkset you wish to assign the IPGWx signaling link to. If you do not wish to use this linkset, perform the Configuring an IPGWx Linkset procedure and add a new IPGWx linkset.

    If the desired IPGWx linkset does not have a mate assigned, continue the procedure with 9.

    If the desired linkset has a mate linkset assigned, and contains an IPGWx signaling link, perform the Configuring an IPGWx Linkset procedure and add a new IPGWx linkset. Continue the procedure with 10.

  8. If you wish to assign more than one IPGWx signaling link to an IPGWx linkset that is a mate to another IPGWx linkset, this linkset must be removed from the other linkset as a mate.

    To verify if the linkset you wish to use is the mate of another IPGWx linkset, enter the rept-stat-iptps command to display the names of all the IPGWx linksets. This is an example of the possible output. 

    
rlghncxa03w 10-07-19 21:16:37 GMT EAGLE5 42.0.0
IP TPS USAGE REPORT

           THRESH  CONFIG/  CONFIG/         TPS   PEAK      PEAKTIMESTAMP
                      RSVD      MAX
--------------------------------------------------------------------------
LSN
lsgw1101      80%     ----     6000  TX:   5100     5500  05-02-10 11:40:04
                                    RCV:   5100     5500  05-02-10 11:40:04
lsgw1103      80%     ----     6000  TX:   5200     5500  05-02-10 11:40:04
                                    RCV:   5200     5500  05-02-10 11:40:04
lsgw1105      80%     ----    14000  TX:   7300     7450  05-02-10 11:40:04
                                    RCV:   7300     7450  05-02-10 11:40:04
lsgw1107      70%      ----    4000  TX:   3200     3500  05-02-10 11:40:04
                                    RCV:   3200     3500  05-02-10 11:40:04 
--------------------------------------------------------------------------

Command Completed.
  9. Enter the rtrv-ls:lsn=<IPGWx linkset name from the rept-stat-iptps output> to verify if the desired linkset is the mate of another IPGWx linkset.

    For this example, enter this command.

    rtrv-ls:lsn=lsgw1103

    This is an example of the possible output. 

    
rlghncxa03w 08-04-17 11:43:04 GMT EAGLE5 38.0.0

                                 L3T SLT              GWS GWS GWS
LSN          APCA   (SS7)  SCRN  SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsgw1103     003-002-004   none  1   1   no  A   1    off off off no    off

           CLLI         TFATCABMLQ MTPRSE ASL8 
           -----------  1          no     no   

           IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
           yes     lsgw1107   10000 70     % 70      % CdPA

            LOC  LINK SLC TYPE
            1103 A    0   SS7IPGW

 Link set table is ( 14 of 1024)  1% full

    If the name of the linkset you wish to use is not shown in the MATELSN field of the rtrv-ls output, repeat this step until all the IPGWx linksets have been displayed, or until a linkset has been found that has the linkset you wish to use assigned as a mate. If the linkset you wish to use is not the mate of another IPGWx linkset, continue the procedure with 10.

    If the name of the linkset you wish to use is shown in the MATELSN field of the rtrv-ls output, perform the Removing a Mate IPGWx Linkset from another IPGWx Linkset procedure to remove this linkset from the other linkset as a mate. Then continue the procedure with 10.

    If the desired linkset is the mate of another IPGWx linkset, and you do not wish to use this linkset, perform the Configuring an IPGWx Linkset procedure and add a new IPGWx linkset. Then continue the procedure with 10.

  10. Add the signaling link to the database using the ent-slk command Table 4-3 shows the parameters and values that can be specified with the ent-slk command.

    Table 4-3 IPGWx Signaling Link Parameter Combinations

    IPGWx Signaling Link
    :loc = location of the IP card with one of these applications: SS7IPGW or IPGWI; and the DCM card type. (See Note 6)
    :link = A
    :lsn = linkset name (See Notes 1, 2, 3, 4, and 5)
    :slc = 0 - 15 (See Notes 4 and 5)
    Notes:

    1. If the multgc=yes parameter is assigned to the linkset, the card’s application must be IPGWI.

    2. The ipgwapc=yes parameter must be assigned to the linkset.

    3. If the card’s application is IPGWI, the linkset adjacent point code must be ITU. If the card’s application is SS7IPGW, the linkset adjacent point code must be ANSI. The domain of the linkset adjacent point code must be SS7.

    4. A linkset can contain only one signaling link assigned to the SS7IPGW or IPGWI applications if the linkset contains a mate IPGWx linkset, or is the mate of an IPGWx linkset.

    5. If the linkset does not have a mate IPGWx linkset assigned to it, or is not the mate of an IPGWx linkset, the linkset can contain up to 8 signaling links assigned to the SS7IPGW or IPGWI applications.

    For this example, enter these commands.

    ent-slk:loc=2207:link=a:lsn=lsnlp3:slc=0

    ent-slk:loc=2211:link=a:lsn=lsnlp4:slc=0

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

    
rlghncxa03w 06-10-07 08:29:03 GMT  EAGLE5 36.0.0
ENT-SLK: MASP A - COMPLTD

    Note:

    If adding the new signaling link will result in more than 700 signaling links in the database and the OAMHCMEAS value in thertrv-measopts output ison, the scheduled UI measurement reports will be disabled.
  11. Verify the changes using the rtrv-slk command with the card location and link parameter values specified in 10.

    rtrv-slk:loc=2207:link=a

    This is an example of the possible output. 

    
rlghncxa03w 07-05-19 21:17:04 GMT EAGLE5 37.0.0
LOC  LINK LSN          SLC TYPE
2207 A    lsnlp3        0  SS7IPGW

    rtrv-slk:loc=2211:link=a

    This is an example of the possible output. 

    
rlghncxa03w 07-05-19 21:17:04 GMT EAGLE5 37.0.0
LOC  LINK LSN          SLC TYPE
2211 A    lsnlp4        0  IPGWI
  12. If any cards contain the first signaling link on a card, those cards must be brought into service with the rst-card command, specifying the location of the card.
    For this example, enter these commands.

    rst-card:loc=2207

    rst-card:loc=2211

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

    
rlghncxa03w 06-10-23 13:05:05 GMT EAGLE5 36.0.0
Card has been allowed.
  13. Activate all signaling links on the cards using the act-slk command, specifying the card location and link parameter value of each signaling link.
    For this example, enter these commands.

    act-slk:loc=2207:link=a

    act-slk:loc=2211:link=a

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

    
rlghncxa03w 06-10-07 08:31:24 GMT  EAGLE5 36.0.0
Activate Link message sent to card
  14. Check the status of the signaling links added in 10 using the rept-stat-slk command with the card location and link parameter values specified in 10. The state of each signaling link should be in service normal (IS-NR) after the link has completed alignment (shown in the PST field). For this example, enter these commands.

    rept-stat-slk:loc=2207:link=a

    This is an example of the possible output. 

    
rlghncxa03w 07-05-23 13:06:25 GMT EAGLE5 37.0.0
SLK      LSN       CLLI        PST          SST       AST
2207,A   lsnlp3    ----------- IS-NR        Avail     ----
  ALARM STATUS       = 
  UNAVAIL REASON     =

    rept-stat-slk:loc=2211:link=a

    This is an example of the possible output. 

    
rlghncxa03w 07-05-23 13:06:25 GMT EAGLE5 37.0.0
SLK      LSN       CLLI        PST          SST       AST
2211,A   lsnlp4    ----------- IS-NR        Avail     ----
  ALARM STATUS       = 
  UNAVAIL REASON     =
  15. 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-6 Adding an IPGWx Signaling Link



Sheet 1 of 6



Sheet 2 of 6



Sheet 3 of 6



Sheet 4 of 6



Sheet 5 of 6



Sheet 6 of 6