Supported Configurations
Please contribute to the JAMWiki project by helping to improve this article. Add to or expand some of the existing information, fix an error, or share your own knowledge to improve this subject! Don't worry about making mistakes - there will always be someone who can correct any errors later.

JAMWiki requires a web application server (such as Tomcat, Websphere or Geronimo) that supports Java 1.4 or later and Java Servlet Specifications 2.4 or later.

[Edit]

Prerequisites

JAMWiki has been found to work with various combinations of the following components:

[Edit]

Supported Java Environments

  • Sun JRE/JDK 1.4
  • Sun JRE/JDK 1.5 aka 5.0
  • Sun JRE/JDK 6.0
[Edit]

Supported Servlet Containers

  • Apache Tomcat 4.1
  • Apache Tomcat 5.0
  • Apache Tomcat 5.5
  • Apache Tomcat 6.0
  • Apache Geronimo 1.1
  • Apache Geronimo 1.1.1
  • Websphere 6.0.2.9
  • BEA Weblogic 8.1 SP 5
  • Sun One Web Server 6.15
  • Oracle Application Server
[Edit]

Supported Databases

  • HSQL (internal database)
  • PostgreSQL 7.4
  • PostgreSQL 8.0
  • PostgreSQL 8.1
  • MS SQL 2000
  • MySQL 4.1
  • MySQL 5.0
  • Oracle 9i (using ojdbc14.jar - v9.2.0.1, database user has to be granted "Query Rewrite" Privilege; an older ojdbc14.jar may not work, e.g. v9.0.2.0 does not work)
  • Oracle 9i (using ojdbc6.jar - Oracle 11 JDBC driver for Java 6)
  • Oracle 10g (using ojdbc14.jar only - classes12.zip will not work).
  • Sybase ASA (tested 9.0.2 using jConnect 5.5 JDBC Driver)

In addition, JAMWiki can be run in either a file persistency mode, or a database persistency mode. When running in a file persistency mode a directory must be available into which JAMWiki files can be written. When running in database persistency mode JAMWiki requires a database user with permission to create tables and sequences. In addition, to support multi-byte characters the JAMWiki database should be created using UTF-8 encoding.

[Edit]

Known Working Configurations

If JAMWiki works for you, please add your operating system, application server, and database (if any) details to the Known Working Configurations section below. If it does not work for you, please add these same details to the Non-Working Configurations section below. Any addition should be of the form:


==Known Working Configurations==

* Windows XP / Tomcat 5.5 / Oracle 10g (with ojdbc14.jar) / Sun JDK 1.4.  Tested
  with JAMWiki 0.1.2. -- ~~~~

==Non-Working Configurations==

* Windows XP / WebSphere 4.x / Oracle 9 (with classes12.zip). Failure during
  install with message "Unknown type CLOB" with JAMWiki 0.0.4. -- ~~~~
[Edit]

Geronimo

  • Ubuntu Linux 6.06--6.10/x86_64,x86 / Geronimo 1.1/1.1.1 / MySQL 5.0.22 / Sun JDK 1.5. Tested with JAMWiki 0.20--0.4.0. -- Peter Thu Jan 4 19:51:10 CET 2007
[Edit]

Resin

  • Red Hat Enterprise Linux / Resin 3.0.14 / Internal DB / JAMWiki 0.4.3 -- lou_tribal
  • RedHat Fedora 4 / Resin 3.0.19 / Flat file / Sun JDK 1.5. Tested with JAMWiki 0.3.0 -- Kent 28-Aug-2006 12:15 CST
  • Ubuntu 6.10 / Resin 3.0.21 / PostgreSQL / Sun JDK 1.5. Tested with JAMWiki 0.5.2 -- anonymous
  • Windows XP/2K / Resin 3.0.s060705 (I think with 3.0.19 works too) / H2 Database (ansi mode) / SUN JDK 1.5 -- AleXis
  • Windows XP / Resin 2.1.17 / Postgres 8.0 / Sun JDK 1.5. Tested with JAMWiki 0.1.3. -- Ryan 05-Aug-2006 14:32 PDT
  • Windows XP / Resin 2.1.17 / Internal database / Sun JDK 1.4. Tested with JAMWiki 0.4.2. -- Ryan 31-Oct-2006 23:47 PST
  • Windows XP / Resin 2.1.17 / MySql 4.1 / Sun JDK 1.5. Tested with JAMWiki 0.2.1. -- Ryan 05-Aug-2006 14:32 PDT
