[an error occurred while processing this directive]

NetMail Frequently Asked Questions
NetMail Cool Solutions Article
Reader Rating    from ratings rate this article
View a Printer Friendly Version of this Page Send this page to a friend

Updated: 4 Jun 2003

The information is taken from the NetMail FAQ, Revision 2.0 and is current as of March 2003.

Use your browser's search functionality to search this page only. Type Ctrl+F on your keyboard.

categories
General
  1. What information should I provide when posting about a problem to NIMSTALK?
  2. How do I buy NetMail if I do not have an agreement with Novell?
  3. Where/how should I report a translation error in the templates?
  4. How do I tell if I am running a valid license?
  5. How do I know what version of NetMail I am running?
  6. Are there performance numbers for NetMail that have been published?
  7. How do I search the archives of the NIMSTALK or any list archive?
  8. Where can I get development support for writing to NetMail APIs?
  9. Where can I get the Signup Agent?
  10. What should I do if my server ABENDS?
  11. Where can I get the current revision of the manual or README for NetMail?
Troubleshooting
  1. I get the error, “Could not load public key,” when starting the Modular Web Agent. Is there a problem?
  2. Is it possible to temporarily disable the receiver in SMTP?
  3. I have a user who is unable to login. What is the problem?
  4. What ports does NetMail use?
  5. What ports do I need to open on my firewall for NetMail to work?
  6. Aliases work inside the NetMail system, but messages sent outside the system are rejected.
  7. The Messaging Server server object is marked with a yellow “?” in NDS. What is wrong?
  8. I’m seeing Btrieve/Pervasive Errors in the log file, what’s wrong?
  9. My aliases are not working, what’s wrong?
  10. What to do about “Couldn’t create queue.btr (Btrieve err:94)”?
  11. MailCon reports 4,294,967,295 server connections, what happened?
  12. Users are receiving duplicate messages when the sender uses the Modular Web Agent.
  13. WebMail is not running after upgrading to NIMS 3.0.
  14. I am having problems loading images of NIMS 3.0 through our BorderManager 3.5 server.
  15. How can a hosted user use Netscape to get mail? Netscape ignores everything after the @?
  16. The Proxy Agent is not picking up mail.
  17. My NetMail system cannot send to a particular site.
  18. When using IE on a Macintosh, I only get asked once for a username and password.
  19. I just got a trailing redzone error on the console. What does it mean?
  20. I sometimes see the entire or partial message header in the body of an e-mail message. Why?
  21. I have messages to an existing user bouncing with the error message “user unknown.” Why does this happen?
  22. The finger module does not load on my Linux/Solaris system?
  23. How can I stop a looping message?
  24. Does NetMail detect mail loops?
  25. I disabled a NetMail agent and now mail is getting stuck in a queue. How can I fix this?
  26. When is it safe to delete the qclients file?
  27. I changed my server’s IP address and now mail is getting stuck in the queue.
  28. What do I do if mail is not leaving the system but is stuck in one queue?
  29. Mail does not deliver; it just sits in the queue?
  30. The List Agent on NetWare 4.11 does not correctly process subscription e-mails.
  31. What happens if there are duplicate aliases created for two users?
  32. I cannot get the Modular Web Agent address book lookup to work on Solaris or Linux.
  33. The Address Book Agent is not loading, it seems another LDAP Agent is still running.
  34. Why does it seem like NetMail is not using a secondary DNS server?
  35. A user’s language setting defaults to French Canadian and the setting cannot be changed.
  36. Every time NetMail is restarted, “novonyx/mail” is added to the NetMail objects’ path, eventually causing NetMail to ABEND.
  37. What does “server encountered a processing error” really mean?
  38. Users do not receive bounces for messages sent to a list, could this be changed?
  39. What should I do if my server is experiencing high utilization?
  40. My LDAP server will not return any requests.
  41. Why does the status of a message not change after I read it in the Web Interface?
  42. What are the *.008 files in the spool directory?
  43. I added users to a new OU and now they cannot log into NIMS.
  44. Where are the NetMail log files stored?
  45. Some aliases are not being created correctly by the Alias Agent; the alias names are being chopped off at eight characters.
  46. I cannot add a moderator to my list; the user that I want does not show up.
  47. What user IDs are valid?
  48. The Modular Web Agent will not load on port 80.
  49. How can I know if NetMail is answering on a certain port (IMAP, POP, SMTP)?
  50. Where can I find an explanation of SMTP errors?
  51. I cannot get SSL to work.
  52. Why can’t I use “Verify recipients Addresses when accepting messages”?
  53. I receive the error “Message is no longer available on the server” in Outlook Express when trying to read some messages?
System Setup
  1. During the NetMail installation, NIMSEXT does not accept my login credentials; I get “Login Failed.” What is wrong?
  2. How is NetMail licensed on NetWare 6? Do I have to purchase Netware 6 licenses for all of my NetMail users?
  3. How do I set up SMTP-after-POP?
  4. How do I prevent my system from being an open relay?
  5. When do I use Hosted domains and Global domains?
  6. The Postmaster address included in bounced messages sent from my NetMail server has two domains appended.
  7. NSS vs. Traditional file system, what is better?
  8. Where is the personal address book info stored?
  9. Can I change the Listserv commands or messages?
  10. Do NetMail messaging servers require an NDS replica?
  11. Are there going to be ConsoleOne SnapIns for NetMail?
  12. How do I get quotas to work on NSS?
  13. How do two NetMail servers in the same tree talk to each other? NMAP to NMAP, or SMTP to SMTP?
  14. How can I get the best performance out of my Solaris server?
  15. How should I set up NetMail if I have X servers and Y users?
  16. Can NMAP just service an object’s NDS alias, but not the User object itself?
  17. Can a traditional file system be used in cluster services?
  18. What versions of NDS does NetMail run on? What operating systems does NetMail support?
  19. What performance optimization can or should be done for NetMail?
  20. How do I bind NetMail to a specific IP address?
  21. What is the best block size on a volume with sub allocation?
  22. Does NetMail require a web server to run the web interface?
  23. How can I convert my existing e-mail over to NIMS?
  24. Can NetMail be used if I have another e-mail system that is tied to the same domain name?
  25. Do I need to purchase eDirectory user licenses as well as NetMail user licenses?
  26. Can NetMail be run on the same server as another e-mail system?
  27. How should I organize my tree? Distributed or non-distributed?
  28. How is SSL enabled in NetMail?
  29. We are planning on creating a filtered NDS replica for NetMail authentication and we need a list of the objects and attributes that we need to replicate.
  30. Where does the e-mail address field for the address book come from?
  31. What does the Organization field in the NetMail address book map to?
  32. My NetMail server used to be lightning fast, but has suddenly become really slow. What happened?
  33. Why is NetMail creating so many temporary files?
  34. How can I set up a signup solution with NetMail?
  35. I’m getting an ABEND when loading the AntiVirus Agent or the AntiVirus Agent does not seem to scan anything.
System Administration
  1. How do I create a hosted user in NWAdmin or WebAdmin?
  2. How can I see and set information that is stored in NDS?
  3. What is the “Forward Local Undeliverable” feature used for?
  4. Do I need to upgrade all my messaging servers to NIMS 3.0 at the same time?
  5. How can I set a default template for my users?
  6. How do I control what templates are available to my users?
  7. How can I have the same user ID for multiple domains that I might be hosting?
  8. How can I send a bulk mailing to all my NetMail users?
  9. When should I use the Bounced Message Control feature and what does it do?
  10. How can I import data such as users, user’s attributes, and NetMail attributes into DS?
  11. Can I run NLDAP and the NetMail LDAP server on the same server?
  12. How can I create a hosted mailing list using hosted domains?
  13. Can the Internet Services Container be moved?
  14. How are SCMS messages stored?
  15. How do I move a user’s mailbox to another volume/system if the user has SCMS messages?
  16. If I run more than one NMAP against the message store, will it improve performance?
  17. Should NetMail messaging servers hold a partition of Root, or just some OU’s?
  18. Can I use another LDAP server besides NIMS’ Address Book Agent (MSGLDAP) to fulfill LDAP requests?
  19. How can deleted messages be restored from a backup?
  20. Can an e-mail disclaimer be added to all outgoing e-mail?
  21. Will NMAP service sub-containers or does every container need to be defined in NMAP?
  22. What happens to mail destined for an account that has been disabled?
  23. What is the difference between disabling the NDS account and disabling the NetMail account?
  24. Is there a utility that will monitor our NetMail system and send a notice if there is a problem?
  25. How can I get activity numbers on our user accounts?
  26. Is there an option for “authentication required” for the LDAP server queries?
  27. How can the mailing list, template, or parent objects be recreated under Internet Services?
  28. Is there any way to clean up the SCMS directory after a user has been deleted?
  29. Is it possible to lock down features on a per user/group basis?
  30. What utilities are available to create/modify user accounts in NDS?
  31. There are a number of Novell and third party utilities like Bulkloader, ICE, DSSNOOP, ConsoleOne, and JRB Utilities. You can search NIMSTALK for other utilities as well.
  32. What is the attribute that needs to be modified to disable a users account and what does the attribute need to be set to?
  33. As admin can I log into someone’s mailbox without the user knowing?
  34. How can I find which users have subscribed to an NDS or regular list?
  35. Is it possible to run an English and Spanish ModWeb on the same server?
  36. How can I have one certificate for multiple variations of my domain name (for example, mail.mydomain.com, smtp.mydomain.com)?
  37. How can I disable a user’s rules?
  38. Can I change how often the Proxy Agent runs to collect mail?
  39. Can I force the Proxy Agent to proxy mail for a particular account instantaneously?
  40. How can the schema be re-extended?
  41. How do I get a log of incoming and outgoing SMTP mail, as well as NMAP deliveries?
  42. What changes to NetMail do not require a restart of the system?
  43. What facilities does NetMail have to prevent looping?
  44. What is the best way to back up NetMail?
  45. Can NetMail limit the amount of data that is bounced back to the sender if the recipient is undeliverable?
  46. How are messages stored in the user’s mailbox? What is the NetMail mailbox format?
  47. How can I tell what messages are waiting in the mail queue?
  48. How can I get every piece of mail that was sent to my NetMail system, even if the user does not exist?
  49. What is the difference between NDS aliases and NetMail aliases?
  50. Using NMAP commands, how can I create a folder with spaces in the name?
  51. How can I get the sub domains to match the user when sending e-mail?
  52. How does NetMail handle duplicate user IDs?
  53. Is there a limit to the number of aliases entered in the Alias Agent?
  54. Is it possible to auto-create a welcome e-mail for any new NetMail account?
  55. NetWare Only: Can I set SYSLOG to roll to a new file after x bytes, or x days?
  56. NetWare Only: Can I change the size of my syslog logfiles?
  57. NetWare Only: When copying my logfile, there’s always some data missing.
  58. NetWare Only: Syslog does not seem to be logging. What’s wrong?
Clustering
  1. How do I use NetMail with cluster services?
  2. How do I split up the NetMail agents across multiple servers?
Templates
  1. How can I modify templates?
  2. How can I add a logo to the templates?
  3. How can I remove feature configuration from the templates but still have the features active?
  4. Is there any way to do a form-based login for NIMS?
  5. How can I replace images in the web interface?
Character Sets
  1. What character set does NetMail send in?
  2. Can a rule be created that contains extended/double byte characters?
Tools and Add-ons
  1. What is the PlusPack?
  2. How do I get the PlusPack?
  3. Is there a virus scanning solution for NIMS?
  4. How can I customize the “welcome” message for a list?
  5. Can I restrict who can send e-mail outside the NetMail system?
  6. What utilities are available for NIMS?
  7. How can I integrate the NetMail address book with another e-mail system’s address book like GroupWise?
  8. Is there any content filtering solution for NIMS?
User Configuration
  1. I don’t want my user to have to set their time-zone on first use of the Modular Web Agent.
  2. Can NetMail users forward messages to a cell phone/handy or pager?
  3. Why do I get read only access to my mailbox (SID files)?
  4. How do I create a sent items folder?
  5. Can personal groups be created in the web interface?
  6. Is there anyway to synchronize the NetMail Calendar and Address book with my Palm?
  7. How can I set a default language for the web interface?
  8. Does NetMail support multiple calendars per user?
  9. Is there any way to modify a calendar event?
  10. Is there a way to redirect the user to a different logout screen?
  11. What ICal clients are available?
  12. Are user IDs case sensitive?
  13. Does the change password option in Eudora sync with NIMS?
  14. Is it possible to import address books from a file to a user?
  15. Is there any way I can override the NDS Object name as the FROM Address in NIMS 3.0 for the Modular Web Agent?
  16. How can I limit the NetMail address book to only search a user’s domain and not any other domain running on the system?
Features
  1. Does NetMail have a busy search feature for the calendar?
  2. What is the syntax for passing the user ID and password to NetMail in the URL to bypass the popup login box?
  3. How can I get Groups and mailing lists to show in the address book?
  4. Is there a spell checker for NetMail?
  5. Is there the Save Drafts ability in the Modular Web Agent?
  6. Can NetMail use NDS Group objects as mailing lists?
  7. Can multiple NDS user objects be granted access to a common mailbox?
  8. Does NetMail support “Shared folders”?
  9. What calendaring standard is being used for NetMail 3.x?
  10. Is there a “notification of new mail” product?
  11. Is there any way to block types of attachments?
  12. How does NetMail use the AntiSpam agent to block e-mails?
  13. Does NetMail support SSL for the address book?
  14. Messages moved between IMAP folders don’t seem to keep their status flags.
  15. Is WAP available for NetMail?
  16. Can messages be addressed to an OU?
  17. What files does the “mail queue” command check?
  18. In what order are the UBE (Unsolicited Bulk E-mail, SPAM) settings checked?
  19. Does or can NetMail use the /etc/hosts or the /etc/resolv.cfg (/etc/ resolve.conf) file?
List Agent
  1. How can the archives of a mailing list be accessed?
  2. How does a moderator subscribe multiple users to a mailing list?
  3. Can List Agent commands be localized?
  4. Can the reply to for a list be set to the list rather than the sender?
  5. Is it possible to create an “announcement-only” list?
