User database helpers
---------------------

For the 2.0 release of the server, the DBM format was switched from NDBM 
format to Berkeley DB format.  This was done to help cross-platform 
consistency.  The program, cvuser, is provided to convert from either
the Netsite 1.1 NDBM database format or NCSA-style text file format to
the 2.0 Berkeley DB format.  Use "cvuser -h" to see the command options.
Using cvuser, you can set up a cron job to regularly update a 2.01 server
user database from another database.

Note that cvuser requires the services of another program, ndbmdump, which
converts a Netsite 1.1 NDBM database to NCSA-style text format.  ndbmdump
should be in your PATH whenever you use cvuser.

There are also a number of utilities included for managing a 2.0 database
from a command line:

    mkuser - used to create a new user
    chuser - used to modify an existing user entry
    rmuser - used to remove an existing user
    shuser - used to display one or more user entries

    mkgroup - used to create a new group
    chgroup - used to modify an existing group, including adding or
              removing user or group members
    rmgroup - used to remove an existing group
    shgroup - used to show one or more group entries

There is also an example HTML page (changepw.htm) and CGI program 
(changepw.cgi) to allow users to change their own passwords.  The HTML page
has a hidden form element defining where the database is - be sure to 
change it to match your database.  You can also recompile the CGI program
to hardcode where the database is if you'd rather do that.  Be sure to give
it a database name without the filename extension.  The form asks for the 
person's username, but if the form is in an area that is already protected 
by authorization, it can get that information from the environment as well.  
The form still asks for the old password for security.  The CGI program
uses the command-line utilities, shuser and chuser, to verify the old
password and set the new one.  These utilities must be installed in the
same directory as the CGI program (changepw.cgi).

Enjoy!
--
Copyright 1995-96 Netscape Communications Corporation, all rights reserved
