[stellation-res] Installation requirements

["Jonathan Gossage" <jgossage@xxxxxxxx>]

As I see it, the following represents the desired functionality that we will
need in an install/uninstall package. In this discussion I will assume that
we will be able to get permission to redistribute the jar files for Xerces,
Oro and Jdom.

I am also assuming that we will use the Eclipse update mechanism for
upgrades after initial installation.

1. The installation file should be invokable simply by double clicking.

2. The following sequence of steps should take place during installation.

3. Present a Welcome screen.

4. Present a licence screen that supports user acceptance or rejection of
the license.

5. Present a readme screen.

6. Present a dialog allowing the user to select a client installation,
server installation or both.

7. Present a dialog that allows the user to select the installation location
for the files.

8. If the environment does not contain a HOME variable (normal on Windows
systems) request permission to create one. If the user does not allow this,
configuration files will be installed in the root installation directory.

9. Present a dialog/wizard that allows the user to select the database to be
used. This should do the following:
   i) Allow the user to select a supported database.
   ii) Specify a path to the required JDBC driver. The dislog should verify
       the existence of the driver.
   iii) Allow the user to select a database name with the Stellation default
        being proposed.
   iv)  Allow the user to specify the hostname and port where the selected
database can be located.

10. For both client and server installations present a dialog that allows
the user to enter the connection parameters to the Stellation server.

11. Install the client jar files if client installation specified.

12. Install the server jar files.

13. Install the JDBC driver if a server or self-contained installation.

14. Generate a skeletion .svcrc file using the database location information
    from the user.

15. For server installation, generate the appropriate entries to allow the
Stellation server to run as a service under Windows or as a daemon under
Unux. For Windows this will involve adding entries to the Windows registry.

16. Install and tailor the client side launchers if necessary.

Uninstall must perform the following operations.

1. Stop the Stellation server if uninstalling a server installation.

2. Remove registry entries for service management for Windows if
uninstalling a server, or remove entries from system script files on Unix
systems.

3. Remove all files from the installation directory tree.

4. Remove Stellation configuration files from the configuration directory.

However we choose to deliver this functionality I believe we will have to
satisfy the above requirements. I had a look at a number of open source
installers and none of them appear to have the functionality to support all
these requirements.

This leaves us with the following alternatives:

1. Stick with a combination of Ant based installation and manual
configuration. This approach may work in the Unix environment but will not
be well regarded in the Windows environment which has come to expect a much
more automated approach to deployment.

2. Use a commercial installer such as InstallAnywhere. This will allow us to
build a professional installation for all platforms but is somewhat
incompatible with an open source project.

3. Roll our own installer. This option gives us complete control over the
process but involves a substantial effort.

4. Select an open source installer and customize it for our needs. This
could be attractive except for the fact that all the potential candiates
that I examined are licensed under GPL which migh create problems.

Regards

Jonathan

Personal Email
jgossage@xxxxxxxx

Business Email
jonathan@xxxxxxxxxxxxxx