1. Database Administration - IP7 User's Guide
  2. IETF M2PA Configuration Procedures
  3. Changing the Host Values of a M2PA Association

Changing the Host Values of a M2PA Association

This procedure is used to change the host values of a M2PA association, assigned to cards that are running the IPLIM or IPLIMI applications, using the chg-assoc command. If you wish to change the attributes of M2PA associations assigned to cards that are running the IPSG application, perform the Changing the Host Values of an IPSG Association procedure.

These parameters of the chg-assoc command are used in this procedure:

:aname – The name assigned to the association, shown in the rtrv-assoc output.

:lhost – The host name for the local host, shown in the rtrv-ip-host output.

:lport – The SCTP port number for the local host.

:rhost – The host name for the remote host, rhost can be any string of characters starting with a letter and comprising these characters ['a'..'z', 'A'..'Z', '0'..'9', '-', '.']. Hostnames are not case-sensitive and can contain up to 60 characters. The default value of this optional parameter is empty (null string).

:rport – The SCTP port number for the remote host.

:alhost – The alternate local host name, shown in the rtrv-ip-host output.

:link – The signaling link on the IPLIMx card. If the card is a E5-ENET 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:

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, m2pa.

:open – The connection state for this association. Valid values are yes or no. When the open=yes parameter is specified, the connection manager opens the association if the association is operational. When the open=no parameter is specified, the connection manager will not open the association.

:m2patset – The M2PA timer set assigned to the association. The m2patset parameter can be specified only with the adapter=m2pa parameter, or if the association already has the adapter=m2pa parameter assigned and the adapter parameter value is not being changed. If the adapter parameter value is being changed to m2pa, and the m2patset parameter is not specified, the default value for the m2patset parameter (1 - M2PA timer set 1) is assigned to the association. If the adapter parameter value for the association is m2pa, is not being changed, and the m2patset parameter is not specified with the chg-assoc command, the m2patset parameter value is not changed.

:ver – The M2PA version assigned to the M2PA association, either the RFC version (ver=rfc), or the Draft 6 version (ver=d6). The ver parameter can be specified only if, when this procedure is completed, the adapter parameter value is m2pa. If the adapter parameter value is being changed to m2pa, and the ver parameter is not specified, the default M2PA version of RFC is assigned to the association. To change the ver parameter value, the open parameter value for the association must be no.

The chg-assoc command contains other parameters that are not used this procedure. To change these parameters, perform these procedures.

At least one optional parameter is required.

The command input is limited to 150 characters, including the hostnames.

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

IPLIMx cards can have 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 E5-ENET cards.

The ipliml2 parameter value of the signaling link assigned to the association must be m2pa. The adapter parameter value of the association must match the ipliml2 parameter value.

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.

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.

The alhost=none parameter removes the alternate local host from the specified association, which also removes the multi-homed endpoint capability.

Canceling the RTRV-ASSOC and RTRV-AS Commands

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

  • Press the F9 function key on the keyboard at the terminal where the rtrv-assoc or rtrv-as commands were entered.
  • Enter the canc-cmd without the trm parameter at the terminal where the rtrv-assoc or rtrv-as commands were entered.
  • Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-assoc or rtrv-as commands were entered, from another terminal other that the terminal where the rtrv-assoc or rtrv-as commands were 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 08-04-28 09:12:36 GMT EAGLE5 38.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
assoc1          1201 A     A    M3UA    2000  1030  YES  YES
assoc2          2105 A     A    M2PA    2048  2048  YES  YES
assoc3          2105 A     B2   M2PA    3000  3000  YES  YES
assoc5          2105 A     A3   M2PA    1500  3000  YES  YES
  2. Enter the rtrv-card command with the location of the card that is hosting the M2PA association that will be changed in this procedure. For this example, enter this command.

    rtrv-card:loc=2105

    This is an example of possible output. 

    
rlghncxa03w 08-04-06 15:17:20 EST EAGLE5 38.0.0
CARD   TYPE      APPL     LSET NAME   LINK SLC LSET NAME   LINK SLC
2105   DCM       IPLIM    e5e6a       A    0   e5e6a       B2   1
                          e5e6a       A3   2
    If the application assigned to the card is IPLIM or IPLIMI, shown in the APPL column, continue the procedure by performing one of these steps.
    • If the open parameter value for the association being changed is yes, continue the procedure with 3.
    • If the open parameter value for the association being changed is no, continue the procedure with 4.

    If the application assigned to the card is IPSG, perform the Changing the Host Values of an IPSG Association procedure.

  3. Change the value of the open parameter to no by specifying the chg-assoc command with the open=no parameter.

    For this example, enter this command.

    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;
  4. Display the association being changed by entering the rtrv-assoc command with the aname parameter specified in 3.

    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of the possible output. 

    
