Adding a Mate IPGWx Linkset to another IPGWx Linkset

This procedure is used to add a mate IPGWx linkset to an existing IPGWx linkset chg-ls command with these parameters.

:lsn – The name of the IPGWx linkset that will contain the mate IPGWx linkset that is being added shown in the rept-stat-iptps or rtrv-ls command outputs. is being added.

:matelsn – The name of the mate IPGWx linkset that is being added.

:action=add – adds the mate IPGWx linkset to the IPGWx linkset specified by the lsn parameter.

An IPGWx linkset is a linkset that contains signaling links assigned to IPGWx cards. IPGWx cards are cards running either the SS7IPGW or IPGWI applications.

The EAGLE allows an IPGWx linkset to contain up to 8 IPGWx signaling links, and as a result, 8 IPGWx cards. This increases the amount of traffic that can be delivered to a single IP node compared to the two-card combined IPGWx linkset deployments used in previous releases. An IPGWx linkset containing up to 8 IPGWx signaling links is the preferred method of configuring IPGWx linksets (see the Configuring an IPGWx Linkset procedure). This method is required if more than two IPGWx signaling links are to be used in the linkset.

To provide backward compatibility with pre-existing two-card combined IPGWx linkset deployments, the EAGLE also provides for a mate IPGWx linkset. A mate IPGWx linkset consists of one IPGWx linkset assigned to another IPGWx linkset using the matelsn parameter of the chg-ls command. To assign a mate IPGWx linkset to another IPGWx linkset, both linksets can contain no more than one signaling link. While mate IPGWx linksets can be configured using this procedure, the preferred method of configuring two-card IPGWx deployments is to configure a two-link non-mated linkset using the Configuring an IPGWx Linkset procedure.

Each linkset in the mated pair must either contain no mate linksets, or can reference the other linkset in the mated pair. For example, to assign linkset LSN2 to IPGWx linkset LSN1 as a mate linkset, linkset LSN1 cannot contain any mate linksets. Linkset LSN2 can have linkset LSN1 as a mate, otherwise linkset LSN2 cannot have any mate linksets assigned to it.

The mate linkset name is displayed in the rtrv-ls:lsn=<linkset name> command output. If either linkset contains more than one signaling link, all but one of the signaling links must be removed from these linksets or other linksets must be chosen. Perform the Removing an IPGWx Signaling Linkprocedure to remove any signaling links from the linkset. If new linksets must be configured for this procedure, perform the Configuring an IPGWx Linkset procedure.

Before a mate IPGWx linkset can be added to an IPGWx linkset, the card containing the IPGWx signaling link assigned to the linkset being changed, and the signaling link assigned to that card must be placed out of service.

The network type of the adjacent point code of the mate IPGWx linkset must be the same type as the linkset the mate is assigned to. For example, if a mate IPGWx linkset is assigned to an IPGWx linkset with an ITU-I adjacent point code, the mate IPGWx linkset must have an ITU-I adjacent point code.

Other Optional Parameters

There are other optional parameters that can be used to configure a linkset. These parameters are not required for configuring an IPGWx linkset. These parameters are discussed in more detail in Commands User's Guide or in these sections.

These procedures in this manual:
These procedures in Database Administration - SS7 User's Guide
- Adding an SS7 Linkset
- Changing an SS7 Linkset
- Configuring an ITU Linkset with a Secondary Adjacent Point Code (SAPC)
The "Configuring a Linkset for the GSM MAP Screening Feature" procedure in Database Administration - Features User's Guide.

Display the system-wide IP TPS usage report, and the IPGWx linksets, by entering the rept-stat-iptps command. 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.

If linksets are displayed in this step, continue the procedure 2.

If no linksets are displayed in this step, perform the Configuring an IPGWx Linkset to create two IPGWx linksets. After the IPGWx linksets have been created, continue the procedure with 14.

Display the linkset that is being changed by entering the rtrv-ls command with a linkset name shown in the rept-stat-iptps output in 1. 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     ---------- 10000 70     % 70      % CdPA

           LOC  LINK SLC TYPE
           1103 A    0   SS7IPGW