[Edit]

Jetty

  • Windows XP /Jetty 6.1.2rc0 / Internal database/ Sun JDK 1.5 Tested with JAMWiki 0.5.2 05-Mar-2007
  • Mac OS 10.4 / Jetty 6.1.7 / Internal database / Java 1.5.0_13 / JAMWiki 0.6.3 Jan-2008
[Edit]

Tomcat

  • Windows Vista Home Premium / Tomcat 6.0.16 / MySQL 5.0 / Sun JDK 1.6.0_03 / Tested with JAMWiki 0.6.3 --Edwin Roestenburg
  • Windows 2000 Server / Tomcat 5.5 / MySQL 5.0 / Sun JDK 1.5.0 / Tested with JAMWiki 0.5.4 --Dave Penn
  • Windows 2003 Server / Tomcat 5.5 / MySQL 4.1 / Sun JDK 1.5.0 / Tested with JAMWiki 0.5.0 --Gloomy 01-Mar-2007 00:00 PST
  • Windows 2003 Server / Tomcat 4.1 / MS SQL 2000 / Sun JDK 1.4.2 / Tested with JAMWiki 0.4.3 --Angel 08-Dec-2006 00:14 PST
  • Windows 2003 Server / Tomcat 4.1 / MS SQL 2000 / Sun JDK 1.4.2 / Tested with JAMWiki 0.5.0 --Angel 13-Mar-2007 14:34 GMT+1
  • Windows 2003 Server / Tomcat 4.1 / MS SQL 2000 / Sun JDK 1.4.2 / Tested with JAMWiki 0.5.1 --Angel 13-Mar-2007 14:34 GMT+1
  • Windows 2003 Server / Tomcat 4.1 / MS SQL 2000 / Sun JDK 1.4.2 / Tested with JAMWiki 0.5.2 --Angel 13-Mar-2007 14:34 GMT+1
  • Windows 2003 Server / Tomcat 6.0.14 / Postgres 8.3.1 / Sun JDK 1.6.0_01 / Tested with JAMWiki 0.6.5 --Tixo 17-Apl-2008 00:00 PST
  • Windows XP / Tomcat 5.5 / Postgres 8.1 / Sun JDK 1.5. Tested with JAMWiki 0.4.3. -- João 23-Nov-2006 19:55 GMT
  • Windows XP / Tomcat 5.5 / Postgres 8.0 / Sun JDK 1.5. Tested with JAMWiki 0.4.2. -- Ryan 31-Oct-2006 23:47 PST
  • Windows XP / Tomcat 5.5 / MySql 4.1 / Sun JDK 1.5. Tested with JAMWiki 0.4.2. -- Ryan 31-Oct-2006 23:47 PST
  • Windows XP / Tomcat 5.5 / Oracle 10g (with ojdbc14.jar). Tested with JAMWiki 0.3.5. -- Ryan 29-Sep-2006 00:44 PDT
  • Windows XP / Tomcat 5.5 / Internal database / Sun JDK 1.5. Tested with JAMWiki 0.4.2. -- Ryan 31-Oct-2006 23:47 PST
  • Windows XP / Tomcat 6.0.1 / Internal database / Sun JDK 1.6_03. Tested with JAMWiki 0.6.3. -- Scott 01-Feb-2008 01:55 PST
  • Ubuntu Linux 7.10 / Tomcat 6.0.1 / Internal database / Sun JDK 1.6_04. Tested with JAMWiki 0.6.3. -- Scott 01-Feb-2008 01:55 PST
  • Debian Linux 4.1 / Tomcat 4.1 / Postgres 7.4.7 / Sun JDK 1.4. Tested with JAMWiki 0.4.2. -- Ryan 31-Oct-2006 23:47 PST
  • Ubuntu Linux 6.06 / Tomcat 5 / MySQL 5.022 / Sun JDK 1.5 -- Colin
  • Gentoo Linux 2006.0 amd64 / Tomcat 5.5.17 / Flat files / Sun 1.5.0_07 64bits Tested with JAMWiki 0.3.4 -- User:Régis Décamps
  • Suse Linux 9.2 / Tomcat 5.0.27 / Internal database / Sun JRE 1.6.0-b105. Tested with JAMWiki 0.5.2. -- fmr 21-Jun-2007 08:43 PDT
  • OpenSuse Linux 10.1 / tomcat 5.0 / MySQL 5.0.18 / Java 1.5.0_06 (take care of the tomcat configuration, the original temp-path is wrong!)-- Michael Habbert 26-Feb-2007 00:21 PST
  • Opensuse Linux 10.2 / Tomcat 5.0.30 / Internal database / Sun JRE 1.6.0-b105. Tested with JAMWiki 0.6.0. -- Frank 12-Sep-2007 07:37 PDT
  • Windows XP / Tomcat 5.0 / MySQL 5.0 / Sun JDK 1.4. Tested with JAMWiki 0.6.0 -- Ryan 05-Jan-2007 08:14 PST
  • Windows XP / Tomcat 5.0 / Postgres 8.0 / Sun JDK 1.4. Tested with JAMWiki 0.6.0 -- Ryan 06-Jul-2007 22:57 PDT
  • Windows XP / Tomcat 5.0 / Oracle 10g / Sun JDK 1.4. Tested with JAMWiki 0.6.0 -- Ryan 05-Jan-2007 08:14 PST
  • Debian Linux 4.1 / Tomcat 4.1 / Postgres 7.4.7 / Sun JDK 1.5. Tested with JAMWiki 0.6.0 -- Ryan 06-Jul-2007 22:57 PDT
  • Solaris x86 5.11 / Tomcat 5.5 / MySQL 5.0 / Sun JDK 1.5 Tested with JAMWiki 0.5.1 --Natto Lover 26-Feb-2007 22:50 PST
  • FreeBSD i386 6.1 / Tomcat 5.5 / MySQL 5.0 / Sun JDK 1.5 Tested with JAMWiki 0.5.1 --Natto Lover 26-Feb-2007 22:50 PST
  • Solaris 9 SPARC / Tomcat 6.0.10 / Oracle 10.2.0.2 EE / Sun JDK 1.6.0 Tested with JAMWiki 0.5.2 --Andrew Evdokimov 13-Mar-2007 00:44 PST
  • HP-UX B11.23 IA64N / Tomcat 5.5.20 / Internal database / HP JVM 1.5.0.6 Tested with JAMWiki 0.5.4
  • Mac OS X 10.5.1 / Tomcat 5.5.23 / Postgres 8.0.4 / Mac OS X JVM 1.5.0_13 Tested with JAMWiki 0.6.3 --huntc 18-Jan-2008 02:25 PST
  • Kubuntu -Gutsy / Tomcat 5.5.25 / Mysql 5.0.45 / JVM 1.5.0_13 Tested with Jamwiki 0.6.2 -- Michael Habbert 31-Jan-2008 00:40 PST
