Site Manager's Operations Manual for LISTSERV®, Version 14.3
Total Page:16
File Type:pdf, Size:1020Kb
L-Soft international, Inc. Site Manager's Operations Manual for LISTSERV®, version 14.3 7 December 2004 LISTSERV 14.3 Release The reference number of this document is 0412-MD-01. Information in this document is subject to change without notice. Companies, names and data used in examples herein are fictitious unless otherwise noted. L-Soft international, Inc. does not endorse or approve the use of any of the product names or trademarks appearing in this document. Permission is granted to copy this document, at no charge and in its entirety, provided that the copies are not used for commercial advantage, that the source is cited and that the present copyright notice is included in all copies, so that the recipients of such copies are equally bound to abide by the present conditions. Prior written permission is required for any commercial use of this document, in whole or in part, and for any partial reproduction of the contents of this document exceeding 50 lines of up to 80 characters, or equivalent. The title page, table of contents and index, if any, are not considered to be part of the document for the purposes of this copyright notice, and can be freely removed if present. The purpose of this copyright is to protect your right to make free copies of this manual for your friends and colleagues, to prevent publishers from using it for commercial advantage, and to prevent ill-meaning people from altering the meaning of the document by changing or removing a few paragraphs. Copyright © 1996-2004 L-Soft international, Inc. All Rights Reserved Worldwide. L-SOFT, LISTSERV and LSMTP are registered trademarks of L-Soft international, Inc. LMail is a trademark of L-Soft international. EASE and CataList are service marks of L-Soft international, Inc. UNIX is a registered trademark of X/Open Company Limited. AIX and IBM are registered trademarks of International Business Machines Corporation. Alpha AXP, Ultrix, OpenVMS and VMS are trademarks of Digital Equipment Corporation. OSF/1 is a registered trademark of Open Software Foundation, Inc. Microsoft is a registered trademark and Windows, Windows NT and Windows 95 are trademarks of Microsoft Corporation. HP is a registered trademark of Hewlett-Packard Company. Sun is a registered trademark of Sun Microsystems, Inc. IRIX is a trademark of Silicon Graphics, Inc. PMDF is a registered trademark of Innosoft International. Pentium and Pentium Pro are registered trademarks of Intel Corporation. All other trademarks, both marked and not marked, are the property of their respective owners. All of L-Soft's manuals for LISTSERV are available in ascii-text format via LISTSERV and in popular word-processing formats via ftp.lsoft.com. They are also available on the World Wide Web at the following URL: http://www.lsoft.com/manuals/index.html L-Soft invites comment on its manuals. Please feel free to send your comments via e-mail to [email protected], and mention which manual you are commenting on. (However, please do not send support questions to this address. See chapter 19 of this manual for appropriate support addresses.) "Hot fix" revisions to this and other L-Soft manuals are posted as they are made to the master document, on the announcement-only mailing list: [email protected] A word about formatting: This manual was written in Microsoft Word 2000, and originally formatted to be printed on 8-1/2"x11" paper on a Canon BJC-2100 inkjet printer. When printing the manual on a different type of printer, or converting to a different word-processing program, it is highly likely that the formatting and pagination will change and it will be necessary to update the tables of contents and figures as well as the index prior to printing. The author has taken great pains to ensure that the pagination and formatting works properly with the particular printer mentioned above, and cannot be held responsible for what is, in the end, a limitation of the software used to produce the manual. Reference Number 0412-MD-01 Site Manager's Operations Manual for LISTSERV 14.3 2 Table of Contents Preface: LISTSERV Command Syntax and Other Conventions. 11 Editorial Note – New Version Numbering ........................................................11 LISTSERV Command Syntax Conventions.....................................................11 1. Who should read this book ....................................................... 13 1.1. Changes and updates to the manual........................................................13 1.2. New documentation is coming!.................................................................13 2. Differences Between Architectures and Implementations ..... 14 2.1. Differences between architectures ...........................................................14 2.2. Differences between LISTSERV and LISTSERV Lite ..............................15 3. Principles of Operation.............................................................. 17 4. A LISTSERV How-To for Site Managers ................................... 19 4.1. Installation/Startup Questions ..................................................................19 How do I install LISTSERV?.................................................................................... 19 Why do I need a DNS A record and a static IP number for my LISTSERV machine?19 Can LISTSERV read mail from POP mailboxes?.................................................... 19 How do I install the web archive/administration interface?...................................... 19 How do I start LISTSERV?...................................................................................... 19 How do I stop LISTSERV? ...................................................................................... 19 4.2. Initial configuration ...................................................................................20 How do I add, change, and delete LISTSERV Maintainers (aka postmasters)?..... 20 How do I create passwords for postmasters, and what are they used for?............. 20 How do I make my first list? .................................................................................... 21 How do I delete a list?............................................................................................. 21 Does LISTSERV have a GUI interface?.................................................................. 21 5. Configuring your LISTSERV® site ............................................ 22 5.1. Site configuration files ..............................................................................22 5.2. What can be configured? .........................................................................22 5.3. Files used by LISTSERV..........................................................................28 5.4. Installing and configuring LISTSERV's WWW Archive and Administration Interface ...............................................................................................33 5.4.1. The WWW Archive Interface described ........................................................ 34 5.4.2. The WWW Administration Interface described.............................................. 35 5.4.3. Installing a web server................................................................................... 35 5.4.4. Installing the web archive interface script...................................................... 36 5.4.5. Creating a subdirectory for the archive interface........................................... 37 5.4.6. Configuring LISTSERV to activate the web archive interface ....................... 38 5.4.7. Customizing the web pages LISTSERV creates ........................................... 38 5.4.8. Enabling individual lists ................................................................................. 39 5.4.9. Enabling web-based bulk operations ............................................................ 41 5.5. The "spam" detector and anti-subscription-"spoofing" feature..................41 5.5.1. Spam quarantine........................................................................................... 42 5.5.2. "Anonymous" spam alerts ............................................................................. 42 5.5.3. Subscription anti-spoofing feature................................................................. 42 5.6. Server Registration...................................................................................43 Site Manager's Operations Manual for LISTSERV 14.3 3 5.6.1. Registering LISTSERV Classic Servers........................................................ 43 5.6.2. The LISTSERV backbone ............................................................................. 44 5.6.3. Automatic Registration for LISTSERV Lite Servers ...................................... 45 5.7. Inter-server Updates.................................................................................45 5.8. Setting up archive and notebook directories for use with LISTSERV.......46 5.9. DBMS and Mail Merge Functions.............................................................47 5.10. Synonymous host name registration via ALIASES NAMES ...................47 5.11. Real-Time Anti-Virus Scanning ..............................................................48 6. LISTSERV Commands ............................................................... 49 6.1. General Commands .................................................................................49 6.1.1. List subscription commands (from most to least important) .......................... 49 6.1.2. Other list-related