Link set table is ( 14 of 1024)  1% full
```
To assign a mate IPGWx linkset to this linkset, this linkset cannot contain more than one signaling link.

If this linkset does not contain more than one signaling link, and the linkset that will be the mate IPGWx linkset is shown in the rept-stat-iptps output in 1, continue the procedure with 3.

If this linkset does not contain more than one signaling link, and the linkset that will be the mate IPGWx linkset is not shown in the rept-stat-iptps output in 1, continue the procedure with 5.
If this linkset contains more than one signaling link, and you wish to add the mate IPGWx linkset to this linkset, perform the Removing an IPGWx Signaling Link procedure to remove all but one of the signaling links in the linkset. After the signaling links have been removed, perform one of these actions.
- If the linkset that will be the mate IPGWx linkset is shown in the rept-stat-iptps output in 1, continue the procedure with 3.
- If the linkset that will be the mate IPGWx linkset is not shown in the rept-stat-iptps output in 1, perform the Configuring an IPGWx Linkset procedure to add the linkset that will be the mate IPGWx linkset. After the linkset has been added, continue the procedure with 5.
If this linkset contains more than one signaling link, and you do not wish to add the mate IPGWx linkset to this linkset, perform one of these actions.
- If wish to use another linkset shown in the rept-stat-iptps output in 1, repeat this step with a linkset shown in the rept-stat-iptps output in 1.
- Perform the Configuring an IPGWx Linkset procedure to add the new IPGWx linkset that the mate IPGWx linkset will be assigned to. After the linkset has been added, if the linkset that will be the mate IPGWx linkset is shown in the rept-stat-iptps output in 1, continue the procedure with 3. If the linkset that will be the mate IPGWx linkset is not shown in the rept-stat-iptps output in 1, perform the Configuring an IPGWx Linkset procedure to add the new IPGWx linkset that will be the mate IPGWx linkset. After the mate IPGWx linkset has been added, continue the procedure with 14

Display the mate linkset from the IPGWx linksets shown in the rept-stat-iptps output in 1.

For this example, enter this command.

rtrv-ls:lsn=lsgw1107

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
lsgw1107     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     ---------- 10000 70     % 70      % CdPA

           LOC  LINK SLC TYPE
           1107 A    0   SS7IPGW

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

To use the linkset shown in 3 as a mate, the network type of the adjacent point code of the linkset shown in 3 must be the same as the network type of the linkset shown in 2. The linkset shown in 3 must not have more than one signaling link assigned to it.

If the linkset contains more than one signaling link, all but one of these signaling links must be removed from the linkset. Perform the Removing an IPGWx Signaling Link procedure to remove these signaling links.

If you do not wish to change this linkset, or if the network type of the adjacent point codes of both linksets are not the same, either choose another linkset from the rept-stat-iptps output in 1, and repeat 3, and 4 if necessary, or perform the Configuring an IPGWx Linkset procedure and add a new linkset. Continue the procedure with 5.

If the network types of the adjacent point codes of both linksets are the same, and the mate linkset contains no more than one signaling link, do not perform the actions in this step. Continue the procedure with 5.
Display the status of the card containing the signaling link assigned to the linkset being changed by entering the rept-stat-card command with the card location shown in the LOC field in the rtrv-ls output in 2. For this example, enter this command.
Note:
If the linkset that the mate linkset is being added to has no signaling links (see thertrv-ls output in2), continue the procedure with14.

rept-stat-card:loc=1103

This is an example of the possible output.
```
rlghncxa03w 08-04-27 17:00:36 GMT EAGLE5 38.0.0
CARD  VERSION      TYPE    GPL       PST           SST       AST
1103  114-000-000  DCM     SS7IPGW   IS-NR         Active    -----
  ALARM STATUS      = No Alarms.
  BPDCM GPL         = 002-102-000
  IMT BUS A         = Conn
  IMT BUS B         = Conn
  SIGNALING LINK STATUS
    SLK    PST                LS            CLLI
    A      IS-NR              lsgw1103      -----------
Command Completed.
```
Display the status of the signaling link assigned to the card shown in 5 by entering the rept-stat-slk command with the card location used in 5 and the link=a parameter. For this example, enter this command.
Note:
If the status of the card shown inPST field in therept-stat-card output in5isOOS-MT-DSBLD, continue the procedure with14.

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

This is an example of the possible output.
```
rlghncxa03w 08-04-27 17:00:36 GMT EAGLE5 38.0.0
SLK      LSN         CLLI        PST          SST       AST
1103,A   lsgw1103    ----------- IS-NR        Avail     -----
  ALARM STATUS       = No Alarms.
  UNAVAIL REASON     = NA
Command Completed.
```
If the status of the signaling link is out-of-service maintenance disabled (OOS-MT-DSBLD), continue the procedure with 14.
If the status of the signaling link is not out-of-service maintenance disabled (OOS-MT-DSBLD), any in-service IP connections on the signaling link must be placed out of service. Continue the procedure by performing one of these steps.
- The recommended method is to have the far end node place these IPconnections out of service. Have the far-end node for the signaling link shown in this step place the M3UA or SUA associations in either the ASP-INACTIVE or ASP-DOWN state. After the IP connections have been placed out of service, continue the procedure with 12.
- If you do not wish to have the far end node place these IP connections out of service, continue the procedure with 7.
Display the IP link associated with the card that the signaling link shown in 6 is assigned to by entering the rtrv-ip-lnk command with the card location shown in 6. For this example, enter this command.
rtrv-ip-lnk:loc=1103

The following is an example of the possible output.
```
rlghncxa03w 08-04-28 21:14:37 GMT EAGLE5 38.0.0
LOC   PORT IPADDR          SUBMASK         DUPLEX  SPEED MACTYPE AUTO MCAST
1103  A    192.1.1.10      255.255.255.128 HALF    10    802.3   NO   NO
1103  B    --------------- --------------- HALF    10    DIX     NO   NO
```
Display the IP host information associated with the IP link by entering the rtrv-ip-host command with the IP address shown in 7. For this example, enter this command.
rtrv-ip-host:ipaddr=192.001.001.010

The following is an example of the possible output.
```
rlghncxa03w 08-12-28 21:17:37 GMT EAGLE5 40.0.0

