Wiki code for Brussels - unified network link configuration

Hide Line numbers
1: |
2: == What’s New
3: * Brussels II Presentation
4:  We have uploaded a presentation which provides a quick overview of the project, various subcommands in /sbin/ipadm(1m) and some design questions that will be addressed as part of the project. Presentation is available [[here >>attach:Project brussels.files@Brusselsphase2.pdf]]
5: * Brussels II Design document
6:  Latest version (v1.7) of the design document is now available [[here>>attach:Project brussels.files@brussels2.pdf]].
7: * ifconfig(1m)/ipadm(1m) feature mapping
8:  At [[here>>Project brussels.ifconfig_ipadm_feature_mapping]] you can find a table, which provides one-to-one feature mapping between ifconfig(1m) and ipadm(1m)
9: * Access to ’ipadm-gate’
10:  To access the mercurial repository of ’ipadm’ development gate, click [[here>>http://src.opensolaris.org/source/xref/brussels/ipadm-gate]]. If you are interested in contributing please send us an email [[brussels-dev@opensolaris.org>>mailto:brussels-dev@opensolaris.org]]
11: 
12: ==  Project Overview
13: 
14: The objective of the Brussels Project is to provide a standard set of Interfaces for network configuration. The first phase of this project provided interfaces for configuring all GLDv3 network drivers via dladm.
15: 
16:  As more drivers are plugging into the framework provided by Brussels I, we are also evaluating a similar improved configuration method for TCP/IP tunables - the problem area and proposed solution for Brussels II (work in progress) are described [[here>>attach:Project brussels.files@brussels2.pdf]]. As with Phase I, the primary motivation for this project is the well-known weakness of /sbin/ndd in providing persistent network configuration of TCP/IP parameters. In addition, Brussels II will introduce a libipadm library that will provide a set of Stable Interfaces for managing IP interfaces.
17: 
18: We welcome comments and feedback - please join the [[ brussels-dev>>Project brussels.mailing-lists]] list to send us your input.
19: 
20: ===  Overview of Brussels II
21: 
22: In the first phase of this project, we will implement a utility /sbin/ipadm(1m) and a dynamic shared object /lib/libipadm.so.1
23: 
24: The utility ’ipadm(1M)’ will allow system administrators to persistently set TCP/IP tunables so that the settings will be reactivated on subsequent reboot. This utility overcomes well-known inadequacies of ndd(1M), which has been the constant complaint from SE’s in the field and System administrators. The initial delivery would include:
25: 
26: * link plumb/unplumb
27: * IP address management (add/delete/show)
28: * tunable parameters setting and retrieval (set/get)
29: 
30: The library ’libipadm.so.1’ will lay the foundation for an extensible networking library and will provide stable interfaces which can be used by multiple configuration tools. Today the frequent problem encountered by applications trying to plug into the networking code is lack of any ’interfaces’. A classic example of this is IP interface plumbing. The code which implements this feature is part of ifconfig(1M) alone and all the applications which need it are either forced to copy/paste the code or spawn (i.e., fork(2) and exec(2)) a copy of ifconfig. The former approach is fragile and will create a nightmare in terms of maintainability and the latter approach is inefficient.
31: 
32: ===  Key Brussels II Milestones
33: 
34: ----
35: 
36: ===  Overview of Brussels I
37: 
38: In the first Phase of this project, we implemented extensions to the GLDv3 framework and associated /sbin/dladm utility to provide a much-needed, and vastly improved, Stable Interface for datalink drivers that had previously been forced to use ndd to dynamically modify parameters.
39: 
40: In addition to providing a frame-work for the configuration of datalink driver parameters, Brussels I brought with it
41: 
42: * persistent property configuration, so that parameter settings are restored when the driver is restarted (a feature notably lacking with ndd(1m))
43: * provision for dynamic tuning of many parameters like mtu (which has tradtionally beem tuned with driver.conf(4), with modifications requiring destructive resets like reboot)
44: * a uniform name-space for parameters (no more dilemmas like "link\_duplex or link\_mode?", "half\_duplex == 0, or half\_duplex == 1"?)
45: 
46:  Here are some reference documents for Brussels I
47: 
48: * [[A Uniform Interface for Driver Administration Through the dladm Command >>http://www.sun.com/bigadmin/sundocs/articles/nicddladmconf.jsp]] - published in BigAdmin
49: * high-level [[design doc >>attach:Project brussels.files@brussels.pdf]]
50: * PSARC 2007/429 [[ Brussels framework >>http://arc.opensolaris.org/caselog/PSARC/2007/429/]]
51: * PSARC 2008/171 [[Brussels ndd compatibility >>http://arc.opensolaris.org/caselog/PSARC/2008/171]]
52: * [[Latest fast-track doc >>attach:Project brussels.files@nddcompat.txt]]
53: * PSARC 2008/175 [[ Brussels Framework enhancements >>http://arc.opensolaris.org/caselog/PSARC/2008/175]]
54: * [[Latest fast-track doc>>attach:Project brussels.files@default.txt]]
55: * PSARC 2008/222 [[Brussels Persistence>>http://arc.opensolaris.org/caselog/PSARC/2008/222/]]
56: 
57: We have also put together an interactive prototype of our proposed [[ GUI >>Project brussels.proto]] that will eventually be integrated into NWAM - please try it out and send us your input!
58: 
59: ===  Key Brussels I Milestones
60: 
61: * PSARC 2007/396 ("Removal of duplicate BGE/NGE kstats ") (Raymond Li putback to onnv71)
62: * PSARC 2007/429 framework component commitment review completed Oct 17 2007
63: * Brussels interactive GUI prototype available (Raoul Carag/Jenya Gestrin Nov 2007)
64: * PSARC 2007/429 putback to onnv_83 Jan 24 2008
65: * PSARC 2008/171 ("Brussels NDD compatibility") fast-track approved March 2008
66: * PSARC 2008/175 ("Brussels Framework enhancements") fast-track approved March 2008
67: * nge driver Brussels putback to onnv_86 (Miles Xu/Jason King March 18 2008)
68: * e1000g driver Brussels putback to onnv_88 (Chenlu Chen/Ted You April 10 2008)
69: * nxge driver Brussels putback to onnv_88 (May Lin Apr 14 2008)
70: * PSARC 2008/171 putback to onnv_90
71: * Brussels putback to onnv_93
OpenSolaris

Top Menu

Wiki code for Brussels - unified network link configuration

Search

Collectives

Community Group

Project

User Group

Subsites

Project brussels Pages
