Installing Webmin on Windows
What you need to have installed before you can run Webmin on Windows.
Note: | All install/testing was done on Windows XP with SP2 installed. |
Contents
Requirements and Optional Programs
- ActiveState Perl 5.8.8 or earlier (required) 5.10 or newer will not work. (Ed note: This has to be wrong. 5.10 is the current minimum version targeted by Webmin. This needs an explanation if it really needs an ancient version of Perl.)
- Cygwin (required)
- >>> GnuWin32 is broken DO NOT USE
- Process.exe (required)
- Win32::Daemon Perl module (required)
- Verify that sc.exe is installed. This is part of Windows XP, and may be found in the Windows Resource Kit on other versions of the OS. (required)
- Apache for windows
- Bind for windows
- MySQL for windows
- LDAP for windows
- PostgreSQL for windows
- OpenSSH for windows
- PHP for windows
- Python for windows
- Sendmail for windows
First install ActiveState Perl then follow below.
Install Win32::Daemon
Using ActiveState Perl type:
ppm install http://www.roth.net/perl/packages/win32-daemon.ppd
From the command prompt.
Install Net::SSLeay on WinXP
This is required for HTTPS connections.
Using ActiveState Perl type:
ppm install http://www.gossamer-threads.com/ppm/Net-SSLeay-1.22-5.8.0.ppd
From the command prompt.
Download OpenLDAP for Windows
This includes OpenSSL so if you don't need LDAP then use the GnuWin32 OpenSSL
For the Windows platform, ILEX has created this OpenLDAP for Windows distribution. It's a packaged version using Nullsoft NSIS and includes OpenLDAP, SASL, BDB, and OpenSSL. It supports LDAP, LDAPS and LDAP+TLS. The wizard guides you through the installation and permit the creation of the slapd.conf file, the database root, the certificates generation (CA+server), the system service installation and much more.
Note: | OpenLDAP can also be installed under Cygwin if you don't want to install this version. Read the HOWTO for this. |
Installing OpenSSL
OpenSSL is installed with GnuWin32
Setting up the Windows Environment Variables
You need to edit your windows environment -- THIS IS VERY IMPORTANT !!!
- Click on My Computer from the desktop and choose Properties
- Click on the Advanced tab
- At the bottom click on Environment Variables
- Make sure the Path variable has the following:
c:\Perl\bin\;c:\Program Files\OpenSSH\bin\;c:\bind-dns\bin\;c:\GnuWin32\bin\;c:\php\;c:\Python24
Software Links
Required software
- ActiveState Perl
- Cygwin
- Process.exe
- Win32::Daemon Perl module
Optional software
- OpenLDAP+OpenSSL for windows
- BIND for windows
- OpenSSH for windows
- Apache for windows
- MySql for windows
- PostgreSQL for windows
- PPM repositories
- OpenLDAP+OpenSSL for windows
- PHP for windows
- Python for windows
Sendmail port by Micro$oft
- This is a OLD sendmail version BUT if you are only sending mail then all you need to do is exec the binary file with the normal sendmail switches. The binaries are located under the msport/sendmail.8.6.9.nt/src/ directory.
- [sendmail 8.6.9]
Sendmail clones
CygWin also has the native port of sendmail which is usually the most recent version.
Other HOWTO docs
- Installing webmin under windows - !NOTE!! The webmin Windows Installer does not work sometimes.
- Installing PHP/Apache/MySQL under Windows
- Adding PPM repositories
Extra PPM repos
Type ppm-shell from the command prompt then add the following repos.
rep add DevelopHelp http://ppd.develop-help.com/ppd/
rep add Roth http://www.roth.net/perl/packages/
rep add PTK http://www.xray.mpe.mpg.de/~ach/ptk/ppm/
rep add Theory http://theoryx5.uwinnipeg.ca/ppmpackages/
rep add Dada http://dada.perl.it/PPM
rep add Jenda http://jenda.krynicky.cz/perl
rep add rto http://rto.dk/packages/
rep add OpenInteract http://openinteract.sourceforge.net/ppmpackages/
rep add GA http://ppm.gingerall.cz
rep add JMC http://homepage.eircom.net/~jmcnamara/perl
Known Issues
- Updating modules does not work. You will need to manually install any updated modules.
- Updating webmin does not work from the webmin configuration section
- DIFF utilities in the GnuWin32 is broken and logging changes for rollback will not work.
- Logging is not recommended at all on the windows platform.
- Installing as a Windows Service does not always work. I use FireDaemon to start/stop webmin instead.
- Creating self-signed SSL certs does not work. You will need to create them on a linux box and import them into webmin for SSL.
Manual install of modules
You will need to download the module and use winzip or any other tool to untar/unzip the module then once you have the module directory paste it into the MAIN directory where webmin is installed. In my case I installed webmin under c:/webmin
RPC calls
- Use FAST RPC calls for the windows platform when clustering.
Windows firewall blocks almost everything so RPC calls will fail. To fix this open 10+ ports from the start of where you told webmin to listen on. EG; https://localhost:10100 so open TCP ports from 10100-10111 -- if you used 10000 then open 10000-10011
Final note
You may need to reboot your win box after updating any Windows Environment Variables.