|
valium overdose Cyrus IMAP HOWTO Aurora Skarra-Gallagher (Community Vision) v1.3, 11 October 2000 A comprehensive guide to installing, configuring, and running Cyrus Imap and Cyrus Sasl _______________ valium overdose ______________________________________________________ Table of Contents 1. About this HOWTO 1.1 Copyrights and Trademarks 1.2 Feedback 1.3 CHANGES 1.4 Document Conventions valium overdose 2. Introduction to IMAP 2.1 What is IMAP? 2.2 IMAP vs. POP 2.3 Cyrus IMAP vs. Washington IMAP 3. Obtaining the Files 3.1 Cyrus Imap Homepage 3.2 Downloading the files valium overdose . Different SASL Authentication Methods 4.1 sasldb 4.2 LDAP 4.3 PAM 4.4 kerberos_v4 5. Cyrus SASL 5.1 Uncompress 5.2 Building the files 6. Cyrus IMAP Installation valium overdose 6.1 Uncompress 6.2 A note on com_err.h 6.3 Configure 6.4 Adding the default user 6.5 Building the files 7. Cyrus IMAP Configuration 7.1 Editing conf files 7.2 Crea valium overdose ing the necessary directories 7.3 More configuration file editing 7.4 If you use postfix instead of sendmail 8. Cyrus IMAP Implementation 8.1 Add the cyrus administrator 8.2 valium overdose Testing Cyrus IMAP 8.3 Setting up users 8.4 Delivery database pruning 8.5 Finishing up 9. Troubleshooting ______________________________________________________________________ valium overdose 1. About this HOWTO 1.1. Copyrights and Trademarks (c) 2000 Aurora Skarra-Gallagher This section was copied from the HOWTO-HOWTO: This manual may be reproduced in whole or in part, wi valium overdose hout fee, subject to the following restrictions: · The copyright notice above and this permission notice must be preserved complete on all complete or partial copies · Any translati valium overdose n or derived work must be approved by the author in writing before distribution. · If you distribute this work in part, instructions for obtaining the complete version of this manu valium overdose l must be included, and a means for obtaining a complete version provided. · Small portions may be reproduced as illustrations for reviews or quotes in other works without this per valium overdose ission notice if proper citation is given. Exceptions to these rules may be granted for academic purposes: Write to the author and ask. These restrictions are here to protect us valium overdose s authors, not to restrict you as learners and educators. Any source code (aside from the SGML this document was written in) in this document is placed under the GNU General Publ valium overdose c License, available via anonymous FTP from the GNU archive. 1.2. Feedback Comments (especially corrections) can be sent to asg@CommunityVision.com 1.3. valium overdose CHANGES · v1.3: inetd.conf error fix, authentication information added, more troubleshooting info · v1.2: SASL Config error fix, new postfix configuration, and database pruning valium overdose thanks, Jernej) · v1.1: Fixed sendmail.mc configuration file error and added IMAP information to the introduction. 1.4. Document Conventions · Italics signifies a directory · Th valium overdose s font signifies instructions to be ran at the command line 2. Introduction to IMAP 2.1. What is IMAP? This definition is from the ComputerUser.com High-Tech Dictionary : Internet Message Access Protocol. A protocol that allows a user to perform certain electronic mail functions on a remote server rather valium overdose han on a local computer. Through IMAP the user can create, delete, or rename mailboxes; get new messages; delete messages; and perform search functions on mail. A separate protocol is requ valium overdose red for sending mail. Also called Internet Mail Access Protocol. 2.2. IMAP vs. POP IMAP allows the user to read email from many different locations and accounts because email folders ar valium overdose stored on the server, locally, at the home or the office, for instance. Even saved and read messages are stored on the IMAP server. POP only stores new unread messages on the server, and valium overdose the read and saved messages are stored locally. To force POP to not delete email once it has been read can create many copies of the same email, creating a waste of space and confusion. Ho valium overdose ever, IMAP is usually more complicated to set up. If you only have one email account, POP is most likely your best choice. If you want to access more than one account, from different loca valium overdose ions, IMAP will probably serve you most efficiently. 2.3. Cyrus IMAP vs. Washington IMAP Cyrus has its own mailbox database which is standalone and increases performance, whereas Washin valium overdose ton uses the stanard UNIX mailbox format, which was designed for a smaller set of users. Washington is portable to more UNIX and non-UNIX systems than Cyrus. The main difference is that w valium overdose th Cyrus, you don't have to add new users to your linux box (i.e. in /etc/passwd) to add new mail users, and with Washington, you do. 3. Obtaining the Files 3.1. Cyrus Imap Homepage T valium overdose e homepage is currently located at: http://asg.web.cmu.edu/cyrus/imapd 3.2. Downloading the files You will need both IMAP and SASL. Download the lat valium overdose st files here: ftp://ftp.andrew.cmu.edu/pub/cyrus-mail Download cyrus-imapd-X.X.X.tar.gz and cyrus-sasl-X.X.X.tar.gz (where X.X.X is the latest valium overdose elease) into your temporary directory. I will use /temp as the directory I've uncompressed the files under for the rest of the examples. 4. Different SASL Authentication Methods 4.1. s valium overdose sldb This is the default method of authentication. It stores usernames and passwords in the SASL secrets file sasldb. In this HOWTO, I assume you are using the sasldb method of authentica valium overdose ion. 4.2. LDAP The following definition came from the OpenLDAP website. Lightweight Directory Access Protocol (LDAP) is an open-standard protocol for accessing information services. The valium overdose protocol runs over Internet transport protocols, such as TCP, and can be used to access stand- alone directory servers or X.500 directories. This method isn't discussed in this HOWTO, but valium overdose here is a link to a page with patches and info: http://www.openldap.org/faq/data/cache/428.html 4.3. PAM Not enough info to document. valium overdose mail me if you have some. 4.4. kerberos_v4 Not enough info to document. Email me if you have some. 5. Cyrus SASL 5.1. Uncompress Here we untar and gunzip the file in a single step. valium overdose . cd /temp 2. tar -zxvf cyrus-sasl-X.X.X.tar.gz 3. cd cyrus-sasl-X.X.X 5.2. Building the files For most purposes, the following set of instructions works fine. If you would like to valium overdose xamine the other configuration options, type ./configure --help | more 1. ./configure 2. make 3. make install If you don't want your password check to be the default sasldb, you mus valium overdose specify which one of PAM, kerberos_v4, passwd, shadow you wish to use. If PAM is the authentication you desire for example, you would type: ./configure --with-pwcheck_method=PAM instead valium overdose of the ./configure line above 6. Cyrus IMAP Installation 6.1. Uncompress The following commands will tar and gunzip cyrus IMAP under /temp. 1. cd /temp 2. tar -zxvf tar/cyrus-imapd-1. valium overdose .24.tar.gz 3. cd cyrus-imapd-1.6.24 6.2. A note on com_err.h When I tried to install cyrus IMAP, I got errors regarding the file com_err.h. My com_err.h was located in /usr/include/et. valium overdose t needs to reside in /usr/include. Run the following command to make sure it is in the correct location: locate com_err.h This will show you where the file is. If it is under /usr/inclu valium overdose e, you can skip to the next section. If it is in another directory, just copy it to /usr/include. If it doesn't exist, download it here: http://www.ludd.luth.se/~jnilsson/cvsweb/cvsweb.cg valium overdose /src/contrib/com_err . 6.3. Configure ./configure --with-auth=unix 6.4. Adding the default user Cyrus require valium overdose a user to own its files. The default user is cyrus. The following command adds a user cyrus with the group of "mail" useradd -g mail cyrus You'll want to set the password for user cyrus. valium overdose passwd cyrus Type in the password you desire cyrus to have each time you are prompted 6.5. Building the files 1. make depend 2. make all CFLAGS=-O 3. make install That's it! You' valium overdose e ready to configure Cyrus IMAP. 7. Cyrus IMAP Configuration 7.1. Editing conf files 1. Edit /etc/syslog.conf and add the following lines at the bottom: local6.debug /var valium overdose adm/imapd.log auth.debug /var/adm/auth.log 2. Edit a new file /etc/imapd.conf and place in it the following lines: configdirectory: /var/imap pa valium overdose tition-default: /var/spool/imap admins: cyrus root srvtab: /var/imap/srvtab allowanonymouslogin: no sasl_passwd_check: shadow If you don't wa valium overdose t your password check to be the default sasldb, you must specify which one of PAM, kerberos_v4, passwd, shadow you wish to use. If PAM is the authentication you desire for example, you wou valium overdose d type: sasl_passwd_check: pam instead of the line above 7.2. Creating the necessary directories This list of instructions will set up all the directories necessary for imap. 1. mkdi valium overdose /var/adm 2. touch /var/adm/imapd.log /var/adm/auth.log 3. mkdir /var/imap /var/spool/imap /var/imap/srvtab 4. chown cyrus /var/imap /var/spool/imap /var/imap/srvtab 5. chgrp mail /var/imap /var/spool/imap /var/imap/srvtab 6. chmod 750 /var/imap /var/spool/imap /var/imap/srvtab 7. su cyrus You are now the user cyrus. This is necessary for the files to have the correct owner and group. Continue: 1. tools/mkimap 2. cd /var/imap 3. chattr +S . user quota user/* quota/* 4. chattr +S /var/spool/imap 5. exit You are now root again. The last command: chattr +S /var/spool/mqueue 7.3. More configuration file editing 1. Edit /etc/services and check for the following lines. If they do not exist, add them: pop3 110/tcp imap 143/tcp imsp 406/tcp kpop 1109/tcp sieve 2000/tcp 2. Edit /etc/inetd.conf and comment out any imap and pop3 lines and add the following: imap stream tcp nowait cyrus
|
