305a7218e6
known outstanding doc bug! Yay release. Still many things to fix. Aren't there always? git-svn-id: svn://10.0.0.236/trunk@101604 18797224-902f-48f8-a5cc-f745e15eee43
781 lines
14 KiB
HTML
781 lines
14 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>User Administration</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
|
|
"><LINK
|
|
REL="HOME"
|
|
TITLE="The Bugzilla Guide"
|
|
HREF="index.html"><LINK
|
|
REL="UP"
|
|
TITLE="Administering Bugzilla"
|
|
HREF="administration.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Post-Installation Checklist"
|
|
HREF="postinstall-check.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Product, Component, Milestone, and Version
|
|
Administration"
|
|
HREF="programadmin.html"></HEAD
|
|
><BODY
|
|
CLASS="SECTION"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>The Bugzilla Guide</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="postinstall-check.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
>Chapter 4. Administering Bugzilla</TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="programadmin.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H1
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="USERADMIN"
|
|
>4.2. User Administration</A
|
|
></H1
|
|
><P
|
|
> User administration is one of the easiest parts of Bugzilla.
|
|
Keeping it from getting out of hand, however, can become a
|
|
challenge.
|
|
</P
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H2
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="DEFAULTUSER"
|
|
>4.2.1. Creating the Default User</A
|
|
></H2
|
|
><P
|
|
> When you first run checksetup.pl after installing Bugzilla, it
|
|
will prompt you for the administrative username (email
|
|
address) and password for this "super user". If for some
|
|
reason you were to delete the "super user" account, re-running
|
|
checksetup.pl will again prompt you for this username and
|
|
password.
|
|
</P
|
|
><DIV
|
|
CLASS="TIP"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="TIP"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/tip.gif"
|
|
HSPACE="5"
|
|
ALT="Tip"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> If you wish to add more administrative users, you must use the
|
|
MySQL interface. Run "mysql" from the command line, and use
|
|
these commands ("mysql>" denotes the mysql prompt, not
|
|
something you should type in):
|
|
<B
|
|
CLASS="COMMAND"
|
|
><TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
> use bugs;</B
|
|
>
|
|
<B
|
|
CLASS="COMMAND"
|
|
><TT
|
|
CLASS="PROMPT"
|
|
>mysql></TT
|
|
> update profiles set
|
|
groupset=0x7ffffffffffffff where login_name = "(user's
|
|
login name)"; </B
|
|
>
|
|
</P
|
|
><P
|
|
>Yes, that is <EM
|
|
>fourteen</EM
|
|
>
|
|
<SPAN
|
|
CLASS="QUOTE"
|
|
>"f"</SPAN
|
|
>'s. A whole lot of f-ing going on if you
|
|
want to create a new administator.</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H2
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="MANAGEUSERS"
|
|
>4.2.2. Managing Other Users</A
|
|
></H2
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H3
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="LOGIN"
|
|
>4.2.2.1. Logging In</A
|
|
></H3
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
> Open the index.html page for your Bugzilla installation
|
|
in your browser window.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Click the "Query Existing Bug Reports" link.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Click the "Log In" link at the foot of the page.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Type your email address, and the password which was
|
|
emailed to you when you created your Bugzilla account,
|
|
into the spaces provided.
|
|
</P
|
|
></LI
|
|
></OL
|
|
><P
|
|
>Congratulations, you are logged in!</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H3
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="CREATENEWUSERS"
|
|
>4.2.2.2. Creating new users</A
|
|
></H3
|
|
><P
|
|
> Your users can create their own user accounts by clicking
|
|
the "New Account" link at the bottom of each page. However,
|
|
should you desire to create user accounts ahead of time,
|
|
here is how you do it.
|
|
</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
> After logging in, click the "Users" link at the footer
|
|
of the query page.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> To see a specific user, type a portion of their login
|
|
name in the box provided and click "submit". To see all
|
|
users, simply click the "submit" button. You must click
|
|
"submit" here to be able to add a new user.
|
|
</P
|
|
><DIV
|
|
CLASS="TIP"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="TIP"
|
|
WIDTH="90%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/tip.gif"
|
|
HSPACE="5"
|
|
ALT="Tip"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> More functionality is available via the list on the
|
|
right-hand side of the text entry box. You can match
|
|
what you type as a case-insensitive substring (the
|
|
default) of all users on your system, a case-sensitive
|
|
regular expression (please see the <B
|
|
CLASS="COMMAND"
|
|
>man
|
|
regexp</B
|
|
> manual page for details on regular
|
|
expression syntax), or a <EM
|
|
>reverse</EM
|
|
>
|
|
regular expression match, where every user name which
|
|
does NOT match the regular expression is selected.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Click the "Add New User" link at the bottom of the user
|
|
list
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Fill out the form presented. This page is
|
|
self-explanatory. When done, click "submit".
|
|
</P
|
|
><DIV
|
|
CLASS="NOTE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="NOTE"
|
|
WIDTH="90%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/note.gif"
|
|
HSPACE="5"
|
|
ALT="Note"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> Adding a user this way will <EM
|
|
>not</EM
|
|
>
|
|
send an email informing them of their username and
|
|
password. While useful for creating dummy accounts
|
|
(watchers which shuttle mail to another system, for
|
|
instance, or email addresses which are a mailing
|
|
list), in general it is preferable to log out and use
|
|
the <SPAN
|
|
CLASS="QUOTE"
|
|
>"New Account"</SPAN
|
|
> button to create users,
|
|
as it will pre-populate all the required fields and
|
|
also notify the user of her account name and
|
|
password.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></LI
|
|
></OL
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H3
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="DISABLEUSERS"
|
|
>4.2.2.3. Disabling Users</A
|
|
></H3
|
|
><P
|
|
> I bet you noticed that big "Disabled Text" entry box
|
|
available from the "Add New User" screen, when you edit an
|
|
account? By entering any text in this box and selecting
|
|
"submit", you have prevented the user from using Bugzilla
|
|
via the web interface. Your explanation, written in this
|
|
text box, will be presented to the user the next time she
|
|
attempts to use the system.
|
|
<DIV
|
|
CLASS="WARNING"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="WARNING"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/warning.gif"
|
|
HSPACE="5"
|
|
ALT="Warning"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> Don't disable your own administrative account, or you
|
|
will hate life!
|
|
</P
|
|
><P
|
|
>At this time, <SPAN
|
|
CLASS="QUOTE"
|
|
>"Disabled Text"</SPAN
|
|
> does not
|
|
prevent a user from using the email interface. If you
|
|
have the email interface enabled, they can still
|
|
continue to submit bugs and comments that way. We need
|
|
a patch to fix this.</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECTION"
|
|
><H3
|
|
CLASS="SECTION"
|
|
><A
|
|
NAME="MODIFYUSERS"
|
|
>4.2.2.4. Modifying Users</A
|
|
></H3
|
|
><P
|
|
> Here I will attempt to describe the function of each option
|
|
on the Edit User screen.
|
|
</P
|
|
><P
|
|
></P
|
|
><UL
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Login Name</EM
|
|
>: This is generally the
|
|
user's email address. However, if you have edited your
|
|
system parameters, this may just be the user's login
|
|
name or some other identifier.
|
|
<DIV
|
|
CLASS="TIP"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="TIP"
|
|
WIDTH="90%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/tip.gif"
|
|
HSPACE="5"
|
|
ALT="Tip"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> For compatability reasons, you should probably stick
|
|
with email addresses as user login names. It will
|
|
make your life easier.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Real Name</EM
|
|
>: Duh!
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Password</EM
|
|
>: You can change the user
|
|
password here. It is normal to only see asterisks.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Email Notification</EM
|
|
>: You may choose
|
|
from one of three options:
|
|
<P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
> All qualifying bugs except those which I change:
|
|
The user will be notified of any change to any bug
|
|
for which she is the reporter, assignee, QA
|
|
Contact, CC recipient, or "watcher".
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> Only those bugs which I am listed on the CC line:
|
|
The user will not be notified of changes to bugs
|
|
where she is the assignee, reporter, or QA
|
|
Contact, but will receive them if she is on the CC
|
|
list.
|
|
<DIV
|
|
CLASS="NOTE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="NOTE"
|
|
WIDTH="90%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/note.gif"
|
|
HSPACE="5"
|
|
ALT="Note"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> She will still receive whining cron emails if
|
|
you set up the "whinemail" feature.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>All Qualifying Bugs</EM
|
|
>: This
|
|
user is a glutton for punishment. If her name is
|
|
in the reporter, QA Contact, CC, assignee, or is a
|
|
"watcher", she will get email updates regarding
|
|
the bug.
|
|
</P
|
|
></LI
|
|
></OL
|
|
></P
|
|
><P
|
|
> <EM
|
|
>Disable Text</EM
|
|
>: If you type anything
|
|
in this box, including just a space, the user account is
|
|
disabled from making any changes to bugs via the web
|
|
interface, and what you type in this box is presented as
|
|
the reason.
|
|
<DIV
|
|
CLASS="WARNING"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="WARNING"
|
|
WIDTH="90%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/warning.gif"
|
|
HSPACE="5"
|
|
ALT="Warning"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
>Don't disable the administrator account!</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
<DIV
|
|
CLASS="NOTE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="NOTE"
|
|
WIDTH="90%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/note.gif"
|
|
HSPACE="5"
|
|
ALT="Note"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> As of this writing, the user can still submit bugs
|
|
via the e-mail gateway, if you set it up, despite
|
|
the disabled text field. The e-mail gateway should
|
|
<EM
|
|
>not</EM
|
|
> be enabled for secure
|
|
installations of Bugzilla.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>CanConfirm</EM
|
|
>: This field is only used
|
|
if you have enabled "unconfirmed" status in your
|
|
parameters screen. If you enable this for a user, that
|
|
user can then move bugs from "Unconfirmed" to
|
|
"Confirmed" status (e.g.: "New" status). Be judicious
|
|
about allowing users to turn this bit on for other
|
|
users.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Creategroups</EM
|
|
>: This option will
|
|
allow a user to create and destroy groups in Bugzilla.
|
|
Unless you are using the Bugzilla GroupSentry security
|
|
option "usebuggroupsentry" in your parameters, this
|
|
setting has no effect.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Editbugs</EM
|
|
>: Unless a user has this
|
|
bit set, they can only edit those bugs for which they
|
|
are the assignee or the reporter.
|
|
<DIV
|
|
CLASS="NOTE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="NOTE"
|
|
WIDTH="90%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/note.gif"
|
|
HSPACE="5"
|
|
ALT="Note"></TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> Leaving this option unchecked does not prevent users
|
|
from adding comments to a bug! They simply cannot
|
|
change a bug priority, severity, etc. unless they
|
|
are the assignee or reporter.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
>
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Editcomponents</EM
|
|
>: This flag allows a
|
|
user to create new products and components, as well as
|
|
modify and destroy those that have no bugs associated
|
|
with them. If a product or component has bugs
|
|
associated with it, those bugs must be moved to a
|
|
different product or component before Bugzilla will
|
|
allow them to be destroyed. The name of a product or
|
|
component can be changed without affecting the
|
|
associated bugs, but it tends to annoy the hell out of
|
|
your users when these change a lot.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Editkeywords</EM
|
|
>: If you use Bugzilla's
|
|
keyword functionality, enabling this feature allows a
|
|
user can create and destroy keywords. As always, the
|
|
keywords for existing bugs containing the keyword the
|
|
user wishes to destroy must be changed before Bugzilla
|
|
will allow it to die. You must be very careful about
|
|
creating too many new keywords if you run a very large
|
|
Bugzilla installation; keywords are global variables
|
|
across products, and you can often run into a phenomenon
|
|
called "keyword bloat". This confuses users, and then
|
|
the feature goes unused.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>Editusers</EM
|
|
>: This flag allows a user
|
|
do what you're doing right now: edit other users. This
|
|
will allow those with the right to do so to remove
|
|
administrator priveleges from other users or grant them
|
|
to themselves. Enable with care.
|
|
</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
> <EM
|
|
>PRODUCT</EM
|
|
>: PRODUCT bugs access. This
|
|
allows an administrator, with product-level granularity,
|
|
to specify in which products a user can edit bugs. The
|
|
user must still have the "editbugs" privelege to edit
|
|
bugs in this area; this simply restricts them from even
|
|
seeing bugs outside these boundaries if the
|
|
administrator has enabled the group sentry parameter
|
|
"usebuggroupsentry". Unless you are using bug groups,
|
|
this option has no effect.
|
|
</P
|
|
></LI
|
|
></UL
|
|
></DIV
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="postinstall-check.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="programadmin.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Post-Installation Checklist</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="administration.html"
|
|
>Up</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Product, Component, Milestone, and Version
|
|
Administration</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |