You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by er...@apache.org on 2010/10/27 17:13:11 UTC

svn commit: r1027996 - in /james/server/trunk/src/site: ./ resources/images/conf/ resources/images/jmx_management/ resources/images/uml/ xdoc/

Author: eric
Date: Wed Oct 27 15:13:10 2010
New Revision: 1027996

URL: http://svn.apache.org/viewvc?rev=1027996&view=rev
Log:
Still image, toc, file name changes - structure should be good for 3.0-M1 - Still content to be added.

Added:
    james/server/trunk/src/site/resources/images/uml/org.apache.james_package_part.png   (with props)
    james/server/trunk/src/site/xdoc/dev_mailets.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/provided_mailets.xml
    james/server/trunk/src/site/xdoc/dev_matchers.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/provided_matchers.xml
    james/server/trunk/src/site/xdoc/feature_mailetcontainer.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/concept_mailetcontainer.xml
    james/server/trunk/src/site/xdoc/feature_perfomance.xml
      - copied, changed from r1027921, james/server/trunk/src/site/xdoc/james_perfomance.xml
    james/server/trunk/src/site/xdoc/feature_queue_priority.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/concept_queue_priority.xml
    james/server/trunk/src/site/xdoc/feature_security.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/james_security.xml
    james/server/trunk/src/site/xdoc/feature_stores.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/concept_stores.xml
    james/server/trunk/src/site/xdoc/feature_summary.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/concept_summary.xml
    james/server/trunk/src/site/xdoc/upgrade_2.3.xml
      - copied unchanged from r1027921, james/server/trunk/src/site/xdoc/james_upgrade.xml
Removed:
    james/server/trunk/src/site/xdoc/concept_mailetcontainer.xml
    james/server/trunk/src/site/xdoc/concept_queue_priority.xml
    james/server/trunk/src/site/xdoc/concept_stores.xml
    james/server/trunk/src/site/xdoc/concept_summary.xml
    james/server/trunk/src/site/xdoc/james_perfomance.xml
    james/server/trunk/src/site/xdoc/james_security.xml
    james/server/trunk/src/site/xdoc/james_upgrade.xml
    james/server/trunk/src/site/xdoc/provided_mailets.xml
    james/server/trunk/src/site/xdoc/provided_matchers.xml
Modified:
    james/server/trunk/src/site/resources/images/conf/config_example.png
    james/server/trunk/src/site/resources/images/jmx_management/jmx_user_part.png
    james/server/trunk/src/site/site.xml
    james/server/trunk/src/site/xdoc/configuration.xml
    james/server/trunk/src/site/xdoc/configuration_serverwide.xml
    james/server/trunk/src/site/xdoc/index.xml
    james/server/trunk/src/site/xdoc/installation.xml
    james/server/trunk/src/site/xdoc/release_notes.xml

Modified: james/server/trunk/src/site/resources/images/conf/config_example.png
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/conf/config_example.png?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
Binary files - no diff available.

Modified: james/server/trunk/src/site/resources/images/jmx_management/jmx_user_part.png
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/jmx_management/jmx_user_part.png?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
Binary files - no diff available.

Added: james/server/trunk/src/site/resources/images/uml/org.apache.james_package_part.png
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/uml/org.apache.james_package_part.png?rev=1027996&view=auto
==============================================================================
Binary file - no diff available.

Propchange: james/server/trunk/src/site/resources/images/uml/org.apache.james_package_part.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Modified: james/server/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/site.xml?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
--- james/server/trunk/src/site/site.xml (original)
+++ james/server/trunk/src/site/site.xml Wed Oct 27 15:13:10 2010
@@ -42,16 +42,16 @@
     <menu name="Overview">
       <item name="Introduction" href="/index.html"/>
       <item name="Release Notes" href="/release_notes.html"/>
-      <item name="Security" href="/james_security.html" />
-      <item name="Performance" href="/james_perfomance.html" />
 <!--      <item name="JIRA Report" href="/jira-report.html"/>-->
     </menu>
   
