FreeBSD, Manual Installation

3.1 PeerCache main product

Log in as peercache and copy included tar file to ~/. Unpack it with command:

$ tar xvfz peercache_<revision>_FreeBSD.tgz

Copy license file (not included in this bundle) to ~peercache/license/license

(Optional) Alter settings in PeerCache.ini:

• As minimum, you should set cache size and directory to desired value. Locate setting “DiskCacheMegabytes”,and change the value after equal sign to correspond to the disk spaceavailable for cache storage (in Mbytes).
• Note: If you change log file locations or names (values ErrorLog and AccessLog in configuration file), you must also change set-up of subsequent statistics and monitoring tools, which use the log files. It is therefore recommended to create symbolic link to original location for log files to make set-up easier.

Start PeerCache

$ ./peercache 

Verify that PeerCache is up and running

$ tail logs/cache.log

You should see a line like “2002/11/12 09:31:34 CORE 1 Starting serving requests”

After a while, verify that the cache is being used and is working efficiently, by checking entries in access.log file. The normal FastTrack requests should show up like:

1036752786.000 1000 1.1.1.1 TCP_MISS/0000 GET http://192.168.100.122:1214/.hash=- DIRECT/192.168.100.122 –

If there are no requests displayed in access.log, then verify that the cache is running and accessible at port 1214.

If there are only requests for .p2pinfo, but no actual requests, verify the validity and existence of license file.

Add crontab entry under peercache user for daily log rotation:

0 0 * * * peercache /home/peercache -k rotate > /dev/null 2>&1

Additional notes:

It is possible to run PeerCache without creating user ‘peercache’. However, as most paths default to “/home/peercache”, all path settings in the configuration file should be changed accordingly. Also, the path to the configuration file for peercache should be indicated in command line, for example:

$ peercache -f /etc/peercache/PeerCache.ini 

Most of the settings have an explanation in the form of comments in the configuration file. Some of the settings are already predefined at the optimal setting for peercache operation, so exercise caution when changing these settings and ask for support if you are unsure.

3.2 Statistics and monitoring package

Unpack tar file

$ tar xzf PeerCache_<revision>_Stats_FreeBSD.tgz
$ cd peercache-stats_<revision>

Create a secure web area:

Copy sample index.html and .htaccess from peercache-stats_ to /home/peercache/htdocs:

$ cp htdocs/index.html /home/peercache/htdocs
$ cp htdocs/.htaccess /home/peercache/htdocs

Create user authentication file:

$ htpasswd -c /home/peercache/auth.users peercache

Install cacti (see also http://www.raxnet.net/products/cacti/docs/INSTALL.htm)Unpack cacti tar file which can be found in the peercache statistics tools under the directory “packages”..

$ cd packages
$ tar xzf cacti-0.6.8a.tar.gz
$ mv cacti-0.6.8a /home/peercache/htdocs/cacti
$ rm cacti-0.6.8a.tar.gz
$ chown -R peercache.www /home/peercache/htdocs/cacti
$ cd ../cacti
$ mysqladmin -u root -p< sqlrootpassword> create peercachecacti
$ mysql -u root -p< sqlrootpassword> peercachecacti <cacti.sql
$ mysql -u root -p< sqlrootpassword> mysql 

mysql> GRANT ALL ON peercachecacti.* TO peercache@localhost IDENTIFIED BY '< cactipassword>';
mysql> flush privileges;
mysql> quit

$ vi /home/peercache/htdocs/cacti/include/config.php

change lines in config.php:

$database_default= "peercachecacti";
$database_username="peercache";
$database_password="<cactipassword>";

Complete the installation by running:

  http://<server ip></server>/cacti

Default login & password: “admin/admin”

Click “Cacti settings” on Configuration section:(specify correct paths during setup, i.e. rrdtool will probably be in/usr/local/bin/rrdtool, php in /usr/local/bin/php, snmpwalk and snmpgetbinaries are not needed)

On Utilities section under “User Administration” you can change password of admin and create more users if needed.

Custom statistics tools:

                  
$ cd peercache-stats_<revision>

Custom statistics scripts:

$ mv stats   /home/peercache/stats
$ cd /home/peercache/stats
$ ./create.sh

Copy “stats/*.conf.dist” files to “stats/*.conf”, unless you are upgrading, in which case use diff command to determine differences in configuration files and what needs to be installed.You must specify the interface which traffic to measure in stats/lognetstat.sh script.

PeerCache cacti installation:

$ mv peercache-stats_<revision>/cacti/*.pl
/home/peercache/htdocs/cacti/scripts