1. Database Administration - IP7 User's Guide
  2. IETF M2PA Configuration Procedures
  3. Configuring an IP Link

Configuring an IP Link

This procedure is used to configure the link parameters for IP cards using the chg-ip-lnk command. These link parameters are used to configure the Ethernet hardware.

The chg-ip-lnk command uses the following parameters.

:loc – The card location of the IP card.

:port – The Ethernet interface on the IP card, A or B.

:ipaddr – IP address assigned to the Ethernet interface on the IP card. This is an IP address expressed in standard “dot notation.” IP addresses consist of the system’s network number and the machine’s unique host number.

:submask – The subnet mask of the IP interface. A subnet mask is an IP address with a restricted range of values. The bits in the mask must be a string of one’s followed by a string of zero’s. There must be at least two one’s in the mask, and the mask cannot be all one’s. See Table 3-3 to assign the correct parameter values.

:auto – Tells hardware whether to automatically detect the duplex and speed.

:duplex – This is the mode of operation of the interface.

:speed – This is the bandwidth in megabits per second of the interface.

:mactype – This is the Media Access Control Type of the interface.

:mcast – The multicast control flag. This parameter enables or disables multicast support for the interface.

The EAGLE can contain a maximum of 2048 IP links.

A zero ipaddr parameter value (0.0.0.0) indicates the IP card Ethernet interface to IP link association is disabled. The host to the original IP address must be removed before the ipaddr=0.0.0.0 can be specified.

If the defrouter parameter of the chg-ip-card command contains an IP address for the card specified in this procedure, the network portion of one of the IP addresses assigned to the card in this procedure must match the network portion of the IP address specified by the defrouter parameter of the chg-ip-card command.

The network portion of the IP address is based on the class of the IP address (shown in Table 3-3). If the IP address is a Class A IP address, the first field is the network portion of the IP address. If the IP address is a Class B IP address, the first two fields are the network portion of the IP address. If the IP address is a Class C IP address, the first three fields are the network portion of the IP address. For example, if the IP address is 193.5.207.150, a Class C IP address, the network portion of the IP address is 193.5.207.

If the auto=yes parameter is specified, then the duplex and speed parameters are not allowed.

The loc parameter value must be shown in the rtrv-ip-card output.

The IP card must be placed out of service.

If either the ipaddr or submask parameters are specified, then both parameters must be specified. If the ipaddr parameter value is zero (0.0.0.0), the submask parameter is not required.

The IP address and subnet mask values cannot be changed to an address representing a different network if:

  • If the network interface specified by the loc and port parameters has a default router, dnsa, or dsnb parameter values assigned to it, as shown in the rtrv-ip-card output.
  • Any IP routes, shown in the rtrv-ip-rte output, reference the IP address for the network interface specified by the loc and port parameters.

The IP link cannot be changed if open associations reference the IP link being changed.

The network portion of the IP addresses assigned to the IP links on an IP card must be unique. For example, if IP links are assigned to IP card 1103, the network portion of the IP address for Ethernet interface A (port=a) must be different from the IP address for Ethernet interface B (port=b).

The submask parameter value is based upon the ipadddr setting. See Table 3-3 for the valid input values for the submask and ipaddr parameter combinations.

Table 3-3 Valid Subnet Mask Parameter Values

Network Class IP Network Address Range Valid Subnet Mask Values

A

1.0.0.0 to 127.0.0.0

255.0.0.0 (the default value for a class A IP address)

255.192.0.0

255.224.0.0

255.240.0.0

255.248.0.0

255.252.0.0

255.254.0.0

255.255.128.1

A+B

128.0.0.0 to 191.255.0.0

255.255.0.0 (the default value for a class B IP address)

255.255.192.0

255.255.224.0

255.255.240.0

255.255.248.0

255.255.252.0

255.255.254.0

255.255.255.128

A+B+C

192.0.0.0 to 223.255.255.0

