Forge Home

x2go

Puppet module for managing x2go server and client

9,589 downloads

996 latest version

5.0 quality score

Version information

  • 0.4.0 (latest)
  • 0.3.1
  • 0.3.0
  • 0.2.1
  • 0.2.0
released Jul 30th 2021
This version is compatible with:
  • Puppet Enterprise 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
  • Puppet >= 6.22.1 < 8.0.0
  • , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'simp-x2go', '0.4.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add simp-x2go
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install simp-x2go --version 0.4.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download
Tags: simp

Documentation

simp/x2go — version 0.4.0 Jul 30th 2021

License CII Best Practices Puppet Forge Puppet Forge Downloads Build Status

Table of Contents

Description

This is a module for managing x2go server and client installations.

This is a SIMP module

This module is a component of the System Integrity Management Platform, a compliance-management framework built on Puppet.

If you find any issues, they may be submitted to our bug tracker.

See ./REFERENCE.md for API details.

Setup

What x2go affects

The x2go module is quite minimal, like x2go itself and simply installs the required packages and allows you to configure the most common files with safe defaults in place.

Usage

The x2go client is installed by default. To disable this, set x2go::client to false in Hiera.

To install and configure the x2go server, set x2go::server to true in Hiera.

x2go requires a functioning window manager on the server to be useful and it does not perform well with compositing window managers, such as GNOME 3.

See https://wiki.x2go.org/doku.php/doc:de-compat for additional information.

It is recommended that you use the SIMP gnome module and set enable_mate to use the MATE window manager (or GNOME 2 if MATE is not available).

NOTE: The x2go server clipboard is set to server by default. This means that the client clipboard will not be exposed to the server to which you are connecting. This is done to prevent sensitive information from the client leaking onto the server by accident.

You can change this by setting the following in Hiera:

---
x2go::server::agent_options:
  '-clipboard': 'both'

Valid options include:

  • both => Bi-directional clipboard
  • server => Server side and Server to Client
  • client => Client side and Client to Server
  • none => Disable the clipboard

Development

Please read our Contribution Guide.

Acceptance tests

This module includes Beaker acceptance tests using the SIMP Beaker Helpers. By default the tests use Vagrant with VirtualBox as a back-end; Vagrant and VirtualBox must both be installed to run these tests without modification. To execute the tests run the following:

bundle install
bundle exec rake beaker:suites

NOTE: When testing this module, you will probably want to run with BEAKER_destroy=no, install the x2go client locally and connect to the running VM to ensure proper functionality.

Please refer to the SIMP Beaker Helpers documentation for more information.