home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / www / mailman-faq < prev    next >
Text File  |  1998-05-30  |  37KB  |  859 lines
  1. Path: senator-bedfellow.mit.edu!faqserv
  2. From: rap@endymion.com (Ryan Alyn Porter)
  3. Newsgroups: comp.infosystems.www.authoring.cgi,comp.infosystems.www.authoring.misc,comp.answers,news.answers
  4. Subject: MailMan WWW email interface v2.0 FAQ
  5. Followup-To: comp.infosystems.www.authoring.cgi
  6. Date: 29 May 1998 11:55:24 GMT
  7. Organization: Endymion Corporation, http://www.endymion.com
  8. Lines: 840
  9. Approved: news-answers-request@MIT.EDU
  10. Expires: 26 Jun 1998 11:47:09 GMT
  11. Message-ID: <www/mailman-faq_896442429@rtfm.mit.edu>
  12. NNTP-Posting-Host: penguin-lust.mit.edu
  13. Summary: A Frequently Asked Questions list for MailMan, version 2.0, 
  14.          a web-based internet email interface.
  15. X-Last-Updated: 1998/05/29
  16. Originator: faqserv@penguin-lust.MIT.EDU
  17. Xref: senator-bedfellow.mit.edu comp.infosystems.www.authoring.cgi:63664 comp.infosystems.www.authoring.misc:26694 comp.answers:31469 news.answers:131254
  18.  
  19. Archive-name: www/mailman-faq
  20. Posting-Frequency: biweekly
  21. Last-modified: Thursday, May 28, 1998
  22. URL: http://www.endymion.com/products/mailman/faq.htm
  23. Created: Friday, May 22, 1998
  24. Maintainer: Ryan Alyn Porter rap@endymion.com
  25.  
  26.      Frequently Asked Questions for MailMan version 2.0
  27.                               
  28.               Ryan Alyn Porter rap@endymion.com
  29.            Copyright ⌐ Endymion Corporation, 1998
  30.                 <URL:http://www.endymion.com>
  31.  
  32. ------------------------------
  33.  
  34. Subject: 1.1) Introduction and Intent
  35.  
  36. This document is an attempt to answer some of the more
  37. frequently asked questions concerning MailMan, a web-based
  38. email interface from Endymion Corporation.  An HTML copy of
  39. this document is stored online at
  40. <URL:http://www.endymion.com/products/mailman/faq.htm>.
  41. This document is not intended to act as marketing materials
  42. for MailMan or for Endymion, this document is intended to
  43. assist us in providing fast and efficient technical support
  44. for MailMan users, 24 hours a day.  I have attempted to
  45. address all levels of reader, from those only barely
  46. familiar with Internet-related software to those with the
  47. task of actually implementing and maintaining MailMan
  48. installations.  Readers of this document are the real judge
  49. of how successfully I have managed to pull that trick off
  50. though.  Let me know if you have any serious issues with the
  51. information contained here.  I have also tried to use simple
  52. and straightforward English, since our users come from all
  53. over the world.  If I have used any idioms that are
  54. difficult to understand in your particular region, please
  55. let me know so that I might make this document more
  56. universally comprehensible.
  57.  
  58. ------------------------------
  59.  
  60. Subject: 2.1) Table of Contents
  61.  
  62. 1.1) Introduction and Intent
  63.  
  64. 2.1) Table of Contents
  65.  
  66. 3.1) Overview
  67. 3.2) What is MailMan?
  68. 3.3) What could I use MailMan for?
  69. 3.3) How is MailMan different from HotMail, YahooMail,
  70. ExciteMail, etc?
  71. 3.4) Where would I find current information on MailMan?
  72. 3.5) WhatÆs the short version of how MailMan works from a
  73. technical standpoint?
  74. 3.6) Can I customize the interface of MailMan?
  75. 3.7) What is the difference between the Standard and the
  76. Professional editions of MailMan?
  77. 3.8) What are the basic requirements for setting up a
  78. MailMan installation?
  79. 3.9) What standards and protocols does MailMan comply with?
  80.  
  81. 4.1) Licensing
  82. 4.2) Is MailMan free?
  83. 4.3) What about the source code?
  84. 4.4) Why would you want people reading your source code?
  85. 4.5) What constitutes a single ôinstallationö of MailMan?
  86. 4.6) Why are you picking on Scientology?
  87.  
  88. 5.1) Installation
  89. 5.2) What is the difference between the different
  90. installation distributions?
  91. 5.3) What is the basic installation procedure?
  92. 5.4) What is the installation procedure for a Unix system?
  93. 5.5) What is the installation procedure for an NT system?
  94. 5.6) I installed MailMan and it doesnÆt work, what do I do?
  95. 5.7) What does it mean when I try to run MailMan and the
  96. server says ôCanÆt locate cgi-lib.plö?
  97.  
  98. 6.1) Operation
  99. 6.2) How would I use MailMan in conjunction with a 'primary'
  100. mailer on my home or office system?
  101. 6.3) Wouldn't IMAP be very well-suited to this type of
  102. scenario?
  103.  
  104. 7.1) Innards
  105. 7.2) How do I customize MailMan to blend into my site and
  106. provide a branded interface to my users?
  107. 7.3) Is it possible to ærigÆ a MailMan installation with a
  108. default POP3 or SMTP server address so that the user doesnÆt
  109. have to enter them?
  110. 7.4) Is it possible to ærigÆ a MailMan installation with a
  111. default POP3 or SMTP server address so that the user canÆt
  112. modify them even if they want to?
  113.  
  114. ------------------------------
  115.  
  116. Subject: 3.1) Overview
  117.  
  118. This section provides an overview of the basic top-level
  119. questions about what MailMan is and what it does.
  120.  
  121. ------------------------------
  122.  
  123. Subject: 3.2) What is MailMan?
  124.  
  125. MailMan is a system that provides any user with an interface
  126. to his or her own email account from any web browser
  127. anywhere in the world.  MailMan is a piece of software that
  128. runs on a web server as a part of an existing web site that
  129. interacts with a mail server and displays the results
  130. through the web server.
  131.  
  132. ------------------------------
  133.  
  134. Subject: 3.2) What could I use MailMan for?
  135.  
  136. A MailMan installation could support a free email
  137. advertisement site.  A different installation of MailMan
  138. could provide essential email access for the students at a
  139. small community college or the students at a large
  140. university.  A different installation of MailMan could allow
  141. the users of a neighborhood ISP to access their local email
  142. accounts through the web without configuring a mail reader.
  143. A different installation of MailMan could provide access to
  144. any email address anywhere in the world for the patrons of a
  145. cyber cafΘ.  Another installation might allow business
  146. workers to stay in touch while away from their desks, even
  147. while at a pay kiosk in an airport or at a borrowed
  148. workstation at another corporation.  Another installation
  149. might allow a family to keep in touch with friends through
  150. GrandmaÆs WebTV box while visiting for Christmas.  There are
  151. other uses for MailMan that we have not even thought of yet.
  152. If you think of others, please let us know.
  153.  
  154. ------------------------------
  155.  
  156. Subject: 3.3) How is MailMan different from HotMail,
  157. YahooMail, ExciteMail, etc?
  158.  
  159. Free Internet mail services such as the ones mentioned above
  160. provide the same basic services that MailMan does, but they
  161. provide them through a proprietary web site, generally with
  162. the purpose of selling advertisements to a guaranteed repeat
  163. audience.  Free email sites provide the user with a mailbox
  164. and the server to access the mailbox.  MailMan is different
  165. because it is simply a piece of software, a technology to be
  166. applied in any number of ways.  MailMan works in conjunction
  167. with other mail servers in order to process incoming and
  168. outgoing mail, communicating with those servers though well-
  169. accepted Internet standards such as the POP3 and STMP
  170. protocols.  The primary advantage of MailMan is that
  171. administrators can control their own MailMan installations.
  172. They have the power to specify what mail servers MailMan
  173. connects to, what MailMan looks like when it runs, who has
  174. access to MailMan, etc.  When you use MailMan, you are
  175. accessing the same email account that you normally access,
  176. not a new account that was created just for you to access
  177. through a free email service.  Some free email services
  178. allow you to access your own email address through the
  179. service, but you are still forced into using someone elseÆs
  180. web server and you are forced into watching someone elseÆs
  181. advertisements.  With MailMan you have much more control.
  182.  
  183. ------------------------------
  184.  
  185. Subject: 3.4) Where would I find current information on
  186. MailMan?
  187.  
  188. The æofficialÆ MailMan information site is at the Endymion
  189. Corporation web site, at
  190. <URL:http://www.endymion.com/products/mailman>.
  191.  
  192. ------------------------------
  193.  
  194. Subject: 3.5) WhatÆs the short version of how MailMan works
  195. from a technical standpoint?
  196.  
  197. The heart of MailMan is a CGI application written in Perl,
  198. version 5.  The mail application generates MailManÆs user
  199. interface dynamically by reading template files filled with
  200. HTML code, processing them, and producing output for the
  201. user through a web server.  To obtain useful email
  202. information, MailMan obtains a userÆs email account
  203. authentication information directly from the user (a
  204. username, password and server name) and communicates with
  205. the userÆs POP3 email server the way that any client-side
  206. mail software ordinarily would.  The user sees a list of
  207. messages and can select messages for viewing, deletion, and
  208. other normal mail tasks.  If a user wishes to reply to a
  209. message, forward a message, or create a new message, MailMan
  210. communicates with an SMTP mail server to send the outgoing
  211. message the way that any ordinary client-side software
  212. would.
  213.  
  214. ------------------------------
  215.  
  216. Subject: 3.6) Can I customize the interface of MailMan?
  217.  
  218. One of the primary benefits of MailMan is that the entire
  219. interface that is presented to the user is the result of a
  220. collection of template files that contain ordinary HTML.
  221. These templates can be modified to incorporate specific
  222. branding of any web site as long as they still contain
  223. certain vital keywords that allow MailMan to insert valuable
  224. information.
  225.  
  226. ------------------------------
  227.  
  228. Subject: 3.7) What is the difference between the Standard
  229. and the Professional editions of MailMan?
  230.  
  231. The standard edition of MailMan is more of a 'viewer' for a
  232. POP3 server than a complete mailer.  It does not store any
  233. user information on the server side.  It does not store
  234. messages anywhere, so the only messages that you see are the
  235. messages that are actually on the POP3 server at that time.
  236. The professional edition stores messages on the server side
  237. after they have been fetched from the POP3 server, allowing
  238. you to organize them into a folder hierarchy like you might
  239. in Eudora or whatever mail program you ordinarily use.  The
  240. professional edition also stores user settings on the server
  241. side, allowing users to configure options such as a default
  242. SMTP server or a signature message to append to outgoing
  243. messages.  The standard edition is a version that we intend
  244. for use by users as a secondary mail system that will
  245. compliment an existing client-side mail package, the
  246. professional edition is intended for use by novice users as
  247. a primary mailer.  Experienced users will probably not be
  248. happy with any version of MailMan as a primary mailer, just
  249. like they would not use HotMail or ExciteMail for a primary
  250. mailer.
  251.  
  252. Another difference, on a more practical level, is that the
  253. professional edition is not yet complete, and won't even go
  254. beta for at least two or three weeks.  (This was written on
  255. Wednesday, May 27, 1998, during the public beta of MailMan
  256. version 2.0 Standard)
  257.  
  258. ------------------------------
  259.  
  260. Subject: 3.8) What are the basic requirements for setting up
  261. a MailMan installation?
  262.  
  263. In order to make use of MailMan you must have a functioning
  264. web server that has the ability to run Perl CGI
  265. applications.  To read incoming mail you must have access to
  266. a functioning POP3 mail server and to send outgoing messages
  267. you must have access to a functioning STMP mail server.
  268. These are all very common Internet standards and you
  269. probably have access to the necessary mail servers if you
  270. have an Internet email account.
  271.  
  272. ------------------------------
  273.  
  274. Subject: 3.9) What standards and protocols does MailMan
  275. comply with?
  276.  
  277. MailMan uses CGI to communicate with the host web server.
  278. For more information about CGI, consult Nick Kew's CGI FAQ
  279. at
  280. <URL:http://www3.pair.com/webthing/docs/cgi/faqs/cgifaq.shtm
  281. l>.
  282.  
  283. For the generation of HTTP headers, MailMan conforms as
  284. closely as possible with the proposed standard RFC 2068,
  285. "Hypertext Transfer Protocol -- HTTP/1.1", as well as the
  286. earlier related specifications such as RFC 1945, "Hypertext
  287. Transfer Protocol -- HTTP/1.0."
  288.  
  289. MailMan's user interface is generated using messages that
  290. comply as closely as possible with RFC 1866, "HyperText
  291. Markup Language Specification - 2.0" and related
  292. specifications.
  293.  
  294. Persistent state information for the frames-based MailMan
  295. interface is maintained according to RFC 2109, "HTTP State
  296. Management Mechanism".
  297.  
  298. For communication with incoming internet email servers,
  299. MailMan conforms as closely as possible with RFC 1939, "Post
  300. Office Protocol - Version 3", and was originally based on
  301. the earlier specification, RFC 1725.  MailMan is in strict
  302. compliance with end of line delimiters specified in the POP3
  303. standards documents and should be compatible with POP3
  304. servers regardless of the end of line delimiter used in the
  305. server's host operating system.
  306.  
  307. For communication with outgoing internet email servers,
  308. MailMan conforms as closely as possible with RFC 821,
  309. "Simple Mail Transfer Protocol".  MailMan does not make use
  310. of enhancements provided by later approved extension
  311. standards such as RFC 1869 or RFC 1870.
  312.  
  313. The messages that MailMan processes and generates are
  314. compliant as closely as possible with RFC 822, "Standard for
  315. the format of ARPA Internet text messages".  Formatted
  316. messages and messages with attachments are automatically
  317. handled by portions of MailMan which are compliant as
  318. closely as possible with the specifications in RFC 2045, RFC
  319. 2046, RFC 2047, RFC 2048 and RFC 2049, "Multipurpose
  320. Internet Mail Extensions (MIME)", parts one through five.
  321.  
  322. All of the above referenced standards documents are
  323. available at <URL:http://www.ietf.org>.
  324.  
  325. ------------------------------
  326.  
  327. Subject: 4.1) Licensing
  328.  
  329. This section describes the licensing structure of MailMan.
  330.  
  331. ------------------------------
  332.  
  333. Subject: 4.2) Is MailMan free?
  334.  
  335. No, MailMan is not free.  An employee of Endymion
  336. Corporation originally started MailMan as a spare time
  337. project in 1996.  The first version of MailMan was released
  338. through the Endymion Corporation web site in 1997 under the
  339. GNU Public License, in the hope that people would find the
  340. software valuable and contribute to its development.  In the
  341. time since then, many people have downloaded MailMan and
  342. used the application and some have even contributed
  343. suggestions and bug fixes, but nobody has undertaken further
  344. development.  Since MailMan has survived the test of time,
  345. Endymion Corporation has decided to pronounce MailMan an
  346. official, supported product.  We have invested the time and
  347. resources in developing MailMan version 2.0, a vast
  348. improvement over the original freeware incarnation of
  349. MailMan, and we are offering it for license.
  350.  
  351. Now for the exceptions.  Endymion Corporation automatically
  352. grants a license for free to installations of MailMan that
  353. meet one of the following criteria:
  354.  
  355. 1.   Educational Institutions, including government,
  356.   private, and non-profit institutions.  In situations where
  357.   the nature of your institution is disputed, Endymion
  358.   Corporation reserves the right to require a copy of your
  359.   501(c)(3) form or a local equivalent before granting a
  360.   license.
  361. 2.   Non-profit institutions, including religious
  362.   institutions, but with the specific exception of the Church
  363.   of Scientology International or any other religious
  364.   organizations directly related to the Church of Scientology.
  365.   Endymion Corporation reserves the right to require a United
  366.   States federal non-profit tax ID number or a local
  367.   equivalent before granting a license.
  368. 3.   Private individuals or families.
  369.  
  370. All installations of MailMan that do not clearly fit into
  371. one of the three clearly-defined categories above must be
  372. licensed.  So that there is no confusion, installations of
  373. MailMan that must be licensed include, but are not limited
  374. to, the following examples:
  375.  
  376. ╖    Cyber cafΘ mail kiosks
  377. ╖    Large ISPs
  378. ╖    Small-town ISPs
  379. ╖    Free Internet email services
  380. ╖    Corporate messaging applications
  381.  
  382. One license must be purchased for each installation of
  383. MailMan, but each installation can host an unlimited number
  384. of users, unlike MailManÆs primary competition.  For current
  385. information on MailMan licensing policies, please see
  386. <URL:http://www.endymion.com/products/mailman/licensing.htm>
  387. .
  388.  
  389. ------------------------------
  390.  
  391. Subject: 4.2) What about the source code?
  392.  
  393. MailMan began life as a GPL product.  Because of our desire
  394. to help to move the world forward just a little bit at a
  395. time by sharing our efforts with others and because of a
  396. general sense of honesty and openness, we are making the
  397. source code for MailMan available under the GNU General
  398. Public License.  Information on the GPL can be found at
  399. <URL:http://prep.ai.mit.edu/pub/gnu/GPL>. The honesty and
  400. integrity of our user base will determine whether our
  401. experiment in openness is successful, or whether MailMan
  402. must become a completely proprietary product because of the
  403. abuse of a few selfish users.  If you can read our source
  404. code and learn from it, be our guest and please have fun.
  405. If you can read our source code and make suggestions, please
  406. do, we value suggestions on how to improve the product.  If
  407. you can read our source code and port it to new protocols
  408. and environments, we would love to hear about it.  If you
  409. can read our source code and you have ideas about absconding
  410. with a derivative of our code that you will make into your
  411. own product, please read the GNU General Public License at
  412. <URL:http://prep.ai.mit.edu/pub/gnu/GPL>.
  413.  
  414. ------------------------------
  415.  
  416. Subject: 4.3) Why would you want people reading your source
  417. code?
  418.  
  419. Quality assurance.  If you buy a food product, you want to
  420. know what it is made out of.  If you buy a house, you want
  421. to know that it is built of quality materials.  If you buy a
  422. car, you want to know what is under the hood.  If you use a
  423. cryptographic algorithm, you want to know that it has been
  424. verified by outside analysts.  We feel that a lot of very
  425. poor quality software is currently sold because a lot of
  426. software companies do not have to answer to their users.  If
  427. an independent observer looked at the source code for web
  428. browsers from Microsoft and Netscape and told you that the
  429. source code behind the Microsoft product was just beastly
  430. but that the Netscape code is very clean and organized, you
  431. might be more inclined to choose NetscapeÆs browser.  Since
  432. Microsoft does not release the source code for their
  433. product, you do not have the option to evaluate their
  434. browser.  The bugs in Netscape, on the other hand, have been
  435. hunted down and eradicated by thousands of prying eyes.  We
  436. are hoping that by making our source code open and available
  437. that we will be held to a higher standard of quality and
  438. that we will benefit by having some of our mistakes pointed
  439. out by our user base.  This model has worked in the past for
  440. MailMan and we hope that it will continue to work in the
  441. future.
  442.  
  443. ------------------------------
  444.  
  445. Subject: 4.4) What constitutes a single ôinstallationö of
  446. MailMan?
  447.  
  448. A single installation of MailMan is defined as both a unique
  449. URL and server that is used to access the MailMan
  450. application.  Most MailMan installations will require
  451. exactly one server and exactly one URL.  For instance,
  452. Endymion Corporation maintains only one installation of
  453. MailMan, on a single server that handles our entire
  454. corporate web site, with a single URL,
  455. <URL:http://www.endymion.com/products/mailman/demo/mailman.c
  456. gi>.  If your MailMan installation will be supported by more
  457. than one server, all with the same URL, each server must be
  458. licensed.  In a more likely scenario, if you operate several
  459. virtual domains from the same server and each virtual domain
  460. makes use of a MailMan installation, each different URL that
  461. MailMan is known by must be licensed.  Having several
  462. different virtual domains all access a single installation
  463. of MailMan by the same URL on the same server technically
  464. only requires one license according to our definitions, but
  465. we are a small company and thatÆs not a very nice thing to
  466. do to us.  Please consider doing the right thing and
  467. licensing each installation.
  468.  
  469. ------------------------------
  470.  
  471. Subject: 4.5) Why are you picking on Scientology?
  472.  
  473. WeÆre not.  Our intent is to provide MailMan for free to
  474. private individuals and to organizations that are acting
  475. selflessly and could use the applications but might not be
  476. able to budget for it.  For-profit organizations foot the
  477. bill in our little Robin Hood game.  We donÆt think that
  478. this is too much to ask, since the bill that weÆre talking
  479. about is miniscule.  The Church of Scientology does not fit
  480. into our definition of æan organization that acts selflessly
  481. and might not be able to pay for a licenseÆ.  We have
  482. nothing nasty to say about Scientology or the Church of
  483. Scientology other than that.  To each his own.
  484.  
  485. ------------------------------
  486.  
  487. Subject: 5.1) Installation
  488.  
  489. This section describes how to install MailMan.
  490.  
  491. ------------------------------
  492.  
  493. Subject: 5.2) What is the difference between the different
  494. installation distributions?
  495.  
  496. There are two different distributions of each edition of
  497. MailMan version 2.0, a Unix distribution and an NT
  498. distribution.  In reality either distribution should work on
  499. any server, but we have found it to be more convenient for
  500. our users to package the application in a way that is more
  501. targeted to the final platform.  The primary difference
  502. between the two distributions is that the files in the NT
  503. distribution have been processed so that the lines in the
  504. mail MailMan source file end with a CRLF, while the lines in
  505. the same file in the Unix distribution are terminated with a
  506. simple LF.  If you donÆt know what that means, donÆt worry
  507. about it, itÆs really not that important usually.  Another
  508. difference is that the main MailMan source file in the Unix
  509. distribution is called ômailman.cgiö, while the same file in
  510. the NT distribution is called ômailman.plö.  We have found
  511. that this arrangement reduces confusion in most cases.  If
  512. you disagree about our file naming conventions you are
  513. perfectly welcome to rename the files to whatever you want.
  514.  
  515. ------------------------------
  516.  
  517. Subject: 5.3) What is the basic installation procedure?
  518.  
  519. I have described the steps in this item in more detail in
  520. the OS-specific items below, this item provides an overview
  521. of the process.
  522.  
  523. 1.   Unpack your distribution
  524. 2.   Copy the distribution to the location on your web
  525.   server where it will be installed, ô/public_html/mailman/ö
  526.   for example.  Make sure that the following files are
  527.   present:
  528.   ômailman.cgiö or ômailman.plö (it comes under different
  529.   names), ôcgi-lib.plö, all of the ôi_*.gifö files, and all of
  530.   the ôt_*.htmö files.
  531. 3.   Make sure that your copy of ômailman.cgiö or
  532.   ômailman.plö is executable, and is executable by your web
  533.   server.  If you donÆt know how to do this, consult an expert
  534.   on your operating system and web server.
  535.  
  536. ThatÆs it, it looks too simple to believe, but that is the
  537. basic process.  In most cases it will be that simple, and
  538. MailMan will run æout of the boxÆ.  Once you have performed
  539. the above three steps, merely access the application through
  540. the URL that you have given it.  In the above example, the
  541. URL to access MailMan would likely be
  542. <URL:http://yourserver/mailman/mailman.cgi> or
  543. <URL:http://yourserver/mailman/mailman.pl>
  544.  
  545. ------------------------------
  546.  
  547. Subject: 5.4) What is the installation procedure for a Unix
  548. system?
  549.  
  550. This item provides a more detailed explanation of the above
  551. procedure for Unix systems.  Before you install MailMan,
  552. make sure that you have Perl 5 installed.  On most Unix
  553. systems, especially web hosting systems, Perl will already
  554. be installed.  If Perl is not installed, or if Perl version
  555. 5 is not installed, consult your system administrator.
  556.  
  557. 1.   Copy the distribution to the location that you want to
  558.   unpack it in.  ô/public_html/mailman/ö in the above example.
  559. 2.   Unpack the distribution with tar.  On most systems you
  560.   can type ôtar ûzxvf <distribution>.tgzö and your system will
  561.   expand the file.  You should now have a collection of
  562.   ôi_*.gifö files, ôt_*.htmö files, ômailman.cgiö, ôcgi-
  563.   lib.plö, and some documentation (this document, in
  564.   particular).  On systems where that doesnÆt work, try
  565.   ôgnutar ûzxvf <distribution>.tgzö.  If that doesnÆt work,
  566.   you will have to manually unzip the file with ôgunzipö and
  567.   then untar the file with ôtar ûxvf <distribution>.tarö.  If
  568.   all else fails, fetch the NT distribution and unzip it.
  569. 3.   Make sure that your copy of ômailman.cgiö is executable
  570. by issuing the command ôchmod 755 mailman.cgiö  Your copy of
  571. ôcgi-lib.plö must also be executable.  ôchmod 755 cgi-
  572. lib.plö.  Also, just to be sure, make sure that your
  573. ôt_*.htmö and ôi_*.gifö files are marked so that the web
  574. server process can read them.  Sometimes you can read your
  575. own files, but you inadvertently have your files set so that
  576. your web server canÆt access them.  These are the same rules
  577. that you should be following when you publish ordinary web
  578. content.  ôchmod 644 i_*.gif t_*.htmö should do the trick.
  579. 4.   Make sure that the first line of the ômailman.cgiö file
  580. refers to the correct location of your Perl interpreter.  Be
  581. warned that it probably does not.  You can find out where
  582. your Perl interpreter is located on most Unix systems by
  583. typing ôwhere perlö on the command line.  Some system
  584. administrators keep Perl 4 and Perl 5 both installed at the
  585. same time, with ôperlö referring to Perl 4 and ôPerlö or
  586. ôperl5ö referring to Perl 5.  If your system operates this
  587. way, make sure that you are referring to the correct
  588. location of Perl 5.  MailMan will not operate with Perl 4.
  589.  
  590. Check your installation by loading ômailman.cgiö in your web
  591. browser through your web server.  In the above example, the
  592. URL to access MailMan would likely be
  593. <URL:http://yourserver/mailman/mailman.cgi>.
  594.  
  595. ------------------------------
  596.  
  597. Subject: 5.5) What is the installation procedure for an NT
  598. system?
  599.  
  600. This item provides a more detailed explanation of the above
  601. procedure for NT systems.  Before you install MailMan on an
  602. NT system, make sure that you have Perl 5 installed.  For
  603. more information on where to get Perl 5 and how to install
  604. and configure it for NT, please consult Evangelo Prodromouæs
  605. Perl for Win32 FAQ at
  606. <URL:http://www.endcontsw.com/people/evangelo/Perl_for_Win32
  607. _FAQ.html>
  608.  
  609. 1.   Copy the distribution to the location that you want to
  610.   unpack it in.  ô/public_html/mailman/ö in the above example.
  611. 2.   Unpack the distribution.
  612. 3.   If you are using IIS, make sure that the directory
  613.   where your MailMan installation resides is marked executable
  614.   in the IIS administration interface.  Also make sure that
  615.   your ômailman.plö file ends in an extension that will be
  616.   recognized by your system as a Perl 5 script.  Most of the
  617.   time ômailman.plö will do the trick, but your installation
  618.   of Perl 5 may be different.
  619.  
  620. Check your installation by loading ômailman.plö in your web
  621. browser through your web server.  In the above example, the
  622. URL to access MailMan would likely be
  623. <URL:http://yourserver/mailman/mailman.pl>.
  624.  
  625. ------------------------------
  626.  
  627. Subject: 5.6) I installed MailMan and it doesnÆt work, what
  628. do I do?
  629.  
  630. 1.   Make sure that you have your permissions set on the
  631.   files mailman.cgi and cgi-lib.pl, so that both are
  632.   executable.  The exact mechanism of doing this is different
  633.   on every operating system.  On unix, make sure that the
  634.   permissions on both files read "-rwxr-xr-x" when you do an
  635.   "ls -alt".  You manage this with "chmod 755 mailman.cgi cgi-
  636.   lib.pl".  If you're using any    other OS, ask an expert on
  637.   your OS.
  638. 2.   Make sure that your web server understands that a file
  639.   ending in ".cgi" (or ô.plö or whatever your copy is called)
  640.   is a CGI script and that it should run "mailman.cgi" when
  641.   you invoke it.  If your web server isn't happy with the
  642.   ".cgi" extension, feel free to rename it to ".pl" or
  643.   ".runthis" or whatever makes your web server happy.  If you
  644.   change the extension, or even the name, of mailman, you
  645.   shouldn't have to change anything else and it should just
  646.   run.  MailMan dynamically identifies its own location each
  647.   time it runs.  This one varies from web server to web
  648.   server, and if you don't know how to deal with this issue,
  649.   ask an expert on your web server.
  650. 3.   Make sure that MailMan's templates are readable to your
  651.   web server.  Keep in mind that just because they are marked
  652.   readable to you, they are not necessarily marked readable to
  653.   your web server, since the server generally runs as a
  654.   different user.  In Unix, you probably want your permissions
  655.   for your "t_*.htm" files to read "-rw-r--r--", which you can
  656.   achieve with "chmod 644 t_*.htm".  On any other OS, if you
  657.   don't already know how to do it then ask an expert on your
  658.   OS.
  659. 4.   Make sure that MailMan's templates are located in the
  660.   directory that your web server will set to the 'current'
  661.   directory when MailMan runs.  This will USUALLY be the same
  662.   directory that the script is located in, but not
  663.   necessarily.  Some web servers set the current directory to
  664.   places other than where the script itself is located.  If
  665.   you have one of these servers and MailMan runs but your
  666.   templates are AWOL, consult with your sysadmin or an expert
  667.   on your web server, or see section 5.7 of this FAQ.
  668.  
  669. ------------------------------
  670.  
  671. Subject: 5.7) What does it mean when I try to run MailMan
  672. and the server says ôCanÆt locate cgi-lib.plö?
  673.  
  674. The most likely cause of an error complaining about not
  675. being able to find ôcgi-lib.plö is that MailMan is ælostÆ.
  676. This happens when your server runs your CGI applications
  677. with a current directory other than the actual directory
  678. that the application is located in.  If your MailMan
  679. installation is in ô/public_html/mailman/mailman.cgiö for
  680. instance, your server might instantiate MailMan with
  681. ô/public_html/mailman/mailman.cgiö as the current directory,
  682. in which case everybody is happy.  It also might instantiate
  683. MailMan with ô/usr/local/somedir/ö as the current
  684. direcotory, in which case MailMan has no way of locating its
  685. own templates and dependencies.  Luckily, there is a simple
  686. fix for this.  At the top of the ômailman.cgiö file there is
  687. a line that allows you to manually set the variable
  688. ô$strLocationö to an absolute path that describes the
  689. location of your MailMan installation.  In the above example
  690. you would set ô$strLocationö to ô/public_html/mailman/ö,
  691. letting MailMan know where it should look for dependencies
  692. and templates.  Note that ô$strLocationö must be a complete
  693. directory name, with an absolute root and the terminating
  694. ô/ö or ô\ö character, depending on your operating system and
  695. file system.
  696.  
  697. ------------------------------
  698.  
  699. Subject: 6.1) Operation
  700.  
  701. This section describes how to work MailMan from a userÆs
  702. point of view.
  703.  
  704. This section is still incomplete, sorry, check back after
  705. the MailMan public beta is over for a more current copy of
  706. this document with more useful information for this section.
  707.  
  708. ------------------------------
  709.  
  710. Subject: 6.2) How would I use MailMan in conjunction with a
  711. 'primary' mailer on my home or office system?
  712.  
  713. We wish that there were other sources that we could
  714. reference that could explain the basics of using several
  715. different mailers at once.  Unfortunately we don't know of
  716. any.  If you know of any good write-ups with suggestions for
  717. novice users on this subject please let us know.
  718.  
  719. The key issue involved is configuring your mailer to leave
  720. its messages on the internet mail server after it has
  721. downloaded them.  If you receive a message from your boss on
  722. your computer at work and you decide that you would really
  723. rather go home and reply to the message after dinner, you
  724. can't do that if your mailer at work deletes the message
  725. from the server after it checks the message.  If you set
  726. your mailer at work to not delete the message from the
  727. server, when you get home and check your mail, the message
  728. will still be there waiting for you to reply to it.  Using
  729. MailMan in conjunction with other mailers is no different.
  730. All that you need to do is configure all of your mailers to
  731. leave messages on the mail server by default, and perhaps
  732. select one mailer as your 'official' mailer that is allowed
  733. to delete your messages.  Most quality mail clients have
  734. options to leave messages on the server but delete them
  735. after a set number of days have passed.  This option is
  736. extremely helpful when using many different mail clients to
  737. access the same mailbox.
  738.  
  739. ------------------------------
  740.  
  741. Subject: 6.3) Wouldn't IMAP be very well-suited to this type
  742. of scenario?
  743.  
  744. Yes, IMAP is the perfect solution to the problem of
  745. synchronizing multiple different internet client
  746. applications.  IMAP supports persistent mail storage in
  747. folders on the server side so that all mail clients,
  748. regardless of location, have a synchronized impression of
  749. what the user's current mail situation is like.  MailMan
  750. does not currently support IMAP because it is not nearly as
  751. widely accepted as POP3 as a mail server protocol, and
  752. because there are a fixed number of hours in a developer's
  753. day.  We sincerely hope that IMAP becomes more prevalent and
  754. demand for an IMAP version of MailMan increases, and we hope
  755. that the existing versions of MailMan will be successful
  756. enough to support the development of an IMAP version.  If
  757. you would personally like to see an IMAP version of MailMan
  758. with full server-side folder support, drop us a line at
  759. mailman@endymion.com and let us know that you are out there.
  760. If the demand is high enough we will naturally be compelled
  761. to develop a product.
  762.  
  763. ------------------------------
  764.  
  765. Subject: 7.1) Innards
  766.  
  767. This section describes the inner working of MailMan for
  768. installation administrators that want to customize their
  769. installations.
  770.  
  771. This section is still incomplete, sorry, check back after
  772. the MailMan public beta is over for a more current copy of
  773. this document with more useful information for this section.
  774.  
  775. ------------------------------
  776.  
  777. Subject: 7.2) How do I customize MailMan to blend into my
  778. site and provide a branded interface to my users?
  779.  
  780. All of MailMan's output is defined by a collection of HTML
  781. templates.  The templates are the ".htm" files that begin
  782. with "t_" in your distribution.  We have provided a sample
  783. look and feel for MailMan that you are welcome to use for as
  784. long as you like.  When you begin the customization process,
  785. simply open the templates in any HTML editor and make your
  786. modifications.  Remember that the behavior of MailMan is
  787. dictated by hidden fields contained within the HTML
  788. templates, so make sure that you go slowly and check your
  789. results often, as it may be possible to 'break' your
  790. installation by accidentally deleting or modifying important
  791. keywords.  We hope to provide more detailed information on
  792. what MailMan's keywords are and what they mean in this
  793. document at a later date.
  794.  
  795. ------------------------------
  796.  
  797. Subject: 7.3) Is it possible to ærigÆ a MailMan installation
  798. with a default POP3 or SMTP server address so that the user
  799. doesnÆt have to enter them?
  800.  
  801. Yes.  The POP3 server used is referred to in the HTML
  802. templates by the substitution keyword ôSERVERö.  Hunt down
  803. everywhere that MailMan allows the user to supply this value
  804. through a form field.  The only place where this should
  805. happen is in the template ôt_login.htmö.  Find this
  806. form field:
  807.  
  808.          <input type="text" name="SERVER" size="30">
  809.  
  810. And replace it with:
  811.  
  812.          <input type="text" name="SERVER" size="30"
  813.                value=öpopserver.mydomain.comö>
  814.  
  815. The box will now be filled in by default for the user when
  816. they log on, but experienced users will still be able to aim
  817. MailMan at specific servers.
  818.  
  819. The SMTP server used by MailMan is specified by the keyword
  820. ôOUTGOINGö.  Change the form fields that set the ôOUTGOINGö
  821. keyword in both ôt_f_messageform.htmö and
  822. ôt_nf_messageform.htmö in order to rig the outgoing SMTP
  823. server to something specific.
  824.  
  825. ------------------------------
  826.  
  827. Subject: 7.4) Is it possible to ærigÆ a MailMan installation
  828. with a default POP3 or SMTP server address so that the user
  829. canÆt modify them even if they want to?
  830.  
  831. Yes.  The POP3 server used is referred to in the HTML
  832. templates by the substitution keyword ôSERVERö.  Hunt down
  833. everywhere that MailMan allows the user to supply this value
  834. through a form field.  The only place where this should
  835. happen is in the template ôt_login.htmö.  Find this
  836. form field:
  837.  
  838.          <input type="text" name="SERVER" size="30">
  839.  
  840. And replace it with:
  841.  
  842.              <input type="hidden" name="SERVER"
  843.                value=öpopserver.mydomain.comö>
  844.  
  845. The box will now not even show up, and users will not have
  846. the option of specifying a server.  This makes things
  847. considerably simpler for novice users if the server
  848. addresses are static.  You will probably want to do more
  849. surgery than this to make your login page look reasonable.
  850.  
  851. The SMTP server used by MailMan is specified by the keyword
  852. ôOUTGOINGö.  Change the form fields that set the ôOUTGOINGö
  853. keyword in both ôt_f_messageform.htmö and
  854. ôt_nf_messageform.htmö in order to rig the outgoing SMTP
  855. server to something specific.
  856.  
  857. ------------------------------
  858.            Copyright ⌐ Endymion Corporation, 1998
  859.