Dear Wiki user, You have subscribed to a wiki page or wiki category on "James Wiki" for change notification.
The following page has been changed by BerndFondermann: http://wiki.apache.org/james/JamesPostage ------------------------------------------------------------------------------ == Overview == - Postage is a stand-alone application generating durable mail traffic on a James server instance. + Postage is a stand-alone application generating constant mail traffic on a James server instance. It can be considered being a load test tool. Postage records the resources used by James and supports finding resource leaks, for example memory bottlenecks. @@ -70, +70 @@ == Prepare James == + You should have a James instance readily installed. + This means at least extracted James binary and started the server once. + ''TBD: fill in link to James installation howto.'' + + === 1. Edit the configuration file JAMES_HOME/apps/james/SAR-INF/config.xml === + + ==== 1.1. Internal test domain ==== + + In the server names sections, add new line containing the virtual domain "mail.james.local". + This makes James consume all mails addressed to, for example [EMAIL PROTECTED] + + It should look something like this, depending on your further configuration preferences: + + {{{ + <servernames autodetect="true" autodetectIP="true"> + <!-- CONFIRM? --> + <servername>localhost</servername> + <servername>mail.james.local</servername> + </servernames> + }}} + + ==== 1.2.Sending external mail ==== + + All mail addresses not handled by James are delivered to their intended destination, if possible. + For Postage to intercept this and receive all mails send out by James, we must enable gateway forwarding. + + change + {{{ + <!-- + <gateway> otherserver.mydomain.com </gateway> + <gatewayPort>25</gatewayPort> + --> + }}} + into + {{{ + <gateway> localhost </gateway> + <gatewayPort>2525</gatewayPort> + }}} + + If Postage is running on another machine than James, you should use the appropriate host/port combination under which Postage is receiving mail. + + Now Postage is consuming '''all''' mail sent out by James and can try to align the mail it puts into James with mail coming out of the server. + + NOTE: This configuration makes James unable to deliver regular external mail, don't do this on a production system! + + === 2. Enable Postage to record memory and thread resource consumption of James === + + This is optional configuration. + + It only works, if James is run under JSE5 or newer and only if Postage has been build with JMX support. + TBD == Configure Postage ==