IMS Sh Service Configuration Mode Commands

The IMS Sh Interface Configuration Mode is used to configure various Diameter parameters in order for:

PDIF to communicate with the HSS server. HSS server is used for MAC address validation in the IKEv2 exchanges to set up SAs and for storing part of the user profile.SCM to communicate with the HSS server. HSS server is used for retrieval and update of call feature parameters and call restriction data.

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

diameter

This command configures Diameter parameters.

Platform:

ASR 5000

Product:

PDIF, SCM


Privilege:

Administrator


Syntax 
diameter { dictionary { custom1 | standard | endpoint string }default diameter { dictionary | endpoint }no diameter endpoint
no

Removes previously configured endpoint.

default

Configures parameters to the default value.

dictionary
Specifies the dictionary to use.
  • custom1: A custom dictionary
  • standard: The standard dictionary

IMPORTANT:

SCM uses only the standard dictionary.

endpoint string

Selects an endpoint to use in the configuration.

string must be the endpoint name, and must be an alpha and/or numeric string of 1 through 63 characters in length.


Usage:

The Diameter endpoint contains information on the peer names and IP addresses and port, and the local IP address to use for Diameter.

You can have more than one Diameter endpoint configured on the chassis and the ims-sh-service needs to know which Diameter endpoint to use. This command is to select the appropriate Diameter endpoint, even if only one has been configured.


Example:
The following example selects a diameter endpoint diam1: 
diameter endpoint diam1
end

Exits the current mode and returns to the Exec Mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax 
end

Usage:

Use this command to change to the Exec Mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax 
exit

Usage:

Use this command to return to the parent configuration mode.

failure-handling

This command configures the action to take in the event of an HSS server request failure.

Platform:

ASR 5000

Product:

PDIF, SCM


Privilege:

Administrator


Syntax 
[ default ] failure-handling { profile-update-request | user-data-request } { { diameter-result-code result_code [ to result_code ] } | timeout } action { continue | retry-and-terminate | terminate } } }
default

Resets configuration for the specified keyword to the default setting.

profile-update-request

Configures failure-handling as a result of a profile update request error.

user-data-request

Configures failure-handling as a result of a user data request.

diameter-result-code result_code [ to result_code ]
The Result-Code data field contains a space representing errors. Diameter provides the following classes of errors, all identified by the thousands digit in the decimal notation:
  • 3xxx (Protocol Errors)
  • 4xxx (Transient Failures)
  • 5xxx (Permanent Failure)

result_code specifies either a result code value (diameter-result-code 3001) or a range of result code values (diameter-result-code 3000 to 9999) to which the failure-handling applies.

action
Configures the action to take depending on the diameter-result-code:
  • Continue the session
  • Retry and then terminate
  • Terminate the session
request-timeout action
Configures the action to take as a result of a request timeout error:
  • Continue the session
  • Retry and then terminate
  • Terminate the session

Usage:

Configures all failure-handling parameters.


Example:
The following command configures profile-update-request failure-handling using a result-code configuration with the terminate session option:
failure-handling profile-update-request diameter-result-code 3005 to  3600action terminate
request

Configures application request timeout.

Platform:

ASR 5000

Product:

PDIF, SCM


Privilege:

Administrator


Syntax 
request timeout secs[ no | default ] request timeout
no

Disables a configured timeout request.

default

Default: 300 seconds

Resets configuration to the default setting.

request timeout secs

Configures the request timeout in seconds.

secs must be an integer from 1 through 300.


Usage:

Specifies the session request timeout period in seconds after which the request is deemed to have failed.


Example:
The following example configures the default timeout request of 300 seconds:
default request timeout