Snmp2CSV Version 1.1.0.0
Snmp2CSV is a standalone-pr= ogram that gathers networking related information about any SNMP enabled device.<= span style=3D'mso-spacerun:yes'> Snmp2CSV is controlled by a configuration file and can retrieve information from one to many devices (IP addresses). The output from S= nmp2CSV is a standard .CSV file that ca= n be read directly by Microsoft Excel, imported to various databases, read as a = text file, or read by other types of programs.
Each IP address specified i=
n the
configuration file is represented in the output file whether the address co=
uld
be contacted via SNMP or not. For
those addresses that cannot be contacted via SNMP, a “
Snmp2CSV supports individua= l SNMP community names by IP address or a single name across scanned IP ranges.
In the registered version of Snmp2CSV, there is no limit to the number of devices that Snmp2CSV can cont= act. The demo version is limited to 5 configuration lines but otherwise is fully functional.
A quiet mode makes it possi= ble to schedule and run Snmp2CSV during off-hours without desktop interaction.
Snmp2CSV runs on any versio=
n of
Windows 2000, Windows XP, or Windows Server 2003 providing that the Microso=
ft
provided WMI SNMP Provider is installed (see Installing the WMI SNMP Pr=
ovider
later in this document). The =
SNMP
Provider is included by Microsoft with all supported operating systems, but=
it
is not installed by default.
Snmp2CSV is installed using= a standard Windows Installer package. The WMI SNMP Provider from Microsoft must be installed before Snmp2C= SV will be able to interact with any computer via SNMP (see Installing<= /span> the WMI SNMP Provider later in this document). The provider does not need to be installed on target computers or devices – it only needs to be instal= led on the same computer as Snmp2CSV.
To install Snmp2CSV, simply= unzip the installation files to a temporary location, double-click the setup.exe file, and follow the instructions. It does not mat= ter if the WMI SNMP Provider is installed before or after Snmp2CSV.
Snmp2CSV is controlled by a configuration file (see Configurati= on File Layout later in this document). By default, this file is named Snmp2CSV.cfg and it is located in the user’s personal folder (usually My Documents). The location of the configuration = file can be changed by using the /C command line switch (see Command Line Switches later in this document). If a configuration= file does not exist, one will be created that will target only the machine on wh= ich Snmp2CSV.exe is run and it will be created in the user’s personal folder.
The Snmp2CSV configuration = file can be edited with any text editor (e.g., Notepad.exe). Please refer to the following samp= le configuration file for the discussion below.
Quiet &=
nbsp; &nbs=
p; =
‘ Line 1
10.10.10.1,publ=
ic &=
nbsp; &nbs=
p; ‘
Line 2
=
scan,=
public,10.10.10.100,10.10.10.110 ‘ Lin=
e 3
10.0.100.1,No_Power &=
nbsp; &nbs=
p; ‘
Line 4
10.0.100.2,Powe=
rful &=
nbsp; &nbs=
p; ‘
Line 5
gm0001,public &=
nbsp; &nbs=
p; ‘
Line 6
=
www.gregmarsh.com,public=
&=
nbsp; ‘ Line 7
The entry at the end of each line is for documentation purposes – they are not required in the actual configuration file!
Line 1: “=
Quiet”
means to run Snmp2CSV in quiet mode.
There is no screen output while in quiet mode. This is useful for running schedul=
ed
scans during off-hours where only the .CSV
file output is desired. To ru=
n with
a progress window showing, do not include this line. All errors detected are written to =
the
output file along with good data regardless of the quiet setting -- quiet o=
nly
means to not output to the screen.
The quiet configuration setting has the same effect as using the /Q command
line option (see Command Line Switches<=
/a>
later in this document).
It is best to put this line first because if put later, some messages might=
be
displayed during the initialization process. On the other hand, if messages are
desired during initialization, but not during the normal operation, then pu=
t it
last.
Line 2: “= 10.10.10.1,public” means to retrieve info from the = device at 10.10.10.1 using the community string “public”.
Line 3: “= scan,public,10.10.10.100,10.10.10.110 “ means= to retrieve info from all devices in the IP range 10.10.10.100 to 10.10.10.110 using the community string “public”.
Line 4: “= 10.0.100.1,No_Power”means to retrieve info from the device at 10.0.100.1 using the community string “No_Power”
Line 5: “= 10.0.100.2,Powerful”means to retrieve info from the device at 10.0.100.2 using the community string “Powerful”.
Line 6: This is the NetBI=
OS
name of a machine on the local network followed by its community string.
Line 7: This is the fully qualified name of a machine followed by its community string. The IP address will be resolved an= d the resulting address used. If a machine has multiple IP addresses for a given fully qualified name, the fir= st one returned will be used.
Notes:
When Snmp2CSV.exe is selected from the “Start” menu, dou= ble-clicked, or run from the command line, the configuration and output files are consid= ered to be in the user’s personal directory (usually My Documents). Al= so, it is assumed that the user desires a progress window that displays the locati= ons of the files and the current IP address being accessed. These assumptions can be overridden using command line switches or the configuration file (see Configuration File Layout later in= this document).
Command line switches:
/Q Quiet Mode. Snmp2CSV will execute without disp= laying progress information.
/H Snmp2CSV will display a simple comm= and line switch reminder.
/C By entering /C, a single space, and= a valid pathname, the location of the configuration file can be specified (e.= g., /C c:\Snmp2CSV.cfg)
/O By entering /C, a single space, and= a valid pathname, the location of the output file can be specified (e.g., /O = c:\Snmp2CSV.csv)
Windows Management Instrumentation (WMI) does not load the SNMP
provider by default and Snmp2CSV requires it. Follow the instructions below to i=
nstall
the provider if you get a message from Snmp2CSV stating that the namespace =
was
not found.
Windows XP or Windows Server 2003:
1.&n=
bsp;
From Control Panel, select Add/Remove Programs.
2.&n=
bsp;
Select Add/Remove Windows Components, then in the
Windows Components Wizard, select Management and Monitoring Tools.
3.&n=
bsp;
Select Simple Network Management Protocol and WMI S=
NMP
Provider, then click OK.
4.&n=
bsp;
Follow the steps in the wizard to complete the
installation.
4.
Windows 2000: Run the SNMP provider Setup program, Wbemsnmp.exe, from the \i386 direc= tory of the Windows 2000 installation CD or wmisnmp.exe in the installation directory for Snmp2CSV. Even = though the file names are different, the build of the provider should be the same. The file wmisetup.exe i= s the version downloaded from the Microsoft Download site. Both are build= 1085.0005, which is the latest as of this writing.
Windows NT version 4.0: The provider can be installed when installing the WMI core or from the Internet at http://www.microsoft.com/downlo= ads; however, Snmp2CSV has not been tested with this version of Windows.
Windows 3.1/95/98: The SNMP provider cannot be installed or run=
on
this operating system.