255.255.255.0 (the default value for a class C IP address)

255.255.255.192

255.255.255.224

255.255.255.240

255.255.255.248

255.255.255.252

If a Class B IP address is specified for the ipaddr parameter of the chg-ip-lnk command, the subnet address that results from the ipaddr and submask parameter values cannot be the same as the subnet address that results from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command. The pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values can be verified by entering the rtrv-netopts command. Choose ipaddr and submask parameter values for the IP link whose resulting subnet address is not be the same as the subnet address resulting from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command.

The IP address for the IP link cannot be shown as the IPADDR value in the rtrv-ip-lnk, rtrv-ftp-serv, or rtrv-seas-config outputs, or the BPIPADDR value in the rtrv-ip-card output.

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 commandwas were entered.
  • Enter the canc-cmd without the trm parameter at the terminal where the rtrv-assoc commandwas entered.
  • Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-assoc commandwas entered, from another terminal other that the terminal where the rtrv-assoc commandwas 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 current link parameters associated with the IP card 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) full.

    Note:

    If theipaddr=0.0.0.0 is not being specified in this procedure, continue the procedure with3.
  2. If IP address information is being added or changed (not deleted) in the link parameters, verify that the IP address is present in the IP host table 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) 0.26% full

    If the current IP address of the IP link is shown in the rtrv-ip-host output, remove the host assigned to the IP address by performing the Removing an IP Host Assigned to an IPLIMx Card procedure.

  3. To change IP link parameters, the signaling link to the IP card and the IP card have to be inhibited.
    Display the signaling link associated with the card shown in 1 using the rtrv-slk command specifying the card location.

    For this example, enter this command.

    rtrv-slk:loc=1201

    This is an example of the possible output. 

    
rlghncxa03w 06-10-19 21:17:04 GMT EAGLE5 36.0.0
LOC   LINK LSN          SLC TYPE    IPLIML2
1201  A    nc001         0  IPLIM   M2PA
  4. Retrieve the status of the signaling link assigned to the IP card to be changed using the rept-stat-slk command.

    For example, enter this command.

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

    The output lists the signaling link assigned to this card: 

    
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SLK      LSN         CLLI        PST          SST       AST
1201,A   nc001       ----------- IS-NR
Command Completed.

    If the signaling link is in service-normal (IS-NR), continue the procedure with 5 to deactivate the signaling link. If the signaling link is out-of-service-maintenance disabled (OOS-MT-DSBLD), continue the procedure with 7 to verify the IP card status.

  5. Deactivate the signaling link assigned to the IP card using the dact-slk command.

    For example, enter this command.

    dact-slk:loc=1201: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 06-10-12 09:12:36 GMT EAGLE5 36.0.0
Deactivate Link message sent to card.
  6. Verify the new link status using the rept-stat-slk command.

    For example, enter this command.

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

    The output displays the link status as OOS-MT-DSBLD and gives off a minor alarm: 

    
rlghncxa03w 06-10-27 17:00:36 GMT EAGLE5 36.0.0
SLK      LSN         CLLI        PST          SST       AST
1201,A   nc001       ----------- OOS-MT-DSBLD AVAIL     ---
ALARM STATUS = * 0236 REPT-LKS:not aligned
UNAVAIL REASON = NA 
Command Completed.
  7. Verify the status of the IP card to be inhibited using the rept-stat-card command.

    For example, enter this command.

    rept-stat-card:loc=1201

    This is an example of the possible output. 

    
rlghncxa03w 06-10-27 17:00:36 GMT EAGLE5 36.0.0
CARD  VERSION      TYPE    GPL       PST           SST       AST
1201  114-000-000  DCM     IPLIM     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              nc001         -----------

Command Completed.

    If the IP card to be inhibited is in service-normal (IS-NR), continue the procedure with 8 to inhibit the card. If the IP card is out-of-service-maintenance disabled (OOS-MT-DSBLD), continue the procedure with 10 to change the IP link parameters.

  8. Inhibit the IP card using the inh-card command.

    For example, enter this command.

    inh-card:loc=1201

    This message should appear. 

    
