Instructions for manual installation of KonaKart

[BoJo]

These are instructions for manually installing KonaKart.
The FAQ contains general KonaKart installation instructions:

http://www.konakart.com/installationfaq.php

However, these are geared for using the "set-up program" that is provided for Windows and Linux platforms. These executables do not run under Mac OS (or at least I don't know how to get them to run under Mac OS). Also, I figured it would be generally useful to provide a consolidated list of steps for performing a manual instruction.

In general, you want to follow all the documented installation instructions  EXCEPT for the "INSTALL KONAKART" section (http://www.konakart.com/installationfaq.php#Install_KonaKart) because this section assumes you are using a "set-up program" ( KonaKart-2.2.2.0-Windows-Setup.exe  or  KonaKart-2.2.2.0-Linux-Install ).

Perform all the documented installation instructions for:
* Java
* The RDBMS of your choice (MySQL in this case)

In my case, I am using MySQL and a database named "konakart". I am using Tomcat as the servlet container.

I) Populate the database

Make sure you have created an empty database instance in the RDBMS of choice as per the FAQ instructions:

In my case;
mysql> create database konakart

What is not clear from the FAQ instruction is what SQL script file to run to populate the database for a manual installation.

From http://www.konakart.com/forum/index.php/topic,302.0.html:
--------------------
To create the database run konakart_demo.sql for the database you have chosen.
---------------------


In my case:

mysql -u root -p konakart < /Users/bob/Documents/workspace/konakart/database/MySQL/konakart_demo.sql

II) Build the WAR files

1) download the zip file for manual installation as instructed here:
http://www.konakart.com/downloads.php

2) Unzip to the file to the directory of your choice.
We'll refer to this directory as <konakart>.

3) set DB name in konapart.properties
Change the string "dbname" to the name of your database (in my case "konakart") in the following file:

<konakart>/webapps/konakart/WEB-INF/classes/konakart.properties

This is documented in the "DEFINING THE DATABASE PARAMETERS" section of the installation FAQ.

4) run ant to generate the war files.

<konakart>/custom>ant
<konakart>/cusotm>ant make_wars

Detailed instruction for building the war files can be found at:
http://www.konakart.com/customizationfaq.php#How_do_I_build_the_customisable_java

III) Deploy & Test

1) deploy the WAR files
In my case I copied the .war files in <konkart>/custom/war to my tomcat "webapps" directory.

2) restart the servlet container (if necessary)
Restart Tomcat in my case.

3) test KonaKart:
Try http://localhost:8080/konakart in your browser.

[ming]

Hi Bob,

It's very helpful of you to provide these useful notes, thanks.

We have used these as a starting point for a new FAQ on Manual Installation.

It's now live at http://www.konakart.com/manual_installationfaq.php

Thanks again,
Ming

[BoJo]

Oops, I forgot to change "dbname" to the name of my database in the konakartadmin.properties file:

<konakart>/webapps/konakartadmin/WEB-INF/classes/konakartadmin.properties

You'll get an error when you run the admin tool without this change.

Bob