From Cactus 1.4.1 to newer version

Release notes are now provided in the distribution in an ANNOUNCEMENT.txt file. Please make sure you read it.

From Cactus 1.3 to 1.4

See the Changes page for full list of changes.

Here are the changes that might affect your previous installation of Cactus 1.3:

  • Configuring Cactus logging has changed. See the Config Howto page. Thus, the old cactus.enableLogging property no longer has any effect.
  • One new jar needs to be put in both client and server side classpaths: commons-logging.jar, due to the new logging system.
  • The following classes have been removed (they were deprecated in Cactus 1.2):
    • org.apache.cactus.ServletTestRequest,
    • org.apache.cactus.util.ClientCookie,
    • org.apache.cactus.util.AssertUtils
  • External jars provided by Cactus have been renamed to contain their version suffixed to their name.
  • The jspRedirector.jsp now creates a HTTP Session by default (it was not previously).

From Cactus 1.2 to 1.3

Here are the steps to migrate from Cactus 1.2 to 1.3

This migration guide does not explain any of the new feature of Cactus 1.3 but concentrates on making you move from Cactus 1.2 to 1.3.

Let's call CACTUS_HOME the directory where you unzipped the Cactus distribution.

Follow these steps:

Step 1

Put aspectjrt.jar (found in CACTUS_HOME/lib) in both your client side and server side classpaths.

Step 2

Modify your cactus.properties to the new format. For example:

cactus.contextURL = http://localhost:8000/cactus
cactus.servletRedirectorName = ServletRedirector

Step 3

Ensure that cactus.servletRedirectorName does not end with a "/" and that the mapping in web.xml matches it:

    <servlet-mapping>
        <servlet-name>ServletRedirector</servlet-name>
        <url-pattern>/ServletRedirector</url-pattern>
    </servlet-mapping>

The Cactus sample is supposed to work with Ant 1.4. However, we introduced an incompatibility at the last moment (i.e. a feature only supported by Ant 1.5). If you're using Ant 1.4, simply remove the failing line (it is an optional line).