LOCAL IPADDR    LOCAL HOST
192.1.1.10      IPNODE1_1103

IP Host table is (11 of 4096) .26% full
```

Display the association associated with the local host name shown in 8 by entering the rtrv-assoccommand.

For this example, enter this command.

rtrv-assoc:lhost=ipnode1_1103

The following is an example of the possible output.

rlghncxa03w 08-04-28 09:12:36 GMT EAGLE5 38.0.0
                CARD IPLNK
ANAME           LOC  PORT  LINK ADAPTER LPORT RPORT OPEN ALW
assoc2          1103 A     A    M3UA    1030  1030  YES  YES

IP Appl Sock/Assoc table is (4 of 4000) 1% full
Assoc Buffer Space Used (16 KB of 3200 KB) on LOC = 1103

Change the alw parameter values in the association shown in 9 using the chg-assoc command with the alw=no parameters, as necessary.
Note:
If theopen andalw parameter values of the association shown in9areno, continue the procedure with11.

chg-assoc:aname=assoc2:alw=no

Caution:
This command impacts network performance and should only be used during periods of low traffic.

When this command has successfully completed, this message should appear.
```
rlghncxa03w 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD
```
Repeat this step for all associations shown in 9.
Change the open parameter values in the association shown in 9 using the chg-assoc command with the open=no parameters, as necessary.
chg-assoc:aname=assoc2:open=no

When this command has successfully completed, this message should appear.
```
rlghncxa03w 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD
```
Repeat this step for all associations shown in 9.
Deactivate the signaling link assigned to the IP card using the dact-slk command. For example, enter this command.
dact-slk:loc=1103:link=a

Caution:
This command impacts network performance and should only be used during periods of low traffic.

After this command has successfully completed, this message appears.
```
rlghncxa03w 08-04-12 09:12:36 GMT EAGLE5 38.0.0
Deactivate Link message sent to card.
```
Inhibit the IP card using the inh-card command. For example, enter this command.
inh-card:loc=1103

This message should appear.
```
rlghncxa03w 08-04-28 21:18:37 GMT EAGLE5 38.0.0
Card has been inhibited.
```
Change the linkset shown in 2 by entering the chg-ls command with the matelsn and action=add parameters.
For this example, enter this command.

chg-ls:lsn=lsgw1103:matelsn=lsgw1107:action=add

When the chg-ls command has successfully completed, this message should appear.
```
rlghncxa03w 08-04-17 16:23:21 GMT  EAGLE5 38.0.0
Link set table is ( 14 of 1024)  1% full
CHG-LS: MASP A - COMPLTD
```

Verify the changes using the rtrv-ls command specifying the linkset name specified in 14 with the lsn parameter. 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 linkset shown in this step does not have a signaling link assigned to it, or if the dact-slk command in 12 was not performed, continue the procedure with 20.

Allow the IP card that was inhibited in 13 using the alw-card command. For example, enter this command.
alw-card:loc=1103

This message should appear.
```
rlghncxa03w 08-04-28 21:21:37 GMT EAGLE5 38.0.0
Card has been allowed.
```
Activate the signaling link from 12 using the act-slk command. For example, enter this command.
act-slk:loc=1103:link=a

The output confirms the activation.
```
rlghncxa03w 08-04-07 11:11:28 GMT EAGLE5 38.0.0
Activate Link message sent to card
```
If 10 and 11 were not performed, continue the procedure with 19.
Change the open and alw parameter values for all the associations changed in 10 or 11 using the chg-assoc command with the open=yes and alw=yes parameters.
chg-assoc:aname=assoc1:open=yes:alw=yes

When this command has successfully completed, this message should appear.
```
rlghncxa03w 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD
```
Have the far-end node for the signaling link shown in 15 place the IP connections on the signaling link into service by placing the M3UAor SUA associations in the ASP-ACTIVE state.

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-5 Adding a Mate IPGWx Linkset to another IPGWx Linkset

Sheet 1 of 6

Sheet 2 of 6

Sheet 3 of 6

Sheet 4 of 6

Sheet 5 of 6

Sheet 6 of 6