Installing the Usermin tar.gz file

Before downloading Usermin, you must already have Perl 5 installed on your system. Perl is usually installed as /usr/local/bin/perl or /usr/bin/perl, and comes as part of most recent versions of Linux. If you don't have Perl, you can download the source from http://www.perl.com/ and compile it for your system. Most operating systems come with Perl these days, so check your operating system CD or website for a package as well.

To download the Usermin tar.gz package, either follow the link on the downloads page , or run commands like : [root@yourhost /]# cd /tmp
[root@yourhost /tmp]# wget http://prdownloads.sourceforge.net/webadmin/usermin-1.610.tar.gz

When unpacked, the distribution creates a subdirectory called usermin-1.610 under the current directory. Since recent versions of Usermin support installation into a directory of your choice, you can pick a destination directory such as /usr/local/usermin. Then run the following commands in the directory containing the usermin-1.610.tar.gz file : [root@yourhost /tmp]# gunzip usermin-1.610.tar.gz
[root@yourhost /tmp]# tar xf usermin-1.610.tar
[root@yourhost /tmp]# cd usermin-1.610
[root@yourhost /tmp/usermin-1.610]# ./setup.sh /usr/local/usermin

When the setup.sh script is run, it will ask the following questions :

  • The Usermin configuration directory
    The directory in which all Usermin configuration information is stored. This is now separate from the Usermin install directory, so that configurations are saved when you upgrade.
    If you have previously installed Usermin and use the same config directory, this will be the only question asked.

  • The Usermin log directory
    The location for pid and webserver log files.

  • The full path to perl on your system
    This is usually /usr/bin/perl or /usr/local/bin/perl

  • Your Operating system type
    This question is only asked if your operating system cannot be automatically determined.
    The setup script will display a list of supported systems. If your OS is not on the list, you can try choosing the closest match. However this may not work properly, and may even cause serious problems!

  • Web server port
    The TCP port that the Usermin web server will listen on.

  • Web server hostname
    The hostname of the machine on which Usermin will run.

  • Use SSL
    This question will only be asked if your system has the Perl SSL libraries installed. See below for more..

Assuming you answer all the above questions correctly, the Usermin web server will be started and the setup script will give you the URL to go to. Enter this URL into your browser, and you will be prompted for a login and password. You should be able to login as any valid Unix user on your system.

If you installed Usermin by specifying an installation directory parameter to setup.sh as the instructions above show, the original usermin-1.610 directory can now be safely deleted.

Supported Operating Systems

The TAR package of Usermin can be installed on any one of the supported operating systems, such as HP/UX, AIX, FreeBSD, and all flavours of Linux. However, if your OS does not support PAM and does not have a regular /etc/passwd or /etc/shadow file, the it may be impossible to login.