Author: bago
Date: Mon Aug 7 08:05:18 2006
New Revision: 429361
URL: http://svn.apache.org/viewvc?rev=429361&view=rev
Log:
Introduced maven2 pom to build postage site.
Added:
james/postage/trunk/pom.xml (with props)
james/postage/trunk/src/site/
james/postage/trunk/src/site/resources/
james/postage/trunk/src/site/resources/images/
james/postage/trunk/src/site/resources/images/asf-logo-reduced.gif (with
props)
james/postage/trunk/src/site/resources/images/james-postage-logo.gif
(with props)
james/postage/trunk/src/site/site.xml
james/postage/trunk/src/site/xdoc/
james/postage/trunk/src/site/xdoc/index.xml
james/postage/trunk/src/site/xdoc/prepare_james.xml
Added: james/postage/trunk/pom.xml
URL:
http://svn.apache.org/viewvc/james/postage/trunk/pom.xml?rev=429361&view=auto
==============================================================================
--- james/postage/trunk/pom.xml (added)
+++ james/postage/trunk/pom.xml Mon Aug 7 08:05:18 2006
@@ -0,0 +1,331 @@
+<?xml version="1.0" encoding="ISO-8859-15"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<!--
+ | DISCLAIMER DISCLAIMER DISCLAIMER DISCLAIMER DISCLAIMER
+ |
+ | This file is only intended to be used to build the james-server
+ | website. It must not be used to build packages for james-server
+ | application.
+ |
+ | DISCLAIMER DISCLAIMER DISCLAIMER DISCLAIMER DISCLAIMER
+ -->
+<project>
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>org.apache.james</groupId>
+ <artifactId>james-postage</artifactId>
+ <name>Apache JAMES Postage Project</name>
+ <version>0.1-SNAPSHOT</version>
+ <packaging>jar</packaging>
+ <description>
+ Postage is a tool to test mail server perfomance/stability.
+ </description>
+ <parent>
+ <groupId>org.apache.james</groupId>
+ <artifactId>james-project</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ </parent>
+ <url>http://james.apache.org/postage/index.html</url>
+ <inceptionYear>2006</inceptionYear>
+
+ <issueManagement>
+ <system>jira</system>
+ <url>http://issues.apache.org/jira/browse/POSTAGE</url>
+ </issueManagement>
+
+ <ciManagement>
+ <system>continuum</system>
+ <notifiers>
+ <notifier>
+ <type>mail</type>
+ <sendOnError />
+ <sendOnFailure />
+ <address>[email protected]</address>
+ </notifier>
+ </notifiers>
+ </ciManagement>
+
+ <mailingLists>
+ <mailingList>
+ <name>Server User List</name>
+ <subscribe>[EMAIL PROTECTED]</subscribe>
+ <unsubscribe>[EMAIL PROTECTED]</unsubscribe>
+
<archive>http://www.mail-archive.com/[email protected]/</archive>
+ </mailingList>
+ <mailingList>
+ <name>Server Developer List</name>
+ <subscribe>[EMAIL PROTECTED]</subscribe>
+ <unsubscribe>[EMAIL PROTECTED]</unsubscribe>
+ <post>[email protected]</post>
+
<archive>http://www.mail-archive.com/[email protected]/</archive>
+ </mailingList>
+ <mailingList>
+ <name>James General List</name>
+ <subscribe>[EMAIL PROTECTED]</subscribe>
+ <unsubscribe>[EMAIL PROTECTED]</unsubscribe>
+ <archive>http://www.mail-archive.com/[EMAIL PROTECTED]/</archive>
+ </mailingList>
+ </mailingLists>
+
+ <scm>
+ <connection>
+ scm:svn:http://svn.apache.org/repos/asf/james/postage/trunk
+ </connection>
+ <developerConnection>
+ scm:svn:https://[EMAIL PROTECTED]/repos/asf/james/postage/trunk
+ </developerConnection>
+ <url>
+ http://svn.apache.org/viewcvs.cgi/james/postage/trunk?root=Apache-SVN
+ </url>
+ </scm>
+
+ <repositories>
+ <repository>
+ <id>bago-dist-m1</id>
+ <name>Temporary Repository</name>
+ <url>http://people.apache.org/~bago/maven/dist-m1</url>
+ <layout>legacy</layout>
+ <snapshots>
+ <enabled>true</enabled>
+ <checksumPolicy>ignore</checksumPolicy>
+ </snapshots>
+ </repository>
+ </repositories>
+
+ <dependencies verbose="true">
+
+ <dependency>
+ <groupId>javax.mail</groupId>
+ <artifactId>mail</artifactId>
+ <version>1.4</version>
+ </dependency>
+
+ <dependency>
+ <groupId>avalon-framework</groupId>
+ <artifactId>avalon-framework-api</artifactId>
+ <version>4.3</version>
+ </dependency>
+
+ <dependency>
+ <groupId>avalon-framework</groupId>
+ <artifactId>avalon-framework-impl</artifactId>
+ <version>4.3</version>
+ <exclusions>
+ <exclusion>
+ <groupId>jmock</groupId>
+ <artifactId>jmock</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>xalan</groupId>
+ <artifactId>xalan</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>xml-apis</groupId>
+ <artifactId>xmlParserAPIs</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>xml-apis</groupId>
+ <artifactId>xml-apis</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>log4j</groupId>
+ <artifactId>log4j</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>geronimo-spec</groupId>
+ <artifactId>geronimo-spec-javamail</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>geronimo-spec</groupId>
+ <artifactId>geronimo-spec-jms</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>javax.servlet</groupId>
+ <artifactId>servlet-api</artifactId>
+ </exclusion>
+ </exclusions>
+ </dependency>
+
+ <dependency>
+ <groupId>commons-lang</groupId>
+ <artifactId>commons-lang</artifactId>
+ <version>2.1</version>
+ </dependency>
+
+ <dependency>
+ <groupId>commons-logging</groupId>
+ <artifactId>commons-logging</artifactId>
+ <version>1.0.4</version>
+ </dependency>
+
+ <dependency>
+ <groupId>commons-configuration</groupId>
+ <artifactId>commons-configuration</artifactId>
+ <version>1.2</version>
+ <exclusions>
+ <exclusion>
+ <groupId>commons-codec</groupId>
+ <artifactId>commons-codec</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>javax.servlet</groupId>
+ <artifactId>servlet-api</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>xerces</groupId>
+ <artifactId>xercesImpl</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>commons-beanutils</groupId>
+ <artifactId>commons-beanutils-core</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>dom4j</groupId>
+ <artifactId>dom4j</artifactId>
+ </exclusion>
+ </exclusions>
+ </dependency>
+
+ <dependency>
+ <groupId>commons-net</groupId>
+ <artifactId>commons-net</artifactId>
+ <version>1.4.1</version>
+ </dependency>
+
+ <dependency>
+ <groupId>cornerstone-sockets</groupId>
+ <artifactId>cornerstone-sockets-api</artifactId>
+ <version>2.1</version>
+ </dependency>
+
+ <dependency>
+ <groupId>cornerstone-sockets</groupId>
+ <artifactId>cornerstone-sockets-impl</artifactId>
+ <version>2.1</version>
+ <exclusions>
+ <exclusion>
+ <groupId>xml-apis</groupId>
+ <artifactId>xml-apis</artifactId>
+ </exclusion>
+ </exclusions>
+ </dependency>
+
+ <dependency>
+ <groupId>org.apache.james</groupId>
+ <artifactId>james-server</artifactId>
+ <version>2.3.0-SNAPSHOT</version>
+ </dependency>
+
+ <dependency>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>3.8.1</version>
+ <scope>test</scope>
+ </dependency>
+
+ </dependencies>
+
+ <distributionManagement>
+ <repository>
+ <id>james-repo</id>
+ <name>James Central Repository</name>
+ <url>scp://minotaur.apache.org/www/james.apache.org/dist-m2</url>
+ </repository>
+ <snapshotRepository>
+ <id>james-snapshots</id>
+ <name>James Central Development Repository</name>
+
<url>scp://minotaur.apache.org/www/james.apache.org/dist-m2-snapshot</url>
+ </snapshotRepository>
+ <site>
+ <id>james-website</id>
+
<url>scp://minotaur.apache.org/www/james.apache.org/public_html/maven/</url>
+ </site>
+ </distributionManagement>
+
+ <build>
+ <resources>
+ <resource>
+ <directory>src/main/resources</directory>
+ </resource>
+ </resources>
+
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-jar-plugin</artifactId>
+ <configuration>
+ <archive>
+ <manifest>
+ <mainClass>org.apache.james.postage.Main</mainClass>
+ <packageName>org.apache.james.postage</packageName>
+ <addClasspath>true</addClasspath>
+ </manifest>
+ <manifestEntries>
+ <mode>development</mode>
+ <url>${pom.url}</url>
+ </manifestEntries>
+ </archive>
+ </configuration>
+ </plugin>
+ <plugin>
+ <artifactId>maven-assembly-plugin</artifactId>
+ <configuration>
+ <descriptorRefs>
+ <descriptorRef>bin</descriptorRef>
+ <descriptorRef>src</descriptorRef>
+ </descriptorRefs>
+ </configuration>
+ </plugin>
+ </plugins>
+
+ </build>
+
+ <reporting>
+ <plugins>
+ <plugin>
+ <artifactId>maven-surefire-plugin</artifactId>
+ </plugin>
+ <plugin>
+ <artifactId>maven-javadoc-plugin</artifactId>
+ </plugin>
+ <plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>jxr-maven-plugin</artifactId>
+ </plugin>
+ <plugin>
+ <artifactId>maven-pmd-plugin</artifactId>
+ <configuration>
+ <targetjdk>1.4</targetjdk>
+ <rulesets>
+ <ruleset>/rulesets/basic.xml</ruleset>
+ <ruleset>/rulesets/controversial.xml</ruleset>
+ </rulesets>
+ <format>xml</format>
+ <linkXref>true</linkXref>
+ <sourceEncoding>utf-8</sourceEncoding>
+ <minimumTokens>100</minimumTokens>
+ </configuration>
+ </plugin>
+ <plugin>
+ <artifactId>maven-site-plugin</artifactId>
+ </plugin>
+ </plugins>
+ </reporting>
+
+</project>
\ No newline at end of file
Propchange: james/postage/trunk/pom.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: james/postage/trunk/src/site/resources/images/asf-logo-reduced.gif
URL:
http://svn.apache.org/viewvc/james/postage/trunk/src/site/resources/images/asf-logo-reduced.gif?rev=429361&view=auto
==============================================================================
Binary file - no diff available.
Propchange: james/postage/trunk/src/site/resources/images/asf-logo-reduced.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: james/postage/trunk/src/site/resources/images/james-postage-logo.gif
URL:
http://svn.apache.org/viewvc/james/postage/trunk/src/site/resources/images/james-postage-logo.gif?rev=429361&view=auto
==============================================================================
Binary file - no diff available.
Propchange: james/postage/trunk/src/site/resources/images/james-postage-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: james/postage/trunk/src/site/site.xml
URL:
http://svn.apache.org/viewvc/james/postage/trunk/src/site/site.xml?rev=429361&view=auto
==============================================================================
--- james/postage/trunk/src/site/site.xml (added)
+++ james/postage/trunk/src/site/site.xml Mon Aug 7 08:05:18 2006
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<project name="Postage">
+ <bannerLeft>
+ <name>James Postage</name>
+ <src>images/james-postage-logo.gif</src>
+ <href>http://james.apache.org/postage/index.html</href>
+ </bannerLeft>
+
+ <bannerRight>
+ <name>The Apache Software Foundation</name>
+ <src>images/asf-logo-reduced.gif</src>
+ <href>http://www.apache.org/index.html</href>
+ </bannerRight>
+
+ <body>
+
+ <menu name="Postage">
+ <item name="Overview" href="index.html"/>
+ <item name="Prepare James" href="prepare_james.html"/>
+ </menu>
+
+ ${reports}
+
+ </body>
+</project>
Added: james/postage/trunk/src/site/xdoc/index.xml
URL:
http://svn.apache.org/viewvc/james/postage/trunk/src/site/xdoc/index.xml?rev=429361&view=auto
==============================================================================
--- james/postage/trunk/src/site/xdoc/index.xml (added)
+++ james/postage/trunk/src/site/xdoc/index.xml Mon Aug 7 08:05:18 2006
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<document>
+ <properties>
+ <title>Overview</title>
+ <author email="[email protected]">James jSPF Project
Team</author>
+ </properties>
+ <body>
+ <section name="Overview">
+ <p>Postage is a stand-alone application generating constant mail traffic
on a James server instance. It can be considered being a load test tool.</p>
+ <p>Postage records the resources used by James and supports finding
resource leaks, for example memory bottlenecks.</p>
+ <p>While putting load on James, Postage also records the resulting mail
traffic and tries to match incoming and outgoing mail making it possible to use
it for end-to-end test.</p>
+ <p>It's flexible enough to mimic many real-world load scenarios, for
example</p>
+ <ul>
+ <li>many users, each receiving few mails every day</li>
+ <li>few users, heavily receiving mails</li>
+ <li>moderate mail traffic, yet very big attachments</li>
+ </ul>
+ </section>
+ <section name="Features">
+ <ul>
+ <li>Easy XML-file-based configuration with multiple running scenarios
for different load profiles</li>
+ <li>Supports unlimited number of internal and external users.</li>
+ <li>Within one scenario supports different email profiles running in
parallel. Every profile has its own specification in terms of</li>
+ <ul>
+ <li>number of generated mails per minute</li>
+ <li>sender/receiver</li>
+ <li>mail size</li>
+ </ul>
+ <li>Records incoming and outgoing mails and matches them to keep track
of successful and failed deliveries</li>
+ <li>Is able to record the Mail Servers thread and heap memory
consumption (only Java SE 5)</li>
+ </ul>
+ </section>
+ </body>
+</document>
\ No newline at end of file
Added: james/postage/trunk/src/site/xdoc/prepare_james.xml
URL:
http://svn.apache.org/viewvc/james/postage/trunk/src/site/xdoc/prepare_james.xml?rev=429361&view=auto
==============================================================================
--- james/postage/trunk/src/site/xdoc/prepare_james.xml (added)
+++ james/postage/trunk/src/site/xdoc/prepare_james.xml Mon Aug 7 08:05:18 2006
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<document>
+ <properties>
+ <title>Prepare James</title>
+ <author email="[email protected]">James jSPF Project
Team</author>
+ </properties>
+ <body>
+ <section name="Prepare James">
+ <p>You should have a James instance readily installed. This means at
least extracted James binary and started the server once (see <a
href="http://wiki.apache.org/james/JamesQuickstart";>JamesQuickstart</a>).</p>
+ </section>
+ <section name="Edit the configuration file
JAMES_HOME/apps/james/SAR-INF/config.xml">
+ <subsection name="Internal test domain">
+ <p>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 [MAILTO] [EMAIL PROTECTED]</p>
+ <p>It should look something like this, depending on your further
configuration preferences:</p>
+ <source>
+<servernames autodetect="true" autodetectIP="true">
+ <!-- CONFIRM? -->
+ <servername>localhost</servername>
+ <servername>mail.james.local</servername>
+</servernames>
+ </source>
+ </subsection>
+ <subsection name="Sending external mail">
+ <p>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.</p>
+ <p>change</p>
+ <source>
+<gateway> otherserver.mydomain.com </gateway>
+<gatewayPort>25</gatewayPort>
+ </source>
+ <p>into</p>
+ <source>
+<gateway> localhost </gateway>
+<gatewayPort> 2525 </gatewayPort>
+ </source>
+ <p>If Postage is running on another machine than James, you should use
the appropriate host/port combination under which Postage is receiving mail.</p>
+ <p>Now Postage is consuming all mail sent out by James and tries to
align the mail it puts into James with mail coming out of the server.</p>
+ <p>NOTE: This configuration makes James unable to deliver regular
external mail, don't do this on a production system!</p>
+ </subsection>
+ </section>
+ <section name="Enable Postage to record memory and thread resource
consumption of James">
+ <p>This is optional configuration.</p>
+ <p>It only works, if James is run under JSE5 or newer and only if
Postage has been build with JMX support. It also conflicts with James' current
genuine MX4J-based JMX support, which has to be disabled (see ConfigureJmx how
to use JSE5 JMX support).</p>
+ <p>Edit file <JAMES_HOME>/bin/phoenix.[sh|bat]</p>
+ <p>Replace line</p>
+ <source>
+JVM_OPTS="-Djava.ext.dirs=$JVM_EXT_DIRS"
+ </source>
+ <p>with (on one line)</p>
+ <source>
+JVM_OPTS="-Djava.ext.dirs=$JVM_EXT_DIRS -Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.ssl=false
+-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.port=10201 "
+ </source>
+ </section>
+ </body>
+</document>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
