Copyright: IMAIL Copyright © 1995- 97 Ipswitch Inc.
Citation: IMAIL Copyright © 1995-97 Ipswitch Inc.


INDEX
IMail User Manager

 What is IMail User Manager?

 Main Screen

 User Properties

 Information Manager

 Vacation Processing

 Delivery Rules

 Finger Plan

 LDAP Directory Information

 Alias Properties

 Backup and Restore IMail Database

 Importing NT Users

Regist32 is a Copyright 1995-97 of Ipswitch, Inc. and is designed to be used with the IMail Server for Windows NT by the system administrator on the console of the server.


IMail User Manager Description
What is IMail User Manager?

This utility program lets the system administrator add, delete and modify users; change their passwords; change inbound mail processing rules for users; set up vacation processing; set up mail forwarding, set up an automated response, enter LDAP directory information, and update the user's PLAN file that is distributed by Finger. The system administrator can also add, delete or modify system aliases.

IMail User Manager supports multiple domains on the IMail Server system, allowing you to create a different virtual host to represent each e-mail domain.

The companion program, IMail remote user utility (IMUTIL), is designed to be distributed to any users, regardless of client. The functions in the remote user utility match those in the IMail User Manager (regist32) with a few exceptions. A user cannot change their name, userid or other user properties. They can change their password and enable mail forwarding.  IMUTIL is a 16-bit application and can be used on the Windows NT host as well as on any Winsock 1.1 compliant network stack. IMUTIL may be distributed without additional fee to any user. System administrators that wish to limit these functions, do not need to distribute the IMUTIL program.


IMail User Manager Main Screen
IMail User Manager - Main Screen

When REGIST32 is invoked, you (the system administrator) are presented with the User Registration window, which shows all registered IMail users. From this screen you can add new users, modify user properties and delete users. If you click the Aliases button, the window shows all registered system aliases. You can add new aliases, modify alias properties and to delete aliases.

If you set up your IMail Server system to support multiple domains through virtual hosts, you must select the virtual host you want to use before making any changes to user mail accounts or system aliases.

Each of the features of the IMail User Manager are available by selecting from the menu or by clicking on a button.

To add a new user, either select Users->New from the menu or press the New button above the Users window. To edit (or delete) a user's properties, select the user name from the list of users and select Users->Modify (or Users->Delete) from the menu or press the Modify (or Delete) button. You can also select the menu item (or press the button) when no user is selected and you will be prompted for the userid of the user that you wish to modify (or delete). You can also modify a user's properties by double-clicking on the user line.

To view system aliases, click the Aliases button.

To add a new alias, either select Aliases->New from the menu or press the New button above the Aliases window. To edit (or delete) an alias's properties, select the alias name from the list of alias and select Aliases->Modify (or Aliases->Delete) from the menu or press the Modify (or Delete) button. You can also select the menu item (or press the button) when no alias is selected and you will be prompted for the alias that you wish to modify (or delete).  You can also modify an alias's properties by double-clicking on the alias line.


Multiple_Domains
Multiple Domain Support (Virtual Hosts)

To receive mail for more than one e-mail domain on the same Windows NT system, you can set up a virtual host for each domain. For example, if your mail server provides mail service for your local e-mail domain, mail.ipswitch.com, and you also want it to provide mail service for another e-mail domain, mail.acme.com, you need to create a virtual host for mail.acme.com.

Each virtual host must have a unique IP address. You can use either a real IP address or a virtual IP address. To use a real IP address, the IP address must be set in the the Control Panel's Network applet, under Protocols->TCP/IP Advanced properties. You can add up to five IP addresses in the Network applet. If you need to add more than five, refer to the documentation for the Windows NT Resource Kit.

A virtual IP address can be assigned to the domain (virtual host) by the IMail Server system. This allows you to have a virtual host without an IP address. You can then use an MX record in your DNS to point the virtual domain to an actual IP address.

If you use a virtual IP address for a mail domain, users must log in to mail accounts in the domain by specifying their userid in their mail client as: userid@virtualhost, where userid is the userid and virtualhost is the domain name, and entering their password. If you use an IP address that is set up on your IMail Server system, this method of login is not necessary.

Note: Whether you use a real IP address or a virtual IP address, you need to make the proper DNS entries for your mail domain(s). If you use a virtual IP address, the MX record (in DNS) for the domain should point to a real IP address. See your DNS documentation for information on creating these entries.

You set up virtual hosts by using the IMail Server application in the Control Panel.


User Properties
IMail User Manager - User Properties

The user properties dialog provides you the means to modify a users name, their user directory, password, vacation file, plan file, mail delivery rules and set options for the account.

