r1020@llin: dpavlin | 2006-09-26 14:40:34 +0200
[webpac2] / run.pl
1 #!/usr/bin/perl -w
2
3 use strict;
4
5 use Cwd qw/abs_path/;
6 use File::Temp qw/tempdir/;
7 use lib './lib';
8
9 use WebPAC::Common 0.02;
10 use WebPAC::Parser 0.04;
11 use WebPAC::Input 0.13;
12 use WebPAC::Store 0.11;
13 use WebPAC::Normalize 0.11;
14 use WebPAC::Output::TT;
15 use WebPAC::Validate 0.06;
16 use WebPAC::Output::MARC;
17 use WebPAC::Config;
18 use Getopt::Long;
19 use File::Path;
20 use Time::HiRes qw/time/;
21 use File::Slurp;
22 use Data::Dump qw/dump/;
23 use Storable qw/dclone/;
24
25 use Proc::Queue size => 1;
26 use POSIX ":sys_wait_h"; # imports WNOHANG
27
28 =head1 NAME
29
30 run.pl - start WebPAC indexing
31
32 B<this command will probably go away. Don't get used to it!>
33
34 Options:
35
36 =over 4
37
38 =item --offset 42
39
40 start loading (all) databases at offset 42
41
42 =item --limit 100
43
44 limit loading to 100 records
45
46 =item --clean
47
48 remove database and Hyper Estraier index before indexing
49
50 =item --only=database_name/input_filter
51
52 reindex just single database (legacy name is --one)
53
54 C</input_filter> is optional part which can be C<name>
55 or C<type> from input
56
57 =item --config conf/config.yml
58
59 path to YAML configuration file
60
61 =item --stats
62
63 disable indexing, modify_* in configuration and dump statistics about field
64 and subfield usage for each input
65
66 =item --validate path/to/validation_file
67
68 turn on extra validation of imput records, see L<WebPAC::Validation>
69
70 =item --marc-normalize conf/normalize/mapping.pl
71
72 This option specifies normalisation file for MARC creation
73
74 =item --marc-output out/marc/test.marc
75
76 Optional path to output file
77
78 =item --marc-lint
79
80 By default turned on if C<--marc-normalize> is used. You can disable lint
81 messages with C<--no-marc-lint>.
82
83 =item --marc-dump
84
85 Force dump or input and marc record for debugging.
86
87 =item --parallel 4
88
89 Run databases in parallel (aproximatly same as number of processors in
90 machine if you want to use full load)
91
92 =item --only-links
93
94 Create just links
95
96 =item --merge
97
98 Create merged index of databases which have links
99
100 =back
101
102 =cut
103
104 my $offset;
105 my $limit;
106
107 my $clean = 0;
108 my $config_path;
109 my $debug = 0;
110 my $only_filter;
111 my $stats = 0;
112 my $validate_path;
113 my ($marc_normalize, $marc_output);
114 my $marc_lint = 1;
115 my $marc_dump = 0;
116 my $parallel = 0;
117 my $only_links = 0;
118 my $merge = 0;
119
120 my $log = _new WebPAC::Common()->_get_logger();
121
122 GetOptions(
123         "limit=i" => \$limit,
124         "offset=i" => \$offset,
125         "clean" => \$clean,
126         "one=s" => \$only_filter,
127         "only=s" => \$only_filter,
128         "config" => \$config_path,
129         "debug+" => \$debug,
130         "stats" => \$stats,
131         "validate=s" => \$validate_path,
132         "marc-normalize=s" => \$marc_normalize,
133         "marc-output=s" => \$marc_output,
134         "marc-lint!" => \$marc_lint,
135         "marc-dump!" => \$marc_dump,
136         "parallel=i" => \$parallel,
137         "only-links!" => \$only_links,
138         "merge" => \$merge,
139 );
140
141 my $config = new WebPAC::Config( path => $config_path );
142
143 #print "config = ",dump($config) if ($debug);
144
145 die "no databases in config file!\n" unless ($config->databases);
146
147 $log->info( "-" x 79 );
148
149
150 my $estcmd_fh;
151 my $estcmd_path = './estcmd-merge.sh';
152 if ($merge) {
153         open($estcmd_fh, '>', $estcmd_path) || $log->logdie("can't open $estcmd_path: $!");
154         print $estcmd_fh 'cd /data/estraier/_node/ || exit 1',$/;
155         print $estcmd_fh 'sudo /etc/init.d/hyperestraier stop',$/;
156         $log->info("created merge batch file $estcmd_path");
157 }
158
159
160 my $validate;
161 $validate = new WebPAC::Validate(
162         path => $validate_path,
163 ) if ($validate_path);
164
165
166 my $use_indexer = $config->use_indexer;
167 if ($stats) {
168         $log->debug("option --stats disables update of indexing engine...");
169         $use_indexer = undef;
170 } else {
171         $log->info("using $use_indexer indexing engine...");
172 }
173
174 # disable indexing when creating marc
175 $use_indexer = undef if ($marc_normalize);
176
177 # parse normalize files and create source files for lookup and normalization
178
179 my $parser = new WebPAC::Parser( config => $config );
180
181 my $total_rows = 0;
182 my $start_t = time();
183
184 my @links;
185
186 if ($parallel) {
187         $log->info("Using $parallel processes for speedup");
188         Proc::Queue::size($parallel);
189 }
190
191 sub create_ds_config {
192         my ($db_config, $database, $input, $mfn) = @_;
193         my $c = dclone( $db_config );
194         $c->{_} = $database || $log->logconfess("need database");
195         $c->{_mfn} = $mfn || $log->logconfess("need mfn");
196         $c->{input} = $input || $log->logconfess("need input");
197         return $c;
198 }
199
200 while (my ($database, $db_config) = each %{ $config->databases }) {
201
202         my ($only_database,$only_input) = split(m#/#, $only_filter) if ($only_filter);
203         next if ($only_database && $database !~ m/$only_database/i);
204
205         if ($parallel) {
206                 my $f=fork;
207                 if(defined ($f) and $f==0) {
208                         $log->info("Created processes $$ for speedup");
209                 } else {
210                         next;
211                 }
212         }
213
214         my $indexer;
215         if ($use_indexer) {
216
217                 my $cfg_name = $use_indexer;
218                 $cfg_name =~ s/\-.*$//;
219
220                 my $indexer_config = $config->get( $cfg_name ) || $log->logdie("can't find '$cfg_name' part in confguration");
221                 $indexer_config->{database} = $database;
222                 $indexer_config->{clean} = $clean;
223                 $indexer_config->{label} = $db_config->{name};
224
225                 # force clean if database has links
226                 $indexer_config->{clean} = 1 if ($db_config->{links});
227
228                 if ($use_indexer eq 'hyperestraier') {
229
230                         # open Hyper Estraier database
231                         use WebPAC::Output::Estraier '0.10';
232                         $indexer = new WebPAC::Output::Estraier( %{ $indexer_config } );
233                 
234                 } elsif ($use_indexer eq 'hyperestraier-native') {
235
236                         # open Hyper Estraier database
237                         use WebPAC::Output::EstraierNative;
238                         $indexer = new WebPAC::Output::EstraierNative( %{ $indexer_config } );
239
240                 } elsif ($use_indexer eq 'kinosearch') {
241
242                         # open KinoSearch
243                         use WebPAC::Output::KinoSearch;
244                         $indexer_config->{clean} = 1 unless (-e $indexer_config->{index_path});
245                         $indexer = new WebPAC::Output::KinoSearch( %{ $indexer_config } );
246
247                 } else {
248                         $log->logdie("unknown use_indexer: $use_indexer");
249                 }
250
251                 $log->logide("can't continue without valid indexer") unless ($indexer);
252         }
253
254
255         #
256         # store Hyper Estraier links to other databases
257         #
258         if (ref($db_config->{links}) eq 'ARRAY' && $use_indexer) {
259                 foreach my $link (@{ $db_config->{links} }) {
260                         if ($use_indexer eq 'hyperestraier') {
261                                 if ($merge) {
262                                         print $estcmd_fh 'sudo -u www-data estcmd merge ' . $database . ' ' . $link->{to},$/;
263                                 } else {
264                                         $log->info("saving link $database -> $link->{to} [$link->{credit}]");
265                                         push @links, sub {
266                                                 $log->info("adding link $database -> $link->{to} [$link->{credit}]");
267                                                 $indexer->add_link(
268                                                         from => $database,
269                                                         to => $link->{to},
270                                                         credit => $link->{credit},
271                                                 );
272                                         };
273                                 }
274                         } else {
275                                 $log->warn("NOT IMPLEMENTED WITH $use_indexer: adding link $database -> $link->{to} [$link->{credit}]");
276                         }
277                 }
278         }
279         next if ($only_links);
280
281
282         #
283         # now WebPAC::Store
284         #
285         my $abs_path = abs_path($0);
286         $abs_path =~ s#/[^/]*$#/#;
287
288         my $db_path = $config->webpac('db_path');
289
290         if ($clean) {
291                 $log->info("creating new database '$database' in $db_path");
292                 rmtree( $db_path ) || $log->warn("can't remove $db_path: $!");
293         } else {
294                 $log->info("working on database '$database' in $db_path");
295         }
296
297         my $store = new WebPAC::Store(
298                 path => $db_path,
299                 debug => $debug,
300         );
301
302
303         #
304         # now, iterate through input formats
305         #
306
307         my @inputs;
308         if (ref($db_config->{input}) eq 'ARRAY') {
309                 @inputs = @{ $db_config->{input} };
310         } elsif ($db_config->{input}) {
311                 push @inputs, $db_config->{input};
312         } else {
313                 $log->info("database $database doesn't have inputs defined");
314         }
315
316         foreach my $input (@inputs) {
317
318                 my $input_name = $input->{name} || $log->logdie("input without a name isn't valid: ",dump($input));
319
320                 next if ($only_input && ($input_name !~ m#$only_input#i && $input->{type} !~ m#$only_input#i));
321
322                 my $type = lc($input->{type});
323
324                 die "I know only how to handle input types ", join(",", $config->webpac('inputs') ), " not '$type'!\n" unless (grep(/$type/, $config->webpac('inputs')));
325
326                 my $input_module = $config->webpac('inputs')->{$type};
327
328                 my @lookups = $parser->have_lookup_create($database, $input);
329
330                 $log->info("working on input '$input_name' in $input->{path} [type: $input->{type}] using $input_module",
331                         @lookups ? " creating lookups: ".join(", ", @lookups) : ""
332                 );
333
334                 if ($stats) {
335                         # disable modification of records if --stats is in use
336                         delete($input->{modify_records});
337                         delete($input->{modify_file});
338                 }
339
340                 my $input_db = new WebPAC::Input(
341                         module => $input_module,
342                         encoding => $config->webpac('webpac_encoding'),
343                         limit => $limit || $input->{limit},
344                         offset => $offset,
345                         recode => $input->{recode},
346                         stats => $stats,
347                         modify_records => $input->{modify_records},
348                         modify_file => $input->{modify_file},
349                 );
350                 $log->logdie("can't create input using $input_module") unless ($input);
351
352                 if (defined( $input->{lookup} )) {
353                         $log->warn("$database/$input_name has depriciated lookup definition, removing it...");
354                         delete( $input->{lookup} );
355                 }
356
357                 my $lookup;
358                 my $lookup_coderef;
359
360                 if (@lookups) {
361
362                         my $rules = $parser->lookup_create_rules($database, $input) || $log->logdie("no rules found for $database/$input");
363
364                         $lookup_coderef = sub {
365                                 my $rec = shift || die "need rec!";
366                                 my $mfn = $rec->{'000'}->[0] || die "need mfn in 000";
367
368                                 WebPAC::Normalize::data_structure(
369                                         row => $rec,
370                                         rules => $rules,
371                                         lookup => $lookup,
372                                         config => create_ds_config( $db_config, $database, $input, $mfn ),
373                                 );
374
375                                 warn "current lookup = ", dump($lookup) if ($lookup);
376                         };
377
378                         WebPAC::Normalize::_set_lookup( undef );
379
380                         $log->debug("created lookup_coderef using:\n$rules");
381
382                 };
383
384                 my $maxmfn = $input_db->open(
385                         path => $input->{path},
386                         code_page => $input->{encoding},        # database encoding
387                         lookup_coderef => $lookup_coderef,
388                         %{ $input },
389                 );
390
391                 my $lookup_data = WebPAC::Normalize::_get_lookup();
392
393                 if (defined( $lookup_data->{$database}->{$input_name} )) {
394                         $log->debug("created following lookups: ", dump( $lookup_data ));
395
396                         foreach my $key (keys %{ $lookup_data->{$database}->{$input_name} }) {
397                                 $store->save_lookup(
398                                         database => $database,
399                                         input => $input_name,
400                                         key => $key,
401                                         data => $lookup_data->{$database}->{$input_name}->{$key},
402                                 );
403                         }
404                 }
405
406                 my $report_fh;
407                 if ($stats || $validate) {
408                         my $path = "out/report/${database}-${input_name}.txt";
409                         open($report_fh, '>', $path) || $log->logdie("can't open $path: $!");
410
411                         print $report_fh "Report for database '$database' input '$input_name' records ",
412                                 $offset || 1, "-", $limit || $input->{limit} || $maxmfn, "\n\n";
413                         $log->info("Generating report file $path");
414                 }
415
416                 my @norm_array = ref($input->{normalize}) eq 'ARRAY' ?
417                         @{ $input->{normalize} } : ( $input->{normalize} );
418
419                 if ($marc_normalize) {
420                         @norm_array = ( {
421                                 path => $marc_normalize,
422                                 output => $marc_output || "out/marc/${database}-${input_name}.marc",
423                         } );
424                 }
425
426                 foreach my $normalize (@norm_array) {
427
428                         my $normalize_path = $normalize->{path} || $log->logdie("can't find normalize path in config");
429
430                         $log->logdie("Found '$normalize_path' as normalization file which isn't supported any more!") unless ( $normalize_path =~ m!\.pl$!i );
431
432                         my $rules = read_file( $normalize_path ) or die "can't open $normalize_path: $!";
433
434                         $log->info("Using $normalize_path for normalization...");
435
436                         my $marc = new WebPAC::Output::MARC(
437                                 path => $normalize->{output},
438                                 lint => $marc_lint,
439                                 dump => $marc_dump,
440                         ) if ($normalize->{output});
441
442                         # reset position in database
443                         $input_db->seek(1);
444
445                         # generate name of config key for indexer (strip everything after -)
446                         my $indexer_config = $use_indexer;
447                         $indexer_config =~ s/^(\w+)-?.*$/$1/g if ($indexer_config);
448
449                         foreach my $pos ( 0 ... $input_db->size ) {
450
451                                 my $row = $input_db->fetch || next;
452
453                                 my $mfn = $row->{'000'}->[0];
454
455                                 if (! $mfn || $mfn !~ m#^\d+$#) {
456                                         $log->warn("record $pos doesn't have valid MFN but '$mfn', using $pos");
457                                         $mfn = $pos;
458                                         push @{ $row->{'000'} }, $pos;
459                                 }
460
461
462                                 if ($validate) {
463                                         if ( my $errors = $validate->validate_errors( $row, $input_db->dump ) ) {
464                                                 $log->error( "MFN $mfn validation error:\n",
465                                                         $validate->report_error( $errors )
466                                                 );
467                                         }
468                                 }
469
470                                 my $ds = WebPAC::Normalize::data_structure(
471                                         row => $row,
472                                         rules => $rules,
473                                         lookup => $lookup ? $lookup->lookup_hash : undef,
474                                         config => create_ds_config( $db_config, $database, $input, $mfn ),
475                                         marc_encoding => 'utf-8',
476                                 );
477
478                                 $store->save_ds(
479                                         database => $database,
480                                         input => $input_name,
481                                         id => $mfn,
482                                         ds => $ds,
483                                 ) if ($ds && !$stats);
484
485                                 $indexer->add(
486                                         id => "${input_name}/${mfn}",
487                                         ds => $ds,
488                                         type => $config->get($indexer_config)->{type},
489                                 ) if ($indexer && $ds);
490
491                                 if ($marc) {
492                                         my $i = 0;
493
494                                         while (my $fields = WebPAC::Normalize::_get_marc_fields( fetch_next => 1 ) ) {
495                                                 $marc->add(
496                                                         id => $mfn . ( $i ? "/$i" : '' ),
497                                                         fields => $fields,
498                                                         leader => WebPAC::Normalize::marc_leader(),
499                                                         row => $row,
500                                                 );
501                                                 $i++;
502                                         }
503
504                                         $log->info("Created $i instances of MFN $mfn\n") if ($i > 1);
505                                 }
506
507                                 $total_rows++;
508                         }
509
510                         if ($validate) {
511                                 my $errors = $validate->report;
512                                 if ($errors) {
513                                         $log->info("validation errors:\n$errors\n" );
514                                         print $report_fh "$errors\n" if ($report_fh);
515                                 }
516                         }
517
518                         if ($stats) {
519                                 my $s = $input_db->stats;
520                                 $log->info("statistics of fields usage:\n$s");
521                                 print $report_fh "Statistics of fields usage:\n$s" if ($report_fh);
522                         }
523
524                         # close MARC file
525                         $marc->finish if ($marc);
526
527                         # close report
528                         close($report_fh) if ($report_fh)
529                 }
530
531         }
532
533         eval { $indexer->finish } if ($indexer && $indexer->can('finish'));
534
535         my $dt = time() - $start_t;
536         $log->info("$total_rows records ", $indexer ? "indexed " : "",
537                 sprintf("in %.2f sec [%.2f rec/sec]",
538                         $dt, ($total_rows / $dt)
539                 )
540         );
541
542
543         # end forked process
544         if ($parallel) {
545                 $log->info("parallel process $$ finished");
546                 exit(0);
547         }
548
549 }
550
551 if ($parallel) {
552         # wait all children to finish
553         sleep(1) while wait != -1;
554         $log->info("all parallel processes finished");
555 }
556
557 #
558 # handle links or merge after indexing
559 #
560
561 if ($merge) {
562         print $estcmd_fh 'sudo /etc/init.d/hyperestraier start',$/;
563         close($estcmd_fh);
564         chmod 0700, $estcmd_path || $log->warn("can't chmod 0700 $estcmd_path: $!");
565         system $estcmd_path;
566 } else {
567         foreach my $link (@links) {
568                 $log->logdie("coderef in link ", Dumper($link), " is ", ref($link), " and not CODE") unless (ref($link) eq 'CODE');
569                 $link->();
570         }
571 }