rlghncxa03w 06-10-28 21:18:37 GMT EAGLE5 36.0.0
Card has been inhibited.
  9. Display the status of the IP card to verify that it is out-of-service maintenance-disabled (OOS-MT-DSBLD).

    Enter this command.

    rept-stat-card:loc=1201

    This is an example of the possible output. 

    
rlghncxa03w 06-10-27 17:00:36 GMT EAGLE5 36.0.0
CARD  VERSION      TYPE    GPL       PST           SST       AST
1201  114-000-000  DCM     IPLIM     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              nc001         -----------

Command Completed.
  10. Display the attributes of the IP card assigned to the IP link being changed by entering the rtrv-ip-card command and specifying the card location of the IP link.

    Note:

    If theipaddr orsubmask parameter values are not being changed, continue the procedure with13.

    For this example, enter this command.

    rtrv-ip-card:loc=1201

    This is an example of the possible output. 

    
rlghncxa03w 08-08-28 21:17:37 GMT EAGLE5 39.0.0
   LOC 1201
     SRCHORDR  LOCAL
     DNSA      150.1.1.1
     DNSB      ---------------
     DEFROUTER ---------------
     DOMAIN    ---------------
     SCTPCSUM  crc32c
     BPIPADDR  ---------------
     BPSUBMASK ---------------

    If the rtrv-ip-card output shows an IP address for the default router (DEFROUTER) whose network portion matches the network portion of the IP address being changed, go to the Configuring an IP Card procedure and change the IP address of the default router to 0.0.0.0.

  11. Display any IP routes referencing the IP link being changed by entering the rtrv-ip-rte command and specifying the card location of the IP link.

    For this example, enter this command.

    rtrv-ip-rte:loc=1201

    This is an example of the possible output. 

    
rlghncxa03w 06-10-28 21:17:37 GMT EAGLE5 36.0.0
LOC   DEST             SUBMASK          GTWY
1201  128.252.10.5     255.255.255.255  140.188.13.33
1201  128.252.0.0      255.255.0.0      140.188.13.34
1201  150.10.1.1       255.255.255.255  140.190.15.3

IP Route table is  (5 of 2048) 0.24% full

    If the rtrv-ip-rte output shows that the card has IP routes assigned to it, go to the Removing an IP Route procedure and remove the IP routes from the database.

  12. The subnet address that results from the ipaddr and submask parameter values of the chg-ip-lnk command cannot be the same as the subnet address that results from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command.

    Note:

    If a Class A or CIP address (seeTable 3-3) will be specified for theipaddr parameter in14, continue the procedure with13.

    Display the pvn, pvnmask, fcna, fcnamask, fcnb, and fcnbmask parameter values of the chg-netopts command by entering the rtrv-netopts command.

    If error message E3967 Cmd Rej: E5IS must be on is displayed after the rtrv-netopts command is executed, the pvn, pvnmask, fcna, fcnamask, fcnb, and fcnbmask parameters are not configured. Continue the procedure with 13.

    This is an example of the possible output if the E5IS feature is on. 

    
rlghncxa03w 09-02-28 21:17:37 GMT EAGLE5 40.1.0
NETWORK OPTIONS
------------------
PVN        = 128.20.30.40
PVNMASK    = 255.255.192.0
FCNA       = 170.120.50.0
FCNAMASK   = 255.255.240.0
FCNB       = 170.121.50.0
FCNBMASK   = 255.255.254.0

    Choose ipaddr and submask parameter values for the IP link whose resulting subnet address is not be the same as the subnet address resulting from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command. Continue the procedure with 13.

  13. Display the associations referencing the local host name that is associated with the IP link being changed by entering the rtrv-assoc command and specifying the local host name shown in the rtrv-ip-host output in 2.

    For this example, enter this command.

    rtrv-assoc:lhost="ipnode-1201"

    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
