Skip to main content

AVIX5 Server configuration for time-scheduled Active Directory sync tasks


To enable the AVIX server to run time-scheduled jobs, you will need to configure a couple of directives in the preference file. 

Furthermore, since the aim is that the AVIX server will perform queries vs. Directory Service (e.g. Active Directory), you will need to submit user credentials (user name  + password) so that the AVIX server is able to authenticate to the directory service. 


quartz scheduling preferences

Make sure that you have a preference file "configuration/se.solme.avix.prefs" in the installation path of the server. Now add the following preference keys:

[se.solme.avix.scheduling]
# Whether Quartz scheduler should be enabled. Default is false. 
# This needs to be enabled, to make Cron scheduling work (e.g. for LDAPUserGroups that are synced from ActiveDirectory)
avix.quartzscheduler.enable = true

[se.solme.avix.security.storage]
# Cron expression for when the Storage scanning (a job that goes through loaded storage, and finds objects of interest that have sync configuration) will be triggered.
# The default is "0 0 * * * ?", which means fire every hour.
# Note that the pref 'avix.quartzscheduler.enable' needs to be enabled too.
# Below example read: Fire every 2 minutes.
avix.scheduler.storagescan.cronexpr = 0 0/2 * * * ?

As seen in the comments, the "enable" preference has to be set to true. The "cronexpr" example value is set to fire every 2 minutes, which is good for testing purposes when you want to see the effect pretty quickly. In a real-world production scenario, this is likely to be too frequent. 

Your AVIX server will need restarting, if you make any changes to the configuration file.

USER CREdentials

Put a text file "auth.txt" in the root directory of the server installation. In this file, add credentials (domain, user name, password) using either of these forms:

domain/user,password

domain,user,password


Since this file contains confidential credentials, it is advisable that you assign the appropriate security permissions to it. The user (account) running the AVIX server service will need Read permission to this file.