Tuesday 26 June 2012

Review OPENKM : Document management Software and installation Problems

My setup is windows XP PC. I  wanted to download OpenKM so i searched and got this link:

http://www.openkm.com/en/download-english.html

If you click on "Only Download" you get the page where you can download the software, but its not working. It downloaded one file which was not working and says only 30Kb. At this time i stopped thinking if the download itself is not working how poorly they must have maintained the software. But i must say i was wrong. I stopped for few days as was busy in some other work.

Again when i searched i got this link for download:

http://sourceforge.net/projects/openkm/files/

This when downloaded it was of 190MB and it was working fine.

We need Java jdk i had already installed jdk-6u26-windows-i586.exe  from


http://www.oracle.com/technetwork/java/javase/downloads/index.html

The OPEN KM installer is thisone :OpenKM-5.1.10_JBoss-4.2.3.GA.exe


Now installation starts :

1) Followed instruction given in

http://wiki.openkm.com/index.php/Quick_Install:_OpenKM_5

a) Uncompress on your file system disk  My installation has xampp. So the default path for me is c:\xampp\htdocs\


b) Open command prompt. Go to C:\xampp\htdocs\jboss-4.2.3.GA\bin and give in command line

      
            run.bat -b 0.0.0.0

c) now click on  http://localhost:8080/OpenKM/.This will open login page with default username as "okmadmin" and password as "admin"

d) login and see how it works.

Issues faced:


1) Once the server started i got error message as "JAVA_Home" not set so to avoid this error message i had set the JAVA_HOME variable in run.bat like this after below lines:

==========================
set RUNJAR=%JBOSS_HOME%\bin\run.jar
if exist "%RUNJAR%" goto FOUND_RUN_JAR
echo Could not locate %RUNJAR%. Please check that you are in the
echo bin directory when running this script.
goto END

:FOUND_RUN_JAR

set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_26
==================================

The issue got resolved.




2) After some time i started getting these messages, and the web page stopped responding:
==================================
15:02:11,343 ERROR [CoyoteAdapter] An exception or error occurred in the container during the request processing
java.lang.OutOfMemoryError: PermGen space

===================================


This issue is resolved by adding below lines in run.bat


-----------------------------------------------------------
rem JVM memory allocation pool parameters. Modify as appropriate.
set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:PermSize=64m -XX:MaxPermSize=128m -Djava.awt.headless=true--------------------------------------------------------------
The issue got resolved.

3)  After this i logged in the server and created some "userroles" but i was unable to do anything. For this issue to resolve we need to change:

 in openKM.cfg -> change "hibernate.hbm2ddl=create" to "hibernate.hbm2ddl=none"

4)  Suddenly i started getting these messages


HTTP Status 404 - /OpenKM/j_security_check

--------------------------------------------------------------------------------

type Status report

message /OpenKM/j_security_check

description The requested resource (/OpenKM/j_security_check) is not available.
-------------------------------------------------------------------------------





JBossWeb/2.0.1.GA

To resolve this i stopped the server, closed all open browser and restarted the server and browser. The issue got resolved. Still not sure why the issue came.


5) After this i was able to create users and user roles but when i created users with some user roles i was unable to login to the server with that user name. Eg. I created user "A" with user role as "DEPT A" and user "B" with user role as "Dept B" . When i tried to login with user A i got below messages

===============================.HTTP Status 403 - Access to the requested resource has been denied

type Status report

message Access to the requested resource has been denied

description Access to the specified resource (Access to the requested resource has been denied) has been forbidden.
JBossWeb/2.0.1.GA
=======================

To resolve this issue the user has to be part of default "UserRole" group. So i selected user with user roles as "Dept A" and "UserRole" and similarly with user B. And i was able to login with both the accounts

6) Some small issues but which took me time to figure out:

  a) For everything first see right click is giving you some option or not.

  b) In Create folder if we create the folder and try to click anywhere else , after giving name the folder wont get created or sometimes the webpage stops working.  Easy way "right click on "okm:root" create folder , give name and again "right click" immediately the folder gets created.

c) Adding user : It costs me almost half day to find out how to add user. I may be dumb but i tried to follow this

http://wiki.openkm.com/index.php/Create_users_and_roles

and i could not find anywhere how to add users. I guess it was different in previous version and they have not updated the document.

A small + is there in Administration -> users icon.



OK after all this its done. Now i can add users, departments, folders, files , security option for each file which can restrict users or groups. I can checkout and checkin so it has versioning control. I can search with title and user name.

I has these features/issue but still i need to verify and see how it is working

1) Email notification
2) open office integration  for  file preview
3) Need to restart every-time the server so need to write a script to restart automatically.

Will post in another entry after i am done with this. But as of now this looks best.Also all these issues got resolved with the help of friend "Google" and OpenKM Forum friends. Thanks to them for helping me out with these issues.