sun microsystems Systems Architecture Committee _________________________________________________________________ Subject: NWAM Phase 1 Submitted by: Renee Danson File: PSARC/2008/532/opinion.ms Date: March 25th, 2009 Committee: James D. Carlson, Mark Carlson, Richard Matthews, Sebastien Roy, Gary Winiger. Product Approval Committee: Solaris PAC solaris-pac@sun.com 1. Summary 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. 2. Decision & Precedence Information The project is approved as specified in references [1] through [3]. The project may be delivered in a Minor release of Solaris and OpenSolaris, via the ON and GNOME consolidations. 3. Interfaces The project exports the following interfaces. ____________________________________________________________________________ | Interfaces Exported | |________________________________|____________________|____________________| |Interface | Classification | Comments | |________________________________|____________________|____________________| |/usr/sbin/nwamadm | Committed | | |/usr/sbin/nwamcf | Committed | | |netadm | Project Private | reserved UID | |netadm | Project Private | reserved GID | |netcfgd | Project Private | Config repo daemon| |________________________________|____________________|____________________| PSARC/2008/532 Copyright 2009 Sun Microsystems - 2 - ____________________________________________________________________________ | Interfaces Exported | |________________________________|____________________|____________________| |Interface | Classification | Comments | |________________________________|____________________|____________________| |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-.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 | |________________________________|____________________|____________________| The project imports the following interfaces. _________________________________________________________ | Interfaces Imported | |_____________|________________|________________________| |Interface | Classification| Comments | |_____________|________________|________________________| |/etc/nwam/llp| Obsolete | Handled during upgrade| |_____________|________________|________________________| 4. Opinion PSARC/2008/532 Copyright 2009 Sun Microsystems - 3 - 5. Futures 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. An important distinction to note is that the Nevada instal- lation (including Jumpstart) does not enable NWAM by default. The only installer that enables it by default is the new OpenSolaris Caiman. 5.1. VNIC Problems 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. 5.1.1. Auditing The project team was reminded that they should coordinate with the Solaris Audit project team to make sure that the newest requirements are met. 6. Minority Opinion(s) None 7. Advisory Information None 8. Appendices 8.1. Appendix A: Technical Changes Required None 8.2. Appendix B: Technical Changes Advised 1. NWAM should be able to coexist with VNICs. It need not configure them in this phase of the pro- ject, but it should not prevent them from being used on the system by manual configuration. PSARC/2008/532 Copyright 2009 Sun Microsystems - 4 - 8.3. Appendix C: Reference Material Unless stated otherwise, path names are relative to the case directory PSARC/2008/532. ** Reference Material listed here. ** PSARC/2008/532 Copyright 2009 Sun Microsystems