Title:		Mechanism for facilitating the installation of OpenOffice.org on Solaris
Case:		LSARC/2010/018
Submitter:	Laszlo Peter
Owner:          John Fischer
Timeout:	01/21/2010

1.0 Introduction

1.1 Project/Component Working Name:

    Mechanism for facilitating the installation of OpenOffice.org on Solaris
    
1.2 Purpose

    LSARC/2010/017 requested the removal of StarOffice 8 from Solaris.
    Customers will need to download and install OpenOffice.org / BrOffice
    separately.  This case proposes a mechanism for notifying the users
    about this change and helping the system administrator download the
    installation sets.
    
    Patch binding is requested.  The intention is to deliver to Solaris
    10 update 9.  OpenSolaris is not affected because it includes
    OpenOffice.org.

2.0 Description 

2.1 User Experience

    New installations of Solaris 10 will not install StarOffice or
    OpenOffice.org.  The desktop menus will include an OpenOffice.org
    launcher.  When OpenOffice.org is not installed, selecting this
    menu will display a page in Firefox that explains that StarOffice
    is no longer provided and that the system administrator can
    download and install OpenOffice.org.  It will include links to
    the download site for OpenOffice.org.  This page will be
    localized and the Brazilian page will point to BrOffice,
    for legal reasons.

    After downloading and installing OpenOffice.org / BrOffice,
    clicking on the menu item will launch the office suite.

    If the customer purchases and installs StarOffice, it will add
    its own, separate menu entries.  The OpenOffice.org menu entry
    can be removed by uninstalling SUNWoffice-launcher.

2.2 Implementation

    The project will deliver a package into Solaris that contains the
    following:

    - a static html document provided by Marketing with the previously
      mentioned content
    - localizations of this page
    - a ksh shell script that does the following:
       - locate OpenOffice.org / BrOffice
       - if found, launch OpenOffice.org / BrOffice
       - if not found, launch Firefox with the static html page in the
         current locale
    - a .desktop file that adds a menu item; clicking on the menu
      item executes the shell script

3.0 Interfaces

3.1 Exported Interfaces

    Interface			| Classification  | Comments
    ----------------------------+-----------------+--------------------
    SUNWoffice-launcher         | Volatile        | package name
    ----------------------------+-----------------+--------------------
    /usr/lib/office-launcher    | Project Private | script
    ----------------------------+-----------------+--------------------
    /usr/share/applications/    | Project Private | desktop menu item
        office-launcher.desktop |                 |