<?xml version="1.0" encoding="iso-8859-1" ?>
<rss version="2.0">
  <channel>
    <title>Test Forum</title>
    <link>http://www.emailthatworks.net/forum/list.php?1</link>
    <description><![CDATA[This is a test forum.  Feel free to try out the new forum system here.]]></description>
    <language>EN</language>
    <pubDate>Fri, 18 Aug 2006 11:43:26 -0700</pubDate>
    <lastBuildDate>Fri, 18 Aug 2006 11:43:26 -0700</lastBuildDate>
    <category>Test Forum</category>
    <generator>Phorum 5.1.15</generator>
    <ttl>600</ttl>
    <item>
      <title>Setup 2</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,15,20#msg-20</link>
      <author>jxh</author>
      <description><![CDATA[ -- moved topic -- ]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,15,20#msg-20</guid>
      <pubDate>Fri, 18 Aug 2006 11:43:26 -0700</pubDate>
    </item>
    <item>
      <title>Re: Second topic</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,3,14#msg-14</link>
      <author>jxh</author>
      <description><![CDATA[Hmm!  That &quot;Quote This Message&quot; stuff looks a bit odd under markdown.  I'll see if I can find where it comes up with it.]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,3,14#msg-14</guid>
      <pubDate>Thu, 17 Aug 2006 21:50:15 -0700</pubDate>
    </item>
    <item>
      <title>Re: Second topic</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,3,13#msg-13</link>
      <author>jxh</author>
      <description><![CDATA[hmb Wrote:
-------------------------------------------------------
&gt; Dunno, did the test pass?  :-)

Yes.]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,3,13#msg-13</guid>
      <pubDate>Thu, 17 Aug 2006 21:48:51 -0700</pubDate>
    </item>
    <item>
      <title>Re: Let's try some markdown</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,6,12#msg-12</link>
      <author>jxh</author>
      <description><![CDATA[OK, the [Phorum](http://www.phorum.org/) folks (via their own support Phorum, naturally) got me a corrected `markdown.php`, so we can start using it now.]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,6,12#msg-12</guid>
      <pubDate>Thu, 17 Aug 2006 21:42:14 -0700</pubDate>
    </item>
    <item>
      <title>Setup</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,11,11#msg-11</link>
      <author>jxh</author>
      <description><![CDATA[*Testing this format.  Many links do not yet work.  The content needs updating quite a bit.  I haven't decided yet if it should be in 8 or so separate threads, rather than this monolithic one; probably so.*

# Setup

This thread is for new customers of EmailThatWorks.net and IMAP Partners.

Your email service is powered by a [Mirapoint](http://www.mirapoint.com) internet message appliance. It is a high-performance IMAP server that also accepts POP, Webmail (HTTP) and WAP connections.

---

## Choosing an IMAP client

There are numerous good IMAP clients available, many of them for free. The most popular are Outlook and Outlook Express, but we don't recommend them. Thunderbird is a good replacement for Outlook that runs on many platforms, including both Windows and Macintosh.  Mac OS X comes with a native IMAP client called simply Mail.app. We have compiled a listing of tips, tricks, and caveats when using some of the more popular clients.

---

## Setting up your IMAP client

 There are many resources on the web to help you in setting up the popular IMAP clients. We won't try to repeat all that here. (Start with imap.org.) Please review the available sources for your program, and refer back here for specific caveats.

* Login with user@domain
* Set the server name
* SMTP Authenticaton required to relay
* If you really want POP...

Specifics of Mirapoint IMAP

* Mailboxes under INBOX
* Webmail hides the INBOX.* structure
* Webmail has a link to your account administration features
* Domain Adminstrators Beware!

---

### Login with user@domain

There are users in many domains sharing a single mail server. In order to distinguish among them, users must log in as user@domain, plus a password. Traditional POP servers may have required only a bare word username and a password, though they have started to go the FQDN-login route to solve the same scaling problem. Most IMAP clients have no problem with this, though some older versions of certain programs extracted the POP server hostname from the same field. If you have a separate place to enter the server hostname and the username field, you should be OK. Otherwise, use &quot;user@domain&quot; as your login. Some clients will have trouble with this, so it is possible to use &quot;user%domain&quot; instead, and the &quot;%&quot; will be translated to &quot;@&quot; internally.)

Repeat: You must login with user@domain, never just &quot;user&quot;. This is the source of much of the difficulty that new users have in getting set up on such a service. If you can't log in, check the username.If you can't log in, does it know what domain you are in? Sorry to beat this to death, but it will help to repeat it. 

---

###  Set the server name

Configure your IMAP server hostname as:

    m1.imap-partners.net

and your username as &quot;user@domain&quot; (not just &quot;user&quot;).

We strongly encourage you to use secure connections (via SSL) whenever possible, to protect your password as it travels over the Internet. This is often under an &quot;advanced&quot; or &quot;security&quot; setting.


Important

With Outlook (and, increasingly, other clients that behave like Outlook), you must also set the IMAP root folder path or prefix to &quot;INBOX.&quot;. This is so the mailbox names it uses for e.g. Sent Items and Drafts will end up in the right place. Otherwise these actions are likely to fail without warning. See below for more on this.

---

### SMTP  Authentication required to relay

You should configure your IMAP client's &quot;SMTP server hostname&quot; as m1.imap-partners.net, and you must enable SMTP Authentication, using the same username/password as for IMAP. Remember, the username must be your entire email address, &quot;user@domain&quot;, not just &quot;user&quot;.

This will make it possible for you to relay messages through that host. Relaying means that the destination is not on the same host. The SMTP server accepts your message, then makes an onward connection to deliver it to another SMTP host. If you don't enable SMTP authentication, you may get relaying denied errors.

Open relays are often abused to send spam. IMAP Partners is committed to fighting spam, and does not run any open relays. 

---

### If you really want POP...

IMAP Partners' Mirapoint server also provides POP access, though POP can only see INBOX. If you have a POP client downloading mail from your INBOX, you should set it for leave-on-server mode, or set delete mail to never. That way, no messages will end up only on your POP client.

---

### Mailboxes under INBOX

IMAP stores mail in mailboxes, in a tree structure. One special mailbox, called INBOX, is where your new mail arrives by default. You create other mailboxes and folders, and &quot;file&quot; messages by moving them from INBOX to other mailboxes.

Mailboxes in IMAP have names, just as files have names on the disk drive of your computer. In Windows, the pathname separator is the backslash (\). In IMAP, the separator is implementation-dependent. Mirapoint uses the period (.), so an IMAP mailbox name might look like INBOX.work. Many IMAP clients display this structure graphically, so you may not see the full, true mailbox name very often. But it's important to understand how it works.

Popular IMAP servers fall into two categories: Cyrus and UW (or Cyrus-like and UW-like). We call this the IMAP &quot;namespace type&quot;. In Cyrus, a user's personal mailboxes are lexically under the INBOX, and shared mailboxes are at the same level as INBOX (the top level). In UW a user's personal mailboxes are at the same lexical level as INBOX, so shared mailboxes (including other users' mailboxes, if you can read them) must start with a special prefix character, in this &quot;#&quot;. 



  
    True internal mailbox(admin protocol)
    IMAP mailbox name(as seen by &quot;bob&quot;)
  
  
    Cyrus*
    UW **
  
  
user.bob
user.bob.Drafts
&quot;user.bob.Sent Items&quot;
user.bob.friends
user.bob.work
user.bob.work.joe
user.joe
user.joe.stuff
archive
archive.old
announce

INBOX
INBOX.Drafts
&quot;INBOX.Sent Items&quot;
INBOX.friends
INBOX.work
INBOX.work.joe
user.joe
user.joe.stuff
archive
archive.old
announce

INBOX
Drafts
&quot;Sent Items&quot;
friends
work
work.joe
#user.joe
#user.joe.stuff
#archive
#archive.old
#announce




* Our system uses the Cyrus IMAP namespace.
** This shows Mirapoint with UW namespace option; actual UW imapd uses '/' as a separator.

Your INBOX is actually called user.yourusername, and is seen as such by the other users (if you permit it), and from the command-line interface used by the domain administrator. INBOX is actually just an alias for user.yourusername during an IMAP session authenticated as yourusername.

How IMAP clients portray this hierarchy varies, but generally they indent mailbox name parts to indicate levels. (Usually, there is also a + or - icon to expand or collapse a level.) 



- INBOX
    Drafts
    Sent Items
    friends
  - work
      joe
- user
  - joe
      stuff
- archive
    old
  announce



Our own Webmail Direct looks like UW (in spite of Cyrus being the default IMAP namespace), but is nothing to do with IMAP. Webmail Direct also puts a horizontal rule after (below) its predefined personal mailboxes (which it creates on first login). But this is for display only and is not reflected in any protocol. (Shared mailboxes are displayed separately.)



  INBOX
  Draft
  Junk Mail
  Sent
  Trash
  -----------
  friends
- work
    joe



Shared mailboxes are useful for storing archives and other messages that don't belong to one user or another. You can also set permissions on your personal mailboxes to give controlled access to other users in your domain.

But, with many IMAP clients (starting with Outlook but increasingly common), shared folders are difficult to use if you also want to use certain other features of your IMAP client. Outlook uses fixed mailbox names for things like &quot;Sent Items&quot; and &quot;Drafts&quot; (not to mention &quot;Trash&quot;). If you want these features to work, you must find the often deeply-hidden setting in your IMAP client to force it to prepend &quot;INBOX.&quot; (note trailing dot) to every mailbox name it uses in talking to the server. Doing so makes it impossible to see any shared mailboxes, but failure to do so will make actions like saving sent mail fail without warning. You and your users will wonder why the mail isn't being saved.

Observant Outlook users may also note the discrepancy between some of Outlook's fixed, predefined mailbox names (Drafts, Sent Items) and those of Webmail Direct (Draft, Sent). A user may end up with all of these if they use both methods. Webmail Direct can at least be configured with Preferences to use other mailbox names for some of these.

See the clients page for details on how to set up your IMAP client to do this.

---

### Webmail hides the INBOX.* structure

When you log into your Webmail Direct account, you will notice that, contrary to the view from an IMAP client, your personal mailboxes appear to be at the same lexical level as your INBOX. This is an illusion.

---

### Webmail has a link to your account administration features

The ServerRoot of the web server at m1.imap-partners.net is configured to take you straight to the Webmail Direct login. Once logged in, you can use the Options link to access administration features for your account.

Users or domain administrators who wish to log directly into the Mirapoint Suite to administer their accounts or domains can refer to /madmin on that server. IMAP Partners encourages the use of SSL-protected sessions whenever possible, for HTTP as well as for POP, IMAP, or SMTP (TLS).

---

### Domain Administrators Beware!

If you are the primary account-holder for your domain, you will have domain administrator privileges. This means, among other things, that you can, through the IMAP protocol, create shared mailboxes at the top level in your domain. Outlook in particular wants to do this for all users by default; you must specifically instruct it to put your personal mailboxes under INBOX. If you create a mailbox called e.g. Drafts, you will have created a shared mailbox called Drafts, when what you probably meant was to create INBOX.Drafts.

After you create this shared mailbox, you may discover your mistake and try to delete it, but you will get a Permission denied error. This is because, by default, mailboxes get the ACLs of their parents; INBOX.Drafts would have had INBOX as a parent, and it would have got explicit delete permission for your username. But since it was shared, it was not considered &quot;owned&quot; by you. You can, as domain administrator, change the ACLs on this mailbox, to give yourself &quot;delete&quot; permission, then delete it.

Here's what it looks like from the command line (via SSH), after user &quot;mark&quot;, a domadmin, got it wrong first, then right, and wants to clean up the mess: 



m1.imap-partners.net&gt; mailbox list
() &quot;.&quot; Drafts
() &quot;.&quot; &quot;Sent Items&quot;
(\Noselect) &quot;.&quot; user
() &quot;.&quot; user.mark
() &quot;.&quot; user.mark.Drafts
() &quot;.&quot; &quot;user.mark.Sent Items&quot;
OK Completed
m1.imap-partners.net&gt; mailbox getacl Drafts
Drafts anyone lrs
OK Completed
m1.imap-partners.net&gt; mailbox setacl Drafts anyone +d
m1.imap-partners.net&gt; mailbox delete Drafts
m1.imap-partners.net&gt; mailbox setacl &quot;Sent Items&quot; anyone +d
m1.imap-partners.net&gt; mailbox delete &quot;Sent Items&quot;
m1.imap-partners.net&gt; mailbox list
(\Noselect) &quot;.&quot; user
() &quot;.&quot; user.mark
() &quot;.&quot; user.mark.Drafts
() &quot;.&quot; &quot;user.mark.Sent Items&quot;
OK Completed



To avoid this problem, IMAP Partners makes a practice of assigning domain administrator privilege to the primary account-holder only after he or she has successfully got an IMAP client set up. Contact support when you get this far.]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,11,11#msg-11</guid>
      <pubDate>Thu, 17 Aug 2006 20:35:08 -0700</pubDate>
    </item>
    <item>
      <title>Re: Phorum problems on this site</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,9,10#msg-10</link>
      <author>jxh</author>
      <description><![CDATA[I have it configured to send errors to the administrator by email, rather than to display them on the screen.  I have a couple of them.  Will investigate.

--

Known problem with permissions vis-a-vis MySQL and temporary tables.  I have turned off the bit that makes it try to use them (couldn't find the exact GRANT command to enable the privilege).  I also made errors go to the screen, since the alternative is so nasty for the end user.  I daresay people will report errors to us if they see them.

Search works now.

--

And foidamore, after I found and ran the `mysql_fix_privilege_tables` script (necessary across certain upgrades that evidently bit us), we can run searches with temporary tables (a performance improvement, it says here).  I still have errors configured to appear to the user.]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,9,10#msg-10</guid>
      <pubDate>Thu, 17 Aug 2006 19:23:04 -0700</pubDate>
    </item>
    <item>
      <title>Phorum problems on this site</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,9,9#msg-9</link>
      <author>hmb</author>
      <description><![CDATA[Hit Search.  Search all forums (fora??) for a phrase e.g. &quot;markdown&quot;.
The &quot;please wait&quot; screen appears for a few seconds, then is replaced
by a blank.

What a bummer.  :-)

[jxh: let's see if I can edit someone else's message.]]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,9,9#msg-9</guid>
      <pubDate>Thu, 17 Aug 2006 15:04:43 -0700</pubDate>
    </item>
    <item>
      <title>Re: Second topic</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,3,8#msg-8</link>
      <author>hmb</author>
      <description><![CDATA[Dunno, did the test pass?  :-)]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,3,8#msg-8</guid>
      <pubDate>Thu, 17 Aug 2006 15:01:36 -0700</pubDate>
    </item>
    <item>
      <title>Let's try some markdown</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,6,6#msg-6</link>
      <author>jxh</author>
      <description><![CDATA[Per [markdown](http://daringfireball.net/projects/markdown/syntax#p) and [php-markdown](http://www.michelf.com/projects/php-markdown/concepts/) this is supposed to work:

*emphasis*  &amp;copy;  AT&amp;T

*   Thing 1
    + foo
    + bar
*   Thing 2
    + baz

Regular para.  Needed or markdown won't recognize the ordered list to follow:

1. Ordered list item 1
1. Item 2

&gt; blockquote this in a
&gt; single paragraph

_See Also:_

* [Formatting Help](read.php?3,118), now part of the template.]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,6,6#msg-6</guid>
      <pubDate>Wed, 16 Aug 2006 21:30:13 -0700</pubDate>
    </item>
    <item>
      <title>Second topic</title>
      <link>http://www.emailthatworks.net/forum/read.php?1,3,3#msg-3</link>
      <author>jxh</author>
      <description><![CDATA[And another test]]></description>
      <category>Test Forum</category>
      <guid isPermaLink="true">http://www.emailthatworks.net/forum/read.php?1,3,3#msg-3</guid>
      <pubDate>Wed, 16 Aug 2006 19:56:17 -0700</pubDate>
    </item>
  </channel>
</rss>