rlghncxa03w 10-07-28 21:14:37 GMT EAGLE5 42.0.0
 ANAME assoc2
       LOC      2105          IPLNK PORT  A,B        LINK  A
       ADAPTER  M2PA          VER         M2PA RFC
       LHOST    IPNODE2-1205
       ALHOST   M2PA1
       RHOST    remotehost1
       ARHOST   ---
       LPORT    2048          RPORT       2048
       ISTRMS   2             OSTRMS      2           BUFSIZE  400
       RMODE    LIN           RMIN        120         RMAX     800
       RTIMES   10            CWMIN       3000        UAPS     10
       OPEN     NO            ALW         YES         RTXTHR   2000
       RHOSTVAL RELAXED       M2PATSET    1

IP Appl Sock/Assoc table is (8 of 4000) 1% full
Assoc Buffer Space Used (1600 KB of 1600 KB) on LOC = 2105

    If the association shown in this step is not an M2PA association, continue the procedure with 5.

    If the association shown in this step is an M2PA association, perform one of these actions.
    • If the association does not have an ALHOST value, continue the procedure with 5.
    • If the association does have an ALHOST value, and the ALHOST value will be removed along with changing the LHOST value of the association, continue the procedure with 5.
    • If the association does have an ALHOST value, and the only action that will be performed in this procedure is to remove the ALHOST value from the association, continue the procedure with Oracle.
  5. Verify that the local host name to be assigned to the association is in the database by entering the rtrv-ip-host:display=all command.

    The following is an example of the possible output. 

    
rlghncxa03w 08-12-28 21:15:37 GMT EAGLE5 40.0.0

LOCAL IPADDR    LOCAL HOST
192.1.1.10      IPNODE1-1201
192.1.1.12      GW105. NC. Oracle. COM
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
192.1.1.54      M2PA1

REMOTE IPADDR   REMOTE HOST
150.1.1.5       NCDEPTECONOMIC_DEVELOPMENT. SOUTHEASTERN_COORIDOR_ASHVL. GOV

IP Host table is (12 of 4096) .29% full
  6. 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
1303  A    192.1.1.10      255.255.255.128 HALF    10    802.3   NO   NO
1303  B    --------------- --------------- HALF    10    DIX     NO   NO
1305  A    192.1.1.12      255.255.255.0   ----    ---   DIX     YES  NO
1305  B    --------------- --------------- HALF    10    DIX     NO   NO
1313  A    192.1.1.14      255.255.255.0   FULL    100   DIX     NO   NO
1313  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    192.1.1.54      255.255.255.0   FULL    100   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, one that contains the desired IP address, is not shown in the rtrv-ip-lnk output, add the IP link using the Configuring an IP Link procedure. After the IP link has been added, assign the IP address of the IP link to the IP host name using the Adding an IP Host procedure. Then continue the procedure with 11.

    If the required IP link is shown in the rtrv-ip-lnk output, but the IP host is not shown in the rtrv-ip-host output in 5, assign the IP address of the IP link to the IP host name using the Adding an IP Host procedure. Then continue the procedure with 11.

    If the required IP host was shown in 5, the required IP link is shown in the rtrv-ip-lnk output in this step. Perform 7 to verify the application running on the card whose IP address is assigned to the IP host.

    Note:

    Thertrv-ip-host output must contain a host name for the association’slhost parameter and a host name for the association’salhost parameter, if thealhost parameter will be specified for the association. The IP address of the IP link should be assigned to the host name, shown in thertrv-ip-host output, that will be used as the association’slhost parameter value. If thealhost parameter will be specified for the association, the IP address of the IP link must be assigned to the host name that will be used as thealhost parameter value. The IP links associated with the association’slhost andalhost values must be assigned to the same card.
  7. Display the application running on the IP card shown in 6 whose IP address is assigned to the IP host using the rept-stat-card command specifying the location of the IP card.

    For this example, enter this command.

    rept-stat-card:loc=1205

    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
1205  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              e5e6a         -----------
      A3     IS-NR              e5e6a         -----------
      B2     IS-NR              e5e6a         -----------

Command Completed.
  8. Display the signaling link associated with the association being changed using the rtrv-slk command and specifying the card location shown in 7, and the new link parameter value of the association for the link parameter value. The card location should reference the local host assigned to the association. The rtrv-ip-lnk output shows the card location associated with the IP address that is associated with the local host in 7. If the rtrv-ip-lnk command was not executed in 6, execute it now to get the card location and the IP address. To display the signaling link for this example, enter this command.

    Note:

    If thelink parameter value is not being changed, continue the procedure with9.

    rtrv-slk:loc=1205:link=a

    The following is an example of the possible output. 

    
