Blame win32/EXAMPLE.conf.win32

Packit fcad23
## Of the following Net-SNMP agent features
Packit fcad23
## NONE are supported on Net-SNMP-5.1.1 Win32 platforms
Packit fcad23
##    Process checks        "proc" config token
Packit fcad23
##    Executable scripts    "exec" config token
Packit fcad23
##    Disk checks           "disk" config token
Packit fcad23
##    Load average checks   "load" config token
Packit fcad23
##    Extensible sections   "exec" config token with shelltest
Packit fcad23
##    Pass-through control  "pass" config token
Packit fcad23
Packit fcad23
###############################################################################
Packit fcad23
#
Packit fcad23
# EXAMPLE.conf:
Packit fcad23
#   An example configuration file for configuring the ucd-snmp snmpd agent.
Packit fcad23
#
Packit fcad23
###############################################################################
Packit fcad23
#
Packit fcad23
# This file is intended to only be an example.  If, however, you want
Packit fcad23
# to use it, it should be placed in c:/usr-mingw/etc/share/snmp/snmpd.conf.
Packit fcad23
# When the snmpd agent starts up, this is where it will look for it.
Packit fcad23
#
Packit fcad23
# You might be interested in generating your own snmpd.conf file using
Packit fcad23
# the "snmpconf" program (perl script) instead.  It's a nice menu
Packit fcad23
# based interface to writing well commented configuration files.  Try it!
Packit fcad23
#
Packit fcad23
# Note: This file is automatically generated from EXAMPLE.conf.def.
Packit fcad23
# Do NOT read the EXAMPLE.conf.def file! Instead, after you have run
Packit fcad23
# configure & make, and then make sure you read the EXAMPLE.conf file
Packit fcad23
# instead, as it will tailor itself to your configuration.
Packit fcad23
Packit fcad23
# All lines beginning with a '#' are comments and are intended for you
Packit fcad23
# to read.  All other lines are configuration commands for the agent.
Packit fcad23
Packit fcad23
#
Packit fcad23
# PLEASE: read the snmpd.conf(5) manual page as well!
Packit fcad23
#
Packit fcad23
Packit fcad23
Packit fcad23
###############################################################################
Packit fcad23
# Access Control
Packit fcad23
###############################################################################
Packit fcad23
Packit fcad23
# YOU SHOULD CHANGE THE "COMMUNITY" TOKEN BELOW TO A NEW KEYWORD ONLY
Packit fcad23
# KNOWN AT YOUR SITE.  YOU *MUST* CHANGE THE NETWORK TOKEN BELOW TO
Packit fcad23
# SOMETHING REFLECTING YOUR LOCAL NETWORK ADDRESS SPACE.
Packit fcad23
Packit fcad23
# By far, the most common question I get about the agent is "why won't
Packit fcad23
# it work?", when really it should be "how do I configure the agent to
Packit fcad23
# allow me to access it?"
Packit fcad23
#
Packit fcad23
# By default, the agent responds to the "public" community for read
Packit fcad23
# only access, if run out of the box without any configuration file in 
Packit fcad23
# place.  The following examples show you other ways of configuring
Packit fcad23
# the agent so that you can change the community names, and give
Packit fcad23
# yourself write access as well.
Packit fcad23
#
Packit fcad23
# The following lines change the access permissions of the agent so
Packit fcad23
# that the COMMUNITY string provides read-only access to your entire
Packit fcad23
# NETWORK (EG: 10.10.10.0/24), and read/write access to only the
Packit fcad23
# localhost (127.0.0.1, not its real ipaddress).
Packit fcad23
#
Packit fcad23
# For more information, read the FAQ as well as the snmpd.conf(5)
Packit fcad23
# manual page.
Packit fcad23
Packit fcad23
####
Packit fcad23
# First, map the community name (COMMUNITY) into a security name
Packit fcad23
# (local and mynetwork, depending on where the request is coming
Packit fcad23
# from):
Packit fcad23
Packit fcad23
#       sec.name  source          community
Packit fcad23
com2sec local     localhost       COMMUNITY
Packit fcad23
com2sec mynetwork NETWORK/24      COMMUNITY
Packit fcad23
Packit fcad23
####
Packit fcad23
# Second, map the security names into group names:
Packit fcad23
Packit fcad23
#             	sec.model  sec.name
Packit fcad23
group MyRWGroup	v1         local
Packit fcad23
group MyRWGroup	v2c        local
Packit fcad23
group MyRWGroup	usm        local
Packit fcad23
group MyROGroup v1         mynetwork
Packit fcad23
group MyROGroup v2c        mynetwork
Packit fcad23
group MyROGroup usm        mynetwork
Packit fcad23
Packit fcad23
####
Packit fcad23
# Third, create a view for us to let the groups have rights to:
Packit fcad23
Packit fcad23
#           incl/excl subtree                          mask
Packit fcad23
view all    included  .1                               80
Packit fcad23
Packit fcad23
####
Packit fcad23
# Finally, grant the 2 groups access to the 1 view with different
Packit fcad23
# write permissions:
Packit fcad23
Packit fcad23
#                context sec.model sec.level match  read   write  notif
Packit fcad23
access MyROGroup ""      any       noauth    exact  all    none   none
Packit fcad23
access MyRWGroup ""      any       noauth    exact  all    all    none
Packit fcad23
Packit fcad23
# -----------------------------------------------------------------------------
Packit fcad23
Packit fcad23
Packit fcad23
###############################################################################
Packit fcad23
# System contact information
Packit fcad23
#
Packit fcad23
Packit fcad23
# It is also possible to set the sysContact and sysLocation system
Packit fcad23
# variables through the snmpd.conf file.  **PLEASE NOTE** that setting
Packit fcad23
# the value of these objects here makes these objects READ-ONLY
Packit fcad23
# (regardless of any access control settings).  Any attempt to set the
Packit fcad23
# value of an object whose value is given here will fail with an error
Packit fcad23
# status of notWritable.
Packit fcad23
Packit fcad23
syslocation Right here, right now.
Packit fcad23
syscontact Me <me@somewhere.org>
Packit fcad23
Packit fcad23
# Example output of snmpwalk:
Packit fcad23
#   % snmpwalk -v 1 -c public localhost system
Packit fcad23
#   system.sysDescr.0 = "Windows NT 2000 SP4"
Packit fcad23
#   system.sysObjectID.0 = OID: enterprises.ucdavis.ucdSnmpAgent.win32
Packit fcad23
#   system.sysUpTime.0 = Timeticks: (595637548) 68 days, 22:32:55
Packit fcad23
#   system.sysContact.0 = "Me <me@somewhere.org>"
Packit fcad23
#   system.sysName.0 = "name"
Packit fcad23
#   system.sysLocation.0 = "Right here, right now."
Packit fcad23
#   system.sysServices.0 = 72
Packit fcad23
Packit fcad23
Packit fcad23
# -----------------------------------------------------------------------------
Packit fcad23
Packit fcad23
###############################################################################
Packit fcad23
# Subagent control
Packit fcad23
#
Packit fcad23
Packit fcad23
# The agent can support subagents using a number of extension mechanisms.
Packit fcad23
# From the 4.2.1 release, AgentX support is being compiled in by default.
Packit fcad23
# However, this is still experimental code, so should not be used on
Packit fcad23
# critical production systems.
Packit fcad23
#   Please see the file README.agentx for more details.
Packit fcad23
#
Packit fcad23
# If having read, marked, learnt and inwardly digested this information,
Packit fcad23
# you decide that you do wish to make use of this mechanism, simply
Packit fcad23
# uncomment the following directive.
Packit fcad23
#
Packit fcad23
#  master  agentx
Packit fcad23
#
Packit fcad23
# I repeat - this is *NOT* regarded as suitable for front-line production
Packit fcad23
# systems, though it is probably stable enough for day-to-day use.
Packit fcad23
# Probably.
Packit fcad23
#
Packit fcad23
# No refunds will be given.
Packit fcad23
Packit fcad23
Packit fcad23
###############################################################################
Packit fcad23
# Further Information
Packit fcad23
#
Packit fcad23
#  See the snmpd.conf manual page, and the output of "snmpd -H".
Packit fcad23
#  MUCH more can be done with the snmpd.conf than is shown as an
Packit fcad23
#  example here.