Installing Webmin on Windows

From Webmin Documentation
Jump to: navigation, search

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.

Requirements and Optional Programs

  • ActiveState Perl 5.8.8 or earlier (required) 5.10 or newer will not work.
  • 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

Optional software

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

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.