Install and setup OpenKM

By xngo on February 21, 2019

Install & Setup OpenKM

  1. Download and install openkm-6.3.0-community-windows-installer.exe.
  2. Create an environment variable CATALINA_HOME = ...\openkm-6.3.0-community\tomcat. Otherwise, when you Start OpenKM, it will display the following message:

        The CATALINA_HOME environment variable is not defined correctly
    This environment variable is needed to run this program
     
  3. Launch the shortcut Start OpenKM from your Desktop.
  4. Open your browser and go to http://localhost:8080/OpenKM.
  5. Log in using Username/Password = okmAdmin/admin.

Troubleshooting

After you launched the shortcut Start OpenKM from your Desktop and the tomcat server is not running, do the followings:

  1. Open the Command Prompt.
  2. Execute cd <INSTALLATION_PATH_OF_OPENKM>\tomcat\bin.
  3. Execute catalina.bat run. It will display the error message.

If you executed catalina.bat run and it displayed the following message:

Error occurred during initialization of VM
Could not reserve enough space for object heap
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

Then, do the following:

  1. Open \tomcat\bin\setenv.bat.
  2. Lower the -Xmx value. Here is what I changed for my case:
set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m -XX:PermSize=256m -XX:MaxPermSize=512m -XX:+UseConcMarkSweepGC

About the author

Xuan Ngo is the founder of OpenWritings.net. He currently lives in Montreal, Canada. He loves to write about programming and open source subjects.