--- loncom/lonsql 2002/08/06 13:48:47 1.51
+++ loncom/lonsql 2007/01/02 12:51:31 1.78
@@ -3,7 +3,7 @@
# The LearningOnline Network
# lonsql - LON TCP-MySQL-Server Daemon for handling database requests.
#
-# $Id: lonsql,v 1.51 2002/08/06 13:48:47 matthew Exp $
+# $Id: lonsql,v 1.78 2007/01/02 12:51:31 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -39,10 +39,59 @@ lonsql - LON TCP-MySQL-Server Daemon for
This script should be run as user=www.
Note that a lonsql.pid file contains the pid of the parent process.
-=head1 DESCRIPTION
+=head1 OVERVIEW
-lonsql is many things to many people. To me, it is a source file in need
-of documentation.
+=head2 Purpose within LON-CAPA
+
+LON-CAPA is meant to distribute A LOT of educational content to A LOT
+of people. It is ineffective to directly rely on contents within the
+ext2 filesystem to be speedily scanned for on-the-fly searches of
+content descriptions. (Simply put, it takes a cumbersome amount of
+time to open, read, analyze, and close thousands of files.)
+
+The solution is to index various data fields that are descriptive of
+the educational resources on a LON-CAPA server machine in a
+database. Descriptive data fields are referred to as "metadata". The
+question then arises as to how this metadata is handled in terms of
+the rest of the LON-CAPA network without burdening client and daemon
+processes.
+
+The obvious solution, using lonc to send a query to a lond process,
+doesn't work so well in general as you can see in the following
+example:
+
+ lonc= loncapa client process A-lonc= a lonc process on Server A
+ lond= loncapa daemon process
+
+ database command
+ A-lonc --------TCP/IP----------------> B-lond
+
+The problem emerges that A-lonc and B-lond are kept waiting for the
+MySQL server to "do its stuff", or in other words, perform the
+conceivably sophisticated, data-intensive, time-sucking database
+transaction. By tying up a lonc and lond process, this significantly
+cripples the capabilities of LON-CAPA servers.
+
+The solution is to offload the work onto another process, and use
+lonc and lond just for requests and notifications of completed
+processing:
+
+ database command
+
+ A-lonc ---------TCP/IP-----------------> B-lond =====> B-lonsql
+ <---------------------------------/ |
+ "ok, I'll get back to you..." |
+ |
+ /
+ A-lond <------------------------------- B-lonc <======
+ "Guess what? I have the result!"
+
+Of course, depending on success or failure, the messages may vary, but
+the principle remains the same where a separate pool of children
+processes (lonsql's) handle the MySQL database manipulations.
+
+Thus, lonc and lond spend effectively no time waiting on results from
+the database.
=head1 Internals
@@ -53,7 +102,9 @@ of documentation.
use strict;
use lib '/home/httpd/lib/perl/';
+use LONCAPA;
use LONCAPA::Configuration;
+use LONCAPA::lonmetadata();
use IO::Socket;
use Symbol;
@@ -65,6 +116,9 @@ use Fcntl;
use Tie::RefHash;
use DBI;
use File::Find;
+use localenroll;
+use GDBM_File;
+use Storable qw(thaw);
########################################################
########################################################
@@ -116,76 +170,6 @@ my $MAX_CLIENTS_PER_CHILD = 5; # numb
my %children = (); # keys are current child process IDs
my $children = 0; # current number of children
-########################################################
-########################################################
-
-=pod
-
-=item Functions required for forking
-
-=over 4
-
-=item REAPER
-
-REAPER takes care of dead children.
-
-=item HUNTSMAN
-
-Signal handler for SIGINT.
-
-=item HUPSMAN
-
-Signal handler for SIGHUP
-
-=item DISCONNECT
-
-Disconnects from database.
-
-=back
-
-=cut
-
-########################################################
-########################################################
-sub REAPER { # takes care of dead children
- $SIG{CHLD} = \&REAPER;
- my $pid = wait;
- $children --;
- &logthis("Child $pid died");
- delete $children{$pid};
-}
-
-sub HUNTSMAN { # signal handler for SIGINT
- local($SIG{CHLD}) = 'IGNORE'; # we're going to kill our children
- kill 'INT' => keys %children;
- my $execdir=$perlvar{'lonDaemons'};
- unlink("$execdir/logs/lonsql.pid");
- &logthis("CRITICAL: Shutting down");
- $unixsock = "mysqlsock";
- my $port="$perlvar{'lonSockDir'}/$unixsock";
- unlink($port);
- exit; # clean up with dignity
-}
-
-sub HUPSMAN { # signal handler for SIGHUP
- local($SIG{CHLD}) = 'IGNORE'; # we're going to kill our children
- kill 'INT' => keys %children;
- close($server); # free up socket
- &logthis("CRITICAL: Restarting");
- my $execdir=$perlvar{'lonDaemons'};
- $unixsock = "mysqlsock";
- my $port="$perlvar{'lonSockDir'}/$unixsock";
- unlink($port);
- exec("$execdir/lonsql"); # here we go again
-}
-
-sub DISCONNECT {
- $dbh->disconnect or
- &logthis("WARNING: Couldn't disconnect from database ".
- " $DBI::errstr : $@");
- exit;
-}
-
###################################################################
###################################################################
@@ -222,10 +206,26 @@ my $run =0; # running count
#
# Read loncapa_apache.conf and loncapa.conf
#
-my $perlvarref=LONCAPA::Configuration::read_conf('loncapa_apache.conf',
- 'loncapa.conf');
+my $perlvarref=LONCAPA::Configuration::read_conf('loncapa.conf');
my %perlvar=%{$perlvarref};
#
+# Write the /home/www/.my.cnf file
+my $conf_file = '/home/www/.my.cnf';
+if (! -e $conf_file) {
+ if (open MYCNF, ">$conf_file") {
+ print MYCNF <<"ENDMYCNF";
+[client]
+user=www
+password=$perlvar{'lonSqlAccess'}
+ENDMYCNF
+ close MYCNF;
+ } else {
+ warn "Unable to write $conf_file, continuing";
+ }
+}
+
+
+#
# Make sure that database can be accessed
#
my $dbh;
@@ -237,10 +237,17 @@ unless ($dbh = DBI->connect("DBI:mysql:l
my $subj="LON: $perlvar{'lonHostID'} Cannot connect to database!";
system("echo 'Cannot connect to MySQL database!' |".
" mailto $emailto -s '$subj' > /dev/null");
+
+ open(SMP,'>/home/httpd/html/lon-status/mysql.txt');
+ print SMP 'time='.time.'&mysql=defunct'."\n";
+ close(SMP);
+
exit 1;
} else {
+ unlink('/home/httpd/html/lon-status/mysql.txt');
$dbh->disconnect;
}
+
#
# Check if other instance running
#
@@ -251,23 +258,25 @@ if (-e $pidfile) {
chomp($pide);
if (kill 0 => $pide) { die "already running"; }
}
+
#
# Read hosts file
#
-my %hostip;
my $thisserver;
+my %hostname;
my $PREFORK=4; # number of children to maintain, at least four spare
open (CONFIG,"$perlvar{'lonTabDir'}/hosts.tab") || die "Can't read host file";
while (my $configline=) {
- my ($id,$domain,$role,$name,$ip)=split(/:/,$configline);
- chomp($ip);
- $hostip{$ip}=$id;
+ my ($id,$domain,$role,$name)=split(/:/,$configline);
+ $name=~s/\s//g;
$thisserver=$name if ($id eq $perlvar{'lonHostID'});
- $PREFORK++;
+ $hostname{$id}=$name;
+ #$PREFORK++;
}
close(CONFIG);
#
-$PREFORK=int($PREFORK/4);
+#$PREFORK=int($PREFORK/4);
+
#
# Create a socket to talk to lond
#
@@ -280,21 +289,23 @@ unless ($server=IO::Socket::UNIX->new(Lo
Listen => 10)) {
print "in socket error:$@\n";
}
-########################################################
-########################################################
+
#
# Fork once and dissociate
+#
my $fpid=fork;
exit if $fpid;
die "Couldn't fork: $!" unless defined ($fpid);
POSIX::setsid() or die "Can't start new session: $!";
+
#
# Write our PID on disk
my $execdir=$perlvar{'lonDaemons'};
open (PIDSAVE,">$execdir/logs/lonsql.pid");
print PIDSAVE "$$\n";
close(PIDSAVE);
-&logthis("CRITICAL: ---------- Starting ----------");
+&logthis("CRITICAL: ---------- Starting ----------");
+
#
# Ignore signals generated during initial startup
$SIG{HUP}=$SIG{USR1}='IGNORE';
@@ -303,11 +314,13 @@ $SIG{HUP}=$SIG{USR1}='IGNORE';
for (1 .. $PREFORK) {
make_new_child();
}
+
#
# Install signal handlers.
$SIG{CHLD} = \&REAPER;
$SIG{INT} = $SIG{TERM} = \&HUNTSMAN;
$SIG{HUP} = \&HUPSMAN;
+
#
# And maintain the population.
while (1) {
@@ -362,7 +375,7 @@ sub make_new_child {
$perlvar{'lonSqlAccess'},
{ RaiseError =>0,PrintError=>0})) {
sleep(10+int(rand(20)));
- &logthis("WARNING: Couldn't connect to database".
+ &logthis("WARNING: Couldn't connect to database".
": $@");
# "($st secs): $@");
print "database handle error\n";
@@ -378,6 +391,8 @@ sub make_new_child {
$run = $run+1;
my $userinput = <$client>;
chomp($userinput);
+ $userinput=~s/\:(\w+)$//;
+ my $searchdomain=$1;
#
my ($conserver,$query,
$arg1,$arg2,$arg3)=split(/&/,$userinput);
@@ -390,7 +405,7 @@ sub make_new_child {
$queryid .= $run;
print $client "$queryid\n";
#
- &logthis("QUERY: $query - $arg1 - $arg2 - $arg3");
+ # &logthis("QUERY: $query - $arg1 - $arg2 - $arg3");
sleep 1;
#
my $result='';
@@ -415,22 +430,67 @@ sub make_new_child {
$result='no_such_file';
}
# end of log query
+ } elsif (($query eq 'fetchenrollment') ||
+ ($query eq 'institutionalphotos')) {
+ # retrieve institutional class lists
+ my $dom = &unescape($arg1);
+ my %affiliates = ();
+ my %replies = ();
+ my $locresult = '';
+ my $querystr = &unescape($arg3);
+ foreach (split/%%/,$querystr) {
+ if (/^([^=]+)=([^=]+)$/) {
+ @{$affiliates{$1}} = split/,/,$2;
+ }
+ }
+ if ($query eq 'fetchenrollment') {
+ $locresult = &localenroll::fetch_enrollment($dom,\%affiliates,\%replies);
+ } elsif ($query eq 'institutionalphotos') {
+ my $crs = &unescape($arg2);
+ eval {
+ local($SIG{__DIE__})='DEFAULT';
+ $locresult = &localenroll::institutional_photos($dom,$crs,\%affiliates,\%replies,'update');
+ };
+ if ($@) {
+ $locresult = 'error';
+ }
+ }
+ $result = &escape($locresult.':');
+ if ($locresult) {
+ $result .= &escape(join(':',map{$_.'='.$replies{$_}} keys %replies));
+ }
+ } elsif ($query eq 'prepare activity log') {
+ my ($cid,$domain) = map {&unescape($_);} ($arg1,$arg2);
+ &logthis('preparing activity log tables for '.$cid);
+ my $command =
+ qq{$perlvar{'lonDaemons'}/parse_activity_log.pl -course=$cid -domain=$domain};
+ system($command);
+ &logthis($command);
+ my $returnvalue = $?>>8;
+ if ($returnvalue) {
+ $result = 'error: parse_activity_log.pl returned '.
+ $returnvalue;
+ } else {
+ $result = 'success';
+ }
+ } elsif (($query eq 'portfolio_metadata') ||
+ ($query eq 'portfolio_access')) {
+ $result = &portfolio_table_update($query,$arg1,$arg2,
+ $arg3);
} else {
# Do an sql query
- $result = &do_sql_query($query,$arg1,$arg2);
+ $result = &do_sql_query($query,$arg1,$arg2,$searchdomain);
}
# result does not need to be escaped because it has already been
# escaped.
#$result=&escape($result);
- # reply with result, append \n unless already there
- $result.="\n" unless ($result=~/\n$/);
&reply("queryreply:$queryid:$result",$conserver);
}
# tidy up gracefully and finish
#
# close the database handle
$dbh->disconnect
- or &logthis("WARNING: Couldn't disconnect".
+ or &logthis("WARNING: Couldn't disconnect".
" from database $DBI::errstr : $@");
# this exit is VERY important, otherwise the child will become
# a producer of more and more children, forking yourself into
@@ -470,7 +530,18 @@ sub process_file {
}
sub do_sql_query {
- my ($query,$custom,$customshow) = @_;
+ my ($query,$custom,$customshow,$searchdomain) = @_;
+
+#
+# limit to searchdomain if given and table is metadata
+#
+ if (($searchdomain) && ($query=~/FROM metadata/)) {
+ $query.=' HAVING (domain="'.$searchdomain.'")';
+ }
+# &logthis('doing query ('.$searchdomain.')'.$query);
+
+
+
$custom = &unescape($custom);
$customshow = &unescape($customshow);
#
@@ -485,8 +556,9 @@ sub do_sql_query {
#prepare and execute the query
my $sth = $dbh->prepare($query);
unless ($sth->execute()) {
- &logthis("WARNING: ".
- "Could not retrieve from database: $@");
+ &logthis(''.
+ 'WARNING: Could not retrieve from database:'.
+ $sth->errstr().'');
} else {
my $aref=$sth->fetchall_arrayref;
foreach my $row (@$aref) {
@@ -566,6 +638,166 @@ sub do_sql_query {
} # End of &do_sql_query
} # End of scoping curly braces for &process_file and &do_sql_query
+
+sub portfolio_table_update {
+ my ($query,$arg1,$arg2,$arg3) = @_;
+ my %tablenames = (
+ 'portfolio' => 'portfolio_metadata',
+ 'access' => 'portfolio_access',
+ 'addedfields' => 'portfolio_addedfields',
+ );
+ my $result = 'ok';
+ my $tablechk = &check_table($query);
+ if ($tablechk == 0) {
+ my $request =
+ &LONCAPA::lonmetadata::create_metadata_storage($query,$query);
+ $dbh->do($request);
+ if ($dbh->err) {
+ &logthis("create $query".
+ " ERROR: ".$dbh->errstr);
+ $result = 'error';
+ }
+ }
+ if ($result eq 'ok') {
+ my ($uname,$udom) = split(/:/,&unescape($arg1));
+ my $file_name = &unescape($arg2);
+ my $group = &unescape($arg3);
+ my $is_course = 0;
+ if ($group ne '') {
+ $is_course = 1;
+ }
+ my $urlstart = '/uploaded/'.$udom.'/'.$uname;
+ my $pathstart = &propath($udom,$uname).'/userfiles';
+ my ($fullpath,$url);
+ if ($is_course) {
+ $fullpath = $pathstart.'/groups/'.$group.'/portfolio'.
+ $file_name;
+ $url = $urlstart.'/groups/'.$group.'/portfolio'.$file_name;
+ } else {
+ $fullpath = $pathstart.'/portfolio'.$file_name;
+ $url = $urlstart.'/portfolio'.$file_name;
+ }
+ my %access = &get_access_hash($uname,$udom,$group.$file_name);
+ if ($query eq 'portfolio_metadata') {
+ if (-e $fullpath.'.meta') {
+ my %loghash = &LONCAPA::lonmetadata::process_portfolio_metadata($dbh,undef,\%tablenames,$url,$fullpath,$is_course,$udom,$uname,$group,'update');
+ if (keys(%loghash) > 0) {
+ &portfolio_logging(%loghash);
+ }
+ }
+ } elsif ($query eq 'portfolio_access') {
+ my %loghash =
+ &LONCAPA::lonmetadata::process_portfolio_access_data($dbh,undef,
+ \%tablenames,$url,$fullpath,\%access,'update');
+ if (keys(%loghash) > 0) {
+ &portfolio_logging(%loghash);
+ } else {
+ my $available = 0;
+ foreach my $key (keys(%access)) {
+ my ($num,$scope,$end,$start) =
+ ($key =~ /^([^:]+):([a-z]+)_(\d*)_?(\d*)$/);
+ if ($scope eq 'public' || $scope eq 'guest') {
+ $available = 1;
+ last;
+ }
+ }
+ if ($available) {
+ # Retrieve current values
+ my $condition = 'url='.$dbh->quote("$url");
+ my ($error,$row) =
+ &LONCAPA::lonmetadata::lookup_metadata($dbh,$condition,undef,
+ 'portfolio_metadata');
+ if (!$error) {
+ if (!(ref($row->[0]) eq 'ARRAY')) {
+ my %loghash =
+ &LONCAPA::lonmetadata::process_portfolio_metadata($dbh,undef,
+ \%tablenames,$url,$fullpath,$is_course,$udom,$uname,$group);
+ if (keys(%loghash) > 0) {
+ &portfolio_logging(%loghash);
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ return $result;
+}
+
+sub get_access_hash {
+ my ($uname,$udom,$file) = @_;
+ my $hashref = &tie_user_hash($udom,$uname,'file_permissions',
+ &GDBM_READER());
+ my %curr_perms;
+ my %access;
+ if ($hashref) {
+ while (my ($key,$value) = each(%$hashref)) {
+ $key = &unescape($key);
+ next if ($key =~ /^error: 2 /);
+ $curr_perms{$key}=&thaw_unescape($value);
+ }
+ if (!&untie_user_hash($hashref)) {
+ &logthis("error: ".($!+0)." untie (GDBM) Failed");
+ }
+ } else {
+ &logthis("error: ".($!+0)." tie (GDBM) Failed");
+ }
+ if (keys(%curr_perms) > 0) {
+ if (ref($curr_perms{$file."\0".'accesscontrol'}) eq 'HASH') {
+ foreach my $acl (keys(%{$curr_perms{$file."\0".'accesscontrol'}})) {
+ $access{$acl} = $curr_perms{$file."\0".$acl};
+ }
+ }
+ }
+ return %access;
+}
+
+sub thaw_unescape {
+ my ($value)=@_;
+ if ($value =~ /^__FROZEN__/) {
+ substr($value,0,10,undef);
+ $value=&unescape($value);
+ return &thaw($value);
+ }
+ return &unescape($value);
+}
+
+###########################################
+sub check_table {
+ my ($table_id) = @_;
+ my $sth=$dbh->prepare('SHOW TABLES');
+ $sth->execute();
+ my $aref = $sth->fetchall_arrayref;
+ $sth->finish();
+ if ($sth->err()) {
+ &logthis("fetchall_arrayref after SHOW TABLES".
+ " ERROR: ".$sth->errstr);
+ return undef;
+ }
+ my $result = 0;
+ foreach my $table (@{$aref}) {
+ if ($table->[0] eq $table_id) {
+ $result = 1;
+ last;
+ }
+ }
+ return $result;
+}
+
+###########################################
+
+sub portfolio_logging {
+ my (%portlog) = @_;
+ foreach my $key (keys(%portlog)) {
+ if (ref($portlog{$key}) eq 'HASH') {
+ foreach my $item (keys(%{$portlog{$key}})) {
+ &logthis($portlog{$key}{$item});
+ }
+ }
+ }
+}
+
+
########################################################
########################################################
@@ -586,7 +818,7 @@ Writes $message to the logfile.
sub logthis {
my $message=shift;
my $execdir=$perlvar{'lonDaemons'};
- my $fh=IO::File->new(">>$execdir/logs/lonsqlfinal.log");
+ my $fh=IO::File->new(">>$execdir/logs/lonsql.log");
my $now=time;
my $local=localtime($now);
print $fh "$local ($$): $message\n";
@@ -613,12 +845,12 @@ Returns: The results of the message or '
########################################################
sub subreply {
my ($cmd,$server)=@_;
- my $peerfile="$perlvar{'lonSockDir'}/$server";
+ my $peerfile="$perlvar{'lonSockDir'}/".$hostname{$server};
my $sclient=IO::Socket::UNIX->new(Peer =>"$peerfile",
Type => SOCK_STREAM,
Timeout => 10)
or return "con_lost";
- print $sclient "$cmd\n";
+ print $sclient "sethost:$server:$cmd\n";
my $answer=<$sclient>;
chomp($answer);
$answer="con_lost" if (!$answer);
@@ -663,52 +895,6 @@ sub reply {
=pod
-=item &escape
-
-Escape special characters in a string.
-
-Inputs: string to escape
-
-Returns: The input string with special characters escaped.
-
-=cut
-
-########################################################
-########################################################
-sub escape {
- my $str=shift;
- $str =~ s/(\W)/"%".unpack('H2',$1)/eg;
- return $str;
-}
-
-########################################################
-########################################################
-
-=pod
-
-=item &unescape
-
-Unescape special characters in a string.
-
-Inputs: string to unescape
-
-Returns: The input string with special characters unescaped.
-
-=cut
-
-########################################################
-########################################################
-sub unescape {
- my $str=shift;
- $str =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
- return $str;
-}
-
-########################################################
-########################################################
-
-=pod
-
=item &ishome
Determine if the current machine is the home server for a user.
@@ -874,17 +1060,76 @@ sub userlog {
return join('&',sort(@results));
}
+########################################################
+########################################################
+=pod
+=item Functions required for forking
+=over 4
+=item REAPER
+REAPER takes care of dead children.
+=item HUNTSMAN
+
+Signal handler for SIGINT.
+
+=item HUPSMAN
+
+Signal handler for SIGHUP
+
+=item DISCONNECT
+
+Disconnects from database.
+
+=back
+
+=cut
+
+########################################################
+########################################################
+sub REAPER { # takes care of dead children
+ $SIG{CHLD} = \&REAPER;
+ my $pid = wait;
+ $children --;
+ &logthis("Child $pid died");
+ delete $children{$pid};
+}
+sub HUNTSMAN { # signal handler for SIGINT
+ local($SIG{CHLD}) = 'IGNORE'; # we're going to kill our children
+ kill 'INT' => keys %children;
+ my $execdir=$perlvar{'lonDaemons'};
+ unlink("$execdir/logs/lonsql.pid");
+ &logthis("CRITICAL: Shutting down");
+ $unixsock = "mysqlsock";
+ my $port="$perlvar{'lonSockDir'}/$unixsock";
+ unlink($port);
+ exit; # clean up with dignity
+}
+sub HUPSMAN { # signal handler for SIGHUP
+ local($SIG{CHLD}) = 'IGNORE'; # we're going to kill our children
+ kill 'INT' => keys %children;
+ close($server); # free up socket
+ &logthis("CRITICAL: Restarting");
+ my $execdir=$perlvar{'lonDaemons'};
+ $unixsock = "mysqlsock";
+ my $port="$perlvar{'lonSockDir'}/$unixsock";
+ unlink($port);
+ exec("$execdir/lonsql"); # here we go again
+}
+sub DISCONNECT {
+ $dbh->disconnect or
+ &logthis("WARNING: Couldn't disconnect from database ".
+ " $DBI::errstr : $@");
+ exit;
+}
-# ----------------------------------- POD (plain old documentation, CPAN style)
=pod