Skip to content

Commit cf9c426

Browse files
author
davehal
committed
Syncing RubyForge repository with private repository.
1 parent c5e4259 commit cf9c426

6 files changed

Lines changed: 182 additions & 0 deletions

File tree

‎content/equipment.jpg‎

12.1 KB
Loading

‎content/index.html‎

Lines changed: 161 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,161 @@
1+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2+
<html lang="en">
3+
<head>
4+
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5+
<title>SNMP Library for Ruby</title>
6+
<style type="text/css">
7+
body {
8+
margin:0;
9+
padding:0;
10+
background-color:white;
11+
color:#000;
12+
min-width:750px;
13+
}
14+
15+
a {text-decoration: none; color: #c23; }
16+
a:hover { text-decoration: underline; color: #c23; }
17+
a:active { color: #fc0; }
18+
19+
h1, h2, h3, h4, h5, h6 {
20+
color: #333;
21+
font-family: Tahoma, sans-serif;
22+
}
23+
24+
p {
25+
font-family: Georgia, serif;
26+
}
27+
28+
div#wrap {
29+
background:white;
30+
margin:0 auto;
31+
width:750px;
32+
}
33+
34+
div#wrap img {
35+
padding: 20px 0px 0px 8px;
36+
}
37+
38+
#main {
39+
background-color:white;
40+
float:left;
41+
width:500px;
42+
}
43+
#main h2, #main h3, #main p, #main pre {
44+
padding:0 10px;
45+
}
46+
#main img {
47+
margin: 0 1em;
48+
}
49+
50+
#sidebar {
51+
background-color:#ffc;
52+
width:247px;
53+
margin-top: 24px;
54+
margin-left:500px;
55+
border: solid 2px #c23;
56+
}
57+
html>body #sidebar {
58+
width:250px;
59+
}
60+
61+
#sidebar p {
62+
font-family: Tahoma, sans-serif;
63+
font-size: small;
64+
}
65+
#sidebar ul {
66+
margin-bottom:0;
67+
}
68+
#sidebar h3 {
69+
color:#c23
70+
}
71+
#sidebar h3, #sidebar p {
72+
padding:0 10px;
73+
}
74+
75+
#quotes {
76+
font-weight: bold;
77+
color: #333;
78+
padding-right: 40px;
79+
}
80+
</style>
81+
</head>
82+
<body>
83+
<div id="wrap">
84+
<img src="rubysnmp.gif" alt="Ruby SNMP" width="290" height="50"/>
85+
86+
<div id="main">
87+
88+
<h2>Network Management the Ruby Way</h2>
89+
<img src="equipment.jpg" alt="Network Equipment" width="200" height="118" style="float:right"/>
90+
<p>If you want to write network management applications in Ruby, you're probably going to need an SNMP library. The goal of the Ruby SNMP project is to create an interface to SNMP that has the same intuitive, joyful feeling that the Ruby programming language does. With a crusty, old protocol like SNMP this is easier said than done, but we're working on it!</p>
91+
92+
<h2>Getting Started</h2>
93+
94+
<h3>Install</h3>
95+
<p>If you already have <a href="http://docs.rubygems.org/">RubyGems</a> all you need to do is:</p>
96+
<p><code>gem install snmp</code></p>
97+
<p>If you don't have RubyGems then <a href="http://rubyforge.org/frs/?group_id=126">go get it</a>. Otherwise, you will need to <a href="http://rubyforge.org/projects/snmplib/">download</a> the library from RubyForge, uncompress it, and run install.rb to install it.</p>
98+
99+
<h3>Import MIBs</h3>
100+
<p>If you are using standard <a href="http://www.ietf.org/">IETF</a> MIBs then you're ready to go. Most of the IETF MIBs have been included for you with Ruby SNMP. Just list the MIBs that you need when you open your SNMP session and you will have full symbolic access to all of the OIDs.</p>
101+
102+
<pre><code>
103+
SNMP::Manager.open(:MibModules =&gt; ["DOCS-IF-MIB"]) do |snmp|
104+
mac = ".0.224.111.203.106.116"
105+
value = snmp.get_value("docsIfCmtsCmPtr" &lt;&lt; mac)
106+
end</code></pre>
107+
108+
<p>If you don't provide a MIB list then the default MIBs are loaded: SNMPv2-MIB, IF-MIB, IP-MIB, TCP-MIB, UDP-MIB</p>
109+
110+
<p>If you want to import custom MIBs, then have a look at the <a href="doc/index.html">documentation</a> for the <code>SNMP::MIB</code> class. If you use the <code>import_module</code> method, you will need to install <a href="http://www.ibr.cs.tu-bs.de/projects/libsmi/">libsmi</a> first, or create the required YAML file manually.</p>
111+
112+
<h3>Start Coding</h3>
113+
114+
<p>Have a look at the <a href="doc/index.html">documentation</a> for the <code>SNMP::Manager</code> class. This class provides the main interface for sending and receiving SNMP PDUs.</p>
115+
116+
<p>Here's an example to get you started. You can find plenty more in the <a href="doc/index.html">README</a> file</p>
117+
<pre><code>
118+
require 'snmp'
119+
120+
ifTable_columns = ["ifIndex", "ifDescr", "ifInOctets", "ifOutOctets"]
121+
SNMP::Manager.open(:Host =&gt; 'localhost') do |manager|
122+
manager.walk(ifTable_columns) do |row|
123+
row.each { |vb| print "\t#{vb.value}" }
124+
puts
125+
end
126+
end</code></pre>
127+
128+
<h2>Useful SNMP Tools</h2>
129+
130+
<h3>libsmi</h3>
131+
132+
<p>The <a href="http://www.ibr.cs.tu-bs.de/projects/libsmi/">libsmi</a> distribution includes some very useful tools for checking, analyzing, converting, and comparing MIBs. It also contains a complete archive of IETF and IANA MIBs which saves you from having to find and download them yourself.</p>
133+
134+
<h3>Net-SNMP</h3>
135+
136+
<p><a href="http://net-snmp.sourceforge.net/">Net-SNMP</a> includes SNMP libraries for implementing SNMP agents and managers in C and a set of SNMP tools for setting and getting information from SNMP agents.</p>
137+
138+
</div>
139+
<div id="sidebar">
140+
<h3><a href="doc/index.html">Documentation &raquo;</a></h3>
141+
<h3><a href="http://rubyforge.org/projects/snmplib/">Download &raquo;</a></h3>
142+
<h3>Happy Users</h3>
143+
<div id="quotes">
144+
<p>&ldquo;I'd like to thank you for such a fantastic library.&rdquo;</p>
145+
<p>&ldquo;This is excellent - better functionality than Perl's Net::SNMP
146+
module.&rdquo;</p>
147+
<p>&ldquo;Your work alone heightens my interest in Ruby quite a bit.&rdquo;</p>
148+
</div>
149+
<p>Have feeback? Send it <a href="http://rubyforge.org/sendmessage.php?touser=842">via RubyForge</a>.</p>
150+
<h3>What is SNMP?</h3>
151+
<p>SNMP is the Simple Network Management Protocol. This protocol provides the capability to monitor and manage switches, routers, printers, desktops, and other equipment in your network.</p>
152+
153+
<h3>What is Ruby?</h3>
154+
<p>Ruby is the interpreted scripting language for quick and easy object-oriented programming. It has many features to process text files and to do system management tasks (as in Perl). It is simple, straight-forward, extensible, and portable.</p>
155+
<p>Find out more at <a href="http://www.ruby-lang.org/en/">www.ruby-lang.org</a>.</p>
156+
<p>&nbsp;</p>
157+
158+
</div>
159+
</div>
160+
</body>
161+
</html>

‎content/rubysnmp.gif‎

4.51 KB
Loading

‎generate.rb‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
require 'fileutils'
2+
3+
ROOT_PATH = File.dirname(File.expand_path(__FILE__))
4+
SRC_DIR = ROOT_PATH + "/content"
5+
DEST_DIR = ROOT_PATH + "/web"
6+
7+
FileUtils.rm_rf DEST_DIR
8+
FileUtils.mkdir_p DEST_DIR
9+
10+
Dir.glob(SRC_DIR + "/*").each do |name|
11+
puts "#{name}...copying"
12+
FileUtils.cp(name, DEST_DIR + "/" + File.basename(name))
13+
end
14+
15+
puts "Documentation...copying"
16+
FileUtils.cp_r(ROOT_PATH + "/../doc", DEST_DIR + "/doc")
17+
18+
19+

‎rubysnmp.psd‎

89.3 KB
Binary file not shown.

‎upload.sh‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
#!/bin/sh
2+
scp -r web/* davehal@rubyforge.org:/var/www/gforge-projects/snmplib

0 commit comments

Comments
 (0)