Auto Tasks

There are a number of background jobs that are performed by the Yvva-based td-regserver service.

You can review and manage them via the Registration Server Administration Console by clicking Admin -> Manage Auto Tasks. See Manage Auto Tasks for details.

The overall frequency of how often the background service will wake up can be changed by modifying the setting repeat in file /etc/td-regserver.conf. The default value is 10 seconds.

Note that the frequency of the individual tasks can be defined differently, by changing each task’s Frequency setting (if required).

“Send Emails” Task

This process sends out email notifications generated by actions from the Team Drive Clients and Registration Server (e.g. device activation or Space invitation messages, license expiry reminders), which are queued in the Registration Server’s internal email queue.

“Delete Old Messages” Task

Messages not retrieved by Clients will be deleted from the Registration Server’s internal message queues after the period defined in the Registration Server settings <InvitationStoragePeriod> (e.g. invitations and other client messages, store-forward invitations) and <InvitationStoragePeriodFD> (invitations for future devices).

See Registration Server Settings and Messages, Invitations & Invitation Types for details on these settings and the various message types.

“Delete Client IPs” Task

For privacy/data protection reasons, this task removes the Client IP addresses from the Devices table according to the value of <StoreRegistrationDeviceIPinSeconds> as described in Registration Server Settings.

“Update RegServer-List” Task

This task checks the synchronises a number of settings of the local Registration Server with the data stored on TDNS for the server.

The parameters update include: RegServerURL, AuthorizationSequence, DefaultProvider and RegServerDescription.

If any of the values on TDNS differ to those set in these stored by TDNS then the TDNS values are updated.

By default, this task will be performed every 12 hours.

“CleanUp” Task

If API logging is enabled (the Provider setting API_REQUEST_LOGGING is set to True), each API request is logged in a database table. On a busy server, these log entries can significantly increase the size of the Registration Server’s database over time.

Enabling this task will remove entries from the API log table, if they are older than 30 days. This task is disabled by default.

This task will also clean up the Client log-files, if they are older than 90 days (See Client Log Files).

“CSV Import” Task

Enable this task if you want to manage your users by importing the usernames and other details from an external source via a CSV file. This auto task will perform the import on a periodic basis.

The task can create new users, update existing users and disable users as required. See Importing Users via CSV Files for details on how to accomplish this.

“Deactivate/Activate Devices” Task

This task is new in Registration Server 4.5.0. It uses the MAXIMUM_DEVICES_PER_USER (see MAXIMUM_DEVICES_PER_USER) Provider setting to determine whether user devices must be enabled or disabled in order to ensure that only the required number of devices per user is active.

The task always disables the least recently used (or accessed) devices. This means that a disabled device can be re-enabled by starting the TeamDrive client, which updates the device access time.

The activation of devices changes, on average, every 3 hours according to their usage. If devices are enabled or disabled the task sends an email to the affected user, using the devices-disabled email template.

“Delete Providers” Task

This task deletes Providers that have been marked for deletion.

“Expire Licenses” Task

If you issue licenses with an expiration date (e.g. by issuing trial licenses or by entering a date in the Valid until field manually), this task takes care of sending out reminder emails to the license’s user(s), informing them about the upcoming expiration. Once the expiration date has been reached, the license will be invalidated and the user’s TeamDrive clients will fall back to their default license.

“License Report” Task

Create a report on licenses and usage.

“Remove Auto Created Users” Task

Remove users that have been automatically created by an invitation if they are not activated within AUTO_CREATED_USER_TIMEOUT days.

“Send Notifications” Task

Send notifications of user change events that could not be sent synchronously.

Further details are provided in the chapter User Change Notifications.