Files
Mozilla/mozilla/webtools/litmus/INSTALL
zach%zachlipton.com 3c1dc52fd9 Two significant user authentication changes:
Bug 329250 - User permission groups. Creates several layers of admin
groups, including super-administrators, test run/test day administrators,
and product administrators, and restricts access to administrative
functions according to user group levels. Also adds auth tools to search
for users by group and to grant/revoke group permissions.

Added hooks for testcases to belong to security groups (much like
Bugzilla's group system) for future use.

Bug 314928 - Forgot Password feature. Allows users who have forgotten
their passwords to change them without intervention from the QA team.
Password change requests are authenticated by an email to the user and a
link they must follow to confirm their identity. Also adds Litmus::Mailer,
with general support for sending email from within Litmus for future email
features.

Also reinstated Memoization in a mod_perl-aware way for a few common
functions.


git-svn-id: svn://10.0.0.236/trunk@227557 18797224-902f-48f8-a5cc-f745e15eee43
2007-06-05 22:29:44 +00:00

57 lines
1.8 KiB
Plaintext
Executable File

= Litmus Installation Instructions =
== Required Perl Modules ==
Apache::DBI - if mod_perl is being used
CGI
Class::DBI
Class::DBI::mysql
Data::Dumper
Data::JavaScript
Date::Manip
File::Find
Getopt::Long;
HTML::StripScripts
HTML::StripScripts::Parser
JSON
Sys::Hostname
Template
Test::Harness
Text::Markdown
Time::HiRes
Time::Piece
Time::Piece::MySQL
Time::Seconds
XML::XPath
Also, note that 'sendmail' (or a mailer with a compatible command-line
interface) is required.
== Setting up the database ==
Run populatedb.pl. This will create a template configuration file,
'localconfig,' that contains variables to hold your database configuration
information. Edit the newly created 'localconfig' file with your database
configuration. Once 'localconfig' is populated with your database information,
run the populatedb.pl again to populate the initial products, locales, etc...
There is no UI at present for doing this.
Then just pop the whole thing into a directory where your web server can
get at it. Have fun!
To get yourself an administrator account, you'll need to load up Litmus in your
web browser and follow the link to create a new account. You'll have been
lucky enough to score user id number 1. Grant yourself admin rights by loading
up mysql, connecting to your Litmus database, and running the following command:
insert into user_group_map values ('1', '1');
From there, you can go into "Edit Users" in the web interface and grant
rights to any new users.
Note: After upgrading Litmus, it's a good idea to run populatedb.pl
again to pick up any schema changes that may have occured.
== Creating the first admin user ==
Click 'Log In' and create a new Litmus account. In the database, set 'is_admin' = 1 for the new user in the users table. That user will now have access to the admin functions of Litmus through the web interface.