.de Sc
\\s-1\\$1\\s0\\$2
..
.ds cA 2008/532
.ds aR \s-1PSARC\s0
.LP
.so ../../amac
.Co
.ds LF \fI\*(aR/\*(cA\fP
.ds RF \fICopyright 2009 Sun Microsystems\fP
.if n .ds CF
.IP \fBSubject:\fP 15
NWAM Phase 1
.IP "\fBSubmitted by:\fP" 15
Renee Danson
.IP \fBFile:\fP 15
\*(aR/\*(cA/opinion.ms
.IP \fBDate:\fP 15
March 25th, 2009
.IP "\fBCommittee:\fP" 15
James D. Carlson,
Mark Carlson,
Richard Matthews,
Sebastien Roy,
Gary Winiger.
.IP "\fBProduct Approval Committee:\fP" 15

Solaris PAC
.br
solaris-pac@sun.com

.pn 2
.NH
Summary
.LP
The Network Automagic (NWAM) Phase 1 project is the second phase of
NWAM.  It completely replaces the earlier "Network Auto-Magic (NWAM)"
(PSARC 2007/132), "NWAM Phase 0.5 (picea)" (PSARC 2008/482), and "NWAM
Picea Addenda" (PSARC 2008/736) functionality with a new design and
more flexible networking options.
.NH
Decision & Precedence Information
.LP
The project is approved as specified in references [1] through [3].
.LP
The project may be delivered in a Minor release of Solaris and
OpenSolaris, via the ON and GNOME consolidations.
.NH
Interfaces
.LP
The project exports the following interfaces.
.if n .ne 8
.if t .ne 3
.TS H
box;
c s s
l | l | l.
Interfaces Exported
_
Interface	Classification	Comments
_
.TH
/usr/sbin/nwamadm	Committed
/usr/sbin/nwamcfg	Committed
netadm	Consolidation Private	reserved UID
netadm	Consolidation Private	reserved GID
nwamd	Project Private
netcfgd	Project Private	Config repo daemon
netcfg	Consolidation Private	reserved UID
/lib/svc/method/net-ipqos	Project Private
/lib/svc/method/net-loc	Project Private
/lib/svc/method/net-netmask	Project Private
network/network-ipqos.xml	Project Private	SMF manifest
network/network-location.xml	Project Private	SMF manifest
network/network-netcfg.xml	Project Private	SMF manifest
network/network-netmask.xml	Project Private	SMF manifest
/usr/bin/nwam-manager-properties
solaris.network.autoconf.read	Committed	Authorization
solaris.network.autoconf.write	Committed	Authorization
solaris.network.autoconf.refresh	Committed	Authorization
/etc/svc/volatile/nwam	Project Private	volatile directory
  nwam/nwam_door	Project Private	door file
  nwam/nwam_backend_door	Project Private
  nwam/nwam_event_msgs.<pid>	Project Private	message queue file
  nwam/Legacy	Project Private	Saved Location Data
  nwam/create_loc_legacy	Project Private	private script
libnwam.so.1	Contr. Cons. Priv.	Library ON/GNOME
libnwam.h	Contr. Cons. Priv.	Header ON/GNOME
libinetcfg.so.1	Cons. Priv.	New interfaces
/etc/nwam/enm.conf	Project Private	profile repository
/etc/nwam/known_wlan.conf	Project Private
/etc/nwam/loc.conf	Project Private
/etc/nwam/ncp-<name>.conf	Project Private
svc:/network/ipqos	Cons. Priv.
svc:/network/location	Cons. Priv.
svc:/network/netmask	Cons. Priv.
svc:/network/netcfg	Cons. Priv.
svc:/network/service	Obsolete	remove in future
Automatic	Committed	Built-in location
NoNet	Committed	Built-in location
Legacy	Committed	Built-in location
.TE
.LP
The project imports the following interfaces.
.if n .ne 8
.if t .ne 3
.TS H
box;
c s s
l | l | l.
Interfaces Imported
_
Interface	Classification	Comments
_
.TH
/etc/nwam/llp	Obsolete	Handled during upgrade
.TE
.NH
Opinion
.LP
.NH 2
Futures
.LP
A substantial amount of the discussion centered on issues that the
project team considers to be items for future work, including servers,
automated installers, VLANs, and NTP.  The project team explained that
there are still more phases coming, and that this one, like the
previous phase, addresses lower-end users, so these concerns are out
of scope for this project.  The ARC members agreed with this
explanation.
.LP
An important distinction to note is that the Nevada installation
(including Jumpstart) does not enable NWAM by default.  The only
installer that enables it by default is the new OpenSolaris Caiman.
.NH 2
VNIC Problems
.LP
An ARC member noted that with the existing NWAM Phase 0, VNICs are not
brought online at boot time.  While the users for which this project
is designed may not have a need for these more advanced features, it
would be desirable to have the features not be in direct conflict with
each other.  The discussion of this issue led to the technical change
advised, described below.
.NH 2
Auditing
.LP
The project team was reminded that they should coordinate with the
Solaris Audit project team to make sure that the newest requirements
are met.
.NH
Minority Opinion(s)
.LP
None
.NH
Advisory Information
.LP
None
.NH
Appendices
.NH 2
Appendix A: Technical Changes Required
.LP
None
.NH 2
Appendix B: Technical Changes Advised
.LP
.RS
.IP 1.
NWAM should be able to coexist with VNICs.  It need not configure them
in this phase of the project, but it should not prevent them from
being used on the system by manual configuration.
.RE
.NH 2
Appendix C: Reference Material
.LP
Unless stated otherwise, path names are relative to the case
directory \*(aR/\*(cA.
.IP 1.
Architecture and Design Specification
.br
File:
commitment.materials/spec/index.html
.IP 2.
PSARC Questionnaire
.br
File:
commitment.materials/20qs
.IP 3.
Draft Man Pages
.br
File:
commitment.materials/manpages/