Mail file creation by using the AdminP commands

Specify the Create Mail File in Background attribute on the Notes® account form to create a mail file on the Lotus® Domino® server by using the AdminP commands.

When you do so, the user registration on the Lotus Domino server is faster as compared to normal user registration. The adapter stores all the mail file creation requests in the admin4.nsf file.

You can select one of the listed options to specify the Create Mail File in Background attribute:
Table 1. Create Mail File in Background attribute options
Create Mail File in Background attribute options Description
Not Applicable This option is the default value on the Mail page of the Notes account form. Select this option if you want to create a mail file immediately if you do not apply the Explicit Policy during user registration process. If you apply the Explicit Policy when creating a user, then the adapter creates the mail file immediately or in the background based on the settings mentioned in the policy.
Yes Select this option if you want to create the mail file in the background by using the AdminP process. If you apply the Explicit Policy when creating a user, then the adapter creates the mail file in the background irrespective of the settings mentioned in the policy.
No Select this option if you want to create a mail file immediately. If you apply the Explicit Policy when creating a user, then the adapter creates the mail file immediately irrespective of the settings mentioned in the policy.
Consider the following items to create a mail file by using the AdminP commands on the Lotus Domino server:
  • You can create a mail file by using the AdminP commands. The AdminP process runs on the scheduled time, however if you want to run the AdminP process immediately, run the following command on the Lotus Domino server console: tell adminp process all
  • Specify the value of the Mail Server attribute on the Notes account form in a fully distinguished form when you want to create a mail file by using the AdminP commands. For example, specify the mail server as CN=Hub01/O=IBM®, where CN=mailserver/O=domain.
  • The adapter does not store the value of the Create Mail File in Background attribute in the Person Document on the Lotus Domino server. You can set the value for this attribute only during user registration and cannot modify its value during the User modify operation from IBM Security Identity Manager. Therefore, after the reconciliation operation, its value is always set to Not Applicable.
  • When the Create Mail file in Background attribute is set to Yes, the adapter generates only an AdminP request to create the mail file in background. When this request is successfully submitted to admin4.nsf database, the adapter returns the status to IBM Security Identity Manager as success. If the processing of the request fails, then you must delete the existing user on the Lotus Domino server and again perform the User add operation.
  • When you set the value of the Create Mail File in Background attribute to Yes, the adapter creates an AdminP request in the admin4.nsf on the registration server. If you specify a mail server other than the registration server, then you must replicate the admin4.nsf of the registration server with the admin4.nsf of the mail server. Only after performing this replication, the adapter processes the mail file creation request on the mail server.
  • If the mail system on IBM Security Identity Manager is other than Notes, then the adapter does not create a mail file for users and the adapter ignores the Create Mail File in Background attribute.
  • If the Create Mail file in Background attribute is set for SametimeOnly users, the adapter gives an attribute level failure. Although, the SametimeOnly account does not have a mail file, the adapter creates the SametimeOnly user successfully.
  • If the Create Mail file in Background attribute is set for PersonDocOnly users, the adapter ignores the value of the Create Mail file in Background attribute. Although the PersonDocOnly account does not have a mail file, the adapter creates the PersonDocOnly user successfully.
  • When you submit a request to create a mail file in the background, the user registration process submits the AdminP request to create the mail file instead of creating the mail file on the managed resource. Therefore, there might be a case when a user is registered and deleted immediately and the following possibilities occur depending on registry key values for the adapter:
    • When the Execute AdminP Operation key is set to FALSE, the adapter deletes the user immediately. However, the AdminP request to create a mail file for the user exists. Therefore, a mail file is created for the user although the user does not exist on the managed resource. The Notes administrator must manually delete the orphan mail files.
    • When the Execute AdminP Operation key is set to TRUE, the adapter submits the AdminP request to delete the user. The adapter processes the AdminP request to create the mail file and then processes the AdminP request to delete the user and the users mail file from the managed resource.
Specifying the Mail Quota Size and Mail Quota Warning Threshold attributes
Specify the Mail Quota Size and the Mail Quota Warning Threshold attributes on the Notes account form to set the size of the user's mail file in the background. The adapter sets the values of these attributes in megabytes. For example, if you specify the values of the Mail Quota Size and Mail Quota Threshold Warning attributes as 100 and 80, the adapter uses these values as 100 MB and 80 MB on the Lotus Domino server.
Note:
  • If you want to apply the Explicit Policy during user registration, then submit the Mail Quota Size and the Mail Quota Threshold Warning requests after the success of user registration and mail file creation in background on the Lotus Domino server.
  • The Lotus Domino server version 8.5 and later does not support specifying the Mail Quota Size and the Mail Quota Warning Threshold attributes to set the size of the user's mail file in the background when an Explicit Policy is applied during user registration. When these attributes are set for creating a user's mail file in the background and an Explicit Policy for registration is applied, the values for these attributes are not set on the Mail file. When the Explicit Policy applied for registration has values set for Mail Quota and Mail Quota Threshold Warning attributes, the Mail Quota is set to 0 GB and the Mail Quota Threshold Warning is set to 1024 GB on the user's mail file.
Creation of mail file replica on the Lotus Domino server
The adapter creates a replica for the user's mail file in the background only for Lotus Domino server version 8.5 and above. To create a replica of the user's mail file on the replication server, you must specify the Replication Server attribute on the Mail tab of the Notes account form during user registration. The AdminP request creates the Mail Replica file with the same name as specified for the user's Mail File attribute when the adapter creates the user's mail file in the background. However, if the Replica Mail file name is provided on the Notes account form, the adapter ignores the value for Lotus Domino server version 8.5 and later. For example, if the user’s mail file name is john.nsf, then the replicated mail file name is also john.nsf on the replication server. The adapter ignores the value of the Replication Mail File attribute on the Mail tab of the Notes account form if the Lotus Domino server version is 8.5 and later. The adapter behaves in the following manner, if the Lotus Domino server version is earlier than 8.5:
  • When you specify the Replication Server and Replication Mail File attributes during user registration and the flag is set to create the mail file in background, the adapter registers the user and generates an AdminP request to create the mail file in background. The adapter registers the user and generates the AdminP request to create the mail file in background, however, it gives an attribute level failure for the Replication Server and Replication Mail File attributes. The adapter displays the following message because mail file is not created during registration: Unable to process Administration Request (New Replica --).File does not exist
To create a mail replica, you must submit an AdminP operation NewReplica as a separate Modify request from IBM Security Identity Manager after the mail file is created successfully by the AdminP process.