This documentation relates to Confluence 3.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.

Installing the Confluence EAR-WAR Edition

The Confluence EAR-WAR distribution is intended for deployment into an existing J2EE application server.

To use this method of installation, you or your application server administrator must already know how to deploy a web application on the application server of choice. If not, please use the Confluence Standalone distribution instead.

On this page:

System Requirements for Confluence EAR-WAR Distribution

  1. Please check the Confluence system requirements.
  2. In addition to the above requirements, the EAR-WAR distribution requires an application server. For more information on Confluence's supported application servers, please refer to our Supported Platforms page.
  3. If deploying as an unexploded WAR, Ant 1.3 or later is required. This is bundled with the war download.
  4. Confluence, the database and application server must use the same character encoding. UTF-8 is recommended.
  5. If you are installing Confluence EAR-WAR on Unix, Linux or Solaris, please ensure that the required X11 libraries are installed.
    Support
    If you deploy Confluence on an unsupported server, server-related issues cannot be covered by Atlassian technical support. You can try the user forums for assistance instead.

Follow the Application-Specific Instructions

Labels

ear-war ear-war Delete
filter-common-tasks filter-common-tasks Delete
supported-software supported-software Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. May 01, 2008

    Nathan Ollerenshaw says:

    You can't set confluence to be the root in at last Tomcat 5.5 inside the conflue...

    You can't set confluence to be the root in at last Tomcat 5.5 inside the confluence.xml file using the hint:

    "To run Confluence without a context path of "/confluence", change the path in the Context tag to an empty string ("")."

    The documentation for tomcat seems to explicitly define this use case to be configured in the server.xml:

    in http://tomcat.apache.org/tomcat-5.5-doc/config/context.html:

    "The value of this field must not be set except when statically defining a Context in server.xml, as it will be inferred from the filenames used for either the .xml context file or the docBase."

    Kind of annoying as when I configure it this way, I get confluence trying to start twice.

  2. Jan 08, 2009

    Tony Ng says:

    I have just downloaded GlassFish v3 Prelude and tried it with Confluence 2.10 us...

    I have just downloaded GlassFish v3 Prelude and tried it with Confluence 2.10 using eval license. It works just fine.

    The only change I have to make is to increase the heap & perm gen space with the following options in domain.xml under <java-config>

            <jvm-options>-server</jvm-options>

            <jvm-options>-Xmx1024m</jvm-options>

            <jvm-options>-XX:MaxPermSize=512m</jvm-options>

    Would appreciate if Confluence can update the above table regarding GlassFish compatibility.

    Thanks,

    Tony

    1. Jan 09, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hi Tony, Thank you for sharing that with us As you may have already noticed, w...

      Hi Tony,

      Thank you for sharing that with us As you may have already noticed, we have a feature request to support GlassFish. I have added your comment to the report, as I believe, it would be helpful for GlassFish adopters and our developers as well.

      Cheers,
      Azwandi

    2. Jan 21, 2009

      Giles Gaskell [Atlassian Technical Writer] says:

      Hello Tony, Thanks for making your suggestion available on this page. The cont...

      Hello Tony,

      Thanks for making your suggestion available on this page.

      The content above has been updated to clarify how we distinguish between the "Compatible", "Potentially Compatible" and "Known Incompatible" Application Server categories for Confluence.

      We have recently received reports from customers who are experiencing configuration and functional issues with Confluence on GlassFish. However, we will consider moving GlassFish out of its current category (above) once these issues have been resolved.

      Best regards,

      Giles Gaskell
      Technical Writer
      ggaskell@atlassian.com
      ATLASSIAN - http://www.atlassian.com

      1. Nov 02

        Anonymous says:

        I Giles, I have a general question...I have downloaded a 30-day trail version o...

        I Giles,

        I have a general question...I have downloaded a 30-day trail version of Confluence and I have the Tomcat server on my computer, but what if I wanted to take what I have done and show someone that isn't near my computer?

        Is this possible? Can I just copy the files from mine and put it on an another computer?

        I have also heard a little bit about Confluence Hosted.

        I would appreciate any feedback.

        Thanks in advance.
        new user

        1. Nov 10

          Jack Low [Atlassian] says:

          Hi, I have a general question...I have downloaded a 30-day trail version of Con...

          Hi,

          I have a general question...I have downloaded a 30-day trail version of Confluence and I have the Tomcat server on my computer, but what if I wanted to take what I have done and show someone that isn't near my computer?

          Is this possible? Can I just copy the files from mine and put it on an another computer?

          There are two options for you to show your work:
          1. Connect your PC to Internet, so that other peoples can access your confluence via your IP, eg: http://your_ip_address:8080/dashboard.action
          2. You can setup a new confluence in the new PC, with the same serial key, and perform a Confluence Site Backup & Restore from your existing Confluence site backup into the new Confluence. The 30 days trial serial key will be brought over into your new computer.

          I have also heard a little bit about Confluence Hosted.

          Confluence Hosted Options will give you some ideas on how Atlassian provide hosted solution for Confluence. Everything is done by Atlassian staff, including installation, backup, maintenance, plugin-instillation etc.

          Hope the information would help.

          Cheers,

  3. Apr 23, 2009

    Paul Curren says:

    Confluence requires a maximum heap allocation (Xmx) of at least 256 MB Is this...

    Confluence requires a maximum heap allocation (Xmx) of at least 256 MB

    Is this still a realistic minimum? For example, functions such as a PDF export of even a small space will require hundreds of megabytes. Likewise for XML exports.

    1. May 07, 2009

      Arie Murdianto says:

      Hi Paul, It is actually really depending on your instance and your usage. If yo...

      Hi Paul,

      It is actually really depending on your instance and your usage. If you install a lot of plugins in your instance, Confluence needs more memory. And also, if your instance is being accessed by a lot of people, it is also need more memory. The memory is needed to populate Java object. I use a simple usage on my local machine with 256m, it works fine when exporting my space to PDF, HTML or XML.

      Cheers,

Add Comment