Move SMA from /usr/sfw to /usr [PSARC/2008/227 FastTrack timeout 04/09/2008]

[Don Cragun]

I am including updated materials for this case from Basabi
Bhattacharya.  I am changing the status from "waiting need spec" back
to "fast-track" and setting the timer to expire on October 9, 2008.

Before the case was moved to waiting need spec status, Darren
commented:

> >       The following will move from /usr/sfw/lib/sma_snmp/ into
> >       /usr/lib/sma_snmp/:
> ...
> >       snmpd.conf
> 
> What is the relationship between this file and the documented 
> /etc/sma/snmp/snmpd.conf ?
> 
> This originally caught my attention because it was a .conf file in /usr/lib.

See section 4.2 below.

> >	fixproc
> That looks rather generic a name to have as /usr/bin/fixproc.  I notice 
> it also looks for a file called /local/etc/fixproc.conf - that seems 
> very strange.

The project team agrees that fixproc is a generic name, but it is a
documented interface on our current sma_snmp(5) man page.  This case
moves it one directory level closer to / (from /usr/sfw/bin/fixproc to
/usr/bin/fixproc), but does not change the existing documented
interface.  However, the sma_snmp(5) man page says that the following
man pages should be present, but are not currently found:
encode_keychange(1M), fixproc(1M), and net-snmp-config(1M).  CR 6755231
has been filed by the project team to add these missing pages.
However, creating these pages is not part of this project.

 - Don

Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
This information is Copyright 2008 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 Move SMA from /usr/sfw to /usr
    1.2. Name of Document Author/Supplier:
	 Author:  Basabi Bhattacharya
    1.3  Date of This Document:
	2 October, 2008

4. Technical Description

4.1 Summary

	This case proposes to move the System Management Agent (SMA)
	suite of commands, libraries, and documentation from /usr/sfw/
	into /usr/.  Interface Stability Classifications are not being
	changed.

	The same packages are provided (SUNWsfwdemo, SUNWsfwhea,
	SUNWsmagt, SUNWsmcmd, SUNWsmdoc, and SUNWsmmgr).  A few
	symbolic links are added (as detailed below) to the packages
	containing the files to which the symlinks point.  Otherwise,
	the packages are the same except for the directories into which
	files delivered by the packages will be installed.

	A Minor release binding is proposed.

4.2 SNMP request daemons

	Currently there are two daemons available to respond to SNMP
	request packets on Solaris systems.  The default Solaris
	facility is described by the snmpd(1M) man page.  This case
	moves this facility up from directories under /usr/sfw into
	corresponding directories directly under /usr.

	The other is the Sun Solstice Enterprise Master Agent described
	by the snmpdx(1M) man page.  This man page contains the note:
		"The SMA (Systems Management Agent) is the default
		 SNMP agent in the Solaris operating system.  See
		 netsnmp(5).  snmpdx is Obsolete and may not be
		 supported in a future release of Solaris."

	This case does not alter the way either of these daemons work.
	Each can be enabled and started by SMF.  By default, they use
	disjoint sets of configuration files; so either facility can be
	run without affecting the behavior of the other.  A system
	administrator could use the options specified on their man
	pages to set both facilities to use the same configuration
	files.  Since SNMP uses ports 161 and 162 by default, the
	behavior is undefined if both snmpd and snmpdx are enabled and
	run concurrently using the default ports.

4.3 Details

	In keeping with PSARC/2005/185 (Enabling serendipitous
	discovery) System Management Agent (SMA) files will be
	moved from /usr/sfw/ into /usr/.  Compatibility links
	will be left behind for all utilities in /usr/sfw/bin/
	and /usr/sfw/sbin.  Compatibility links will not be
	left behind for SMA libraries nor for SMA documentation.

