diff options
Diffstat (limited to 'docs/html/useradmin.html')
| -rw-r--r-- | docs/html/useradmin.html | 589 |
1 files changed, 589 insertions, 0 deletions
diff --git a/docs/html/useradmin.html b/docs/html/useradmin.html new file mode 100644 index 000000000..2e49e532f --- /dev/null +++ b/docs/html/useradmin.html @@ -0,0 +1,589 @@ +<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 3. 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" +>3.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" +>3.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" +><BLOCKQUOTE +CLASS="TIP" +><P +><B +>Tip: </B +> 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 +></BLOCKQUOTE +></DIV +></DIV +><DIV +CLASS="SECTION" +><H2 +CLASS="SECTION" +><A +NAME="MANAGEUSERS" +>3.2.2. Managing Other Users</A +></H2 +><DIV +CLASS="SECTION" +><H3 +CLASS="SECTION" +><A +NAME="LOGIN" +>3.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" +>3.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" +><BLOCKQUOTE +CLASS="TIP" +><P +><B +>Tip: </B +> 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 "man regexp" 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 +></BLOCKQUOTE +></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" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> Adding a user this way will <EM +>not</EM +> send an email + informing them of their username and password. + In general, it is preferable to log out and use the "New Account" + 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 +></BLOCKQUOTE +></DIV +></LI +></OL +></DIV +><DIV +CLASS="SECTION" +><H3 +CLASS="SECTION" +><A +NAME="DISABLEUSERS" +>3.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" +BORDER="1" +WIDTH="100%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> Don't disable your own administrative account, or you will hate life! + </P +></TD +></TR +></TABLE +></DIV +> + </P +></DIV +><DIV +CLASS="SECTION" +><H3 +CLASS="SECTION" +><A +NAME="MODIFYUSERS" +>3.2.2.4. Modifying Users</A +></H3 +><P +> Here I will attempt to describe the function of each option on the user edit 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" +><BLOCKQUOTE +CLASS="TIP" +><P +><B +>Tip: </B +> For compatability reasons, you should probably + stick with email addresses as user login names. It will make your life easier. + </P +></BLOCKQUOTE +></DIV +> + </P +></LI +><LI +><P +> <EM +>Real Name</EM +>: Duh! + </P +></LI +><LI +><P +> <EM +>Password</EM +>: You will only see asterisks in versions + of Bugzilla newer than 2.10 or early 2.11. You can change the user password here. + </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, Q/A 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 Q/A contact, but will receive them if she is on the CC list. + <DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> She will still receive whining cron emails if you set up the "whinemail" feature. + </P +></BLOCKQUOTE +></DIV +> + </P +></LI +><LI +><P +> <EM +>All Qualifying Bugs</EM +>: This user is a glutton for punishment. + If her name is in the reporter, Q/A 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" +BORDER="1" +WIDTH="90%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +>Don't disable the administrator account!</P +></TD +></TR +></TABLE +></DIV +> + <DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> 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 +></BLOCKQUOTE +></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 (ergo: "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" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> 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 +></BLOCKQUOTE +></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 +>
\ No newline at end of file |