File:
[LON-CAPA] /
loncom /
build /
add_domain_coordinator_privilege.pl
Revision
1.4:
download - view:
text,
annotated -
select for diffs
Thu Jan 3 21:16:11 2008 UTC (16 years, 8 months ago) by
raeburn
Branches:
MAIN
CVS tags:
version_2_9_X,
version_2_9_99_0,
version_2_9_1,
version_2_9_0,
version_2_8_X,
version_2_8_99_1,
version_2_8_99_0,
version_2_8_2,
version_2_8_1,
version_2_8_0,
version_2_7_X,
version_2_7_99_1,
version_2_7_99_0,
version_2_7_1,
version_2_7_0,
version_2_6_X,
version_2_6_99_1,
version_2_6_99_0,
version_2_6_3,
version_2_6_2,
version_2_6_1,
version_2_6_0,
version_2_10_0_RC2,
version_2_10_0_RC1,
bz6209-base,
bz6209,
bz5969,
bz5610,
bz2851,
PRINT_INCOMPLETE_base,
PRINT_INCOMPLETE,
HEAD,
GCI_3,
GCI_2,
GCI_1,
BZ5971-printing-apage,
BZ5434-fox
Set www as owner of nohist_domainprefs.pm, in case it had to be created when adding a user from the command line.
#!/usr/bin/perl
=pod
=head1 NAME
add_domain_coordinator_privilege.pl - Add domain coordinator to an
exisiting user on a LON-CAPA system.
=cut
# The LearningOnline Network
#
# add_domain_coordinator_privilege.pl - Add domain coordinator to an
# exisiting user on a LON-CAPA system.
#
# $Id: add_domain_coordinator_privilege.pl,v 1.4 2008/01/03 21:16:11 raeburn Exp $
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
# /home/httpd/html/adm/gpl.txt
#
# http://www.lon-capa.org/
#
###
=pod
=head1 DESCRIPTION
Automates the steps for domain coordinator creation. This
program also describes a manual procedure (see below).
These are the steps that are executed on the linux operating system:
=over 4
=item *
Tests to see if user already exists for LON-CAPA, if not it aborts.
=item *
Set roles.hist and roles.db
=back
=cut
# NOTE: I am interspersing the manual procedure with the automation.
# To see the manual procedure, do perldoc ./make_domain_coordinator.pl
# This is a standalone script. It *could* alternatively use the
# lcuseradd script, however lcuseradd relies on certain system
# dependencies. In order to have a focused performance, I am trying
# to avoid system dependencies until the LON-CAPA code base becomes
# more robust and well-boundaried. make_domain_coordinator.pl should be able
# to run freely as possible, irrespective of the status of a LON-CAPA
# installation.
# ---------------------------------------------------- Configure general values
use lib '/home/httpd/lib/perl/';
use LONCAPA;
use Apache::lonnet;
use Apache::loncommon;
use Apache::lonlocal;
&Apache::lonlocal::get_language_handle();
=pod
=head1 OPTIONS
There are no flags to this script.
usage: add_domain_coordinator_privilege.pl [USERNAME:DOMAIN] [NEWDOMAIN]
The first argument specifies the user name domain of an existing user.
The second argument specifies the domain to add to coordinate.
=cut
# ----------------------------------------------- So, are we invoked correctly?
# Two arguments or abort
if (@ARGV!=2) {
die('usage: add_domain_coordinator_privilege.pl [USERNAME:DOMAIN] [NEWDOMAIN]'.
"\n");
}
my ($user,$add_domain)=(@ARGV);
my ($username,$domain)=split(':',$user);
if (!grep(/^\Q$add_domain\E$/,&Apache::lonnet::current_machine_domains())) {
die('**** ERROR **** Domain '.$add_domain.' is unknown'."\n");
}
my $udpath=&propath($domain,$username);
if (!-d $udpath) {
die ('**** ERROR **** '.$user.' is NOT already defined as a LON-CAPA '.
'user.'."\n");
}
=pod
=head1 MANUAL PROCEDURE
There are 2 steps to manually recreating what this script performs
automatically.
You need to decide on two pieces of information
to create a domain coordinator.
* USERNAME (kermit, albert, joe, etc)
* DOMAIN (should be a domain for thsi machine from domain.tab)
The examples in these instructions will be based
on two example pieces of information:
* USERNAME=dc103
* DOMAIN=103
You will also need to know your "root" password
or your "www" password.
=over 4
=pod
=item 1. (as www). Run CVS:loncapa/doc/rolesmanip.pl:
Command: [prompt %] perl rolesmanip.pl NEWDOMAIN USERNAME
Example: [prompt %] perl rolesmanip.pl 103 dc103
=cut
use GDBM_File; # A simple key-value pairing database.
my $rolesref=&LONCAPA::locking_hash_tie("$udpath/roles.db",&GDBM_WRCREAT());
if (!$rolesref) {
die('unable to tie roles db: '."$udpath/roles.db");
}
if (exists($rolesref->{'/'.$add_domain.'/_dc'})) {
my ($role,$end,$start) = split('_',$rolesref->{'/'.$add_domain.'/_dc'});
print(&mt("[_1] already has a dc privilege for [_2].",
$user,$add_domain)."\n");
if ($start) {
print(&mt("Start date: [_1]",&Apache::lonlocal::locallocaltime($start)).
"\n");
if (!$end) {
print(&mt("No planned end date.")."\n");
}
if ($start < time() && (!$end || $end > time())) {
print(&mt("It is currently active."));
exit(0);
}
} elsif ($end) {
print(&mt("End date: [_1]",&Apache::lonlocal::locallocaltime($end)).
"\n");
if ($end > time()) {
print(&mt("It is currently active.")."\n");
exit(0);
}
}
if (!$start and !$end) {
print(&mt("It is currently active.")."\n");
exit(0);
}
print(&mt("It is currently not active. Proceeding to re-enable")."\n");
}
my $now = time;
$rolesref->{'/'.$add_domain.'/_dc'}='dc_0_'.$now; # Set the domain coordinator role.
open(OUT, ">$udpath/roles.hist"); # roles.hist is the synchronous plain text.
foreach my $key (keys(%{$rolesref})) {
print(OUT $key.' : '.$rolesref->{$key}."\n");
}
close(OUT);
&LONCAPA::locking_hash_untie($rolesref);
`chown www:www $udpath/roles.hist`; # Must be writeable by httpd process.
`chown www:www $udpath/roles.db`; # Must be writeable by httpd process.
my %perlvar = %{&LONCAPA::Configuration::read_conf('loncapa.conf')};
my $dompath = $perlvar{'lonUsersDir'}.'/'.$domain;
my $domrolesref = &LONCAPA::locking_hash_tie("$dompath/nohist_domainroles.db",&GDBM_WRCREAT());
if (!$domrolesref) {
die('unable to tie nohist_domainroles db: '."$dompath/nohist_domainroles.db");
}
# Store in nohist_domainroles.db
my $domkey=&LONCAPA::escape('dc:'.$username.':'.$domain.'::'.$domain.':');
$domrolesref->{$domkey}= &LONCAPA::escape('0:'.$now);
&LONCAPA::locking_hash_untie($domrolesref);
system('/bin/chown',"www:www","$dompath/nohist_domainroles.db"); # Must be writeable by httpd process.
system('/bin/chown',"www:www","$dompath/nohist_domainroles.db.lock");
=pod
=item 2.
You may further define the domain coordinator user (i.e. dc103)
by going to http://MACHINENAME/adm/createuser.
=cut
# Output success message, and inform sysadmin about how to further proceed.
print("$username is now a domain coordinator for $add_domain\n");
my $hostname=`hostname`; chomp($hostname); # Read in hostname.
print("http://$hostname/adm/createuser will allow you to further define".
" this user.\n"); # Output a suggested URL.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>