Rebuilds and Resets

Introduction

It may be tricky to understand the difference between a rebuild, reset, and a total reset, so we have dedicated this document to explaining the differences. Briefly, a rebuild is when your ranking pages are updated with the current stats, a reset is when the in and out hit counts are set back to zero, and a total reset is when the total in and total out hit counts are set back to zero. We will cover each in more detail below.

Rebuilds

A rebuild is when all of your ranking pages are updated with the current information in the database and will also cause any changes you have made to your templates to take affect. The hit counts for each member will be tallied and all of your members will be re-sorted using the method you have selected. Once the members have been re-sorted the ranking pages will be recreated using this new information; if any changes have been made to the ranking page templates since the last rebuild these changes will also take affect. During a rebuild none of the hit counts are changed; a rebuild is used strictly to update your ranking pages with the current statistics and the current template.

Rebuilds can be done manually through the control panel interface, handled by the in.cgi hit tracking script, or done automatically at the exact times you specify through cron. To rebuild your pages manually through the control panel simply click on the 'Rebuild Ranking Pages' link in the 'Ranking Pages' section of the menu. Your ranking pages will be instantly rebuilt using the current stats and latest ranking page templates.

If you do not have cron on your server, you will need to rely on the in.cgi script to handle automatic rebuids. While this is less accurate than cron and will not allow you to specify the exact times that the rebuilds occur, it is a good alternative when cron is not available. Each time the surfer comes to your site through the in.cgi script it will check to see if it needs to rebuild your ranking pages. It can figure this out from the 'Rebuild Interval' value you setup in the Edit Options interface. If it has been at least as long, or longer, than the Rebuild Interval since the last rebuild the in.cgi script will rebuild your pages automatically. Obviously, since this only works when someone comes to your site through the in.cgi script, this limits the accuracy of each rebuild. For example, if no one comes to your site through the in.cgi script for two hours, your pages will not be rebuilt even if your rebuild interval is less that two hours.

If you do have cron on your server we highly recommend that you use it for rebuilds and resets. It will allow you to exactly specify when you want rebuilds and resets to occur and will always be on time.

Resets

A reset is when all of your member's in and out hit counts get reset back to zero and adds an entry into each member's stats file so they can view historical stats when they login to their account. A reset does not update your ranking page, it only resets the member hit counts and generates historical statistics. You can do a manual reset through the software control panel by clicking on the 'Reset Hits In/Out' link in the control panel menu.

The same things apply when it comes to automatic resets that apply to automatic rebuilds. If you are relying on the in.cgi script for resets you will need a steady stream of traffic coming into your site through that script in order to see rebuilds and resets occuring at regular intervals. If you do not have a steady stream of traffic coming in through the in.cgi script you may need to manually rebuild and reset through the control panel.

Total Resets

A total reset is when all of your member's total in and total out hit counts get reset back to zero. This also affects each member's average hit counts (in per day, in per week, out per day, etc) because those values are based on the total in and total out hit counts. The averages will reset just like the total hit counts when you do a total reset. As with a normal reset, this will not update your ranking page, it only resets the hit counts. Total resets must be done manually through the control panel by clicking on the 'Reset Total Hits In/Out' link.