Configuring push notification expiration timer

Last Updated : Mar 14, 2025 |

About this task

Use this procedure to set an expiration time for push notification messages on Session Manager. Acceptable values are 0 to 3600 seconds.

Note:

Due to Apple's own apns-expiration header handling, it is possible for Apple servers to deliver the push notification to client's Apple device after the expiry of the push notification message timer. For more information on how Apple handles message expiration, see Sending Notification Requests to APNs; Table 1 Header Field: apns-expiration.

Before you begin

Ensure that all core Session Manager instances are on the same software release.

Procedure

  1. Log in to Session Manager CLI using root or sroot credentials.
  2. Run the command sm set LocalSetting APN_EXPIRATION_TIMER {time in seconds}.

    Session Manager sets the timer to the value specified and shows the Current Value, Default Value, Minimum Value, and Maximum Value fields.

  3. Save the changes.
  4. To verify the push notification expiration timer, run the command sm get LocalSetting APN_EXPIRATION_TIMER.