piwik

Piwik module

Project URL RSS Feed Report issues

Module Stats

10,313 downloads

10,313 latest version

2.6 quality score

Version information

released Oct 5th 2014

This version is compatible with:

Puppet Enterprise >= 3.2.0 < 3.4.0
Puppet 3.x
,

Start using this module

Installation method

Add this module to your Puppetfile:

mod 'bflad-piwik', '0.3.0'

Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add bflad-piwik

Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install bflad-piwik --version 0.3.0

Documentation

bflad/piwik — version 0.3.0 Oct 5th 2014

puppet-piwik

Description

Installs/Configures Piwik

Requirements

Platforms

CentOS 6
RHEL 6

Modules

Heira Data and Defaults

These facts are in the piwik:: hiera data namespace.

Fact	Description	Type	Default
install_dir	Base installation directory for Piwik	String	/opt
log_dir	Log directory for Piwik	String	/var/log/piwik
php_binary	Location of php binary	String	/usr/bin/php
tmp_dirs	Temporary directories for Piwik	String or Array of Strings	See params.pp
url	URL to download Piwik	String	http://builds.piwik.org
version	Version of Piwik to install	String	2.6.1
web_user	Web user for Piwik	String	apache

These facts are in the piwik::apache:: hiera data namespace.

Fact	Description	Type	Default
access_log_file	Filename for Piwik access log	String	piwik_access.log
admin_allowed_domains	Simple Allow from configuration	String	`(example.com
admin_allowed_ips	Simple Allow from configuration	String	`^(10.
custom_fragment	Custom configuration block for each VirtualHost	String	See params.pp
manage	Manage Apache	Boolean	true
port	HTTP port	Fixnum	80
priority	Site ordering	String	10
serveradmin	Server administrator email	String	noreply@example.com
ssl_port	HTTPS port	Fixnum	443

These facts are in the piwik::archive:: hiera data namespace.

Fact	Description	Type	Default
cron	Enables archive crontab	Boolean	true
cron_minute	Minute setting for archive crontab	String	*/10
logrotate	Enables archive log logrotate	Boolean	true
url	Piwik URL to archive	String	http://localhost

These facts are in the piwik::config:: hiera data namespace.

Fact	Description	Type	Default
manage	Manage configuration	Boolean	false (in development)

These facts are in the piwik::mysql:: hiera data namespace.

Fact	Description	Type	Default
database	MySQL database name	String	piwik
manage	Manage MySQL	Boolean	true
password_hash	MySQL user password hash, generated via `SELECT PASSWORD('password');`	String	*56E87D7B48023AB211CCB9A23F75A3CB7A8A64F3
user	MySQL user	String	piwik

These facts are in the piwik::php:: hiera data namespace.

Fact	Description	Type	Default
manage	Manage PHP	Boolean	true
memory_limit	PHP memory limit	String	256M
modules	PHP modules to install	String or Array of Strings	See params.pp
pecl_modules	PECL modules to install	String or Array of Strings	See params.pp
timezone	PHP timezone	String	America/New_York

Manifests

init Installs/Configures Piwik
augeas Defined resource to configure Piwik properties (in development)
apache Installs/Configures Apache for Piwik
archive Configures Piwik auto archive
config Configure Piwik properties (in development)
install Installs Piwik
mysql Installs/Configures MySQL for Piwik
permissions Configures permissions for Piwik
php Installs/Configures PHP for Piwik

Usage

Default Installation

Add the below to your profile.

class { 'piwik': }

Testing and Development

Quickly testing with Vagrant: VAGRANT.md
Full development and testing workflow with rspec-puppet, puppet-lint, and friends: TESTING.md

Contributing

Please use standard Github issues/pull requests and if possible, in combination with testing on the Vagrant boxes.

Maintainers

Brian Flad (bflad417@gmail.com)

Types in this module release

file_line

Ensures that a given line is contained within a file. The implementation matches the full line, including whitespace at the beginning and end. If the line is not contained in the given file, Puppet will add the line to ensure the desired state. Multiple resources may be declared to manage multiple lines in the same file.

Example:

    file_line { 'sudo_rule':
      path => '/etc/sudoers',
      line => '%sudo ALL=(ALL) ALL',
    }
    file_line { 'sudo_rule_nopw':
      path => '/etc/sudoers',
      line => '%sudonopw ALL=(ALL) NOPASSWD: ALL',
    }

In this example, Puppet will ensure both of the specified lines are
contained in the file /etc/sudoers.

Parameters
after	An optional value used to specify the line after which we will add any new lines. (Existing lines are added in place)
ensure
line	The line to be appended to the file located by the path parameter.
match	An optional regular expression to run against existing lines in the file;\nif a match is found, we replace that line rather than adding a new line.
multiple	An optional value to determine if match can change multiple lines.
name	An arbitrary name used as the identity of the resource.
path	The file Puppet will ensure contains the line specified by the line parameter.
provider

Providers
ruby

mysql_database

Manage MySQL databases.

Parameters
ensure
name	The name of the MySQL database to manage.
provider

Properties
charset	The CHARACTER SET setting for the database
collate	The COLLATE setting for the database

Providers
mysql	Manages MySQL databases.

anchor

A simple resource type intended to be used as an anchor in a composite class.

In Puppet 2.6, when a class declares another class, the resources in the interior class are not contained by the exterior class. This interacts badly with the pattern of composing complex modules from smaller classes, as it makes it impossible for end users to specify order relationships between the exterior class and other modules.

The anchor type lets you work around this. By sandwiching any interior classes between two no-op resources that are contained by the exterior class, you can ensure that all resources in the module are contained.

  class ntp {
    # These classes will have the correct order relationship with each
    # other. However, without anchors, they won't have any order
    # relationship to Class['ntp'].
    class { 'ntp::package': }
    -> class { 'ntp::config': }
    -> class { 'ntp::service': }

    # These two resources "anchor" the composed classes within the ntp
    # class.
    anchor { 'ntp::begin': } -> Class['ntp::package']
    Class['ntp::service']    -> anchor { 'ntp::end': }
  }

This allows the end user of the ntp module to establish require and before relationships with Class['ntp']:

  class { 'ntp': } -> class { 'mcollective': }
  class { 'mcollective': } -> class { 'ntp': }

Parameters
name	The name of the anchor resource.

database_user

Manage a database user. This includes management of users password as well as privileges

Parameters
ensure
name	The name of the user. This uses the 'username@hostname' or username@hostname.
provider

Properties
max_user_connections	Max concurrent connections for the user. 0 means no (or global) limit.
password_hash	The password hash of the user. Use mysql_password() for creating such a hash.

Providers
mysql	manage users for a mysql database.

mysql_grant

Manage a MySQL user's rights.

Parameters
ensure
name	Name to describe the grant.
provider

Properties
options	Options to grant.
privileges	Privileges for user
table	Table to apply privileges to.
user	User to operate on.

Providers
mysql	Set grants for users in MySQL.

mysql_user

Manage a MySQL user. This includes management of users password as well as privileges.

Parameters
ensure
name	The name of the user. This uses the 'username@hostname' or username@hostname.
provider

Properties
max_connections_per_hour	Max connections per hour for the user. 0 means no (or global) limit.
max_queries_per_hour	Max queries per hour for the user. 0 means no (or global) limit.
max_updates_per_hour	Max updates per hour for the user. 0 means no (or global) limit.
max_user_connections	Max concurrent connections for the user. 0 means no (or global) limit.
password_hash	The password hash of the user. Use mysql_password() for creating such a hash.

Providers
mysql	manage users for a mysql database.

database_grant

Manage a database user's rights.

Parameters
name	The primary key: either user@host for global privilges or user@host/database for database specific privileges
provider

Properties
privileges	The privileges the user should have. The possible values are implementation dependent.

Providers
mysql	Uses mysql as database.

database

Properties
charset	The characterset to use for a database

Providers
mysql	Manages MySQL database.

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.

Modules

Discover

Contribute

Resources

About Forge

Getting Started

piwik

Version information

This version is compatible with:

Start using this module

Documentation

puppet-piwik

Description

Requirements

Platforms

Modules

Heira Data and Defaults

Manifests

Usage

Default Installation

Testing and Development

Contributing

Maintainers

Types in this module release

file_line

mysql_database

anchor

database_user

mysql_grant

mysql_user

database_grant

database

0.3.0

0.2.0

0.1.0

Dependencies