1SNMPCONF(1) Net-SNMP SNMPCONF(1)
2
6 snmpconf - creates and modifies SNMP configuration files
7
9 snmpconf [OPTIONS] [fileToCreate]
10 Start with:
12 snmpconf -g basic_setup
13 Or even just:
15 snmpconf
16
18 snmpconf is a simple Perl script that walks you through setting up a
19 configuration file step by step. It should be fairly straight forward
20 to use. Merely run it and answer its questions.
21 In its default mode of operation, it prompts the user with menus show‐
23 ing sections of the various configuration files it knows about. When
24 the user selects a section, a sub-menu is shown listing of the descrip‐
25 tions of the tokens that can be created in that section. When a
26 description is selected, the user is prompted with questions that con‐
27 struct the configuration line in question.
28 Finally, when the user quits the program any configuration files that
30 have been edited by the user are saved to the local directory, fully
31 commented.
32 A particularly useful option is the -g switch, which walks a user
34 through a specific set of configuration questions. Run:
35 snmpconf -g basic_setup
37 for an example.
39
41 -f Force overwriting existing files in the current directory with‐
42 out prompting the user if this is a desired thing to do.
43 -i When finished, install the files into the location where the
45 global system commands expect to find them.
46 -p When finished, install the files into the users home direc‐
48 tory's .snmp subdirectory (where the applications will also
49 search for configuration files).
50 -I DIRECTORY
52 When finished, install the files into the directory DIRECTORY.
53 -a Don't ask any questions. Simply read in the various known con‐
55 figuration files and write them back out again. This has the
56 effect of "auto-commenting" the configuration files for you.
57 See the NEAT TRICKS section below.
58 -rall|none
60 Read in either all or none of the found configuration files.
61 Normally snmpconf prompts you for which files you wish to read
62 in. Reading in these configuration files will merge these
63 files with the results of the questions that it asks of you.
64 -R FILE,...
66 Read in a specific list of configuration files.
67 -g GROUPNAME
69 Groups of configuration entries can be created that can be used
70 to walk a user through a series of questions to create an ini‐
71 tial configuration file. There are no menus to navigate, just
72 a list of questions. Run:
73 snmpconf -g basic_setup
75 for a good example.
77 -G List all the known groups.
79 -c CONFIGDIR
81 snmpconf uses a directory of configuration information to learn
82 about the files and questions that it should be asking. This
83 option tells snmpconf to use a different location for configur‐
84 ing itself.
85 -q Run slightly more quietly. Since this is an interactive pro‐
87 gram, I don't recommend this option since it only removes
88 information from the output that is designed to help you.
89 -d Turn on lots of debugging output.
91 -D Add even more debugging output in the form of Perl variable
93 dumps.
94
96 snmpconf -g basic_setup
97 Have I mentioned this command enough yet? It's designed to walk
98 someone through an initial setup for the snmpd(8) daemon.
99 Really, you should try it.
100 snmpconf -R /usr/local/snmp/snmpd.conf -a -f snmpd.conf
102 Automatically reads in an snmpd.conf file (for example) and adds
103 comments to them describing what each token does. Try it. It's
104 cool.
105
107 snmpconf is actually a very generic utility that could be easily con‐
108 figured to help construct just about any kind of configuration file.
109 Its default configuration set of files are SNMP based.
110
112 snmpd(8), snmp_config(5), snmp.conf(5), snmpd.conf(5)
1134th Berkeley Distribution 08 Feb 2002 SNMPCONF(1)