> SGSN PSP Configuration Mode Commands
> The Peer-Server Process (PSP) configuration mode provides the commands to create, configure, bind, and manage a specific PSP instance for a SS7 Routing Domain.
> Important: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
> associate
> Defines an association between the PSP instance and an application server process (ASP) instance.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> associate asp instance asp_num
> no associate
> no
> Removes the association between the PSP and the ASP from the routing domain configuration.
> Important: Using this command will probably result in the termination of all current subscriber sessions active through the peer-server.
> asp_num
> Identifies a specific ASP configuration. Up to four ASP instances can be configured for a single SS7 routing domain.
> asp_num must be an integer from 1 through 4.
> Usage
> Create an association between a specific peer-server process (PSP) and a specific application server process (ASP) instance. The M3UA end-point of the ASP must be configured prior to configuring the PSP-ASP association. Use the commands defined in the ASP Configuration Mode chapter of the Command Line Interface Reference.
> Example
> associate asp instance 2
> end
> Exits the configuration mode and returns to the Exec mode.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> end
> Usage
> Change the mode back to the Exec mode.
> end-point
> This command defines or deletes the IP address to be associated with the local SCTP end-point for the application server process (ASP).
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> end-point { address ip_address | port port_number }
> no end-point [ address ip_address ]
> port port_number
> Identifies the M3UA’s SCTP port associated with this end-point.
> port_number: must be an integer from 1 to 65535.
> Removes the end-point configuration.
> no
> Removes the ASP end-point association from the PSP configuration.
> Important: This command can not be used as long as the PSP and the ASP are associated.
> Usage
> Use this command to manage the ASP end-point. At least one address needs to be configured for the ASP before the end-point can be associated with the PSP.
> Example
> Set the end-point to IP address 192.168.1.1 with the following command:
> end-point address 192.168.1.1
> exchange-mode
> Configures the exchange-mode for the peer-server process.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> exchange-mode [ double-ended | single-ended ]
> Usage
> Use this command to toggle the exchange modes for the peer-server process. The default (initial configuration) mode is double-ended.
> Example
> exchange-mode double-ended
> exit
> Exits the configuration mode and returns to the Global configuration mode.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> exit
> Usage
> Return to the Global configuration mode.
> psp-mode
> Configures the peer-server process (PSP) operational mode as either client or server mode.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> psp-mode { client | server }
> client
> The PSP operates as a client.
> server
> The PSP operates as a server.
> Usage
> Instruct the peer-server process to operator in either client or server mode.
> Example
> psp-mode server
> routing-context
> Configures the behavior of the routing context in M3UA messages.
> Important: This keyword function is only available in releases 8.1 and higher.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> routing-context { discard-inbound | process-inbound { insert-outbound | suppress-outbound }
> default routing-context
> default
> Include this keyword with the command, to reset the configuration to the system default for routing-context which is a combination of process-inbound and insert-outbound.
> discard-inbound
> Sets the routing context received in M3UA messages to be discarded.
> process-inbound
> Sets the routing context received in M3UA messages to be processed.
> insert-outbound
> Sets the routing context so that it is added in the M3UA messages.
> suppress-outbound
> Sets the routing context so that it is suppressed in the M3UA messages.
> Usage
> In PSP (singled-ended) configuration mode, the settings for both the local routing context (the SGSN's routing context) and the peer routing context (the RNC's routing context) should be the same. If the routing contexts created at the SGSN and on the peer are different then this can cause the M3UA link to fail.
> Routing context is an optional parameter when an M3UA association has only one associated peer-server.
> Example
> routing-context discard-inbound insert-outbound
> sctp-alpha
> This stream control transmission protocol (SCTP) retransmission time out (RTO) parameter defines a retransmission timeout value.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-alpha value
> default sctp-alpha
> value
> Defines a percentage (%) that represents the RTO portion of the RTT calculation. This percentage value must be an integer between 0 and 65535.
> default
> Resets the sctp-alpha to the default value of 5%.
> Usage
> sctp-alpha is used in conjunction with other commands, such as the sctp-beta command, to determine the round-trip time (RTT) calculations. The Alpha parameter is used to manage load balancing within the SS7 environment for multi-homed peers.
> Example
> sctp-alpha 256
> sctp-beta
> This stream control transmission protocol (SCTP) retransmission time out (RTO) parameter defines a retransmission timeout value.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-beta value
> default sctp-beta
> value
> Defines a percentage (%) that represents the RTO portion of the RTT calculation. This percentage value must be an integer between 0 and 65535.
> default
> Resets the sctp-beta to the default value of 10%.
> Usage
> Use this command in conjunction with other commands, such as the sctp-alpha command, to determine the round-trip time (RTT) calculations. The Beta parameter is used to manage load balancing within the SS7 environment for multi-homed peers.
> Example
> sctp-beta 512
> sctp-checksum-type
> This command selects the type of checksum algorithm to be used.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-checksum-type { adler32 | crc32 }
> default sctp-checksum-type
> adler32
> Selects the Adler-32 type of algorithm as a faster checksum function.
> crc32
> Selects the CRC-32, a slower but more reliable 32-bit cyclic redundancy check.
> default
> Resets the sctp-checksum-type to the default of CRC-32.
> Usage
> Use this command to set which type of checksum algorithm the SGSN is to use to validate SCTP packets.
> Example
> sctp-checksum-type crc32
> sctp-cookie-life
> This command sets the valid life for the SCTP cookie.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-cookie-life value
> default sctp-cookie-life
> value
> Sets the cookie life value in increments of 100 milliseconds. The range is 50 to 1200 .
> default
> Resets the sctp-cookie-life value to the default, 600 (= 60 seconds).
> Usage
> Use this command to set the SCTP cookie life.
> Example
> sctp-cookie-life 60
> sctp-max-assoc-retx
> This command sets the maximum number of datagram retransmissions to be associated with this peer server configuration.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-max-assoc-retx value
> default sctp-max-assoc-retx
> value
> Defines the maximum number of datagram retransmissions for an association. The value must be an integer between 0 and 255.
> default
> Resets the default for sctp-max-assoc-retx to 10.
> Usage
> Use this command to configure the maximum number of datagram retransmissions for an association. The endpoint will be declared unreachable after sctp-max-assoc-retx number of consecutive retransmissions to an endpoint on any transport address.
> Example
> sctp-max-assoc-retx 3
> sctp-max-init-retx
> This command sets the maximum number of retries to send the INIT datagram.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-max-init-retx value
> default sctp-max-init-retx
> value
> Sets the maximum number of retries. This value must be an integer between 0 and 255.
> default
> Resets the default for sctp-max-init-retx to 5.
> Usage
> Use this command to set the maximum number retries the SCTP layer should make to send the INIT datagram to the peer to open an association.
> Example
> sctp-max-init-retx 3
> sctp-max-mtu size
> This command sets the number of bytes that comprise the maximum MTU size.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-max-mtu-size value
> default sctp-max-mtu-size
> value
> Sets the maximum number of bytes for the SCTP MTU size. This value must be an integer between 508 and 65535.
> default
> Resets the default for sctp-max-mtu-size to 1500.
> Usage
> Use this command to configure the size of the MTU.
> Example
> sctp-max-mtu-size 1024
> sctp-max-out-strms
> This command sets the maximum number of outgoing streams through the PSP going towards the peer server.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-max-out-strms max#_out_streams
> default sctp-max-out-strms
> default
> Resets the SGSN’s sctp-max-out-strms value to the default of 16.
> max#_out_streams
> The value must be an integer between 1and 65535. The value should match the peer node’s (STP/SG/RNC/HLR) number of in-bound streams.
> Usage
> Use this command to balance the stream throughput from the PSP to the peer server. The value for this command is used to validate the incoming packets in the SCTP layer.
> Example
> sctp-max-out-strms 3500
> sctp-max-path-retx
> This command sets the maximum number of datagram retransmissions for this path.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-max-path-retx value
> default sctp-max-path-retx
> value
> Sets the maximum number of datagram retransmission to a destination transport address. This value must be an integer from 0 to 255.
> default
> Resets the sctp-max-path-retx default to 5.
> Usage
> Use this command to set the maximum number of datagram retransmissions to a destination transport address. The destination transport address will be declared unreachable after the SGSN exhausts the sctp-max-path-retx number of consecutive retransmissions to a destination transport address.
> Example
> sctp-max-path-retx 10
> sctp-rto-initial
> This command sets the initial retransmission timeout for the SCTP.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-rto-initial value
> default sctp-rto-initial
> value
> Sets the timeout in increments of 100 milliseconds. The value must be an integer between 10 and 1200.
> default
> Resets the system to the sctp-rto-initial default of 30 (3 seconds).
> Usage
> Use this command to define the initial retransmission timer.
> Example
> sctp-rto-initial 240
> sctp-rto-max
> This command sets the maximum retransmission timeout value for the SCTP.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-rto-max value
> default sctp-rto-max
> default
> Resets the system to the sctp-rto-max default of 600 (60 seconds).
> value
> Set the maximum retransmission timeout value in increments of 100 milliseconds and the value must be an integer between 5 and 1200.
> Usage
> Use this command to configure the maximum time for retransmissions.
> Example
> The following sets the timeout for 45 seconds:
> sctp-rto-max 450
> sctp-rto-min
> This command sets the minimum retransmission timeout (RTO) value for the SCTP.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-rto-min value
> default sctp-rto-min
> default
> Resets the sctp-rto-min to the default of 10 (1 second).
> value
> Sets the minimum retransmission timeout in increments of 100 milliseconds. The value must be an integer from 1 to 50.
> Usage
> Use this command to set the minimum time for retransmission before timeout.
> Example
> The following sets the timeout for 2 seconds:
> sctp-rto-min 20
> sctp-sack-frequency
> This command sets the frequency of transmission of SCTP selective acknowledgements (SACK).
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-sack-frequency value
> default sack-frequency
> value
> Sets the maximum number of datagrams to be received prior to sending a SACK to the peer. The value must be an integer between 1 and 5.
> default
> Resets the sctp-sack-frequency default value of 2.
> Usage
> Use this command to set the maximum number of datagrams to be received before a SACK must be sent to the peer. The sctp-sack-frequency is used in conjunction with the sctp-sack-period to control the generation of SACK, depending on which one occurs first.
> Example
> sctp-sack-frequency 3
> sctp-sack-period
> This command sets the delay before sending an SCTP selective acknowledgement (SACK).
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sctp-sack-period value
> default sack-period
> value
> Sets the maximum time, in increments of 100 milliseconds, before the system must send a SACK to the peer. The value must be an integer from 0 to 5.
> default
> Resets the system to the sctp-sack-period default value, 2 (=200 milliseconds).
> Usage
> Use this command to set the time the SCTP waits to send a SACK.
> Example
> s ctp-sack-period 120
> sctp-suppress-alarm
> This command enables/disables the suppression of alarms for SCTP path failure between two peer endpoints.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> [ no ]sctp-suppress-alarm path-failure self-end-point-address orig_ipv4_address peer-end-point-address peer_ipv4_address
> no
> Disables the pre-configured alarm suppression for SCTP path failure.
> path-failure
> This keyword specifies that the alarm suppression is for SCTP path failure between two peer nodes.
> self-end-point-address orig_ipv4_address
> This keyword specifies the IP address of the originating endpoint.
> orig_ipv4_address is the IP address of originating endpoint in IPv4 dotted decimal notation.
> peer-end-point-address peer_ipv4_address
> This keyword specifies the IP address of the peer endpoint.
> peer_ipv4_address is the IP address of peer endpoint in IPv4 dotted decimal notation.
> Usage
> Use this command to configure the path failure alarm suppression. This command ignores the alarms generated on SCTP path failure.
> Example
> The following command suppresses the path failure alarms occurred in SCTP path between originating peer address 1.2.3.4 and peer endpoint 6.7.8.9:
> sctp-suppress-alarm path-failure self-end-point-address 1.2.3.4 peer-end-point-address 6.7.8.9
> timeout
> This command sets the times for various timeout timers.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> timeout { m3ua-periodic-dest-audit dest_timeout | sctp-bundle bundle_time | sctp-heart-beat hrt_bt_timeout }
> default timeout sctp-heart-beat
> default
> Resets the system to the default values.
> m3ua-periodic-dest-audit dest_timeout
> Sets the period (in increments of seconds) between the DAUD messages while auditing a destination state.
> dest_timeout: Must be an integer from 1 to 65535. Default is 2.
> sctp-bundle
> Sets the SCTP bundle timeout value in incremenets of 100 milliseconds, with a range of 1 to 65535. By default, SCTP bundling is disabled.
> sctp-heart-beat hrt_bt_timeout
> Sets the number of seconds in the SCTP heart-beat timer
> hrt_bt_timeout: This value is an integer between 1 and 300. Default is 30.
> Usage
> Use this command to configure timers. Repeat the command with each of the keywords to set values for each.
> Example
> timeout m3ua-periodic-dest-audit 120

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883