Current development on JAMWiki is primarily focused on maintenance rather than new features due to a lack of developer availability. If you are interested in working on JAMWiki please join the jamwiki-devel mailing list.

Supported Configurations

alert.png This page is no longer maintained and is considerably out-of-date. It may be deleted at some point in the future.

JAMWiki requires a web application server (such as Tomcat, Websphere or Geronimo) that supports Java 5 or later and Java Servlet Specifications 2.4 or later. If using an external database the database drivers must support the JDBC 3.0 specification (or later).

Contents

Prerequisites[edit]

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

Supported Java Environments[edit]

  • Sun JRE/JDK 1.5 aka 5.0
  • Sun JRE/JDK 6.0
  • Sun JRE/JDK 7.0

Supported Servlet Containers[edit]

  • Apache Tomcat 5.5
  • Apache Tomcat 6.0
  • Apache Geronimo 1.1
  • Apache Geronimo 1.1.1
  • Apache Geronimo 2.1.3
  • Websphere 6.0.2.9
  • BEA Weblogic 8.1 SP 5
  • Sun One Web Server 6.15
  • Oracle Application Server

Supported Databases[edit]

  • H2 database
  • HSQL (internal database)
  • PostgreSQL 7.4
  • PostgreSQL 8.0
  • PostgreSQL 8.1
  • MS SQL 2005 (using JTDS)
  • MySQL 4.1
  • MySQL 5.0
  • Oracle 10g (using ojdbc14.jar only - classes12.zip will not work).
  • Oracle 11 (using ojdbc6.jar)
  • Sybase ASA (tested 9.0.2 using jConnect 5.5 JDBC Driver)

When using an external database 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. Alternatively, JAMWiki can be run using an internal version of the HSQL database, meaning that no external database is required.

Known Working Configurations[edit]

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==

{| border="1" cellspacing="0" cellpadding="5" align="center"
! OS
! App Server
! Database
! JDK/JRE
! JAMWiki
! User
|- 
| Windows XP
| Tomcat 5.5
| Oracle 10g (with ojdbc14.jar)
| Sun JDK 1.4
| 0.6.6  
| ~~~~
|}

==Non-Working Configurations==

{| border="1" cellspacing="0" cellpadding="5" align="center"
! OS
! App Server
! Database
! JDK/JRE
! JAMWiki
! User
! Comment
|- 
| Windows XP
| WebSphere 4.x
| Oracle 9 (with classes12.zip)
| Sun JDK 1.4
| 0.6.6  
| ~~~~
| Failure during install with message "Unknown type CLOB" with JAMWiki 0.0.4.
|}

Geronimo[edit]

OS App Server Database JDK/JRE JAMWiki User
Ubuntu Linux 6.06--6.10/x86_64,x86 Geronimo 1.1/1.1.1 MySQL 5.0.22 Sun JDK 1.5 0.20--0.4.0 Peter Thu Jan 4 19:51:10 CET 2007
Windows Server 2003 Standard Edition Geronimo 2.1.3 MS SQL 2005 SP2 Sun JDK 1.5 0.7.0 Fanninger Thomas • (comments) • 04-Mar-2009 04:24 PST

Resin[edit]

OS App Server Database JDK/JRE JAMWiki User
FreeBSD 6.x Resin 3.0.26 MySQL ? 0.6.6 Gene
Red Hat Enterprise Linux Resin 3.0.14 Internal DB ? 0.4.3 lou_tribal
FreeBSD 6.x Resin 3.0.26 MySQL ? 0.6.6 Gene
RedHat Fedora 4 Resin 3.0.19 Flat file Sun JDK 1.5. 0.3.0 Kent 28-Aug-2006 12:15 CST
Ubuntu 6.10 Resin 3.0.21 PostgreSQL Sun JDK 1.5. 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. 0.1.3. Ryan 05-Aug-2006 14:32 PDT
Windows XP Resin 2.1.17 MySql 4.1 Sun JDK 1.5 0.2.1 Ryan 05-Aug-2006 14:32 PDT
Windows Server 2003,SP2 Resin 3.2.1 internal DB Sun JRE 1.6.0.13 0.7.0 Bob White 09-Jun-2009 16:51 PDT

Jetty[edit]

  • 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
  • Ubuntu 8.04 / Jetty 5.1.14-1 / PostgreSQL 8.3.3 / Java 1.6.0_3 / JAMWiki 0.6.7 Dec-2008

Tomcat[edit]

  • Windows 2003 Server / Tomcat 6.0.20 / Internal database/ Sun JDK 1.6.0_14 / Tested with jamwiki-0.7.2 --friendmine 31-Jul-2009 00:00 PST
  • 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
  • Solaris Sparc 5.10 / Tomcat 6.0.16 / Oracle 11 / Sun JDK 1.6.0 Tested with JAMWiki 0.6.6 --HB 15-Sep-2008 04:55 PDT
  • 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
  • HP-UX B11.23 IA64 / Tomcat 6.0.18 / Internal database / HP JVM 1.5.0.14 Tested with JAMWiki 0.6.6
  • HP-UX B11.31 IA64 / Tomcat 6.0.18 / Internal database / HP JVM 1.5.0.14 Tested with JAMWiki 0.6.6
  • 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
  • Debian Linux 4.1 amd64 / Apache Tomcat 6.0.18 / MySQL 5.0.51 / Java 1.6.0_12 / Tested with JAMWiki 0.7.2 -- Francois 09-Jun-2009 23:41 PDT
  • Ubuntu Linux 9.04 / Tomcat 6 / MySQL 5.0.75-0ubuntu10.2 / Sun JDK 1.6.0-13 -- User:insunzam

WebSphere[edit]

  • 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

Glassfish + Sun Application server[edit]

  • 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
  • Windows 2000 / Sun Java System Application Server 9.1_01 (build b09d-fcs) / MS-SQL MSDE 2000 V8.00.194/ Sun JDK 1.6. Tested with JAMWiki 0.6.7. -- Michael Sand -- 16-Jan-2009
  • 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

Weblogic[edit]

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

Oracle Application Server[edit]

  • All platforms supported by the product -- Marcelo Zanatto

JBoss Application Server[edit]

  • Windows XP SP 2 / JBoss 4.2.2 GA / Hypersonic SQL DB (embedded) / Sun JDK 1.6.0_10. Tested with JAMWiki 0.6.7. -- Dan Wilkin 23-Dec-2008 13:00 PST

SpringSource dm Server[edit]

  • Ubuntu Linux Server 8.04 (Hardy), J2SE runtime (build 1.6.0_07-b06), SpringSource dm Server 1.0.1 and 1.0.2. Downloads not persistent - a separate download handler is needed. (Lubos Medovarsky, Accelera Networks, http://accelera-networks.com, June 2009)

Non-Working Configurations[edit]

  • 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.

Browser Compatibility[edit]

Supported browsers[edit]

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 / Firefox 3.0.5 --Michael Sand -- 16-Jan-2007
  • 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


Known browser specific issues[edit]

  • Firefox 2 requries setting network.standard-url.encode-utf8 parameter to true to successfully work with pages which URLs contain non-ASCII characters (cyrillic in my case). See [1] --Andrew Evdokimov 13-Mar-2007 00:44 PST