Appendix : Support for Office Formats: LibreOffice
   
Support for Office Formats: LibreOffice
Cumulus needs the open source application LibreOffice in order to properly create previews and thumbnails from office documents such as RTF files, MS Office Open XML files and templates, MS Office files and templates, Open Office files and templates, and Open Document files and templates.
NOTE: Cumulus was tested with LibreOffice 5. For security reasons, it is recommended to always install the latest stable release of LibreOffice 5
LibreOffice must be installed on the same machines as the Cumulus Client applications that do the cataloging and/or that generate previews. Cumulus Client applications comprise
• the Cumulus Desktop Client,
• all applications based on Cumulus Java Classes (CJC), such as
• Cumulus Web Solutions (Cumulus Web Client and the Cumulus Integration Platform)
• Scheduler
• Canto RoboFlow
• Cumulus File System Companion
On macOS and Linux machines, Cumulus will find LibreOffice automatically, if is installed in its default location. However, on Windows machines – as well as on macOS or Linux machines where LibreOffice was installed in a different location –, the path to the installation must be specified in the client.xml file under the key LibreOfficePath, e.g.:
<ns:LibreOfficePath>C:\Program Files (x86)\LibreOffice 5\program\soffice.exe</ns:LibreOfficePath>
Where to find the config.xml file for the Desktop Client
With the Cumulus Desktop Client the client.xml is initially contained in the installation folder. On the first start of the Desktop Client, this file is copied to a different folder:
• on Windows, to the user's AppData folder (../AppData/Roaming/Canto/Cumulus Client/conf) on Windows, or
• on OS X/macOS, to the user's Library folder (~/Library/Application Support/Canto/Cumulus Client/conf).
Only edit the client.xml file that is stored in the AppData folder or the Library folder!
Where to find the config.xml file for CJC based applications
With Client applications are based on Cumulus Java Classes, the client.xml file is located in the conf folder of the respective installation folder (e.g C:/Program Files/Canto/Cumulus Web Solutions/conf), and must be edited there.
To edit the file, you need administrator permissions on the respective machine.