Projekt

Allgemein

Profil

Herunterladen (7,63 KB) Statistiken
| Zweig: | Markierung: | Revision:

kivitendo/scripts/dbupgrade2_tool.pl @ 12c4c658

4fd8bdbf Moritz Bunkus
#!/usr/bin/perl

BEGIN {
if (! -d "bin" || ! -d "SL") {
print("This tool must be run from the Lx-Office ERP base directory.\n");
exit(1);
}
3f65b4fb Moritz Bunkus
push(@INC, "modules");
4fd8bdbf Moritz Bunkus
}

a6a8a9a8 Moritz Bunkus
use English '-no_match_vars';

4fd8bdbf Moritz Bunkus
use DBI;
use Data::Dumper;
use Getopt::Long;

use SL::LXDebug;

$lxdebug = LXDebug->new();

use SL::Form;
a6a8a9a8 Moritz Bunkus
use SL::User;
e0cb5a6c Moritz Bunkus
use SL::Locale;
4fd8bdbf Moritz Bunkus
use SL::DBUpgrade2;
a6a8a9a8 Moritz Bunkus
use SL::DBUtils;
4fd8bdbf Moritz Bunkus
#######
#######
#######

a6a8a9a8 Moritz Bunkus
my ($opt_list, $opt_tree, $opt_rtree, $opt_nodeps, $opt_graphviz, $opt_help);
my ($opt_user, $opt_apply);

our (%myconfig, $form, $user);

4fd8bdbf Moritz Bunkus
sub show_help {
92fc1394 Moritz Bunkus
my $help_text = <<'END_HELP'
dbupgrade2_tool.pl [options]

A validation and information tool for the database upgrade scripts
in 'sql/Pg-upgrade2'.

At startup dbupgrade2_tool.pl will always check the consistency
of all database upgrade scripts (e.g. circular references, invalid
formats, missing meta information). You can but don't have to specifiy
additional actions.

Actions:
--list Lists all database upgrade tags
--tree Lists all database upgrades in tree form
--rtree Lists all database upgrades in reverse tree form
--graphviz[=file] Create a Postscript document showing a tree of
all database upgrades and their dependencies.
If no file name is given then the output is
written to 'db_dependencies.ps'.
--apply=tag Applies the database upgrades 'tag' and all
upgrades it depends on. If '--apply' is used
then the option '--user' must be used as well.
--help Show this help and exit.

Options:
--user=name The name of the user configuration to use for
database connectivity.
END_HELP
;

print $help_text;
exit 0;
a6a8a9a8 Moritz Bunkus
}

sub error {
4fd8bdbf Moritz Bunkus
}

sub calc_rev_depends {
map({ $_->{"rev_depends"} = []; } values(%{$controls}));
foreach my $control (values(%{$controls})) {
map({ push(@{$controls->{$_}{"rev_depends"}}, $control->{"tag"}) }
@{$control->{"depends"}});
}
}

sub dump_list {
my @sorted_controls = sort_dbupdate_controls($controls);

print("LIST VIEW\n\n");
print("number tag depth priority\n");
$i = 0;
foreach (@sorted_controls) {
print("$i $_->{tag} $_->{depth} $_->{priority}\n");
$i++;
}

print("\n");
}

sub dump_node {
my ($tag, $depth) = @_;

print(" " x $depth . $tag . "\n");

my $c = $controls->{$tag};
my $num = scalar(@{$c->{"depends"}});
for (my $i = 0; $i < $num; $i++) {
dump_node($c->{"depends"}[$i], $depth + 1);
}
}

sub dump_tree {
print("TREE VIEW\n\n");

calc_rev_depends();

my @sorted_controls = sort_dbupdate_controls($controls);

foreach my $control (@sorted_controls) {
dump_node($control->{"tag"}, "") unless (@{$control->{"rev_depends"}});
}

print("\n");
}

sub dump_node_reverse {
my ($tag, $depth) = @_;

print(" " x $depth . $tag . "\n");

my $c = $controls->{$tag};
my $num = scalar(@{$c->{"rev_depends"}});
for (my $i = 0; $i < $num; $i++) {
dump_node_reverse($c->{"rev_depends"}[$i], $depth + 1);
}
}

sub dump_tree_reverse {
print("REVERSE TREE VIEW\n\n");

calc_rev_depends();

my @sorted_controls = sort_dbupdate_controls($controls);

foreach my $control (@sorted_controls) {
last if ($control->{"depth"} > 1);
dump_node_reverse($control->{"tag"}, "");
}

print("\n");
}

sub dump_graphviz {
92fc1394 Moritz Bunkus
my $file_name = shift || "db_dependencies.ps";

4fd8bdbf Moritz Bunkus
print("GRAPHVIZ POSTCRIPT\n\n");
92fc1394 Moritz Bunkus
print("Output will be written to '${file_name}'\n");
0c128c20 Moritz Bunkus
calc_rev_depends();

4fd8bdbf Moritz Bunkus
$dot = "|dot -Tps ";
0c128c20 Moritz Bunkus
open OUT, "${dot}> \"${file_name}\"" || die;

4fd8bdbf Moritz Bunkus
print(OUT
"digraph db_dependencies {\n" .
0c128c20 Moritz Bunkus
"node [shape=box style=filled fillcolor=white];\n");
4fd8bdbf Moritz Bunkus
my %ranks;
foreach my $c (values(%{$controls})) {
0c128c20 Moritz Bunkus
$ranks{$c->{"depth"}} ||= [];

my ($pre, $post) = ('node [fillcolor=lightgray] ', 'node [fillcolor=white] ') if !@{ $c->{"rev_depends"} };

push @{ $ranks{$c->{"depth"}} }, qq|${pre}"$c->{tag}"; ${post}|;
4fd8bdbf Moritz Bunkus
}
foreach (sort(keys(%ranks))) {
0c128c20 Moritz Bunkus
print OUT "{ rank = same; ", join("", @{ $ranks{$_} }), " }\n";
4fd8bdbf Moritz Bunkus
}
foreach my $c (values(%{$controls})) {
print(OUT "$c->{tag};\n");
foreach my $d (@{$c->{"depends"}}) {
print(OUT "$c->{tag} -> $d;\n");
}
}
print(OUT "}\n");
close(OUT);
}