-    <menu name="Concepts">
-      <item name="Summary" href="/concept_summary.html" />
-      <item name="Mailet Container" href="/concept_mailetcontainer.html" />
-      <item name="Stores" href="/concept_stores.html" />
-      <item name="Queue Priority" href="/concept_queue_priority.html" />
+    <menu name="Features">
+      <item name="Summary" href="/feature_summary.html" />
+      <item name="Mailet Container" href="/feature_mailetcontainer.html" />
+      <item name="Stores" href="/feature_stores.html" />
+      <item name="Queue Priority" href="/feature_queue_priority.html" />
+      <item name="Performance" href="/feature_perfomance.html" />
+      <item name="Security" href="/feature_security.html" />
     </menu>
     
     <menu name="User Manual">
@@ -69,6 +69,7 @@
         <item name="FetchMail" href="/configuration_fetchmail.html" />
         <item name="Remote Manager" href="/configuration_remotemanager.html" />
         <item name="List Manager" href="/configuration_listmanager.html" />
+        <item name="Common Configs" href="/configuration_common.html" />
       </item>
       <item name="3. Manage James" href="/management.html" collapse="true" >
         <item name="Domains" href="/management_domains.html" />
@@ -79,19 +80,15 @@
         <item name="Logging" href="/monitoring_logging.html" />
         <item name="JMX" href="/monitoring_jmx.html" />
       </item>
-    </menu>
-
-    <menu name="FAQ">
-      <item name="Upgrade from James 2.3" href="/james_upgrade.html" />
-      <item name="Common Configs" href="/configuration_common.html" />
-      <item name="Provided Mailets" href="/provided_mailets.html" />
-      <item name="Provided Matchers" href="/provided_matchers.html" />
+      <item name="5. Upgrade from James 2.3" href="/upgrade_2.3.html" />
     </menu>
 
     <menu name="Developers Corner">
       <item name="Architecture" href="/dev_architecture.html" />
       <item name="Build from source" href="/dev_build.html" />
+      <item name="Provided Mailets" href="/dev_mailets.html" />
       <item name="Develop a Mailet" href="/dev_custom_mailet.html" />
+      <item name="Provided Matchers" href="/dev_matchers.html" />
       <item name="Develop a Matcher" href="/dev_custom_matcher.html" />
       <item name="Extend James" href="/dev_extend.html"  collapse="true" >
         <item name="Hook SMTP" href="/dev_extend_hook_smtp.html" />

Modified: james/server/trunk/src/site/xdoc/configuration.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/configuration.xml?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/configuration.xml (original)
+++ james/server/trunk/src/site/xdoc/configuration.xml Wed Oct 27 15:13:10 2010
@@ -44,6 +44,7 @@
         <li><a href="configuration_fetchmail.html">FetchMail Configuration</a></li>
         <li><a href="configuration_remotemanager.html">Remote Manager Configuration</a></li>
         <li><a href="configuration_listmanager.html">List Manager Configuration</a></li>
+        <li><a href="configuration_common.html">Common Configuration</a></li>
     </ul>
 
   </section>

Modified: james/server/trunk/src/site/xdoc/configuration_serverwide.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/configuration_serverwide.xml?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/configuration_serverwide.xml (original)
+++ james/server/trunk/src/site/xdoc/configuration_serverwide.xml Wed Oct 27 15:13:10 2010
@@ -113,6 +113,9 @@ or he need to disable user/pass on windo
 yes only windows
 on unix like operation systems the perms are correctly set
 </p>
+
+</subsection>
+
     <subsection name="Other global configuration">
   
       <p>Other configuration are available inside James.  