swbel32         1201 A     A    M2PA    1030  2345  YES  YES

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

    If no associations are displayed in this step, continue the procedure with 14.

    If the rtrv-assoc output shows that the open parameter for any associations is yes, perform one of these procedures to change the value of the open parameter the associations to no.

  14. Change the link parameters associated with the IP card in the database using the chg-ip-lnk command.

    For this example, enter this command.

    chg-ip-lnk:loc=1201:port=a:ipaddr=192.1.1.10:submask=255.255.255.0 :auto=yes:mactype=dix

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

    
rlghncxa03w 06-10-28 21:18:37 GMT EAGLE5 36.0.0
CHG-IP-LNK: MASP A - COMPLTD
  15. Verify the new link parameters associated with the IP card that was changed in 14 by entering the rtrv-ip-lnk command with the card location specified in 14.

    For this example, enter this command.

    The following is an example of the possible output. 

    
rlghncxa03w 07-05-28 21:14:37 GMT EAGLE5 37.0.0
LOC   PORT IPADDR          SUBMASK         DUPLEX  SPEED MACTYPE AUTO MCAST
1201  A    192.1.1.10      255.255.255.128 HALF    10    DIX     YES  NO
1201  B    --------------- --------------- HALF    10    DIX     NO   NO
  16. Allow the IP card that was inhibited in 8 by using by using the alw-card command.

    Note:

    If8was not performed, continue the procedure with18.

    For example, enter this command.

    alw-card:loc=1201

    This message should appear. 

    
rlghncxa03w 06-10-28 21:20:37 GMT EAGLE5 36.0.0
Card has been allowed.
  17. Verify the in-service normal (IS-NR) status of the IP card using the rept-stat-card command.

    For example, enter this command.

    rept-stat-card:loc=1201

    This is an example of the possible output. 

    
rlghncxa03w 06-10-27 17:00:36 GMT EAGLE5 36.0.0
CARD  VERSION      TYPE    GPL       PST           SST       AST
1201  114-000-000  DCM     IPLIM     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              nc001         -----------

Command Completed.
  18. Activate the signaling link from 5 using the act-slk command.

    Note:

    If5was not performed, continue the procedure with20.

    For example, enter this command.

    act-slk:loc=1201:link=a

    The link changes its state from OOS-MT-DSBLD (out-of-service maintenance-disabled) to IS-NR (in-service normal).

    The output confirms the activation. 

    
rlghncxa03w 06-10-07 11:11:28 GMT EAGLE5 36.0.0
Activate Link message sent to card
  19. Verify the in-service normal (IS-NR) status of the signaling link using the rept-stat-slk command.

    For example, enter this command.

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

    This message should appear. 

    
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SLK      LSN         CLLI        PST          SST       AST
1201,A   nc001       ----------- IS-NR
Command Completed.
  20. Perform the Configuring an IP Card procedure and change the IP address of the default router to a non-zero value, where the network portion of the default router IP address matches the network portion of the IP link’s new IP address.

    Note:

    If theipaddr orsubmask values were not changed, continue the procedure with22.

    Note:

    If theIP address of the default router was not changed to 0.0.0.0 in 10 , continue the procedure with21.
  21. Perform the Adding an IP Route procedure and add the IP routes back into the database.

    Note:

    IfIP routes were not removed in11, continue the procedure with22.
  22. Perform one of these procedures as necessary and change the value of the open parameter of the association to yes.

    Note:

    If theopen parameter value for an association was not changed in13, continue the procedure with23.
  23. 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 3-3 Configuring an IP Link



Sheet 1 of 9



Sheet 2 of 9



Sheet 3 of 9



Sheet 4 of 9



Sheet 5 of 9



Sheet 6 of 9



Sheet 7 of 9



Sheet 8 of 9



Sheet 9 of 9