Installation Troubleshooting

This page lists common installation issues and recommended solutions :

* **Install script fails**
The most common cause of installation failures is problems downloading packages. If this happens, check the following :
1. Can you Cloudmin master system access to download packages via HTTP? If it is blocked by a firewall, the install will fail.
1. Is your system's YUM or APT configuration file up to date? If /etc/yum.repos.d is missing files or /etc/apt/sources.list is in-complete, some required packages may not be found.

* **Cannot Login as root**
This can happen if your system doesn't have a root password set, perhaps because authentication is done via an SSH key. To set a password on CentOS, Fedora or Redhat Enterprise, use the command :

/usr/libexec/webmin/ /etc/webmin root mynewpassword

Or on Debian or Ubuntu, run :

/usr/share/webmin/ /etc/webmin root mynewpassword

* **Perl module install fails**
If the install script reports that a Perl module has failed to install, try it manually from the shell with a command like :

perl -MCPAN -e 'install Net::SSLeay'

Assuming Net::SSLeay was the module that failed. The cause may be missing dependencies such as C development libraries that Cloudmin cannot automatically install.