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.
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.
So the Upgrading sequence is: 1) Start, 2) Stop, 3) Move 4) Edit, 5) Restart.
Remove the apps/james/var directory and copy the apps/james/var directory of the old james installation in this place.
It's necessary to remove the fetchpop block in config.xml because fetchpop was removed in 2.3.
Move <mailetpackages> and <matcherpackages> outside of the <spoolmanager> block.
Add the following line as the first mailet of the "root" processor:
<mailet match="All" class="PostmasterAlias"/>
This was hardcoded in 2.2.0 and previous. Now we made it configurable.
Move the spoolrepository out of the mailstore. Its also necessary to change the config syntax. For example:
<spoolRepository> <repository destinationURL="db://maildb/spool/spool" type="SPOOL"/> </spoolRepository>
<spoolrepository destinationURL="db://maildb/spool/spool" type="SPOOL"/>
Move the objectstore config into the mailstore config.
To be able to use SSL you need to add this SSL config to the server-sockets block:
<!-- <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> -->
Please note the following things that were changed. So maybe it's necessary for you to change some stuff in your mailets.