[Edit]

WebSphere

  • Windows XP / Websphere 6.0.2.9 / Postgres 8.0 / Sun JDK 1.5. Tested with JAMWiki 0.1.3. -- Ryan 17-Jul-2006 22:01 PDT
  • Windows XP / Websphere 6.0.2.9 / MySQL 4.1 / Sun JDK 1.5. Tested with JAMWiki 0.2.1. -- Ryan 12-Aug-2006 12:59 PDT
  • Windows XP / Websphere Community Edition 1.1.0.1 / Build in database (hsqldb) / IBM JDK 1.5. Tested with JAMWiki 0.5.1. -- David H. 9-Feb-2007 15:00 CET
  • SuSE SLES-8.1 / Websphere 5.1.1.12 / Build in database (hsqldb) / IBM WebSphere SDK 1.4.2.1.1 Works with both JAMWiki 0.4.1 and 0.5.2 with a different version of hsqldb.jar instead of hsqldbmain AND edits to web.xml so the order of elements strictly conforms with the DTD -- Rodney Hampton 15-March-2007 9:00 EDT
  • Windows XP / WebSphere 6.1.0.2 / Oracle 10g XE (with latest ojdbc14.jar, version 10.2.0.3.0) / JDK 1.5, WebSphere 6.1 JRE. Tested with JAMWiki 0.5.4 with corrected web.xml (see Bug Reports) -- Carsten Seiffert 05-Jul-2007 02:30 PDT
  • Windows Server 2003 Standard Edition / WebSphere 6.1.0.5 / Oracle 9i (version 9.2.0.6.0, with latest ojdbc14.jar, version 10.2.0.3.0) / JDK 1.5, WebSphere 6.1 JRE. Tested with JAMWiki 0.5.4 with corrected web.xml (see Bug Reports) -- Carsten Seiffert 06-Jul-2007 05:06 PDT
