Import and Export

For moving from one mail server to another, WebSTAR Mail allows you to import user information and messages and export them to a standard format.

WebSTAR Mail Export Formats

WebSTAR Mail has a simple tagged format for importing and exporting mail user settings and messages. It has tags and attributes, and can be read by SGML or XML processors.

Be careful with these export files -- they contain user passwords. You should store them only in secure locations, such as computers which do not serve any data.

This example shows an outgoing message from the Queue, with user and message data.

 

<user unique=000000BF mailbox="test@domain.com" alias="test" passwordc="a8cr1S" apop="a8cr1S" isSysop=0 emailStorage=0 emailMessages=0 requireApop=0 mailboxCreate=0 mailboxDestroy=0 mailboxRename=0 forwardTo="">

 
<email to="test@domain.com">

 
Return-Path: &lt;elaine@example.com&gt;

 
Received: from mail.example.com. by www.domain.com. [192.168.0.7]; Mon, 24 May 1999 17:39:59 -0700

 
From: testing webstar &lt;elaine@example.com&gt;

 
To: test@domain.com

 
Subject: test

 
Message-ID: &lt;v04205227b36fa19e4d14@[192.168.0.7]&gt;

 
Date: Mon, 24 May 1999 17:39:59 -0700

 
MIME-Version: 1.0

 
Content-Type: text/plain; charset=&quot;ISO-8859-1&quot;

 
Content-Transfer-Encoding: 8bit

 
</email>

Mail Export User Information

The <user> tag stores the User Setting attributes as described in Users & Accounts Settings :

unique: the unique ID
mailbox: the email address
alias: the user name
passwordc: the password
apop: the APOP password
isSysop: whether this is the Postmaster account

A value of 0 in the storage, messages and APOP fields means that the user account conforms to the default settings for this server.

emailStorage: limits on the size of the server mailboxes
emailMessages: limit on the number of messages on the server
requireAPOP: whether APOP is required for POP login
mailboxCreate: whether IMAP clients can create mailboxes
mailboxDestroy: whether IMAP clients can delete mailboxes
mailboxRename: whether IMAP clients can rename mailboxes
forwardTo: forwarding address for alias accounts.

Mail Export Message Part

The <email> tag has one attribute, which stores the email address of the recipient, the body stores the body of the mail message, including message headers, and enclosures, which are stored with encoding, such as Base64,. All quotes and brackets (<>) are converted to their HTML equivalents, such as &quote; .

Import User Mailboxes

WebSTAR Mail allows you to import user mailboxes, containing all current messages, from EIMS (Eudora Internet Mail Server) or AIMS (Apple Internet Mail Server).

1 If the old mail server is running, shut it down and quit the application.
2 Make sure you have the correct Host entries in the WebSTAR Admin, Mail Settings Hosts panel.
3 Launch the Mailbox Extraction Tool (in the Tools & Examples folder).
4 Select Choose Mail Folder from the File menu.
5 Select a folder or mailbox file from the old server's folder, and click Choose .

The old server folder is probably in the Mail folder in the System folder.

6 Give the export file any name (or use the default Mailbox Extraction.sgml ) and click Save .
7 Launch WebSTAR Admin on the same machine, choose the Mail Settings Users & Accounts panel, and click the Import button.
8 Now you can select the export file, and WebSTAR Mail will create new user accounts and import the old mail into each user's account, just as it was on the old server.

Exporting Mail Users and Messages

You can export mail user information, and even messages on the server, into text files for local storage.

For details of the format see WebSTAR Mail Export Formats .

To export the user and message information, open the WebSTAR Admin, choose Mail Settings, Users and Accounts, and click the Export button at the lower left.

Options are:

Selected User and Mail: includes the user name, password, and other information, as well as the mail messages stored on the server, in the WebSTAR Mail Export Formats .
All Users and Mail: user settings and server messages for all users in the WebSTAR Mail Export Formats
User List Tab Delimited: user list with a header line at the beginning and a row for each entry with user name, password, and other information, separated by tab characters into columns.
Export User List SGML Format: user list in the WebSTAR Mail Export Formats , without messages.
Outgoing Mail Queue: messages from the Queue, in the WebSTAR Mail Export Formats , with the user information, message and any enclosure.

By default, the file is named Mail Users , but you can and should change the name to reflect the contents and date.

Be careful with these files -- they contain passwords and should be secured at all times.