

                 ***   Using the Evolution Brutus Connector  ***
                     Copyright (C) 2005-2008 OMC Denmark ApS

Your rights
===========

Copying and distribution of this file, with or without modification, are 
permitted in any medium without royalty provided the copyright notice and this 
notice are preserved.
                

How to create an email account using evolution-brutus
=====================================================

You must create a Brutus email account in Evolution after installing
e-b. Please use:

Receiving Email:

    Account type:            "Microsoft Exchange (Courtesy of Brutus)"

    Server:                  <DNS resolvable name or IP address of the 
    			      Exchange server>

    Username:                <Your Windows Domain User username>

Receiving Options:

    Exchange Email Address:  <Email address of Exchange mailbox to access>

    Windows Domain:          <Windows Domain name for the User>

    Brutus Server:           <DNS resolvable name or IP address of the 
                              Brutus server>

    Brutus Server Port:      <Brutus Server IIOP port number. This is 
      	   	  	      configured at the server side, default=2003>

Password
========

You must use your Windows Domain password when prompted for your password.


Beyond email
============

You may choose to support the Exchange Calendar, Tasks, Notes and public
folders if the remote Exchange server provides such support. Simply open
up your Evolution Preferences and edit your account accordingly. You must
restart Evolution after having modified your evolution-brutus account
settings.


Known problems
==============

evolution-brutus is still in development but is perfectly usable by 
non-technical users. You must use Lorica if there is a firewall in between
the Brutus server and the evolution-brutus client. Please read more about
Lorica at http://lorica.42tools.com.


Supported Microsoft Exchange Server versions
============================================

Microsoft Exchange Server 5.5 or later versions. Exchange 5.5 has recieved 
the most testing though.


Reporting problems
==================

You can always help by reporting problems to <bugs@42tools.com> or preferably to
the 42tools bugzilla: 

   <http://bugzilla.42tools.net/>

or by subcribing to the brutus mailing list and posting your problem to the list:

   <http://www.42tools.com/mailman/listinfo/brutus/>

evolution-brutus, if build with debugging support, will generate a nice log that 
you are encouraged to attach to your problem report. To tell evolution-brutus to 
generate the log just create a file named ".brutus-do-debug" in your home 
directory. It doesn't need to be a regular file. It could be a directory or a 
link.

All log output will be appended to "~/.brutus-logd/brutus.log" by the Brutus Log 
daemon. Please append this file to all bug reports and describe how to reproduce 
the problem if possible.

You can tell the log daemon to restart itself and start all over with an empty 
log file. Just send SIGUSR2 to the log daemon:

      $ kill -s USR2 $(cat ~/.brutus-logd/brutus-logd.pid)

Enjoy,
   Jules Colding
   <colding@42tools.com>
