Support

Change the polling time for Print Deploy

This page applies to:

The polling frequency determines how often the Print Deploy client contacts the Application Server to check for new print queues. By default, this is every 15 minutes plus and minus a random offset to avoid all clients calling in at the same time.

The Print Deploy client polls the server for a list of printers every x number of seconds, where:
x = IntervalSecs + Rand.between(MinRandomOffsetSecs , MaxRandomOffsetSecs)

Changing the polling values

You can change the number of seconds in two ways:

  • Via the Settings tab in the Print Deploy admin interface.

  • Update the values in the client.conf.toml file, located in:

    <PaperCut NG\MF installation folder>\providers\print-deploy\win\data\config\client.conf.toml

    Any change to the .toml file requires a PaperCut Print Deploy Server service restart .

Config value

IntervalSecsThis value needs to be a positive integer value.

Default is 900 seconds.
MinRandomOffsetSecsMust be a negative value.

Default is -300 seconds.

Minimum value: -2147483647

This value MUST NOT exceed the intervalSecs value. For example do not set MinRandomOffsetSecs to -1800 if IntervalSecs is set to 900.
MaxRandomOffsetSecsMust be a positive value.

Default is 300 seconds.

Maximum value: 2147483647

Example 1:

The polling values below (the default values) give a polling time of 15 minutes, plus or minus 5 minutes. This results in a minimum time of 10 minutes and maximum time of 20 minutes. They are calculated after each check-in.

[PollingConfig]
IntervalSecs = 900
MinRandomOffsetSecs = -300
MaxRandomOffsetSecs = 300

Example 2:

If for whatever reason you don’t want computers to call in other than at startup, set the IntervalSecs value to its maximum value: 2147483647. Keep the other offset settings as they are.

[PollingConfig]
IntervalSecs = 2147483647
MinRandomOffsetSecs = -300
MaxRandomOffsetSecs = 300

Example 3:

If you only want computers to call in once a day, set the IntervalSecs value to 86400 (24 hours). In this example the offset has been updated to -7200 and 7200. This results in a polling time of once every 24 hours, plus or minus 2 hours, which results in a minimum time of 22 hours and a maximum time of 26 hours.

[PollingConfig]
IntervalSecs = 86400
MinRandomOffsetSecs = -7200
MaxRandomOffsetSecs = 7200

Confirming your changes through log files

You can confirm your configuration on the user’s computer by looking at the following logs:

Windows: C:\Program Files\PaperCut Print Deploy Client\data\logs\pc-print-deploy-client.log

macOS: /Applications/PaperCut Print Deploy Client/data/logs/pc-print-deploy-client.log

The PaperCutPrint Deploy Client logs look like this:

2019/07/22 17:39:24 pc-print-deploy-client.exe: STDOUT|SUPPORT: querying for printer list again after **37 seconds** {"src":"scheduler.go:39"}
2019/07/22 17:40:01 pc-print-deploy-client.exe: STDOUT|SUPPORT: querying for printer list again after **70 seconds** {"src":"scheduler.go:39"}
2019/07/22 17:41:11 pc-print-deploy-client.exe: STDOUT|SUPPORT: querying for printer list again after **78 seconds** {"src":"scheduler.go:39"}

Comments