Installing The Squirrel Logger Plugin ===================================== 1) Start with untaring the file into the plugins directory. Here is a example for the 2.0 version of the squirrel_logger plugin. $ cd plugins $ tar -zxvf squirrel_logger-2.0-1.2.7.tar.gz 2) Decide if you want to store the plugin configuration file in the plugin directory or in the main SquirrelMail config directory. A) To store the configuration file in the plugin directory, change into the squirrel_logger directory, copy config_example.php to config.php and edit config.php, making adjustments as you deem necessary. $ cd squirrel_logger $ cp config_example.php config.php $ vi config.php B) To store the configuration file in the main SquirrelMail config directory, change into the squirrel_logger directory, copy config_example.php to ../../config/config_squirrel_logger.php and edit ../../config/config_squirrel_logger.php, making adjustments as you deem necessary. $ cd squirrel_logger $ cp config_example.php ../../config/config_squirrel_logger.php $ vi ../../config/config_squirrel_logger.php 3) If you will be using SQL logging, use the data schema provided in the README file to create your logging database table. Any changes you make to it should be coordinated with the SQL-related settings in config.php 4) Then go to your config directory and run conf.pl. Choose option 8 and move the plugin from the "Available Plugins" category to the "Installed Plugins" category. Save and exit. $ cd ../../../config/ $ ./conf.pl Upgrading The Squirrel Logger Plugin ==================================== 1) Start with untaring the file into the plugins directory. Here is a example for the 2.0 version of the squirrel_logger plugin. $ cd plugins $ tar -zxvf squirrel_logger-2.0-1.2.7.tar.gz 2) Change into the squirrel_logger directory and check your config.php file against the new version to see if there are any new settings that you must add to your config.php file. $ diff -u config.php config_example.php If you store your configuration file in the main SquirrelMail config directory, adjust this command as follows: $ diff -u ../../config/config_squirrel_logger.php config_example.php Or simply replace your config.php file with the provided example and reconfigure the plugin from scratch (see step 2 under the installation procedure above).