Renew Interval

The renew interval can be used to specify how often—if ever—the client may attempt to recontact the local license server. Successful contact extends the expiration based on the effective borrow interval (in other words, the timer for the effective borrow interval is restarted).

The producer can set the renew interval at feature level in the back office, or at server level using the property licensing.renewInterval in producer-settings.xml. The renew interval is set as a percentage of the effective borrow interval. The default value is 15. For information on how the effective borrow interval is calculated, see Determining the Effective Borrow Interval.

Important:This specification by itself does not lead to enforcement. The client-side APIs must extract this value from the license server capability response and take appropriate action.

Example

The following example illustrates how the renew interval might be used:

Settings: Effective borrow interval = 604800s (1 week); renew interval = 15

Suppose the device initially obtains its license on January 1. The 7-day effective borrow interval results in a license that is valid until January 8. The 15% renew interval indicates that the device should attempt to recontact the server after 90720 seconds, that is, on January 2 (15% of 604800 seconds = 90720 seconds = approx. 1 day). If successful, the license is now valid until January 9. If unsuccessful, the license remains valid until the end of the original borrow period, which is still January 8.