Run the set-up program that executes a graphical installation wizard - see Graphical Installation Wizard below. (You can use the "Silent Mode" installation if you prefer, but the graphical version is probably easier if you're installing for the first time).

Create a terminal session on your machine and enter the following: (You may prefer to use commands to do the same thing from your X-desktop if you have one installed).

$# (replace 2.2.6.0 with the version you have downloaded)
$ chmod +x KonaKart-2.2.6.0-Linux-Install      
$ ./KonaKart-2.2.6.0-Linux-Install

If you have a graphical environment on your Linux/Unix machine you will be able to run the GUI. In which case see the Graphical Installation Wizard below (identical steps to the Windows installation).

If you don't have a graphical environment you will see this warning message:

$ ./KonaKart-2.1.0.0-Linux-Install
This program must be run in a graphical environment
or in silent, unattended mode (with the -S option).

When running in "silent" (-S) (or "unattended") mode you are able to specify configuration parameters on the command line, for example:

$ ./KonaKart-2.1.0.0-Linux-Install -S \
                  -DDatabaseType mysql
                  -DDatabaseUrl jdbc:mysql://localhost:3306/mykkdb \
                  -DDatabaseUsername kkdbusr \
                  -DDatabasePassword ikk8271

This shows a typical installation that uses the wizard:

Either double-click on the installation setup program (either KonaKart-2.2.0.4-Windows-Setup.exe on Windows, or KonaKart-2.2.0.4-Linux-Install on Linux - or respective later version numbers) or run it from a command shell. You are first presented with this small window which allows you to confirm that you wish to proceed with the installation:

Click on Yes to continue to:

Check that you have the correct version number and click on next to get to the next screen. Note in passing the email address for support questions. Please contact us and / or search the forum if you have any difficulties at all with the installation and we will endeavour to help you as soon as possible.

Please read the license agreement carefully and if you are happy to do so under the terms of the agreement, click on the "I accept the terms of the license agreement" bullet and click next to continue. If you are not prepared to accept that license agreement please quit the installation at this point.

Click on next to reach:

This is where you specify where you want KonaKart to be installed. On Windows this defaults to "C:\Program Files\", on Linux this is the user's home directory (if the user is not root) or "/usr/local" (if the user is root). This can be specified in the silent mode of on the command line of the GUI version using -DInstallationDir.

It is recommended that you accept the default location, but not essential.

On clicking next you reach:

Here you have to confirm or specify the location of the java runtime environment. The wizard will try to find this for you but it is not always successful. In the cases where it isn't successful you will have to enter the location manually. If you have installed java v5 in the default location or it appears in your environment's path, the wizard should find it for you.

Click on next to get to:

This is where you define the port number that KonaKart will run on. Actually, KonaKart uses Apache Tomcat, so this is the port number that Tomcat is configured to run on. Whilst it is certainly possible to choose another port, it's advisable to accept the default which is 8780. KonaKart will not start up if another application is using the port you select, so make sure the port you select here is not currently being used.

Clicking next moves you on to:

This is your final chance to check your settings before copying the files into position.

Clicking next will start the process of copying the KonaKart files into position as can be seen on the next screen:

After about a minute or so the file copying will have completed and you are presented with this screen to choose the Database Type that you wish to use:

Choose your preferred database type. You must set up the database yourself - this is not done as part of the installation (see database creation).

Click next to continue to :

It is very likely that you will have to modify values on this screen. You have to define the database connection parameters to KonaKart for the database that you created earlier (see database creation)

KonaKart currently supports MySQL, PostgreSQL, Oracle, DB2 and MS SQL Server and includes all the JDBC driver jars required to access these.

Note that you must append "?zeroDateTimeBehavior=convertToNull" to your Database URL if you're using MySQL.

After clicking next, the installer wil check the database connection and report the results on the next screen as follows. For an unsuccesful connection you will see something like this:

At this point you can go back and modify the database connection parameters and then click next to try the database connection test again. If successful you will see a screen like this:

If the database connection fails, you can choose to click on next and finish the installation without executing the database initialisation. Normally, for a fresh install, you are advised to correct your database connection parameters so that you see a successful database connection message, then proceed to the database initialisation screen which looks like this:

Note that the default is that the database initialisation is NOT executed. To execute it you must click on the checkbox and click next to reach the next step.

Be warned that the database initialisation script will drop and re-create all the KonaKart tables and populate them with a default set of starting data. This default starting position is ideal for users who are setting up KonaKart for the first time but this is probably not what you want to do if you already have a KonaKart database with a product catalog loaded for your store.

Note that for users who already have an existing KonaKart database (or an osCommerce database) there may be additional steps to ensure your database is suitably-configured for the version of KonaKart that you're installing. See Database Creation.

If you do not check the 'Create the tables..' box then click next you would jump to the final page of the wizard. Alternatively, if you do check the 'Create the tables...' box then click next, you will be presented with a screen that shows the loading of the database initialisation script in a scolling window which will look like this:

In the above example the script ran successfully (see last comment "SQL executed successfully" in the scrollable text area). If the script does not run successfully you will see the error message in this window.

After clicking next you reach the following screen:

Finally you are congratulated on a successful installation on the final screen of the wizard:

Finally you have the option to create a desktop icon (which is defined to start the KonaKart server and launch the GUI) and launch the application immediately after the installation has completed. The "Launch KonaKart" option executes a startup of the KonaKart server and then launches the default browser to show the KonaKart UI, and the KonaKart Administration Application.