Upgrading
  1. How do I upgrade from NIMS 2.6 to NIMS 3.0?
  2. Can I upgrade NIMS 2.1 to NIMS 3.0?
  3. What is the supported upgrade path to NIMS 3.0?
  4. How can I upgrade from an evaluation copy of NIMS 3.0 to a licensed version?
  5. How can I move NetMail to another server?
  6. How can I move user data from Solaris to Netware or Linux or the other way?
Tools and where to get them
  1. NDS Tools to set or get attributes
  2. How to find out whether your SMTP server can exchange mail with another SMTP server
Secrets and not-so Secrets
  1. Are there any configuration items you guys aren’t telling us?
  2. How does inheritance work on parent objects?
  3. How are the inheritance configuration and feature sets stored in NDS?
  4. What command-line switches exist for the various components of NetMail?


General

Q1:

What information should I provide when posting about a problem to NIMSTALK?

A1:

You should provide the following:
  • What version of NetMail you are running.
  • What platform you are running on.
  • How your system is set up. For example, are you running a single server, multiple servers; what agents are running and where; and so on.
  • If there is an error message, give the full context and when the error occurs.
  • Indicate if the problem be reproduced.
  • If you have a setup or configuration question, explain what you are trying to do.

Q2:

How do I buy NetMail if I do not have an agreement with Novell?

A2:

NetMail 3.1 may currently be purchased retail. See http:// www.shop.novell.com.

Q3:

Where/how should I report a translation error in the templates?

A3:

Send any translation errors and corrections to dlatimer@myrealbox.com

Q4:

How do I tell if I am running a valid license?

A4:

If you don’t have a footer added to every message going through the system, you are licensed. Your license information also displays when msgsrv is loaded.

Q5:

How do I know what version of NetMail I am running?

A5:

On NetWare, you can enter the mail version command at the console prompt to see each agent’s version. For Linux and Solaris, check the /usr/nims/dbf/versions file.

Q6:

Are there performance numbers for NetMail that have been published?

A6:

