Jobs

MailStore Server allows the creation of jobs to execute server side Management API-Commands in the background. Templates are available for the most important Management API-Commands, which simplifies the creation of jobs.

Creating Jobs

To create a new job, proceed as follows:

Log on to MailStore Client as MailStore administrator.
Click on Administrative Tools > Management API and then Jobs.
Select a template from the Create Job section for the type of job to be created or click on Manual... to set up background execution of other Management API commands.
If a template was selected, it may be required to make additional settings in the Common Settings section of the New Job dialog. Otherwise enter the Management API command and all its arguments in the Action text box alike you would in the Management Shell.
Now specify in the Schedule section when and how often the job should to be executed.
Important notice: Running storage maintenance commands too frequently may have a negative impact on the overall performance of the system and thus should preferably carried out during non-working hours.
Click OK to create the new job.

The newly created job will now be executed in the background based on its configured schedule. In order to verify if the job execution results in the expected behavior, jobs can be run manually at any time before its first automatic execution.

Verifying Job Results

To show the results of the last job execution or results of all previous executions of a particular job, proceed as follows:

Log on to MailStore Client as MailStore administrator.
Click on Administrative Tools > Management API and then Jobs.
Select a job from the Jobs table.
Click on Details... in the Last Executions section next to the job list to show the result of the most recent execution or click on All Results.. to display the list of results of all previous executions.
If All Results.. was clicked, double clicking on a list item in the Last Results dialog opens its details.

Information about showing the results of all jobs can be found in Job Results.

Executing Jobs Manually

Follow the instructions below to to execute jobs manually:

Log on to MailStore Client as MailStore administrator.
Click on Administrative Tools > Management API and then Jobs.
Select a job from the Jobs table.
Click on Run in the Current State section next to the job list.

After the execution finished you can verify the job results.

Modifying Jobs

In the following it is describe how the different job properties can be changed at any time.

Status

Newly created jobs are enabled by default and therefore will be automatically executed in the background based on their individual schedule. To suppress the executions, the job status can be adjusted accordingly. To do this, proceed as follows:

Log on to MailStore Client as MailStore administrator.
Click on Administrative Tools > Management API and then Jobs.
Right click on the job to be modified in the Jobs table and uncheck the Enabled option to disable the scheduled execution or check the Enabled option to re-enable the scheduled execution of a previously disabled job.

Rename

To rename a job, proceed as follows:

Log on to MailStore Client as MailStore administrator.
Click on Administrative Tools > Management API and then Jobs.
Right click on the job to be renamed and then select Rename....
Enter a new name for the job.
Click OK to rename the job.

Change Owner

In rare cases it might be necessary to change the owner of a job. As jobs must be owned by a MailStore administrator, no other user will be selectable in the corresponding dialog. Proceed as follow to change the owner of a job:

Log on to MailStore Client as MailStore administrator.
Click on Administrative Tools > Management API and then Jobs.
Right click on the appropriate job and then click on Change Owner....
Select the new owner in the Select User dialog.
Click on OK to change the owner.

Properties

To modify the properties of jobs proceed as follows:

Log on to MailStore Client as MailStore administrator.
Click on Administrative Tools > Management API and then Jobs.
Double click on the job to be modified or right click on the job and then click on Properties.
Make the desired changes to to job properties.
Click OK to save the changes.

Templates

Template	Description
Storage
Synchronize with Directory Services	Synchronizes the MailStore user database with the configured directory service. The behavior is equivalent to clicking on Synchronize at Administrative Tools > Users and Privileges > Directory Services. 'Please note: Archiving profiles for multiple, journal or catch all mailboxes provide an option to synchronize user with a directory service prior to archiving. This option is to be preferred.
Create Backup	Based on the configured schedule a backup is created in the given target directory. Further information are available in Backup and Restore.
Maintain all FDB Files	All Firebird embedded database that are used in standard or advanced archive stores of type Directory (File System) are maintained. Further details can be found in Maintenance and Repair.
Rebuild Broken Search Indexes	Rebuild all search indexes that are currently in the state Needs rebuild. Further details can be found in Maintenance and Repair.
Check Data Integrity	Verification of the data integrity between "Folder Information and Meta Data" as well as "Email Headers and Contents". Optionally search indexes can be include in the verification, yet it increases the time to run the integrity check. Further details can be found in Maintenance and Repair.
Profiles
Archive E-mail	Runs server side archiving profiles based on their configured schedule. Please note that server side archiving profiles are executed automatically and continuously in the background by default. Thus server side archiving profiles can only be executed from a job, if the execution of the profile is set to Manual in the profile management. Hint: We recommend using this execution method only in special scenarios where automatic and continuous archiving is not desired.
Export E-mail	Runs server side export profiles based on their configured schedule. Server side archiving profiles can only be executed from a job, if the execution of the profile is set to Manual in the profile management. 'Hint: If an automatic and continuous execution of an export profile is desired, it is recommended to change the execution of the profile to Automatic in the profile management.