/[BackupPC]/trunk/doc/Search.pod

This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!

Diff of /trunk/doc/Search.pod

Parent Directory | Revision Log | View Patch Patch

-revision 96 by dpavlin,
Tue Aug 30 09:55:43 2005 UTC
+revision 255 by dpavlin,
Mon Dec 12 16:31:07 2005 UTC
 Line 16 
 see state of one or all of your shares i
  =item *
  archive selected backups (per host, share and increment) to archival
- medium (CD, DVD, tape etc.)
+ medium (CD, DVD, tape etc.) with rich descriptions, archival locations,
+ multiple copies and so on.
  =back
-Line 31 
 allready part of C<unstable> distributio
+Line 32 
 allready part of C<unstable> distributio
    # apt-get install postgresql
    # apt-get install hyperestraier libestraier-dev libqdbm-dev
- Now you can skip to installation of HyperEstraier perl bindings below.
+ Now you can skip to installation of L<HyperEstraier perl bindings> below.
  If you don't have pre-packaged binaries for your installation, you will
  need to install additional packages by hand.
- =over 4
+ =head3 PostgreSQL
- =item PostgreSQL installation
  You can use packages provided by your distribution or follow installation
  instructions on PostgreSQL site.
- =item QDBM installation
+ =head3 QDBM
  First, you need qdbm on which HyperEstraier depends. Installation is simple.
-Line 53 
 First, you need qdbm on which HyperEstra
+Line 52 
 First, you need qdbm on which HyperEstra
    $ make
    $ sudo make install
- =item HyperEstraier installation
+ =head3 HyperEstraier
  Also quite simple.
-Line 63 
 Also quite simple.
+Line 62 
 Also quite simple.
    $ make
    $ sudo make install
- Then you will have to install perl bindings for HyperEstraier. This might take
+ Then you will have to install perl bindings for HyperEstraier.
- a bit more work. You will need to have C<swig> installed beforehand.
+ =head3 HyperEstraier perl bindings
+ This might take a bit more work. You will need to have C<swig> and C<g++> installed
+ before you can install perl bindings.
    $ tar xvfz hyper_estraier_wrappers-0.0.10.tar.gz
    $ cd swig_hest/perl/
-Line 98 
 After succesfull C<perl Makefile.pl>, yo
+Line 101 
 After succesfull C<perl Makefile.pl>, yo
    $ make
    $ sudo make install
+ =head3 CPAN modules
+ You will also need a few additional cpan modules
+ =over 4
+ =item File::Pid
+ =item File::Which
+ =item File::Path
+ =item File::Slurp
+ =item Spreadsheet::WriteExcel
+ =item Term::Menus
+ =item XML::Writer
+ =item Algorithm::Diff
+ =item Archive::Tar::Stream
  =back
- =head1 Creation of initial data
+ Last module, C<Spreadsheet::WriteExcel> is needed only if you want to use
+ C<BackupPC_xls_report> to generate Excel reports from your backup data.
+ Easiest way to install them is using C<cpan> shell.
+   $ sudo cpan File::Pid Spreadsheet::WriteExcel
+ =head1 Creation of initial database
  Once you have all components installed, you should initially create data
  about increments in RDBMS and full-text search engine index.
-   $ sudo -u backuppc /data/backuppc/bin/BackupPC_updatedb
+ First, edit C<config.pl> and setup C<SearchDSN> to valid perl DSN (for example,
+ C<dbi:Pg:dbname=backuppc> and C<SearchUser> to database user which has priviledges
+ over that database. You might need to add additional directives in PostgreSQL's
+ C<pg_hba.conf> so that selected user can be connected without password (I know, it's not
+ perfect, but I trust local users on backuppc machine).
+ Then, create new database for backuppc.
+   $ createdb backuppc
+ Then invoke C<BackupPC_updatedb> for the first time with argument to create database
+ schema:
+   $ sudo -u backuppc /data/backuppc/bin/BackupPC_updatedb -c
- You can also force full-text reindex by C<-i> flag.
+ You can also force full-text reindex by C<-i> flag. This will add all files which are in
+ database but for some reason are missing in full-text index.
- B<Documentation is incomplete>.
+ Now, you can setup cron job which will daily check your backups and update database
+ and full-text index. This is as simple as invoking
+   /data/backuppc/bin/BackupPC_updatedb
+ As C<backuppc> user and redirecting output to log file.
+ B<Documentation is still incomplete>.
  Now that you finished installation, you can select new options from
  menu on the left and example search and archival.
+ =head1 Reporting in Excel
+ Often, it is useful to be able to present report about your BackupPC hosts, number
+ of snapshots, total size and other useful info. While all those information can
+ be accessed using web browser, for analysis it's useful to have them in spreadsheet
+ form. With this data, you can monitor changes on your backup cycle, effects of changes
+ on your server or network to your BackupPC installation and so on.
+ You can create Excel spreadsheet (which works perfectly with Gnumeric also) using
+ following command:
+   $ sudo -u backuppc /data/backuppc/bin/BackupPC_xls_report
+ =head1 Additional requirements
+ You will also need several other command-line utilities to make
+ C<BackupPC_burnArchiveCLI> run. Those include:
+ =over 4
+ =item mkisofs
+ =item cdrecord
+ Or equivavalent utility, on Debian you might want to use C<dvdrecord>.
+ =item eject
+ Please make a symlink from C</dev/cdrom> to you CD/DVD burner.
+ =item split
+ =back
+ =head1 Troubleshoting
+ =head2 md5sum problems on Debian
+ If you are running Debian stable and expiriencing error message like
+  -: No such file or directory
+ your C<md5sum> comes from C<coreutils> (which doesn't know how to handle C<->
+ as input) as opposed to C<md5sum> which comes with C<textutils> (which does).
+ Fix is simple, correct md5sum is allready installed, you just have to do:
+  sudo cp /usr/bin/md5sum.textutils /usr/bin/md5sum
  =head1 Related projects
  BackupPC allready has archival host which might suit your needs better (and

 Legend:



Removed from v.96
 


changed lines


 
Added in v.255
 Legend:



Removed from v.96
 


changed lines


 
Added in v.255
-Removed from v.96
+Added in v.255

	ViewVC Help
Powered by ViewVC 1.1.26