/[BackupPC]/trunk/doc/Search.pm
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /trunk/doc/Search.pm

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 96 by dpavlin, Tue Aug 30 09:55:43 2005 UTC revision 198 by dpavlin, Thu Oct 13 19:03:32 2005 UTC
# Line 16  see state of one or all of your shares i Line 16  see state of one or all of your shares i
16  =item *  =item *
17    
18  archive selected backups (per host, share and increment) to archival  archive selected backups (per host, share and increment) to archival
19  medium (CD, DVD, tape etc.)  medium (CD, DVD, tape etc.) with rich descriptions, archival locations,
20    multiple copies and so on.
21    
22  =back  =back
23    
# Line 31  allready part of C<unstable> distributio Line 32  allready part of C<unstable> distributio
32    # apt-get install postgresql    # apt-get install postgresql
33    # apt-get install hyperestraier libestraier-dev libqdbm-dev    # apt-get install hyperestraier libestraier-dev libqdbm-dev
34    
35  Now you can skip to installation of HyperEstraier perl bindings below.  Now you can skip to installation of L<HyperEstraier perl bindings> below.
36    
37  If you don't have pre-packaged binaries for your installation, you will  If you don't have pre-packaged binaries for your installation, you will
38  need to install additional packages by hand.  need to install additional packages by hand.
39    
40  =over 4  =head3 PostgreSQL
   
 =item PostgreSQL installation  
41    
42  You can use packages provided by your distribution or follow installation  You can use packages provided by your distribution or follow installation
43  instructions on PostgreSQL site.  instructions on PostgreSQL site.
44    
45  =item QDBM installation  =head3 QDBM
46    
47  First, you need qdbm on which HyperEstraier depends. Installation is simple.  First, you need qdbm on which HyperEstraier depends. Installation is simple.
48    
# Line 53  First, you need qdbm on which HyperEstra Line 52  First, you need qdbm on which HyperEstra
52    $ make    $ make
53    $ sudo make install    $ sudo make install
54    
55  =item HyperEstraier installation  =head3 HyperEstraier
56    
57  Also quite simple.  Also quite simple.
58    
# Line 63  Also quite simple. Line 62  Also quite simple.
62    $ make    $ make
63    $ sudo make install    $ sudo make install
64    
65  Then you will have to install perl bindings for HyperEstraier. This might take  Then you will have to install perl bindings for HyperEstraier.
66  a bit more work. You will need to have C<swig> installed beforehand.  
67    =head3 HyperEstraier perl bindings
68    
69    This might take a bit more work. You will need to have C<swig> and C<g++> installed
70    before you can install perl bindings.
71    
72    $ tar xvfz hyper_estraier_wrappers-0.0.10.tar.gz    $ tar xvfz hyper_estraier_wrappers-0.0.10.tar.gz
73    $ cd swig_hest/perl/    $ cd swig_hest/perl/
# Line 98  After succesfull C<perl Makefile.pl>, yo Line 101  After succesfull C<perl Makefile.pl>, yo
101    $ make    $ make
102    $ sudo make install    $ sudo make install
103    
104    =head3 CPAN modules
105    
106    You will also need a few additional cpan modules
107    
108    =over 4
109    
110    =item File::Pid
111    
112    =item Spreadsheet::WriteExcel
113    
114    =item Term::Menus
115    =item XML::Writer
116    
117  =back  =back
118    
119  =head1 Creation of initial data  Last module, C<Spreadsheet::WriteExcel> is needed only if you want to use
120    C<BackupPC_xls_report> to generate Excel reports from your backup data.
121    
122    Easiest way to install them is using C<cpan> shell.
123    
124      $ sudo cpan File::Pid Spreadsheet::WriteExcel
125    
126    =head1 Creation of initial database
127    
128  Once you have all components installed, you should initially create data  Once you have all components installed, you should initially create data
129  about increments in RDBMS and full-text search engine index.  about increments in RDBMS and full-text search engine index.
130    
131    $ sudo -u backuppc /data/backuppc/bin/BackupPC_updatedb  First, edit C<config.pl> and setup C<SearchDSN> to valid perl DSN (for example,
132    C<dbi:Pg:dbname=backuppc> and C<SearchUser> to database user which has priviledges
133    over that database. You might need to add additional directives in PostgreSQL's
134    C<pg_hba.conf> so that selected user can be connected without password (I know, it's not
135    perfect, but I trust local users on backuppc machine).
136    
137    Then, create new database for backuppc.
138    
139      $ createdb backuppc
140    
141    Then invoke C<BackupPC_updatedb> for the first time with argument to create database
142    schema:
143    
144  You can also force full-text reindex by C<-i> flag.    $ sudo -u backuppc /data/backuppc/bin/BackupPC_updatedb -c
145    
146  B<Documentation is incomplete>.  You can also force full-text reindex by C<-i> flag. This will add all files which are in
147    database but for some reason are missing in full-text index.
148    
149    Now, you can setup cron job which will daily check your backups and update database
150    and full-text index. This is as simple as invoking
151    
152      /data/backuppc/bin/BackupPC_updatedb
153    
154    As C<backuppc> user and redirecting output to log file.
155    
156    B<Documentation is still incomplete>.
157    
158  Now that you finished installation, you can select new options from  Now that you finished installation, you can select new options from
159  menu on the left and example search and archival.  menu on the left and example search and archival.
160    
161    =head1 Reporting in Excel
162    
163    Often, it is useful to be able to present report about your BackupPC hosts, number
164    of snapshots, total size and other useful info. While all those information can
165    be accessed using web browser, for analysis it's useful to have them in spreadsheet
166    form. With this data, you can monitor changes on your backup cycle, effects of changes
167    on your server or network to your BackupPC installation and so on.
168    
169    You can create Excel spreadsheet (which works perfectly with Gnumeric also) using
170    following command:
171    
172      $ sudo -u backuppc /data/backuppc/bin/BackupPC_xls_report
173    
174    =head1 Additional requirements
175    
176    You will also need several other command-line utilities to make
177    C<BackupPC_burnArchiveCLI> run. Those include:
178    
179    =over 4
180    
181    =item mkisofs
182    
183    =back
184    
185    
186  =head1 Related projects  =head1 Related projects
187    
188  BackupPC allready has archival host which might suit your needs better (and  BackupPC allready has archival host which might suit your needs better (and
Legend:
Removed from v.96  
changed lines
  Added in v.198
  ViewVC Help
Powered by ViewVC 1.1.26