Why install manually ?
Manual Installation Instructions
Why install manually?
If you are installing on a platform that supports the GUI installer (Windows, Linux, Unix), it is recommended that you use that.
If not, but you are on a platform that supports the silent form of the installer (again Windows, Linux, Unix), it is recommended that you use that.
Otherwise, use the manual installation.
If you plan to install KonaKart in an existing servlet container, it is still advisable to run through the GUI installer if you can. The reason for this is that it will populate all the properties files for you and load your database automatically. Once you have done this you can make WARs from the GUI-installed version of KonaKart (details below) and deploy them elsewhere as you please.
Manual Installation Instructions
These instructions for manually installing KonaKart were first provided in a post to our forum by "BoJo" (aka "Bob") and have been expanded here.
The Installation FAQ contains general KonaKart installation instructions (although focuses on using the GUI-driven and silent versions of the installer) and contains important information that is also relevant for the manual installation so check this before starting out.
In general, you need to follow all the documented installation instructions except for the "INSTALL KONAKART" section which explains how to use the automated GUI and Silent versions of the installation.
Perform all the documented installation instructions for:
* Java
* The RDBMS of your choice (MySQL in this case)
For the purposes of this FAQ we'll use MySQL and a database named "konakart".
I) Populate the database
Make sure you have created an empty database instance in the RDBMS of choice as per the FAQ instructions: eg:
$ mysql> create database konakart
To create the database load konakart_demo.sql for the database you have chosen. In this case:
$ mysql -u root -p konakart < ./konakart/database/MySQL/konakart_demo.sql
II) Configure the Properties Files
1) Download the zip file for manual installation as described on the Downloads page
2) Unzip to the file to the directory of your choice. We'll refer to this directory as <konakart>.
3) Set DB name (and other database connection parameters) in konakart.properties
Change the string "dbname" to the name of your database (in this 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) Set DB name (and other database connection parameters) in konakartadmin.properties
Change the string "dbname" to the name of your database (in this case "konakart") in the following file:
<konakart>/webapps/konakartadmin/WEB-INF/classes/konakartadmin.properties
Now there is a choice.
Either: (IIIa) run KonaKart using the tomcat that was provided in the download kit or (IIIb) create WARs and load them into your chosen servlet container.
IIIa) Run using the tomcat provided
1) Start tomcat using <konakart>/bin/startkonakart.sh (or <konakart>\bin\StartAndLaunchKonaKart.bat n Windows).
2) Run KonaKart and KonaKartAdmin
Try http://localhost:8780/konakart/ and http://localhost:8780/konakartadmin/ in your browser.
IIIb) Create WARs and deploy in another servlet container
1) Run ant to generate the war files.
$ cd <konakart>/custom
$ ./custom/bin/ant
make_wars
More detailed instruction for building the war files are available in the customization FAQ if you need them.
2) Deploy the generated WAR files
This is different for different servlet conatiners, but for tomcat, just copy the .war files in <konkart>/custom/war to your tomcat's "webapps" directory.
3) Restart the servlet container (if necessary)
4) Run KonaKart and KonaKartAdmin (adjust the port as necessary):
Try http://localhost:8080/konakart/ and http://localhost:8080/konakartadmin/ in your browser.