Changing the SCTP Checksum Algorithm Option for IPSG M3UA Associations

Use this procedure to change the SCTP checksum algorithm, either Adler-32 or CRC-32c, applied to traffic on SCTP associations. The sctpcsum parameter of the chg-sg-opts command is used to change this option. The Adler-32 and CRC-32c checksum algorithms specified in this procedure applies to all the M3UA associations that are assigned to all the IP cards running the IPSG application. This option is a system-wide option. To apply this option to associations assigned to cards running the IPLIM, IPLIMI, SS7IPGW, or IPGWI applications, or to IPSG M2PA associations, perform these procedures.

The sctpcsum parameter contains another value, percard, that allows either the Adler-32 or CRC-32c SCTP checksum algorithm to be specified for the all the associations assigned to a specific card. With this option specified, the Adler-32 checksum algorithm can be specified for the associations on one card and the CRC-32c checksum algorithm can be specified for the associations on another card. Setting the sctpcsum parameter to percard changes the SCTP checksum algorithm for the associations assigned to a card to the SCTP checksum algorithm value for that card. The checksum algorithm for individual cards is provisioned by performing the Configuring an IP Card procedure.

Once the SCTP checksum option has been changed, the associations on each IP card need to be reset by changing the open parameter value for each association to no, then back to yes. This ensures that the associations on the IP card are using the new SCTP checksum algorithm.

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.

Display the current IP options in the database by entering the rtrv-sg-opts command. The following is an example of the possible output.
```
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SCTPCSUM:       adler32
```
The rtrv-sg-opts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-sg-opts command, see the rtrv-sg-opts command description in Commands User's Guide.

Display the cards in the EAGLE by entering the rtrv-card command. This is an example of the possible output.


rlghncxa03w 09-10-15 16:34:56 GMT EAGLE5 41.0.0
CARD   TYPE      APPL      LSET NAME     LINK SLC  LSET NAME     LINK SLC
1101   DSM       VSCCP      
1102   TSM       GLS       
1104   DCM       STPLAN    
1113   GSPM      EOAM
1114   TDM-A
1115   GSPM      EOAM
1116   TDM-B
1117   MDAL
1201   LIMDS0    SS7ANSI   lsn1          A    0    lsn2          B    1
1202   DCM       IPLIM     ipnode2       A    1    
1203   LIMDS0    SS7ANSI   lsn2          A    0    lsn1          B    1
1204   LIMATM    ATMANSI   atmgwy        A    0    
1205   DCM       IPLIM     ipnode1       A    0    ipnode3       B    1
1207   DCM       IPLIM     ipnode2       A    0    
1303   DCM       IPLIM     ipnode3       A    0    ipnode1       B    1
1305   DCM       IPLIM     ipnode4       A    0    
1308   DCM       IPLIM     ipnode3       B    2
                           ipnode1       A1   2    ipnode4       B2   1
1315   ENET      IPSG      ipgtwy1       A    
1317   DCM       IPGWI     ipgtwy2       A

Record the card location, shown in the LOC column, and signaling link, shown in the LINK column, information for all cards running the IPSG application.

Select one of the IPSG cards shown in 2. Display the associations assigned to the IPSG card by entering the rtrv-assoc command and specifying the card location of the IPSG card. For this example, enter this command.
rtrv-assoc:loc=1315

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
assoc3          1315  A     A    M3UA    2345  1025  YES  YES

