From sacadmin Thu Jul 31 16:37:49 2008 Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6VNbmw1025887; Thu, 31 Jul 2008 16:37:48 -0700 (PDT) Received: (from kasso@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m6VNbmqp025883; Thu, 31 Jul 2008 16:37:48 -0700 (PDT) Date: Thu, 31 Jul 2008 16:37:48 -0700 (PDT) From: Chris Kasso Message-Id: <200807312337.m6VNbmqp025883@sac.sfbay.sun.com> To: LSARC@sac.sfbay.sun.com Cc: kasso@sun.com Subject: Update Center 2 Toolkit - GUI and Desktop Notifier [LSARC/2008/492 OnePager] Status: RO Content-Length: 12432 Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: Update Center 2 Toolkit - GUI and Desktop Notifier 1.2. Name of Document Author/Supplier: Author: Chris Kasso 1.3 Date of This Document: 31 July, 2008 4. Technical Description 1. Introduction 1.1. Project/Component Working Name: Update Center 2 Toolkit - GUI and Desktop Notifier 1.2. Name of Document Author/Supplier: Chris Kasso 1.3. Date of This Document: July 31, 2008 1.3.1. Date this project was conceived: October, 2007 1.4. Name of Major Document Customer(s)/Consumer(s): 1.4.1. The PAC or CPT you expect to review your project: Java ES PAC 1.4.2. The ARC(s) you expect to review your project: LSARC 1.4.3. The Director/VP who is "Sponsoring" this project: Martin Knutson 1.4.4. The name of your business unit: Software 1.5. Email Aliases: 1.5.1. Responsible Manager: nazrul.islam@sun.com 1.5.2. Responsible Engineer: tom.mueller@sun.com 1.5.3. Marketing Manager: ed.conzel@sun.com 1.5.4. Interest List: dev@updatecenter.dev.java.net 2. Project Summary 2.1. Project Description: This is a sub-project of the Update Center 2 Toolkit project which focuses on the Update Tool GUI, Desktop Notifier and Configuration Extensions. For details of the overall project see: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 2.2. Risks and Assumptions: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 3. Business Summary 3.1. Problem Area: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 3.2. Market/Requester: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 3.3. Business Justification: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 3.4. Competitive Analysis: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 3.5. Opportunity Window/Exposure: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 3.6. How will you know when you are done?: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier 4. Technical Description: 4.1. Details: For general info see: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier Configuration Extension ----------------------- This feature enables package maintainers to specify configuration scripts to be executed after a package installation, update or removal transaction has completed. Since configuration extensions may only be executed after all steps in a potentially multi-package transaction occur, this extension is aligned with the IPS philosophy of not enabling execution of arbitrary code during an individual package's install, update or removal phases. Project-specific scripts will enable package maintainers to carry out cross-OS platform and platform-specific operations such as desktop Start menu integration without having to depend exclusively on separately executed utilities. Update Tool GUI and Desktop Notifier ------------------------------------ The Update Tool GUI is a thick client application available to end users to apply updates, install add-on components and to remove installed components within installations on a user's local system. In more advanced cases, the GUI can be used to create new installation images from scratch and populate these new images by installing packages from IPS package repositories. The desktop notification applet (not a Java applet) is a small-scale application represented by an icon in the notification area of a user's desktop. This applet monitors repositories associated with the user's installation images for applicable updates, notifies the user of available updates and enables user to directly apply updates and launch the Update Tool GUI. The Update Tool GUI and notification applet share a common, per user configuration store to maintain user preferences that affect the operation of the tools and keep track of installation images of interest to the user. GUI Toolkit: The Update Tool GUI and notifier are written in Python and make use of the wxPython and wxWidgets C++-based cross-OS platform toolkits to deliver a look and feel that is aligned with the desktop environments in which they are used. Since IPS itself is written primarily in Python, using Java and Swing was not a feasible option for the project. As the IPS Java API is built out, there may be an option in the future to deliver a Java-based Update Tool GUI. However, the UC2 toolkit project has no firm plans to do so at this time. Other cross-platform GUI toolkits such as PyGTK were considered, but since the UC2 toolkit project must support Mac OS X and GTK support was not available on Mac OS X's native desktop environment, the UC2 toolkit project decided to use the wxPython and wxWidgets toolkit. Packaging: The Update Tool GUI and its associated desktop notifier application are delivered as a distinct IPS package that can be embedded in a pre-installed installation image, downloaded during initial installation through the initialization component or installed after the fact through the IPS pkg CLI. Use of the Update Tool GUI and desktop notifier is optional. Delivery of pre-installed images and ongoing management of installation images can be carried out via the IPS pkg CLI and, to some extent, the IPS Java API. When distributions do not need to support desktop environments, distribution owners do not need to include the GUI and notifier package in their distribution. For example, if a distribution is concerned with supporting only headless server environments, the distribution assembler would not include the Update Tool GUI IPS package in their distribution. 4.2. Bug/RFE Number(s): See UC2 Toolkit bug/RFE database: http://wiki.updatecenter.java.net/Wiki.jsp?page=BugsRFEs 4.3. In Scope: 4.3.1 OS Platform Support The primary OS platforms being supported by the project include: * Windows XP and Vista on x86 * Mac OS X on PowerPC and x86 * Popular, Recent Linux Distributions on x86 * Solaris 9 and 10 on SPARC and x64 * OpenSolaris 2008.05 and above Both 32- and 64-bit are supported on each of the platforms. Support for other Unix platforms such as AIX and HP-UX, although not initially addressed by this project, could be supported with a modest amount of effort. To support any OS platform, at a minimum, a suitable Python runtime must be made available. If desktop support is also required, then suitable versions of wxPython and wxWidgets are required. 4.4. Out of Scope: See above. 4.5. Interfaces: Deferred to more detailed subcase material. 4.6. Doc Impact: 4.6.1. End User Documentation * IPS man pages are provided as part of the port of IPS * Online help is provided as part of the Update Tool GUI 4.6.2. Distribution Documentation * UC2 Toolkit Release Notes can be used by distribution owners to augment their own distribution release notes when they embed the toolkit in their distributions. * UC2 and IPS overview and usage information modules will be provided such that they can be plugged into each distribution's documentation set as appropriate. 4.6.3. Developer Documentation * Package Maintainer Best Practices * Distribution Assembler Guide For more information on documentation, see: http://wiki.updatecenter.java.net/Wiki.jsp?page=UC2Documentation 4.7. Admin/Config Impact: Operation of the technologies included in distributions does not have to be affected by the introduction of the UC2 toolkit and IPS. At one level, use of IPS packaging can be viewed as an overlay on top of existing unpackaged zip-based distributions. Distribution owners may elect to integrate update, add-on and image management functions within their existing management interfaces by using the IPS APIs. 4.8. HA Impact: Not applicable. 4.9. I18N/L10N Impact: The Update Tool GUI and desktop notifier are i18n-compliant and the conventional set of languages supported by Sun software products will be supported. 4.10. Packaging & Delivery: See above and, for additional details, see the related ARC subcases. 4.10.1 Overall Filesystem Layout General layout: bin/ # Wrappers/links to actual commands pkg updatetool pkg/ # Self contained pkg (IPS) directory bin/ pkg, pkgsend, pkg.depotd vendor-packages/pkg/ # Actual IPs python modules are here python2.4-minimal/ # Minimized python runtime updatetool/ # Self contained updatetool directory bin/updatetool bin/updatetoolconfig vendor-packages/updatetool # Updatetool python code vendor-packages/wx-2.8 # wxPython toolkit Example GlassFish-based distribution: bin/ pkg updatetool asadmin # Wrapper/link to actual asadmin command in glassfish3/bin imqcmd imqadm glassfish/ bin/ lib/ ... mq/ bin/ lib/ pkg/ updatetool/ 4.11. Security Impact: Installation image management security is essentially limited to end users' ability to access the filesystem, directories and file residing under an installation image of interest. In this sense, overlaying IPS package on top of formerly unpackaged zip-based installation does not introduce any new security concerns. The Update Tool GUI and desktop notifier carry out local communications over a port in order to coordinate their activities. The connection is made when needed and is generally short lived. Only simple commands (e.g reload config, initiate update check, restart, etc.) are sent. No data, beyond the command set is sent over the wire. The connection is TCP based with the port derived from the private port range (49152 - 65535). 4.12. Dependencies: See: http://sac.eng/LSARC/2008/411/20080627_christopher.kampmeier This is a subcase of LSARC/2008/411. This case depends on PSARC/2008/190 - pkg(5) - Image Packaging System (IPS) 5. Reference Documents: See this more comprehensive project overview: http://wiki.updatecenter.java.net/Wiki.jsp?page=UC20FSD.Overview All project documentation material is available here: http://wiki.updatecenter.java.net Multi-install Specifications (umbrella: WSARC/2006/130) http://sac.eng/Archives/CaseLog/arc/WSARC/2006/130/ Multi-install Filesystem Layout (WSARC/2006/239) http://sac.sfbay.sun.com/Archives/CaseLog/arc/WSARC/2006/239/ Multi-install Dependency Wiring (WSARC/2007/445) http://sac.sfbay/arc/WSARC/2007/445/ OpenSolaris IPS information: http://www.opensolaris.org/os/project/pkg/ 6. Resources and Schedule: 6.1. Projected Availability: Production quality release August-September 2008. Quarterly update releases to follow. 6.2. Cost of Effort: 5 development engineers for 9 months plus Quality, Globalization and other project resources. 6.3. Cost of Capital Resources: Addressed via existing resources. 6.4. Product Approval Committee requested information: 6.4.1. Consolidation or Component Name: Not applicable. 6.4.3. Type of CPT Review and Approval expected: Not applicable. 6.4.4. Project Boundary Conditions: Not applicable. 6.4.5. Is this a necessary project for OEM agreements: Not at this time. 6.4.6. Notes: Not applicable. 6.4.7. Target RTI Date/Release: Not applicable. 6.4.8. Target Code Design Review Date: Reviews have been occurring throughout the development process. 6.4.9. Update approval addition: Not applicable. 6.5. ARC review type: Standard 6.6. ARC Exposure: Open 6.6.1. Rationale: Not applicable. 7. Prototype Availability: An initial preview release already available as part of the GlassFish Technology Preview 2 release in May, 2008. https://glassfish.dev.java.net/downloads/v3-techPreview-2.html 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: unknown 6.5. ARC review type: OnePager 6.6. ARC Exposure: open From sacadmin Mon Sep 29 12:07:44 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m8TJ7ij8010446 for ; Mon, 29 Sep 2008 12:07:44 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m8TJ7geX002369 for <@sunmail2sca.sfbay.sun.com:lsarc@sun.com>; Mon, 29 Sep 2008 13:07:44 -0600 (MDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K7Z00F0714UPG00@nwk-avmta-2.sfbay.sun.com> for lsarc@sun.com (ORCPT lsarc@sun.com); Mon, 29 Sep 2008 12:07:42 -0700 (PDT) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K7Z00BXL14SUL50@nwk-avmta-2.sfbay.sun.com> for lsarc@sun.com (ORCPT lsarc@sun.com); Mon, 29 Sep 2008 12:07:40 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m8TJ7epE011811 for ; Mon, 29 Sep 2008 19:07:40 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K7Y00C01ZIRK000@mail-amer.sun.com> (original mail from Aarti.Pai@Sun.COM) for lsarc@sun.com (ORCPT lsarc@sun.com); Mon, 29 Sep 2008 13:07:40 -0600 (MDT) Received: from [129.145.154.52] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K7Z00LQT141SED0@mail-amer.sun.com> for lsarc@sun.com (ORCPT lsarc@sun.com); Mon, 29 Sep 2008 13:07:22 -0600 (MDT) Date: Mon, 29 Sep 2008 12:07:12 -0700 From: Aarti Pai Subject: Materials for LSARC/2008/492 - Update Center 2 Toolkit - GUI and Desktop Notifier Sender: Aarti.Pai@sun.com To: lsarc@sun.com Reply-to: Aarti.Pai@sun.com Message-id: <48E12760.7030108@Sun.COM> MIME-version: 1.0 Content-type: multipart/alternative; boundary="Boundary_(ID_nj8yKoRcg8J6zhhXXhohgA)" X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 3119 This is a multi-part message in MIME format. --Boundary_(ID_nj8yKoRcg8J6zhhXXhohgA) Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT This case is scheduled on 10/7/2008. sac% pwd /shared/sac/Archives/CaseLog/arc/LSARC/2008/492 sac% ls -l inception.materials total 781 -rw-r--r-- 1 kasso sac 41957 Sep 26 12:04 20-questions.txt -rw-rw-r-- 1 kasso sac 550 Sep 26 12:01 README.html -rw-rw-r-- 1 kasso sac 18167 Sep 26 11:28 UC20FSD.NotifierLife.htm -rw-rw-r-- 1 kasso sac 140491 Sep 26 11:21 gui_spec.html drwxr-xr-x 2 kasso sac 32 Sep 26 11:21 gui_spec_files -rw-rw-r-- 1 kasso sac 36039 Sep 26 11:30 install_time_config.htm drwxrwxr-x 2 kasso sac 6 Sep 26 11:39 manifests -rw-rw-r-- 1 kasso sac 20166 Sep 26 12:02 notifier.html drwxr-xr-x 2 kasso sac 7 Sep 26 11:27 notifier_files -rw-rw-r-- 1 kasso sac 1941 Sep 26 11:25 preferences.txt -rw-rw-r-- 1 kasso sac 1636 Sep 26 11:25 protocol.txt --Boundary_(ID_nj8yKoRcg8J6zhhXXhohgA) Content-type: text/html; charset=ISO-8859-1 Content-transfer-encoding: 7BIT This case is scheduled on 10/7/2008.

sac% pwd
/shared/sac/Archives/CaseLog/arc/LSARC/2008/492
sac% ls -l inception.materials
total 781
-rw-r--r--   1 kasso    sac        41957 Sep 26 12:04 20-questions.txt
-rw-rw-r--   1 kasso    sac          550 Sep 26 12:01 README.html
-rw-rw-r--   1 kasso    sac        18167 Sep 26 11:28 UC20FSD.NotifierLife.htm
-rw-rw-r--   1 kasso    sac       140491 Sep 26 11:21 gui_spec.html
drwxr-xr-x   2 kasso    sac           32 Sep 26 11:21 gui_spec_files
-rw-rw-r--   1 kasso    sac        36039 Sep 26 11:30 install_time_config.htm
drwxrwxr-x   2 kasso    sac            6 Sep 26 11:39 manifests
-rw-rw-r--   1 kasso    sac        20166 Sep 26 12:02 notifier.html
drwxr-xr-x   2 kasso    sac            7 Sep 26 11:27 notifier_files
-rw-rw-r--   1 kasso    sac         1941 Sep 26 11:25 preferences.txt
-rw-rw-r--   1 kasso    sac         1636 Sep 26 11:25 protocol.txt

 --Boundary_(ID_nj8yKoRcg8J6zhhXXhohgA)-- From sac-owner Wed Oct 8 15:00:21 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m98M0Lv9001943 for ; Wed, 8 Oct 2008 15:00:21 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m98M0EKf035457 for <@sunmail2sca.sfbay.sun.com:All-ARCs@sun.com>; Wed, 8 Oct 2008 16:00:21 -0600 (MDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K8F00J2HX4J0U00@nwk-avmta-2.sfbay.sun.com> for All-ARCs@sun.com (ORCPT All-ARCs@Sun.COM); Wed, 08 Oct 2008 15:00:19 -0700 (PDT) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K8F00DBFX4JBZ90@nwk-avmta-2.sfbay.sun.com> for All-ARCs@sun.com (ORCPT All-ARCs@Sun.COM); Wed, 08 Oct 2008 15:00:19 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m98M0JOC021784 for ; Wed, 08 Oct 2008 22:00:19 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K8F00I01VS2X200@mail-amer.sun.com> (original mail from Aarti.Pai@Sun.COM) for All-ARCs@Sun.COM (ORCPT All-ARCs@Sun.COM); Wed, 08 Oct 2008 16:00:19 -0600 (MDT) Received: from [129.145.154.52] by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K8F00JXRX4AB6A0@mail-amer.sun.com> for All-ARCs@Sun.COM (ORCPT All-ARCs@Sun.COM); Wed, 08 Oct 2008 16:00:12 -0600 (MDT) Date: Wed, 08 Oct 2008 15:00:10 -0700 From: Aarti Pai Subject: LSARC Approved - Update Center 2 Toolkit - GUI and Desktop Notifier (2008/492) Sender: Aarti.Pai@sun.com To: Aarti.Pai@sun.com Reply-to: Aarti Pai Message-id: <48ED2D6A.7040003@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.14 (X11/20080505) Status: RO Content-Length: 217 LSARC approved on 10/07/2008: Case: Update Center 2 Toolkit - GUI and Desktop Notifier (2008/492) Incompatible Changes: none Precedent: none If more information is needed, please contact the case owner/intern.