view release on metacpan or  search on metacpan

examples/admin/README  view on Meta::CPAN

USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.


Installation
------------

  - Create the MySQL tables:

        CREATE TABLE USERS (
            USER VARCHAR(20) NOT NULL,
            UID INT PRIMARY KEY NOT NULL AUTO_INCREMENT,
            REALNAME VARCHAR(20) NOT NULL,
            SHELL VARCHAR(20) NOT NULL,
            HOMEDIR VARCHAR(40) NOT NULL,
            PASSWORD VARCHAR(20) NOT NULL,
            ALIASES VARCHAR(255),
            FORWARD VARCHAR(80),
            CUSTOM VARCHAR(80)
        )
        ALTER TABLE USERS ADD UNIQUE USER_INDEX (USER)

        CREATE TABLE GROUPS (
            GROUPNAME VARCHAR(20) NOT NULL,
            MEMBER VARCHAR(20) NOT NULL
        )

  - Adjust the DBI DSN, user and password settings in the files of this
    directory.
  - Create a password protected directory in your WWW server, /admin
    say.
  - Move the files index.ep, user.ep, group.ep, rmuser.ep and
    rmgroup.ep to that directory.
  - If you are not using Red Hat Linux, carefully inspect the script
    usersModified whether it is acceptable for your local systems.
    In particular you should verify that

	* the path settings at the top are correct
	* it is safe to assume UID's >600 being free on your machine,
          otherwise change the respective values in user.ep
	* the program chpasswd is present and supports a

		echo <unencrypted_password> | chpasswd <user>

	* the commands

		useradd -c <realname> -d <homedir> -u <uid>
			-s <shell> <username>
		userdel -c <username>

	  are supportted.


  - Move the script "usersModified" to /usr/local/bin and make it
    suid root:

	mv usersModified /usr/local/bin
	chown root /usr/local/bin/usersModified
	chgrp root /usr/local/bin/usersModified
	chmod 4755 /usr/local/bin/usersModified

  - That's it!


Author and Copyright
--------------------

    This program is

        Copyright (C) 1998    Jochen Wiedmann
                              Am Eisteich 9
                              72555 Metzingen
                              Germany

                              Phone: +49 7123 14887
                              Email: joe@ispsoft.de

    All rights reserved.

    You may distribute this module under the terms of either the GNU General
    Public License or the Artistic License, as specified in the Perl README
    file.