IP Appl Sock/Assoc table is (9 of 4000) 1% full
Assoc Buffer Space Used (19 KB of 800 KB) on LOC = 1315
```
If the ADAPTER value of the associations shown in the rtrv-assoc output is M3UA, continue the procedure with 4.

If the ADAPTER value of the associations shown in the rtrv-assoc output is M2PA, do not perform the remainder of this procedure. Perform the Changing the SCTP Checksum Algorithm Option for M2PA Associations procedure to change the SCTP checksum algorithm for IPSG M2PA associations.
At the IP near end node, stop all traffic to the IP card specified in 3 on the EAGLE.

At the EAGLE, enter the msucount -l pass command with the card location of the IP card selected in 3. For this example, enter this command.

pass:loc=1315:cmd=”msucount -l”

The following is an example of the possible output.

rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
PASS: Command sent to card

rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
MSUCOUNT: Command In Progress

rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0

MSUCOUNT: MSU Count Report

--------------------------
Link Measurements (Link A)
--------------------------
Transmit Counts                      Receive Counts
----------------------------------   -----------------------------
rate   msus        bytes             rate   msus        bytes
-----  ----------  ---------------   -----  ----------  ----------
2000   4294967295  4294967295        2000   4294967295  4294967295
MTP Primitive (MTPP) counts          Reroute Counts
----------------------------------   ----------------------
sent pdus   rcvd pdus   dscrd pdus   sent msus   rcvd msus
----------  ----------  ----------   ----------  ----------     
4294967295  4294967295  4294967295   4294967295  4294967295 
    
END of Report

At the EAGLE, enter the msucount -a pass command with the card location specified in 5 and the association names shown in 3. For this example, enter this command.

pass:loc=1315:cmd=”msucount -a assoc3”

The following is an example of the possible output.


rlghncxa03w 06-10-28 21:17:37 GMT EAGLE5 36.0.0
PASS: Command sent to card

rlghncxa03w 06-10-28 21:17:37 GMT EAGLE5 36.0.0
MSUCOUNT: Command In Progress

rlghncxa03w 06-10-28 21:17:37 GMT EAGLE5 36.0.0
MSUCOUNT: MSU Count Report

--------------------------
IP Connection Measurements
--------------------------
Receive Counts                     Transmit Counts
--------------------------------   -----------------------------
msus            bytes              msus             bytes
----------      ----------------   ----------       ----------
4294967295      4294967295         4294967295       4294967295
Receive Discard Counts             Transmit Discard Counts
--------------------------------   ---------------------------------
reason                count       reason                 count
--------------------- ---------   ---------------------- ----------
link state            4294967295   sccp msg type          4294967295
sccp msg type         4294967295   sccp class             4294967295
sccp class            4294967295   normalization error    4294967295
sccp called party     4294967295   invalid traffic type   4294967295
sccp calling party    4294967295   M3UA conversion error  4294967295
isup sio              4294967295   SUA conversion error   4294967295
normalization error   4294967295
error in XSRV packet  4294967295
M3UA PDU error        4294967295
SUA PDU error         4294967295
invalid rcontext      4294967295
Stored Transmit Discard Data
----------------------------
no stored transmit discard data
Stored Receive Discard Data
---------------------------
53 41 53 49 69 73 6f 74 11 00 87 0a 01 03 01 05
05 00 01 02 03 04 05 06 07 08 09 00 00 00 00 00

END of Report

At the IP near end node, disconnect all the associations attached to the IP card specified in 6.
At the EAGLE, place the signaling link on this IP card out of service using the dact-slk command. For this example, enter this command.
dact-slk:loc=1315:link=a

When 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
```
Change the SCTP checksum option in the database using the chg-sg-opts command. For this example, enter this command.
chg-sg-opts:sctpcsum=crc32c

When this command has successfully completed, the following message should appear.
```
rlghncxa03w 06-10-28 21:19:37 GMT EAGLE5 36.0.0
CHG-SG-OPTS: MASP A - COMPLTD
```
Continue the procedure by performing one of these actions.
- If the sctpcsum parameter value was changed to either adler32 or crc32c, continue the procedure with 10.
- If the sctpcsum parameter value was changed to percard, perform the Configuring an IP Card procedure to assign an sctpcsum parameter value to all the cards running the IPLIM or IPLIMI applications. After the Configuring an IP Card procedure has been performed, continue the procedure with 11.
Verify that the SCTP checksum algorithm was changed using the rtrv-sg-opts command. The SCTP checksum algorithm option value is shown in the SCTPCSUM parameter. The following is an example of the possible output.
```
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SCTPCSUM:       crc32c
```
The rtrv-sg-opts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-sg-opts command, see the rtrv-sg-opts command description in Commands User's Guide.
Change the value of the open parameter of the associations shown in 3 to no by specifying the chg-assoc command with the open=no parameter. For this example, enter this command.
chg-assoc:aname=assoc3:open=no

When this command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
CHG-ASSOC: MASP A - COMPLTD;
```
Change the value of the open parameter of the associations changed in 11 to yes by specifying the chg-assoc command with the open=yes parameter. For this example, enter this command.
chg-assoc:aname=assoc3:open=yes

When this command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
CHG-ASSOC: MASP A - COMPLTD;
```

Verify the checksum algorithm that is assigned to the associations shown in 12 by entering the sctp -a pass command with the card location of the IP card specified in 8 and the name of the associations specified in 12. For this example, enter this command.

pass:loc=1315:cmd=”sctp -a assoc3 ”

