Difference between revisions of "AppSuite:DocumentViewer"

m (Configuration)
(notes for other sections)
Line 1: Line 1:
- Produkt/App Beschreibung (Technisch)
+
=== Produkt/App Beschreibung (Technisch) ===
- Requirements
+
 
- Download and Installation
+
=== Requirements ===
 +
 
 +
=== 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.
 +
 
 +
==== ReaderEngine ====
 +
 
 +
{{AppSuite:ReaderEngineInstall}}
 +
 
 +
==== Document Viewer ====
 +
 
 +
pkg install
 +
 
 
=== Configuration ===
 
=== Configuration ===
 
To enable document viewing for OX Files the associated permission has to be set.
 
To enable document viewing for OX Files the associated permission has to be set.

Revision as of 12:53, 12 February 2013

Produkt/App Beschreibung (Technisch)

Requirements

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.

ReaderEngine

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.

Installation on OX App Suite

Debian GNU/Linux 8.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/DebianJessie/ /

and run

$ apt-get update
$ apt-get install readerengine

Debian GNU/Linux 9.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/DebianStretch/ /

and run

$ apt-get update
$ apt-get install readerengine

Debian GNU/Linux 10.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/DebianBuster/ /

and run

$ apt-get update
$ apt-get install readerengine

SUSE Linux Enterprise Server 12

Add the package repository using zypper if not already present:

$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/readerengine/SLE_12 readerengine

and run

$ zypper ref
$ zypper in readerengine

RedHat Enterprise Linux 6

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/RHEL6/
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 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

CentOS 6

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/RHEL6/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum 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.