Configuring the Diameter Application (SRC CLI)

• Configuring the Diameter Application Properties
• Configuring the Diameter Client Properties
• Configuring the Diameter Server Properties
• Configuring Logging Destinations

Configuring the Diameter Application Properties

The SRC software supports Diameter application properties such as Juniper Networks Session Resource Control (JSRC), Packet-Triggered Subscribers and Policy Control (PTSP), and GX-Plus. JSRC and PTSP communicates with the Service Activation Engine (SAE) (remote SRC peer), whereas GX-Plus communicates with the Policy and Charging Rules Function (PCRF).

Use the following configuration statements to configure the properties for the Diameter application:

To configure the Diameter application:

1. From configuration mode, access the statement for the Diameter application.
   user@host# edit system diameter

   Note: The java-* options have default values that should not be changed unless directed by Juniper Networks Technical Assistance Center (JTAC).

2. If you encounter problems caused by lack of memory, change the maximum memory size available to the Java Runtime Environment (JRE).
   [edit system diameter]user@host# set java-heap-size java-heap-size
3. Configure the amount of space available to the JRE when the Diameter server starts.
   [edit system diameter]user@host# set java-new-size java-new-size
4. Configure the garbage collection functionality of the Java Virtual Machine.
   [edit system diameter]user@host# set java-garbage-collection-options java-garbage-collection-options
5. Specify the protocol for the transport connection.
   [edit system diameter] user@host# set protocol [(tcp | sctp)...]
6. (Optional) Specify the local IP addresses that remote peers can use to reach this server.
   [edit system diameter]user@host# set local-address [local-address...]
7. (Optional) Specify the port for the server.
   [edit system diameter]user@host# set port port
8. (Optional) Specify the fully qualified domain name (FQDN) used to identify this host to its Diameter peers.
   [edit system diameter]user@host# set origin-host origin-host
9. (Optional) Specify the realm used to identify this host to its Diameter peers.
   [edit system diameter]user@host# set origin-realm origin-realm

   The Diameter realm should be configured to the domain name of the origin host. For example, if the FQDN of the host is host.juniper.net, then the realm should be juniper.net. For PTSP, realm-based Diameter routing is not used.

10. (Optional) Configure the timeout value until which the Diameter server holds unsolicited requests such as Point to Point Protocol (PPP) and Abort Session Request (ASR), and waits for a matching response such as Push Profile Answer (PPA) and Abort Session Answer (ASA). The server discards the responses received after the specified time. The value range is 1–65,565 seconds. The preferred value is 10–30 seconds. By default, the value is set to 25 seconds.
    [edit system diameter]user@host# set diameter-server-timeout diameter-server-timeout

    Note: diameter-server-timeout and reply-timeout under the [edit shared sae group configuration driver] hierarchy should be configured with the same value.

11. (Optional) Specify whether the peer connection is in active mode.
    [edit system diameter]user@host# set active-peers

    Note: Active mode means that the SRC software actively tries to connect to the peer. Make sure the peer you are connecting to supports active peers. The MX Series router does not support active peers. The SRC software can still be configured, but the connection attempts will not work. If the peer connection is configured to be in active mode, you must configure the remote peer address for all Diameter peers by using the address option under the [edit shared network diameter peer name] hierarchy.

12. (Optional) Specify whether the peer connection is in debug mode.
    [edit system diameter] user@host# set debug-mode
13. (Optional) Configure the load-balancing mode for peer selection when forwarding a request message.
    [edit system diameter] user@host# set load-balancing-mode (failover | round-robin)
14. (Optional) Configure the log level for the transaction processing log.
    [edit system diameter] user@host# set transaction-processing-log log-level

    where log-level is one of the following:

    • log-no-messages—Do not log any messages.
    • log-severe-messages—Log only severe messages.
    • log-normal-messages—Log only normal messages.
    • log-debug-messages—Log only debug messages.
15. (Optional) Configure the log level for the packet tracing log.
    [edit system diameter] user@host# set packet-trace-log log-level

    where log-level is one of the following:

    • log-no-messages—Do not log any messages.
    • log-severe-messages—Log only severe messages.
    • log-normal-messages—Log only normal messages.
    • log-debug-messages—Log only debug messages.
16. (Optional) Configure the log level for the peer state machine log.
    [edit system diameter] user@host# set peer-state-machine-log log-level

    where log-level is one of the following:

    • log-no-messages—Do not log any messages.
    • log-severe-messages—Log only severe messages.
    • log-normal-messages—Log only normal messages.
    • log-debug-messages—Log only debug messages.
17. (Optional) Configure the log level for the configuration log.
    [edit system diameter] user@host# set configuration-log log-level

    where log-level is one of the following:

    • log-no-messages—Do not log any messages.
    • log-severe-messages—Log only severe messages.
    • log-normal-messages—Log only normal messages.
    • log-debug-messages—Log only debug messages.

Configuring the Diameter Client Properties

This procedure configures the client-side adapter of the SRC Diameter server, which handles client connections. Configuration should be necessary only if you encounter performance problems.

Use the following statements to configure the properties for the Diameter client:

To configure the Diameter client properties:

1. From configuration mode, access the statement for the Diameter client.
   user@host# edit system diameter client
2. (Optional) Specify the number of threads to use.
   [edit system diameter client] user@host# set threads threads
3. (Optional) Specify the time to wait for new commands.
   [edit system diameter client] user@host# set keep-alive-time keep-alive-time

Configuring the Diameter Server Properties

Use the following statements to configure the properties for the Diameter server:

To configure the Diameter server properties:

1. From configuration mode, access the statement for the Diameter server.
   user@host# edit system diameter server
2. (Optional) Specify the minimum number of threads to use.
   [edit system diameter server] user@host# set threads threads
3. (Optional) Specify the time to wait for new commands.
   [edit system diameter server] user@host# set keep-alive-time keep-alive-time

Configuring Logging Destinations

Use the following configuration statements to configure logging destinations for Diameter:

To configure logging destinations to store log messages in a file:

1. From configuration mode, access the statement that configures the name and type of logging destination.
   user@host# edit system diameter logger name file
2. Specify the properties for the logging destination.
   [edit system diameter logger name file] user@host# set ?

   For more information about configuring properties for the logging destination, see Configuring Logging Destinations to Store Messages in a File (SRC CLI).

Related Documentation

• SRC CLI Commands to Monitor the SRC Diameter Server
• To manage services for JSRC peers on MX Series routers, see Managing Services on MX Series Routers Using the Diameter Application.
• To manage policies for PTSP peers on MX Series routers, see Configuring PTSP to Manage Subscriber-Level Policies.