Webmin How To Guide
From Swivel Knowledgebase Wiki
Contents |
Overview
Webmin is a third party package present on Version 2 PINsafe Appliances. It has many administrative uses which are of particular use during a support incident, rather than day-to-day administration:
- Retrieving files from the PINsafe appliance;
- Inspecting the MySQL PINsafe database;
- Stopping or Starting services.
Webmin is often useful when it is not possible to get a connection using PuTTY or WinSCP over SSH, such as when access is restricted. For more information on using PuTTY and WinSCP, see the PuTTY How To Guide and WinSCP How To Guide.
This article describes how to login to Webmin on an appliance. To discover more about how Webmin can be used to support PINsafe, see the Common Uses for Webmin section below.
Prerequisites
- PINsafe version 2 appliance (hardware or virtual machine) with Webmin installed;
- Web browser to connect to the PINsafe server;
- Webmin login credentials.
Accessing Webmin
The default credentials are:
Username: admin Password: lockbox
The default URL for Webmin is:
https://192.168.0.35:10000/
(where 192.168.0.35 is replaced by your PINsafe appliance IP. By default a single appliance is 192.168.0.35 and primary and secondary appliances are by default 192.168.0.36 and 192.168.0.37 respectively).
Logging in
Using a Web browser, visit the URL given above (https://192.168.0.35:10000/) using the IP address or hostname you have assigned to your PINsafe appliance.
You should reach the following page, where you can enter the default credentials given above, to login:
Once logged in, you should see the following screen:
If for some reason you cannot establish a connection to the web page, then consult the Troubleshooting section below.
Troubleshooting
If you find that you cannot obtain Webmin access, check to see that Webmin is listening for connections. Login to the appliance via SSH using PuTTY (see the PuTTY How To Guide) and get to the command line:
Enter the following netstat command. If you return a result similar to this then you know that Webmin is installed and running.
[admin@appliance ~]# netstat -anp | grep 10000 tcp 0 0 0.0.0.0:10000 0.0.0.0:* LISTEN 3594/perl udp 0 0 0.0.0.0:10000 0.0.0.0:* 3594/perl [admin@appliance ~]#
If this returns nothing then it could indicate that Webmin is not installed. If this is the case try running the following commands to see if the package exists on the appliance:
[admin@appliance ~]# find /etc/ -iname webmin /etc/sysconfig/daemons/webmin /etc/pam.d/webmin /etc/webmin /etc/webmin/webmin /etc/rc.d/init.d/webmin [admin@appliance ~]#
Also:
[admin@appliance ~]# whereis webmin webmin: /etc/webmin /usr/libexec/webmin [admin@appliance ~]#
If you don't return a result, then it's likely that your appliance is too old to have Webmin installed. If you do return a result then you can use the following stop and start commands to get Webmin stopped and started:
[admin@appliance ~]# service webmin stop Stopping Webmin server in /usr/libexec/webmin [admin@appliance ~]# service webmin start
A further check of the listener will confirm if Webmin is now started:
[admin@appliance ~]# netstat -anp | grep 10000 tcp 0 0 0.0.0.0:10000 0.0.0.0:* LISTEN 3185/perl udp 0 0 0.0.0.0:10000 0.0.0.0:* 3185/perl [admin@appliance ~]#
If you're not bringing up anything via a Web Browser check that there are no firewalls between you and the PINsafe appliance which could be obstructing access. Try the following command to reveal the PINsafe firewall entries, to ensure that the PINsafe appliance is allowing access to the Webmin listener:
[admin@appliance ~]# cat /etc/sysconfig/iptables
This will produce the following output.
Ensure that the following ACCEPT line (highlighted in the output above) exists, to be sure that PINsafe is allowing access to the Webmin listener:
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 10000 -j ACCEPT
Common Uses for Webmin
Below are articles which describe common use cases for Webmin:
