Phase 0.5

This release of NWAM will be part of OpenSolaris 2008.11, and has delivered into Nevada builds 99 (GNOME GUI) and 100 (ON).

The ON code review is complete.  The
webrev contains
the changes that were under review.  Any additional issues should be filed as bugs under solaris/network/config.

Design

The reviewed design document (version 1.2; with changes due to code
review) is available:

- ON Design

Documentation

The phase 0.5 nwamd(1M) man page is here.  A sys-admin wiki will be available soon.

Source

The source for that design document is usr/doc/picea-on-design.tex in
the project ON gate.  The picea ON gate is in Mercurial:

    ssh://anon@hg.opensolaris.org/hg/nwam/picea

The gate is locked, because the project is complete.

Binaries

Binaries of the final ON bits before integration (version 013) are
still available as self-installing archives (these take care of the
merge issues required with the RBAC files):

- SPARC 013
- x86 013

To install the binaries, just do this:

    # sh ./picea-install-\{{code}}arch{{/code}}-013

Except in extraordinary cases, these bits should not be used.  Use
the bits that have been delivered to ON instead.

GUI Binaries

The GUI to match version picea 008 or above is available for download here:
- SPARC NWAM UI 0.5.9 Binaries for picea 013
- x86 NWAM UI 0.5.9 Binaries for picea 013

To install these binaries, replacing some existing binaries, you will need at
least snv_94 - with GNOME 2.22 in it, you can check the version of GNOME by
typing:

    # /usr/bin/gnome-session \-\-version
    GNOME gnome-session 2.22.2

You can then install the above binaries by extracting the tarball and running
the script contained in it - update_to_nwam.sh:

    # gzip -cd NWAM~_Manager-\{{code}}uname -p\{{/code}}-2008-09-18.tar.gz | tar xvf -
    # cd NWAM~_Manager-\{{code}}uname -p\{{/code}}
    # sh ./update~_to~_nwam.sh

This should install the binaries using SVR4 packages. Once this is done, you
should log out and log back in again if on Solaris, on OpenSolaris you will
need to reboot.

These binaries include updates to several elements, not just the NWAM UI:

- Updated SUNWgnome-system-tools to provide ability to switch between Manual and Automatic configuration easily.
  - Updated SUNWgnome-dialog (zenity) needed for this
- Updated SUNWgnome-intranet-applets to provide an updated GNOME netstatus applet with wifi support.
- Finally, but not least, the new UI for NWAM Picea. 

If you only wish to see the latter part, edit the update_to_nwam.sh script to
only refer to SUNWnwam-manager and SUNWnwam-manager-root in the package list
and also replacing "all" in the package add, to read more like::

    PKGS='SUNWnwam-manager SUNWnwam-manager-root'
    
    for pkg in ${PKGS};do
        yes | pfexec pkgrm $pkg
    done
    
    yes | pfexec pkgadd -d NWAM~_Manager-\{{code}}uname -p\{{/code}}.pkg ${PKGS}
    
    echo svcadm restart postrun
    pfexec svcadm restart postrun

Naturally I would prefer if you looked at the change as a whole, not just the
UI for NWAM.

Bugs should be logged at:

- Log to defect.opensolaris.org
- Sun Internal Bugtracking system : using the category jds/gnome/sysadmin

GUI Developers

There are also packages for GUI build servers that are dependent on
the libnwam private library.  These packages are:

- SPARC
- x86

To install these, do something like this:

    # pkgrm SUNWnwamintr SUNWnwamintu
    # gunzip -c picea-pkg-\{{code}}arch\{{/code}}-013.tar.gz | ( cd /tmp ; tar xf - )
    # pkgadd -d /tmp SUNWnwamintr SUNWnwamintu

Important Installation Notes

- When upgrading using the now-obsolete ON installer, download both the ON picea-install- and GUI packages first.  Then run the ON picea-install- script, as that shuts down the 'nwam' service intentionally.  Then install the GUI bits.  And then finally enable nwam again with:

    # svcadm enable nwam

- The packaging for the GUI bits uses traditional System V packages, and since it updates some of the common packages that are installed via IPS on OpenSolaris, the installer doesn't play too nice on the OpenSolaris distribution.  You'll need to remove some things manually to get to the point where the GUI installs:

    % pfexec pkg uninstall slim_install
    % pfexec pkg uninstall SUNWgnome-dialog
    % pfexec pkg uninstall SUNWgnome-intranet-applets
    % pfexec pkg uninstall SUNWgnome-system-tools

This project has integrated into Nevada.  You should not need to update
it manually, as it's now part of the system.  For help with the feature,
please contact nwam-discuss@opensolaris.org.

Licensing

The source and binaries are licensed under CDDL.