Version information
This version is compatible with:
- Puppet Enterprise 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
- Puppet >= 5.0.0 < 7.0.0
- CentOS,RedHat,OracleLinux
Start using this module
Documentation
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.
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 clipboardserver
=> Server side and Server to Clientclient
=> Client side and Client to Servernone
=> 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.
- Thu Jul 23 2020 Jeanne Greulich jeanne.greulich@onyxpoint.com - 0.3.0
- update the upper bound of simplib for SIMP 6.5 release
- Fri Aug 02 2019 Robert Vincent pillarsdotnet@gmail.com - 0.3.0
- Remove Puppet 4 support
- Add Puppet 6 support
- Add puppetlabs-stdlib 6 support
- Thu Mar 07 2019 Liz Nemsick lnemsick.simp@gmail.com - 0.2.1
- Update the upper bound of stdlib to < 6.0.0
- Update a URL in the README.md
- Thu Nov 01 2018 Liz Nemsicklnemsick.simp@gmail.com - 0.2.0
- Update to Hiera 5
- Thu May 17 2018 Trevor Vaughan tvaughan@onyxpoint.com - 0.1.0
- Initial release of the x2go module
Dependencies
- simp/dconf (>= 0.0.1 < 2.0.0)
- simp/gnome (>= 8.0.0 < 9.0.0)
- simp/mate (>= 1.0.0 < 2.0.0)
- simp/simplib (>= 3.3.1 < 5.0.0)
- puppetlabs/stdlib (>= 4.13.1 < 7.0.0)
x2go - Puppet module for managing x2go server and client Per Section 105 of the Copyright Act of 1976, these works are not entitled to domestic copyright protection under US Federal law. The US Government retains the right to pursue copyright protections outside of the United States. The United States Government has unlimited rights in this software and all derivatives thereof, pursuant to the contracts under which it was developed and the License under which it falls. --- Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.