Upgrading your system to UnixWare 7

Upgrading Mail and Messaging

SCO OpenServer 5, SCO UnixWare 2.X and UnixWare 7 all contain different mail transport systems with different methods of configuration. However, the feature sets are similar and most features do migrate easily. This topic discusses those features that feature prominently in the GUI or character based configuration tools. (The mail transport in UnixWare 7 is modelled after the SCO OpenServer one, which makes duplicating complex configuration a little easier from that direction.)

Mail folder formats are completely backwards-compatible from UnixWare 7 to both of the other systems, and so folders can be imported with ease.

The following major areas are addressed by this document:

Each of these is described according to whether the migration path is to UnixWare 7 from SCO OpenServer or from SCO UnixWare Release 2.X. In both cases, the text assumes that you are starting with a default configuration on UnixWare 7 and attempting to modify it to match your previous configuration.

Note that this topic describes how to preserve the simple configuration options that were provided in the configuration programs (SCO UnixWare Release 2.X provided a GUI-based configuration tool for mailsurr, while SCO OpenServer provided a GUI for MMDF and a command line script for sendmail).

Upgrading SCO UnixWare Release 2.X Mail and Messaging

This topic describes the migration path from SCO UnixWare Release 2.X to UnixWare 7 for various aspects of the Mail and Messaging system.

Preserving users' inboxes

User's inboxes in SCO UnixWare Release 2.X are in /var/mail, and remain there for UnixWare 7. It is therefore sufficient to copy these files to the new machine. No data conversion of these files is required.


NOTE: In the case where mailboxes are in users' home directories, these must be restored and the INBOX location configured to point there.

Using the Mail Manager to change the inbox location to users' home directories, change the ``Users' INBOX Location'' setting (within the ``Folder Configuration'' container) to the appropriate setting.

Preserving transport agent configuration

The SCO UnixWare Release 2.X UNIX Mail Setup configuration manager specifies several items. This topic explains how to duplicate similar behavior on UnixWare 7.

In the ``Basic'' configuration category, the following fields are displayed:

The ``Advanced'' configuration section of the SCO UnixWare Release 2.X UNIX Mail Setup tool contains several parameters that have no GUI-based analogs in UnixWare 7's sendmail. sendmail does support all of those features, however, a hand edit of /etc/sendmail.cf being necessary to precisely duplicate the SCO UnixWare Release 2.X behavior. The following is a description of what you need to do to duplicate the configuration on UnixWare 7:


Footnotes

1
sendmail, Bryan Costales with Eric Allman, O'Reilly & Associates, Inc.

Preserving vacation notifications

Users of SCO UnixWare Release 2.X will have configured their vacation notifications from dtmail, the graphical mail user agent from CDE. Under UnixWare 7, they should use the Vacation Manager, accessible from the CDE desktop under the Mail panel.

The following SCO UnixWare Release 2.X files must be migrated:

Preserving aliases

If your SCO UnixWare Release 2.X system uses a mailsurr file for mail configuration (you do not use sendmail as mail transport agent), then the following files must be migrated to your UnixWare 7 system:


If the BSD Compatibility Package was installed on your SCO UnixWare Release 2.X system, and you are now using sendmail as the mail transport agent, then the following files should be migrated to the UnixWare 7 system:

Preserving custom forwarding

Users on SCO UnixWare Release 2.X systems had the ability to configure mail forwarding via the /bin/mail program's -F option. On UnixWare 7, /bin/mail is now equivalent to mailx(1), so the -F option is not available. However, similar functionality is supplied by the use of ~/.forward and ~/.maildelivery. The following lists the SCO UnixWare Release 2.X /bin/mail forwarding options, and their equivalent in either ~/.forward or ~/.maildelivery.


Those SCO UnixWare Release 2.X systems with the BSD Compatibility Package installed, and which use sendmail as the mail transport agent, will be able to transfer users ~/.forward files to UnixWare 7 systems without modification, as long as those programs, files, and recipients referenced in the ~/.forward files are accessible.

Upgrading SCO OpenServer Release 5 Mail and Messaging

This topic describes the migration path from SCO OpenServer Release 5 to UnixWare 7 for various aspects of the Mail and Messaging system.

Preserving users' inboxes

In SCO OpenServer Release 5, users' inboxes are in /usr/spool/mail, and in /var/mail in UnixWare 7. There is a symbolic link to /usr/spool/mail from /var/mail, and it is therefore sufficient to copy these files to the new machine. No data conversion of these files is required.


NOTE: In the case where mailboxes are in users' home directories, these must be restored and the INBOX location configured to point there.

Using the Mail Manager to change the inbox location to the users' home directories, change the ``Users' INBOX Location'' setting (within the ``Folder Configuration'' category) to the appropriate setting.

Preserving transport agent configuration

SCO OpenServer Release 5 supports two mail transport agents: MMDF and sendmail. Preserving these configurations is described separately:

Preserving virtual domain support

The SCO OpenServer 5.0.4 sendmail supports virtual domains under POP. UnixWare 7 supports virtual domains and adds IMAP support as well.

SCO OpenServer used virtual users (fake users known only to the POP server), whereas UnixWare 7 uses real users and exports them via a user map into the virtual domains.

Refer to ``The Virtual Domain User Manager'' in SCOhelp for details of how to set up virtual domains and export users to those domains. The virtual domain POP users' inboxes on SCO OpenServer are contained in the directory /usr/internet/ip/ip_addr/sco_mail/spool, where ip_addr is the IP address of a virtual domain. The inboxes are named after the virtual user names.

These mailboxes do not need to be reformatted, but do need to be moved into the standard place for inboxes (by default, /var/mail) on UnixWare 7.

In UnixWare 7, virtual users' password information is contained in /var/internet/ip/ip_addr/passwd. This file is in the old style UNIX /etc/passwd format where the encrypted password is contained in the same file as the user ID information. SCO OpenServer normally splits out the encrypted password into /etc/shadow, and places an ``x'' in that field in /etc/passwd.

Preserving vacation notifications

For additional information on the vacation notification features, see ``The Vacation Notification Manager'' in SCOhelp and the vacation(1) and maildelivery(4) manual pages.

Preserving aliases

Preserving custom forwarding

On SCO OpenServer Release 5 systems using MMDF as mail transport agent, users' ~/.maildelivery files are compatible with UnixWare 7, and may be transferred with little modification. However, the following programs popular with use in ~/.maildelivery on OpenServer are not available in UnixWare 7:

Use of /usr/bin/vacation in ~/.maildelivery to replace rcvtrip is discussed in ``Preserving vacation notifications''.

On OpenServer systems that use sendmail as the mail transport agent, users' ~/.forward files are also compatible with UnixWare 7 and may be transferred with little modification. Users must simply ensure that programs, files, and recipients referenced in their ~/.forward files are accessible. See also ``Preserving vacation notifications''.


© 1998 The Santa Cruz Operation, Inc. All rights reserved.