Attachment 114527 Details for Bug 156187 – bsnmpd02.diff.txt

bsnmpd02.diff.txt

bsnmpd02.diff.txt (text/plain; charset=US-ASCII), 4.87 KB, created by ofosos on 2011-04-06 09:01:45 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: ofosos

Created: 2011-04-06 09:01:45 UTC

Size: 4.87 KB

patch

obsolete

>Index: en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml
>===================================================================
>RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml,v
>retrieving revision 1.129
>diff -u -r1.129 chapter.sgml
>--- en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml	4 Apr 2011 05:23:33 -0000	1.129
>+++ en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml	6 Apr 2011 07:14:20 -0000
>@@ -5383,6 +5383,126 @@
> 	by local users.</para>
>     </sect2>
>   </sect1>
>+
>+  <sect1 id="network-bsnmpd">
>+    <sect1info>
>+      <authorgroup>
>+        <author>
>+          <firstname>Mark</firstname>
>+          <surname>Meyer</surname>
>+          <contrib>Contributed by </contrib>
>+        </author>
>+      </authorgroup>
>+      <authorgroup>
>+        <author>
>+          <contrib>Updated by </contrib>
>+          <othername>The &os; Documentation Project</othername>
>+        </author>
>+      </authorgroup>
>+    </sect1info>
>+
>+    <title>The <application>bsnmpd</application> Server</title>
>+
>+    <sect2 id="network-bsnmpd-overview">
>+      <title>Overview</title>
>+
>+      <para>With your installation of FreeBSD, bsnmpd is
>+        provided as the default software implementing SNMPv2.  For the
>+        purpose of testing we will assume you're trying to connect to
>+        this service from your local system.</para>
>+
>+      <note><para>To run the tests in this section you will additionally
>+	need <filename role="package">net-mgmt/bsnmptools</filename>,
>+	which you can install via the bsnmptools package or
>+	port.</para></note>
>+
>+    </sect2>
>+
>+    <sect2 id="network-bsnmpd-configuring">
>+      <title>Configuring <application>bsnmpd</application></title>
>+
>+      <para>The bsnmpd configuration resides
>+	in <filename>/etc/snmpd.config</filename> and is already
>+	runnable.  By default bsnmpd allows anyone to read any
>+	variable using the community <literal>public</literal>.  If
>+	you don't want anyone to read your SNMP variables, choose a
>+	different read community and edit the configuration setting
>+	accordingly:</para>
>+
>+      <programlisting>read := "<replaceable>superprivate</replaceable>"</programlisting>
>+
>+      <note><para>Choose the community string wisely.  Everyone able
>+	to guess it will be able to read from your systems management
>+	data.  The community string is transferred in cleartext over
>+	the network, potentially leaking a valuable password to an
>+	attacker.</para></note>
>+
>+      <para>The variables "location" and "contact" can be set. They
>+	are intended to reflect the physical location and system
>+	administration contact respectively:</para>
>+
>+      <programlisting>location := "Room 200"
>+contact := "sysmeister@example.com"</programlisting>
>+
>+      <para>If you want to send SNMP traps to a specific port, set
>+	both <literal>traphost</literal>
>+	and <literal>trapport</literal> variables:</para>
>+
>+      <programlisting>traphost := monitor.example.com
>+trapport := 162</programlisting>
>+
>+    </sect2>
>+
>+    <sect2 id="network-bsnmpd-running">
>+      <title>Running <application>bsnmpd</application></title>
>+
>+      <para>To run bsnmpd at system startup, add the following to your
>+	<filename>/etc/rc.conf</filename>:</para>
>+
>+      <programlisting>bsnmpd_enable="YES"</programlisting>
>+
>+      <para>Start <application>bsnmpd</application>:</para>
>+
>+      <screen>&prompt.root; <userinput>/etc/rc.d/bsnmpd start</userinput></screen>
>+
>+      <para>To test your setup, run
>+	<application>bsnmpget</application> on
>+	your system.</para>
>+
>+      <screen>&prompt.root; <userinput>/usr/local/bin/bsnmpget -s <replaceable>superprivate</replaceable>@localhost sysContact</userinput>
>+sysContact.0 = sysmeister@example.com</screen>
>+
>+      <para>The command should print the value you entered
>+	in <filename>/etc/snmpd.config</filename>.</para>
>+
>+    </sect2>
>+
>+    <sect2 id="network-bsnmpd-module">
>+      <title>Loading a module</title>
>+
>+      <para>Most of the bsnmpd functionality is available via
>+	modules. For demonstration purposes we will load the host
>+	resources module, which we will query for how much ram this
>+	system has. In <filename>snmpd.config</filename> the mib-2 module is
>+	already activated. We will add the host resources
>+	module. Search for the following line and uncomment it, by
>+	removing the hash sign in front:</para>
>+
>+      <programlisting>begemotSnmpdModulePath."hostres" = "/usr/lib/snmp_hostres.so"</programlisting>
>+
>+      <para>Restart <application>bsnmpd</application>:</para>
>+
>+      <screen>&prompt.root; <userinput>/etc/rc.d/bsnmpd restart</userinput></screen>
>+
>+      <para>Now you are able to query the amount of RAM (in kilobytes)
>+	this system has:</para>
>+
>+      <screen>&prompt.root; <userinput>/usr/local/bin/bsnmpwalk -s <replaceable>superprivate</replaceable>@localhost -n 1.3.6.1.2.1.25.2.2</userinput>
>+1.3.6.1.2.1.25.2.2 = 511392</screen>
>+
>+    </sect2>
>+  </sect1>
>+
> </chapter>
> 
> <!--

Actions: View

Attachments on bug 156187: 114526 | 114527