The following is an example of the possible output.

    rlghncxa03w 10-12-28 21:16:37 GMT EAGLE5 43.0.0
    Aname            Local              Local   Primary        Remote
                     IP Address         Port    Address        Port
    assoc3           192.1.1.50         2345    192.168.112.4  1025
                     192.1.1.50  

               Configuration                            State
        Retransmission Mode = LIN          State = OPEN
Min. Retransmission Timeout = 10000        ULP association id = 18
Max. Retransmission Timeout = 800000       Number of nets = 2
     Max. Number of Retries = 10           Inbound Streams = 1
    Min. Congestion Window  = 3000         Outbound Streams = 2
            Inbound Streams = 2
           Outbound Streams = 2
         Checksum Algorithm = crc32c
       Send/Rcv Buffer Size = 204800

                                 Nets Data     

         IP Address     192.168.112.4      State     Reachable
               Port     1025             Primary     YES
                MTU     1500                cwnd     16384
           ssthresh     16384                RTO     120

         IP Address     192.168.112.5      State     Reachable
               Port     7777             Primary     NO
                MTU     1500                cwnd     16384
           ssthresh     16384                RTO     120

                    Last Net Sent To = 192.168.112.4      
                  Last Net Rcvd From = 192.168.112.4      
                 Over All Eror Count = 0
                          Peers Rwnd = 13880
                             My Rwnd = 16384
                          Max Window = 16384
                  Initial Seq Number = 24130
             Next Sending Seq Number = 124686
               Last Acked Seq Number = 124669
         Maximum Outbound Char Count = 16384
         Current Outbound Char Count = 2112
            Number Unsent Char Count = 0
           Outbound Data Chunk Count = 16
                       Number Unsent = 0
                Number To Retransmit = 0


                   ip datagrams rcvd = 155402
  ip datagrams with data chunks rcvd = 120844
                    data chunks rcvd = 367908
                    data chunks read = 367900
                       dup tsns rcvd = 8
                          sacks rcvd = 38734
                 gap ack blocks rcvd = 3
             heartbeat requests rcvd = 135
                 heartbeat acks rcvd = 52
             heartbeat requests sent = 52
                   ip datagrams sent = 129254
  ip datagrams with data chunks sent = 73084
                    data chunks sent = 396330
         retransmit data chunks sent = 135
                          sacks sent = 64872
                         send failed = 0
              retransmit timer count = 0
     consecutive retransmit timeouts = 0
 RTT between RMIN and RMAX inclusive = 6
               RTT greater than RMAX = 0
               fast retransmit count = 135
                    recv timer count = 0
               heartbeat timer count = 244
                    none left tosend = 0
                 none left rwnd gate = 5
                 none left cwnd gate = 8


;

    rlghncxa03w 10-12-28 21:16:37 GMT EAGLE5 43.0.0

    SCTP command complete

    rlghncxa03w 08-04-28 21:16:37 GMT EAGLE5 38.0.0
    Aname            Local              Local   Primary        Remote
                     IP Address         Port    Address        Port
    assoc3           192.1.1.50         2345    192.168.112.4  1025
                     192.1.1.50  

               Configuration                            State
        Retransmission Mode = LIN          State = OPEN
Min. Retransmission Timeout = 10           ULP association id = 18
Max. Retransmission Timeout = 800          Number of nets = 2
     Max. Number of Retries = 10           Inbound Streams = 1
    Min. Congestion Window  = 3000         Outbound Streams = 2
            Inbound Streams = 2
           Outbound Streams = 2
  Checksum Algorithm = crc32c


                                 Nets Data     

         IP Address     192.168.112.4      State     Reachable
               Port     1025             Primary     YES
                MTU     1500                cwnd     16384
           ssthresh     16384                RTO     120

         IP Address     192.168.112.5      State     Reachable
               Port     7777             Primary     NO
                MTU     1500                cwnd     16384
           ssthresh     16384                RTO     120

                    Last Net Sent To = 192.168.112.4      
                  Last Net Rcvd From = 192.168.112.4      
                 Over All Eror Count = 0
                          Peers Rwnd = 13880
                             My Rwnd = 16384
                          Max Window = 16384
                  Initial Seq Number = 24130
             Next Sending Seq Number = 124686
               Last Acked Seq Number = 124669
         Maximum Outbound Char Count = 16384
         Current Outbound Char Count = 2112
            Number Unsent Char Count = 0
           Outbound Data Chunk Count = 16
                       Number Unsent = 0
                Number To Retransmit = 0


                   ip datagrams rcvd = 155402
  ip datagrams with data chunks rcvd = 120844
                    data chunks rcvd = 367908
                    data chunks read = 367900
                       dup tsns rcvd = 8
                          sacks rcvd = 38734
                 gap ack blocks rcvd = 3
             heartbeat requests rcvd = 135
                 heartbeat acks rcvd = 52
             heartbeat requests sent = 52
                   ip datagrams sent = 129254
  ip datagrams with data chunks sent = 73084
                    data chunks sent = 396330
         retransmit data chunks sent = 135
                          sacks sent = 64872
                         send failed = 0
              retransmit timer count = 0
     consecutive retransmit timeouts = 0
 RTT between RMIN and RMAX inclusive = 6
               RTT greater than RMAX = 0
               fast retransmit count = 135
                    recv timer count = 0
               heartbeat timer count = 244
                    none left tosend = 0
                 none left rwnd gate = 5
                 none left cwnd gate = 8


