Step-by-step guide: SwitchMap under CactiEZ
Switchmap is a Perl program that creates HTML pages that show information about a set of Cisco Ethernet switches. It uses SNMP to gather data from the switches. Normally I install Switchmap in conjunction with CactiEZ and every time I am struggling to get Switchmap to work perfectly.
During another installation I wrote this step-by-step guide to configure switchmap correctly. This step-by-step guide is based on switchmap version 11.19. At first you have to download switchmap, extract it to the /var/www/html directory and rename the folder.
tar zxvf switchmap-11.19.tar.gz
mv switchmap-11.19 switchmap
Switchmap depends on multiple Perl modules, so install the necessary modules.
perl -MCPAN -e shell
Make sure your routers and Catalyst switches are configured to speak SNMP.
snmp-server community read4switchmap RO
Now you have to define your site-specific variables in ThisSite.pm. I changed the following parameters.
@routers = ();
push @routers, ‘10.62.4.2’;
@LocalSwitches = ();
push @LocalSwitches, ‘10.62.4.2’;
$Community = ‘read4switchmap’;
$DnsDomain = ‘.booches.nl’;
$DestinationDirectory = ‘/var/www/html/switchmap’;
$DestinationDirectoryRoot = ‘/switchmap’;
$StateFileDirectory = ‘/var/www/html/switchmap’;
Change the configfile variable in index.php to the following:
Switchmap has the option to search for IP addresses and MAC addresses, but you have to alter the configuration to get this functionality working. First change the following in FindOffice.pl.
use lib ‘/var/www/html/switchmap’;
Change the configuration of the web server to allow it to run CGI files from the switchmap directory. I added the following lines above the existing ScriptAlias in /etc/httpd/conf/httpd.conf.
ScriptAlias /cgi/ “/var/www/html/switchmap/”
Allow from all
Edit SearchPortLists.html and change the following lines.
<link href=”/switchmap/SwitchMap.css” rel=”stylesheet”>
<form method=GET action=”/cgi/FindOffice.pl”>
Change the rights on the files FindOffice.pl and ThisSite.pm
chmod 777 FindOffice.pl
chmod 777 ThisSite.pm
Now you can test run your installation by executing the following 3 commands:
When the commands are executed you can point your browser to:
and you should have a working Switchmap configuration.
The last step is configuring a cron job to schedule switchmap. Change the cron configuration using the command
and add the following lines.
44 * * * * perl /var/www/html/switchmap/ScanSwitch.pl
49 * * * * perl /var/www/html/switchmap/GetArp.pl
05 14 * * * perl /var/www/html/switchmap/SwitchMap.pl
You are good to go!! I hope this step-by-step guides makes my life (and hopefully also your life) a bit easier when installing a new Switchmap under CactiEZ.
Latest posts by René Jorissen (see all)
- MacOS Big Sur and SSLKEYFILELOG - November 23, 2021
- ClearPass, Azure AD, SSO and Object ID - August 12, 2021
- ClearPass – custom MPSK - July 20, 2021
I tried the step by step for Switchmap and working fine.
Thanks for your help.
Only thing searchportlist is not working.
I get the error message
The requested URL /cgi/FindOffice.pl was not found on this server
Can you please help me to resolve this.
Very nice Step-by-step guide!
When you change the file switchmap/SearchPortlists.html
the portsearch function works fine.
What I should do in
Bas wanted to tell that the following needs to be changes:
Logged in throu webmin and cgi programes then Regexp CGI directory aliases there I have added this from to.
Working fine.Since I am very new to this difficult for me to identify this location.
Thanks a lot.
The file SearchPortlists.html is not generated, can you please tell me what am I missing?
I don’t leave many remarks, but i did a few searching and wound up here Step-by-step guide: SwitchMap under CactiEZ | Booches.nl. And I actually do have some questions for you if it’s allright. Is it just me or does it look like some of the responses look like written by brain dead visitors? :-P And, if you are writing at additional social sites, I would like to follow anything new you have to post. Would you make a list of all of all your shared pages like your twitter feed, Facebook page or linkedin profile?
I noticed an error when installing the perl modules “Log::Dispatch::Screen” and “Log::Log4perl” this resulted in an error running the command “perl GetArp.pl”
When u do a forced install of de modules “perl GetArp” seems to work and the result seems ok.
The only thing i found is that the command ” perl SwitchMap.pl” will result in :
“Use of uninitialized value in numeric gt (>) at /var/www/html/switchmap/SwitchUtils.pm line 747.”
i’m going to sort this out sometime later. but for now it works.