AppSuite:DocumentViewer

Download and Installation

The OX Document Viewer deployment consists of two functional modules, that need to be intalled separately: the //readerengine// component and the //Document Viewer Converter Webservice// component.

Description

Readerengine is a document conversion engine based on OpenOffice. It contains some tunings special for our requirements, too. Additional there is implemented a completely new export filter for exporting any doc type to SVG.

System requirements

All available readerengine packages need to be installed on the target machine running Linux 64bit that is used for hosting the OX Document Converter.

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/readerengine/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install readerengine

Debian GNU/Linux 12.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/readerengine/DebianBookworm/ /

and run

$ apt-get update
$ apt-get install readerengine

RedHat Enterprise Linux 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/readerengine.repo

[readerengine]
name=Open-Xchange
baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/readerengine/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum install readerengine

RedHat Enterprise Linux 8

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/readerengine.repo

[readerengine]
name=Open-Xchange
baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/readerengine/RHEL8/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ dnf update
$ dnf install readerengine

CentOS 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/readerengine.repo

[readerengine]
name=Open-Xchange
baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/readerengine/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum install readerengine

Fonts

Since Appsuite 7.4.2 the readerengine comes with the packages open-xchange-documents-fonts which includes an appropriate set of fonts.

Document Viewer

pkg install

Configuration

To enable document viewing for OX Files the associated permission has to be set.

The default setting for all users is changed in the file permissions.properties in the directory /opt/open-xchange/etc.

After installation the functionality is disabled:

# Default permissions for all users
permissions=

The following line enables the functionality:

# Default permissions for all users
permissions=document_preview

Further settings for the underlying readerengine are located in the file documentconverter.properties located in the directory "/opt/open-xchange" as described above.