Web Logbook is just that - a logbook that runs over a web interface.

Some time ago while working in a network security group, we had a simple web logbook where all important actions were registred. I always though I could do more to make that logbook more functional and faster. As a result this little project started.

Main features include:

• Written in Perl (no additional modules required)
• Easy management of several logbooks
• Multi-language
• Subjects list
• Attachements
• Auto-detect attach and view online
• Archive
• Search
• Sort
• Multi-page navigation
• Print view
• User input validation
• Statistics/trends
• Display URIs with a link
• Import/export

Web logbook is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Some examples:

	Web-logbook This is here most of the action happens - add, edit and remove logbook entries. From here you can also manage attachments or access all available menu options. Other possibilities include: change logbook and change language.
	Archive / Browse archives Archiving can be used if the database gets too large or you just feel it is time to 'rotate' the logbook. Archived books can't be modified but you can still search, print or produce reports.
	Subject list
	Logbook Export
	Trends and Statistics

You can download the latest Web Logbook release here.

You can also browse previous releases here.

The installation process is made to be quick and painless. Perl is required but no other Perl modules should be necessary.

1. Extract the application onto your Web server's document root:

   $ gzip -d logbook-x.yz.tar.gz
$ tar xvf logbook-x.yz.tar

   By default the application extracts to './logbook' directory. You can still change this in the 'logbook.cfg' configuration file.

2. Modify the configuration:

   $ vi ./logbook/share/etc/logbook.cfg

3. Edit your web-server's configuration. On Apache would be something like:

   ScriptAlias /logbook/cgi-bin/ "/webserver/real/path/htdocs/logbook/cgi-bin/"
<Directory "/webserver/real/path/htdocs/logbook/cgi-bin">
  AllowOverride None
  Options None
  Order allow,deny
  Allow from all
</Directory>
# prevents access to the 'share' directory
<Directory "/webserver/real/path/htdocs/logbook/share">
  Deny from all
</Directory>


4. Grant write access for your web server's user on the following directories:

   $ chown nobody ./logbook/share/attach
$ chown nobody ./logbook/share/db


5. Reload/restart your webserver's configuration.
6. Using your browser go to: http://your.domain.here/logbook/cgi-bin/index.cgi

Before you start the upgrade, follow the steps below to backup your logbooks. Remember that by default the application extracts to the './logbook' directory.

1. Preserve your existing version:

   $ mv logbook logbook_old

2. Extract the new version onto your Web server's document root:

   $ gzip -d logbook-x.yz.tar.gz
$ tar xvf logbook-x.yz.tar

   By default the application extracts to './logbook' directory. If you have changed this in the 'logbook.cfg' configuration file, rename the directory now.

3. Restore all data from the old version:

   $ cp -f logbook_old/share/etc/logbook.cfg logbook/share/etc
$ cp logbook_old/share/db/* logbook/share/db
$ cp -R logbook_old/share/attach/* logbook/share/attach

4. Grant write access for your web server's user on the following directories:

   $ chown -R nobody ./logbook/share/attach
$ chown -R nobody ./logbook/share/db


5. Using your browser go to: http://your.domain.here/logbook/cgi-bin/index.cgi
6. If everything is working well, you can remove the backup done above:

   $ rm -rf logbook_old

7. PLEASE NOTE If you are upgrading to version 0.05 you should consider adding the following lines to the configuration file (in the 'Types' section):

   Types {
  ...

  wlb {
    Description "Web Logbook"
    Type        "application/octet-stream"
    Extension   wlb
  }

  csv {
    Description "Comma-Separated Values"
    Type        "text/csv"
    Extension   csv
  }
}

   These two new formats are now supported through Import/Export operations.

2008-01-23
  Version 0.05 released.
  + Added the IBM ISS Threat Index banner in logbook.cfg.
  - Fixed bug while doing a case sensitive search.
  - Fixed bug that prevented the And/Or criteria to work on the Print page.
  + Count characters left for the description field. Limit on maximum length.
  + Limit on maximum length for the subject field (with JS in addition to HTML).
  + Subject popup now sorted ascending when opened (instead of logbook order).
  + Alphabet anchor menu in subject popup.
  + Check required file name on attachment upload (with JS).
  - Search sintax is now regexp 'free' - special chars are escaped accordingly.
  * Search with regular exp. is still possible by adding the 'regexp' prefix.
  - Fixed bug that prevented 'us' date format from being correctly displayed.
  + New Export/Import options.
  + Added 'wlb' and 'csv' formats to logbook.cfg types list.
  - Browse Archive showed redundant Search and Trends menus when book was empty.
  - Fixed broken sort when switching between index.cgi and attview.cgi pages.
  * Many other code optimizations.

Full ChangeLog file.

All contributions are welcome! Please, report any problems and questions to weblogbook(at)morgado(dot)ch.

If you find any bug, have any suggestions or write a patch, you can either use Sourceforge's project Tracker or, please write an email to weblogbook(at)morgado(dot)ch.

(Non-spammers: please remove the underscores from the email address)