EXAMPLE.conf.def
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:16k
源码类别:

SNMP编程

开发平台:

Unix_Linux

  1. ###############################################################################
  2. #
  3. # EXAMPLE.conf:
  4. #   An example configuration file for configuring the ucd-snmp snmpd agent.
  5. #
  6. ###############################################################################
  7. #
  8. # This file is intended to only be an example.  If, however, you want
  9. # to use it, it should be placed in SYSCONFDIR/snmp/snmpd.conf.
  10. # When the snmpd agent starts up, this is where it will look for it.
  11. #
  12. # You might be interested in generating your own snmpd.conf file using
  13. # the "snmpconf" program (perl script) instead.  It's a nice menu
  14. # based interface to writing well commented configuration files.  Try it!
  15. #
  16. # Note: This file is automatically generated from EXAMPLE.conf.def.
  17. # Do NOT read the EXAMPLE.conf.def file! Instead, after you have run
  18. # configure & make, and then make sure you read the EXAMPLE.conf file
  19. # instead, as it will tailor itself to your configuration.
  20. # All lines beginning with a '#' are comments and are intended for you
  21. # to read.  All other lines are configuration commands for the agent.
  22. #
  23. # PLEASE: read the snmpd.conf(5) manual page as well!
  24. #
  25. ###############################################################################
  26. # Access Control
  27. ###############################################################################
  28. # YOU SHOULD CHANGE THE "COMMUNITY" TOKEN BELOW TO A NEW KEYWORD ONLY
  29. # KNOWN AT YOUR SITE.  YOU *MUST* CHANGE THE NETWORK TOKEN BELOW TO
  30. # SOMETHING REFLECTING YOUR LOCAL NETWORK ADDRESS SPACE.
  31. # By far, the most common question I get about the agent is "why won't
  32. # it work?", when really it should be "how do I configure the agent to
  33. # allow me to access it?"
  34. #
  35. # By default, the agent responds to the "public" community for read
  36. # only access, if run out of the box without any configuration file in 
  37. # place.  The following examples show you other ways of configuring
  38. # the agent so that you can change the community names, and give
  39. # yourself write access as well.
  40. #
  41. # The following lines change the access permissions of the agent so
  42. # that the COMMUNITY string provides read-only access to your entire
  43. # NETWORK (EG: 10.10.10.0/24), and read/write access to only the
  44. # localhost (127.0.0.1, not its real ipaddress).
  45. #
  46. # For more information, read the FAQ as well as the snmpd.conf(5)
  47. # manual page.
  48. ####
  49. # First, map the community name (COMMUNITY) into a security name
  50. # (local and mynetwork, depending on where the request is coming
  51. # from):
  52. #       sec.name  source          community
  53. com2sec local     localhost       COMMUNITY
  54. com2sec mynetwork NETWORK/24      COMMUNITY
  55. ####
  56. # Second, map the security names into group names:
  57. #              sec.model  sec.name
  58. group MyRWGroup v1         local
  59. group MyRWGroup v2c        local
  60. group MyRWGroup usm        local
  61. group MyROGroup v1         mynetwork
  62. group MyROGroup v2c        mynetwork
  63. group MyROGroup usm        mynetwork
  64. ####
  65. # Third, create a view for us to let the groups have rights to:
  66. #           incl/excl subtree                          mask
  67. view all    included  .1                               80
  68. ####
  69. # Finally, grant the 2 groups access to the 1 view with different
  70. # write permissions:
  71. #                context sec.model sec.level match  read   write  notif
  72. access MyROGroup ""      any       noauth    exact  all    none   none
  73. access MyRWGroup ""      any       noauth    exact  all    all    none
  74. # -----------------------------------------------------------------------------
  75. ###############################################################################
  76. # System contact information
  77. #
  78. # It is also possible to set the sysContact and sysLocation system
  79. # variables through the snmpd.conf file.  **PLEASE NOTE** that setting
  80. # the value of these objects here makes these objects READ-ONLY
  81. # (regardless of any access control settings).  Any attempt to set the
  82. # value of an object whose value is given here will fail with an error
  83. # status of notWritable.
  84. syslocation Right here, right now.
  85. syscontact Me <me@somewhere.org>
  86. # Example output of snmpwalk:
  87. #   % snmpwalk -v 1 -c public localhost system
  88. #   system.sysDescr.0 = "SunOS name sun4c"
  89. #   system.sysObjectID.0 = OID: enterprises.ucdavis.ucdSnmpAgent.sunos4
  90. #   system.sysUpTime.0 = Timeticks: (595637548) 68 days, 22:32:55
  91. #   system.sysContact.0 = "Me <me@somewhere.org>"
  92. #   system.sysName.0 = "name"
  93. #   system.sysLocation.0 = "Right here, right now."
  94. #   system.sysServices.0 = 72
  95. # -----------------------------------------------------------------------------
  96. ###############################################################################
  97. # Process checks.
  98. #
  99. #  The following are examples of how to use the agent to check for
  100. #  processes running on the host.  The syntax looks something like:
  101. #
  102. #  proc NAME [MAX=0] [MIN=0]
  103. #
  104. #  NAME:  the name of the process to check for.  It must match
  105. #         exactly (ie, http will not find httpd processes).
  106. #  MAX:   the maximum number allowed to be running.  Defaults to 0.
  107. #  MIN:   the minimum number to be running.  Defaults to 0.
  108. #
  109. #  Examples:
  110. #
  111. #  Make sure mountd is running
  112. proc mountd
  113. #  Make sure there are no more than 4 ntalkds running, but 0 is ok too.
  114. proc ntalkd 4
  115. #  Make sure at least one sendmail, but less than or equal to 10 are running.
  116. proc sendmail 10 1
  117. #  A snmpwalk of the prTable would look something like this:
  118. # % snmpwalk -v 1 -c public localhost .EXTENSIBLEDOTMIB.PROCMIBNUM
  119. # enterprises.ucdavis.procTable.prEntry.prIndex.1 = 1
  120. # enterprises.ucdavis.procTable.prEntry.prIndex.2 = 2
  121. # enterprises.ucdavis.procTable.prEntry.prIndex.3 = 3
  122. # enterprises.ucdavis.procTable.prEntry.prNames.1 = "mountd"
  123. # enterprises.ucdavis.procTable.prEntry.prNames.2 = "ntalkd"
  124. # enterprises.ucdavis.procTable.prEntry.prNames.3 = "sendmail"
  125. # enterprises.ucdavis.procTable.prEntry.prMin.1 = 0
  126. # enterprises.ucdavis.procTable.prEntry.prMin.2 = 0
  127. # enterprises.ucdavis.procTable.prEntry.prMin.3 = 1
  128. # enterprises.ucdavis.procTable.prEntry.prMax.1 = 0
  129. # enterprises.ucdavis.procTable.prEntry.prMax.2 = 4
  130. # enterprises.ucdavis.procTable.prEntry.prMax.3 = 10
  131. # enterprises.ucdavis.procTable.prEntry.prCount.1 = 0
  132. # enterprises.ucdavis.procTable.prEntry.prCount.2 = 0
  133. # enterprises.ucdavis.procTable.prEntry.prCount.3 = 1
  134. # enterprises.ucdavis.procTable.prEntry.prErrorFlag.1 = 1
  135. # enterprises.ucdavis.procTable.prEntry.prErrorFlag.2 = 0
  136. # enterprises.ucdavis.procTable.prEntry.prErrorFlag.3 = 0
  137. # enterprises.ucdavis.procTable.prEntry.prErrMessage.1 = "No mountd process running."
  138. # enterprises.ucdavis.procTable.prEntry.prErrMessage.2 = ""
  139. # enterprises.ucdavis.procTable.prEntry.prErrMessage.3 = ""
  140. # enterprises.ucdavis.procTable.prEntry.prErrFix.1 = 0
  141. # enterprises.ucdavis.procTable.prEntry.prErrFix.2 = 0
  142. # enterprises.ucdavis.procTable.prEntry.prErrFix.3 = 0
  143. #
  144. #  Note that the errorFlag for mountd is set to 1 because one is not
  145. #  running (in this case an rpc.mountd is, but thats not good enough),
  146. #  and the ErrMessage tells you what's wrong.  The configuration
  147. #  imposed in the snmpd.conf file is also shown.  
  148. #  Special Case:  When the min and max numbers are both 0, it assumes
  149. #  you want a max of infinity and a min of 1.
  150. #
  151. # -----------------------------------------------------------------------------
  152. ###############################################################################
  153. # Executables/scripts
  154. #
  155. #
  156. #  You can also have programs run by the agent that return a single
  157. #  line of output and an exit code.  Here are two examples.
  158. #
  159. #  exec NAME PROGRAM [ARGS ...]
  160. #
  161. #  NAME:     A generic name.
  162. #  PROGRAM:  The program to run.  Include the path!
  163. #  ARGS:     optional arguments to be passed to the program
  164. # a simple hello world
  165. exec echotest /bin/echo hello world
  166. # Run a shell script containing:
  167. #
  168. # #!/bin/sh
  169. # echo hello world
  170. # echo hi there
  171. # exit 35
  172. #
  173. # Note:  this has been specifically commented out to prevent
  174. # accidental security holes due to someone else on your system writing
  175. # a /tmp/shtest before you do.  Uncomment to use it.
  176. #
  177. #exec shelltest /bin/sh /tmp/shtest
  178. # Then, 
  179. # % snmpwalk -v 1 -c public localhost .EXTENSIBLEDOTMIB.SHELLMIBNUM
  180. # enterprises.ucdavis.extTable.extEntry.extIndex.1 = 1
  181. # enterprises.ucdavis.extTable.extEntry.extIndex.2 = 2
  182. # enterprises.ucdavis.extTable.extEntry.extNames.1 = "echotest"
  183. # enterprises.ucdavis.extTable.extEntry.extNames.2 = "shelltest"
  184. # enterprises.ucdavis.extTable.extEntry.extCommand.1 = "/bin/echo hello world"
  185. # enterprises.ucdavis.extTable.extEntry.extCommand.2 = "/bin/sh /tmp/shtest"
  186. # enterprises.ucdavis.extTable.extEntry.extResult.1 = 0
  187. # enterprises.ucdavis.extTable.extEntry.extResult.2 = 35
  188. # enterprises.ucdavis.extTable.extEntry.extOutput.1 = "hello world."
  189. # enterprises.ucdavis.extTable.extEntry.extOutput.2 = "hello world."
  190. # enterprises.ucdavis.extTable.extEntry.extErrFix.1 = 0
  191. # enterprises.ucdavis.extTable.extEntry.extErrFix.2 = 0
  192. # Note that the second line of the /tmp/shtest shell script is cut
  193. # off.  Also note that the exit status of 35 was returned.
  194. # -----------------------------------------------------------------------------
  195. ###############################################################################
  196. # disk checks
  197. #
  198. # The agent can check the amount of available disk space, and make
  199. # sure it is above a set limit.  
  200. # disk PATH [MIN=DEFDISKMINIMUMSPACE]
  201. #
  202. # PATH:  mount path to the disk in question.
  203. # MIN:   Disks with space below this value will have the Mib's errorFlag set.
  204. #        Default value = DEFDISKMINIMUMSPACE.
  205. # Check the / partition and make sure it contains at least 10 megs.
  206. disk / 10000
  207. # % snmpwalk -v 1 -c public localhost .EXTENSIBLEDOTMIB.DISKMIBNUM
  208. # enterprises.ucdavis.diskTable.dskEntry.diskIndex.1 = 0
  209. # enterprises.ucdavis.diskTable.dskEntry.diskPath.1 = "/" Hex: 2F 
  210. # enterprises.ucdavis.diskTable.dskEntry.diskDevice.1 = "/dev/dsk/c201d6s0"
  211. # enterprises.ucdavis.diskTable.dskEntry.diskMinimum.1 = 10000
  212. # enterprises.ucdavis.diskTable.dskEntry.diskTotal.1 = 837130
  213. # enterprises.ucdavis.diskTable.dskEntry.diskAvail.1 = 316325
  214. # enterprises.ucdavis.diskTable.dskEntry.diskUsed.1 = 437092
  215. # enterprises.ucdavis.diskTable.dskEntry.diskPercent.1 = 58
  216. # enterprises.ucdavis.diskTable.dskEntry.diskErrorFlag.1 = 0
  217. # enterprises.ucdavis.diskTable.dskEntry.diskErrorMsg.1 = ""
  218. # -----------------------------------------------------------------------------
  219. ###############################################################################
  220. # load average checks
  221. #
  222. # load [1MAX=DEFMAXLOADAVE] [5MAX=DEFMAXLOADAVE] [15MAX=DEFMAXLOADAVE]
  223. #
  224. # 1MAX:   If the 1 minute load average is above this limit at query
  225. #         time, the errorFlag will be set.
  226. # 5MAX:   Similar, but for 5 min average.
  227. # 15MAX:  Similar, but for 15 min average.
  228. # Check for loads:
  229. load 12 14 14
  230. # % snmpwalk -v 1 -c public localhost .EXTENSIBLEDOTMIB.LOADAVEMIBNUM
  231. # enterprises.ucdavis.loadTable.laEntry.loadaveIndex.1 = 1
  232. # enterprises.ucdavis.loadTable.laEntry.loadaveIndex.2 = 2
  233. # enterprises.ucdavis.loadTable.laEntry.loadaveIndex.3 = 3
  234. # enterprises.ucdavis.loadTable.laEntry.loadaveNames.1 = "Load-1"
  235. # enterprises.ucdavis.loadTable.laEntry.loadaveNames.2 = "Load-5"
  236. # enterprises.ucdavis.loadTable.laEntry.loadaveNames.3 = "Load-15"
  237. # enterprises.ucdavis.loadTable.laEntry.loadaveLoad.1 = "0.49" Hex: 30 2E 34 39 
  238. # enterprises.ucdavis.loadTable.laEntry.loadaveLoad.2 = "0.31" Hex: 30 2E 33 31 
  239. # enterprises.ucdavis.loadTable.laEntry.loadaveLoad.3 = "0.26" Hex: 30 2E 32 36 
  240. # enterprises.ucdavis.loadTable.laEntry.loadaveConfig.1 = "12.00"
  241. # enterprises.ucdavis.loadTable.laEntry.loadaveConfig.2 = "14.00"
  242. # enterprises.ucdavis.loadTable.laEntry.loadaveConfig.3 = "14.00"
  243. # enterprises.ucdavis.loadTable.laEntry.loadaveErrorFlag.1 = 0
  244. # enterprises.ucdavis.loadTable.laEntry.loadaveErrorFlag.2 = 0
  245. # enterprises.ucdavis.loadTable.laEntry.loadaveErrorFlag.3 = 0
  246. # enterprises.ucdavis.loadTable.laEntry.loadaveErrMessage.1 = ""
  247. # enterprises.ucdavis.loadTable.laEntry.loadaveErrMessage.2 = ""
  248. # enterprises.ucdavis.loadTable.laEntry.loadaveErrMessage.3 = ""
  249. # -----------------------------------------------------------------------------
  250. ###############################################################################
  251. # Extensible sections.
  252. # This alleviates the multiple line output problem found in the
  253. # previous executable mib by placing each mib in its own mib table:
  254. # Run a shell script containing:
  255. #
  256. # #!/bin/sh
  257. # echo hello world
  258. # echo hi there
  259. # exit 35
  260. #
  261. # Note:  this has been specifically commented out to prevent
  262. # accidental security holes due to someone else on your system writing
  263. # a /tmp/shtest before you do.  Uncomment to use it.
  264. #
  265. # exec .EXTENSIBLEDOTMIB.50 shelltest /bin/sh /tmp/shtest
  266. # % snmpwalk -v 1 -c public localhost .EXTENSIBLEDOTMIB.50
  267. # enterprises.ucdavis.50.1.1 = 1
  268. # enterprises.ucdavis.50.2.1 = "shelltest"
  269. # enterprises.ucdavis.50.3.1 = "/bin/sh /tmp/shtest"
  270. # enterprises.ucdavis.50.100.1 = 35
  271. # enterprises.ucdavis.50.101.1 = "hello world."
  272. # enterprises.ucdavis.50.101.2 = "hi there."
  273. # enterprises.ucdavis.50.102.1 = 0
  274. # Now the Output has grown to two lines, and we can see the 'hi
  275. # there.' output as the second line from our shell script.
  276. #
  277. # Note that you must alter the mib.txt file to be correct if you want
  278. # the .50.* outputs above to change to reasonable text descriptions.
  279. # Other ideas:
  280. # exec .EXTENSIBLEDOTMIB.51 ps /bin/ps 
  281. # exec .EXTENSIBLEDOTMIB.52 top /usr/local/bin/top
  282. # exec .EXTENSIBLEDOTMIB.53 mailq /usr/bin/mailq
  283. # -----------------------------------------------------------------------------
  284. ###############################################################################
  285. # Pass through control.
  286. # Usage:
  287. #   pass MIBOID EXEC-COMMAND
  288. #
  289. # This will pass total control of the mib underneath the MIBOID
  290. # portion of the mib to the EXEC-COMMAND.  
  291. #
  292. # Note:  You'll have to change the path of the passtest script to your
  293. # source directory or install it in the given location.
  294. # Example:  (see the script for details)
  295. #           (commented out here since it requires that you place the
  296. #           script in the right location. (its not installed by default))
  297. # pass .EXTENSIBLEDOTMIB.255 /bin/sh PREFIX/local/passtest
  298. # % snmpwalk -v 1 -c public localhost .EXTENSIBLEDOTMIB.255
  299. # enterprises.ucdavis.255.1 = "life the universe and everything"
  300. # enterprises.ucdavis.255.2.1 = 42
  301. # enterprises.ucdavis.255.2.2 = OID: 42.42.42
  302. # enterprises.ucdavis.255.3 = Timeticks: (363136200) 42 days, 0:42:42
  303. # enterprises.ucdavis.255.4 = IpAddress: 127.0.0.1
  304. # enterprises.ucdavis.255.5 = 42
  305. # enterprises.ucdavis.255.6 = Gauge: 42
  306. #
  307. # % snmpget -v 1 -c public localhost .EXTENSIBLEDOTMIB.255.5
  308. # enterprises.ucdavis.255.5 = 42
  309. #
  310. # % snmpset -v 1 -c public localhost .EXTENSIBLEDOTMIB.255.1 s "New string"
  311. # enterprises.ucdavis.255.1 = "New string"
  312. #
  313. # For specific usage information, see the man/snmpd.conf.5 manual page
  314. # as well as the local/passtest script used in the above example.
  315. ###############################################################################
  316. # Subagent control
  317. #
  318. # The agent can support subagents using a number of extension mechanisms.
  319. # From the 4.2.1 release, AgentX support is being compiled in by default.
  320. # However, this is still experimental code, so should not be used on
  321. # critical production systems.
  322. #   Please see the file README.agentx for more details.
  323. #
  324. # If having read, marked, learnt and inwardly digested this information,
  325. # you decide that you do wish to make use of this mechanism, simply
  326. # uncomment the following directive.
  327. #
  328. #  master  agentx
  329. #
  330. # I repeat - this is *NOT* regarded as suitable for front-line production
  331. # systems, though it is probably stable enough for day-to-day use.
  332. # Probably.
  333. #
  334. # No refunds will be given.
  335. ###############################################################################
  336. # Further Information
  337. #
  338. #  See the snmpd.conf manual page, and the output of "snmpd -H".
  339. #  MUCH more can be done with the snmpd.conf than is shown as an
  340. #  example here.