Wiki source code of Connect to an External Office Server
Last modified by Eleni Cojocariu-testing account on 2026/08/21 17:04
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | An externally managed office server is an office process you start and stop yourself, which XWiki only connects to, so its startup parameters and its lifetime are yours to control; to have XWiki manage the process instead, [[connect to an internal Office Server>>documentation.xs.admin.exports.office-server-properties.connect-internal-office-server.WebHome]]. To connect your wiki to an externally managed office server: | ||
| 2 | |||
| 3 | 1. Install [[LibreOffice>>https://www.libreoffice.org/]] or [[OpenOffice>>https://www.openoffice.org/]] on the server that runs XWiki. | ||
| 4 | 1. Open ##xwiki/WEB-INF/xwiki.properties## in a text editor and find the [[office server properties>>documentation.xs.admin.exports.office-server-properties.WebHome]]. | ||
| 5 | 1. Uncomment ##openoffice.serverType## and set it to ##1##. Leave ##openoffice.homePath## and ##openoffice.profilePath## commented out, since an externally managed server ignores them. | ||
| 6 | 1. Save the file and restart XWiki. | ||
| 7 | 1. Start the office server in headless mode, on the first of the ports set in ##openoffice.serverPorts##:((( | ||
| 8 | {{code language="none"}} | ||
| 9 | soffice --headless --accept="socket,host=127.0.0.1,port=8100;urp;" --nofirststartwizard | ||
| 10 | {{/code}} | ||
| 11 | |||
| 12 | where ##soffice## is the office suite executable, for example ##C:/Program Files/LibreOffice/program/soffice.exe## on Microsoft Windows. | ||
| 13 | ))) | ||
| 14 | 1. [[Administer the wiki>>documentation.xs.admin.base.content-organization.administer-wiki.WebHome]], select "Content" and then "Office Server", and click "Connect". | ||
| 15 | 1. Check that the "Server type" reads "Externally managed (local)" and the "Server state" reads "Connected":((( | ||
| 16 | {{image reference="office-server-externally.png" size="large" alt="The Office Server administration section reporting an externally managed server in the Connected state"/}} | ||
| 17 | ))) |