;

    rlghncxa03w 08-04-28 21:16:37 GMT EAGLE5 38.0.0

    SCTP command complete

If the checksum algorithm shown in any of the associations displayed in this step do not match the checksum algorithm specified in 9, contact the Customer Care Center. Refer to My Oracle Support (MOS) for the contact information.

If the checksum algorithm shown in all of the associations displayed in this step match the checksum algorithm specified in 9, continue the procedure with 14.

At the IP near end node, configure all the associations attached to the IP card specified in 12 to use the SCTP checksum algorithm.
Put the signaling link that was placed out of service in 7 back into service using the act-slk command. For example, enter this command.
act-slk:loc=1315:link=a

When this command has successfully completed, this message appears.
```
rlghncxa03w 06-10-07 11:11:28 GMT EAGLE5 36.0.0
Activate Link message sent to card
```
Verify the in-service normal (IS-NR) status of the signaling link by using the rept-stat-slk command and specifying the card location and link value specified in 15. For example, enter this command.
rept-stat-slk:loc=1315:link=a

The following is an example of the possible output.
```
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SLK      LSN         CLLI        PST          SST       AST
1315,A   ipgtwy1     ----------- IS-NR        Avail     ----
Command Completed.
```
At the IP near end node, connect one of the associations attached to the IP card specified in 11.

At the EAGLE, enter the rept-stat-assoc command specifying the association names specified with the chg-assoc command in 11 and 12 to verify that the association is established with the IP near end node. For this example, enter this command.

rept-stat-assoc:aname=assoc3

The following is an example of the possible output.


rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0

                    CARD IPLNK
    ANAME           LOC  PORT   LINK PST             SST             ASPID
    as1             1315 A      A    IS-NR           ESTABLISHED     undefined

    LSN         ANAME             ASP STATE
    lpgtwy1     assoc3            ACTIVE

    Command Completed.

Enter the netstat -p sctp pass command with the card location of the IP card to determine if any errors have occurred. For this example, enter this command. For this example, enter this command.

pass:loc=1315:cmd=”netstat -p sctp”

The following is an example of the possible output.

rlghncxa03w 08-04-28 21:16:37 GMT EAGLE5 38.0.0
ip packets sent...................................... 1474882
        ip packets sent with data chunk.................. 306354
        control chunks (excluding retransmissions)....... 1172759
        ordered data chunks (excluding retransmissions).. 1534350
        unordered data chunks (excluding retransmissions) 0
        user messages fragmented due to MTU.............. 0
        retransmit data chunks sent...................... 4
        sacks sent....................................... 496302
        send failed...................................... 0
    ip packets received.................................. 1816035
        ip packets received with data chunk.............. 989957
        control chunks (excluding duplicates)............ 833141
        ordered data chunks (excluding duplicates)....... 989968
        unordered data chunks (excluding duplicates)..... 0
        user messages reassembled........................ 0
        data chunks read................................. 988601
        duplicate tsns received.......................... 0
        sacks received................................... 153763
        gap ack blocks received.......................... 0
        out of the blue.................................. 4
        with invalid checksum............................ 0
    connections established.............................. 2954
        by upper layer................................... 0
        by remote endpoint............................... 2958
    connections terminated............................... 4
        ungracefully..................................... 2952
        gracefully....................................... 0
    associations dropped due to retransmits.............. 0
    consecutive retransmit timeouts...................... 4
    retransmit timer count............................... 6
    fast retransmit count................................ 0
    heartbeat requests received.......................... 330275
    heartbeat acks received.............................. 340239
    heartbeat requests sent.............................. 340258
    associations supported............................... 50
    milliseconds cookie life at 4-way start-up handshake. 5000
    retransmission attempts allowed at start-up phase.... 8

