diff options
author | kpfleming <kpfleming@f38db490-d61c-443f-a65b-d21fe96a405b> | 2006-10-24 03:15:31 +0000 |
---|---|---|
committer | kpfleming <kpfleming@f38db490-d61c-443f-a65b-d21fe96a405b> | 2006-10-24 03:15:31 +0000 |
commit | 78ad5683385688f3afe17fccf38c57be70278aab (patch) | |
tree | 46cf3e32f2c78b75391df767aa5aef2ed1a03d97 /doc | |
parent | 6895e3748692994e604488e115b8c822262304b3 (diff) |
Merged revisions 46080 via svnmerge from
https://origsvn.digium.com/svn/asterisk/branches/1.4
........
r46080 | kpfleming | 2006-10-23 22:13:08 -0500 (Mon, 23 Oct 2006) | 2 lines
simplify and correct voicemail IMAP storage build instructions
........
git-svn-id: http://svn.digium.com/svn/asterisk/trunk@46081 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'doc')
-rw-r--r-- | doc/imapstorage.txt | 46 |
1 files changed, 26 insertions, 20 deletions
diff --git a/doc/imapstorage.txt b/doc/imapstorage.txt index 69946bea5..c0cee0dbc 100644 --- a/doc/imapstorage.txt +++ b/doc/imapstorage.txt @@ -41,26 +41,41 @@ University of Washington IMAP C-Client You will need a source distribution of University of Washington's IMAP c-client (http://www.washington.edu/imap/). Asterisk supports both the 2004 and 2006 versions of c-client, however mail_expunge_full is enabled -in the 2006 version. You will want to make the appropriate changes -to the c-client Makefile, for instance: +in the 2006 version. -EXTRAAUTHENTICATORS=gss -EXTRADRIVERS=mbox +Note that Asterisk only uses the 'client' portion of the UW IMAP toolkit, +but building it also builds an IMAP server and various other utilities. +Because of this, the build instructions for the IMAP toolkit are somewhat +complicated and can lead to confusion about what is needed. -In src/osdep/unix/Makefile, set CREATEPROTO to mbxproto. This is done -to utilize mbx mailbox format (see below). +If you are going to be connecting Asterisk to an existing IMAP server, +then you don't need to care about the server or utilities in the IMAP +toolkit at all. If you want to also install the UW IMAPD server, that +is outside the scope of this document. -Compile c-client and verify that a c-client.a file has been generated. +Building the c-client library is fairly straightforward; for example, on a +Debian system there are two possibilities: + +1) if you will not be using SSL to connect to the IMAP server: + $ make slx SSLTYPE=none + +2) if you will be using SSL to connect to the IMAP server: + $ make slx EXTRACFLAGS="-I/usr/include/openssl" + +Once this completes you can proceed with the Asterisk build; there is no +need to run 'make install'. ------------------ Compiling Asterisk ------------------ Configure with ./configure --with-imap=/usr/src/imap -or where ever you built the University of Washington IMAP C-Client. -Then make menuselect go to voicemail options and check the imap box -then make, make install and asterisk will have imap storage support for -voicemail. +or where ever you built thfe UWashington IMAP Toolkit. When you run +'make menuselect', choose 'Voicemail Build Options' and the +IMAP_STORAGE option should be available for selection. + +After selecting it, use the 'x' key to exit menuselect and save +your changes, and the build/install Asterisk normally. --------------------- Modify voicemail.conf @@ -87,15 +102,6 @@ Kerberos. They are defined to allow Asterisk to authenticate as a single user that has access to all mailboxes as an alternative to Kerberos. -------------- -Mailbox Format --------------- -Mailboxes should use the "mbx" mailbox format. The "mbox" format does not -support concurrent access to mailboxes, which can cause deadlock or strange -behaviors. You can convert mailboxes from mbox to mbx using mailutil: - -mailutil copy INBOX #driver.mbx/INBOX - --------------- IMAP Folders -------------- Besides INBOX, users should create "Old", "Work", "Family" and "Friends" |