ClickMail Central Directory | Info | Download | Links | Support | Feedback
Gracion Software Home

Read Me - ClickMail Central directory

ClickMail® Central Directory 1.2 January 5, 2003
©1998–2002 Gracion Software
1257 Tolman Creek Road
Ashland, OR 97520-3652
Tel: +1 (541) 488-3488

1.2: Web Admin compatibility update

Welcome to ClickMail! Until a serial number is entered, this is a 30-day evaluation version. To activate this copy for permanent use, order online or by phone from Gracion Software.

The Administrator Guide is a "must read" before you start to use ClickMail. To use, open the "AdministratorGuide.html" file in your installed ClickMail Folder.

ClickMail Central Directory is your in-house email and contact yellow pages server. It runs standalone or along with AppleShare IP or any mail server. ClickMail provides the missing link: a master directory of your users’ email addresses, accessible in virtually any email client on any platform, PC or Mac--and now in OS X 10.2 ("Jaguar")'s Address Book. Your users (and optionally the public), can look up email or postal addresses, phone and fax numbers, any kind of information you want to keep about people, devices, and services. Thanks to the Internet standard LDAP* protocol, the major email clients on Mac and Windows are already able to access ClickMail’s directory.

Although email clients do not have the ability to upload entries, you can add/edit entries right in ClickMail on the server or via Remote Web Administration. ClickMail runs on Mac OS 8/9, and on OS X as a Classic Application.

*LDAP: Lightweight Directory Access Protocol ( RFC 2251)


Installing ClickMail
Installing Web Admin
Web Admin compatibility update (1.2b2)
Using ClickMail with OS X Mail and Jaguar Address Book
LDIF Import update (1.2a5)
Netscape Communicator features
LDAP Write
System requirements
Release notes

Installing ClickMail

Double-click the downloaded file "ClickMail_1.2.sea". This creates the folder "ClickMail 1.2". Drag this folder to any convenient location on your hard drive. If upgrading, you may delete the old ClickMail application from its folder whenever you are ready. Be sure not to throw out any data files you may have in your old ClickMail folder.

If you downloaded "" instead, it can be unzipped by Stuffit Expander or ZipIt. Unzipping with Stuffit Expander may result in the application appearing as "ClickMail C.D..bin" --if so, double-click this file to obtain the actual application.

Installing Web Admin

On OS 7/8/9: From the installed ClickMail folder, drag the folder "cmweb" to your "Web Folder" or "Web Pages" folder. Put an alias to the ClickMail application in your web folder (anywhere outside the cmweb folder). Name it "clickmail.acgi".

On OS X: From the installed ClickMail folder, drag the folder "cmweb" to /Library/WebServer/Documents/. Put an alias to the ClickMail application in /Library/WebServer/CGI-Executables/. Name it "clickmail.acgi". Install agci dispatcher per its documentation. Launch ClickMail, choose Edit->Preferences, and check "Running under OS X". (This setting only affects web admin.)

Web Admin compatibility update (1.2)

This version's web features are compatible with Internet Explorer 5, Netscape 6, and Mozilla 1.0 (tested primarily in OS X). OmniWeb is not compatible.

Like the previous version, this version is compatible with OS X as a Classic application. What's new is that Web Admin now works under OS X's built-in (Apache) web server. This feature requires "acgi dispatcher," a shareware program. To use Web Admin this way, check "Running under OS X" in ClickMail Preferences.

Note: On our system, acgi dispatcher 1.1 gets an error when Netscape or Mozilla is used. If hosting ClickMail on OS X, please use Internet Explorer for web administration.

acgi dispatcher:

Bug fixes to 1.2b2 are listed in the release notes below.

Using ClickMail with OS X Mail and Jaguar Address Book

OS X’s Mail and Jaguar’s Address Book can search ClickMail. In Mail, type part of a first name, last name, or email address. Mail automatically completes the name and may show a list of matches to choose from.

While Mail uses only the name and email address from ClickMail entries, Jaguar’s Address Book uses much more: In Address Book (10.2 or later), click “Directories” and type part of a name in the Search field. Click the “Email” column header to switch to viewing phone numbers.

Drag a returned entry to the Group column to store it in your Address Book. Once there, more information is revealed: Title, organization name (o), work phone, fax, and four address fields (street, city/location (o), state (st), and zip/postal code).

To setup Mail to search your ClickMail, see Mail Preferences->Composing and click "Edit Server List" (now called "Configure LDAP" in Jaguar). Check the box on the same line as the button to enable Mail's search. Jaguar's Address Book also has a preference for adding LDAP servers, but it's aware of the one you entered in Mail Preferences.

LDIF Import update