;

    rlghncxa03w 08-04-28 21:16:37 GMT EAGLE5 38.0.0

    NETSTAT command complete

If errors are shown in the pass command output, contact the Customer Care Center. Refer to My Oracle Support (MOS) for the contact information.

At the IP near end node, connect all the other associations attached to the IP card specified in 19.
At the IP near end node, activate one of the associations attached to the IP card specified in 19.

At the EAGLE, enter the msucount -l pass command with the card location of the IP card specified in 19. For this example, enter this command.

pass:loc=1315:cmd=”msucount -l”

The following is an example of the possible output.


rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
PASS: Command sent to card

rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
MSUCOUNT: Command In Progress

rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
MSUCOUNT: MSU Count Report

--------------------------
Link Measurements (Link A)
--------------------------

Transmit Counts                      Receive Counts
----------------------------------   -----------------------------
rate   msus        bytes             rate   msus        bytes
-----  ----------  ---------------   -----  ----------  ----------
2000   4294967295  4294967295        2000   4294967295  4294967295

MTP Primitive (MTPP) counts          Reroute Counts
----------------------------------   ----------------------
sent pdus   rcvd pdus   dscrd pdus   sent msus   rcvd msus
----------  ----------  ----------   ----------  ----------     
4294967295  4294967295  4294967295   4294967295  4294967295     

END of Report

At the EAGLE, enter the msucount -a pass command with the card location specified in 22 and the association names specified in 18. For this example, enter this command.

pass:loc=1315:cmd=”msucount -a assoc3”

The following is an example of the possible output.


rlghncxa03w 06-10-28 21:17:37 GMT EAGLE5 36.0.0
PASS: Command sent to card

rlghncxa03w 06-10-28 21:17:37 GMT EAGLE5 36.0.0
MSUCOUNT: Command In Progress

rlghncxa03w 06-10-28 21:17:37 GMT EAGLE5 36.0.0
MSUCOUNT: MSU Count Report

--------------------------
IP Connection Measurements
--------------------------

Receive Counts                     Transmit Counts
--------------------------------   -----------------------------
msus            bytes              msus             bytes
----------      ----------------   ----------       ----------
4294967295      4294967295         4294967295       4294967295
Receive Discard Counts             Transmit Discard Counts
--------------------------------   ---------------------------------
reason                count       reason                 count
--------------------- ---------   ---------------------- ----------
link state            4294967295   sccp msg type          4294967295
sccp msg type         4294967295   sccp class             4294967295
sccp class            4294967295   normalization error    4294967295
sccp called party     4294967295   invalid traffic type   4294967295
sccp calling party    4294967295   M3UA conversion error  4294967295
isup sio              4294967295   SUA conversion error   4294967295
normalization error   4294967295
error in XSRV packet  4294967295
M3UA PDU error        4294967295
SUA PDU error         4294967295
invalid rcontext      4294967295

Stored Transmit Discard Data
----------------------------
no stored transmit discard data
Stored Receive Discard Data
---------------------------
53 41 53 49 69 73 6f 74 11 00 87 0a 01 03 01 05
05 00 01 02 03 04 05 06 07 08 09 00 00 00 00 00

END of Report

If the outputs of the pass commands in 22 and 23 show that traffic is not flowing over the association, refer to My Oracle Support (MOS).

At the IP near end node, activate all the other associations attached to the IP card specified in 23.
Repeat 4 through 24 to update the other IPSG cards in the EAGLE that contain IPSG M3UA associations with the new SCTP checksum algorithm.

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 the rtrv-card output in 2 shows cards running the IPLIM or IPLIMI applications, perform the Changing the SCTP Checksum Algorithm Option for M2PA Associations procedure.

If the rtrv-card output in 2 shows cards running the SS7IPGW or IPGWI applications, perform the Changing the SCTP Checksum Algorithm Option for M3UA and SUA Associations procedure.

If the rtrv-card output in 2 shows that there are no cards running the IPLIM, IPLIMI, SS7IPGW, or IPGWI applications, this procedure is finished.

Figure 6-32 Changing the SCTP Checksum Algorithm Option for IPSG M3UA Associations

Sheet 1 of 4

Sheet 2 of 4

Sheet 3 of 4

Sheet 4 of 4