COVALENT SNMP QUICK START GUIDE
Version 1.0.3

Please read the licenses included in the licenses directory of the
distribution before installing the software.

***************************************************************************
INTRODUCTION

This quick start guide includes instructions for installing the Covalent
SNMP module with the installer provided by Covalent. For more
detailed information about installation and configuration, please read the
Covalent SNMP User Guide. If you want to install this product
manually, refer to "Appendix A: Manual installation" in the user guide.

***************************************************************************
INSTALLATION REQUIREMENTS

To install Covalent SNMP 2.0, you need:

1	The Apache HTTP (Web) server.

	Use either the Apache binary distribution included with Covalent
	SNMP (recommended)

		or

	Use Covalent SNMP with your existing Apache installation.

	To verify whether your current installation is suitable for adding
	Covalent SNMP, run the httpd -l command in the apache/bin
	directory and verify that mod_so.c is present in the list that
	displays.

	NOTE:	If you have an Apache installation which is EAPI enabled
	and older than Apache 1.3.9, you may encounter problems linking our
	module to your existing Apache installation. You need to upgrade
	prior to installing the Covalent SNMP module.

2	The X Window System for the graphical user interfaces. A text-based
	user interface is also provided.

3	The gzip decompression utility.

***************************************************************************
DOWNLOADING AND UNPACKING COVALENT SNMP

1	If you do not yet have the Covalent SNMP 2.0
	distribution, purchase a full release of Covalent SNMP
	at:

		http://www.covalent.net/products/snmp

	After your purchase is processed, you will receive an e-mail link
	to the download area.

2	Unpack Covalent SNMP. To unpack the distribution,
	execute:

		gunzip -c CovalentSNMP-1.*-1.3.*-platform.tar.gz| tar xf -

***************************************************************************
INSTALLING COVALENT SNMP WITH THE APACHE BINARY (RECOMMENDED)

1	Start the installation program.
	
	If you are logged in as root, execute the following:

	For graphical mode:

		cd CovalentSNMP-1.*
		./setup

	For text mode:

		cd CovalentSNMP-1.*
		./setup --textmode

	If you are not logged in as root, execute the following to log in
	as root and start the installation program:

	For graphical mode:

		xhost +servername
		su root
		cd CovalentSNMP-1.*
		./setup

	For text mode:

		su root
		cd CovalentSNMP-1.*
		./setup --textmode

	NOTE:	If you are logged in as a non-root user, refer to the
	"Troubleshooting" section in the Covalent SNMP User
	Guide.

2	Follow the instructions in the user interface to install Covalent
	SNMP. If you use the default settings, Covalent SNMP will be
        installed in:

		/usr/local/raven/module/snmp2.0

	and Apache in:

		/usr/local/apache.

	You can choose between installing the Covalent Apache binary or
	linking Covalent SNMP dynamically to your existing Apache
	installation.

3	The installer will ask you which version of SNMP you want to
	install. Check the documentation of your management application to
	verify which versions are supported.

	SNMP versions 1 and 2c send information plaintext over the wire.
	SNMP version 3 provides encryption to prevent unauthorized access.

	If you install SNMP versions 1 and v2c, you should be aware that
	the community string that protects access to your information is
	set to 'public'. If you want to limit access to your SNMP module,
	you should change the community string in the snmpd.conf file in
	the raven/module/snmp2.0/conf directory. This only gives very
	limited protection as communication is not encrypted in SNMP
	versions 1 and 2c. We recommend closing the default SNMP ports
	(161 and 162) on your firewall if you are concerned about
	unauthorized access to your SNMP agents.

4	If you selected to install SNMPv1/v2c, you need to enter your
	network address and subnetmask to enable remote access to your
	Covalent SNMP module.

	The network address is an IP number representing the network in
	which you are operating. The subnet mask indicates which part of
	the IP address denotes the network and subnet, and which part
	denotes the host ID.

	For example, the network address 10.0.0.0 combined with the
	subnetmask 255.255.255.0 indicates that the network has IP
	addresses ranging from 10.0.0.1 to 1.0.0.255.

	NOTE:	If you do not enter your network address and subnet mask,
	your SNMP agent will only be accessible from the localhost.

5	If you selected to install SNMPv3, you must enter an SNMPv3
	password.

	NOTE:	The password must be at least eight characters long.

6	When the Installation Program finishes copying files, the
	Congratulations! screen displays indicating that you have
	successfully installed Covalent SNMP.

***************************************************************************
ADDING SNMP TO YOUR EXISTING APACHE INSTALLATION

1	To add Covalent SNMP to an existing Apache server, verify
	that your installation supports DSOs. To verify, if you're using a
	standard (non-Covalent) Apache installation, execute:

		apache/bin/httpd -l

	The result of this command should include mod_so c. If this module
	is not included in your current Apache installation, you must
	recompile the Apache server with the --enable-module=so flag added
	to the ./configure command.