[Edit]

Glassfish + Sun Application server

  • Windows XP / Glassfish v1 / Postgres 8.1 / Sun JDK 1.5. Tested with JAMWiki 0.1.3. Jason Lee 10-Aug-2006 03:48 CDT
  • Fedora Core 5 / Glassfish v1 / File Persistence / Sun JDK 1.5. Tested with JAMWiki 0.3.6. John Weldon 2006-10-18 1430 PDT
  • Debian GNU/Linux 4.0 Etch / Glassfish-v2-b27 / Build in database / Sun JDK 1.5.0_08 Tested with JAMWiki 0.4.3. -- Kevin Bortis 2006-12-08 1530 CET
  • Windows 2000 / Glassfish-v2-b33 / MySQL 5.0.27 / Sun JDK 1.6. Tested with JAMWiki 0.5.0. Darren Spurgeon 28-Jan-2007 12:12 EDT
  • Linux / Sun Application Server 9PE / Sun HotSpot 6.0 / embedded database. Tested with JAMwiki 0.6.0-SNAPSHOT Régis Décamps 28-Jul-2007 16:15 PDT
  • Linux Ubuntu 8.04 / Sun Application Server 9PE / Sun JDK 1.6 / MySQL 5.0. Tested with JAMwiki 0.6.5 david 08-May-2008 01:28 PDT
  • Linux Ubuntu 8.04 Server / Glassfish-v2-UR2 / Sun Java RE 1.6.0_06-b02 / HSQL. Tested with JAMwiki 0.6.6 16-Jul-2008 19:58 BST
[Edit]

Weblogic

  • Windows XP / Weblogic 8.1 SP 5 / Oracle 9i / Sun JDK 1.4. Tested with JAMWiki 0.5.1. -- Kwee Tin
[Edit]

Oracle Application Server

  • All platforms supported by the product -- Marcelo Zanatto
[Edit]

Non-Working Configurations

  • Any Oracle instance using classes12.zip. JAMWiki requires the ojdbc14.jar file for CLOB support. -- Ryan 11-Jul-2006 15:02 PDT
  • Oracle using an outdated ojdbc14.jar (version 9i) - there is a 4K size limit on CLOBs in the old driver. -- Carsten Seiffert 05-Jul-2007 02:34 PDT
  • Websphere 6.0 does not work prior to at least fixpack 6.0.2 due to this issue (if anyone can clarify the exact fixpack version it would be appreciated).
  • File persistency mode is broken with JDK 1.4 on JAMWiki versions prior to 0.0.8 (should work with JAMWiki 0.0.8 and later).
  • There is a rather elusive bug with JAMWiki versions up to and including 0.1.1 where non-ASCII characters may become garbage when edited. See Non-ASCII Taglib Encoding Bug for details. This bug is fixed in JAMWiki 0.1.2 and later versions.
  • MySQL version 3.x and earlier does not support AUTO_COMMIT=false and thus will not work with JAMWiki.
[Edit]

Browser Compatibility

[Edit]

Supported browsers

Browsers that worked with no rendering glitches, no warning popups, no javascript errors.

  • Opensuse 10.2 / Firefox 2.0.0.6 -- Frank 12-Sep-2007 07:40 PDT
  • Windows XP / IE 7.0.5730.11 --Natto Lover 03-Mar-2007 03:55 PST
  • Windows XP / Firefox 2.0.0.2 --Natto Lover 03-Mar-2007 03:55 PST
  • Windows XP / Opera 9.10 --Natto Lover 03-Mar-2007 03:55 PST
  • Linux Ubuntu 8.04 Hardy Heron / Firefox 3.0 -- 17-Jul-2008 07:55 PDT
[Edit]

Known browser specific issues