# BEGIN BPS TAGGED BLOCK {{{ # # COPYRIGHT: # # This software is Copyright (c) 1996-2005 Best Practical Solutions, LLC # # # (Except where explicitly superseded by other copyright notices) # # # LICENSE: # # This work is made available to you under the terms of Version 2 of # the GNU General Public License. A copy of that license should have # been provided with this software, but in any event can be snarfed # from www.gnu.org. # # This work 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 this program; if not, write to the Free Software # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. # # # CONTRIBUTION SUBMISSION POLICY: # # (The following paragraph is not intended to limit the rights granted # to you to modify and distribute this software under the terms of # the GNU General Public License and is only of importance to you if # you choose to contribute your changes and enhancements to the # community by submitting them to Best Practical Solutions, LLC.) # # By intentionally submitting any modifications, corrections or # derivatives to this work, or any other work intended for use with # Request Tracker, to Best Practical Solutions, LLC, you confirm that # you are the copyright holder for those contributions and you grant # Best Practical Solutions, LLC a nonexclusive, worldwide, irrevocable, # royalty-free, perpetual, license to use, copy, create derivative # works based on those contributions, and sublicense and distribute # those contributions and any derivatives thereof. # # END BPS TAGGED BLOCK }}} package RT; use strict; use RT::I18N; use RT::CurrentUser; use RT::System; use vars qw($VERSION $System $SystemUser $Nobody $Handle $Logger $CORE_CONFIG_FILE $SITE_CONFIG_FILE $BasePath $EtcPath $VarPath $LocalPath $LocalEtcPath $LocalLexiconPath $LogDir $BinPath $MasonComponentRoot $MasonLocalComponentRoot $MasonDataDir $MasonSessionDir ); $VERSION = '@RT_VERSION_MAJOR@.@RT_VERSION_MINOR@.@RT_VERSION_PATCH@'; $CORE_CONFIG_FILE = "@CONFIG_FILE_PATH@/RT_Config.pm"; $SITE_CONFIG_FILE = "@CONFIG_FILE_PATH@/RT_SiteConfig.pm"; @DATABASE_ENV_PREF@ $BasePath = '@RT_PATH@'; $EtcPath = '@RT_ETC_PATH@'; $BinPath = '@RT_BIN_PATH@'; $VarPath = '@RT_VAR_PATH@'; $LocalPath = '@RT_LOCAL_PATH@'; $LocalEtcPath = '@LOCAL_ETC_PATH@'; $LocalLexiconPath = '@LOCAL_LEXICON_PATH@'; # $MasonComponentRoot is where your rt instance keeps its mason html files $MasonComponentRoot = '@MASON_HTML_PATH@'; # $MasonLocalComponentRoot is where your rt instance keeps its site-local # mason html files. $MasonLocalComponentRoot = '@MASON_LOCAL_HTML_PATH@'; # $MasonDataDir Where mason keeps its datafiles $MasonDataDir = '@MASON_DATA_PATH@'; # RT needs to put session data (for preserving state between connections # via the web interface) $MasonSessionDir = '@MASON_SESSION_PATH@'; =head1 NAME RT - Request Tracker =head1 SYNOPSIS A fully featured request tracker package =head1 DESCRIPTION =head2 LoadConfig Load RT's config file. First, the site configuration file (C) is loaded, in order to establish overall site settings like hostname and name of RT instance. Then, the core configuration file (C) is loaded to set fallback values for all settings; it bases some values on settings from the site configuration file. In order for the core configuration to not override the site's settings, the function C is used; it only sets values if they have not been set already. =cut sub LoadConfig { local *Set = sub { $_[0] = $_[1] unless defined $_[0] }; if ( -f "$SITE_CONFIG_FILE" ) { require $SITE_CONFIG_FILE || die ("Couldn't load RT config file '$SITE_CONFIG_FILE'\n$@"); } require $CORE_CONFIG_FILE || die ("Couldn't load RT config file '$CORE_CONFIG_FILE'\n$@"); RT::I18N->Init; } =head2 Init Conenct to the database, set up logging. =cut sub Init { #Get a database connection ConnectToDatabase(); #RT's system user is a genuine database user. its id lives here $SystemUser = new RT::CurrentUser(); $SystemUser->LoadByName('RT_System'); #RT's "nobody user" is a genuine database user. its ID lives here. $Nobody = new RT::CurrentUser(); $Nobody->LoadByName('Nobody'); $System = RT::System->new(); InitClasses(); InitLogging(); } =head2 ConnectToDatabase Get a database connection =cut sub ConnectToDatabase { require RT::Handle; unless ($Handle && $Handle->dbh && $Handle->dbh->ping) { $Handle = RT::Handle->new(); } $Handle->Connect(); } =head2 InitLogging Create the RT::Logger object. =cut sub InitLogging { # We have to set the record separator ($, man perlvar) # or Log::Dispatch starts getting # really pissy, as some other module we use unsets it. $, = ''; use Log::Dispatch 1.6; unless ($RT::Logger) { $RT::Logger=Log::Dispatch->new(); if ($RT::LogToFile) { my ($filename, $logdir); if ($RT::LogToFileNamed =~ m![/\\]!) { # looks like an absolute path. $filename = $RT::LogToFileNamed; ($logdir) = $RT::LogToFileNamed =~ m!^(.*[/\\])!; } else { $filename = "$RT::LogDir/$RT::LogToFileNamed"; $logdir = $RT::LogDir; } unless ( -d $logdir && ( ( -f $filename && -w $filename ) || -w $logdir ) ) { # localizing here would be hard when we don't have a current user yet # die $self->loc("Log directory [_1] not found or couldn't be written.\n RT can't run.", $RT::LogDir); die ("Log file $filename couldn't be written or created.\n RT can't run."); } package Log::Dispatch::File; require Log::Dispatch::File; $RT::Logger->add(Log::Dispatch::File->new ( name=>'rtlog', min_level=> $RT::LogToFile, filename=> $filename, mode=>'append', callbacks => sub { my %p = @_; my ($package, $filename, $line) = caller(5); return "[".gmtime(time)."] [".$p{level}."]: $p{message} ($filename:$line)\n"} )); } if ($RT::LogToScreen) { package Log::Dispatch::Screen; require Log::Dispatch::Screen; $RT::Logger->add(Log::Dispatch::Screen->new ( name => 'screen', min_level => $RT::LogToScreen, callbacks => sub { my %p = @_; my ($package, $filename, $line) = caller(5); return "[".gmtime(time)."] [".$p{level}."]: $p{message} ($filename:$line)\n" }, stderr => 1 )); } if ($RT::LogToSyslog) { package Log::Dispatch::Syslog; require Log::Dispatch::Syslog; $RT::Logger->add(Log::Dispatch::Syslog->new ( name => 'syslog', ident => 'RT', min_level => $RT::LogToSyslog, callbacks => sub { my %p = @_; my ($package, $filename, $line) = caller(5); # syswrite() cannot take utf8; turn it off here. Encode::_utf8_off($p{message}); if ($p{level} eq 'debug') { return "$p{message}\n" } else { return "$p{message} ($filename:$line)\n"} }, stderr => 1, @RT::LogToSyslogConf )); } } # {{{ Signal handlers ## This is the default handling of warnings and die'ings in the code ## (including other used modules - maybe except for errors catched by ## Mason). It will log all problems through the standard logging ## mechanism (see above). $SIG{__WARN__} = sub { my $w = shift; $w =~ s/(?:\r*\n)+$//; # The 'wide character' warnings has to be silenced for now, at least # until HTML::Mason offers a sane way to process both raw output and # unicode strings. $RT::Logger->warning($w) if index($w, 'Wide character in ') != 0; }; #When we call die, trap it and log->crit with the value of the die. $SIG{__DIE__} = sub { unless ($^S || !defined $^S ) { $RT::Handle->Rollback(); $RT::Logger->crit("$_[0]"); exit(-1); } else { #Get out of here if we're in an eval die $_[0]; } }; # }}} } =head2 InitClasses Load all modules that define base classes =cut sub InitClasses { require RT::Tickets; require RT::Transactions; require RT::Users; require RT::CurrentUser; require RT::Templates; require RT::Queues; require RT::ScripActions; require RT::ScripConditions; require RT::Scrips; require RT::Groups; require RT::GroupMembers; require RT::CustomFields; require RT::CustomFieldValues; require RT::ObjectCustomFields; require RT::ObjectCustomFieldValues; } # }}} sub SystemUser { return($SystemUser); } sub Nobody { return ($Nobody); } =head1 BUGS Please report them to rt-bugs@fsck.com, if you know what's broken and have at least some idea of what needs to be fixed. If you're not sure what's going on, report them rt-devel@lists.bestpractical.com. =head1 SEE ALSO L L =begin testing ok ($RT::Nobody->Name() eq 'Nobody', "Nobody is nobody"); ok ($RT::Nobody->Name() ne 'root', "Nobody isn't named root"); ok ($RT::SystemUser->Name() eq 'RT_System', "The system user is RT_System"); ok ($RT::SystemUser->Name() ne 'noname', "The system user isn't noname"); =end testing =cut eval "require RT_Local"; die $@ if ($@ && $@ !~ qr{^Can't locate RT_Local.pm}); 1;