Keystone Frequently Asked Questions
$Id: FAQ,v 1.4 1998/07/17 04:26:31 shevett Exp $
$Name: keystone-0_22_02 $
---------------------------------------------------------------------
Q: In PTS, there were projects and tasks.  Now there are just slips.
	What gives?
A: Correct.  Keystone makes no distinction between a task with 
	subtasks, and a project.  The seperation of them in PTS was a 
	limitation, since tasks couldn't have children, etc.

	Any slip can have child slips, that can be dependent on the 
	closing of another task, or have child tasks of their own.  Rules
	for how child tasks react to what happens to their parents are
	still in the works.


Q: What is a Filter?
A: A filter is a certain rule applied to a table that can limit the 
	number of rows you see from that table.  For instance, you can set a
	filter to only show you open slips, or ones you opened, or ones opened
	by a certain technician between two dates. 

	Filters can be set up by the system adminstrator, so any user can 
	select one of tyhe publically defined filters, or users can generate
	their own.  Filters may be turned on and off by just clicking on the 
	'ON' or 'OFF' graphic next to the 'Filters are...' pick on the menu.

	To view/add/edit filters, select 'Filters' under the 'Other' menu.


Q: I added in a new user, but they can't log in?  What gives?
A: The tool used to add users is a generic table browser, and knows 
	nothing about encrypted passwords.  It stored the password away for
	the user without encrypting it.  Go to the Maintenance functions,
	and click on 'Change Password'.  Change the username to the name
	of the user just added, and type in their new password.  This will
	encrypt their password and store it in the table.


Q: When I'm installing Keystone for the first time, I'm able to see the
	login screen, but anything after that either comes up with a 'not
	logged in' screen, or a 'mysql' error, or the like.
A: There are many reasons this can happen.  The first is that PHP is
	not configured properly, or MySQL hasn't been configured right.  RUn
	down this checklist to confirm your installation:
	1) create a file called 'test.php3', and put <? phpinfo() ?> in it.
		Point your web browser at it, and make sure you have the database
		support you need in it.
	2) Make sure you have the 'keystone' database created in your system,
		and that your server has all the tables required from the 'struct'
		directory.
	3) Keystone 0.10.07 has more robust error messages in it.  Run that,
		and see if you're getting database errors.


Q: I've installed MySQL, but I keep getting "you have no permission to
	access this table" or some similar security issue.  How do I 
	get it working?
A: MySQL is very touchy about access configurations in its 'grant' tables,
	and they can be very difficult to get right.  If your security
	model allows it, try running 'mysqld' with '--skip-grant-tables'.
	If that works, then everything but your grant tables is configured
	properly.

	Another issue that comes up is that the MIT pthreads library 
	frequently doesn't allow 'localhost' as a target host for the connect
	function.  Put in a FQDN, and try again.


Q: Every once in a while Keystone won't expand or collapse views
	of slips anymore.  No matter what I do, I can't seem to look at
	a new slip in expanded form.  What gives?
A: Unfortunately, this is a known bug.  It has to do with how data
	is stored in the 'state' table.  As of Version 0.21.00, there
	is no programmatical fix, but there is a step to take to 
	restore functionality.  Run up your mysql command line, and
	type:

		update state set explist='' where uid='login'

	change 'login' to whichever login id is having the problem.		
