This module is designed to fetch and perform a very basic configuration of Open Web Analytics with very basic security in place to allow for immediate usage of the software on any LAMP stack.
- This module will fetch a GitHub repository into a directory that is defined
- Various permissions of the files fetched are modified to prevent security risk
- A database is created for the usage of the software
For information as to what this module requires, please first see https://github.com/padams/Open-Web-Analytics/wiki/Technical_Requirements.
Most important being PHP with MySQL and necessary extensions. This module also does require puppetlabs-mysql to configure the database on your platform.
To simply configure Open Web Analytics:
include openwa
You may also use the cli/install define to setup OpenWA if you have provided a configuration
Alternatively after you have setup Open Web Analytics, you can add additional sites:
openwa::cli::add_site { 'somedomain.net':
cli_domain => 'https://www.somedomain.net',
}
This class creates a database and fetches Open Web Analytics from GitHub
This will also setup a basic configuration for initial use
Parameters within openwa
:
This is the name of your database, such as openwa
This is the host of your database, such as localhost
This is the database user which would have access to the database
This is the password your user requires to access the database
This password is also used if the openwa::cli::install class is used
This is the directory where openwa will be installed on the file system.
Do not forget to include a trailing slash
This information defines the URL in the configuration which defaults to the FQDN of the system
This is the source for the repository for Open Web Analytics
This is a control reference tag or revision
Fetch and configure Open Web Analytics for a generic installation
Update permissions for standard security
Parameters within openwa::package
:
This defines the files' owner
This defines the files' group
This is the source for the repository for Open Web Analytics
This is a control reference tag or revision
This is the name of your database, such as openwa
This is the host of your database, such as localhost
This is the database user which would have access to the database
This is the password your user requires to access the database
This password is also used if the openwa::cli::install class is used
This is the directory where openwa will be installed on the file system.
Do not forget to include a trailing slash
This information defines the URL in the configuration which defaults to the FQDN of the system
Create the Open Web Analytics Database and User
Parameters within openwa::database
:
This is the name of your database, such as openwa
This is the host of your database, such as localhost
This is the database user which would have access to the database
This is the password your user requires to access the database
This password is also used if the openwa::cli::install class is used
This will allow puppet to call the cli.php directly
Simple Usage:
openwa::cli { 'flush_cache':
cli_cmd => 'flush-cache',
cli_args => '',
}
Parameters within openwa::cli
:
This is the directory where openwa will be installed. Do not forget to include a trailing slash
This defines the files' owner
This defines the files' group
This is the path for php for your cli.php executions
This is the name of your cli.php if you change it
This is a custom string of arguments passed for cli.php
See https://github.com/padams/Open-Web-Analytics/wiki/Command-Line-Interface-%28CLI%29
This is the type of command you want to run with cli.php
Automate the site settings or profile for any existing site
Simple Usage:
openwa::site_settings { 'somedomain.net':
settings_domain => 'http://www.somedomain.net/',
filter => '.+',
rules => [
'(/view1)(/[^/]+) -> \$1',
'(/view2)(/[^/]+) -> \$1'
],
}
Parameters within openwa::site_settings
:
This is the name of your database, such as openwa
This is the host of your database, such as localhost
This is the database user which would have access to the database
This is the password your user requires to access the database. This password is also used if the openwa::cli::install class is used
This will determine where your mysql binary is located
This will determine the domain you wish to update the profile for
P3P Compact Privacy Policy under Site Settings This setting controls the P3P compact privacy policy that is returned to the browser when OWA sets cookies
Domain Aliases under Site Settings This setting allows you to specify additional domain names that you want OWA to treat as the same as the one you are using for this tracked website. For example, if the domain of your website is "www.mydomain.com" you could add an alias here for "mydomain.com". Aliases should be separated by comma.
URL Parameters under Site Settings This setting controls the URL parameters that OWA should ignore when processing requests. This is useful for avoiding duplicate URLs due to the use of tracking or others state parameters in your URLs. Parameter names should be separated by comma.
Rewrite Rules under Site Settings NOTE This setting may not be available with your installation as you may have to pull in a fork of Open Web Analytics. NOTE If this value is not present update the settings variable to the commented variable. This setting controls how to rewrite URLs. Rules should be separated by comma. Each rule looks like: (/view)(/[^/]+) -> $1
Default Page under Site Settings This is the page that your web server defaults to when there is no page specified in your URL (e.g. index.html). Use this setting to combine page views for www.domain.com and www.domain.com/index.html.
e-commerce Reporting under Site Settings Adds e-commerce metrics/statistics to reports. This value will be either 0 for disabled or 1 for enabled
This is a define for cli.php's install command
Important to note that your owa-config.php must already be setup with your database and URL settings
Simple Usage:
openwa::cli { 'setup':
cli_domain => 'https://www.somedomain.net/',
cli_email => '[email protected]',
}
Parameters within openwa::cli::install
:
This is the directory where openwa will be installed. Do not forget to include a trailing slash
This defines the files' owner
This defines the files' group
This is the path for php for your cli.php executions
This is the name of your cli.php if you change it
Required - This is the domain of the first web site that you want to track
Required - This is the email address of the admin user. This is used in password recovery
This is a define for cli.php's add-site command
This would be used to add an additional site to be tracked
Simple Usage:
openwa::cli::add_site { 'somedomain.net':
cli_domain => 'https://www.somedomain.net/'
}
Parameters within openwa::cli::add_site
:
This is the directory where openwa will be installed. Do not forget to include a trailing slash
This defines the files' owner
This defines the files' group
This is the path for php for your cli.php executions
This is the name of your cli.php if you change it
required - the domain of the web site that you want to track. Best practice is to include the protocol (e.g. https://www.somedomain.net/)
optional - the name that you want to see the site listed as in the site roster
optional - a short description of the site
optional - the name of the site family/group that this site should be included in