rlghncxa03w 08-04-19 21:17:04 GMT EAGLE5 38.0.0
LOC   LINK LSN          SLC TYPE    IPLIML2
1205  A    e5e6a         0  IPLIM   M2PA

    If the required signaling link is not in the database, add the signaling link using the Adding an IPLIMx Signaling Link procedure without activating the signaling link. If the application of the card containing the signaling link is IPLIM or IPLIMI, the ipliml2=m2pa parameter must be specified for the signaling link and the adapter=m2pa parameter value must be specified for the association.

  9. Display the application servers referencing the association being changed using the rtrv-as command with the name of the association being changed in this procedure.

    Note:

    If theadapter parameter value is not being changed from M3UA or SUA to M2PA, continue the procedure with10.

    For this example, enter this command.

    rtrv-as:aname=assoc2

    This is an example of possible output. 

    
rlghncxa03w 08-04-28 21:14:37 GMT EAGLE5 38.0.0
AS Name           Mode        Tr ms   Association Names
as1               LOADSHARE   2000    assoc2

as4               LOADSHARE   2000    assoc2

as6               LOADSHARE   2000    assoc2

AS Table is (6 of 250) 1% full

    If the association is not assigned to any application servers, continue the procedure with 10

    If the association is assigned to any application servers, go to the Removing an Association from an Application Server procedure and remove the association from the application servers. After the association has been removed from the application servers, continue the procedure with 10

  10. Display the application running on the IP card shown in 6 using the rept-stat-card command specifying the location of the IP card.

    Note:

    If therept-stat-card command was performed in7, continue the procedure with11.

    For this example, enter this command.

    rept-stat-card:loc=2105

    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
2105  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              e5e6a         -----------
      A3     IS-NR              e5e6a         -----------
      B2     IS-NR              e5e6a         -----------

Command Completed.
  11. Display the signaling link that will be assigned to the association by entering the rtrv-slk command and specifying the card location and signaling link.

    Note:

    If a new signaling link was added in8, continue the procedure withOracle.

    For this example, enter this command.

    rtrv-slk:loc=1203:link=a

    This is an example of the possible output. 

    
rlghncxa03w 08-04-19 21:17:04 GMT EAGLE5 38.0.0
LOC   LINK LSN          SLC TYPE    IPLIML2
1203  A    e5e6a         1  IPLIM   M2PA

    When the IP card’s application is either IPLIM or IPLIMI, the ipliml2 parameter value for the signaling link assigned to the association must be m2pa. If the ipliml2 parameter is not m2pa, remove the signaling link using the Removing an IPLIMx Signaling Link procedure. Add the signaling link back into the database with the ipliml2=m2pa parameter, and without activating the signaling link, using the Adding an IPLIMx Signaling Link procedure.

  12. Display the status of the signaling link shown in 11 using the rept-stat-slk command specifying the card location and signaling link.

    Note:

    If theAdding an IPLIMx Signaling Linkprocedure was not performed in11, continue the procedure withOracle.

    For example, enter this command.

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

    This is an example of the possible output. 

    
rlghncxa03w 08-04-28 21:16:37 GMT EAGLE5 38.0.0
SLK      LSN         CLLI        PST          SST       AST
1203,A   e5e6a       ----------- IS-NR        Avail     ----
Command Completed.

    Note:

    If the primary state (PST) of the signaling link isOOS-MT and the secondary state (SST) isUnavail, continue the procedure withOracle.
  13. Deactivate the signaling link from 12 using the dact-slk command.

    For example, enter this command.

    dact-slk:loc=1203:link=a

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

    
rlghncxa03w 08-04-07 11:11:28 GMT EAGLE5 38.0.0
Deactivate Link message sent to card
  14. Verify the status of the signaling link using the rept-stat-slk command.

    For example, enter this command.

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

    This is an example of the possible output. 

    
