Quick Install - OpenKM 6.3

From OpenKM Documentation
Jump to: navigation, search

In less than five minutes you can install OpenKM and run it on your own server.


Nota advertencia.png There's a property definition in OpenKM.cfg to automatically create the OpenKM database. Once the tables are created, OpenKM itselft will change the hibernate.hbm2ddl configuration property from create to none.

Windows

Installation with wizard

If you decide install OpenKM with wizard, simply follow the installer screen instructions. To prevent problems with white space in the installation path - tomcat installation can have problems on some Windows OS if the installation path has white spaces - we recommend to install OpenKM on root disk ( for example C:\ ). OpenKM installer will install java jdk in your OpenKM installation folder too.

Installation without wizard

Requirements are:

  • Install OpenKM-Tomcat bundle
  • Install java jdk 1.7

Install Java JDK 1.7

Go to the Oracle Java download site and select to download the Java Developer Kit (JDK) 7, latest update. The url is http://www.oracle.com/technetwork/java/javase/downloads/index.html (Note that the url or version number may change as time goes by). When the file has been downloaded, execute it to install Java on your system using the setup wizard.

Install OpenKM

Download the OpenKM 6 + Tomcat 7 bundle and uncompress on your file system disk (a good option is to uncompress on C:\). If you experience problems uncompressing OpenKM-6.x.x-community-tomcat-bundle.zip, try using the WinRAR application to uncompress it.


Nota idea.png Once installed, please read Basic application knowledge and User Guide to familiarize yourself with OpenKM, Application configuration for configuration details, or Administration Guide to become an OpenKM power administator. If you have any problem, take a look at the Troubleshooting section.

First login

Linux

Installation with wizard

If you decide install OpenKM with wizard, simply follow the installer screen instructions. OpenKM installer will install java jdk in your OpenKM installation folder too.

Installation without wizard

Requirements are:

  • Install OpenKM-Tomcat bundle
  • Install java jdk 1.7

There are several ways to install it. These steps were used to install on Ubuntu but can be used for any other Linux flavor.

Install Java JDK 1.7

Execute the following command on the terminal

$ sudo aptitude install sun-java6-bin sun-java6-jdk sun-java6-jre

Install OpenKM

Download the OpenKM 6 + Tomcat 7 bundle and uncompress on your file system disk (a good option is to uncompress under /opt/).

Execute the following command on the terminal

$ unzip OpenKM-6.x.x-community-tomcat-bundle.zip

Nota idea.png Once installed, please read Basic application knowledge and User Guide to familiarize yourself with OpenKM, Application configuration for configuration details, or Administration Guide to become a OpenKM power administator. If you have any problem, take a look at the Troubleshooting section.

First login

Mac OS X

You don't need to install Java for OS X... Java is installed by default and shipped with every OS X. The only important thing is to update your version of Java to the latest, through OS X System Software update. This is to ensure you have the latest Java version, especially for OS X 10.6.6 and above, which makes your version of Java(SE) capable of 32bit & 64bit.

Note: Don't go to the Java or Oracle website to acquire Java. Apple supplies and maintains Java for OS X. This is true as of Java 1.6 though this practice might change with Java 1.7. Because Apple maintains their own Java, every Java application in OS X looks and performs like a native cocoa application.

JDK 1.7 for Mac OS X?

The whole JDK (JRE,JVM, Class Libraries, Development tools such as compiler) are built into every OS X, thus making installation of OpenKM the easiest of all 3 (Windows, Linux, MacOS X) platforms - No need to install Java from any website. Just extract and run your OpenKM installation.

Install OpenKM

Download the OpenKM 6 + Tomcat 7 bundle and uncompress on your file system disk (a good option is to uncompress under /Library) or alternatively copy, move by OS X GUI, open a new finder window and browse your Macintosh HD, Locate and move/copy OpenKM 6 + Tomcat 7 inside the Library folder.

In OS X, open the Terminal application by browsing through Finder and navigate to Applications/Utilities folder and double click Terminal application.

Execute the following command on the terminal OR alternatively, just double click the zip file you have copied/moved in the finder and it will extract itself! Same result and no need to type or use Terminal commands.

$ unzip OpenKM-6.x.x-community-tomcat-bundle.zip

Nota idea.png Once installed, please read Basic application knowledge and User Guide to familiarize yourself with OpenKM, Application configuration for configuration details, or Administration Guide to become a OpenKM power administrator. If you have any problem, take a look at the Troubleshooting section.

First login