Copied: james/server/trunk/src/site/xdoc/feature_perfomance.xml (from r1027921, james/server/trunk/src/site/xdoc/james_perfomance.xml)
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/feature_perfomance.xml?p2=james/server/trunk/src/site/xdoc/feature_perfomance.xml&p1=james/server/trunk/src/site/xdoc/james_perfomance.xml&r1=1027921&r2=1027996&rev=1027996&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/james_perfomance.xml (original)
+++ james/server/trunk/src/site/xdoc/feature_perfomance.xml Wed Oct 27 15:13:10 2010
@@ -20,7 +20,7 @@
 <document>
 
   <properties>
-    <title>Performance</title>
+    <title>James 3 - Performance</title>
   </properties>
 
 <body>

Modified: james/server/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/index.xml?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/index.xml (original)
+++ james/server/trunk/src/site/xdoc/index.xml Wed Oct 27 15:13:10 2010
@@ -33,18 +33,20 @@
 	    
 	    <p>This documentation is intended to be an introduction to the concepts behind the James usage, as well 
 	      as a guide to <a href="installation_instructions.html">install</a>, <a href="configuration_instructions.html">configure</a> 
-	      and <a href="build_james.html">develop</a> the James server.</p>
+	      and <a href="build_james.html">develop</a> James server.</p>
 	    
 	    <p>You can download stables releases from <a href="http://james.apache.org/download.cgi">here</a>
-	      (or latest snapshots from <a href="http://repository.apache.org/content/groups/snapshots/org/apache/james/james-server-spring-deployment/3.0-SNAPSHOT/ ">here</a>).</p>
+	      (or latest snapshots from <a href="http://people.apache.org/builds/james/nightly/">here</a>).</p>
 	
         <table>
         
          <tr><td width="50%">
 
           <subsection name="Configureable">
+          
+            <p>Configure the stores,... via the well-known Spring framework - <a href="configuration.html">read more</a>.</p>
         
-            <p></p>
+            <img src="images/conf/config_example.png" height="400px" />
         
           </subsection>
           
@@ -52,8 +54,10 @@
 
           <subsection name="Manageable">
         
-            <p></p>
-        
+            <p>Manage domains, users,... via well-known JMX tools - <a href="management.html">read more</a>.</p>
+            
+            <img src="images/jmx_management/jmx_user_part.png" />
+
           </subsection>
           
          </td></tr>
@@ -63,7 +67,9 @@
           <subsection name="Performant">
            
             <p>A special focuss has been brought to the performance: James can process more than
-               100 mails per second. See the <a href="performance.html">performance</a> page to get more numbers.</p>
+               100 mails per second - <a href="performance.html">read more</a></p>
+        
+            <img src="images/jmx_monitoring/jmx_process_root.png" height="400px" />
         
           </subsection>
          
@@ -71,15 +77,12 @@
 
           <subsection name="Secured">
         
-            <p>James is a secured mail server by default. You can read more on the existing security
-               measures and infrastructure on the <a href="security.html">security</a>.</p>
+            <p>James is a secured mail server by default - <a href="security.html">read more</a>.</p>
         
           </subsection>
           
-         </td>
-         
-         </tr>
-   	    
+         </td></tr>
+        
          <tr><td width="50%">
         
   	      <subsection name="Extensible">
@@ -89,14 +92,16 @@
 	          custom applications for mail processing.  This modularity and ease of customization is one of James' 
 	          strengths, and can allow administrators to produce powerful applications surprisingly easily.</p>
 	 
-	        <p>James 3.0 is now built on top of Spring 3.0 in replacement of trunk version of the <a href="http://avalon.apache.org/">Avalon Application Framework</a>.
-	          With Spring, We keep the good development practices introduced by Avalon such as 
-	          Component Oriented Programming and  Inversion of Control. 
-	          The stable and robust Spring container provides a strong foundation for the James server.</p>
+	        <p>James 3.0 is now built on top of Spring 3.0 in replacement of trunk version of the <a href="http://avalon.apache.org/">Avalon</a> Application Framework.
+	           With Spring, We keep the good development practices introduced by Avalon such as 
+	           Component Oriented Programming and  Inversion of Control. 
+	           The stable and robust Spring container provides a strong foundation for the James server.</p>
 	    
 	        <p>The internal and exposed APIs for this 3.0-M1 release are under current validation and are 
