Tetra WebBBS Documentation

Viewcount Backup/Restore Tool *LINK*

This standalone tool allows to backup/restore viewcount databases.
This tool is supposed to be used with Tetra-WebBBS 5.3x series.
You may use this tool for prior versions - see notes at the bottom of this page.
Tetra-WebBBS 6.00 and later versions do not need this tool any more because the backup/restore feature is built-in by default. Of course it's possible to import backups created by this tool into version 6.00 installations.

Motivation

  • backup the viewcount's DBM database file to a simple ASCII flatfile
  • restore the viewcount's DBM database file from a simple ASCII flatfile
  • supposed to run via cron, browser, command line

Requirements

You must already have a working installation of the version 5.30 forum scripts.

Configure and install this tool

section (1) - required configuration:
Variables in this section MUST be defined in order to get this script to work properly.

$data_basedir
Set this variables to the same value used in the corresponding *_config.pl files of your forum.

$mode
Set this variable to either 'backup' or 'restore'.
If not set accordingly scripts will default to 'backup'.

section (3) - optional
Variables in this section are optional.

$data_subdir
Leave empty to backup ALL forum's viewcounts.
Define only if you want to backup a single forum's viewcounts.

use lib "/full/path/to/bbs53x/lib";
Define only if this script is NOT installed alongside the "/lib" folder.
It's pretty much the same as in any of the *_config.pl files

Upload and run the script
Upload the script to your server (ASCII mode), preferable alongside your admin-scripts!
Chmod the script 755.
Point your browser to this script or run from command line.

Notes:

You *may* use this script to backup viewcount DBM database files created by versions prior
to Tetra-WebBBS 5.30, but the setup is different and you may only backup ONE forum's
viewcount DBM database file at a time:

Using this tool with Tetra-WebBBS 5.2x you MUST define both $data_basedir and $data_subdir
the same as they are defined in each of your admin_config.pl files.

Using this tool with WebBBS 5.1x or older versions you MUST define $data_basedir the
same as $dir in the old admin_config.pl files and you MUST leave $data_subdir empty.