Extract the KIM installation archive in the desired location. (For convenience we call the extracted folder <KIM_HOME>.)
We recommend short paths with no white spaces, such as C:\<KIM_HOME>.
Set the location of the JDK
Set the location of the JDK by uncommenting and editing the line: SET JAVA_HOME=<-- enter path to JDK here --> in <KIM_HOME>\bin\config\config.bat.
Go to Control Panel, open System, select the Advanced tab, and click Environment Variables. This opens a window where you can enter a new user variable named JAVA_HOME. Its value must be the directory where you have installed the JDK.
By default KIM tries to read the JAVA_HOME environment variable. We don't recommend using a JDK bundled with your Linux distribution. Instead use a Sun / Oracle JDK as stated in the system requirements.
You can set the path for this particular running instance of KIM by prepending the start command with the following variable assignment: JAVA_HOME=/opt/jdk1.6.0_21/ && kim start. This will overwrite the global JAVA_HOME environment variable.
Another way to set the path is to uncomment and edit the line export JAVA_HOME='<-- enter path to JDK here -->' in <KIM_HOME>/bin/config/config . If uncommented, KIM will use this value of JAVA_HOME regardless of the assignments made before that or the value of the corresponding environment variable.
Make all shell scripts executable by running the command chmod -R+x <KIM_HOME>/bin or by executing the script <KIM_HOME>/bin/utils/chmod-all.sh.
For Mac OS:
The instructions are the same as Linux with the exception that you must use the bundled JDK by Mac OS X. JAVA_HOME should point to /Library/Java/Home. See this Mac OS X reference page for details.
Remember that when you set the path, it must point to JDK and not JRE.
To enable the Web User Interface (UI) for all servlet containers, copy the contents of the services\httpd\webapps folder (located in the <KIM_HOME>) to the content delivery folder of your servlet container. (For Tomcat this is the webapps folder).