-	          expected to be subject to change.</p>
+	          expected to be subject to change - <a href="dev_architecture.html">read more</a>.</p>
 	         
+            <img src="images/uml/org.apache.james_package_part.png" width="400px" />
+        
   	      </subsection>
   	      
   	    </td><td width="50%">
@@ -112,7 +117,7 @@
 	        <ul>
 	          <li>100% pure Java Mail server designed to be a complete and portable enterprise 
 	              mail engine solution.</li>
-	          <li>Supports currently available IETF protocols, including SMTP, POP3 and IMAP4 
+	          <li>Supports currently available IETF protocols, including SMTP, LMTP, POP3 and IMAP4 
 	              James is able to store user and message data either in a file-system (Maildir), any JPA-compatible database
 	              and even JCR, allowing fast, reliable, even real-time replicated storage.</li>
 	          <li>Provides a powerful, flexible mail application engine through support for the Apache Mailet 
@@ -126,9 +131,7 @@
 	      
   	      </subsection>
   	      
-  	    </td>
-  	    
-  	    </tr>
+  	    </td></tr>
   	      
    	    </table>
 

Modified: james/server/trunk/src/site/xdoc/installation.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/installation.xml?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/installation.xml (original)
+++ james/server/trunk/src/site/xdoc/installation.xml Wed Oct 27 15:13:10 2010
@@ -27,22 +27,34 @@
 
 <section name="Requirements">
 
-<p>James requires a Java Runtime Environment of Java version 1.4 or higher installed to run the 
+<subsection names="Java Virtual Machine">
+
+<p>James requires a Java Runtime Environment of Java version 1.5 or higher installed to run the 
 James application.  The exact JREs available depend on the platform.  A JRE must be downloaded and
-installed before James can run.  In addition, the environment variable JAVA_HOME must be set to
+installed before James can run.  In addition, the environment variable JAVA_HOME should be set to
 the JRE home directory before running James.</p>
 
-<p>Runs on OpenJDK and Sun JDK</p>
+<p>James 3.0 has been successfully tested on OpenJDK, Sun JDK and IBM JDK</p>
+
+</subsection>
+
+<subsection names="System Requirements">
 
 <p>On Unix platforms, root access will be required to run James.  On these platforms, access to ports 
-below 1024 is generally restricted to the root user.  As SMTP, POP3, and NNTP all need to open 
+below 1024 is generally restricted to the root user.  As SMTP, POP3, and IMAP all need to open 
 server sockets on such ports in standard configurations, James requires root access.</p>
 
 <p>Obviously James also requires sufficient disk space, processor power, and network bandwidth.  But, 
 other than what's been discussed here, it has no additional special requirements.</p>
+
+<p>James needs by default 512 MB RAM, but may need more depending on the load.</p>
+
+</subsection>
+
 </section>
 
 <section name="Installation Comments">
+
 <p>James installation involves a number of steps, each of which is described in some detail in the 
 following sections.  But as this sequence of steps has confused some users in the past, additional 
 comments seem warranted.</p>

Modified: james/server/trunk/src/site/xdoc/release_notes.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/release_notes.xml?rev=1027996&r1=1027995&r2=1027996&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/release_notes.xml (original)
+++ james/server/trunk/src/site/xdoc/release_notes.xml Wed Oct 27 15:13:10 2010
@@ -26,9 +26,10 @@
 
 <body>
 
-<p>This document records what was done between releases.
-As always, thank you to everyone who contributed code, documentation, 
-bug reports, and feedback.</p>
+<p>This document records what was done between releases.</p>
+
+<p><b>As always, thank you to everyone who contributed code, documentation, 
+bug reports, and feedback.</b></p>
 
 <section name="Version 3.0-M1 (Milestone 1)">
 



---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org