Author: norman
Date: Mon Aug 21 00:45:54 2006
New Revision: 433192
URL: http://svn.apache.org/viewvc?rev=433192&view=rev
Log:
Add upgrading instructions. See JAMES-581
Added:
james/server/trunk/src/site/xdoc/upgrade_instructions_2_3.xml
Modified:
james/server/trunk/UPGRADE.txt
james/server/trunk/src/site/site.xml
james/server/trunk/src/site/xdoc/documentation_2_3.xml
Modified: james/server/trunk/UPGRADE.txt
URL:
http://svn.apache.org/viewvc/james/server/trunk/UPGRADE.txt?rev=433192&r1=433191&r2=433192&view=diff
==============================================================================
--- james/server/trunk/UPGRADE.txt (original)
+++ james/server/trunk/UPGRADE.txt Mon Aug 21 00:45:54 2006
@@ -9,9 +9,9 @@
read the README.
- Step 1: Copy mailboxes and users.
+ Step 1: Copy mailboxes and users
- You should remove the apps/james/var directory and copy the apps/james/var
directory of the old james
+ Remove the apps/james/var directory and copy the apps/james/var directory
of the old james
installation in this place.
Modified: james/server/trunk/src/site/site.xml
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/site.xml?rev=433192&r1=433191&r2=433192&view=diff
==============================================================================
--- james/server/trunk/src/site/site.xml (original)
+++ james/server/trunk/src/site/site.xml Mon Aug 21 00:45:54 2006
@@ -46,7 +46,7 @@
<item name="Document Archive" href="/document_archive.html"/>
</menu>
- <menu name="Documentation 2.3B">
+ <menu name="Documentation 2.3">
<item name="James" href="/documentation_2_3.html"/>
<item name="Design" href="/design_objectives_2_3.html"/>
<item name="James Javadocs" href="/apidocs/index.html"/>
Modified: james/server/trunk/src/site/xdoc/documentation_2_3.xml
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/documentation_2_3.xml?rev=433192&r1=433191&r2=433192&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/documentation_2_3.xml (original)
+++ james/server/trunk/src/site/xdoc/documentation_2_3.xml Mon Aug 21 00:45:54
2006
@@ -95,6 +95,7 @@
V. Other Information
<ul>
<li><a href="FAQ.html">The James FAQ</a></li>
+<li><a href="upgrade_instructions_2_3.html">Upgrade James</a></li>
</ul>
</p>
</subsection>
Added: james/server/trunk/src/site/xdoc/upgrade_instructions_2_3.xml
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/upgrade_instructions_2_3.xml?rev=433192&view=auto
==============================================================================
--- james/server/trunk/src/site/xdoc/upgrade_instructions_2_3.xml (added)
+++ james/server/trunk/src/site/xdoc/upgrade_instructions_2_3.xml Mon Aug 21
00:45:54 2006
@@ -0,0 +1,113 @@
+<?xml version="1.0"?>
+<!--
+ 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>James 2.3 - Upgrading</title>
+ </properties>
+<body>
+<section name="Upgrading Comments">
+<p>James upgrading 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>
+<p>It is important to realize that the James configuration files are not
unpacked from the James
+distribution until the first time James is started. This is a consequence of
the design of the
+Avalon Phoenix container used to run James. Once James has been started, the
distribution will
+be unpacked. The server should be stopped, the configuration files edited,
and the server restarted.</p>
+<p>So the Upgrading sequence is: <b>1) Start, 2) Stop, 3) Move 4) Edit, 5)
Restart</b>.</p>
+</section>
+<section name="Copy mailboxes and users">
+<subsection name="Copy mailboxes and users">
+<p>Remove the apps/james/var directory and copy the apps/james/var directory
of the old james
+installation in this place.</p>
+</subsection>
+</section>
+<section name="Copy and modify config.xml">
+<subsection name="Remove fetchpop block">
+<p>Its necessary to remove the fetchpop block in config.xml cause fetchpop was
removed in 2.3.</p>
+</subsection>
+<subsection name="Move mailet and matcher packages config">
+<p>Move <mailetpackages> and <matcherpackages> outside from the
<spoolmanager> block.</p>
+</subsection>
+<subsection name="Add neccassary mailets">
+<p>Add the following line as the first mailet of the "root" processor:</p>
+<source>
+<mailet match="All" class="PostmasterAlias"/>
+</source>
+<p>This was hardcoded in 2.2.0 and previous. Now we made it configurable.</p>
+</subsection>
+<subsection name="Move the spoolrepository config">
+<p>Move the spoolrepository out of the mailstore. Its also necessary to change
the config syntax. For example:</p>
+<source>
+<spoolRepository>
+ <repository destinationURL="db://maildb/spool/spool" type="SPOOL"/>
+</spoolRepository>
+</source>
+Must converted to
+<source>
+<spoolrepository destinationURL="db://maildb/spool/spool" type="SPOOL"/>
+</source>
+
+</subsection>
+<subsection name="Move the objectstore">
+<p>Move the objectstore config into the mailstore config.</p>
+</subsection>
+<subsection name="Add SSL to server-sockets">
+<p> To be able to use SSL you need to add this SSL config to the
server-sockets block:</p>
+<source>
+<!--
+<factory name="ssl"
class="org.apache.avalon.cornerstone.blocks.sockets.TLSServerSocketFactory">
+ <ssl-factory>
+ <keystore>
+ <file>conf/keystore/</file>
+ <password>secret</password>
+ <key-password>keysecret</key-password>
+ <type>JKS</type>
+ <protocol>TLS</protocol>
+ <algorithm>SunX509</algorithm>
+ <authenticate-client>false</authenticate-client>
+ </keystore>
+ </ssl-factory>
+</factory>
+-->
+</source>
+</subsection>
+</section>
+<section name="Modify costum mailets if necessary">
+<p> Please note the following things which were changed. So maybe its
necessary for you to change some stuff in your mailets. </p>
+<subsection name="Avalon updates">
+<ul>
+<li>avalon Component has been replaced by avalon Service</li>
+<li>avalon Composable has been replaced by avalon Serviceable</li>
+<li>avalon ComponentManager has been replaced by avalon ServiceManager</li>
+</ul>
+</subsection>
+<subsection name="Cornerstone updates">
+<ul>
+<li>MailStore interface has been removed: mailets looking up the MailStore
should now lookup
+a Store (org.apache.avalon.cornerstone.services.store.Store)</li>
+</ul>
+</subsection>
+</section>
+<section name="Start James">
+<p> Now you should be able to start james without problems.</p>
+</section>
+</body>
+</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
