Webmin & Usermin installation on OS X

June 17, 2010 by admin
Filed under Webmin

Installing Webmin and Usermin on OS X

These instructions, contributed by Kevin Capwell, will allow you to install webmin on any Apple Macintosh OS X server. The version that I was using is as follows:

Server: 10.3
Perl: 5.8.1-RC3 to see version open terminal cd /usr/bin then type perl –version
OpenSSL: 0.9.7b to see version open terminal cd /usr/bin then type OpenSSL version

PART ONE :: PREPARATION

INSTALL DEVELOPER TOOLS

Go to https://connect.apple.com/ and become a member of ADC – it’s free!
Click on ‘Download Software’.
Click on ‘Developer Tools’.
Download the Xcode Tools v1.0 and 1.0.1 update. As of this writing download the Xcode CD is in 20 parts, however, Xcode should come with your box copy of 10.3.
Click twice on the Xcode.dmg icon.
Click twice on the ‘Developer’ package.
Enter your administrator password when you are prompted.
After selecting the drive to install the developer tools, then click the ‘Customize’ button. Make sure the check the BSD SDK option.
Perform the install.

INSTALL THE NET_SSLEAY.PM

Download and install the Perl Mod “Net::SSLeay”
Go to the web page http://www.cpan.org/modules/by-module/Net/
Download the ‘Net_SSLeay.pm-1.25.tar.gz’ this version was tested with the perl and openssh that are installed with 10.3. In my case this is Perl 5.8.1 and OpenSSL 0.9.7b (to see your versions look at the commands above)
I copied the Net_SSLeay.pm-1.25.tar.gz to /usr/local. Then run

tar -zxvf Net_ssleay.pm-1.25.tar.gz

cd Net_ssleay.pm-1.25

perl Makefile.PL -t

You should see a successful install message.
Issue the

sudo -s

command – enter your admin password. You should now see a root# prompt at the beginning of each line you type. type & enter:

make install

If the following command doesn’t output any error message, then the ssl support that webmin needs is properly installed.

perl -e ‘use Net::ssleay

INSTALL THE AUTHEN_PAM.PM

Download and install the Perl Mod “Authen::PAM”
Go to the web page http://www.cpan.org/modules/by-module/Authen/
Download the ‘Authen-PAM-0.15.tar.gz’ file
I copied the Authen-PAM-0.15.tar.gz to /usr/local

tar -zxvf Authen-PAM-0.15.tar.gz
cd Authen-PAM-0.15
perl Makefile.PL -t

You should see a successful install message. Issue the following command (without the quotes) – enter your admin password. You should now see a root# prompt at the beginning of each line you type.

sudo -s

make install

PART TWO :: INSTALLATION

INSTALL WEBMIN

Go to http://www.webmin.com/download.html download the current Unix tar/gzip version.
I copied the webmin-1.510.tar.gz to /usr/local. Run following command

tar -zxvf webmin-1.510.tar.gz
cd webmin-1.510
./setup.sh

Accept defaults for config and log file directory (one return for each will do).
Accept the default path to perl (it should test ok).
Accept the default port for webmin (port 10000).
Login name can be anything you want (the default is admin).
Login password can be anything you want. Then you will be asked to verify the password.
If you followed the instructions above correctly you will be prompted with ‘Use SSL (y/n):’ you can now answer Y. This will encrypt your connections with the Xserve.
Answer Y to Start Webmin at boot time.
After the install is complete, copy the file pam-webmin to /etc/pam.d/webmin and re-start Webmin with

/etc/webmin/stop

/etc/webmin/start

This will enable PAM authentication, if you need it.

If everything installs correctly you will see ‘Webmin has been installed and started successfully. Use your web browser to go to:

https://<your server name or IP address>:10000

and login with the name and password that you entered previously.

INSTALL USERMIN

Go to http://www.webmin.com/udownload.html download the current Unix tar/gzip version.
I copied the usermin-1.440.tar.gz to /usr/local. Then run the following commands:

tar -zxvf usermin-1.440.tar.gz
cd usermin-1.440
./setup.sh

Accept defaults for config and log file directory (one return for each will do).
Accept the default path to perl (it should test ok).
Accept the default port for webmin (port 20000).
If you followed the instructions above correctly you will be prompted with ‘Use SSL (y/n):’ you can now answer Y. This will encrypt your connections with the Xserve.
After the install is complete, copy the file pam-usermin to /etc/pam.d/usermin and re-start Usermin with /etc/webmin/stop ; /etc/webmin/start. This will enable PAM authentication for all users who login.
Usermin is useful for changing passwords and (optionally) reading mail. It is a terrific user tool with security built in. I highly recommend that you experiment with it for ease of use with your users.

You are done!