New version allows full control over the input fields and order of the data. Additional fields are now available including Fax Number, Title, FID, and Preferred Email ID (the last one is available in GroupWise 7.0.1 only). Also provides the ability for logging and unique identity checking when doing large imports. Even though there are many tools out there to do this now, including Novell's own utility for ConsoleOne, there still seems to be a need for a basic, no frills tool for this function.
GroupWise Import Utility 1.50
Last Update: 1/28/2007
GroupWise Import Utility (GWIU) is a utility that provides for the
automated creation of user accounts in Novell's GroupWise and
(optionally) eDirectory. It reads in a comma-separated variable (CSV)
file and imports the accounts into the system. It can create both the
GroupWise account and regular user account, the GroupWise account and
an external entity object in eDirectory, or just the GroupWise account.
This version is mostly a complete rewrite of the original GWIU released
in 1998. The original was written in Visual Basic 5.0. This version has
been written in Visual Basic .Net. However, the GroupWise administrative
APIs are still COM objects, so the core functionality and how it gets the
job done is pretty much the same. Because of this, GWIU should work with
any GroupWise versions from 5.5 through 7.0.
2. Whats New
The following are new features since version 1.30:
Since this tool is written in Visual Basic .NET, the .Net Framework
version 2.0 is REQUIRED. This can be obtained from Microsoft
(www.microsoft.com). In addition, the following are also required:
GWIU should work with any GroupWise system back to at least version 5.5
EP and just about any eDirectory version back to the original eDirectory 85.
The latest version of GWIU has been primarily tested in a GroupWise 7.0.1
environment with eDirectory 22.214.171.124. Feedback on how it performs with
older versions of GroupWise and eDirectory is welcome (see contact
In addition to the above software requirements, the user running the tool must
have FULL file rights to the domain directory and proper administrative rights
in eDirectory to create accounts.
Simply unzip the archive into a directory. The Interop DLL must be in the same
directory as the executable.
5. Import File
The import file must be in a CSV format and must have the field order on the
FIRST line of the file. Valid fields are:
The fields must be spelled as listed above, however, case does not matter.
They may be listed in any order and must be separated by commas. The fields
with an * next to them are REQUIRED fields (do not include the * in the
Individual fields may be left blank if there is no data for that particular
attribute. Each line must end with a CR/LF.
Visibility must be one of the following: System, Domain, PostOffice, or None.
NetID is the user's distinguished name (DN) in eDirectory (full context,
FID should be used with CAUTION. Typically, the GroupWise system assigns
the File ID (FID). However, there can be disaster recovery scenarios
where importing the FID is useful. Use it with caution. The import will
fail if there is a duplicate FID in the Post Office in which the import
is taking place (FIDs are unique PO-wide, not system-wide).
PrefEmailID allows overriding of the user's system generated Internet Email
Address. This is a new feature in the API and is only available in GroupWise
7.0.1 and later.
The password field is the GroupWise password. GWIU currently does NOT set the
NDS/eDirectory password (see section below on passwords).
An example data file:
6. The User Interface
Most of the interface is self-explanatory, however, a few options are worth
Prior to launching GWIU, the workstation should be logged into eDirectory with
a drive mapped to a GroupWise domain directory. GWIU must have access to
WPDOMAIN.DB in order to function.
Once an import file has been successfully loaded, the "Import" button can be
selected to begin the import. A status dialog will appear showing the current
operation and any errors that have been encountered.
8. A Word About Passwords
For many versions now, GroupWise has had the ability to utilize passwords in
eDirectory for account authentication. This is the preferred configuration, as
the eDirectory password supports many features which the GroupWise native
password does not, such as forced expiration, password history, and complex
password rules. GroupWise post offices accomplish this by communicating with
eDirectory over LDAP.
GWIU will import GroupWise passwords should you choose to continue to use them.
However, it will not set eDirectory passwords. This feature may be added in a
future version of GWIU.
One way to preset passwords for accounts in eDirectory is via LDIF (LDAP Data
Interchange Format). A full discussion of LDIF is beyond the scope of this
document. Novell includes a tool with eDirectory called ICE
(Import/Convert/Export) that can read LDIF files. A sample LDIF entry to set
passwords would look something like this:
The ICE tool would then be used to import the file (ICE can be accessed at the command line or via a GUI through ConsoleOne).