← Back to branch summary

~ubuntu-branches/ubuntu/precise/net-snmp/precise

« back to all changes in this revision

Viewing changes to README.win32

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2009-11-26 01:27:00 UTC
  • mfrom: (1.1.9 sid)
  • Revision ID: james.westby@ubuntu.com-20091126012700-pox7w0a5j2x305h9
Tags: 5.4.2.1~dfsg-3ubuntu1
https://launchpad.net/bugs/104738
https://launchpad.net/bugs/254261
https://launchpad.net/bugs/250459
https://launchpad.net/bugs/426813
* Merge from debian testing.  Remaining changes:
  - Set Ubuntu maintainer address.
  - net-snmp-config: Use bash. (LP: #104738)
  - Removed multiuser option when calling update-rc.d. (LP: #254261)
  - debian/snmpd.init: LSBify the init script.
  - debian/patches/52_fix_snmpcmd_1_typo.patch: Adjust a typo in snmpcmd.1
    (LP: #250459)
  - debian/patches/99-fix-ubuntu-div0.patch: Fix dvision by zero.
    (LP: #426813).
 * Dropped patches:
   - debian/patches/101-fix-ipalias.patch: Applied upstream.
   - debian/patches/99-fix-net-snmp-syslog.patch: Applied upstream.
   - debian/patches/99-fix-perl-counter-in-subagent.patch: Applied upstream.
   - ebian/patches/103-fix-ubuntu-lmsensors.patch: No longer needed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.win32
151
151
Enabling the Windows SNMP extension agents
152
152
------------------------------------------
153
153
 
 
154
When installing Net-SNMP using the binary available from the web site, select 
 
155
'With Windows Extension DLL support' for the 'Net-SNMP Agent Service'.
 
156
 
154
157
The recommended way to start snmpd is with the following command line:
155
158
 
156
159
 snmpd.exe -I-udp,udpTable,tcp,tcpTable,icmp,ip,interfaces,system_mib,sysORTable
159
162
the default Windows (2003) extensions included with Windows.  Other Net-SNMP 
160
163
modules take precedence over the modules loaded by winExtDLL.
161
164
 
 
165
The binary install of Net-SNMP includes shortcuts in the Start menu for registering 
 
166
and unregistering snmpd and snmptrapd as a service with the correct command line 
 
167
options.
 
168
 
 
169
A simple test to see if winExtDLL is working is to get the sysDescr string.
 
170
 
 
171
 snmpget -v 1 -c public localhost sysDescr.0
 
172
 
 
173
If you see something similar to:
 
174
 
 
175
 Hardware: x86 Family 15 Model 12 Stepping 0 AT/AT COMPATIBLE - Software:
 
176
 Windows 2000 Version 5.0 (Build 2195 Uniprocessor Free)
 
177
 
 
178
instead of the usual Net-SNMP:
 
179
 
 
180
 Windows host1 5.0.2195 Service Pack 4 2000 Server x86 Family 15 Model 12
 
181
 Stepping 0
 
182
 
 
183
then it's using the Windows DLLs.  You may also notice that your floppy 
 
184
drive is accessed when starting the service.  This is from one of the 
 
185
Windows extensions.
 
186
 
 
187
To see what Windows modules are being loaded, you can shut down the 
 
188
service and then run snmpd.exe from the command line with winExtDLL 
 
189
debugging enabled using (all on one line):
 
190
 
 
191
 snmpd.exe -I-udp,udpTable,tcp,tcpTable,icmp,ip,interfaces,system_mib,
 
192
 sysORTable -DwinExtDLL
 
193
 
162
194
The Windows DLL snmpmib.dll (SNMPMIB) contains SNMP traffic statistics
163
195
(.1.3.6.1.2.1.11).  As we are using Net-SNMP and not the Windows SNMP Service,
164
196
no values will be returned from the Windows extension.  To allow SNMP 
206
238
 
207
239
Configure / nmake:
208
240
 
209
 
-modify win32\net-snmp\net-snmp-config.h.in and add:
210
 
 #define USING_WINEXTDLL_MODULE 1
211
 
 
212
 
-modify win32\netsnmpmibssdk\Makefile.in:
213
 
 uncomment winExtDLL lines
214
 
 
215
 
 add to lines that contain LIB32_FLAGS (line that contains iphlpapi.lib): 
216
 
  MgmtAPI.lib snmpapi.lib 
 
241
-add --with-winextdll to the Configure command line.
217
242
 
218
243
Workspace:
219
244
 
557
582
 
558
583
    Net-SNMP build and install options
559
584
    ==================================
560
 
    
561
 
    1.  OpenSSL support:            disabled
562
 
    2.  Platform SDK support:       disabled
563
 
    
564
 
    3.  Install path:               c:/usr
565
 
    4.  Install after build:        enabled
566
 
    
567
 
    5.  Perl modules:               disabled
568
 
    6.  Install perl modules:       disabled
569
 
    
570
 
    7.  Quiet build (logged):       enabled
571
 
    8.  Debug mode:                 disabled
572
 
    9.  IPv6 transports:            disabled
573
 
 
574
 
    10. Link type:                  static
575
 
    
576
 
    11. Install development files   disabled
577
 
    
 
585
 
 
586
    1.  OpenSSL support:                disabled
 
587
    2.  Platform SDK support:           disabled
 
588
 
 
589
    3.  Install path:                   c:/usr
 
590
    4.  Install after build:            enabled
 
591
 
 
592
    5.  Perl modules:                   disabled
 
593
    6.  Install perl modules:           disabled
 
594
 
 
595
    7.  Quiet build (logged):           enabled
 
596
    8.  Debug mode:                     disabled
 
597
 
 
598
    9.  IPv6 transports (requires SDK): disabled
 
599
    10. winExtDLL agent (requires SDK): disabled
 
600
 
 
601
    11. Link type:                      static
 
602
 
 
603
    12. Install development files       disabled
 
604
 
578
605
    F.  Finished - start build
579
606
    Q.  Quit - abort build
580
 
    
581
 
    Select option to set / toggle: 
 
607
 
 
608
    Select option to set / toggle:  
582
609
 
583
610
5.  Toggle the options on and off as desired by typing the line number 
584
611
    followed by <enter>.  
592
619
 
593
620
    To use the IPv6 transports, you must be using Windows 98 or later.
594
621
 
 
622
    See the section 'Running Net-SNMP as a replacement for the Microsoft 
 
623
    SNMP service' for important information on using the winExtDLL agent.
 
624
 
595
625
    If Quiet mode is enabled, all build activity is stored in various *.out 
596
626
    files inside of the win32 folder.
597
627
 
1445
1475
to be registered with the SCM.  This is done by running the program once with
1446
1476
the -register command line switch from a command prompt.
1447
1477
 
 
1478
If Net-SNMP was installed using the binary available from the Net-SNMP web site,
 
1479
there will be shortcuts in the Start menu for registering and unregistering the 
 
1480
agent and snmptrapd.
 
1481
 
1448
1482
The synopsis for registering snmpd as a Windows service is:
1449
1483
 
1450
1484
  snmpd -register [OPTIONS] [LISTENING ADDRESSES]