If you are importing an LDIF file from a client address book (such as Netscape or QuickMail Pro client), ClickMail now accepts the incomplete distinguished names (DNs) these clients generate. By default, ClickMail takes the client's incomplete DN and adds your Naming Context (such as "c=US"). In some cases, such as importing from multiple clients where there is duplication, you may wish to ignore the partial DNs. To do that, check the preference "LDIF Import: Ignore partial dn?". This makes ClickMail create new DNs based on the person's name.

Note: DNs are used to identify duplicate records. If you import an LDIF file containing duplicates, and you have changed the "Ignore partial dn" preference since the last import, duplicate entries will be added instead of updating the existing entries. So, don't change the preference mid-stream. Decide whether you want client-DN-based or common name-based DNs in ClickMail and set the preference before the first time you import into your new database.

LDIF import also accepts DOS-format text files (CRLF).

Netscape Communicator features

Netscape Communicator 4.5 and higher have LDAP-related features called "Select this directory for download" and "Roaming Access." These are not supported by ClickMail.

LDAP Write

LDAP write lets LDAP clients make changes to the contents of your directory. Of course, you need to find a client that knows how to do this! One publicly available Mac LDAP read/write client, MaX.500 from U. Michigan, now works with the 1.1 version. It can browse and edit existing entries, but not add new ones. Use the "non-UMich" install option, and set your directory and Searchbase options before searching. < >

LDAP write is disabled by default. To Enable LDAP write operations, from the Database menu choose Permissions. Under Write, check "Logged in Users". We recommend that you also define a permitted IP range for a little more security. Next, add a password to the entry(ies) of the person(s) who should be permitted write access. For write access the client must log in with this person's Distinguished Name and password.

Warning: There is no encryption or security protocol used with ClickMail's password login or write operations. Passwords can be easily revealed as they travel "in the clear" between client and server. If this server is used over the Internet, be aware that passwords, and therefore your LDAP data, are subject to interception and modification by outsiders. Do not use the same passwords used for other services such as email or FTP (although FTP passwords aren't secure either).

New LDAP operations supported: Add, Delete, Modify, ModifyDN, Abandon, Compare.

Trivia about modifiersName: The modifiersName attribute contains the DN of the user who changed an entry with Modify or ModifyDN. ModifyDN can move an entry to a different location in the tree, by giving it a new parent. This changes internal references in the parent entries and the DNs of any children of the moved entry. The modifiersName/modifyTimestamp of the parent are not touched, but those in all children are updated with the DN of the logged in user.

For a description of all LDAP operations, see RFC 2251:

System requirements

Power Macintosh (including iMac, G3, G4) with System 7.5.3 through 9.2.2, or OS X in Classic compatibility layer, Open Transport 1.1.2 or later (Mac OS X Classic only). Free RAM needed: Virtual Memory on: 3.5–5MB; VM off: 6–7.5MB. Disk space: 3MB + 4K per entry.

If integrating with AppleShare: AppleShare 5.0 or later and the AppleShare IP Registry API extension (a shared library found on your AppleShare IP install CD).

The extension “OpenTptInternetLib” must be present in the Extensions folder. For Systems 7.5–7.6.1, AppleScriptLib, InterfaceLib, MathLib, and ObjectSupportLib must also be present. These are all part of your normal Mac OS. If one is missing, an alert is displayed when ClickMail is opened.

