Installation

From Open Web Analytics Wiki

Jump to: navigation, search

Contents

Before you begin...

Stand Alone Installation

Pre-Install Steps

Before you start the installation there are a few server environment setups that you'll need to ensure are in place or completed.

File System Permissions

Ensure that OWA's files and directories have the proper file system permissions.

Setup Your Database Connection

As part of the OWA installation process, you will be asked for database connection information that will be used by OWA to create its tables and begin logging statistics. Prior to starting the install process you will want to either setup a new database for OWA to use (recommended) or choose an existing database. Either way OWA's installer requires a few pieces of database connection info:

As part of the installation OWA will write this information to a newly created owa-config.php configuration file - where it can be changed later if you need to modify the database that OWA read and writes from.

The OWA installer will create all the tables that it needs using the owa_ table prefix.

Installation Steps

  1. Download the latest OWA distribution or check it out of SVN.
  2. Place the 'owa' folder somewhere within the document root of your web server. The 'owa' folder must be accessible by web browsers.
  3. Start the installation wizard by pointing your web browser at: http://yourdomain/path/to/owa/install.php

WordPress Installation

To install OWA under a single instance of Wordpress, follow these steps:

  1. Download the latest OWA distribution or check it out of SVN.
  2. Move the entire 'owa' folder into the WordPress plugins folder which is located at /path/to/wordpress/wp-content/plugins. NOTE: the folder must be named 'owa' (without the quotes) to work.
  3. Login into your WordPress blog and activiate the plugin via the "Plugins" admin screen. This will create all of the required databse tables in the same datbase that wordpress is using. OWA tables will be created with the owa_ prefix by default.

That's it. OWA will immediately start tracking Wordpress generated web pages and feeds. In addition, you can then configure various OWA options in WordPress by visiting the OWA options page which should now appear under the main Options tab in the WordPress admin interface.

Track WordPress site using an existing OWA instance

In order to use the OWA WordPress plugin you must have a full separate OWA instance installed as a plugin under WordPress.

You can however have your OWA WordPress instance write to the same database as your other OWA instance so that statistics for your WordPress site are available through your existing instance of OWA. To do so, follow the same Wordpress instructions but create your owa-config.php file manually (using the same database login info as your existing OWA instance) before activating the WordPress plugin. This will ensure that data will be consolidated into the same database.

WordPress Theme Compatibility

In order for OWA's WordPress plugin to work, your WordPress theme needs have the following line of php somewhere above the </body> tag in its footer.php template:

<?php wp_footer(); ?>

Most WordPress themes are well formed and come with this Wordpress API call in the footer.php template already, so most people will not need to modify their theme to make OWA work. For more information on how to make sure that your themes work with WordPress plugins see: http://codex.wordpress.org/Theme_Development

Incompatible WordPress Plugins

MediaWiki Installation

NOTE: The OWA MediaWiki plugin will disable all of mediawiki's content caching features. This is needed to track mediawiki pages at this time.

  1. Download the latest OWA distribution or check it out of SVN.
  2. Move the entire OWA folder into MediaWiki's extensions folder.
  3. Add the following line of PHP to the bottom of MediaWiki's LocalSettings.php file:
    require_once('extensions/owa/mw_plugin.php');
  4. Navigate to MediaWiki's list of Special pages
  5. Click on the Open Web Analytics Special page
  6. Follow on-screen instructions to install OWA.

Gallery 2.2 Installation

Currently requires Gallery 2.2.4 or later.

  1. Download the latest OWA distribution or check it out of SVN.
  2. Move the entire OWA folder into Gallery's modules folder.
  3. Add the following code to the footer of whatever Gallery theme you are going to use:
    {g->callback type="owa.pagetags"} {$block.owa.pagetags.owaData}
  4. Login to Gallery as an administrator and navigate to the Site Admin -> Plugins page.
  5. Scroll down the list of plugins and click on the install link next to Open Web Analytics.

Re-installing OWA

A clean re-install of OWA requires the following:

Updating an existing OWA Instance

See the updating page for details on how to update your existing OWA instance.

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox