1 = Using imip-agent = 2 3 With imip-agent deployed, usage of the software should occur automatically. 4 However, evidence of its operation will only emerge when calendar-related 5 messages are exchanged between e-mail users. This will cause a few different 6 things to happen: 7 8 * Summary messages may be sent by the calendar system to mail recipients 9 10 * Replies to calendar-related messages may be received by the senders of 11 those messages 12 13 * Free/busy information will become available, either in responses to 14 requests sent over e-mail, or [[../FreeBusyPublishing|over the Web]] 15 16 In the background, imip-agent uses and updates information as described in the 17 [[../FilesystemUsage|filesystem usage guide]]. 18 19 == Creating User Data Stores == 20 21 The [[../MailIntegration|mail system]] mechanisms are responsible for 22 determining whether a valid recipient has been specified in any given message, 23 and imip-agent does not attempt to validate such information again. Therefore, 24 when a message is received for a calendar user for whom no data store has been 25 initialised in the [[../FilesystemUsage|filesystem]], the software will 26 automatically create one. 27 28 Consequently, users for whom such data stores have been created will experience 29 the software using the default configuration, described in the 30 [[../Preferences|preferences guide]]. It is for this reason that the default 31 values in the [[../Configuration|configuration]] should be adjusted according 32 to the policies decided for the deployment of this software. 33 34 However, it is possible to create data stores for users in advance using the 35 `tools/init_user.sh` script as in the following example: 36 37 {{{ 38 tools/init_user.sh mailto:vincent.vole@example.com 39 }}} 40 41 Here, the user identity is given as a URI since this is how iCalendar references 42 participants in scheduling operations. The result of the above command should be 43 some new directories in the [[../FilesystemUsage|filesystem area]] dedicated to 44 calendar information storage. 45 46 === Adjusting Preferences === 47 48 Once initialised, the user preferences can be adjusted by adding files to the 49 `preferences` directory created by the above command. For example, if a user has 50 elected to not participate in the calendar system, a file called `participating` 51 can be added as follows: 52 53 {{{ 54 echo 'no' > '/var/lib/imip-agent/preferences/mailto:vincent.vole@example.com/participating' 55 }}} 56 57 Here, the default storage location has been given in the filename. 58 59 Normally, users should visit the [[../CalendarManager|management interface]] to 60 change their preferences, but modifications done by administrators are more 61 efficiently performed by directly interacting with the filesystem. For example, 62 an administrator might initialise the common names of users by scripting changes 63 to the `CN` file for each user, obtaining such names from some kind of database. 64 65 == Excluding Users Entirely == 66 67 Since the [[../AgentPrograms|agent programs]] are installed as part of the mail 68 handling workflow, even the configuration of non-participation in the calendar 69 system for users will still result in those users' messages being passed along 70 the workflow by imip-agent, which may result in a decrease in general mail 71 delivery performance. 72 73 To exclude users entirely, the routing configuration of the 74 [[../MailIntegration|MTA]] needs to be changed so that such users identities are 75 not recognised as calendar system participants, thus preventing their messages 76 from being routed via imip-agent. This is as simple as either not listing the 77 identity in [[../MailIntegration/Simple|lists of addresses]] or by adjusting 78 [[../MailIntegration/LDAP|queries yielding calendar users]].