4.3.1 Libraries

	The following will be moved from /usr/sfw/lib/ into /usr/lib/
	with no compatibility links left behind:
		libentity.so
		libnetsnmp.so
		libnetsnmp.so.5
		libnetsnmp.so.5.0.9
		libnetsnmpagent.so
		libnetsnmpagent.so.5
		libnetsnmpagent.so.5.0.9
		libnetsnmphelpers.so
		libnetsnmphelpers.so.5
		libnetsnmphelpers.so.5.0.9
		libnetsnmpmibs.so
		libnetsnmpmibs.so.5
		libnetsnmpmibs.so.5.0.9
		libseaExtensions.so
		libseaProxy.so

	The following will move from /usr/sfw/lib/sparcv9/ into
	/usr/lib/sparcv9/:
		libentity.so
		libnetsnmp.so
		libnetsnmp.so.5
		libnetsnmp.so.5.0.9
		libnetsnmpagent.so
		libnetsnmpagent.so.5
		libnetsnmpagent.so.5.0.9
		libnetsnmphelpers.so
		libnetsnmphelpers.so.5
		libnetsnmphelpers.so.5.0.9
		libnetsnmpmibs.so
		libnetsnmpmibs.so.5
		libnetsnmpmibs.so.5.0.9
		libseaExtensions.so
		libseaProxy.so

	The following will move from /usr/sfw/lib/amd64 into
	/usr/lib/amd64/:
		libentity.so
		libnetsnmp.so
		libnetsnmp.so.5
		libnetsnmp.so.5.0.9
		libnetsnmpagent.so
		libnetsnmpagent.so.5
		libnetsnmpagent.so.5.0.9
		libnetsnmphelpers.so
		libnetsnmphelpers.so.5
		libnetsnmphelpers.so.5.0.9
		libnetsnmpmibs.so
		libnetsnmpmibs.so.5
		libnetsnmpmibs.so.5.0.9
		libseaExtensions.so
		libseaProxy.so

	The following will move from /usr/sfw/lib/sma_snmp/ into
	/usr/lib/sma_snmp/:
		masfcnv
		masfd
		sma_buildrev
		snmpd.conf

4.3.2 Utilities

	The following will move from /usr/sfw/sbin/ into /usr/sbin/
	with compatibility links left behind in /usr/sfw/sbin/:
		snmpd
		snmptrapd

	The following will move from /usr/sfw/sbin/i86/ into
	/usr/sbin/i86/ with compatibility links left behind in
	/usr/sfw/sbin/i86/:
		snmpd
		snmptrapd

	The following will move from /usr/sfw/sbin/amd64/ into
	/usr/sbin/amd64/ with compatibility links left behind in
	/usr/sfw/sbin/amd64/:
		snmpd
		snmptrapd

	The following will move from /usr/sfw/bin/ into /usr/bin/ with
	compatibility links left behind in /usr/sfw/bin/:
		fixproc
		mib2c
		mib2c.perl
		net-snmp-config (symlink to net-snmp-config-32)
		net-snmp-config-32
		net-snmp-config-64
		snmpbulkget
		snmpbulkwalk
		snmpconf
		snmpdelta
		snmpdf
		snmpget
		snmpgetnext
		snmpinform
		snmpnetstat
		snmpset
		snmpstatus
		snmptable
		snmptest
		snmptranslate
		snmptrap
		snmpusm
		snmpvacm
		snmpwalk

4.3.3 Documentation

	SMA html files will move from /usr/sfw/share/doc/sma_snmp/html/
	into /usr/share/doc/sma_snmp/html/.

	Any references to pathnames of files being moved by this case
	that exist in our man pages will be updated to reflect the
	changed locations.

5. References

	CR 6754005:	SNMP man pages upate - PSARC/2008/227
	CR 6755231:	SNMP missing man pages - encode_keychange(1M),
			    fixproc(1M), and net-snmp-config(1M)
	LSARC/2003/103:	System Management Agent
	PSARC/2005/185:	Enabling serendipitous discovery

6. Resources and Schedule
    6.4. Steering Committee requested information
	6.4.1. Consolidation C-team Name:
		SFW
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open