Note: You can set the some of these options to apply to all users in the domain by selecting File->Global User Properties and setting the option in the dialog box. Options that can be set globally include Max Mailbox Size, Max Messages, User Cannot Change Password, Account Disabled (POP Access), Disable Finger Info. Any options set in the User Properties dialog box will override the global setting.

UserID

The name you entered for the userid when the mail account was created.

Full Name

The user's full name.

User Directory

Shows the directory where the user account information is stored. You cannot edit this field.

Password

The password the user will use to log on to the mail account. You confirm the password entered here by entering it again in the Confirm Password text box.

Forward

Allows you to automatically send all of a users mail to a different userid on the same or a different host.  (see Forwarding Mail )

Max Mailbox Size

The maximum size (in bytes) for each mailbox created in the user's mail account. If a mailbox exceeds the maximum, any new mail for the mailbox is returned to the sender.

Max Messages

The maximum number of messages (the total for all mailboxes created in the user's mail account). If the maximum is exceeded, any new mail for the user is returned to the sender.

Current Size

The current size (in bytes) of the Main mailbox.

Current Msgs

The current total of all messages in all mailboxes in the user's account.

User Cannot Change Password

This option controls whether or not the user can change their password remotely by using the IMail User Utility or the Web Remote Administration utility.

POP3 Access Disabled

Prohibit the user from accessing the account remotely through POP3 without changing their password or removing them from the system.

Disable Finger and Whois Info

Allows you to disable the distribution of any information about this user through Finger if you have the Finger server running and through Whois if you have the Whois server running.

Allow Web Access

Allows this user access to their account via the Web remote administration utility (provided the utility is configured).

Host Administrator

Allows this user to add, modify, or delete users in their current domain by using IRADMIN or the Web Remote Administration utility. To use the Web utility, Allow Web Access must also be selected.

IMail System Administrator

Allows this user to start and stop services and configure service monitoring from the IRADMIN or Web Remote Administration utilities. To use the Web utility, Allow Web Access must also be selected.

Information Manager

Edit Vacation

Edit Rules

Edit Plan


Forwarding Mail
IMail User Manager - Forwarding Mail

You can cause IMail Server for Windows NT to automatically forward a users mail to another account or system by entering a complete mail address in the Forward text box.

The address that you enter must be a complete mail address that is valid from the IMail Server for Windows NT host system. If you want to send the users mail to a different user on the same host, you only have to enter the simple userid.  If you want to send the user's mail to a different system, you must enter a complete mail address including the userid and the full domain name.  (userid@host.domain)

To turn mail forwarding off, ensure the text box is empty and press OK.

You can access the same mail forwarding function through the vacation feature.

Also a special forwarding for mail addressed to an alternate mailbox is allowed. To activate this, create a file named "alternate_mailbox.fwd" in the user's mail directory where "alternate_mailbox" is the name of the mailbox.

Forwarding is checked AFTER rules processing, info manager processing and vacation processing.


Mail Delivery Rules
IMail User Manager - Delivery Rules

You can create delivery rules to direct incoming mail to different mailboxes based on the contents of the From:, Subject:, and Sender: fields in the message header. The rules effect only incoming mail sent to the user's Main mailbox.

When you add delivery rules, IMail creates a rules.ima file in the user's home directory on the IMail Server for Windows NT host system. This file is read top down until a match is found. The rules.ima file is a text file that can be copied to any user's home directory.

To create a delivery rule:

1. In the User Properties dialog box, click Rules. The Mail Delivery Rules dialog box appears.

2. Click the Add button.

3. Select the Contains option to apply the rule to messages that contain the search string, or select Doesn't Contain to apply the rule to those that do not contain the search string.

4. Enter a search string in the text box below the Contains option.

Optionally, select the Match Case option. When this option is enabled, the search string must match the find string in both upper and lower case.

5. Select the header field (From, Subject, Sender) that you want to search.

6. Enter the name of the mailbox to which you want to route the messages that meet the rule criteria.

7. Click OK to save the rule.

The list box shows the new rule, along with any other rules you have created. See the Rule Syntax for information on the syntax used to define rules.

To delete a rule:

1. In the list box, select the rule you want to delete.

2. Click the Delete button.

Alternate mailboxes may be accessed by any POP3 client by appending the mailbox name at the end of the userid, following a hyphen.   (userid-mailbox)

You can have mail sent directly to an alternate mailbox by addressing mail to userid-mailbox@host.domain.  This is useful when registering on list servers, etc.  The default mailbox for a user is userid-main@host.domain.


rule_syntax
Syntax Rules for Mail Delivery

The syntax used to define rules in the rules.ima file specifies the search type, the search string, and the destination mailbox. When you create a rule in the Mail Delivery Rules dialog box, it is entered in the rules.ima file in this format. You can use the following rules for processing mail:

F=string:mailbox (Case sensitive match in From: header)

F~string:mailbox (Case insensitive match in From: header)

S=string:mailbox (Case sensitive match in Subject: header)

S~string:mailbox (Case insensitive match in Subject: header)

N=string:mailbox (Case sensitive match in Sender: header)

N~string:mailbox (Case insensitive match in Sender: header)

where string is the search string and mailbox is the destination mailbox.

Example rules.ima file:

F=ipswitch:internal (send mail from ipswitch to mailbox "internal")

N~53list:53list (send mail from 53listserver to mailbox "53list")

S~ftp:ftp (send mail with ftp in subject to "ftp" mailbox)

S~mail:mail (send mail with mail in subject to "mail" mailbox)


Vacation Processing
IMail User Manager - Vacation Processing

You can create a "vacation.ima" file in the users home directory on the IMail Server for Windows NT host system that will be mailed ONCE to each user that sends mail to the user.

The user's addresses that receive these messages will be listed in a "vacation.snt" file. The presence of the address in this file is what stops the sender from receiving a second message.

Vacation messages are not returned if the original message contains the "Precedence: bulk" header or contains "listserv" in the mail address.

To create a vacation message:

1. In the User Properties dialog box, click Vacation. The Vacation Message dialog box appears.

2. Enter the message that you want to send as a reply to mail while you (the user) are away.

When the vacation message is sent, IMail Server for Windows NT lists the e-mail address of the recipient in the vacation.snt file. The presence of the address in this file is what stops the sender from receiving a second message.

3. Select the Enable Vacation option.

When the you (the user) returns from vacation, you can disable the vacation message by making sure the Enable Vacation option is not checked.

4. Optionally, select the Delete old recipients option. If you do not select this option, the vacation message will not be sent to any users in the vacation.snt file. If you select the option, the vacation.snt file is deleted when you click OK, thus deleting the list of old recipients.

5. Optionally, enter a mail address to which IMail will forward your mail while you are away.

The address that you enter in this text box must be a complete mail address that is valid from the IMail Server for Windows NT host system. If you want to send the user's mail to a different user on the same host, you can enter the simple userid. If you want to send the user's mail to a different system, you must enter a complete mail address including the userid and the full domain name, for example: (userid@host.domain)

See also Forwarding Mail

6. Click OK.

When the vacation message is sent, IMail Server for Windows NT lists the e-mail address of the recipient in the vacation.snt file. The presence of the address in this file is what stops the sender from receiving a second message.

Vacation processing is checked AFTER rules processing and info manager processing.


Info Manager
IMail User Manager - Info Manager

The Info Manager allows you to set up an automated e-mail information system. When mail is received for a user that has enabled the Info Manager, a prepared message is sent back to the sender. This is different from the Vacation processing as a mail message is sent back each time mail is received even if the message has already been sent to the user.

You can set up the Info Manager to process mail sent to different mailboxes. A separate message can be set up for each of the user's mailboxes. For example, you may want to set up an "info" user account for your organization. When someone sends mail to the info account, the Info Manager can return a response that explains the subcategories of the info account in which they can obtain further information. They could then send a message to "info-sales" and receive back a different message relating to sales or to "info-classes" and receive back a message about classes you offer. There is no limit to the number of subcategories that you can set up in the Info Manager.

To create an automated response for a mail account:

1. In the User Properties dialog box, click Info Mgr. The Info Manager dialog box appears.

2. Create a new subarea or select an existing subarea to which the response message will apply.

The default subarea is main. The message you enter for this area will be returned to users' who send mail to the account but do not specify a mailbox. For example, if a user sends mail to info@ipswitch.com, they will receive the response entered for the main subcategory. If a user sends mail to the info-sales@ipswitch.com mailbox, they will receive the response entered for the sales subcategory of the info mail account.

3. Enter the message to be returned to all users who send mail to this subarea.

The first line of the body of  the message is used as the subject line for the automated response. It must be less than 80 characters long.

The response message is contained in the subcategory.inf file in the user's mail directory.

4. Select the Enable info manager for this subarea option.

To disable the automated response, make sure the Enable info manager for this subarea option is not checked.

5. Optionally, enter a mail address to which IMail will forward mail sent to the subarea (in addition to sending the response to the sender).

The address that you enter in this text box must be a complete mail address that is valid from the IMail Server for Windows NT host system. If you want to send the user's mail to a different user on the same host, you can enter the simple userid. If you want to send the user's mail to a different system, you must enter a complete mail address including the userid and the full domain name, for example: (userid@host.domain)

6. Click Save to save the message and enable the Info Manager.

Rules processing can also be used to route this mail based on keywords in the Subject of the messages, as the Info Manager is checked after completing the rules processing.

The inbound message for each of the subcategories can be forwarded to different recipients or can use the global forwarding feature. It is recommended that you do not send mail from the account since the recipient of that message will receive an automated response when they reply to your message.

The message that is sent back is contained in the "subcatagory.inf" file in the user's mail directory. The presence of this file is what activated the Info Manager for a specific mailbox.

The user's mail address that sent mail to the Info Manager will be listed in a "subcatagory.snt" file and can be viewed by pressing the View Recipients button.

Info Manager messages are not returned if the original message contains the "Precedence: bulk" header or contains "listserv" in the mail address.

The Info Manager is checked AFTER the Rules Manager and BEFORE the Vacation Manager.


Finger Plan
IMail User Manager - Finger Plan

You can create a "plan.ima" file in the users home directory on the IMail Server for Windows NT host system to provide Finger information. The contents of the file are returned to finger requests from other hosts, provided the system administrator enables finger and allows the users plan to be presented. The Plan contents are displayed in addition to the login username, login times, and other information displayed by the Finger server.

The system administrator can disable the transmission of any information about any user through the finger protocol by checking the Disable Finger Info option in the User Properties dialog box.

To create or modify a Finger Plan:

1. In the User Properties dialog box, click Plan. The Finger dialog box appears.

2. Enter any information you desire to make publicly available to Finger clients.

3. Click OK.


LDAP info
Entering LDAP Directory Information (Attributes)

You can add attribute information to the user's account record for publishing via the LDAP server. IMail Server provides an LDAP interface to the IMail user database. The IMail user database is extended to include standard LDAP attributes (such as name, address, organization name, phone number). These attributes are made available (through the LDAP server) to any LDAP-enabled client.

To enter LDAP information for a user:

1.  In the User Properties dialog box, click the Attribs button. The User Attributes dialog box appears.

2.  Select an attribute from the list or define a new attribute by entering it in the text box at the top of the list.

The list contains the most common attributes used in an LDAP entry. Other attributes can be defined by the system administrator or the user.

The text box at the top of the list shows the currently selected attribute. The text box to the right of the list shows the entry for the currently selected attribute.

3.  Enter or modify the entry for the selected attribute, and then click the Set button to save the change.

4.  Select or enter another attribute to change.

5.  When you have finished making entries, click OK.


Aliases
IMail User Manager - Aliases

IMail supports three types of aliases: standard aliases that point to a mail address on the local system, a remote system, or another alias; list aliases that point to a file containing a list of mail addresses; and program aliases that point to an executable program on the host system.

When you create an alias, you are prompted for the name of the alias and the type of alias that you are creating. The alias names are limited to 45 characters and must be created from the character set of A-Z, a-z, 0-9, _ (underline), and - (hypen). The name cannot contain spaces and must be unique within the system. An alias name can be the same as a userid on the system and will override that userid (allowing mail to be forwarded in a manner that the user cannot override).

Standard Aliases

A standard alias can point to a single userid on the same system, multiple userids on the same system, a remote mail address, multiple mail addresses, another alias, or any combination of the same. When entered in the text box, you should place one complete mail address per line (no spaces). If you create an alias that is longer than is allowed, the alias will be converted to a list alias.

List Aliases

A list alias points to a file that contains a list of valid mail addresses, one per line. The dialog box allows you to define the location of the list by manually typing the name of the file or through the use of the browse button.

Program Aliases

A program alias points to a program that can accept the mail message for further processing. The message is passed to the program by passing the full pathname of a temporary file as the last argument on the command line when the program is invoked. Other required command line parameters can be placed in the text box that defines the executable program.


Backup_Restore
Backup and Restore IMail Database

Whenever you exit from the IMail User Manager, it attempts to backup the IMail Server section of the Windows NT registry to the file imailreg. After you complete the initial IMail Server installation, the IMail registry data is written to the file reginit.

You can perform a backup manually by selecting Backup IMail Registry from the File menu. A dialog box prompts you to specify a fliename to which it will back up the IMail Server section of the registry.

You can restore these backup files to the registry by selecting Restore IMail Registry from the File menu. A dialog box displays a list of the backup files. If you select to restore a backup file, you will lose any changes made between the time of the backup and the time of the restore.


Import_NTusers
Importing NT Users

If you did not select to use the Windows NT User Database for user mail accounts, you can use the Import NT Users feature (from the File menu) to add users to the IMail database. Selecting this option displays a dialog box that lists the users in the NT User Database. You can select the users you want to add to the IMail database and IMail Server will create accounts using the userid and the user's full name. You are prompted to enter a password for each user.