libreoffice

pdk
Installs and set up a service for libreoffice listening on port 8100.

Dario Sestero

dsestero

4,911 downloads

4,911 latest version

5.0 quality score

Version information

  • 0.2.0 (latest)
released Apr 13th 2018
This version is compatible with:
  • Puppet Enterprise 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

Documentation

dsestero/libreoffice — version 0.2.0 Apr 13th 2018

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

  1. Description
  2. Setup - The basics of getting started with libreoffice
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. 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.