We are currently using Specmail (http://www.spec.org) to test with NetMail. In March 2002, NetMail passed a 210,000 user test on a single server.
See http://www.spec.org/mail2001/results/res2002q1/mail2001-20020312-00014.d.html for the detailed report.

Q7:

How do I search the archives of the NIMSTALK or any list archive?

A7:

Send a message to listserv@nimsinfo.com using the Search command described below or just send a message with “info” in the body of the message and all commands will be sent back to you.

Command Description
SEArch <list_name> The SEArch command enables users to search archived messages by date, subject line, or message body.

The following parameters can be combined using AND/OR statements. For example, to search for a message sent between January 1, 2001 and January 31, 2001 and containing “Performance Review” in the subject line, the user would submit the following command:
SEArch list_name FROM 01/01/2001 TO 31/01/2001 AND SUBJECT “Performance Review”
FROM <dd/mm/yyyy> TO <dd/mm/yyyy> Receive a listing of all archived messages posted to the mailing list between the specified dates.

FROM <dd/mm/yyyy> TO today Receive a listing of all archived messages posted to the mailing list from the date indicated to today.

SUBJECT “<subject>” Receive a listing of all archived messages that include the indicated text string in the subject line.

The quotes are required to demarcate the text string. Quotes cannot be searched or escaped.
SENDER “<sender>” Receive a listing of all archived messages posted to the mailing list by the designated sender.

The quotes are required to demarcate the sender. Quotes cannot be searched or escaped.
BODY “<body_text>” Receive a listing of all archived messages that include the indicated text string in the message body.

The quotes are required to demarcate the text string. Quotes cannot be searched or escaped.


Q8:

Where can I get development support for writing to NetMail APIs?

A8:

The development list, DEVTALK@nimsinfo.com, is managed by the NetMail team. To join DEVTALK, send an e-mail message to listserv@nimsinfo.com. Include the command, SUBSCRIBE listname [Full Name] , in the message body Example: SUBSCRIBE DEVTALK John Doe Additionally, the NetMail SDK is available on developer support at http://developer.novell.com/ndk/leadedge.htm#le162 under the "Leading Edge 162 (NetMail)" link.

Q9:

Where can I get the Signup Agent?

A9:

The Signup Agent that is used on MyRealBox.com is included with NetMail 3.0.2 and above. It includes sample template sources that show how to use the agent. Please note that this agent is provided as a courtesy and is not supported by Novell.

Q10:

What should I do if my server ABENDS?

A10:

Make sure that you are running the latest support packs. Verify what is causing the ABENDs by looking at log files. If you determine that NetMail is causing the ABEND, or if you cannot determine the cause, send your ABEND log and a description of your system setup to NIMSTALK@nimsinfo.com. We will look at the log and determine a course of action.

Q11:

Where can I get the current revision of the manual or README for NetMail?

A11:

The manual is available at http://www.novell.com/documentation. The README files are available with the product patches.



Troubleshooting

Q12:

I get the error, “Could not load public key,” when starting the Modular Web Agent. Is there a problem?

A12:

The message, "Could not load public key," indicates there is no certificate installed for SSL. This is not an error message; it is an informative message. To read about installing a certificate, see “Setting Up TLS and SSL” on page 184 in the NetMail Administration Guide.

Q13:

Is it possible to temporarily disable the receiver in SMTP?

A13:

At the console, enter MAIL SMTP NOACCEPT to turn off the receiver. Enter MAIL SMTP ACCEPT to turn it back on.

Q14:

I have a user who is unable to login. What is the problem?

A14:

It is possible that the user’s NDS container has not been added as an NMAP Agent context. In this case, add the user’s context to the NMAP Agent’s context list and restart the messaging server.

Note: See “Context” in the NetMail Administrator's Guide on page 100 for more information.

If the users’ contexts are assigned to an NMAP Agent running on a standalone server, a Modular Web Agent must be running locally on the standalone server.

If the user is associated with a Parent object, the Modular Web Agent may be disabled in the Parent object.

Q15:

What ports does NetMail use?

A15:

Port Protocol Agent Configurable Port
25 SMTP SMTP Agent no
80 HTTP Modular Web Agent yes
81 HTTP WebAdmin uses port 81 for HTTP-based administration. yes
110 POP POP Agent no
143 IMAP IMAP Agent no
389 LDAP Address Book Agent yes
689 UDP   Connection Manager uses UDP port 689 to receive client IP addresses from the POP and IMAP Agents no
689 TCP NMAP NMAP Agent no
443 HTTPS Modular Web Agent yes
444 HTTPS WebAdmin yes
995 SSL over POP POP no
993 SSL over IMAP IMAP no
  TLS NetMail supports TLS on every protocol’s native port.  
The listed ports are defaults; most ports can be changed through the administration tools.

Q16:

What ports do I need to open on my firewall for NetMail to work?

A16:

Refer to the ports listed above. The NMAP port usually should not be opened.

Q17:

Aliases work inside the NetMail system, but messages sent outside the system are rejected.

A17:

If the “Verify recipient addresses when accepting messages” option is enabled on the SMTP Agent object, the SMTP Agent will not accept mail addressed to an alias. For further information, see page 127 in the NetMail Administration Guide.

Q18:

The Messaging Server server object is marked with a yellow “?” in NDS. What is wrong?

A18:

Your Postmaster user has been deleted. Deleting the User object designated as the NetMail Postmaster changes Messaging Server objects to type “Unknown.” To reset Messaging Server object type, you must run the IMSPMFIX utility. You may download this utility at http://www.novell.com/coolsolutions/netmail/downloadables.html.

Q19:

I’m seeing Btrieve/Pervasive Errors in the log file, what’s wrong?

A19:

Error Description Number Action
Permission error: 94 On Linux/Solaris: Make sure that the psql group has rwx rights to /usr/nims/dbf
Record manager inactive: 20 On Linux/Solaris: Make sure that mkded is running (start via psql init script)
I/O error: 2  
Duplicate key value: 5  
Filename bad: 11  
File not found: 12  
Disk full: 18  
Unrecoverable error: 19  
Create I/O error: 25  
Invalid owner: 51  
File already exists: 59  
Programming error: 79  
File table full: 86  
No handles available: 87  
Access to file denied: 46 Check rights to the .btr file
Maximum open files: 47  

Note: We’ve only seen 94 & 20 before.

Q20:

My aliases are not working, what’s wrong?

A20:

Make sure that Btrieve is working properly. Check the log files for any Btrieve errors and then consult the answer to FAQ Item “I’m seeing Btrieve/Pervasive Errors in the log file, what’s wrong?”

Q21:

What to do about “Couldn’t create queue.btr (Btrieve err:94)”?

A21:

You get this error if permissions on Linux & Solaris are not configured properly. In order for Btrieve to be able to write NetMail’s various databases (alias, address book and delayed queue), the psql group needs rights to write to the NetMail DBF directory (usually /usr/nims/dbf). Set the rights for these directories accordingly.

Q22:

MailCon reports 4,294,967,295 server connections, what happened?

A22:

This is purely a cosmetic error. It occurs when the NetMail connection count becomes negative. We have not yet found what causes the connection count to become negative.

Q23:

Users are receiving duplicate messages when the sender uses the Modular Web Agent.

A23:

We’ve found that is usually caused by the sender clicking the browser’s “Refresh” button right after the send. The browser’s Refresh button repeats the last action. So, if a user sends a message and then clicks the browser’s “Refresh” button, the message will be sent a second time. This is the behavior of the browser; NetMail does not have any control over it. Users should use the update link on the web page instead of the browser’s Refresh button to refresh the page.

Q24:

WebMail is not running after upgrading to NIMS 3.0.

A24:

NIMS 3.0 ships with a new web-based e-mail interface called the "Modular Web Agent," or ModWeb. This agent replaces the WebMail Agent that was used in NIMS 2.x. The WebMail Agent is no longer supported in NIMS 3.0. For more information see the NIMS 3.0 README or manual.

Q25:

I am having problems loading images of NIMS 3.0 through our BorderManager 3.5 server.

A25:

This is a problem with BorderManager and can be fixed with the BM35 SP3 patch available at http://support.novell.com

Q26:

How can a hosted user use Netscape to get mail? Netscape ignores everything after the @?

A26:

In POP mode, Netscape* Messenger 4.x strips @ symbols and trailing characters from usernames. Users in Hosting Domains can use Netscape Messenger 4.x in IMAP mode or the POP client can be manually configured to accept usernames with the @ symbol.

To enable the Netscape Messenger* 4.x POP client to accept usernames with the @ symbol, edit the PREFS.JS file in the C:\PROGRAM FILES\NETSCAPE\USERS\USERNAME directory. Add the following line above the other mail lines:

user_pref("mail.allow_at_sign_in_user_name", true)

You can then restart the Netscape Messenger 4.x POP client. It is possible to make this change before distributing the Netscape client to all the users.

Q27:

The Proxy Agent is not picking up mail.

A27:

The best place to start looking is the log files to see what proxy is doing. If a user has three proxy accounts set up and the first account is invalid, NetMail will skip the other two accounts for that user. So, make sure the proxy information is entered correctly.

Q28:

My NetMail system cannot send to a particular site.

A28:

The MXTrace utility simulates sending a message to any site and will return any errors received. Use this utility to test your system and determine why you are being blocked. The reasons could be that the other system is blocking your e-mail server, your DNS server is not returning correct information, or the remote site is down.

MXTrace is available at http://www.novell.com/coolsolutions/netmail/ downloadables.html.

Q29:

When using IE on a Macintosh, I only get asked once for a username and password.

A29:

This is an IE issue that NetMail has no control over. Even if all caching is turned off in IE and though the realm for the login is different for every login, IE will still cache the username and password. The user name and password are only removed from cache when IE is closed. Users of IE on the Mac need to be educated that IE will cache user name and password until the browser is closed.

Q30:

I just got a trailing redzone error on the console. What does it mean?

A30:

POP but have not created a Connection Manager.

Versions 3.0.1 and higher handle this configuration error and do not cause the redzone error. However, you must still create a Connection Manager to enable SMTP-after-POP.

For more information, see “Connection Manager” on page 206 in the NetMail Administration Guide.

Q31:

I sometimes see the entire or partial message header in the body of an e-mail message. Why?

A31:

That happens when the message does not have proper headers; usually because the software the sender used to create the message (often homemade scripts) violates the RFC specification and sends only line feeds instead of CR/ LF as line separation characters. We've seen it happen mostly on SPAM messages.

Q32:

I have messages to an existing user bouncing with the error message “user unknown.” Why does this happen?

A32:

This occurs when running DS version 8.77. The solution has been to upgrade to the latest version of DS 8.77 or higher. Currently DS 8.78 is available. TID 2960827 explains the update.

Q303:

The finger module does not load on my Linux/Solaris system?

A33:

On Solaris and Linux, the Finger Agent is not part of the installed product because a Finger daemon is part of the standard UNIX distribution

Q34:

How can I stop a looping message?

A34:

You need to determine which user is responsible and what is causing the looping message—whether it is a rule or an auto reply. This can be determined by looking in the message queue. (You should probably bring NetMail down so you can look through all messages without NetMail processing messages.) By looking at the control files (C*.*), you can see who each message is from and to whom the message is being sent. A series of very similar control files will indicate who is causing the looping message. Remove all looping messages from the queue and fix the auto reply or rule in the User object.

Q35:

Does NetMail detect mail loops?

A35:

There are three types of mail loops: the first is caused by DNS misconfiguration; the second is caused by two users auto-replying to each others auto-replies (an autoreply loop); and the third is caused when users are forwarding a particular message between their accounts (a forwarding loop).

In most cases, the first problem can be detected by NetMail if only a single IP address is used. NetMail logs that there is a DNS misconfiguration. If the server has multiple IP addresses bound, NetMail cannot properly detect the situation.

The second problem, auto-reply loops, cannot be automatically detected since, technically, it’s not the same message being sent between the two systems. However, the NetMail Autoreply Agent will not autoreply to messages that have the “Precedence: bulk” header, and its auto-replies contain this header line. the "Precendence bulk" header minimizes the occurrence of loops.

The third problem is forwarding loops. NetMail will not forward forwarded message on the same system; however, it does not detect such loops if they occur between two independent servers. While it is technically possible to detect forwarding loops in the same system, we have found that the code required to do this (which is in NetMail, but disabled) causes a 55% performance decrease at all times, even if there never is a looping situation. Since forwarding loops are relatively rare, and since it will be quite obvious from system behavior (like rapidly increasing statistics counters and high CPU utilization) that a loop is happening, we decided to opt for performance.

Q36:

I disabled a NetMail agent and now mail is getting stuck in a queue. How can I fix this?

A36:

If messages are coming in the queue and not leaving, you need to find out which queue they are getting stuck in (what is the extension on the C* files in the spool directory?). Based on the answer to that question, you can find determine which agent is responsible for the problem.

For example, if the extension were .007, we would suspect that the DNS server is having problems. If it is a number less than 007,. we would suspect a queue agent is still registered but no longer running. If this is the case, deleting the qclients file from the DBF directory after unloading NetMail will fix the problem.

Q37:

When is it safe to delete the qclients file?

A37:

In general, unless you change one of the parameters that cause qclients to be incorrect (for example, permanently removing an agent, changing a server IP address, or changing the DN of the messaging server), you should never delete the qclients file.

However, if you determine you need to delete it, make sure that NMAPD is not running before deleting the file.

Note: When NMAPD is running, it rewrites the file.

Q38:

I changed my server’s IP address and now mail is getting stuck in the queue.

A38:

See Question 36: “I disabled a NetMail agent and now mail is getting stuck in a queue. How can I fix this?”.

Q39:

What do I do if mail is not leaving the system but is stuck in one queue?

A39:

See Question 36: “I disabled a NetMail agent and now mail is getting stuck in a queue. How can I fix this?”.

Q40:

Mail does not deliver; it just sits in the queue?

A40:

See Question 36: “I disabled a NetMail agent and now mail is getting stuck in a queue. How can I fix this?”.

Q41:

The List Agent on NetWare 4.11 does not correctly process subscription e-mails.

A41:

The List Agent can only be used on NetWare 5.x and above. It is not supported for NetWare 4.x, due to the lack of some NDS functionality in NDS 6.x.

Q42:

What happens if there are duplicate aliases created for two users?

A42:

If there are duplicate aliases, the log file will contain a line describing the error when creating the aliases. If you do not fix this problem, the first user assigned to the alias will receive all mail sent to that alias. If SNMP monitoring is used, NetMail will also send a trap notifying the SNMP monitor about the duplicate alias.

Q43:

I cannot get the Modular Web Agent address book lookup to work on Solaris or Linux.

A43:

There is a problem with the ModWeb/WebMail Agent that only happens if NetMail loads the web interface automatically at startup. Currently, the only work around is to load the ModWeb/WebMail Agent manually after starting NetMail.

Q44:

The Address Book Agent is not loading, it seems another LDAP Agent is still running.

A44:

When using eDirectory on Linux and Solaris, it automatically runs Novell’s LDAP server, nldap. Run nldap –u to unload.

Q45:

Why does it seem like NetMail is not using a secondary DNS server?

A45:

NetMail only uses a secondary DNS server if a response from the first DNS server is not received. If NetMail receives a response from a DNS server, it acts according to the information received, even if the information is incorrect. NetMail, like any other application, must assume that all information received from a DNS server is correct. Consequently, it will not contact a secondary DNS server if a response is received from the first DNS server. If a DNS server is not returning the correct information, you need to fix it or point NetMail to a different DNS server.

Q46:

A user’s language setting defaults to French Canadian and the setting cannot be changed.

A46:

Check your user's Signature content. If the Signature contains more than eight or nine "=" on the last line, the language defaults to French Canadian. The team is looking into this problem.

Q47:

Every time NetMail is restarted, “novonyx/mail” is added to the NetMail objects’ path, eventually causing NetMail to ABEND.

A47:

This is a symptom of a failed/incomplete schema extension. Perform a DS health check to track down any synchronization issues that you might have and then re-extend the schema using NIMSEXT.NLM. It is NOT necessary to remove NetMail first; re-extending the schema will not overwrite your current system configuration settings.

Q48:

What does “server encountered a processing error” really mean?

A48:

Error reporting before NIMS 2.65 was minimal. Before analyzing this error, upgrade to NIMS 2.65 or NIMS 3.x. We have greatly improved error handling in more recent versions. Usually this error was caused because NetMail could not contact the remote site.

Q49:

Users do not receive bounces for messages sent to a list, could this be changed?

A49:

Messages sent to a list do not get bounced to the sender. A list is large enough that the sender does not care if a couple of people on the list do not get the message. If you would like to be notified of all failures, set up a Group. For more info on mailing lists, see “Managing Mailing Lists” on page 245 in the NetMail Administration Guide.

Q50:

What should I do if my server is experiencing high utilization?

A50:

Start by unloading the NetMail agents one at a time to see if NetMail is causing the problem. If you find that a NetMail agent is causing the problem, you need to find out what it is doing. (Is it working on a message in the queue? Is it processing a request?) Pinpointing an action that triggers the high utilization also helps. Once you have collected as much information as possible, submit a question to NIMSTALK@nimsinfo.com with the information that you have gathered.

Note: See Question 36: “I disabled a NetMail agent and now mail is getting stuck in a queue. How can I fix this?”.

Q51:

My LDAP server will not return any requests.

A51:

  • Make sure that an Address Book Agent object exists in NDS.
  • Make sure that the Mail Module beneath the Modular Web Agent has the correct address book information.
    Note: For single server system using the Address Book Agent, entering “127.0.0.1” in the “System Wide LDAP Server field” will suffice.
  • Make sure that no other LDAP server is running on this server. If NLDAP, the Novell LDAP server, is loaded, the NetMail LDAP server will not load.

Q52:

Why does the status of a message not change after I read it in the Web Interface?

A52:

If this occurs in the NIMS 3.0 web interface, simply select Update to refresh the message view.

If this occurs in with NIMS 2.6x, you likely have a read-only connection to your mailbox, and therefore, changes will not be saved. If this is the case, close all connections to the mailbox then try accessing it again. Inactive connections will time out within 45 minutes, but if a client is set up to pull mail from this mailbox every 20 minutes the read/write connection will not timeout.

Note: All sessions in NIMS 3.0 are read/write sessions and there are no longer read-only sessions.

Q53:

What are the *.008 files in the spool directory?

A53:

The *.008 files are messages being bounced back to the sender. This can happen because the recipient does not exist, the messages were incorrectly formatted, the sender or domain is blocked by NetMail, etc.

Q54:

I added users to a new OU and now they cannot log into NIMS.

A54:

When adding a new container to NetMail, you need to make sure that the new context is explicitly defined in the NMAP agent. If the context is not defined in the NMAP agent the users serviced by this context will not be able to log into NetMail.

In NetMail 3.0 and previous versions, the messaging server’s context list cannot be updated in memory. Consequently, if you add or remove contexts in the NMAP Agent configuration, the changes do not take effect until the messaging server is restarted. In NetMail 3.1, the messaging server’s context list can be updated in memory; therefore, it is no longer necessary to restart the messaging server.

Q55:

Where are the NetMail log files stored?

A55:

On Netware, the default log directory is sys:\etc\syslog.d .

On Linux and Solaris, the standard UNIX syslog daemon is used. Check “man syslogd” to see configuration on those systems.

Q56:

Some aliases are not being created correctly by the Alias Agent; the alias names are being chopped off at eight characters.

A56:

The Alias Agent will only use up to eight characters when creating the First initial plus Last Name alias scheme (FLastnam), so a user whose name is Bill Williamson will end up having an alias of bwilliam. This is not a bug. If you want Bill’s alias to be bwilliamson, you will have to manually create the alias. For more info refer to “Hosting and Feature Management” on page 209 in the NetMail Administration Guide.

Q57:

I cannot add a moderator to my list; the user that I want does not show up.

A57:

The list moderator must also be a member of the list. Add the user to the list as a member then select that user as the moderator.

Q58:

What user IDs are valid?

A58:

RFC 2821 (http://vyger.freesoft.org/CIE/RFC/821/24.htm) explains what is valid and what is not.

Q59:

The Modular Web Agent will not load on port 80.

A59:

This usually indicates that some other daemon is already using port 80. Either configure ModWeb to run on a different port in the Modular Web Agent configuration tab, or unload the other program that is using the port (or just reconfigure it to use another port). On NetWare, you probably want to unload the following programs:
  • httpstk
  • portal
  • nshttpd


Q60:

How can I know if NetMail is answering on a certain port (IMAP, POP, SMTP)?

A60:

Simply use telnet to connect to the port for the protocol you would like to check.

For example, to check if IMAP is working, enter telnet <server-ip-address> 143

If you get a response, then NetMail is answering. Note: "NIMS," "NetMail," or "Novonyx" will be in the answer string.

Q61:

Where can I find an explanation of SMTP errors?

A61:

RFC2821 describes the standard responses.
Below is the list of responses that the NetMail SMTP Agent uses:

211-Acceptable commands
211-HELO MAIL RCPT DATA\r\n211-RSET VRFY EXPN HELP
211 NOOP QUIT
220 Novonyx SMTP ready
220 Ready to start TLS
221 So long, and thanks for all the fish
250 OK
250 Pleased to meet you
250-ETRN
250-STARTTLS
250-HELP
250-EXPN
250-PIPELINING
250-8BITMIME
250-DSN
250-AUTH LOGIN
250-AUTH=LOGIN
250 SIZE
251 OK No messages waiting for you
252 OK Messages for you are being sent
250 Sender OK
250 Recipient OK
354 Send message, end with <CRLF>.<CRLF>
421 Service not available: server shutting down
451 Internal error: Unable to complete, please try later
451 SMTP Receiver temporarily shut down, please try in a few minutes
451 Too many connections, please try later
452 Not enough disk space. Please try later
550 Your site is blocked due to previous spamming incidents
551 Your computer does not have a hostname, access blocked
552 Blackholed by %s
553 Your computer does not have a hostname, you must AUTHenticate
500 Command unrecognized
501 Parameter syntax error or not supported
502 Command not implemented
500 Line too long, closing channel
500 Out of memory, closing channel
501 Recipient address unknown format
501 You don't exist. Go away!
501 Syntax error, no sender
501 Syntax error
502 Command disabled
503 Invalid sequence of commands
504 Unrecognized authentication type
505 Authentication required
550 Mailbox not found
550 Too many recipients
552 Message size exceeds maximum allowed by this server
571 No external routing allowed
571 Remote sending only allowed with authentication!
572 Bounces are blocked due to system abuse by spammers

Q62:

I cannot get SSL to work.

A62:

See “Setting Up TLS and SSL” on page 184 in the NetMail Administration Guide. If you continue to have problems, send the exact error message you are getting to NIMSTALK@nimsinfo.com.

Q63:

Why can’t I use “Verify recipients Addresses when accepting messages”?

A63:

You can use it, but then you can’t use aliases or host mailing lists. This switch causes the SMTP Agent to verify all recipient addresses against NDS, and since aliases and mailing list subscribers do not have a corresponding User object in NDS, they will fail.

The switch is a remnant from the days of NIMS 1.x (then known as the Netscape Messaging Server for NetWare) when life was still good, people were honest, and SPAM was an unknown problem. It used to be NIMS’ only defense against SPAM. These days this mechanism isn’t enough, but we kept it for compatibility reasons. It will go away in the near future.

Q64:

I receive the error “Message is no longer available on the server” in Outlook Express when trying to read some messages?

A64:

This usually indicates that the Outlook local message cache is corrupt. Select the properties for your server entry and clear all local files. If this doesn’t help, the message is either malformatted and Outlook doesn’t like it or there is a NetMail problem. If you can provide the team with a copy of the mailbox AND corresponding index file, we can analyze it and maybe fix a bug.

System Setup

Q65:

During the NetMail installation, NIMSEXT does not accept my login credentials; I get “Login Failed.” What is wrong?

A65:

There are cases when DS cannot find the user unless it is in a specific format. The following is a list of all formats that you can try when running NIMSEXT.
  • <user> (This should work if the admin user is in the same context as the server.)
  • <User>.<Organizational Unit>.<Organization>
  • .<User>.<Organizational Unit>.<Organization>
  • .cn=<User>.ou=<Organizational Unit>.o=<Organization>
  • .cn=<User>.ou=<Organizational Unit>.o=<Organization>
Please try all the formats before giving up. We don’t know why some instances of eDirectory don’t like certain logins, but we’ve found that one of the formats will always work.

Q66:

How is NetMail licensed on NetWare 6? Do I have to purchase Netware 6 licenses for all of my NetMail users?

A66:

NetWare 6 licensing does not affect NetMail licensing. NetMail users do not need a NetWare 6 license unless they need to use NetWare file and print services. They do need an NDS license, but that is included in the NetMail price. See question 89: Do I need to purchase eDirectory user licenses as well as NetMail user licenses?.

Q67:

How do I set up SMTP-after-POP?

A67:

See “SMTP-after-POP” in the NetMail Administration Guide on page 191.

After creating a Connection Manager Agent, enabling SMTP-after-POP on the SMTP Agent, and identifying the Connection Manager in the Messaging Server, wait a couple of minutes for DS to sync and then, at the console, enter

IMS Unload
IMS

Q68:

How do I prevent my system from being an open relay?

A68:

Set up SMTP-after-POP. See Q67: How do I set up SMTP-after-POP?.

You can also use the Allowed List function. If your users usually come from a known range of IP addresses, you can add that range to the Allowed List so whenever a user connects to SMTP from one of those addresses, they will not have to authenticate.

Q69:

When do I use Hosted domains and Global domains?

A69:

See “Supporting Multiple Internet Domains” in the NetMail Administration Guide on page 210.

Q70:

The Postmaster address included in bounced messages sent from my NetMail server has two domains appended.

A70:

There used to be a bug in NIMS 2.6 that would cause this. Update to NIMS 2.65. If you are using NIMS 3.0, you have probably entered a hosted domain user as the Postmaster. Neither the Postmaster’s addressed domain nor the official domain may be hosted domain.

Q71:

NSS vs. Traditional file system, what is better?

A71:

We would recommend the legacy file system over NSS. Because of the sheer number of files that get created and deleted, the file system you use will largely determine overall system performance. In our tests, NetMail ran four times faster on the legacy file system.

Note: We have no performance numbers for NSS on NetWare 6, but we believe performance of NSS will be better on NetWare 6.

Q72:

Where is the personal address book info stored?

A72:

The personal address book information is stored in the NDS User object.

Q73:

Can I change the Listserv commands or messages?

A73:

English commands are stored in \system\nls\4\imslist\strings.txt . On UNIX systems, the commands are stored in $NIMSDIR/nls/4/imslist/welcome.la . By modifying this file, you can change the commands the List Agent understands as well as the text that is sent back to the user and moderator.

If your NetWare server is configured for a language other than English, do not replace the English file (...4\imslist\strings.txt). Instead, create a new strings file in another directory. For example, you could create a strings.txt file in the ...7\imslist directory for German commands and text.

Q74:

Do NetMail messaging servers require an NDS replica?

A74:

No, it does not require a local replica. However, it is very strongly recommended to have a local Read-Write replica. See “Understanding How NetMail and NDS Work Together” on page 30 in the NetMail Administration Guide.

Q75:

Are there going to be ConsoleOne SnapIns for NetMail?

A75:

Currently, only WebAdmin and NWAdmin snap-ins are available for NetMail. There are no engineering plans to create any ConsoleOne SnapIns for NetMail.

Q76:

How do I get quotas to work on NSS?

A76:

To get NetMail quotas to work with NSS, you must:
  • Install Support Pack 3 on NetWare 5.1, or Support Pack 7 on NetWare 5.0.
  • NSS must be started with the /classicdirectoryquotas switch.
    For example, NSS /classicdirectoryquotas

Q77:

How do two NetMail servers in the same tree talk to each other? NMAP to NMAP, or SMTP to SMTP?

A77:

Unless you disable the distributed processing property in the Messaging Server configuration, messaging servers use NMAP to communicate with other messaging servers in the tree. Messages do not hop across NMAP Agents; messaging servers talk directly to the message recipient’s NMAP server. The address used to connect to the other NMAP server is read from DS.

Note: This address is visible in the Messaging Server properties menu under Status.

When talking to systems outside the local domain, NetMail uses SMTP to talk to the other system, even if it is a NetMail server.

Q78:

How can I get the best performance out of my Solaris server?

A78:

The performance-limiting factor on Solaris is the file system. We have found that using the Veritas file system can provide better performance up to an order of magnitude.

Q79:

How should I set up NetMail if I have X servers and Y users?

A79:

This question is hard to answer because setup depends more on expected traffic (concurrent connections, protocols used for access) than a simple number of users. You can service several million users on a 486 if only ten access the mail server at any one time. NetMail has been successfully servicing over 150,000 users on a single server at MyRealBox.com. There are also installations for over 1 million users with just three servers.

To make an educated guess, you need the following numbers:
  • How many simultaneous connections are expected? We’ve seen many unrealistic numbers for this value. Usually the estimates were much too high, so consider how people access the system, how many dial-up lines you have, how many computers are on campus, etc.
  • What protocols will be used? POP, IMAP, ModWeb?
    • POP has short connections and takes less resources.
    • IMAP sessions can last a long time and they take up more RAM.
    • ModWeb connections are brief, but sessions can last a long time. ModWeb has higher memory requirements than IMAP because it’s basically a full e-mail client running on the server.
  • How many objects will be in NDS? NDS caches all data by default. Therefore, unless explicitly restricted, you could end up with the whole replica in RAM.
  • How many simultaneous incoming server (SMTP) connections are expected?

Once you have those numbers, calculate about 100KB per POP connection, 150KB per IMAP connection, and 200KB per ModWeb connection and see how much RAM you need to sustain your connections. Also calculate about 250KB for any incoming SMTP connection. These calculations will give you an idea of your RAM requirements.

Important: These numbers are very rough estimates and include associated resources like RAM used for IP sockets, etc. Your actual mileage may vary.

If client protocols (POP, IMAP, SMTP and ModWeb) are run on a different server than NMAP, the memory requirements are about 70KB less per connection for the server running POP, IMAP and ModWeb, and about 100KB less per connection for the server running SMTP. The difference in memory requirements is due to the split of functionality on the servers. The total memory reduction on the protocol server needs to be added to the memory requirements for the NMAP server.

On Myrealbox, we’re running about 1000 client connections during peak usage and 650 sustained connections with 2GB of RAM. NDS uses about 1GB and we have 450MB of free RAM for cache buffers.

For Linux and Solaris, we have been unable to gather more detailed memory requirements. However, they should be about the same since resource requirements should not vary significantly from NetWare. The NetMail binaries, themselves, need the same amount of RAM on all platforms.

Q80:

Can NMAP just service an object’s NDS alias, but not the User object itself?

A80:

NMAP must service the context where the actual User object resides. You will see very odd problems if NMAP only services the context in which the Alias object exists. The NMAP Agent can service both the User and Alias object contexts; however, NetMail will always store the user’s account data under the User object. Consequently, the User object name must have valid 8-bit syntax.

Note: Double-byte characters are not supported for either the Alias or the User object because Internet standards do not support such addresses.

Q81:

Can a traditional file system be used in cluster services?

A81:

Yes. Netware clustering can use a traditional file system and we recommend that a traditional file system be used. In our tests, the traditional file system performed four times better then a NSS file system.

Note: We have no performance numbers for NSS on NetWare 6, but we believe performance of NSS will be better on NetWare 6.

Q82:

What versions of NDS does NetMail run on? What operating systems does NetMail support?

A82:

NetMail currently runs on the following platforms:
  • NetWare 4.x
  • NetWare 5.1 SP5
  • NetWare 6.x SP2
  • RedHat Linux 6.1 and higher
  • Solaris 8
  • Windows NT 4, SP6a with the latest security fixes
  • Windows 2000 SP2 with the latest security fixes
  • Windows XP with the latest security fixes

NDS requirements are as follows:

  • On Solaris and Linux, eDirectory 8.6.2 is required.
  • On Windows NT/2000/XP, eDirectory 8.6.2 must be loaded locally on the Windows server
  • On Netware, all NDS versions from 6.x up are currently supported.

However, support for any version less than 8.5 will be dropped a future release so NetMail will not require the User object ID to be the e-mail ID. In that future version, it will be possible to use an attribute as the e-mail & login ID.

Q83:

What performance optimization can or should be done for NetMail?

A83:

For information on optimizing a Netware server for NetMail, please see “Optimizing a NetWare Server for NetMail” on page 331 in the NetMail Administration Guide.

For Solaris 8, the TCP parameters should be set as described in Sun tuning documents and according to expected load. The best tuning on Solaris is to use any file system other than the standard UFS file system. The NetMail team has seen a significant improvement in performance with the Veritas file system

Q84:

How do I bind NetMail to a specific IP address?

A84:

This functionality was added in NIMS 3.0. Under Messaging Server properties, select the Status tab and click Advanced. In the Advanced IP Options dialog, you can bind NetMail to a specific IP address by selected Force bind. For more information, see “Advanced IP Options” on page 95 in the NetMail Administration Guide.

Q85:

What is the best block size on a volume with sub allocation?

A85:

It depends. If no sub allocation is used, the larger the better. With sub allocation enabled, the smaller the better.

Q86:

Does NetMail require a web server to run the web interface?

A86:

No. The Modular Web Agent (NIMS 3.x) and the WebMail Agent (NIMS 2.x) act as their own web server in serving up NetMail content.

Q87:

How can I convert my existing e-mail over to NIMS?

A87:

NetMail’s Mail Proxy feature can pull mail from any mailbox accessible through POP or IMAP and place it in the NetMail message store. As the feature is designed in NetMail, it requires user intervention. However, it can be automated if you know the usernames and passwords for all your existing mailboxes.

One limitation of the Mail Proxy feature is that it will only pull messages that exist in the inbox. If you can convert your existing mail system to Sendmail, you can copy the SendMail files over to the NetMail user directories since the SendMail and NetMail message stores use the same format. More migration methods and tools are under consideration.

Q88:

Can NetMail be used if I have another e-mail system that is tied to the same domain name?

A88:

Yes. For more information, see “Domain Sharing” on page 215 in the NetMail Administration Guide.

Q89:

Do I need to purchase eDirectory user licenses as well as NetMail user licenses?

A89:

When you purchase NetMail, you are entitled to the same number of eDirectory licenses as NetMail licenses. Read the NetMail license for details.

Q90:

Can NetMail be run on the same server as another e-mail system?

A90:

Not really. Both e-mail systems will fight over ports. If a port is already in use, NetMail will not load the NetMail agent that tries to use that port.

However, if multiple IP addresses are bound to the system, it is possible to force a bind to a particular IP address and run two mail systems on the same server. (See Q84: How do I bind NetMail to a specific IP address?.

Note: You cannot load NetMail twice, so you better have two different mail systems! There’s no reason to load NetMail twice because it can support multiple domains on a single port.

Q91:

How should I organize my tree? Distributed or non-distributed?

A91:

Please refer to “Planning Your NetMail System” on page 29 in the NetMail Administration Guide. It gives a very good step-by-step explanation of how to best set up your system.

Q92:

How is SSL enabled in NetMail?

A92:

Under the Security tab in the Messaging Server properties menu, the Enable SSL and TLS option needs to be marked. Additionally, a certificate needs to be installed using CertGen. Please refer to “Setting Up TLS and SSL” on page 184 in the NetMail Administration Guide.

Q93:

We are planning on creating a filtered NDS replica for NetMail authentication and we need a list of the objects and attributes that we need to replicate.

A93:

Every object class and attribute that starts with either “NIMS:” or “Novonyx:” must be replicated. Additionally, NIMS 3.0.1 and higher uses the “Internet E-mail Address” attribute. Of course, these attributes are in addition to the standard User and Group object attributes.

Q94:

Where does the e-mail address field for the address book come from?

A94:

This description is for NIMS 3:
  1. NetMail will check to see if the User object has the “Internet E-mail Address” attribute set. If so, it is used.
  2. If the user is a hosted domain user, the User object already has a domain name associated with it and NetMail will simply use the User object name.
  3. If the user is not a hosted domain user, then NetMail will determine if the user is associated with a Parent object and if that Parent object has an assigned domain. If this is the case, NetMail combines the Parent object’s global domain with the User object name to form the e-mail address.
  4. If options 1-3 fail, NetMail checks the context under which the user exists to see if there is a domain name associated with the context. If a domain is associated with the Container object, NetMail will combine the Container domain with the User object name to form the e-mail address.
  5. As last resort, if a-d fails, the Official Domain defined in the Messaging Server object is used to form the user’s e-mail address.

In NIMS 2.x, only steps b, d and e are performed.

Q95:

What does the Organization field in the NetMail address book map to?

A95:

The value in the Department field in the User object is used to populate the Organization field in the address book.

Q96:

My NetMail server used to be lightning fast, but has suddenly become really slow. What happened?

A96:

This usually indicates that the Immediate Purge of Deleted Files option is not enabled.

In processing messages, NetMail creates a lot of temporary files. If these files are not purged, they can quickly fill the volume and drag messaging system performance to a crawl.

To automate the process of purging NetMail’s temporary files, enable the Immediate Purge of Deleted Files option using either the global switch in Monitor or by direct assignment using command-line utilities. Immediately purging deleted files accelerates server startup and improves message store performance; however, you lose the ability to restore deleted files on your volume.

Note: Instead of enabling immediate purge on the entire volume, you can apply this parameter to only the mail store directories. Limiting immediate purge to the NetMail mail store allows you to restore deleted files everywhere on your volume except the mail store directories.

Important: You do not need to enable Immediate Purge of Deleted Files if you regularly purge NetMail’s server volume. Depending on message traffic, this may need to be done on a weekly or even a daily basis.

Q97:

Why is NetMail creating so many temporary files?

A97:

To protect shared access and prevent data corruption, NetMail creates various lock files and temporary files. Since the first commandment of a mail server is to not lose mail, things have to be implemented this way, even if they seem to slow down the system or seem unnecessary.

Q98:

How can I set up a signup solution with NetMail?

A98:

Signup is usually a very custom process and everyone has different needs. Consequently, the NetMail team recommends using Novell Consulting Services to create the signup solution.

However, for those who either don’t want to spend the money or like a challenge, NIMS 3.0.2 provides the MWSignup ModWeb Module along with template sources for the MyRealBox signup pages. If you need help with them, you can post your questions to NIMSTALK@nimsinfo.com; however, users with “real” problems will have priority.

Q99:

I’m getting an ABEND when loading the AntiVirus Agent or the AntiVirus Agent does not seem to scan anything.

A99:

The APIs that were provided to us by the AntiVirus vendors only work on those vendors’ newer engine versions.

For InoculateIT, the supported version is AVENGINE.NLM, Version 23.48, Nov 8, 2001.

For McAfee, the supported version is MCSCAN32.NLM, Version 41.40, Jan 17, 2001.

System Administration

Q101:

How do I create a hosted user in NWAdmin or WebAdmin?

A101:

A hosted user ID contains the domain name and the user ID (for example, jsmith@xyz.com). In NWAdmin, the user ID must be entered as jsmith@xyz\.com . The “\” tells NDS that the “.” does not refer to a context.

In WebAdmin, the user ID can be without a “\” (jsmith@xyz.com).

For more info about hosted domains and users, see “Hosting Domains” on page 213 in the NetMail Administration Guide.

Q102:

How can I see and set information that is stored in NDS?

A102:

You can use a number of different utilities like DSSNOOP, JRBUtils, ConsoleOne, and DSBROWSE. You can search the archives of NIMSTALK to see what others use.

Q103:

What is the “Forward Local Undeliverable” feature used for?

A103:

See “Forward Local Undeliverable Messages” on page 99 in the NetMail Administration Guide.

Q104:

Do I need to upgrade all my messaging servers to NIMS 3.0 at the same time?

A104:

Yes and no. Changes in NIMS 3.0 are significant enough that all of your servers should be simultaneously upgraded to NIMS 3.0, if possible.

If this is not possible and you’re using a “Hub and Spoke” system, upgrade your central servers first.

If you have a mixed environment, do not mix NIMS 2.x agents with NIMS 3.x NMAP servers and vice versa.

Another issue is with users who are already on NIMS 3.x sending a calendar message to a NIMS 2.x user in the same tree. The NIMS 2.x server will simply drop the calendar message.

Q105:

How can I set a default template for my users?

A105:

The default template can be set on a Parent object and on the Modular Web Agent. If set on a Parent object, the default template setting will only apply to users assigned to that Parent object. Setting the default template on the Modular Web Agent applies the setting to all users. If both settings are applied, the Parent object has precedence over the Modular Web Agent.

For further information on Parent Objects, see “Leveraging Parent Objects” on page 228 in the NetMail Administration Guide.

Q106:

How do I control what templates are available to my users?

A106:

Here are two options to control access to templates:
  • .The Modular Web Agent has the option of restricting access to templates in the “Available Template” and “Default Template” dialog boxes.
  • .Use Parent Objects. The problem here is that you have to assign Parent objects to all your users. This can be done using a utility like JRB's setname. Parent objects are quite powerful and they are great if you have different user groups. For more information, see “Leveraging Parent Objects” on page 228 in the NetMail Administration Guide.


Q107:

How can I have the same user ID for multiple domains that I might be hosting?

A107:

If you are using hosted domains this is possible. See “Hosting Domains” on page 213 in the NetMail Administration Guide..

Q108:

How can I send a bulk mailing to all my NetMail users?

A108:

Here are two options:
  • .Create a mailing list with all users and send to that list.
  • .The BulkMail utility created by the NetMail team allows you to create multiple messages to be delivered simultaneously to any number of users. You will want to play with the blocksize number to determine what will work best for your system.

This utility is available at http://www.novell.com/coolsolutions/netmail/ downloadables.html.

Q109:

When should I use the Bounced Message Control feature and what does it do?

A109:

In general, don’t use it. It is designed to allow sites with a high level of SPAM abuse to control how many bounces can be generated by the system in a given time. For example, if Bounced Message Control is set to 300 bounces in 30 seconds, if more than 300 bounces are generated within 30 seconds, NetMail will simply drop the bounce. It can also be useful if you have a malicious denial-of-service attack happening. For more information, see “Bounced Message Control” on page 198 in the NetMail Administration Guide.

Q110:

How can I import data such as users, user’s attributes, and NetMail attributes into DS?

A110:

There are many utilities that will allow you to import data into NDS. Some of these include

Q111:

Can I run NLDAP and the NetMail LDAP server on the same server?

A111:

Not unless you change one of the port assignments. The NetMail LDAP server will not load if the LDAP port is in use by another process. If you are running the NetMail LDAP server, make sure that the Novell LDAP server is not loaded. Remove it from the autoexec.ncf if it exists.

Alternatively, you can change the port in the Address Book Agent Configuration tab, but remember to notify all clients of the changed port and update the Configuration for the ModWeb Mail Module’s System address book, if used.

Q112:

How can I create a hosted mailing list using hosted domains?

A112:

The mailing list is created as the full name (for example, list@domain.com). The period (.) does not need to be escaped with any character.

Q113:

Can the Internet Services Container be moved?

A113:

No. The Internet Services Container cannot be moved from the Root. You can, however, create a messaging server object anywhere in the tree.

Q114:

How are SCMS messages stored?

A114:

An SCMS message is given an SCMS ID. The message is then stored in one of the 16 SCMS folders based on the last letter of the SCMS ID. The message header and the SCMS ID are stored in the recipient’s mailbox.

When the user reads the message using the web interface, the body of the message is pulled from the SCMS directory using the SCMS ID stored in the message header. For more information, see “Single Copy Message Store” on page 21 and “SCMS Message Structure” on page 278 in the NetMail Administration Guide.

Q115:

How do I move a user’s mailbox to another volume/system if the user has SCMS messages?

A115:

There is currently no utility that allows you to do this. In most cases when this was requested, the administrator was unaware of the distributed nature of NetMail and that it was unnecessary to physically move the user. We are, however, considering a tool for a future release.

Q116:

If I run more than one NMAP against the message store, will it improve performance?

A116:

No. Running more than one NMAP against a single message store causes unpredictable behavior; it may cause data corruption, erratic client behavior and even loss of data. Consequently, this configuration is not supported and is not a wise setup.

Q117:

Should NetMail messaging servers hold a partition of Root, or just some OU’s?

A117:

A NetMail messaging server should hold partition information on the contexts that it services, including its corresponding Messaging Server object. (In a distributed system, you can partition off Internet Services and have a read/ write replica on all NetMail servers. For more information, see “Optimizing NDS for NetMail” on page 30 in the NetMail Administration Guide.

Q118:

Can I use another LDAP server besides NIMS’ Address Book Agent (MSGLDAP) to fulfill LDAP requests?

A118:

Yes, but you may use some functionality. The NetMail LDAP server automatically generates all user e-mail addresses based on their associated User objects and domains.

To use a different LDAP server, you need to populate the Internet E-mail Address attribute in the User object. (This can be done using the NetMail Address Book Agent.) Also, the other LDAP server would need to be configured to use the User object’s Internet E-mail Address attribute.

Q119:

How can deleted messages be restored from a backup?

A119:

You have two options:
  1. Rename the restored Inbox.box to something like Restored_Messages.box and put it in the user's NetMail mail directory. NetMail will automatically generate the *.idx file and the user will have access to the new folder from an IMAP client or the web client.
  2. If POP is the only option, you can append the restored Box file to the current Box file. Just make sure to put a blank line in between the messages where you append the file. It should not matter what order the< messages appear in the merged inbox because the client should take care of sorting the messages.

Q120:

Can an e-mail disclaimer be added to all outgoing e-mail?

A120:

Yes, this can be accomplished with the PlusPack. For more info on the PlusPack, see the “Tools and Add-ons” section below.

Q121:

Will NMAP service sub-containers or does every container need to be defined in NMAP?

A121:

You need to explicitly define every container that should be serviced by NetMail. Go to the Context tab on the NMAP Agent object to do this. For more info about NMAP contexts, “Context” on page 96 in the NetMail Administration Guide.

Q122:

What happens to mail destined for an account that has been disabled?

A122:

If an e-mail is sent to an account that has been disabled, the e-mail will be rejected and bounced back to the user.

Setting an account to “Disabled” will make NetMail behave as if the user does not exist.

Q123:

What is the difference between disabling the NDS account and disabling the NetMail account?

A123:

If an NDS account has been disabled, the user cannot log into NDS but the user can still log into NetMail and vice-versa. This is a nice security feature for an ISP that is hosting NetMail users, but does not want these users to ever log into NDS. However, remember that just because a user’s NDS account has been disabled does not mean the user cannot log into NetMail.

Q124:

Is there a utility that will monitor our NetMail system and send a notice if there is a problem?

A124:

The NetMail team has provided BabyMon. This utility runs on Linux, Solaris and Windows and will monitor a NetMail system and send an alarm if there is a problem. It is available at http://www.novell.com/coolsolutions/netmail/downloadables.html.

Q125:

How can I get activity numbers on our user accounts?

A125:

IMSAudit, available in NIMS 3.0.2, generates statistics about user accounts. IMSAudit has two modes, normal and detailed. In normal mode, it simply counts all accounts; this is useful for licensing purposes.

In detailed mode, IMSAudit generates a comma separated values file (CSV) that can be imported into a spreadsheet or database application or it can be further processed by custom accounting tools.

For more information, see “IMSAUDIT” on page 321 in the NetMail Administration Guide.

Q126:

Is there an option for “authentication required” for the LDAP server queries?

A126:

Shortly before release of NIMS 3.0, we decided to pull the feature since it would most likely cause confusion for most users. (The Address Book is already one of the most misunderstood features and we didn’t want to add to the confusion.) However, if the feature is required, it can be enabled using an NDS editing tool.

See “Address Book Agent Optional Features” on page 148 in the NetMail Administration Guide for information on enabling this feature.

Q127:

How can the mailing list, template, or parent objects be recreated under Internet Services?

A127:

These objects can only be recreated by running NIMSEXT.

Important: Select ONLY Add Schema Extensions so NIMSEXT does not remove or reset your existing configuration.

Q128:

Is there any way to clean up the SCMS directory after a user has been deleted?

A128:

We are working on a tool to cross-check the SCMS store. In order to delete a user’s mailbox and all associated messages, use the RMBox utility provided with NIMS 3.0.2b. For more information, see “RMBOX” on page 328 in the NetMail Administration Guide.

Q129:

Is it possible to lock down features on a per user/group basis?

A129:

You have the following options:
  • To disable features for a particular user, disable the option on the User object.


  • To disable features for a group of users, create a Parent Object, select the options you want available, then add all users that you want to inherit these options to the Parent object. For more info about Parent Objects and how to use them, see “Parent Objects” on page 5 and “Leveraging Parent Objects” on page 228 in the NetMail Administration Guide.


  • To disable features for a group of users, remove all unwanted options from the templates. The template sources and compiler are available in the Unsupp directory. This option is not supported, but there is documentation in the Doc directory that will help you complete this process.

Q131:

What utilities are available to create/modify user accounts in NDS?

A131:

There are a number of Novell and third party utilities like Bulkloader, ICE, DSSNOOP, ConsoleOne, and JRB Utilities. You can search NIMSTALK for other utilities as well.

Q132:

There are a number of Novell and third party utilities like Bulkloader, ICE, DSSNOOP, ConsoleOne, and JRB Utilities. You can search NIMSTALK for other utilities as well.

A132:

To disable a user, select the NetMail tab on the User object and mark the Disabled option.

Q133:

What is the attribute that needs to be modified to disable a users account and what does the attribute need to be set to?

A133:

The attribute controlling a user’s access to NetMail is called Novonyx:Messaging Disabled. To disable a user, store “1” as a value.

This can be done via the Novell IMS Configuration tab in NWAdmin, with WebAdmin, or any numbers of utilities like Bulkloader, DSSNOOP, ICE, or JRB utilities.

Q134:

As admin can I log into someone’s mailbox without the user knowing?

A134:

Unless you know the users password you cannot log into the users mailbox. You can reset the password and log in as the user with the reset password.

The NetMail mailbox format is plain text so you could also open the *.box file with a text editor like NotePad and view all messages in the user’s mailbox. The *.box files are stored in the users directory and a *.box files exists for every folder in the user’s mailbox.

Q135:

How can I find which users have subscribed to an NDS or regular list?

A135:

The members of an NDS mailing list are shown in the list’s details in both NWAdmin and WebAdmin. The members of a mailing list are shown as subordinate objects under the list in NWAdmin. In WebAdmin, the users are shown in the details of the Mailing List object.

Also, the List Agent provides commands to request the members of a list. Send a message containing the word “Info” in the body to the List Agent. See “List Server Commands” on page 258 in the NetMail Administration Guide.

Q136:

Is it possible to run an English and Spanish ModWeb on the same server?

A136:

Yes. Language settings are set on the User object. The NetMail templates contain all languages in each template, so all 26 languages that NetMail supports are running on the same NetMail server.

Q137:

How can I have one certificate for multiple variations of my domain name (for example, mail.mydomain.com, smtp.mydomain.com)?

A137:

Only one certificate is recognized, so in this case, you would want to buy a wildcard certificate for *.mydomain.com.

Q138:

How can I disable a user’s rules?

A138:

To disable users’ access to the Rules feature, you can disable the feature at the User or Parent object.

If you simply want to remove a particular rule from a User object, use an NDS editor like DSSnoop or JRB Utils to edit the NIMS:Rule attribute. This attribute contains user rules.

Q139:

Can I change how often the Proxy Agent runs to collect mail?

A139:

By default, the Proxy Agent runs every three hours, but this can be set as low as one hour. We recommend not running too often, since it will significantly increase load on your system.

For example, MyRealBox runs every three hours, but to process all users’ proxy entries, it takes about 6 hours or more depending on how slow the remote systems are.

For more information, see “Proxy Agent” on page 141 in the NetMail Administration Guide.

Q140:

Can I force the Proxy Agent to proxy mail for a particular account instantaneously?

A140:

No. This would wreak havoc on a server since every user would always press such a button, if provided, and system resources would quickly be monopolized.

Q142:

No. This would wreak havoc on a server since every user would always press such a button, if provided, and system resources would quickly be monopolized.

A142:

The NetMail schema can be re-extended by running NIMSEXT. If you select Add Schema Extensions, NIMSEXT will not overwrite any existing configurations. This utility should only be run to recreate objects that cannot be created in the administrative interface (that is, the Internet Services, Parent, Template, and Mailing List containers).

Q143:

How do I get a log of incoming and outgoing SMTP mail, as well as NMAP deliveries?

A143:

If the logging level is set to INFO, SMTP will log what it successfully delivered and for whom and NMAP will log when messages are stored in mailboxes.

Q144:

What changes to NetMail do not require a restart of the system?

A144:

See “Implementing Administrative Changes” on page 289 in the NetMail Administration Guide.

Q145:   

What facilities does NetMail have to prevent looping?

A145:

  • NetMail Rules will not forward or reply to any message that already has been forwarded.
  • .Forward will not forward a forwarded message.
  • .Autoreply will not reply to a message that contains the “Precedence: bulk” header line.

Q146:

What is the best way to back up NetMail?

A146:

All of a user’s mailboxes are stored in the user directory by default; it is this data that is the most important to backup. If the volume that holds the message store were to die or become corrupt, all you have to do is restore the user directories once the volume has been replaced or repaired.

NetMail does not keep any files open, so backups can be performed at any time. The only time a file is open is if it’s being read or written, but this occurs in sub-second time frames. Most backup software will retry at least once to backup an open file, at which time the open file should be closed again.

Q147:

Can NetMail limit the amount of data that is bounced back to the sender if the recipient is undeliverable?

A147:

With NIMS 2.x, the full message was bounced back to the sender. Due to user requests, only the header info of the original message is sent back to the user in NIMS 3.0. Now, of course, people are complaining that they wanted to see the whole message. Oh well. If a client supports DSN, the client can specify what he wants back in a bounce.

Q148:

How are messages stored in the user’s mailbox? What is the NetMail mailbox format?

A148:

NetMail uses the same format as Sendmail on UNIX. Every message in a single mailbox is contained in a single file, separated by a CR/LF, a From xxx line in a particular format, and another CR/LF.

To speed up access to the mail.box file, NetMail creates an index file.

For more information, see “Message Structure” on page 275 in the NetMail Administration Guide.

Q149:

How can I tell what messages are waiting in the mail queue?

A149:

The MAIL STAT command lists the total number of messages in the queue as well as SMTP connections, client connections. (It’s nmail stat on UNIX). For more information, see “Server Commands” on page 311 in the NetMail Administration Guide.

Q150:

How can I get every piece of mail that was sent to my NetMail system, even if the user does not exist?

A150:

Messages sent to non-existent users can be copied to the Postmaster by marking the Bounce Control CC:Postmaster option in the NMAP Agent’s Options page. All bounces will then be delivered to that mailbox. For more information, see “CC Postmaster” on page 99 in the NetMail Administration Guide.

If you want all mail going through your system, you need the PlusPack Agent.

Q151:

What is the difference between NDS aliases and NetMail aliases?

A151:

NDS aliases are actual objects in the tree and can be used when addressing e-mails to users in the system as long as the user and aliases exist in contexts that are serviced by NetMail.

NetMail aliases that are created by the Alias Agent are not objects in the NDS Tree. The Alias Agent creates a file in the DBF directory that keeps track of which alias matches which user. NetMail aliases can be much easier to maintain if automatic aliases are being used. For more information on NetMail aliases refer to “Managing User Aliases” on page 219 in the NetMail Administration Guide.

Q152:

Using NMAP commands, how can I create a folder with spaces in the name?

A152:

A white-space character is designated via the ASCII 0x7F character.

Q153:

How can I get the sub domains to match the user when sending e-mail?

A153:

If the user belongs to a hosting domain, it already has a domain name associated with it and NetMail will use the user ID on the message.

If the user does not belong to a hosting domain, then NetMail looks to see if the user is associated with a Parent object and if that Parent object has an assigned domain. If the Parent object has an assigned domain, the message will be sent with that domain.

If there is no Parent object, or the Parent object does not have an assigned domain, then NetMail looks at the context where the user exists to see if there is a domain name associated with the Container object. If so, the Container object’s domain is used on the e-mail.

If NetMail does not find a domain in the Parent or Container objects, it uses the Official Domain defined in the Messaging Server object.

Q154:

How does NetMail handle duplicate user IDs?

A154:

NetMail allows duplicate user IDs, but all mail for the user ID will go to the first user ID NetMail finds. Which user ID is first depends on the order in which NDS returns data.

Q155:

Is there a limit to the number of aliases entered in the Alias Agent?

A155:

No. But as always, be reasonable. It requires processing power to handle a database.

Q156:

Is it possible to auto-create a welcome e-mail for any new NetMail account?

A156:

Yes, if the Signup Agent is used.

Q157:

NetWare Only: Can I set SYSLOG to roll to a new file after x bytes, or x days?

A157:

Yes. This feature was implemented in NIMS 3.0.2b. You need to load syslogd before IMS is loaded in autoexec.ncf. You can provide the “-r” switch to syslogd to enable rolling of logs. Unless you plan to manually clean up or move your log-files, you most likely also want to add the “-a:<days>” switch. This switch will tell syslogd to automatically remove log-files older than <days> days.

Q158:

NetWare Only: Can I change the size of my syslog logfiles?

A158:

Yes, load syslogd with the “-s:” switch in autoexec.ncf before IMS is loaded. Size is provided in bytes. If you want to have 4KB log-files you would load it with -s:4096 .

Q159:

NetWare Only: When copying my logfile, there’s always some data missing.

A159:

Before copying the log-file, you should enter “syslog flush” on the console. This will cause the syslog daemon to flush it’s log. Usually, for performance reasons, about 4KB of the log are always buffered in RAM.

Q160:

NetWare Only: Syslog does not seem to be logging. What’s wrong?

A160:

You can type “syslog config” on the console to see how the syslog daemon is configured. Remember, any changes to the syslog configuration require a restart of NIMS.

Clustering

Q161:

How do I use NetMail with cluster services?

A161:

See “Building Fault Tolerance in NetMail” on page 50 in the NetMail Administration Guide.

Q162:

How do I split up the NetMail agents across multiple servers?

A162:

See “Creating and Configuring NetMail Agents” on page 37 in the NetMail Administration Guide.

Templates

Q163:

How can I modify templates?

A163:

The source files for templates shipping with NetMail are always available. They can be found under the unsupp/template directory in the NetMail distribution.

If you do not have this subdirectory, then download the NetMail Evaluation ISO image from http://www.novell.com/coolsolutions/netmail/ downloadables.html.

If you have a CD-R/RW drive and the associated software, you should be able to write a CD from the ISO image. You can also mount the ISO on a Linux system using the following command:
mount -t iso9660 -o loop <isoimagename>.iso /mountpount

Q164:

How can I add a logo to the templates?

A164:

ModWeb creates a logo subdirectory underneath the modweb directory. (On NetWare: Sys:system\modweb\logo, on Solaris /opt/NOVLnims/bin/ modweb/logo and on Linux /usr/local/nims/bin/modweb/logo)

In this directory, store the logo file and make the filename a number, but keep the proper extension (.gif or .jpg). Example: 1.gif.

Then use a NDS editor and add the following value to the “Novonyx:Configuration” attribute on the Modular Web Agent object:

Logo=<your number>

When ModWeb is reloaded next time, it will put your logo into the designated places on the templates.

Alternatively, you can add the following value to the “Novonyx:Preferences” attribute on the user object or a Parent Object:

“ModWeb:Logo=<your number>”.

This approach allows having multiple individual images per parent object and even per user, depending on how inheritance is set on parent objects. It will also work on the user if no parent objects are used on that user.

Of course, it is also possible to edit the template sources and generate templates that have hard coded logos.

Q166:

How can I remove feature configuration from the templates but still have the features active?

A166:

This can be accomplished by editing the template sources in the unsupp directory. This is unsupported but there is some documentation that we have included to help you out. Expect more detailed documentation on how to create/edit templates in the near future.

Q167:

Is there any way to do a form-based login for NIMS?

A167:

Here is how to implement form-based login with ModWeb and NIMS 3.0. Use the following FORM tag for METHOD="GET":

<form method="get" action="http://your.server.name/ f?username=xxx&password=xxx">

Use the following FORM tag for METHOD="POST":

<form method="post" action=”http://your.server.name/f”>

If the Post method is used (recommended), make sure that the username input tag is called “username” and that the password input tag is called “password”. If you want to redirect the user on a failed login attempt you can do the following:

Using DSSnoop, add the following value to the “Novonyx:Configuration” attribute of the Messaging Server Object that is running ModWeb: FormLoginRedirectURL=<url>

e.g.

FormLoginRedirectURL=http://your.server.name/ unauthorized.html

Q168:

How can I replace images in the web interface?

A168:

This can be accomplished by editing the template sources in the unsupp directory. This is unsupported but there is some documentation that we have included to help you out.

Character Sets

Q169:

What character set does NetMail send in?

A169:

In NIMS 3.0, the user can select the character set they want messages to be sent out in. This is set in the preferences/options of the web interface. Also, a default character set can be selected on the Modular Web Agent for the NetMail system.

In NIMS 2.x all messages were sent out in UTF-8 only and there was no way to change this.

Q170:

Can a rule be created that contains extended/double byte characters?

A170:

No, NetMail will not accept rules that use extended characters. Also, if NetMail did accept and store these rules there would not be any guarantee that the rule would catch all e-mail that you expect. NetMail stores all data into DS as Unicode and then the stored data is compared to the messages to decide if a rule should be executed or not. So, unless the character set that the message is sent in matches what is stored, the rule will not execute.

Tools and Add-ons

Q171:

What is the PlusPack?

A171:

The PlusPack provides:
  • Automatic signature adding
  • NDS Group-based blocking for sending
  • Big-Brother automatic message copying of outbound messages to a "monitoring user/folder"
The PlusPack operates *only* on outbound messages, it will not touch messages destined for local recipients; local is defined as members of the local NetMail cluster, this can be more than one server operating in distributed mode.

Q172:

How do I get the PlusPack?

A172:

Updated: 2 Mar 2004 - The NetMail 3.1 PlusPack is now available for download at: http://www.novell.com/coolsolutions/tools/1848.html.

Q174:

Is there a virus scanning solution for NIMS?

A174:

Yes, the NIMS 3.0.2 update added a virus scanning solution that integrates with McAfee NetShield, CA InoculateIT and Symantec CarrierScan. See the NIMS 3.0.2 README.

Q175:

How can I customize the “welcome” message for a list?

A175:

There is an attribute on every list object. It's called "NIMS:ListWelcomeMessage"

(MSGSRV_A_LIST_WELCOME_MESSAGE)

You can store your welcome message in that attribute and it will be sent instead of the message stored in \system\nls\4\imslist\welcome.la ($NIMSDIR/nls/4/imslist/welcome.la for our UNIX guys).

You need to store the whole message in a single value, including any CR/ LF(0x0d/0x0a) for new lines you want to have.

Of course, if you don't want a personalized message per list but just generally a different welcome message, just change the welcome.la file.

Q176:

Can I restrict who can send e-mail outside the NetMail system?

A176:

The PlusPack provides the ability to restrict who can send outbound e-mail.

Q177:

What utilities are available for NIMS?

A177:

All utilities are available at http://www.novell.com/coolsolutions/netmail/ downloadables.html under the download section.

Q178:

How can I integrate the NetMail address book with another e-mail system’s address book like GroupWise?

A178:

NetMail supports LDAP lookups from outside of the NetMail system so if the client in use supports configurable address lookup just pointing the client to the NetMail server would do the trick.

We also have a partnership with Concentrico (www.concentrico.net) that sells a product that will integrate address books of two systems together for both systems. Their solution is very cool and is worth taking a look at.

Q179:

Is there any content filtering solution for NIMS?

A179:

Currently there is no content filtering for NIMS; this is a feature that is on our list of potential future features for NIMS. There’s got to be a reason why we keep this AntiSpam-agent thingy around.

User Configuration

Q180:

I don’t want my user to have to set their time-zone on first use of the Modular Web Agent.

A180:

In NIMS 3.0.2 we added the ability to set the default time-zone on the Modular Web Agent. Simply set the proper time-zone on the NDS Object, and as long as a user hasn’t stored any preferences in NIMS 3 before the time-zone was set on the Modular Web Agent object, the default time-zone will be applied to the session settings.

Q181:

Can NetMail users forward messages to a cell phone/handy or pager?

A181:

Yes, if the cell-phone/handy or pager has an e-mail address NetMail can forward e-mails to that device’s e-mail address.

Q182:

Why do I get read only access to my mailbox (SID files)?

A182:

In NIMS 2.x only the first connection to the mailbox received read/write access, all other connections were read-only access. The first connection must be logged out or timed out in order to be able to get another read/write connection. In NIMS 3.x all connections are read/write so you will never have a read-only connection. (NIMS 3.0.2b changed the locking model to memory based locking so SID files are no longer created.)

Q183:

How do I create a sent items folder?

A183:

The sent items folder can be set up in the preferences/options of the web interface.

Q184:

Can personal groups be created in the web interface?

A184:

Yes. Creating a user and entering all addresses in the e-mail address field can create personal groups within the web interface. Commas, semi-colons, or spaces should separate the e-mail addresses entered in the e-mail address field.

Q185:

?Is there anyway to synchronize the NetMail Calendar and Address book with my Palm?

A185:

We are currently considering this as a potential enhancement.

Q186:

How can I set a default language for the web interface?

A186:

In the preferences/options of the Modular Web Agent every user has the option of setting their language. Also, starting in NIMS 3.0.2 it is possible to set a system wide default on the Modular Web Agent configuration dialog.

Q187:

Does NetMail support multiple calendars per user?

A187:

NetMail currently has the ability to support multiple calendars per user but we do not have an interface that supports multiple calendars yet. We hope to incorporate the needed interface changes in a future release.

Q188:

Is there any way to modify a calendar event?

A188:

Currently there is no way to modify calendar events. There are no set standards on how this should be done and because there are so many variations of who gets the updates and what should be done with the updates it is currently not possible. We would like to have this available but are waiting on the standards to be finalized.

Q189:

Is there a way to redirect the user to a different logout screen?

A189:

Yes, add the following value to the “Novonyx:Configuration” attribute of the Modular Web Agent: FormLogoutRedirectURL=<URL to redirect to>

Q190:

What ICal clients are available?

A190:

The known iCAL clients are as follows: Outlook 2002, Notes R5 (we only heard rumors about this), Entourage for the Mac. These clients support ICAL only to some degree; Outlook 2002 and Entourage only support appointments currently.

Q191:

Are user IDs case sensitive?

A191:

User IDs are not case sensitive.

Q192:

Does the change password option in Eudora sync with NIMS?

A192:

No, NetMail does not support this Eudora feature, it’s not based on any RFC standard.

Q193:

Is it possible to import address books from a file to a user?

A193:

Yes, a personal address book entry is a multi-value attribute on the Novonyx:Addressbook Users attribute. The format is as follows:

Attribute            Value
AA_ENTRY_ID          0
AA_EMAIL_ADDRESS     1
AA_FIRST_NAME        2
AA_LAST_NAME         3
AA_PHONE_1           4
AA_PHONE_TYPE_1      5
AA_PHONE_2           6
AA_PHONE_TYPE_2      7
AA_BIRTH_MONTH       8
AA_BIRTH_DAY         9
AA_BIRTH_YEAR        10
AA_COMMENT           11

These values are carriage return (CR) delimited.
Entry_Id is a unique id for this personal address book
Email_Address is the e-mail address of the user
First_Name is the first name of the entry
Last_Name is the last name of the entry
Phone_1 is the phone number of the entry
Phone_Type1 is a number, 0= work, 1= Home 2= Cell 3= Fax 4= Pager
Phone_2 is the phone number of the entry
Phone_Type2 is a number, 0= work, 1= Home 2= Cell 3= Fax 4= Pager
Birth_Month is the month number 1 through 12
Birth_Day is the day number 1 to 31
Birth Year is the four-digit year
Comment is any info in the comment field

Just remember that these values must be separated by a carriage return.
Depending on your import utility you may be able to import a group of entries
into the user database at once.


Q194:

Is there any way I can override the NDS Object name as the FROM Address in NIMS 3.0 for the Modular Web Agent?

A194:

You can use the reply-to address as usual. Any client replying will then send to the name specified in the reply-to field.

ModWeb starting with NIMS 3.0.2b will also use the “Internet E-mail Address” value to set the user’s e-mail address.

Q195:

How can I limit the NetMail address book to only search a user’s domain and not any other domain running on the system?

A195:

See “Is there an option for “authentication required” for the LDAP server queries?” on page 493. The USEBASEDN option will allow users to specify their domain as BaseDN in the LDAP client and the Address Book Agent will then filter the domains.

Features

Q196:

Does NetMail have a busy search feature for the calendar?

A196:

Currently NetMail does not have a busy search feature. Calendar Access Protocol (CAP) is the standard that is currently being worked on and will include the busy search functionality. Once CAP is complete, NetMail hopes to include the busy search functionality. Of course we’ve already got the stuff for this in NMAP, there’s just no interface for it available yet.

Q197:

What is the syntax for passing the user ID and password to NetMail in the URL to bypass the popup login box?

A197:

http://<userid>:<password>@domain An example of this would be a user named joe with the password of pass logging into test.com

http://joe:pass@test.com

Also see Q167: Is there any way to do a form-based login for NIMS?

Q198:

How can I get Groups and mailing lists to show in the address book?

A198:

Groups and mailing lists were left out of the NetMail Address Book Agent for security reasons. We did not want potential spammers to be able to see all of the groups and mailing lists that existed on your system, they could use information to send SPAM to your users. You can use a different LDAP server that you could configure to show groups and mailing lists but we cannot help you configure any other LDAP servers.

Q199:

Is there a spell checker for NetMail?

A199:

There is no spell checker for the Web interface of NIMS. There are third-party products that you could plug into the browser to give you the spell checker functionality.

Q200:

Is there the Save Drafts ability in the Modular Web Agent?

A200:

There is not. We do have this on our list of potential features for future releases.

Q201:

Can NetMail use NDS Group objects as mailing lists?

A201:

Yes. NetMail will deliver to NDS groups as if they were a user. A message sent to a group will be sent to all members of the group. Of course, this requires that the group members are NetMail users.

Also check out the NDS List functionality of the NetMail List Agent. For more information, see “Managing Mailing Lists” on page 245 in the NetMail Administration Guide.

Q202:

Can multiple NDS user objects be granted access to a common mailbox?

A202:

This is a feature being considered for a future version of NetMail.

Q203:

Does NetMail support “Shared folders”?

A203:

Yes, but there are two kinds of shared folders. One kind the user give others access to a folder and sets rights for the other users. The other type of shared folder, and the one that NetMail supports, allows multiple, simultaneous connections to a mailbox.

Q204:

What calendaring standard is being used for NetMail 3.x?

A204:

NetMail is using the ICAL standard, which is just a language to describe events. The RFCs that define ICAL are 2445, 2446, and 2447.

Q205:

Is there a “notification of new mail” product?

A205:

NetMail does not ship with a program to allow for notification of new mail but there are third party products that will do this.

“I use an NLM on the server... cheap program and it loads on the server with a windows application to setup the notification parameters.

Nothing has to be loaded on each workstation see http://www.netwarefiles.com/mail.htm

The program is Advanced Mailbox Scanner (1st one on the list)” (Thanks to Paul Johnson for providing this information)

Q206:

Is there any way to block types of attachments?

A206:

There is nothing currently in NetMail to block certain types of attachments. This is on our list of potential features in the future.

Q207:

How does NetMail use the AntiSpam agent to block e-mails?

A207:

The Anti-Spam agent blocks e-mail based on the “From” address in the envelope of the message. When the AntiSpam Agent was created that was a relatively easy and secure method to block SPAM, however, over the last couple of years the growing sophistication of spammers has rendered this method useless, since the envelope data can easily be forged. We are keeping the AntiSpam Agent around, though, because that’s where we’d like to add future content blocking functionality.

For more information, see “AntiSpam Agent” on page 193 in the NetMail Administration Guide.

Q208:

Does NetMail support SSL for the address book?

A208:

No. NetMail does not currently support SSL with the Address Book Agent. We do support password authentication as an option that can be turned on. See Q126: Is there an option for “authentication required” for the LDAP server queries?

SSL support for the Address Book Agent is being considered for a future release.

Q209:

Messages moved between IMAP folders don’t seem to keep their status flags.

A209:

This only applies to NIMS 2.x; in NIMS 3.x this has been fixed.

Q210:

Is WAP available for NetMail?

A210:

WAP support is available in NetMail 3.5.

Q211:

Can messages be addressed to an OU?

A211:

No, messages cannot be addressed to an OU. NetMail only supports users, groups and organizational roles as directly addressable NDS objects. This is done on purpose, to prevent accidental or intentional spamming of an organization. In order to provide such functionality, NDS Lists have been added to the List Agent.

Q212:

What files does the “mail queue” command check?

A212:

The “mail queue” command that can be issued at a NetWare console prompt will only check mail entries in the remote queue (files with a 007 extension) for which delivery has been attempted at least once.

Q213:

In what order are the UBE (Unsolicited Bulk E-mail, SPAM) settings checked?

A213:

Steps 1-5 are performed upon connection request, right after accepting the connection

  1. Is connection from address in blocked list?
         1a Yes -> Close connection
         1b No -> Continue with check #2
  2. Is connection from an address that just authenticated via POP or IMAP (SMTP-after-POP)?
         2a Yes -> Connection "trusted", ignore checks #3 & #4
         2b No -> Connection "not trusted", continue with check #3
  3. Is connection from an address in allowed list?
         3a Yes -> Connection "trusted", ignore check #4
         3b No -> Connection "not trusted" (yet)
  4. Is connection from address that is known to any configured RBL lists?
         4a Yes -> close connection
         4b No -> Connection "not trusted" (yet), continue with check #5
  5. Does address have a reverse entry in DNS
         5a Yes -> continue with check #5
         5b No -> Close connection

    The connection is now allowed to issue regular SMTP commands

  6. AUTH command is received and successfully authenticated -> Connection "trusted"
  7. RCPT TO is received
         7a If connection is trusted, all (local & remote) addresses are allowed
    7b If connection is not trusted, only local recipients and addresses to domains listed in the "Relayed Domains" are accepted.

Q214:

Does or can NetMail use the /etc/hosts or the /etc/resolv.cfg (/etc/ resolve.conf) file?

A214:

NetMail will ignore all settings in the hosts and resolver configuration files on all platforms. We do this because we have extremely fast lookup code that can query the DNS server much faster than any library on any of those systems.

List Agent

Q215:

How can the archives of a mailing list be accessed?

A215:

If a message is sent to listserv@yourdomain.com with “info” in the body of the message the List Agent will return a message with all commands that can be used to search.

Q216:

How does a moderator subscribe multiple users to a mailing list?

A216:

  • As the moderator, try to add a user to the list. The command is: (sent to listserv@your.domain) ADD list_name emailaddress [fullname] PW=<password> The PW is the password set on the list.
  • You will have to set the moderator's password before you do this. According to the manual, the syntax is: PW <ListName> [Add | Change] <NewPassword> [PW=<OldPassword>]

    Where the first password is the old password and the new password is the second password. Refer to “Managing Mailing Lists” on page 245 in the NetMail Administration Guide for more information.

Q217:

Can List Agent commands be localized?

A217:

While you can do that, it's not "supported". Check system\nls\4\imslist. It is strongly recommend against translating the commands themselves, since you will severely limit the users. The listserv language NetMail support is pretty common, and translating the commands means users have to learn new commands. The commands would need to be in UTF-8 encoding.

Q218:

Can the reply to for a list be set to the list rather than the sender?

A218:

Yes, on the list object there is a option to set the “Reply-To: to list”, once this option is selected on the list the reply-to address will now be the list. We strongly recommend against this setting, however, since any auto-replies from subscribers will then go to the list. NIMS’ AutoReply Agent will NOT reply to list messages, since it scans for “Precedence: bulk” and does not reply if the header line is present. All list messages generate this header line.

Q219:

Is it possible to create an “announcement-only” list?

A219:

Yes. If the option on the list under Postings “By Moderator Only” is set, only the moderator of the list can send messages to the list.

Upgrading

Q220:

How do I upgrade from NIMS 2.6 to NIMS 3.0?

A220:

Run the install from the NetMail directory and choose to upgrade, it is important that you run the SCMS move program correctly during the upgrade to insure that all SCMS messages are seen by the users after the upgrade. The SCMS directory format has been changed from NIMS 2.6x to NIMS 3.0.

Q221:

Can I upgrade NIMS 2.1 to NIMS 3.0?

A221:

Technically this can be done but it has not been tested since NIMS 2.1 is no longer supported. We know of several customers who did this, also, Novell’s DigitalMe service successfully upgraded from NIMS 2.1 to NIMS 3.0.2b without problems.

Q222:

What is the supported upgrade path to NIMS 3.0?

A222:

The supported upgrade path to NIMS 3.0 is from NIMS 2.6x only. Updates from NIMS 2.5x to NIMS 2.6x can be found at http://www.novell.com/ coolsolutions/netmail/downloadables.html.

Q223:

How can I upgrade from an evaluation copy of NIMS 3.0 to a licensed version?

A223:

By buying the licensed version and then copying the nims.nlf license file into the directory that contains the NetMail binaries. (Netware: sys:system, Linux: /usr/local/nims/bin, Solaris: /opt/NOVLnims/bin)

Q224:

How can I move NetMail to another server?

A224:

By assigning another NCP server object to the NetMail Messaging Server object and by copying all related data (Spool and user mailstore) to the new server. Remember to delete the qclients file if you are also copying the DBF directory, since your new servers’ IP address will be different.

Q225:

How can I move user data from Solaris to Netware or Linux or the other way?

A225:

NetWare and Linux both run on Intel processors. Solaris runs on Sparc processors. Intel and Sparc processors represent data in a different way (Big Endian vs. Little Endian). NetMail index files are processor-specific and cannot be exchanged between Solaris and Intel machines. However, all mailboxes and spool files can easily be copied between the two platforms.

Data can be moved between NetWare and Linux (and Windows, when available) without problem.

Tools and where to get them

Q226:

NDS Tools to set or get attributes

A226:

JRBUtils
JRB Software has a whole suite of tools. Two tools of the suite, setname and getname, can be used to store and retrieve attributes in NDS.
For more information, go to http://www.jrbsoftware.com

DSSnoop
DSSnoop was created by someone in Novell’s support organization (we’d love to mention the name, but we don’t know the author)
Download from www.novell.com/coolsolutions/tools#ndssnoop

SetAttr
SetAttr was created by the NetMail team mostly for internal purposes. It’s not very polished, but it’s quite powerful in setting DS attributes.
Download from http://www.novell.com/coolsolutions/ netmail/downloadables.html

Q227:

How to find out whether your SMTP server can exchange mail with another SMTP server

A227:

On NetWare, you can use MXTrace to perform this task. It uses the actual NetMail lookup routines to simulate delivery.

Download MXTrace from http://www.novell.com/coolsolutions/netmail/downloadables.html.

Secrets and not-so secrets

Q228:

Are there any configuration items you guys aren’t telling us?

A228:

Sure. Whenever you write code and implement a certain feature, you use configurable defaults in order to be able to easily change those constants later if requirements change. Or there’s a situation where something cool can be done, but it would confuse 95% of the user population.

In such cases, we add the ability to read the configuration option from NDS, but don’t add the ability to set it with our admin tools. Not to be mean to you, but to prevent us from going nuts because everyone fiddles with it and then comes complaining to the forum that their NetMail is “kaputt.”

So, here’s a list of all modules & attributes. Note that they’re not all secret. It’s the (almost) complete list of all of them. You decide what we hid from you. Oh, and if you mess it up you’re on your own! Don’t go and complain that “something just stopped working.” We will find out!

MSGSRV.NLM
Novonyx:Context
Novonyx:Official Name
Novonyx:Postmaster
NIMS:NLSDirectory
NIMS:BinDirectory
NIMS:DBFDirectory
Novonyx:Work Directory
Novonyx:Server Standalone

Novonyx:Configuration

NIMS:PKeyFile
NIMS:CAFile
NIMS:ConnMgr Config
<dn>
<domain>
<dn>
<path>
<path>
<path>
<path>
1
0
Clustered
Bind:Specified Address
<path>
<path>
1
Contexts to support
Official Domain
Postmaster object
NLS location
NetMail binaries location
Path for database files
Path for temp files
Distributed system off
Distributed system on
Prevent writing the current IP address to DS
Bind to the address stored in Novonyx:IP Address
Path & name of private key .pem file
Path & name of certificate .pem file
Connection Manager enabled

MSGALIAS.NLM
Novonyx:Time Interval


Novonyx:Alias Options
<number> or S<number>

<number>

How often to regenerate the database
If starts with ‘S’ in seconds, otherwise days

Add the numbers together to get the value to store. If you don’t know what 1<<0 means you shouldn’t try to mess with the attributes.
  (1<<0)
(1<<1)
(1<<2)
(1<<3)
(1<<4)
(1<<5)
(1<<6)
(1<<7)
(1<<8)
(1<<9)
(1<<10)
(1<<11)
(1<<12)
(1<<13)
(1<<14)
LDAP_SERVER_ON
LDIF_EXPORT_ON
ALIAS_AUTOMATIC
ALIAS_FIRST_LAST
ALIAS_FLASTNAME
ALIAS_FIRST_D_LAST
ALIAS_FULL_DOT
ALIAS_FULL_UNDER
ALIAS_AUTO_POPULATE
POPULATE_DEFAULT
POPULATE_FIRST_LAST
POPULATE_FLASTNAME
POPULATE_FIRST_D_LAST
POPULATE_FULL_DOT
POPULATE_FULL_UNDER

ANTISPAM.NLM
Novonyx:Action


Novonyx:Email address
<number>
(1<<0)
(1<<1)
<multi-value list>

Return to sender
CC Postmaster
Who to block
AVIRUS.NLM
Novonyx:Configuration Settings:<number> (1<<0)
(1<<1)
(1<<2)
(1<<3)
(1<<4)
(1<<5)
Patternfile:<path>
CarrierHost:<hostname>
CarrierPort:<portname>

AV_USE_CA
AV_USE_MCAFEE
AV_USE_SYMANTEC
AV_NOTIFY_USER
AV_NOTIFY_SENDER
AV_SCAN_INCOMING
Path to pattern files
Name of Symantec host
Port at Symantec host

FORWARD.NLM
Novonyx:Autoreply message <text> The default autoreply message if user’s is empty

GKEEPER.NLM
Novonyx:Configuration NameSupport
NoNameSupport
Default, Enable storing names with addresses
Disable storing names with addresses

IMSLIST.NLM
NIMS:ListDigestTime
NIMS:ListserverName
Novonyx:Language
<0-23>
<name>
<Lang-ID>
Hour when to generate digest
Name listserv should react to (usually listserv)
Default language for list responses

MSGLDAP.NLM
Novonyx:Time Interval

<number> or S<number>
How often to regenerate the database
If starts with ‘S’ in seconds, otherwise days
Novonyx:LDAP Options <number>
(1<<0)
(1<<1)
(1<<2)
(1<<3)
(1<<4)
(1<<5)

LDAP_SERVER_ON
LDIF_EXPORT_ON
LDAP_REQUIRE_BASEDN
LDAP_REQUIRE_AUTHENTICATION
LDAP_USE_USERS_BASEDN
LDAP_SEARCH_PERSONAL
Novonyx:Port
Novonyx:SSL Port
<number>
<number>
Port to bind to
Port to support SSL on

MODWEBD.NLM
Novonyx:Port
Novonyx:SSL Port
Novonyx:Language
NIMS:Timezone
Novonyx:Configuration
<number>
<number>
<lang-id>
<0-74>
FormLoginRedirectURL= <url>
FormLogoutRedirectURL =<url>
Logo=<number>
Port to bind to
Port to support SSL on
Default language
Default Timezone ID
URL to redirect to if root of modweb is hit. Prevents popup login box. Use only if no public template avail.
URL to redirect to when user clicks logout
Default logo to use
NIMS:Title <text> Title to display as window titles

MODWEBD.NLM, read from User/Parent object on login:
NIMS:Timezone
NIMS:Locale
<0-74>
DS:<DateFormatShort>
DL:<DateFormatLong>
T:<TimeFormat>
WDS:<0-6>
User Timezone ID
Short Date Format
Long Date Format
Time Format
Week starts on 0=Sunday, 6=Saturday
Format strings for Date & Time strings: %a
%A
%b
%B
%d
%H
%I
%j
%m
%M
%n
%p
%r
%S
%t
%T
%U
%w
%y
%Y
%Z
Locales abbreviated weekday name
Locales full weekday name
Locales abbreviated month name
Locales full month name
Day of month (01-31)
Hour (24 hour) 00-23
Hour (12 hour) 01-12
Day of the year
Month as decimal number (01-12)
Minute as decimal number (00-59)
Newline character
Locale equivalent of either am or pm
12 hour time representation hh:mm:ss [am/ pm]
Second as decimal number (00-59)
Tab character
24 hour time representation HH:MM:SS
Week number of the year
Weekday as decimal number; 0=sunday
Year without century
Year with century as decimal number
Timezone offset from UTC (+/- 0000)
NIMS:Title
NIMS:Default Charset
Novonyx:Preferences
<Title>
<charset>
ModWeb:MsgPerPage=<num>
ModWeb:Logo=<num>
Title string to display for user
Charset name for user
Messages per page
Logo ID
Novonyx:Color
Page: <fg> <bg>
Border: <fg> <bg>
Section: <fg> <bg>
Fieldname: <fg> <bg>
Fieldbody: <fg> <bg>
Colors, hex values

NMAPD.NLM
Novonyx:NMAP Trusted Hosts


Novonyx:Minimum Space
Novonyx:UID
Novonyx:Queue Timeout
Novonyx:Queue Interval
Novonyx:SCMS Size Threshold
Novonyx:SCMS User Threshold
Novonyx:Quota Message
Novonyx:Quota Warning
Novonyx:Use Quota
<multi-value list>

<ip-address>
<Kbytes>
<uid>
<days>
<minutes>
<Kbytes>
<number>
<text>
<text>
<number>


Trusted host
Space to keep on disk
Next UID to use
Max age of queue entries
Queue retry interval
SCMS minimum size
SCMS minimum user count
Quota full message
Quota 90% full message
0 = no
1=User
2=System
3=User+System Quota
Novonyx:Quota Value
NIMS:RTS Antispam Config


NIMS:SpoolDirectory
NIMS:SCMS Directory
Novonyx:Message Store
Novonyx:RTS Handling
<bytes>
Enabled:%d
Delay:%ld
Threshold:%lu
<path>
<path>
<path>
<number>
System Quota



Spooldir path
SCMS path
Path to default user message store
0 = off
1=bounce back
2=cc postmaster
3=both
Novonyx:Queue Tuning Concurrent: %ld
Sequential: %ld
Load high: %ld
Load Low: %ld
Queue Trigger: %ld
Interval: %ld
Debug %ld
 
Novonyx:Forward Undeliverable <address> FUD address

MAILPROX.NLM
Novonyx:Time Interval
Novonyx:Thread Limit
Novonyx:Maximum Items


Novonyx:NMAP Server
Novonyx:NMAP Queue Server
<hours> or S<seconds> <number>
<0-3>


<dn>
<dn>
How often to run
How many threads to create
How many proxy entries per user
Important: Setting this higher than three will adversely affect your system performance.

DNs of NMAP servers to read contexts to be supported from
NMAP server to drop new items off to

RULESRV.NLM
Novonyx:Configuration <multi-value>
<rules>

System wide rules (don’t mess with this, there’s a bug that might prevent rules from running if you try to enable system rules)

SMTPD.NLM
Novonyx:Domain

Novonyx:User Domain

NIMS:Relay Domain

NIMS:Blocked Address

NIMS:Allowed Address
<multi-value>
<domains>
<multi-value>
<domains>
<multi-value>
<domains>
<multi-value>
<addrfrom>-<addrto>
<multi-value>
<addrfrom>-<addrto>

Global Domains

Hosted Domains

Relayed Domains

Blocked range

Allowed range
NIMS:UBE Configuration <number>
(1<<0)
(1<<1)
(1<<2)
(1<<3)
(1<<4)
(1<<5)
(1<<6)
UBE switches
UBE_CHECK_ALLOWED
UBE_CHECK_BLOCKED
UBE_CHECK_REVERSE
UBE_REMOTE_AUTH_ONLY
UBE_USE_RBL
UBE_SMTP_AFTER_POP
UBE_NO_REVERSE_AUTH
NIMS:Recipient Limit
NIMS:RBL Host

Novonyx:Message Limit
Novonyx:NMAP Queue Server
Novonyx:RelayHost
NIMS:RTS Antispam Config
<number>
<multi-value>
<hostname>
<MByte>
<dn>
<hostname>
Enabled:%d
Delay:%ld
Threshhold:%lu
Max RCPT TO lines allowed

RBL hosts to check against
Maximum size of accepted messages
NMAP to queue to
Host to forward *all* message to

NWMAIL.NLM
NIMS:Recipient Limit
Novonyx:Message Limit
<number>
<MByte>
Maximum recipients allowed
Maximum message size

NWCAL.NLM
NIMS:Recipient Limit <number> Maximum recipients allowed

NWPREF.NLM
Novonyx:Configuration
NIMS:PasswordConfig
<number>
<number>

bit 0=allow password
bit 1=require SSL

RULESRV.NLM read from user object
NIMS:Rule <multi-value> <rule>
Rule according to rulesrv.h

FORWARD.NLM read from user object
Novonyx:Forwarding Enabled



Novonyx:Autoreply Enabled


Novonyx:Forwarding Address

Novonyx:Autoreply Message
<0-2>



<0-1>


<multi-value>
<address>
<text>
0=disabled
1=forward
2=forward & keep copy

0=disabled
1=enabled


Address to forward to
Text to autoreply with

Read from USER, GROUP and ORGANIZATIONAL ROLE objects
Novonyx:Messaging Disabled 1 Not recognized as object

Q229:

How does inheritance work on parent objects?

A229:

Here's the logic:
  1. Have the user DN; we check if there's a parent DN (=inheritance DN)
  2. If we have inheritance DN, get the inheritance config of parent, else go to step 4c

  3.      3a Inheritance is Parent->User; read features attribute from parent
         3b Inheritance is User->Parent; read features attribute from user

  4.      4a If feature disabled return disabled state
         4b If feature from parent, read parent data attribute
         4c If feature from user, read user data attribute
  5. If data attribute empty, try opposite DN attribute


Q230:

How are the inheritance configuration and feature sets stored in NDS?

A230:

Three attributes are used, “NIMS:FeatureSet”, “NIMS:FeatureInheritance” and “NIMS:ParentObject”.

NIMS:FeatureInheritance is stored only on the parent object and defines, if the NIMS:FeatureSet attribute is first to be read from the user object or from the parent object.

It’s possible values are “O” for User First and “P” for Parent First. Then the NIMS:FeatureSet attribute is retrieved from the appropriate object. The FeatureSet attribute is a multi-value attribute that defines a matrix of features.

A feature is defined a value for row and column. For example, the IMAP feature is defined as row “A” and column “1”. The attribute by default looks like this:
AUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
BUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
CUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
DUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
EUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
The first letter designates the row, the letters after the row designator are the columns used by the feature indicators.

A “U” or “P” indicates to read an attribute from the user object if the feature set has been read from the parent, and vice versa. A “0” indicates the feature is not available, a “1” indicates the feature is available.

Here’s the list of defined features, as of NIMS 3.0.2:
Feature                         Row                          Column
IMAP                            A                            1
POP                             A                            2
Address Book                    A                            3
Proxy                           A                            4
Forward                         A                            5
AutoReply                       A                            6
Rules                           A                            7
Finger                          A                            8
SMTP Send count Limit           A                            9
SMTP Send Size Limit            A                            10
NMAP Quota                      A                            11
NMAP Store                      A                            12
WebMail                         A                            13
ModWeb                          A                            14
MWMail Address Book Private     A                            15
MWMail Address Book System      A                            16
MWMail Address Book Public      A                            17
ModWeb WAP Access               A                            18
Calendar Agent                  A                            19
Calendar                        A                            20
AntiVirus                       A                            21

If IMAP and AntiVirus are disabled, and ModWeb enabled, the attribute would look like this:

A0UUUUUUUUUUUU1UUUUUU0UUUUUUUUUUUUUUUUUUU
BUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
CUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
DUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
EUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU

If the same attribute was stored on the user object with the following settings:

AUUUUUUUUUUUUUUUUU1U0UUUUUUUUUUUUUUUUUUUU
BUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
CUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
DUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU
EUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU

Based on those two attributes and assuming that inheritance is Parent->User, the user would be able to use all features but IMAP and AntiVirus based on the features from the parent object. For looking up if Calendar is enabled, NetMail would fallback to the user object (since there’s “U” in the parent object for the feature) and find a “0” in the Calendar position. This would also disable the Calendar feature. In the WAP position on the user object is a “1” which enables the feature.

Combining all the results from above calculations, the end-result would be that the user cannot use IMAP, AntiVirus and any Calendar features. All other features could be used, since there’s no explicit “0” stored anywhere else. NetMail always defaults to On if not explicitly disabled, for backwards compatibility.

There’s two types of lookup NetMail does through this logic: 1) To determine if a feature is enabled or disabled. 2) To read an attribute (e.g. Novonyx:Forwarding Enabled)

When using the logic to read an attribute, it is possible, through inheritance, to redirect the lookup of the feature to the parent object. All NDS lookups in all NetMail agents go through this logic every time an attribute is read from a user object. The configuration interfaces for NetMail (NWAdmin/WebAdmin) do not provide full access to this logic for all attributes to prevent misconfiguration nightmares. However, it is possible to set those values with other tools to archive some desired results.

Now, if you managed to read this whole section, congratulations! It’s a brain teaser, even for us on the team. The best way to learn how it works is to have a test server, set a few values through the admin interfaces and then use DSSnoop or a similar tool to look at the attribute values and what’s changed. The coolest thing is, it only takes about 40 lines of code to implement the inheritance and attribute reading, but it took two full pages to try to describe it.

Q231:

What command-line switches exist for the various components of NetMail?

A231:

In general, if a program supports command-line switches, it will always support the “-h” and “-?” switch to find out it’s usage.

The only “undocumented” two switches are for nmapd, since usually it is auto-loaded by MSGSRV and no switches can be passed in.

The first option is “recover”, MSGSRV.NLM will automatically pass this argument to *all* agents if it detects that NetMail was not shut down properly last time. NMAP will do a full queue integrity check if it is loaded with “recover” as argument.

The second argument is “showload” and it will cause NMAP to display a rudimentary screen showing load trends. Use with caution.