X-Git-Url: https://code.th-h.de/?p=usenet%2Fnewsstats.git;a=blobdiff_plain;f=install%2Finstall.pl;h=fabdaa160c118a89066bba4451fbdccfb5a4a82c;hp=b14f59ac79cee63419b83d3ac68b4fcdd4286cb1;hb=24d2011f322ff3b58527c24bbd767cdf02515ca5;hpb=f6d15ca78e16217b709d69f2977b28dd1eeabc02 diff --git a/install/install.pl b/install/install.pl index b14f59a..fabdaa1 100755 --- a/install/install.pl +++ b/install/install.pl @@ -1,51 +1,62 @@ -#! /usr/bin/perl -W +#! /usr/bin/perl # # install.pl # # This script will create database tables as necessary. -# +# # It is part of the NewsStats package. # -# Copyright (c) 2010 Thomas Hochstein +# Copyright (c) 2010-2013 Thomas Hochstein # -# It can be redistributed and/or modified under the same terms under +# It can be redistributed and/or modified under the same terms under # which Perl itself is published. BEGIN { - our $VERSION = "0.01"; + our $VERSION = "0.02"; use File::Basename; - # we're in .../install, so our module is in .. - push(@INC, dirname($0).'/..'); + # we're in .../install, so our module is in ../lib + push(@INC, dirname($0).'/../lib'); } use strict; +use warnings; use NewsStats qw(:DEFAULT); use Cwd; use DBI; +use Getopt::Long qw(GetOptions); +Getopt::Long::config ('bundling'); ################################# Main program ################################# ### read commandline options -my %Options = &ReadOptions('u:'); +my ($OptUpdate,$OptConfFile); +GetOptions ('u|update=s' => \$OptUpdate, + 'conffile=s' => \$OptConfFile, + 'h|help' => \&ShowPOD, + 'V|version' => \&ShowVersion) or exit 1; ### change working directory to .. (as we're in .../install) -chdir dirname($0).'/..'; +chdir dirname($FullPath).'/..'; my $Path = cwd(); ### read configuration print("Reading configuration.\n"); -my %Conf = %{ReadConfig('newsstats.conf')}; +my %Conf = %{ReadConfig($OptConfFile)}; ##### -------------------------------------------------------------------------- ##### Database table definitions ##### -------------------------------------------------------------------------- +my $DBCreate = < < < INSTALL -my $Upgrade = < 0.02 -$DBUpgrade{'0.02'} = <connect(sprintf('DBI:%s:host=%s',$Conf{'DBDriver'}, + $Conf{'DBHost'}), $Conf{'DBUser'}, + $Conf{'DBPw'}, { PrintError => 0 }); + my $DBQuery = $DBHandle->prepare($DBCreate); + $DBQuery->execute() or &Bleat(2, sprintf("Can't create database %s: %s%\n", + $Conf{'DBDatabase'}, $DBI::errstr)); + + printf("Database table %s created succesfully.\n",$Conf{'DBDatabase'}); + $DBHandle->disconnect; +}; + ### DB init, read list of tables print "Reading database information.\n"; my $DBHandle = InitDB(\%Conf,1); -my %TablesInDB = %{$DBHandle->table_info('%', '%', '%', 'TABLE')->fetchall_hashref('TABLE_NAME')}; +my %TablesInDB = + %{$DBHandle->table_info('%', '%', '%', 'TABLE')->fetchall_hashref('TABLE_NAME')}; -if (!$Options{'u'}) { +if (!$OptUpdate) { ##### installation mode - print "----------\nStarting database table generation.\n"; # check for tables and create them, if they don't exist yet foreach my $Table (keys %DBCreate) { &CreateTable($Table); }; print "Database table generation done.\n"; - + # Display install instructions print $Install; } else { ##### upgrade mode print "----------\nStarting upgrade process.\n"; - if ($Options{'u'} < $PackageVersion) { - # Database upgrades for each version - foreach my $UpVersion (sort keys %DBUpgrade) { - if ($UpVersion > $Options{'u'} and $UpVersion <= $PackageVersion) { - print "v$UpVersion: Executing database upgrade ...\n"; - &DoMySQL($DBUpgrade{$UpVersion}); - }; - }; - # Display upgrade instructions for each version - foreach my $UpVersion (sort keys %Instructions) { - if ($UpVersion > $Options{'u'} and $UpVersion <= $PackageVersion) { - print "v$UpVersion: Upgrade Instructions >>>>>\n"; - my $Padding = ' ' x (length($UpVersion) + 3); - $Instructions{$UpVersion} =~ s/^/$Padding/; - print $Instructions{$UpVersion}; - print "<" x (length($UpVersion) + 29) . "\n"; - }; + $PackageVersion = '0.03'; + if ($OptUpdate < $PackageVersion) { + if ($OptUpdate < 0.02) { + # 0.01 -> 0.02 + # &DoMySQL('...;'); + # print "v0.02: Database upgrades ...\n"; + # &PrintInstructions('0.02',<<" INSTRUCTIONS"); + # INSTRUCTIONS }; }; - # Display upgrade instructions + # Display general upgrade instructions print $Upgrade; }; @@ -204,25 +213,38 @@ exit(0); ################################# Subroutines ################################## -sub CreateTable() { +sub CreateTable { my $Table = shift; if (defined($TablesInDB{$Conf{$Table}})) { - printf("Database table %s.%s already exists, skipping ....\n",$Conf{'DBDatabase'},$Conf{$Table}); + printf("Database table %s.%s already exists, skipping ....\n", + $Conf{'DBDatabase'},$Conf{$Table}); return; }; my $DBQuery = $DBHandle->prepare($DBCreate{$Table}); - $DBQuery->execute() or die sprintf("$MySelf: E: Can't create table %s in database %s: %s%\n",$Table,$Conf{'DBDatabase'},$DBI::errstr); - printf("Database table %s.%s created succesfully.\n",$Conf{'DBDatabase'},$Conf{$Table}); + $DBQuery->execute() or + &Bleat(2, sprintf("Can't create table %s in database %s: %s%\n",$Table, + $Conf{'DBDatabase'},$DBI::errstr)); + printf("Database table %s.%s created succesfully.\n", + $Conf{'DBDatabase'},$Conf{$Table}); return; }; -sub DoMySQL() { +sub DoMySQL { my $SQL = shift; my $DBQuery = $DBHandle->prepare($SQL); - $DBQuery->execute() or warn sprintf("$MySelf: E: Database error: %s\n",$DBI::errstr); + $DBQuery->execute() or &Bleat(1, sprintf("Database error: %s\n",$DBI::errstr)); return; }; +sub PrintInstructions { + my ($UpVersion,$Instructions) = @_; + print "v$UpVersion: Upgrade Instructions >>>>>\n"; + my $Padding = ' ' x (length($UpVersion) + 3); + $Instructions =~ s/^ /$Padding/mg; + print $Instructions; + print "<" x (length($UpVersion) + 29) . "\n"; +}; + __END__ @@ -234,23 +256,11 @@ install - installation script =head1 SYNOPSIS -B [B<-Vh>] +B [B<-Vh> [--update I] [--conffile I] =head1 REQUIREMENTS -See doc/README: Perl 5.8.x itself and the following modules from CPAN: - -=over 2 - -=item - - -Config::Auto - -=item - - -DBI - -=back +See L. =head1 DESCRIPTION @@ -258,40 +268,48 @@ This script will create database tables as necessary and configured. =head2 Configuration -F will read its configuration from F via +B will read its configuration from F via Config::Auto. -See doc/INSTALL for an overview of possible configuration options. +See L for an overview of possible configuration options. =head1 OPTIONS =over 3 -=item B<-V> (version) +=item B<-V>, B<--version> -Print out version and copyright information on B and exit. +Print out version and copyright information and exit. -=item B<-h> (help) +=item B<-h>, B<--help> Print this man page and exit. +=item B<-u>, B<--update> I + +Don't do a fresh install, but update from I. + +=item B<--conffile> I + +Load configuration from I instead of F. + =back =head1 FILES =over 4 -=item F +=item F The script itself. -=item F +=item F Library functions for the NewsStats package. -=item F +=item F -Runtime configuration file for B. +Runtime configuration file. =back @@ -306,11 +324,11 @@ bug tracker at L! =item - -doc/README +L =item - -doc/INSTALL +L =back @@ -322,7 +340,7 @@ Thomas Hochstein =head1 COPYRIGHT AND LICENSE -Copyright (c) 2010 Thomas Hochstein +Copyright (c) 2010-2013 Thomas Hochstein This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.