rlghncxa03w 08-04-28 21:16:37 GMT EAGLE5 38.0.0
SLK      LSN         CLLI        PST          SST       AST
1203,A   e5e6a       ----------- OOS-MT       Unavail   ----
Command Completed.
  15. Change the association using the chg-assoc command.

    For this example, enter this command.

    chg-assoc:aname=assoc2:lhost=m2pa2:alhost=m2pa3:rhost="gw200.nc-Oracle.com"

    These are the rules that apply to changing the host value of M2PA associations that are assigned to IPLIMx signaling links.
    • If any optional parameters are not specified with the chg-assoc command, those values are not changed.
    • The B Ethernet interface can be used with E5-ENET cards.
    • The EAGLE can contain a maximum of 4000 connections.
    • IPLIMx cards can have only one connection for each signaling link assigned to the card. If the card is an E5-ENET card, the card may contain a maximum of 16 connections.
    • The value of the lhost and rhost parameters is a text string of up to 60 characters, with the first character being a letter. The command input is limited to 150 characters, including the hostnames.
    • The adapter parameter value for the association must be m2pa and the ipliml2=m2pa parameter must be assigned to the signaling link on the iplim or iplimi card.
    • Specifying the lhost parameter only creates a uni-homed endpoint. The network portion of the endpoint's IP address must be the same as the network portion of the IP address assigned to either the A or B network interface of the IP card.
    • Specifying the lhost and alhost parameters creates a multi-homed endpoint. The network portion of the IP address associated with the lhost parameter must be the same as the network portion of the IP address assigned to one of the network interfaces (A or B) of the IP card, and the network portion of the IP address associated with the alhost parameter must be the same as the network portion of the IP address assigned to the other network interface on the IP card.
    • The alhost=none parameter removes the alternate local host from the specified association, which also removes the multi-homed endpoint capability.
    • If the mp2atset parameter is not specified with the chg-assoc command, and the adapter parameter value is being changed to m2pa, the m2patset parameter value defaults to M2PA timer set 1 (m2patset=1).
    • The port parameter can be used in place of the link parameter to specify the signaling link assigned to the association.
    • The M2PA version of the association determines the version of the M2PA timer set that is assigned to the association. For example, if M2PA timer set 3 is assigned to the M2PA association, and the association is an RFC M2PA association, the RFC version of M2PA timer set 3 is used with the association. If M2PA timer set 7 is assigned to the M2PA association, and the association is a Draft 6 M2PA association, the Draft 6 version of M2PA timer set 7 is used with the association.
    • If the adapter parameter value of the association is changed to m2pa in this procedure and the ver parameter is not specified, the version of the association will be RFC. To make this association a M2PA Draft 6 association, the ver=d6 parameter must be specified for this association.

    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;

    Note:

    If the value of theopen parameter was not changed in3, continue the procedure withOracle.
  16. Change the value of the open parameter to yes by specifying the chg-assoc command with the open=yes parameter.

    For this example, enter this command.

    chg-assoc:aname=assoc2:open=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;
  17. Verify the changes using the rtrv-assoc command specifying the association name specified in Oracle and 16.

    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of possible output. 

    
rlghncxa03w 10-07-28 21:14:37 GMT EAGLE5 42.0.0
 ANAME assoc2
       LOC      1203          IPLNK PORT  A,B        LINK  A
       ADAPTER  M2PA          VER         M2PA RFC
       LHOST    M2PA2
       ALHOST   M2PA3
       RHOST    gw200.nc-tekelec.com
       ARHOST   ---
       LPORT    2048          RPORT       3000
       ISTRMS   2             OSTRMS      2           BUFSIZE  500
       RMODE    LIN           RMIN        120         RMAX     800
       RTIMES   10            CWMIN       3000        UAPS     10
       OPEN     YES           ALW         YES         RTXTHR   10000
       RHOSTVAL RELAXED       M2PATSET    1

IP Appl Sock/Assoc table is (8 of 4000) 1% full
Assoc Buffer Space Used (1300 KB of 1600 KB) on LOC = 1203
  18. Activate the signaling link assigned to the association using the act-slk command.

    For example, enter this command.

    act-slk:loc=1203:link=a

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

    
rlghncxa03w 08-04-07 11:11:28 GMT EAGLE5 38.0.0
Activate Link message sent to card
  19. Verify the status of the signaling link using the rept-stat-slk command.

    For example, enter this command.

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

    This is an example of the possible output. 

    
rlghncxa03w 08-04-28 21:16:37 GMT EAGLE5 38.0.0
SLK      LSN         CLLI        PST          SST       AST
1203,A   e5e6a       ----------- IS-NR        Avail     ----
Command Completed.
  20. 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.
    If you wish to change the other attributes of the M2PA association, perform one of these procedures.

    If you do not wish to change the other attributes of the M2PA association, this procedure is finished.

Figure 3-19 Changing the Host Values of a M2PA Association



Sheet 1 of 7



Sheet 2 of 7



Sheet 3 of 7



Sheet 4 of 7



Sheet 5 of 7



Sheet 6 of 7



Sheet 7 of 7