|
Hi Zoran, i am really sorry the installation is causing you such trouble. We are really concerned to help you resolve this. I think you've pointed out the problematic point yourself: to make things easier to install (sometimes) we also modify catalina.bat. And in the case this did not happen correctly this causes the problems between the plugin and the KIM Server. I will explain why: the plugin is using an annotation server running under tomcat to communicate to the KIM Server. This annotation server is dependent on a parameter being passed to it, through a call in catalina.bat. And for this purpose catalina.bat is being modified on install time. And the problem is due to the version of the tomcat. It is our mistake we did not see earlier what version you are using. please refer to your system documentation .../doc/sys-doc/kim-platform-administration/configure-kim-webui.html or http://www.ontotext.com/kim/doc/sys-doc/kim-platform-administration/configure-kim-webui.html where the problem is explained. i just found out that there are differences between the most up-to-date documentation and what is available in the installation or on the web site. So i am also attaching it. i hope this resolves this issue ! good luck and thank you for your patience borislav Zoran Jeremic wrote:
|
KIM WebUI
This configuration manual of the KIM WebUI is intended to be used in one of the following two cases:- the user skipped configuring WebUI when promted during the KIM install, had no Tomcat installed or pointed to an invalid Tomcat folder, and at present wants to configure the WebUI manually on the same machine
- the user wants the WebUI to run on a separate machine from the KIM Server, i.e. needs to copy and configure it there
- some error occured during installation and the automatic configuration failed (e.g. Tomcat 5.5.x and 6.0.x for Windows are installed as services only, so they don't have the %TOMCAT_HOME%/bin/*.bat(*.sh) start/stop scripts that KIM WebUI uses)
Requirements :
In order for KIM WebUI to be able to connect to the KIM Server (to the machine where the sever runs) some conditions must be met:
- If a proxy runs there it must be configured to open the port that KIM Server is available at for connections through RMI (by default 1099).
- The JVM that KIM Server uses must be configured
so that it allows calls on that port too. This is
done by editing permissions in:
(JRE) /$JRE/lib/security/java.policy
(JDK) /$JDK/jre/lib/security/java.policy
- Install Tomcat on the machine you want.
- Install KIM Platform on the machine you want the KIM Server to run on, follow the install instructions and when prompted for Tomcat folder just cancel the dialog that appears. However, after the install you will still have the WebUI files available, so you can manually configure it to run wherever you want.
- From the install path of the KIM Platform
go to the %KIM_HOME%/KIM Clients folder and get from there:
- KIM.war - In order not to go back to the KIM Server machine
in the proccess of the following WebUI configuration
just take some notes that will be needed:
- host name or IP
- JVM environmental variables from bin/config_kim.bat or ./bin/config_kim.sh e.g. :REM ********************************************************** REM * config_kim.bat REM ********************************************************** REM *** KIM Server installation folder *** set KIM_HOME=< kim home folder here > set KIM_CONTEXT=D:/kim/context/kim-platform REM *** SWAN installation folder *** set SWAN_HOME=%KIM_HOME%/kim-cluster set SWAN_RMI_HOST=-D"java.rmi.server.hostname=localhost"or########################################################## # config_kim.sh ########################################################## ### KIM Server installation folder ### export KIM_HOME='< kim home folder here >' export KIM_CONTEXT="$KIM_HOME/context/default" ### SWAN installation folder ### export SWAN_HOME="$KIM_HOME/kim-cluster" export SWAN_RMI_HOST=-D'java.rmi.server.hostname=localhost' - Go to the server where WebUI will run,
go to the %TOMCAT_HOME%/webapps folder and place there
the file you copied on step (3) :
- KIM.war
- Edit the kwebui.config file and set the parameters for
- kim-rmi-host
- kim-rmi-port - Finally, here is the most unpleasant part. Go to the
%TOMCAT_HOME%/bin folder and edit
catalina.bat or respectively catalina.sh file:
- place those JVM variables you took note of earlier in the beggining of the file, just after the comments
- change the SWAN_RMI_HOST variable only, so that instead localhost there is placed the KIM Server machine name or IP
- leave the rest of them as they are, paths must be as they are on the KIM Server machine
- and to finish, place these variables everywhere in the file where java is invoked to make it look like this (the presence of the quotes is essential):%_EXECJAVA% %JAVA_OPTS% -D"kim.home.dir=%KIM_HOME%" -D"kim.context.dir=%KIM_CONTEXT%" -D"swan.home.dir=%SWAN_HOME%" %SWAN_RMI_HOST% .......
or"$_RUNJAVA" $JAVA_OPTS -D"kim.home.dir=$KIM_HOME" -D"kim.context.dir=$KIM_CONTEXT" -D"swan.home.dir=$SWAN_HOME" $SWAN_RMI_HOST .......
Specifics : configuring KIM WebUI when Tomcat runs as a service (Windows only)
- Do the entire Preparations section and make the configurations as in step (1) from the Configure section.
- Repeat the same actions as in step (2) from from the Configure section but instead of editing catalina.bat or respectively catalina.sh file
open Configure Tomcat from your Tomcat program menu group. Add all the above Java options in the Java Options field on the Java tab
of the dialog box that will appear using particulal values instead of shell script variables. Your addition should look like this:
-D"kim.home.dir=c:\kim-platform" -D"kim.context.dir=c:\kim-platform\context\default" -D"swan.home.dir=c:\kim-platform\kim-cluster" -D"java.rmi.server.hostname=localhost"
- You may also optionally need to manually copy %JAVA_HOME%/lib/tools.jar from the JDK to the %TOMCAT_HOME%/common/lib directory in order to be able to compile JSP pages.
- Restart of the Tomcat service is required for the changes to take effect.
After finishing all those configuration tasks, run your KIM Server, run your Tomcat (on the separate machine) and try playing with the WebUI on the following address:
http://host:port/KIM
where host is the name or IP of the machine you run the WebUI on, and port is the port you configured Tomcat to run on.
Administration :: Configuration :: KIM WebUI
_______________________________________________ NOTE: Please REPLY TO ALL to ensure that your reply reaches all members of this mailing list. KIM-discussion mailing list [email protected] http://ontotext.com/mailman/listinfo/kim-discussion_ontotext.com
