Installing KonaKart on JOnAS with Jetty

Verified on JOnAS v4.9.2 / Jetty v5.1.10 on Windows

Refer to the general notes for installing KonaKart on all Application Servers .

Installation

Place the KonaKart EAR in the apps/autoload directory of the JOnAS installation. The KonaKart EAR is loaded automatically by JOnAS (some warnings about the use of DTDs can be ignored: "konakart.ear is using DTDs, WsGen needs Schema only : WEB-INF/web.xml use a DTD").

Configuration

  1. Set the port numbers (9000) for reporting as required (set these using the KonaKart Admin App under the Configuration > Reports section)

  2. Set the HTTP (9000) and HTTPS (9043)port numbers as required (set these using the KonaKart Admin App under the Configuration > HTTP/HTTPS section). You will also have to setup SSL in JOnAS/Jetty if you haven't already done so (refer to JOnAS and Jetty documentation to find out how to do this). A quick way to do this if you don't have a keystore already (and for development purposes only) is to copy the conf/.keystore file from your KonaKart installation to the conf directory of JOnAS, then add to edit your jetty5.xml file as follows:

    
    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
    <!-- Add a HTTPS SSL listener on port 9043                           -->
    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
    <!-- UNCOMMENT TO ACTIVATE -->
    <Call name="addListener">
      <Arg>
        <New class="org.mortbay.http.SunJsseListener">
          <Set name="Port">9043</Set>
          <Set name="MinThreads">5</Set>
          <Set name="MaxThreads">100</Set>
          <Set name="MaxIdleTimeMs">30000</Set>
          <Set name="LowResourcePersistTimeMs">2000</Set>
          <Set name="Keystore"><SystemProperty name="jetty.home" default="."/>
              ./../../conf/.keystore</Set>
          <Set name="Password">kkpassword</Set>
          <Set name="KeyPassword">kkpassword</Set>
        </New>
      </Arg>
    </Call>
    
    

  3. Set the memory parameters to suit your environment (eg. I set JONAS_OPTS=-XX:PermSize=256m -XX:MaxPermSize=256m -Xms400m -Xmx700m ). ("You may need different settings).

  4. Configure the image locations in the Admin App under Configuration > Images . Set the image base url to http://localhost:9000/konakart/images/ and the image base path to something like C:/JOnAS-4.9.2/jetty/work/webapps/jonas/ear/konakart/konakart/images (or the equivalent in your installation).