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/nwamcfg | Committed | | |netadm | Consolidation Private| reserved UID | |netadm | Consolidation Private| reserved GID | |nwamd | Project Private | | |________________________________|_______________________|_____________________| PSARC/2008/532 Copyright 2009 Sun Microsystems - 2 - ________________________________________________________________________________ | Interfaces Exported | |________________________________|_______________________|_____________________| |Interface | Classification | Comments | |________________________________|_______________________|_____________________| |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. | 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-.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| |_____________|________________|________________________| PSARC/2008/532 Copyright 2009 Sun Microsystems - 3 - 4. Opinion 4.1. 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. 4.2. VNIC Problems 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. 4.3. 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. 5. Minority Opinion(s) None 6. Advisory Information None 7. Appendices 7.1. Appendix A: Technical Changes Required None 7.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 PSARC/2008/532 Copyright 2009 Sun Microsystems - 4 - project, but it should not prevent them from being used on the system by manual configuration. 7.3. Appendix C: Reference Material Unless stated otherwise, path names are relative to the case directory PSARC/2008/532. 1. Architecture and Design Specification File: commitment.materials/spec/index.html 2. PSARC Questionnaire File: commitment.materials/20qs 3. Draft Man Pages File: commitment.materials/manpages/ PSARC/2008/532 Copyright 2009 Sun Microsystems