Attachment 114526 Details for Bug 156187 – file.txt

file.txt

file.txt (text/plain), 4.71 KB, created by Mark Meyer on 2011-04-04 23:00:22 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Mark Meyer

Created: 2011-04-04 23:00:22 UTC

Size: 4.71 KB

patch

obsolete

>? bsnmpd.diff
>Index: 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
>--- network-servers/chapter.sgml	4 Apr 2011 05:23:33 -0000	1.129
>+++ network-servers/chapter.sgml	4 Apr 2011 21:40:56 -0000
>@@ -5383,6 +5383,125 @@
> 	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 first 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>NTo 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 /etc/bsnmpd.config and
>+	is already in a runnable state.  By default bsnmpd allows
>+	anybody to read any variable using the community "public".  If
>+	you don't want everybody to read your SNMP variables, choose a
>+	different read community and edit the configuration setting
>+	accordingly:</para>
>+
>+      <programlisting>read := "superprivate"</programlisting>
>+
>+      <note><para>Choose the community string wisely.  Everybody able to
>+	guess it, will be able to read from your systems management
>+	data.  The community will however be transferred in plain text
>+	over the wire, thus potentially leaking an otherwise secure
>+	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 "traphost" and "trapport" 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_enabl="YES"</programlisting>
>+
>+      <para>Doing a</para>
>+
>+      <screen>&prompt.root; <userinput>/etc/rc.d/bsnmpd start</userinput></screen>
>+
>+      <para>will start <application>bsnmpd</application>
>+	immediately. To test your setup, run
>+	an <application>bsnmpget</application> from the machine you
>+	installed on.</para>
>+
>+      <screen>&prompt.root; <userinput>/usr/local/bin/bsnmpget -s superprivate@localhost sysContact</userinput>
>+sysContact.0 = sysmeister@example.com</screen>
>+
>+      <para>The command should dump the value you entered in your
>+	configuration.</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>Now 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 superprivate@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