.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/nwamcf	Committed
netadm	Project Private	reserved UID
netadm	Project Private	reserved GID
netcfgd	Project Private	Config repo daemon
netcfg	Project 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_door	Private Private	door file
/etc/svc/volatile/nwam	Project Private	volatile directory
nwamd_soft_reset	Project Private	volatile flag file
nwam/location_ready	Project Private	volatile flag file
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 1
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 the existing NWAM Phase 0 causes VNICs to
fail 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 3
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.
** Reference Material listed here. **