SWEAP v1.

0 Installation and Configuration Manual

Copyright
c 2012 LigoWave LLC

October 5, 2013

1 General
SWEAP stands for SNMP-to-WNMS External Agent/Proxy and is a solution that enables monitoring of third-party
network equipment in LigoWave WNMS. SWEAP periodically polls network devices using the SNMP protocol and
then converts the information retrieved to a heartbeat XML format understood by LigoWave WNMS to be reported to
a WNMS server.

2 Installation

2.1 Windows

SWEAP for Windows depends on Microsoft Visual C++ 2010 SP1 Distributable that can be downloaded from:
http://www.microsoft.com/download/en/details.aspx?id=8328
It should also be bundled together with the SWEAP installation package for your convenience. Please run the vcre-
dist_86.exe executable to install it before installing SWEAP.
SWEAP for Windows is distributed as a Microsoft Installer package (MSI) which makes it trivial to install: just double-
click the MSI file and follow the steps in the installation wizard. At some point during the installation you will be asked
to enter the URL of your WNMS server and a name for the instance of SWEAP you’re installing. You can later change
these settings by editing SWEAP’s main configuration file.
SWEAP installs as a Windows service that starts automatically and can be started or stopped through the Services
applet of Microsoft Management Console or from the command line (administrative privileges required) using the
following commands:
net start SWEAP
net stop SWEAP
Note that the service needs to be restarted for any changes made to SWEAP’s configuration files to take effect.
SWEAP supports all versions of Windows starting with Windows XP.

2.2 Ubuntu / Debian

SWEAP for Linux is provided as a Debian software package (DEB) that can either be downloaded directly and installed
using the dpkg tool, or downloaded and installed automatically using the apt-get tool.
To use the apt-get method, add the following line to /etc/apt/sources.list:
deb http://wnms.ligowave.com/ stable main contrib non-free
Then, run the following commands to automatically download and install SWEAP and the packages it depends on:

1
 sudo apt-get update
sudo apt-get install sweap
At some point during the installation you will be asked to enter the URL of your WNMS server and a name for the
instance of SWEAP you’re installing. You can later change these settings by editing SWEAP’s main configuration file.
SWEAP installs as a system daemon into the rc.d infrastructure and can be started, stopped or restarted using the
following commands:
sudo /etc/init.d/sweap start
sudo /etc/init.d/sweap stop
sudo /etc/init.d/sweap restart
or
sudo service sweap start
sudo service sweap stop
sudo service sweap restart

3 Basic Configuration
SWEAP is normally configured through the user interface of the WNMS server it reports to, therefore the only local
configuration changes you are ever likely to do is changing the WNMS server URL and/or the name used to identify
your particular instance of SWEAP on the server.
To change these settings, you’ll need to edit SWEAP’s main configuration file – configuration.xml – using your favorite
plain text file editor. Depending on the operating system, the configuration file is located in:
• on Windows: C:\SWEAP\config (presuming that you installed SWEAP to the default location C:\SWEAP)
• on Linux: /etc/sweap
Open the file named configuration.xml in your favorite text editor and locate and XML element server-uri that is a
child of an element called agent. Change the value of the server-uri element to the desired WNMS server URL.
To change the name that SWEAP will use to identify itself to the WNMS server, locate an XML element called name
whose parent element is called reporting. The value of the name element is, unsurprisingly, the name of your SWEAP
instance.
Here are the relevant excerpts from a typical configuration.xml file:
<?xml version="1.0" encoding="utf-8"?>
<sweap-configuration version="1.0">
<agent>
<server-uri>http://wnms.yourcompany.com</server-uri>
...
</agent>
...
<reporting>
<name>SWEAP</name>
...
</reporting>
...
</sweap-configuration>
Note that on Linux you can conveniently change the essential settings by running the following command:
sudo dpkg-reconfigure sweap

2
If you make manual changes to the configuration file, you’ll need to restart the daemon for the changes to take effect.
If you use the dpkg-reconfigure method, the daemon is restarted automatically.