ClickMail is designed to be accessed by LDAP-aware clients such as OS X Mail, Jaguar Address Book, Netscape Communicator, QuickMail Pro, Outlook Express, Mulberry, and Eudora Pro 4.x* --For proper operation, use Eudora Pro 4.01 or later (

Release notes

1.2b2 - 12/5/02
• Button graphics and all web admin now working in Internet Explorer, Netscape.
• Tab import now strips quoted fields (Excel tends to add quotes around some field values)
• Re-importing parent entries no longer unlinks them from children
• Field names corrected in standard field list: department/unit (ou), url (lower case), po box
• LDIF export fixed: one entry was not exported; DSE was exported instead

1.2b1 - 7/26/02
• OS X compatibility preference added. When checked, drops CGI header for compatibility with acgi dispatcher. No effect on anything except web admin CGI interface.
• Web Admin: Button graphics fixed for Internet Explorer.

1.2a5 - 11/29/01
• LDIF import - Can import from Dos-format files (CRLF). Accepts partial (one level, no commas) DN's, unless preference to Ignore partial DNs is checked. If checked, would create DN from name.

1.2a3 - 6/12/00
• AppleShare mirror-mode support for muitiple email domains. Where individual email addresses of AppleShare users have a domain name different from the main domain shown in ClickMail's Configure window, resyncing with AppleShare no longer reverts these to the main domain name. So, you can set any domain you want in the email address of an AppleShare user's entry in ClickMail. If the name/Alias for a user is changed in AppleShare Users & Groups, the email address is updated but the domain name previously in use for that user is be retained. (Only the first email address in an entry is mirrored).

1.2a1 - 7/7/99
• New in web admin: Paged browse mode. Set max number of entries per page at login, then it automatically pages the results as needed. Entries are sorted by DN.
• New in web admin: Starts-with, ends-with searches. See info page in your cmweb folder (start at cmweb/index.html).
• New in web admin: LDAP write permissions settings.
• New AppleScript functions: Get/set all preferences, import, export, backup, resync under AppleScript control. See our AppleScript dictionary and <>.
• Added: LDAP Types Only queries (which return attribute names but no values in LDAP search).
• Fixed for AppleShare mirror: saving an entry with a duplicate DN failed invisibly. Now you are told what's wrong. Another possible error is trying to save an entry with an existing email address. AppleShare doesn't permit this.
• Fixed: Entry ID numbers (field name "EID") can now be imported from tab-delimited files. This allows moving entries by changing their DNs. This is useful for converting a flat directory structure into a tree-structure. See <>.
• Fixed in local interface: Crash if attribute double-clicked in Find mode.

1.1.1 - 6/14/99
• Fixed: Some versions of AppleShare IP returned a parameter error (our code 744) when syncing in AppleShare mirror mode.

1.1 - 6/3/99

• Fixed data sending routine that might crash in certain circumstances, such as when an empty list of attributes is returned. This is pretty hard to do, but might happen in response to the "select this directory for download" setting in Netscape (see above).

1.1b5 - 5/28/99

• New: AppleShare IP groups are now visible in the LDAP directory. This allows listing group email addresses. Group membership must be assigned in the AppleShare IP Web & File Admin program. A special LDAP object class, "asipgroup" is assigned to these groups. These are not regular LDAP "groupofpersons" groups.

• New: AppleShare mirror mode supports surname-before-givenname naming (such as Asian, Polish, etc.) This option is available in the Configure window. The option controls how "first name" and "last name" are set in LDAP when syncing from the full user name in AppleShare.

• New: Entries window warns you if you enter a duplicate email address.

• New: Datafile compacting may be scheduled on a daily basis. (Compacting is also automatic when a certain threshold of extra space is crossed.) Setting in Preferences.

• New: AppleShare mirror mode--Preference to copy all passwords from AppleShare to LDAP directory. To enable this for an existing directory, turn on in Preferences, then Resync from AppleShare (File menu).

• Now works (somewhat) with maX.500, the free LDAP client from the University of Michigan

• Fixed: Searches were very slow on some servers. Searches that took 5-15 seconds on these servers now take 1 or 2! Also, algorithm for certain common searches was accelerated.
• Fixed: Reindexing the datafile reset all attribute preferences to factory defaults.
• Fixed: Web admin CGI requests all timed out in earlier 1.1 versions.
• Fixed: AppleShare mirror mode--Adding password attribute to a non-owner Administrator turned off Administrator access for that user. User access flags are now retained in the directory, so that changing an entry does not change the flags. The flags are currently displayed in hex (preceeded by "16#"), and may be edited if you know what they mean.
• Fixed: AppleShare mirror mode--Extraneous characters after 8-character passwords are now deleted.

1.1b2 - 3/12/99
• New! Scheduled daily backup and resync with AppleShare users. See Edit menu -> Preferences.
• Fixed: Some attribute values in newly created attributes were not indexed, so searches for these values failed. After upgrading, please reindex any datafiles created in older versions.
• Fixed: Tabbing through entry attribute list did not always update display properly.
• Improved: Syncing with AppleShare is now cached for much greater speed. Status window added so you know what's going on, too.

1.1b1 - 2/10/99
• LDAP Write operations added (see LDAP Write, above).
• LDAP Compare operation added (allows use as a password database for other servers)
• Alias entries implemented. See the effect of aliases on searching in RFC 2251.
Alias entries: objectClass: "alias". required attribute: aliasedEntryName (DN of entry it points to).
To find all aliases to an entry, search for that entry's DN in the aliasedEntryName attribute.

1.0.2 - 12/18/98
• Some preference settings couldn't be changed: Default Character set, Web Session timeout.
• Default character set was being used in all return data, instead of detected character set.

1.0.1 - 12/13/98
• Web administration: unable to log in under AppleShare 6.0 or 6.1. Fixed.
• Can't open Attributes Reference while Tab-Delimited import/export window is open. Fixed.
• Rechoosing Find mode while already in Find mode could crash. Fixed.
• If user logs in with misformatted distinguished name, ClickMail log now explains this.

1.0 - 7/13/98
• First commercial release

ClickMail Central Directory | Info | Download | Links | Support | Feedback
Gracion Software Home