Chapter 5. Installation

Table of Contents

Before You Begin
Platforms Supported
Pre-requisites
Install Java
Create a Database
Upgrading the Database between releases of KonaKart
Install KonaKart
Installing KonaKart on Windows
Installing KonaKart on Unix/Linux
Silent Mode Installations
Graphical Installation Wizard
Manual Installation
Starting Up and Shutting Down KonaKart
Starting up KonaKart
Shutting down KonaKart
Setting up KonaKart as a Windows Service
KonaKart as a Service - option 1
KonaKart as a Service - option 2
Default Admin App Credentials
Admin Password Validation
Super User
Installation Notes for Databases
Defining the Database Parameters
Encrypting the Database Parameters
Defining the Database Parameters - Using JNDI
Notes for DB2 and Oracle
Notes for Postgresql
Notes for MySQL
Notes for Microsoft SQL Server

Please read this section carefully before attempting to install KonaKart.

Before You Begin

Before proceeding, please check that your chosen platform is one that is currently supported and that you have installed the pre-requisite software.

Platforms Supported

Currently KonaKart can be installed on Linux, Unix, or Windows XP/2003/Vista/7/8/10. It has been successfully installed on other platforms including Mac OS using the manual installation .

Please contact the KonaKart team at if you would like to see KonaKart support running on another platform.

Pre-requisites

  • A Java runtime environment

  • A database loaded with KonaKart tables

  • KonaKart itself

Install Java

KonaKart requires a Java Development Kit for full functionality. For version 8.1.0.0 you must use Java 7 or Java 8. For version 9.0.0.0 you must use Java 8. For version 9.2.0.0 you can use Java 8 through Java 13.

  • Download and install Java JDK version 8.0. (A good choice is typically the OpenJDK supported on your chosen platform).

  • Install the Java JDK according to the instructions included with the release.

  • Ensure you have set JAVA_HOME in your environment prior to installation.

    The installer attempts to locate your JRE automatically but you can override the one that's found if you require. The selected JRE is validated to help you avoid typing errors when entering the JRE location manually.