There are two documents here. Part I is for UUCP. Part II is for TCP/IP. These both replace any and all copies I may have already sent out in the last month. -chris CONFIGURING MMDF IN A UUCP ENVIRONMENT -------------------------------------- Christopher Durham The Santa Cruz Operation chrisdu@sco.COM The following document outlines how to configure the (M)ulti-(C)hannel (M)emorandum (D)istribution (F)acility (MMDF) mail system under SCO UNIX Operating System Release 3.2 and SCO Open Desktop, with specific emphasis on the UUCP channel. TABLE OF CONTENTS Section I .......................................Introduction & Assumptions Section II .....................Mail between two machines connected via UUCP Section III ......................Mail to the Internet through a UUCP gateway Section IV .....Mail in a "hub" configuration with a gateway to the Internet Section V ............................Troubleshooting & Calling SCO Support Section VI ..............................The Internet, UUNET and UseNet News Section VII ..............................................Further Information Introduction and Assumptions ---------------------------- As stated above, this document will show, in a step by step manner, how to configure the MMDF mail system between machines connected with UUCP. Several assumptions are made. First, it is assumed that a UUCP connection is already configured and is working between the systems involved. Secondly, in each section it is assumed that MMDF configuration files are in a default state, and that they have not been modified previously, unless otherwise specified. Most sections will have three subsections: an "Objective:", which will state what is to be accomplished, an "Assumptions:", which will state any additional assumptions, and a "Procedure:", which will outline the steps that need to be taken in order for the "Objective:" to be achieved. Note that it might be necessary to assign a password for the user mmdf on all machines before proceeding past this point, as by default, mmdf does not have a password and hence cannot log into the system. Mail between two machines connected via UUCP -------------------------------------------- Objective: This section will show how to setup two machines over UUCP for transfer of mail with MMDF. Let us assume that the two machine names are fred and barney. A pictoral representation is: fred--(UUCP)--barney Assumptions: The assumption here is that there is a working UUCP connection between fred and barney. Procedure: 1. Login as mmdf on fred. 2. Make sure the following lines exist in /usr/mmdf/mmdftailor: MLDOMAIN UUCP MLNAME fred ; MLOCMACHINE systemid UUname fred UUXSTR "uux -" 3. Edit /usr/mmdf/table/local.dom and make sure the following lines exist: fred: fred.UUCP fred.UUCP: fred.UUCP 4. Edit /usr/mmdf/table/local.chn and make sure the following lines exist: fred: fred fred.UUCP: fred 5. Edit /usr/mmdf/table/uucp.dom and make sure the following lines exists: barney: barney.UUCP barney.UUCP: barney.UUCP 6. Edit /usr/mmdf/table/uucp.chn and make sure the following line exists: barney.UUCP: barney!%s 7. Modify the uucp channel entry in /usr/mmdf/mmdftailor: MCHN uucp, show="SCO UUCP Delivery", que=uucp, tbl=uuchn, ap=822, pgm=uucp, mod=reg 8. Modify the local channel entry in /usr/mmdf/mmdftailor: MCHN local, show="Local Delivery", que=local, tbl=local, ap=same, pgm=local, mod=reg 9. Make sure the local and uucp domain entries in /usr/mmdf/mmdftailor are as follows. They do not have to be next to each other: MDMN "UUCP", show="Local domain", table=locdom MDMN "UUCP", show="UUCP Domain", table=uudom 10. Change directories to /usr/mmdf/table 11. Execute: ./dbmbuild to compile the MMDF database. 12. Log out from mmdf and log in as root. Add the following lines to /etc/rc2.d/S88USRDEFINE: /bin/su mmdf -c "/usr/mmdf/bin/deliver -clocal -b -T60" /bin/su mmdf -c "/usr/mmdf/bin/deliver -cuucp -b -T60" 13. Shutdown the system and reboot. 14. Login as mmdf on machine barney. 15. Make sure the following lines exist in /usr/mmdf/mmdftailor: MLDOMAIN UUCP MLNAME barney ; MLOCMACHINE systemid UUname barney UUXSTR "uux -" 16. Edit /usr/mmdf/table/local.dom and make sure the following lines exist: barney: barney.UUCP barney.UUCP: barney.UUCP 17. Edit /usr/mmdf/table/local.chn and make sure the following lines exist: barney: barney barney.UUCP: barney 18. Edit /usr/mmdf/table/uucp.dom and make sure the following lines exists: fred: fred.UUCP fred.UUCP: fred.UUCP 19. Edit /usr/mmdf/table/uucp.chn and make sure the following line exists: fred.UUCP: fred!%s 20. Modify the uucp channel entry in /usr/mmdf/mmdftailor: MCHN uucp, show="SCO UUCP Delivery", que=uucp, tbl=uuchn, ap=822, pgm=uucp, mod=reg 21. Modify the local channel entry in /usr/mmdf/mmdftailor: MCHN local, show="Local Delivery", que=local, tbl=local, ap=same, pgm=local, mod=reg 22. Make sure the local and uucp domain entries in /usr/mmdf/mmdftailor are as follows. They do not have to be next to each other: MDMN "UUCP", show="Local domain", table=locdom MDMN "UUCP", show="UUCP Domain", table=uudom 23. Change directories to /usr/mmdf/table 24. Execute: ./dbmbuild to compile the MMDF database. 25. Log out from mmdf and log in as root. Add the following lines to /etc/rc2.d/S88USRDEFINE: /bin/su mmdf -c "/usr/mmdf/bin/deliver -clocal -b -T60" /bin/su mmdf -c "/usr/mmdf/bin/deliver -cuucp -b -T60" 26. Shutdown the system and reboot. Machines fred and barney are now configured to send mail to each other with MMDF. Addressing should be as: user@barney or user@fred. Mail to the Internet through a UUCP gateway ------------------------------------------- For a summary of what the "Internet" is, see section VII: "The Internet, UUNET, and UseNet News". Objective: This section will show how to connect a machine to an Internet gateway via UUCP for exchange of mail. Let us assume that the Internet machine is uunet.UU.NET, and that the machine we are connecting to the Internet is bedrock.UUCP. A pictoral representation is: bedrock--(UUCP)--uunet--Internet Assumptions: The assumption here is that there is a working UUCP connection between bedrock and uunet. Procedure: The following steps need to be done on bedrock: 1. Login as mmdf 2. Make sure the following lines exist in /usr/mmdf/mmdftailor: MLDOMAIN UUCP MLNAME bedrock ; MLOCMACHINE systemid UUname bedrock UUXSTR "uux -" 3. Edit /usr/mmdf/table/local.dom and make sure the following lines exist: bedrock: bedrock.UUCP bedrock.UUCP: bedrock.UUCP 4. Edit /usr/mmdf/table/local.chn and make sure the following lines exist: bedrock: bedrock bedrock.UUCP: bedrock 5. Edit /usr/mmdf/table/root.dom and make sure the following line exists: uunet.UU.NET: uunet.UU.NET 6. Edit /usr/mmdf/table/uucp.dom and make sure the following line exists: uunet: uunet.UUCP 7. Edit /usr/mmdf/table/uucp.chn and make sure the following lines exist: uunet.UU.NET: uunet!%s uunet.UUCP: uunet!%s 8. Modify the uucp channel entry in /usr/mmdf/mmdftailor: MCHN uucp, show="SCO UUCP Delivery", que=uucp, tbl=uuchn, ap=822, pgm=uucp, mod=reg 9. Modify the local channel entry in /usr/mmdf/mmdftailor: MCHN local, show="Local Delivery", que=local, tbl=local, ap=same, pgm=local, mod=reg 10. Modify the badhosts channel entry in /usr/mmdf/mmdftailor. This will cause all mail not recognized locally to be delivered to uunet.UU.NET: MCHN badhosts, show="Last-Chance Routing", que=badhosts, tbl=uuchn, ap=822, pgm=uucp, mod=reg, host=uunet.UU.NET 11. Make sure the local and uucp domain entries in /usr/mmdf/mmdftailor are as follows. They do not have to be next to each other: MDMN "UUCP", show="Local domain", table=locdom MDMN "UUCP", show="UUCP Domain", table=uudom 12. Change directories to /usr/mmdf/table 13. Execute: ./dbmbuild to compile the MMDF database. 14. Execute: mkdir /usr/spool/mmdf/lock/home/q.badhosts The new directory should have owner and group mmdf. 15. Log out from mmdf and log in as root. Add the following lines to /etc/rc2.d/S88USRDEFINE: /bin/su mmdf -c "/usr/mmdf/bin/deliver -clocal -b -T60" /bin/su mmdf -c "/usr/mmdf/bin/deliver -cuucp -b -T60" /bin/su mmdf -c "/usr/mmdf/bin/deliver -cbadhosts -b -T60" 16. Shutdown the system and reboot. MMDF should now be configured to deliver mail that cannot be recognized locally to uunet.UU.NET. Mail does not have to be addressed as: uunet!andrew.cmu.EDU!cd0v, correct Internet style addresses of cd0v@andrew.cmu.EDU will work properly. Mail in a "hub" configuration with a gateway to the Internet ------------------------------------------------------------ For a summary of what the "Internet" is, see section VII: "The Internet, UUNET, and UseNet News". Objective: Let us assume there is another host connected to bedrock called rubble. We wish to setup a MMDF connection between rubble and bedrock which will enable rubble to send and receive Internet mail through uunet.UU.NET. A pictoral representation is: rubble--(UUCP)--bedrock--(UUCP)--uunet--Internet Assumptions: The machines bedrock and uunet are setup as in the previous section. Also, rubble and bedrock have a a working UUCP connection. Procedure: 1. Login as mmdf on bedrock. 2. Edit /usr/mmdf/table/uucp.dom and ADD the following line: rubble: rubble.UUCP 3. Edit /usr/mmdf/table/uucp.chn and ADD the following line: rubble.UUCP: rubble!%s 4. Execute the following commands: cd /usr/mmdf/table ./dbmbuild 5. Logout of bedrock. 6. Login as mmdf on rubble. 7. Make sure the following lines exist in /usr/mmdf/mmdftailor: MLDOMAIN UUCP MLNAME rubble ; MLOCMACHINE systemid UUname rubble UUXSTR "uux -" 8. Edit /usr/mmdf/table/local.dom and make sure the following lines exist: rubble: rubble.UUCP rubble.UUCP: rubble.UUCP 9. Edit /usr/mmdf/table/local.chn and make sure the following lines exist: rubble: rubble rubble.UUCP: rubble 10. Edit /usr/mmdf/table/uucp.dom and make sure the following line exists: bedrock: bedrock.UUCP 11. Edit /usr/mmdf/table/uucp.chn and make sure the following line exists: bedrock.UUCP bedrock!%s 12. Modify the uucp channel entry in /usr/mmdf/mmdftailor: MCHN uucp, show="SCO UUCP Delivery", que=uucp, tbl=uuchn, ap=822, pgm=uucp, mod=reg 13. Modify the local channel entry in /usr/mmdf/mmdftailor: MCHN local, show="Local Delivery", que=local, tbl=local, ap=same, pgm=local, mod=reg 14. Modify the badhosts channel entry in /usr/mmdf/mmdftailor. This will cause all mail not recognized locally to be delivered to bedrock.UUCP: MCHN badhosts, show="Last-Chance Routing", que=badhosts, tbl=uuchn, ap=822, pgm=uucp, mod=reg, host=bedrock.UUCP 15. Make sure the local and uucp domain entries in /usr/mmdf/mmdftailor are as follows. They do not have to be next to each other: MDMN "UUCP", show="Local domain", table=locdom MDMN "UUCP", show="UUCP Domain", table=uudom 16. Change directories to /usr/mmdf/table 17. Execute: ./dbmbuild to compile the MMDF database. 18. Execute: mkdir /usr/spool/mmdf/lock/home/q.badhosts The new directory should have owner and group mmdf. 19. Log out from mmdf and log in as root, on rubble. Add the following lines to /etc/rc2.d/S88USRDEFINE: /bin/su mmdf -c "/usr/mmdf/bin/deliver -clocal -b -T60" /bin/su mmdf -c "/usr/mmdf/bin/deliver -cuucp -b -T60" /bin/su mmdf -c "/usr/mmdf/bin/deliver -cbadhosts -b -T60" 20. Shutdown the system and reboot. MMDF is now configured to send mail from rubble, through bedrock, and out to the Internet. Internet style addressing can be used, as in cd0v@andrew.cmu.EDU. It is easy to see how this procedure can be modified for a "hub" configuration of UUCP systems, all which use bedrock as their gateway to the Internet. A pictoral representation of this is below. Note that because bedrock is the gateway between all the systems, rubble and bambam can also exchange mail. Mail should be addressed Internet style, such as: root@sco.COM, or chris@bambam. uunet | (UUCP) | bedrock / \ (UUCP) (UUCP) / \ rubble bambam Troubleshooting and Calling SCO Support --------------------------------------- Before calling SCO Support with a problem about MMDF, please take the following steps to diagnose the problem. 1. Does the underlying network work? Can you use the uucp(C) command to transfer files between the two systems? 2. When logged in as mmdf, note the output of the command: /usr/mmdf/bin/checkaddr
where
is the address to which you intend to send mail. 3. If you get output other than OK from the above command, recheck the files in /usr/mmdf/table for accuracy. Make sure the command ./dbmbuild is run when logged in as mmdf and the directory is /usr/mmdf/table. 4. If you need to call SCO Support, be sure to have the following files ready when speaking with an engineer: /usr/mmdf/mmdftailor /usr/mmdf/table/*.chn /usr/mmdf/table/*.dom /usr/mmdf/log/*.log We also recommend that you be in front of the machine having the problem when speaking to an engineer, in order to try suggestions we may have. The Internet, UUNET, and UseNet News ------------------------------------ The Internet is a world-wide network of computers that allow the mutual exchange of mail, files, and remote logins. Machines on the Internet are grouped according to domains. Domains are administrative groupings of machines. There are several types of top-level domains, including: EDU educational institutions COM commercial institutions GOV government institutions MIL military institutions A domain is usually defined as .. Hence, machines at The Santa Cruz Operation have a domain of sco.COM. Machines in a domain have "fully-qualified domain names" of: .. Hence the machine scotch at The Santa Cruz Operation has a "fully-qualified domain name" of: scotch.sco.COM All machines and groups of machines that have a connection to the Internet should be assigned a domain to prevent duplication of names on the network. To apply for a domain name, and to get more information about the Internet, contact: DDN Network Information Center SRI International 333 Ravenswood Avenue, Room EJ291 Menlo Park, CA 94025, USA Phone: 1-800-235-3155 --------------------- uunet.UU.NET is a machine on the Internet which provides access to the Internet for mail. UUNET also provides access to UseNet News, a discussion oriented forum for a variety of topics that reaches thousands of sites worldwide. Contact: UUNET Administration Location: Fairfax, Virginia Business Hours: 9:00 to 18:00, Eastern Time Subscription Number: (703) 876 - 5050 SCO provides Support Level Supplement unx194, a pre-compiled version of the UseNet News Software. Contact SCO Customer Service at (800) 347-4381 to obtain a copy. SCO does not endorse UUNET. We provide this information only as a service. Further Information ------------------- For information on configuring MMDF in a TCP/IP environment, see the SCO Support Document entitled: "Configuring MMDF in a TCP/IP environment". Also, for a better understanding of MMDF, see: SCO UNIX System V/386 Operating System System Administrator's Guide: Chapter 21, Setting Up Electronic Mail This is available with SCO UNIX System V/386 Release 3.2 version II.