sub dump_nodeps {
calc_rev_depends();

print("SCRIPTS NO OTHER SCRIPTS DEPEND ON\n\n" .
join("\n",
map({ $_->{"tag"} }
grep({ !@{$_->{"rev_depends"}} }
values(%{$controls})))) .
"\n\n");
}

a6a8a9a8 Moritz Bunkus
sub apply_upgrade {
my $name = shift;

acd67df0 Moritz Bunkus
my (@order, %tags, @all_tags);
a6a8a9a8 Moritz Bunkus
acd67df0 Moritz Bunkus
if ($name eq "ALL") {
calc_rev_depends();
@all_tags = map { $_->{"tag"} } grep { !@{$_->{"rev_depends"}} } values %{$controls};
a6a8a9a8 Moritz Bunkus
acd67df0 Moritz Bunkus
} else {
$form->error("Unknown dbupgrade tag '$name'") if (!$controls->{$name});
@all_tags = ($name);
}

foreach my $tag (@all_tags) {
build_upgrade_order($tag, \@order, \%tags);
}
a6a8a9a8 Moritz Bunkus
my @upgradescripts = map { $controls->{$_}->{"applied"} = 0; $controls->{$_} } @order;

my $dbh = $form->dbconnect_noauto(\%myconfig);

$dbh->{PrintWarn} = 0;
$dbh->{PrintError} = 0;

$user->create_schema_info_table($form, $dbh);

my $query = qq|SELECT tag FROM schema_info|;
$sth = $dbh->prepare($query);
$sth->execute() || $form->dberror($query);
while (($tag) = $sth->fetchrow_array()) {
$controls->{$tag}->{"applied"} = 1 if defined $controls->{$tag};
}
$sth->finish();

acd67df0 Moritz Bunkus
@upgradescripts = sort { $a->{"priority"} <=> $b->{"priority"} } grep { !$_->{"applied"} } @upgradescripts;
if (!@upgradescripts) {
a6a8a9a8 Moritz Bunkus
print "The upgrade has already been applied.\n";
exit 0;
}

foreach my $control (@upgradescripts) {
$control->{"file"} =~ /\.(sql|pl)$/;
my $file_type = $1;

# apply upgrade
print "Applying upgrade $control->{file}\n";

if ($file_type eq "sql") {
$user->process_query($form, $dbh, "sql/$form->{dbdriver}-upgrade2/$control->{file}", $control);
} else {
$user->process_perl_script($form, $dbh, "sql/$form->{dbdriver}-upgrade2/$control->{file}", $control);
}
}

$dbh->disconnect();
}

sub build_upgrade_order {
my $name = shift;
my $order = shift;
my $tag = shift;

my $control = $controls->{$name};

foreach my $dependency (@{ $control->{"depends"} }) {
next if $tags->{$dependency};
$tags->{$dependency} = 1;
build_upgrade_order($dependency, $order, $tag);
}

push @{ $order }, $name;
acd67df0 Moritz Bunkus
$tags->{$name} = 1;
a6a8a9a8 Moritz Bunkus
}

4fd8bdbf Moritz Bunkus
#######
#######
#######

eval { require "lx-erp.conf"; };

$form = Form->new();
$locale = Locale->new("de", "login");

#######
#######
#######

GetOptions("list" => \$opt_list,
"tree" => \$opt_tree,
"rtree" => \$opt_rtree,
"nodeps" => \$opt_nodeps,
92fc1394 Moritz Bunkus
"graphviz:s" => \$opt_graphviz,
a6a8a9a8 Moritz Bunkus
"user=s" => \$opt_user,
"apply=s" => \$opt_apply,
4fd8bdbf Moritz Bunkus
"help" => \$opt_help,
);

if ($opt_help) {
show_help();
}

$controls = parse_dbupdate_controls($form, "Pg");

if ($opt_list) {
dump_list();
}

if ($opt_tree) {
dump_tree();
}

if ($opt_rtree) {
dump_tree_reverse();
}

92fc1394 Moritz Bunkus
if (defined $opt_graphviz) {
dump_graphviz($opt_graphviz);
4fd8bdbf Moritz Bunkus
}

if ($opt_nodeps) {
dump_nodeps();
}
a6a8a9a8 Moritz Bunkus
if ($opt_user) {
my $file_name = "users/${opt_user}.conf";

eval { require($file_name); };
$form->error("File '$file_name' was not found") if $@;
$locale = new Locale($myconfig{countrycode}, "all");
$user = new User("users/members", $opt_user);
map { $form->{$_} = $myconfig{$_} } keys %myconfig;
}

if ($opt_apply) {
$form->error("--apply used but no configuration file given with --user.") if (!$user);
apply_upgrade($opt_apply);
}