MetaTraffic Lite 2.23

Metasun Software


Table Of Contents

  1. Overview
  2. Quick Start
  3. Requirements
  4. Upgrading From a Previous Version
  5. Installation
  6. Security Considerations
  7. Known Limitations
  8. Support
  9. Version History
  10. Licensing

Overview

MetaTraffic is a web site statistics application developed in pure ASP. It now supports the following features:

See Metasun's web site for full details.

[top]


Quick Start

Follow these instructions for a quick installation:

  1. Extract the contents of the zip file ensuring that the folder structure remains intact. (This option is called "Use Folder Names" in WinZip.)
  2. Upload the metatraffic2 folder to the root folder on your web site.
  3. Using your web browser, load the /metatraffic2/setup.asp page on your web site. (For example, type in http://www.yourdomain.com/metatraffic2/setup.asp)
  4. Complete the setup and install MetaTraffic.
  5. Once you have completed the setup, delete the setup.asp file from your web site and then use the link provided on the completed setup page to log in to MetaTraffic.
  6. Once you have logged in, proceed to the Setup section and update your Configuration settings.
  7. You will need to add tracking code to each web page that you want to track. Go to the Tracking section to copy and paste code into your web pages.

See the installation instructions below for more information.

[top]


Requirements

Mandatory Server Requirements

MS ACCESS

SQL SERVER

MySQL

Optional Server Requirements

Client Requirements

[top]


Upgrading from a Previous Version

Please read the entire instructions before proceeding. Always make sure you backup your database and installation files before upgrading.

Upgrading From Version 2.22

Update the following files on your MetaTraffic installation with those included in this zip file:

Log into MetaTraffic and Proceed to Settings > Maintenance. Select the Update Definitions and press the Perform Maintenance button; you do not need to specify a file as it will use the definitions.txt file you uploaded. Repeat this with the Update Countries option. Updating your country data can take a few minutes.

Upgrading From Version 2.21

Update the following files on your MetaTraffic installation with those included in this zip file:

Log into MetaTraffic and Proceed to Settings > Maintenance. Select the Update Definitions and press the Perform Maintenance button; you do not need to specify a file as it will use the definitions.txt file you uploaded. Repeat this with the Update Countries option. Updating your country data can take a few minutes.

If you are running MySQL as your database server, run the following query on the database that contains MetaTraffic data:

ALTER TABLE mt_pagelog MODIFY COLUMN pl_s_id int(11) NOT NULL default '0';

Note: If your Table Prefix is not mt_, you will need to change it to the correct table prefix.

Upgrading From Version 2.20

Login to MetaTraffic and disable logging by going to Settings > Configuration and setting the Enable Log configuration option to No. Update the following files on your MetaTraffic installation with those included in this zip file:

Once you have updated the above files, log into MetaTraffic. Proceed to Settings > Maintenance. Select the Update Definitions and press the Perform Maintenance button; you do not need to specify a file as it will use the definitions.txt file you uploaded. Repeat this with the Update Countries option. Updating your country data can take a few minutes. You can now re-enable logging by setting the Enable Log configuration option to Yes.

If you are running MySQL as your database server, you need to run the following query on the database that contains MetaTraffic data:

ALTER TABLE mt_pagelog MODIFY COLUMN pl_s_id int(11) NOT NULL default '0';

Note: If your Table Prefix is not mt_, you will need to change it to the correct table prefix.

Upgrading From Version 2.11, 2.12

Login to MetaTraffic and disable logging by going to Settings > Configuration and setting the Enable Log configuration option to No. Update the following files on your MetaTraffic installation with those included in this zip file:

Once you have updated the above files, log into MetaTraffic. Proceed to Settings > Maintenance. Select the Update Definitions and press the Perform Maintenance button; you do not need to specify a file as it will use the definitions.txt file you uploaded. Repeat this with the Update Countries option. Updating your country data can take a few minutes. You can now re-enable logging by setting the Enable Log configuration option to Yes.

If you are running MySQL as your database server, you need to run the following query on the database that contains MetaTraffic data:

ALTER TABLE mt_pagelog MODIFY COLUMN pl_s_id int(11) NOT NULL default '0';

Note: If your Table Prefix is not mt_, you will need to change it to the correct table prefix.

Upgrading From Version 2.10

Follow the instructions in "Upgrading From Version 2.11, 2.12" above and then use the instructions below to finish the process.

If you use the JavaScript tracking methods, copy and paste the new JavaScript tracking code from the Tracking > Web Pages section into the appropriate pages on your web site.

Upgrading From Version 2.0, 2.01, 2.02, 2.03

Follow the instructions in "Upgrading From Version 2.11, 2.12" above and then use the instructions below to finish the process.

In order to support page titles in your reports, proceed to the Tracking section of MetaTraffic and copy / paste the new tracking code into your web pages.

If you are running SQL Server and are upgrading from version 2.0 - 2.03, you need to add a column to the mt_PageNames table. Run the Query Analyzer, set the database to where MetaTraffic is installed and run the following SQL:

ALTER TABLE [dbo].[mt_PageNames] ADD [pn_label] [VARCHAR] (100) NULL

Note: If your Table Prefix is not mt_, you will need to do a Find and Replace to make sure the SQL contains the correct Table Prefix.

If you are running SQL Server and are upgrading from version 2.01 or 2.0, you should also add some indexes on your database. Run the Query Analyzer, set the database to where MetaTraffic is installed and run the following SQL:

CREATE UNIQUE INDEX ix_mt_PageNames ON mt_PageNames(pn_id)
CREATE UNIQUE INDEX ix_mt_Referrers ON mt_Referrers(r_id)
CREATE UNIQUE INDEX ix_mt_ReferrerNames ON mt_ReferrerNames(rn_id)
CREATE UNIQUE INDEX ix_mt_Keywords ON mt_Keywords(k_id)
CREATE UNIQUE INDEX ix_mt_Names ON mt_Names(n_id)

Note: If your Table Prefix is not mt_, you will need to do a Find and Replace to make sure the SQL contains the correct Table Prefix.

Upgrading From Version 1.2, 1.3x

MetaTraffic has a setup program that will upgrade the data for MetaTraffic 1.2 or 1.3x. Upgrading for versions prior to 1.2 is not supported.

Follow the standard installation instructions below ensuring that you install MetaTraffic into a different folder than your previous MetaTraffic installation. When running the setup, make sure you select the "Upgrade (From MetaTraffic 1.2 or 1.3x)" option as your installation type. Once you are done, verify it is installed and working correctly by logging into MetaTraffic.

You must update your tracking code on all your web pages. Important changes were made and javascript includes are no longer supported.

Go to the Tracking section to get the updated tracking code to insert into your web pages. Copy and paste the appropriate tracking code into each web page you wish to track. Make sure you remove any old MetaTraffic tracking code from your web pages from prior versions.

You will also need to change any links that are using the redirect tracking method for tracking downloads or multimedia files. This has been changed from previous versions to use the syntax "mtr=/yourfile.zip" instead of "r=/yourfile.zip". Please see the Tracking section for full details.

Note: Upgrading data from previous versions 1.2 and 1.3x can be a time consuming procedure, especially for high traffic sites. Ensure that you only upgrade the data that you need. If you are using SQL Server as your database, you may want to consider using the included SQL scripts to upgrade your data. See the SQL Scripts section below for more information.

[top]


Installation

MetaTraffic now has a setup program that will test, setup and configure MetaTraffic. This includes setting up the necessary tables on MS SQL Server or MySQL installations. If you are upgrading from a previous version, it will also upgrade the data to the new data format.

  1. Extract the contents of the zip file ensuring that the folder structure remains intact. Retaining folder structure is called "Use Folder Names" in WinZip, it may be different in other applications.


  2. Upload the metatraffic2 folder to the root folder on your web site.


  3. Ensure that the IUSR_machine Windows account has read / write permissions on the MetaTraffic install folder. If you are not using MS Access or moving the MS Access database to a location other that the MetaTraffic installation folder (recommended), you can have read permissions on the folder and write permissions only on the config.asp and conn.asp files.


  4. Using your web browser, load the /metatraffic2/setup.asp page on your web site. For example, type in http://www.yourdomain.com/metatraffic2/setup.asp in your web browser.


  5. Follow the setup program instructions; use the help provided there for details on specific setup options.


  6. Once you have completed the setup, delete the setup.asp file from your web site and use the link provided to log in to MetaTraffic.


  7. Once you have logged in, update your settings as needed. Again, use the help provided for specific information on the configuration options.


  8. You will need to add tracking code to each page that you want to track. Go to the tracking section to copy the code that you can paste directly into page on your web site.


You can test your installation by loading the track.asp file in your web browser. If you load this page in your web page and check the reports, you should see the activity if MetaTraffic is working correctly.


Security Considerations

Once you have completed the setup procedure, ensure that you delete the setup.asp file from your MetaTraffic installation folder on your web site.

If you are using MS Access as your database, it is not a good idea to have it in a publicly accessible folder such as in your web site content directory. It is recommended that you move it to a folder on your server that is not accessible via your web site. However, the Internet Guest account (IUSR_MACHINE) of your web server must have read and write permissions on the database file.

For security reasons, if you are using MS Access with the default database file name and location, file upload for definition and country updates in the Settings > Maintenance section is disabled.

[top]


Known Limitations

When you track pages using the javascript method, there will be no robot data collected. This is because the robots will not execute the javascript and never log anything to the database.

When you track pages using the ASP method, Screen Area data is not collected. Javascript tracking is required to capture client resolution information.

[top]


Support

If you require support, please visit our support site.

[top]


Version History

v2.23 - July 24th, 2006

v2.22 - June 6th, 2006

v2.21 - Feb 16th, 2006

v2.20 - Oct 26th, 2005

v2.12 - Sept 23rd, 2005

v2.11 - May 12th, 2005

v2.10 - Jan 24th, 2005

v2.03 - Nov 1st, 2004

v2.02 - Oct 4th, 2004

v2.01 - Sept 19th, 2004

v2.0 Official Release - Sept 10th, 2004

Beta 2-7 changes have been removed

v2.0 (BETA)- April 26th, 2004

Version history prior to version 2 has been removed. MetaTraffic was first released with version 0.8 on Oct 2nd, 2002. Many releases, feature additions and bug fixes later, version 2.0 beta was released!

[top]


Licensing

MetaTraffic is not freeware. Please make sure you read our license agreement in detail included in the zip file (license.txt). You can also check out a summary of this agreement on Metasun's website.

[top]