When trying to have the NotesDriverShim register a Lotus Notes user (create a new Notes user) without creating a user ID file we insert a ‘no-id-file=”true”‘ XML attribute into the add element. When the command is submitted to the NotesDriverShim to add the user, the following error occurs: “4299 – Required registration argument not provided”.

What can be done to avoid this error?


Prior to Lotus Notes / Domino 6.5, this error was not a issue. See this cool solution tip for more info:

Domino 6.5 added Certificate Authority features, which caused the registration process to be more ‘refined’. As such, to create a new user without a file, the Notes Driver custom parameters must be set with an intimate understanding of their underlying effects. In other words, you have to spend hours of trial and error with your driver policies, or be an IDM Lotus Notes Driver Wizard to figure this out by simply reading the documentation.

The error mentioned in the question above is caused by the driver policy requesting that Lotus Notes register a new user without creating a new file (no-id-file=”true”). The Notes registration process is intricately intertwined with .id files, and setting everything ‘exactly right’ with respect to the Lotus Notes programming API is neither easy, nor well documented. To cause the error to go away, you will need to create a file for the new user by setting the ‘no-id-file=”false”‘ custom parameter (and then delete the file later…not what you really want to do) or to add a “certifier-name” custom parameter (XML attribute) on the add operation. However, if you choose this latter option, then you will also need to use a ‘use-certificate-authority=”false”‘ parameter if you are not using a certificate authority (CA) to register the new user..
Thus, to work-around the present problem, try applying the following add element attributes via policy:

  1. use-certificate-authority=”false”
  2. certifier-name=”OU=myOrg/O=org”

    where “OU=myOrg/O=org” represents the containment (certificate name) of the certifier ID specified to register the user.

To provide some background to this problem, here are a few references to similar problems mentioned on the public Notes Domino forum:

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this post.

Disclaimer: As with everything else at NetIQ Cool Solutions, this content is definitely not supported by NetIQ, so Customer Support will not be able to help you if it has any adverse effect on your environment.  It just worked for at least one person, and perhaps it will be useful for you too.  Be sure to test in a non-production environment.

Leave a Reply

No Comments
By: pnuffer
Jul 8, 2009
12:11 pm
Active Directory Authentication Automation Cloud Computing Cloud Security Configuration Customizing Data Breach DirXML Drivers End User Management Identity Manager Importing-Exporting / ICE/ LDIF Intelligent Workload Management IT Security Knowledge Depot LDAP Monitoring Open Enterprise Server Passwords Reporting Secure Access Supported Troubleshooting Workflow