Connect to an Internal Office Server
Steps
An internally managed office server is an office process that XWiki starts and stops itself; to connect to one you run yourself, connect to an external Office Server instead. To connect your wiki to an internally managed office server:
- Install LibreOffice or OpenOffice on the server that runs XWiki.
- Open xwiki/WEB-INF/xwiki.properties in a text editor and find the office server properties.
- Uncomment openoffice.autoStart and set it to true.
- Uncomment openoffice.homePath and openoffice.profilePath and set them to the installation and profile directories of the office suite you installed.
- Save the file and restart XWiki.
- Administer the wiki, select "Content" and then "Office Server". The "Server type" reads "Internally managed (local)" and the "Server state" reads "Connected":
FAQ
Can I start and stop the office server without restarting XWiki?
Yes, the "Office Server" administration section offers "Start server (connect)", "Stop server (disconnect)" and "Restart server" for an internally managed server.
Why does the server state stay "Not Connected" after XWiki restarts?
With openoffice.autoStart left at its default of false, XWiki does not start the office server on its own: start it from the "Office Server" administration section, or set the property to true.
Why must openoffice.homePath stop at the installation directory?
Because the office executable is looked up inside it: the conversion library appends program/soffice.bin on Linux, program/soffice.exe on Microsoft Windows and program/soffice or MacOS/soffice on macOS. A homePath that already ends in program therefore fails, reporting that the directory does not contain soffice.bin. This holds on every operating system, not only on Microsoft Windows.
My office suite is version 24, so why does its profile path end in 4?
That 4 is the profile format version, which has not changed since LibreOffice 4, and not the product version. LibreOffice 24.2 still keeps its profile in .config/libreoffice/4.
