Version information
This version is compatible with:
- Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
- Puppet >= 2.7.0 < 5.0.0
- Debian, ,
Start using this module
Add this module to your Puppetfile:
mod 'genebean-networker', '1.1.2'
Learn more about managing modules with a PuppetfileDocumentation
networker
Table of Contents
Overview
This module installs the EMC NetWorker backup client and/or server.
It is assumed that the installation packages are available via a repository
the client has access to. It also manages the servers
file.
Setup
What networker affects
- the
lgtoclnt
andlgtoman
packages - the content in
/nsr/res/servers
- the service
networker
Setup Requirements
An assumption is made that you have setup a private repository to hold the packages for installing the NetWorker client.
Beginning with networker
Once you have a repo setup all you have to do is include networker in your manifest somewhere. You can, optionally, set the servers that are allowd to access the client via a parameter or via the file backend to hiera.
Usage
Basic usage:
include networker
Set the servers allowed to access the client:
class { 'networker':
servers => ['server1.example.com', 'server2.example.com'],
}
Pull the file representing /nsr/res/servers
from hiera:
class { 'networker':
servers_file => 'hiera',
}
Parameters
Package Installation
install_client
Installs the Networker client packages "lgtoclnt", "lgtoman"
Default: true
Hiera parameter: networker::install::install_client
install_console
Installs the Networker console package "lgtonmc"
Default: false
Hiera parameter: `networker::install::install_console``
install_nmda
Installs the Networker Module for Databases and Applications package "lgtonmda"
Default: false
Hiera parameter: networker::install::install_nmda
install_sap
Installs the Networker Module for SAP package "lgtonmsap"
Default: false
Hiera parameter: networker::install::install_sap
install_server
Installs the Networker server package "lgtoserv"
Default: false
Hiera parameter: networker::install::install_server
install_storagenode
Installs the Networker storagenode package "lgtonode"
Default: false
Hiera parameter: networker::install::install_storagenode
version_client
Sets the version of the client to install.
Default: present
Hiera parameter: networker::install::version_client
version_console
Sets the version of the console to install.
Default: present
Hiera parameter: networker::install::version_console
version_nmda
Sets the version of the nmda module to install.
Default: present
Hiera parameter: networker::install::version_nmda
version_sap
Sets the version of the sap module to install.
Default: present
Hiera parameter: networker::install::version_sap
version_server
Sets the version of the server to install.
Default: present
Hiera parameter: networker::install::version_server
version_storagenode
Sets the version of the storagenode to install.
Default: present
Hiera parameter: networker::install::version_storagenode
Config Settings
connection_portrange
Sets the system's connection ports to the ranges specified.
Type: String
Default: 0-0
servers
The servers that should be entered into /nsr/res/servers
Type: array
Default: []
servers_file
Determines where the content for the servers file comes from. Valid values are
'template'
and 'hiera'
.
template
: takes the array passed to $servers and uses it to construct/nsr/res/servers
.hiera
: takes advantage of the file backend for hiera and looks for the specified file there (seeservers_file_name
).
Type: String
Default: 'template'
servers_file_name
The name of the file in hiera that contains the desired contents of
/nsr/res/servers
Type: String
Default: 'networker_servers'
service_portrange
Sets the system's service ports to the ranges specified.
Type: String
Default: 7937-9936
Limitations
This should work on the RedHat
and Debian
families of OS's. Additional
support is welcomed, just submit an issue with the details. Support for
Windows is planned for a future release.
Development
Pull requests are welcomed! Many thanks to Sebastian Ickler for adding features beyond the client setup to this module. If you add any code please try to make sure it will only be executed on OS's that support it.
License
This is released under the New BSD / BSD 3 Clause license. A copy of the license can be found in the root of the module.
2015-11-09 Release 1.1.2
- Fixed circular dependency related to setting ports
- Updated test matrix to include Puppet 4
- Fixed manifests with unquoted variables
2015-04-23 Release 1.1.0
- Alphabetized many things
- Added code to make this only run on Linux for now
- Server components can now be installed too
- Custom facts added for service ports and connection ports
2015-01-21 Release 1.0.0
- Initial release
Dependencies
- puppetlabs-stdlib (>= 1.0.0)
Copyright (c) 2015, Gene Liverman All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of genebean-networker nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.