Getting started with NetTen 1.4


Introduction

What follows is a walkthrough of a typical installation and initial configuration of NetTen. Though installing and configuring Tenon products is usually straightforward, NetTen often uses terminology familiar to those who have mail server background; other users may need additional assistance. That is what this document provides.

Installation and initial configuration

NetTen 1.4 can be easily installed by running the installer program. Once NetTen is installed, it can be launched and configured. Once NetTen is up and running, it is then time to set a postmaster password for NetTen. Once the Postmaster account has been set up, it will allow you to manage mail accounts, and have access to NetTen's mail configuration features.

To set the NetTen Postmaster password, select "Set Post Master" from the "Post.Office" menu in the NetTen application. A window will open that asks whether any information should be changed. At this prompt type "yes." Enter a Postmaster password. This password must be six characters or longer. If you type in a password that is too short, NetTen will prompt you to enter another one.

NetTen will then display something similar to the following: "Access Domains: [tenon.com]". It should display the domain that is present in the TCP/IP control panel. You can add additional domains that you would like to have access to the Postmaster configuration options by typing them here. If I wanted "tenon.com" and "tenontest.com" to each be accessible by the HTML-based Postmaster interface, I would type "tenon.com tenontest.com". If you only type one domain, that is the domain that will be set Š it will not append domains to the current list. It is ok if you choose not to enter additional domains here. You can always add them later by using the Postmaster configuration screens.

Using the configuration utilities

ITo access the Post Office configuration, type "http://my.domain/netten_admin/". The Post Office configuration server lives on port 82. A shortcut is "http://my.domain:82" which can be accessed after you have used "netten_admin" at least once.

Creating new mail accounts

To set up new mail accounts, first log into the Postmaster configuration system. Access the Postmaster login as mentioned above and enter the username Postmaster on to the hostname of your machine. It should look something like this: "Postmaster@quwi.tenon.com." Enter your password and click the "Authenticate" button. If the server refuses to authenticate your login, there are three possibilities:

  1. Incorrect password.
  2. The domain that you are trying to access the Postmaster configuration from is not listed in the domains that are allowed access (see instructions above for adding this).
  3. The machine that you are trying to access the Postmaster configuration from does not have a forward and reverse DNS entry. This can be verified by using the Macintosh program "Whatroute" or any Unix "nslookup" command.

Once access has been granted to the Postoffice administration server, click the "New Account" link. The account creation page allows the user to enter the full name, username, password, and other information pertaining to an e-mail account. If both an IMAP and POP account is desired, check both check boxes; otherwise, check the one that is applicable to your configuration. The "Access Domains" section allows specification of domains from which the user of the account can modify his account information. Once the applicable fields are filled in, click the "Submit" button, and the accounts will be created and are accessible immediately.

Notice that in both the NetTen Postmaster configuration (accessible by referencing port 82) and in the NetTen Home page (the accessible by referencing /NetTen/), online help is available. It can be seen from the above example that creating a mail account is relatively easy. More advanced features of NetTen like mail filtering and SMTP aliases can also be accessed from the Postmaster configuration page.

Adding mail filters

Adding mail filters in NetTen, while not difficult, is not an obvious procedure. From the main Postmaster configuration page, choose the "SMTP Filters Form." On this form, there are three entry boxes labeled "Source," "Destination," and "Subject." In order to create a filter, you must delete the word in the entry box and enter what should be filtered. For example, if you wanted to filter mail that included the words "yellow" and "green" in the subject, enter "*yellow* into the subject field (after deleting the word "Subject"), and click submit. Repeat these steps for "green" or any other filter that you wish to add. It is also optional to send the mail to another user instead of simply deleting it. This is accomplished by changing the "Action" button from "Discard" to "Mail to:".

Mail forwarding and aliases

Mail can be forwarded simply by adding the address that the mail is to be forwarded to in the configuration screen for each userÕs account. Mail that comes from outside sources to a certain machine can be forwarded to an entirely different machine. This is known as SMTP Aliasing. This is done by choosing the SMTP Aliasing form from the Postoffice configuration page. The syntax for adding aliases is given on this page and is relatively straightforward. One reason to use aliases would be to direct mail that looks like the following: "user@my.domain" to "user@host.my.domain". Here at Tenon, we use this to direct mail to our mailing list "webten@tenon.com" to our mail list server machine, mawby. Our SMTP alias looks as follows:

<webten@tenon.com> <webten@mawby.tenon.com>

The syntax and use of this command, as can be seen in the example above is relatively straightforward.

Conclusion

At Tenon, we sincerely hope that your first experience with NetTen has been a pleasant one and that you were able to exploit the powerful capabilities of our software. If you had difficulties with installation, configuration, or experienced usability issues with our software, please feel free to e-mail us at support@tenon.com. or call us at 800 662-2410.