LibreOffice configuration management

LibreOffice configuration management tools, approaches & best practices Thorsten Behrens - tbehrens@suse.com LibreOffice Hacker at SUSE

What, Why, How Customize LibreOffice repeatably Makes your life easier, happier & more secure Large-scale deployments Improved user experience Lockdown / policy / compliance LibreOffice can do (most) of that out-of-the box! 05/31/12 LibreOffice configuration management 2

The LibreOffice config subsystem 05/31/12 LibreOffice configuration management 3

Architecture <?xml> <?xml> <?xml> <?xml> User User Configuration Configuration <?xml> <?xml> Administrative Administrative Configuration Configuration Hardwired Hardwired Configuration Configuration Schema Schema 05/31/12 LibreOffice configuration management 4

Schema Layer <oor:component-schema> <group oor:name="mygroup"> <prop oor:name="myitem" oor:type="xs:string"> <value>a Sample</value> </prop> </group> </oor:component-schema> DTD Link Hardwired Hardwired Configuration Schema Schema 05/31/12 LibreOffice configuration management 5

Admin Layer <oor:component-data> <node oor:name="mygroup"> <prop oor:name="myitem" oor:type="xs:string"> <value>a Modified Sample</value> </prop> </node> </oor:component-data> In a read-only location for plain users, e.g. /usr/lib64/libreoffice/basis3.5/share/registry/main.xcd Administrative Configuration 05/31/12 LibreOffice configuration management 6

User Layer <oor:component-data> <node oor:name="mygroup"> <prop oor:name="myitem" oor:type="xs:string"> <value>an even more modified Sample</value> </prop> </node> </oor:component-data> Few more sub-layers: DTD Link Tools->Options Extensions... User User Configuration 05/31/12 LibreOffice configuration management 7

Layer priorities Normally, upper layers win Admin config overrides schema defaults User config overrides admin value Not helpful for lock-down / security policies: Use oor:finalized="true" then in lower layers 05/31/12 LibreOffice configuration management 8

How to customize LibreOffice 05/31/12 LibreOffice configuration management 9

Clean install approach Hint: start with a completely new, clean user Configure LibreOffice via Tools->Options Extract changed config items: ~/.config/libreoffice/3/user/registrymodifications.xcu ~/Application Support/LibreOffice/3/user/registrymodifications.xcu %AppData%\LibreOffice\3\user\registrymodifications.xcu 05/31/12 LibreOffice configuration management 10

Grok <?xml> Approach Digest schema files from http://cgit.freedesktop.org/libreoffice/core/tree/officecfg/r Type up / amend your registrymodifications.xcu Just kidding - 05/31/12 LibreOffice configuration management 11

Install OOConfig extension http://users.freedesktop.org/~thorsten/extensions/ooconfig.o Tweak config, including hidden config items - DEMO - (also note my package in OBS) 05/31/12 LibreOffice configuration management 12

How to deploy customizations 05/31/12 LibreOffice configuration management 13

Create a customization extension Contains just.xcu file as payload Example here: http://users.freedesktop.org/~thorsten/extensions/config 05/31/12 LibreOffice configuration management 14

Administrative extension install To prevent your users from changing your setup: Perform an administrative installation /usr/lib64/libreoffice/program/unopkg --suppress-license --shared add path/to/config_only_sample.oxt %PROGRAMFILES%\LibreOffice 3.5\program\unopkg" add --suppresslicense --shared path\to\config_only_sample.oxt 05/31/12 LibreOffice configuration management 15

A Sample Deployable RPM If you have an RPM-based deployment: Here's a sample package in the opensuse buildservice Grab the src rpm and tweak the contained oxt for your setup Do your own rpmbuild, or branch the package on OBS 05/31/12 LibreOffice configuration management 16

Further information LDAP sample config Plain LDAP Active Directory-based Articles / Blogs Configuration details (German) Deployment & Migration 05/31/12 LibreOffice configuration management 17

Helpful links Contacting us Development: libreoffice@lists.freedesktop.org IRC: #libreoffice on freenode.net Useful links Extensions: http://extensions.libreoffice.org/ Wiki: http://wiki.documentfoundation.org This document is licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the LibreOffice name, logo, or icon. This does not include LibreOffice source code, which is licensed under the LGPLv3 (GNU Lesser General Public License). 05/31/12 LibreOffice configuration management 18