2	Run ./setup according to the installation procedures in the
	previous section, with following exceptions (steps 3 through 5
	below).

3	When the Install Apache screen displays, choose to add Covalent
	SNMP to your existing Apache installation.

4	When prompted, enter the path to the Apache configuration file.
	The default path to the Apache configuration file is:

		usr/local/apache/conf/httpd.conf

5	When prompted, enter the appropriate commands to start and stop
	your server. The command to start a standard (non-Covalent) Apache
	configuration is:

		/path/to/apache/bin/apachectl start

	The command to start a Covalent Apache installation is:

		/path/to/apache/bin/httpsdctl start

***************************************************************************
STARTING AND STOPPING YOUR SERVER

STARTING YOUR SERVER

If you installed the Apache binary included with Covalent SNMP, to start
your Apache Web server execute:

	apache/bin/httpsdctl start

The output should be:

	httpsdctl start: httpd started

NOTE:	Refer to the "Troubleshooting" section of the Covalent SNMP
User Guide if you have problems starting your server.

STOPPING YOUR SERVER

To stop your Apache Web server execute:

	apache/bin/httpsdctl stop

***************************************************************************
TESTING YOUR INSTALLATION

If the installation was successful, you are now ready to test the
functionality of your Covalent SNMP module.

TESTING IF YOU INSTALLED AS A ROOT USER

The following steps only apply if you installed Covalent SNMP as
a root user. If you did not install as a root user, skip these steps and
proceed to "Testing if you installed as a non-root user" below.

1	Start your Apache Web server.

	The output should be httpdctl start: httpd started for a standard
	(non-Covalent) Apache installation, or httpsdctl start: httpd
	started for a Covalent Apache installation.

2	To test SNMPv1 enter the following, where public is your
	community string:

		raven/module/snmp2.0/bin/snmpwalk -v 1 localhost
		public

	The expected output for this command looks like this:

		system.sysDescr.0 = FreeBSD localhost 4.1-RELEASE FreeBSD
		4.1- Fri Jul i386
		system.sysObjectID.0 = OID:
		enterprises.covalent.covalentGenericMIB.ctGenericOSoid.255
		system.sysUpTime.0 = Timeticks: (2340) 0:00:23.40
		system.sysContact.0 = Covalent SNMP
		<webmaster@localhost.com>
		system.sysName.0 = localhost
		system.sysLocation.0 = Apache Server with Covalent SNMP
		...

3	To test SNMPv2c enter the following, where public is your
	community string:

		raven/module/snmp2.0/bin/snmpwalk -v 2c localhost
		public

	The expected output for this command is the same as for testing
	SNMPv1.

4	To test SNMPv3 enter the following, where password is the password
	you established while installing Covalent SNMP:

		raven/module/snmp2.0/bin/snmpwalk -v 3 -l authNoPriv
		-u covalent -a MD5 -A password localhost

	NOTE:	The default user after installing Covalent SNMP
	is called covalent.
 
	The expected output for this command is the same as for testing
	SNMPv1.

5	Stop your Apache Web server.

TESTING IF YOU INSTALLED AS A NON-ROOT USER

1	Start your Apache Web server.

	The output should be httpdctl start: httpd started for a standard
	(non-Covalent) Apache installation, or httpsdctl start: httpd
	started for a Covalent Apache installation.

2	To test SNMPv1 enter the following, where public is your community
	string:

		raven/module/snmp2.0/bin/snmpwalk -p 1610 -v 1
		localhost public

	The expected output for this command looks like this:

		system.sysDescr.0 = FreeBSD www.localhost 4.1-RELEASE FreeBSD
		4.1- Fri Jul i386
		system.sysObjectID.0 = OID:
		enterprises.covalent.covalentGenericMIB.ctGenericOSoid.255
		system.sysUpTime.0 = Timeticks: (2340) 0:00:23.40
		system.sysContact.0 = Covalent SNMP
		<webmaster@localhost.com>
		system.sysName.0 = localhost
		system.sysLocation.0 = Apache Server with Covalent SNMP
		...

3	To test SNMPv2c enter the following, where public is your community
	string:

		raven/module/snmp2.0/bin/snmpwalk -p 1610 -v 2c
		localhost public

	The expected output for this command is the same as for testing
	SNMPv1.

4	To test SNMPv3 enter the following, where password is the password
	you established while installing Covalent SNMP:

		raven/module/snmp2.0/bin/snmpwalk -p 1610 -v 3 -l
		authNoPriv -u covalent -a MD5 -A password localhost

	NOTE:	The default user after installing Covalent SNMP
	is called covalent.

	The expected output for this command is the same as for testing
	SNMPv1.

5	Stop your Apache Web server.


For more information, please refer to the Covalent SNMP User
Guide at:

	http://www.covalent.net/support/snmp
