Installing on RedHat and CentOS

Preliminaries

Ensure you have enough disk space to install OpenKM y store the document repository:

$ df -h

Once verified, create the “openkm” user:

$ adduser openkm

If Java 8 is still not installed, please install the following:

$ yum install java-1.8.0-openjdk

OpenKM currently only works with Java 8, so once the installation process is completed, verify the default version is Java 8:

# java -version
openjdk version "1.8.0_352"
OpenJDK Runtime Environment (build 1.8.0_352-b08)
OpenJDK 64-Bit Server VM (build 25.352-b08, mixed mode)

Otherwise, set Java 8 as the default one:

$ update-alternatives --config java

If you do have any other preference for a database, we suggest installing MariaDB:

$ yum install mariadb-server

After that, enable and start the MariaDB service:

$ systemctl enable mariadb
$ systemctl start mariadb

Installing OpenKM

You can choose between installing OpenKM at “/home/openkm” or “/opt.” In any case, go to the selected path and download the installer.

It’s a text-based installer, so you must execute it from the console as root. This is because it needs to install package dependencies and configure OpenKM as a service:

$ java -jar OKMInstaller.jar

Remember to check Using the installer in case of using a proxy to access the Internet.

When the installation process has finished, please ensure that Java 8 is the default one:

$ java -version

Otherwise, set it as default:

$ update-alternatives --config java

Once verified, start the required services:

$ systemctl start xvfb openkm

You can verify the status of these services this way:

$ systemctl status xvfb openkm

More info at:

Enable remote access

RedHat does not allow connection to the 8080 port by default, so you need to open this port in the firewall:

$ firewall-cmd --zone=public --permanent --add-port=8080/tcp
$ firewall-cmd --reload

Post-installation checklist

To verify the installation was successful, please use this checklist:

Verify the default Java is Java 8.
Verify you can access OpenKM from another computer.
Try to log in with the default okmAdmin / admin user and password.
Upload a Word document and check if the thumbnail is generated and the preview is shown.

Troubleshooting

If you have a problem with the thumbnail generation, please verify you have the ImageMagick package installed and the “convert” application works.

Download a sample image from Sample PNG Image and try to generate a thumbnail:

$ wget https://www.sample-videos.com/img/Sample-png-image-1mb.png
$ convert -thumbnail '80x80>' -background 'white' -flatten Sample-png-image-1mb.png sample-output.png