Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

Changing PCEF Profiles, PCC Rules, PCC Rulebases, Diameter Profiles, Flow Descriptions, and PCC Action Profiles

date_range 13-Jan-21

These procedures show how to enter maintenance mode to halt new sessions from being started and verify that no sessions remain on either the gateway or TDF domain before making changes to the following:

  • PCEF profiles (However, maintenance mode is not required to add PCC rules or rulebases to a dynamic PCEF profile.)

  • PCC rules

  • PCC rulebases

  • Diameter profiles

  • Flow descriptions

  • PCC action profiles

Note:

Even when a PCEF profile is not associated with a TDF domain or a TDF domain-selection term, configuration changes or deletion of the PCEF profile and any referenced objects of the profile require you to activate maintenance mode for the TDF gateway.

Changing PCEF Profiles, PCC Rules, PCC Rulebases, Diameter Profiles, Flow Descriptions, and PCC Action Profiles with the TDF Domain in Maintenance Mode

This procedure shows operators how to enter maintenance mode to halt new sessions from being started and to verify that no sessions remain on the TDF domain before making changes to PCEF profiles, PCC rules, PCC rulebases, Diameter profiles, flow descriptions, and PCC action profiles for a TDF domain.

To activate maintenance mode for the TDF domain and make changes:

  1. From configuration mode, activate maintenance mode for the TDF domain.
    content_copy zoom_out_map
    [edit]
    user@host# set unified-edge gateways tdf gateway-name domain domain-name service-mode maintenance 
    user@host# commit
    
  2. Verify that the TDF domain is in maintenance mode.
    content_copy zoom_out_map
    [edit]
    user@host# run show unified-edge tdf domain service-mode
    

    The service mode for the TDF domain shows Maintenance–Active Phase if all the sessions using this TDF domain are cleared. The service mode for the TDF domain shows Maintenance - In Phase if some sessions are actively using this TDF domain.

  3. Verify that no subscribers are active on the TDF domain.
    content_copy zoom_out_map
    [edit]
    user@host# run show unified-edge tdf subscribers | match domain-name
    
  4. (Optional) Terminate any remaining sessions on the TDF domain by using the clear command.
    content_copy zoom_out_map
    [edit]
    user@host# run clear unified-edge tdf subscribers | match domain-name
    
  5. Verify that the TDF domain is in Active Phase.
    content_copy zoom_out_map
    [edit]
    user@host# run show unified-edge tdf domain service-mode
    
  6. Make the configuration changes and commit the changes.
  7. Exit maintenance mode.
    content_copy zoom_out_map
    [edit]
    user@host# delete unified-edge gateways tdf gateway-name domain domain-name service-mode 
    user@host# commit
    
  8. Verify that changes were properly committed.
    • To view a PCEF profile configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef profiles profile-name 
      
    • To view a PCC rulebase configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef pcc-rulebases rulebase-name 
      
    • To view a PCC rules configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef pcc-rules rule-name 
      
    • To view a flow description configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef flow-description flow-identifier 
      
    • To view a PCC action profile configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef pcc-action-profiles profile-name 
      
  9. Return the gateway to operational state.
    content_copy zoom_out_map
    [edit]
    user@host# run show unified-edge tdf gateway service-mode 
    

Changing PCEF Profiles, PCC Rules, PCC Rulebases, Diameter Profiles, Flow Descriptions, and PCC Action Profiles with the TDF Gateway in Maintenance Mode

This procedure shows how to enter maintenance mode to halt new sessions from being started and to verify that no sessions remain on the TDF gateway before making changes to PCEF profiles, PCC rules, PCC rulebases, Diameter profiles, flow descriptions, and PCC action profiles across multiple TDF domains on the gateway.

To activate maintenance mode for the gateway and make changes:

  1. From configuration mode, activate maintenance mode for the gateway.
    content_copy zoom_out_map
    [edit]
    user@host# set unified-edge gateways tdf gateway-name service-mode maintenance 
    user@host# commit
    
  2. Verify that the TDF gateway is in maintenance mode.
    content_copy zoom_out_map
    [edit]
    user@host# run show unified-edge tdf service-mode
    

    From the gateway hierarchy, the service mode shows Maintenance—Active Phase if all the sessions are cleared. The service mode shows Maintenance—In Phase if some sessions are active. The service mode shows Maintenance—Out Phase if maintenance mode is not configured, and the gateway is in operational mode.

  3. Make the configuration changes.

    You can modify a PCEF profile by making changes to the PCC rules, PCC rulebases, or flow identifiers that the PCEF profile references or by specifying a different PCC rule, rule precedence, PCC rulebase, or Diameter profile in the PCEF profile.

  4. Exit maintenance mode and commit the changes.
    content_copy zoom_out_map
    [edit]
    user@host# delete unified-edge gateways tdf gateway-name service-mode 
    user@host# commit
    
  5. Verify that changes were properly committed.
    • To view a PCEF profile configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef profiles profile-name 
      
    • To view a PCC rulebase configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef pcc-rulebases rulebase-name 
      
    • To view a PCC rules configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef pcc-rules rule-name 
      
    • To view a flow description configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef flow-description flow-identifier 
      
    • To view a PCC action profile configuration:

      content_copy zoom_out_map
      [edit]
      user@host# run show configuration unified-edge pcef pcc-action-profiles profile-name 
      
  6. Return the gateway to operational state.
    content_copy zoom_out_map
    [edit]
    user@host# run show unified-edge tdf gateway service-mode 
    
footer-navigation