View Source

To install KIM 3.6, follow the steps:

# 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
{panel:title=For Windows:}
* 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}}.
OR
* 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.{panel}
{panel:title=For Linux:}
* *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}}.{panel}
{panel:title=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|http://developer.apple.com/mac/library/qa/qa2001/qa1170.html] for details.{panel}
(!) 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 *KIM Clients* folder (located in the <KIM_HOME>) to the content delivery folder of your servlet container. (For Tomcat this is the *webapps* folder).