AppFuseEnvironmentIssues

There are some environments that cause errors when deploying or running an AppFuse application. As you run into problems add them to this list so others know what to look for when they have the same problem.

• MySQL 4.0.20 standard distribution for redhat 8.0 linux x86 (maybe other linux impl's too) has a problem whereby the permissions granted are granted for user 'test@localhost' which causes the 'ant setup' target in the generated app to fail because it tries unsuccessfully to access mysql as 'test@hostname'.
  • Resolution: In the generated app directory cd to MYAPPNAME/metadata/sql and modify mysql-create.sql by copying the line that reads 'grant all privileges on qts.* to test@localhost identified by "test";' and adding a new line that adds the same privileges to 'test@hostname' where 'hostname' is the hostname of the box runnihng MySQL. The resulting 2 lines should look like this when done:
    

    grant all privileges on qts.* to test@localhost identified by "test";
    grant all privileges on qts.* to test@<hostname> identified by "test";

• Tomcat 4.1.27 throws an exception when using the compressionFilter.
  • Resolution 1: Don't use the compressionFilter, by commenting out the mapping in metadata/web/filter-mappings:
    

    <!--filter-mapping>
        <filter-name>compressionFilter</filter-name>
        <url-pattern>*.do</url-pattern>
    </filter-mapping-->

• • Resolution 2: Upgrade your version of Tomcat. Version 4.1.30 is known to resolve this issue.

• Ant throws an error when running the "test-canoo" target. The following error is caused by "nekohtml.jar" being in ANT_HOME/lib:
  

com.canoo.webtest.engine.StepExecutionException: Unexpected
exception caught: org.w3c.dom.DOMException: NAMESPACE_ERR:
An attempt is made to create or change an object in a way
which is incorrect with regard to namespaces., Step:
VerifyElementText at file:./login.xml:3:  with
(text="AppFuse ~ Login", type="title", stepId="we should see
the login title", regex="false",
stepType="verifytitle")com.canoo.webtest.engine.StepExecutionException:
Unexpected exception caught: org.w3c.dom.DOMException:
NAMESPACE_ERR: An attempt is made to create or change an
object in a way which is incorrect with regard to
namespaces., Step: VerifyElementText at file:./login.xml:3:
 with (text="AppFuse ~ Login", type="title", stepId="we
should see the login title", regex="false",
stepType="verifytitle")

• • Resolution: Remove "nekohtml.jar" from ANT_HOME/lib

• AppFuse home directory cannot be in CATALINA_HOME/webapps. This is common sense really, but a developer in my team had a problem with this. The issue is when certain ant targets are called (I think it was "deploy"), they will overwrite parts of appfuse.

• Some installations of Fedora Core 1 fail the "Signup" test in the ant "test-canoo" target. Updating the installation of FC1 has resolved this issue in some cases, but it is otherwise unresolved.

• Appfuse 1.6 (springmvc) on Debian using PostgreSQL fails tests because the application can create and delete tables and records, but quietly fails to retrieve records. Currently unresolved. This is extremely baffling behavior since there's clearly a database connection established and no access restrictions but only some operations are succeeding.

• Ant in Windows XP (and most likely other Windows versions) looks in your Windows home directory when searching for a file relative to ~/. This means if you have set up environment specific build.properties files (either ~/.{appname}-build.properties or ~/.build.properties) they should not go in %HOME%\, but rather %HOMEDRIVE%%HOMEPATH%\.