Installing KonaKart on JOnAS with Tomcat

Verified on JOnAS v4.9.2 / Apache Tomcat v5.5.26 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/Tomcat if you haven't already done so (refer to JOnAS and Tomcat 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 your server.xml file as follows:

    
    <!-- Define a SSL Coyote HTTP/1.1 Connector on port 9043 -->
    
    <Connector port="9043" 
               maxHttpHeaderSize="8192"
               maxThreads="150" 
               minSpareThreads="25" 
               maxSpareThreads="75"
               enableLookups="false" 
               disableUploadTimeout="true"
               acceptCount="100" 
               scheme="https" secure="true"
               clientAuth="false" 
               sslProtocol="TLS" 
               keystoreFile="conf/.keystore" 
               keystorePass="kkpassword" />
    
    

  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/tomcat/work/webapps/jonas/ear/konakart/konakart/images (or the equivalent in your installation).