libreoffice
Version information
This version is compatible with:
- Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
- Puppet >= 4.0.0
- Ubuntu, Debian
Start using this module
Add this module to your Puppetfile:
mod 'dsestero-libreoffice', '0.2.0'
Learn more about managing modules with a PuppetfileDocumentation
libreoffice
This is the libreoffice module. It allows to install libreoffice core and to start it in listen mode as a service.
Table of Contents
- Description
- Setup - The basics of getting started with libreoffice
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Description
This is the libreoffice module. It allows to install libreoffice core and to start it in listen mode as a service.
The service will be listening for connections on port 8140 and allows to produce documents by using the UNO/URE APIs.
Setup
What libreoffice affects
This module installs the specified LibreOffice version from DEB files.
LibreOffice will be installed under /opt/libreoffice and a link /opt/libreoffice will be created pointing to that folder.
An init script is deployed for starting LibreOffice as a service in listening mode.
A file with the locale environment variables configured for the specified locale is deploy under /etc/default and sourced from the init script.
LibreOffice minor versions substitute each other while packages of different major versions coexist. The module, however, does not remove LibreOffice packages; if desired, the packages related to a previous LibreOffice version could be removed by hand; for example to remove LibreOffice 4 packages issue the command:
sudo apt-get remove libreoffice4.*
Setup Requirements
This module requires the download_uncompress
module.
Beginning with libreoffice
To use the module simply declare the class and specify LibreOffice version and locale to be used:
class {'libreoffice':
majorver => '5',
minorver => '4',
incr => '6',
subincr => '2',
locale => 'it_IT',
}
Usage
The parameters of the class allow to specify the LibreOffice version. It is characterized by three numbers: major, minor, increment. A fourth number (subincrement) need also to be provided: it should be specified according to the fourth number visibile as folder name after uncompressing the distribution file.
Reference
The documentation can be generated by puppet-strings in the doc folder of the module by issuing the command:
puppet strings
inside the module directory.
See: https://puppet.com/blog/using-puppet-strings-generate-great-documentation-puppet-modules
Limitations
The module is developed and tested on Debian/Ubuntu OS platforms.
Development
If you need some feature please send me a (pull) request and send me an email at: dsestero 'at' gmail 'dot' com.
##2018-04-12 - Release - 0.2.0 ###Summary Full revision to comply with Puppet 4/5 new recommended style. Compliant with pdk. Documented with puppet strings. First release on GitHub and Puppet Forge.