AppSuite:Text Installation Guide 7 8 0
Download & Installation OX Text
Requirements
See the Open-Xchange software requirements page for details.
OX Text needs to be installed in an OX App Suite configuration with a backend based on Grizzly (including hazelcast as installed and activated by default).
For compatibility with DOC files (not DOCX) and for printing functionality in OX Text the document converter components (incl. readerengine) are required. These are not available in the Community Version of OX AppSuite.
Mandatory Modules
Additional functional modules need to be installed separately:
- The Document Converter API: See Document converter API installation instructions
Installation
The OX Text deployment consists of the packages open-xchange-documents-backend and open-xchange-documents-ui.
Redhat Enterprise Linux 6 or CentOS 6
Add the following repositories to your Open-Xchange yum configuration:
[open-xchange-office] name=Open-Xchange-office baseurl=https://software.open-xchange.com/products/appsuite/stable/office/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-office-web] name=Open-Xchange-office-web baseurl=https://software.open-xchange.com/products/appsuite/stable/office-web/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-documentconverter-api] name=Open-Xchange-documentconverter-api baseurl=https://software.open-xchange.com/products/appsuite/stable/documentconverter-api/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-calcengine] name=Open-Xchange-calcengine baseurl=https://software.open-xchange.com/products/appsuite/stable/calcengine/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
if you have a valid maintenance subscription, please add also following repositories by replacing the credentials.
[open-xchange-office-updates] name=Open-Xchange-office-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office/updates/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-office-web-updates] name=Open-Xchange-office-web-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office-web/updates/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-documentconverter-api-updates] name=Open-Xchange-documentconverter-api-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/documentconverter-api/updates/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-calcengine-updates] name=Open-Xchange-calcengine-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/calcengine/updates/RHEL6/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
$ yum install open-xchange-documents-backend open-xchange-documents-ui open-xchange-documents-ui-static
Redhat Enterprise Linux 7 or CentOS 7
Add the following repositories to your Open-Xchange yum configuration:
[open-xchange-office] name=Open-Xchange-office baseurl=https://software.open-xchange.com/products/appsuite/stable/office/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-office-web] name=Open-Xchange-office-web baseurl=https://software.open-xchange.com/products/appsuite/stable/office-web/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-documentconverter-api] name=Open-Xchange-documentconverter-api baseurl=https://software.open-xchange.com/products/appsuite/stable/documentconverter-api/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-calcengine] name=Open-Xchange-calcengine baseurl=https://software.open-xchange.com/products/appsuite/stable/calcengine/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
if you have a valid maintenance subscription, please add also following repositories by replacing the credentials.
[open-xchange-office-updates] name=Open-Xchange-office-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office/updates/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-office-web-updates] name=Open-Xchange-office-web-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office-web/updates/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-documentconverter-api-updates] name=Open-Xchange-documentconverter-api-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/documentconverter-api/updates/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
[open-xchange-calcengine-updates] name=Open-Xchange-calcengine-updates baseurl=https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/calcengine/updates/RHEL7/ gpgkey=https://software.open-xchange.com/oxbuildkey.pub enabled=1 gpgcheck=1 metadata_expire=0m
$ yum install open-xchange-documents-backend open-xchange-documents-ui open-xchange-documents-ui-static
Debian GNU/Linux 7.0
Add the following repositories to your Open-Xchange apt configuration:
deb https://software.open-xchange.com/products/appsuite/stable/office/DebianWheezy /
deb https://software.open-xchange.com/products/appsuite/stable/office-web/DebianWheezy /
deb https://software.open-xchange.com/products/appsuite/stable/documentconverter-api/DebianWheezy /
deb https://software.open-xchange.com/products/appsuite/stable/calcengine/DebianWheezy /
if you have a valid maintenance subscription, please add also following repositories by replacing the credentials.
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office/updates/DebianWheezy /
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office-web/updates/DebianWheezy /
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/documentconverter-api/updates/DebianWheezy /
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/calcengine/updates/DebianWheezy /
$ apt-get update $ apt-get install open-xchange-documents-backend open-xchange-documents-ui open-xchange-documents-ui-static
Debian GNU/Linux 8.0
Add the following repositories to your Open-Xchange apt configuration:
deb https://software.open-xchange.com/products/appsuite/stable/office/DebianJessie /
deb https://software.open-xchange.com/products/appsuite/stable/office-web/DebianJessie /
deb https://software.open-xchange.com/products/appsuite/stable/documentconverter-api/DebianJessie /
deb https://software.open-xchange.com/products/appsuite/stable/calcengine/DebianJessie /
if you have a valid maintenance subscription, please add also following repositories by replacing the credentials.
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office/updates/DebianJessie /
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office-web/updates/DebianJessie /
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/documentconverter-api/updates/DebianJessie /
deb https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/calcengine/updates/DebianJessie /
$ apt-get update $ apt-get install open-xchange-documents-backend open-xchange-documents-ui open-xchange-documents-ui-static
SUSE Linux Enterprise Server 11
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/office/SLES11 office
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/office-web/SLES11 office-web
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/documentconverter-api/SLES11 documentconverter-api
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/calcengine/SLES11 calcengine
if you have a valid maintenance subscription, please add also following repositories by replacing the credentials.
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office/updates/SLES11 office-updates
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office-web/updates/SLES11 office-web-updates
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/documentconverter-api/updates/SLES11 documentconverter-api-updates
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/calcengine/updates/SLES11 calcengine-updates
$ zypper ref $ zypper install open-xchange-documents-backend open-xchange-documents-ui open-xchange-documents-ui-static
SUSE Linux Enterprise Server 12
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/office/SLE_12 office
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/office-web/SLE_12 office-web
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/documentconverter-api/SLE_12 documentconverter-api
$ zypper ar https://software.open-xchange.com/products/appsuite/stable/calcengine/SLE_12 calcengine
if you have a valid maintenance subscription, please add also following repositories by replacing the credentials.
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office/updates/SLE_12 office-updates
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/office-web/updates/SLE_12 office-web-updates
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/documentconverter-api/updates/SLE_12 documentconverter-api-updates
$ zypper ar https://LDBUSER:LDBPASSWORD@software.open-xchange.com/products/appsuite/stable/calcengine/updates/SLE_12 calcengine-updates
$ zypper ref $ zypper install open-xchange-documents-backend open-xchange-documents-ui open-xchange-documents-ui-static
Univention Corporate Server
OX Text for OX App Suite for UCS is available in the Univention App Center. Please check the UMC module App Center for the installation of the OX Text at your already available environment.
Printing and .doc Editing
For .DOC and/or printing support from OX Text the Document Converter and readerengine components have to be installed separately (license key required)
Spell Checking
OX Text is able to use hunspell for spell checking functionality.
After installation of the hunspell package for your platform the shared library and the US English dictionaries are available.
Additional dictionaries are published for your platform as packages hunspell-de-de, hunspell-fr, ...
Configuration
Permissions
To enable OX Text for OX Drive the associated permission has to be set.
The default setting for all users is changed in the file documents.properties in the directory /opt/open-xchange/etc.
After installation the functionality is disabled:
# Enables or disables the "text" module capability globally. #com.openexchange.capability.text=true
The following line enables the functionality:
# Enables or disables the "text" module capability globally. com.openexchange.capability.text=true
Starting with 7.6.2, you can disable the text portal app. In permissions.properties:
permissions=textportaldisabled
Spell Checking
Spell checking has to be configured in the file /opt/open-xchange/etc/hunspell.properties. The values for the shared library file and dictionary path have to be set according to the platform.
This example shows the values for Debian:
# The name and location of the hunspell library # Default value: "/usr/lib/x86_64-linux-gnu/libhunspell-1.3.so.0" com.openexchange.spellchecker.hunspell.library=/usr/lib64/libhunspell-1.2.so.0 # The location of the dictionaries # Default value: "/usr/share/hunspell" com.openexchange.spellchecker.hunspell.dictionaries=/usr/share/hunspell
Templates
OX Text and OX Spreadsheet support different levels to provide document templates for users.
A number of ready-to-use templates for letters, memos, resumes, home budget, etc is included with the system. These templates are made available in a directory at each system node by installation of the package open-xchange-documents-templates. The path to this directory is defined in the office.properties file
# Defines the absolute path where document templates are located inside the local (!) file system. # The templates are displayed in the documents applications. # If this property is missing a default '/opt/open-xchange/templates/documents' is taken. io.ox/office//module/templatePath = /opt/open-xchange/templates/documents
The content in the directory specified by the path must comply to the following rules:
/opt/open-xchange/templates/documents | ----> text [application type] | | | ----> en-US [language-region] | | | ----> en [language fallback, en is also fallback for all other non-convered languages] | | | ----> de-DE | | | ----> de | | | ----> common [language independent, used in addition to the language specific ones] | ----> spreadsheet
A context administrator can additionally provide global templates for all users in the same context. If logged in with this role folders can be added to or removed from the list of global template folders. For regular users the list is displayed without the permission to modify it.
Users can create and manage their own templates. These user templates are stored and retrieved from the user’s root folder (“My files”). In addition to the root folder the user can define more template folders, sub-folders or even external folders in the “Documents” section of the “Settings” menu. This helps to organize templates and allows cleanup of the root folder by removal of templates.