------------------------------------------------------------------
README.TXT for the "Install Toolkit for Java" (ITJ)

Updated: 6/11/99

Supported OS: Win 95, Win 98, Win NT, OS/2, OS/390, AIX, Solaris, Linux, HP-UX
------------------------------------------------------------------

Congratulations!  You've taken your first step in
using the "Install Toolkit for Java."

The "Install Toolkit for Java" is a Java program that
enables an install program to be written for
Java or non-Java programs.  Since the install
program is written in Java, it can be run on
any platform and operating system - Thus
providing simpler installation and distribution.

After copying the install.class into a temporary
directory, the installation of this program
occurs by running the install.class file.
This can be accomplished at the command
line by typing "java install" in the same
directory as the file install.class.  In the
future, this will also run from the web as an applet.

Install.class is a self-extracting class file whose
contents get extracted during install.  Install.class
contains the Installer class files and data.zip.
Data.zip contains the program files for the
"Install Toolkit for Java."

After extracting the Installer classes,
Installer is automatically run. This is the
install program which directs the user through a
series of install screens.

Installer unzips the program files into
the desired directories.  Then, the registry is
updated, and a set of shortcuts may be created
for the Start Menu.  During this process, an
uninstall log is created which allows the
installation to be removed or backed out to the
previous installed version.

After successful installation, you may run the
demo by running the Installer class file that
resides in the Java Install Toolkit Demo directory, or
by selecting the Demo icon under the Start menu.
This installs some garbage files and directories
as a demonstration of how the Toolkit works.
Be sure to select a temporary directory instead
of the Java Install Toolkit directory.

You can also build your own simple install program
by running the "New Install Wizard" icon under
the Start menu, or by running "java Wizard".

------------------------------------------------------------------
Quick Start for Win32, OS/2, OS/390, AIX, Solaris, or Linux
------------------------------------------------------------------

INSTALL
-------
1. Copy install.class into temporary directory.

2. Run "java install" from temp directory.
   This will install the toolkit.

3. If you encounter Java errors when running
   "java install", try running:

   "java -classpath JAVA_HOME\lib\classes.zip;.; install"
   where "JAVA_HOME" is where Java is installed.  (For AIX
   use : instead of ; in classpath)

UNINSTALL
---------
There are 3 ways to uninstall the toolkit for Win32:

1. Run the batch file:
      "c:\winnt\profiles\current_user\juninst" "toolkit_dir\UnInst"
      "c:\windows\itj\juninst" "toolkit_dir\UnInst"

2. Run "Uninstall" from the Start menu.

3. Uninstall from the Add/Remove Programs
   dialog under the Control Panel.

There are 2 ways to uninstall the toolkit for OS/2:

1. Run the command file:
      "c:\os2\itj\juninst" "toolkit_dir\UnInst"

2. Run uninstall from the "Install Toolkit for Java"
   Desktop folder.

There are 3 ways to uninstall the toolkit for AIX:

1. Run the shell script file:
      juninst "toolkit_dir\UnInst"

2. Uninstall the fileset using smit.

3. Uninstall using installp:
      installp -u Install.Toolkit.for.Java.Toolkit

There are 2 ways to uninstall the toolkit for Solaris:

1. Run the shell script file:
      juninst "toolkit_dir\UnInst"

2. Uninstall the fileset using pkgrm or admintool.

There is 1 way to uninstall the toolkit for Linux and OS/390:

1. Run the shell script file:
      juninst "toolkit_dir\UnInst"


DEMO
----
There is a demo that goes through the different
panels in the toolkit.  This can be run by:

1. Run "Demo - Normal Install" from the Start menu
   or Desktop folder.

2. Run "java Installer" from the Projects\Demo1
   directory.

You can also run the demo in the unattended or
automatic mode:

1. Run "Demo - Unattended Install" from the Start
   menu or Desktop folder.

2. Run "java Installer /p install.script" from
   the Projects\Demo1 directory.


MAKE YOUR OWN INSTALL
---------------------
You can build your own simple install program by
running either:

1. Run "New Install Wizard" icon from the Start menu
   or an OS/2 folder.

2. Run "java Wizard" from the toolkit directory.

This wizard will generate a simple install program
that utilizes only a small subset of the entire
capabilities of the "Install Toolkit for Java".

------------------------------------------------------------------
System Requirements
------------------------------------------------------------------
1. Win NT 4.0 with JDK 1.1.3 or greater
2. Win 95 with JDK 1.1.3 or greater
3. OS/2 Warp 4.0 with JDK 1.1.4 or greater
4. AIX 4.1.5 or greater with JDK 1.1.4
5. Solaris with JDK 1.1.4 or greater
6. Linux with JDK 1.1.6 or greater
7. OS/390 with Open Edition
8. Requires 4.5 MB of disk space (27 MB on Win 95
   due to FAT16)

------------------------------------------------------------------
Install from the Web
------------------------------------------------------------------
Support for "Install from the Web" has been added to the "Install
Toolkit for Java".  This allows a user to install products located
on a web server using the Netscape 4 or Microsoft 4 web browsers.
In addition to a browser, the user must have a JDK or JRE installed
on their system.

This feature has been tested on WinNT, Win95 and Win98.  On Win95
and Win98 problems with uninstall could be encountered if your
environment space for MS-DOS prompt is not large enough.

------------------------------------------------------------------
FAQ
------------------------------------------------------------------
Q. What is "Install Toolkit for Java"?

A. The "Install Toolkit for Java" is a Java program that enables an install
   program to be written to install Java or non-Java programs.  This includes
   the ability to install Windows NT/95 programs.  Since the install
   program is written in Java, it can be run on any platform and operating
   system. This provides a simpler installation and distribution process.

   The toolkit enables programs to be installed using the JDK from a local
   file, or using a web browser from a local file or over a network.
   (Currently, only the JDK method is supported.)  To install a program
   only 1 file is needed: install.class.

   After copying the install.class file into a temporary
   directory, installation of the program occurs by running the install.class
   file.  Install.class contains the rest of the install class files and
   data.zip. Data.zip contains the program files in a zip format.
   This enables install images to be easily built.  During the install
   process, an uninstall log is created which allows the program to be
   uninstalled.


Q. How do I install the toolkit?

A. To install "Install Toolkit for Java" do the following:

   1. Unzip InstallToolkit.zip into temporary directory, or copy
      install.class into temporary directory.

   2. Run "java install" from temp directory.
      This will install the toolkit.

   3. If you encounter Java errors when running
      "java install", try running:

        "java -classpath JAVA_HOME\lib\classes.zip;.; install"

      or

        "java -nojit install"

      where "JAVA_HOME" is where Java is installed.  (For AIX
      use : instead of ; in classpath)


Q. How do I uninstall the toolkit or any other program installed
   using the toolkit?

A. There are 3 ways to uninstall the toolkit for Win32:

   1. Run the batch file:
      "c:\winnt\profiles\current_user\juninst" "toolkit_dir\UnInst"
      "c:\windows\itj\juninst" "toolkit_dir\UnInst"

   2. Run "Uninstall" from the Start menu.

   3. Uninstall from the Add/Remove Programs dialog under the Control Panel.

   There are 2 ways to uninstall the toolkit for OS/2:

   1. Run the command file:
      "c:\os2\itj\juninst" "toolkit_dir\UnInst"

   2. Run uninstall from the "Install Toolkit for Java" Desktop folder.

   There are 2 ways to uninstall the toolkit for AIX:

      1. Run the shell script file:
         juninst "toolkit_dir\UnInst"

      2. Uninstall the fileset using smit.

   There are 2 ways to uninstall the toolkit for Solaris:

      1. Run the shell script file:
         juninst "toolkit_dir\UnInst"

      2. Uninstall the fileset using pkgrm or admintool.

    There is 1 way to uninstall the toolkit for Linux and OS/390:

      1. Run the shell script file:
         juninst "toolkit_dir\UnInst"


Q. How do I run the demo program?

A. There is a demo that shows the different panels available in the
   toolkit.  This can be run by:

   1. Run "Demo - Normal Install" from the Start menu or Desktop folder.

   2. Run "java Installer" from the Projects\Demo1 directory.

   You can also run the demo in the unattended or automatic mode:

   1. Run "Demo - Unattended Install" from the Start menu or Desktop folder.

   2. Run "java Installer /p install.script" from the Projects\Demo1 directory.


Q. When I uninstall the demo program, it doesn't appear to be uninstalled?

A. The demo installation program makes a backup of any files it will copy
   over.  If you have already installed the demo, and you do it again, a
   backup file will be created in the uninstall directory. This file is
   called "backup.zip".  When you uninstall the demo, the previous demo
   will be restored.  Of course for this demo, the current and previous
   install have the same files, but this is used to demonstrate the
   "restore previous install" feature of the toolkit.  To completly remove
   the demo, you must uninstall all previous installs of the demo.
   This is equal to the number of times you ran install.  The uninstall
   program indicates if there is a previous version that will be uninstalled.


Q. How can I make an install that will install my own program?

A. You can build your own simple install program by running either:

   1. Run "New Install Wizard" icon from the Start menu or from the OS/2
      folder.

   2. Run "java Wizard" from the toolkit directory.


Q. The wizard doesn't do everything I want my install program to do.  Is
   there a way to have multiple destination directories, get or set registry
   keys, ...?

A. The wizard will generate a simple install program that utilizes only a
   small subset of the entire capabilities of the "Install Toolkit for Java".
   By editing the Installer.java file that the wizard generates, you
   can easily add functionality to your install program.  Since this is a
   Java program, you can add any Java code to your install.  This allows
   your install to check if files exist, read or create them, modify
   autoexec, config and ini files, or call other program.  The list of
   the capabilities provided by the toolkit are:

      Files
        - copy, read, create, modify, versions, batch files

      Directories
        - create, delete

      Registry
        - read, create, modify, delete, enumerate, remote registry

      Environment variables
        - read, create, modify, delete

      Folders, shortcuts, and icons

      Log
        - install, uninstall

      Install to multiple destination directories

      Multiple fileset install

      Selective uninstall

      Dependency checking of prerequisite programs

      GUI panels
        - Welcome Panel
        - AskText Panel
        - AskText2 Panel
        - Destination Panel
        - Folder Panel
        - Information Panel
        - Information Dialog
        - License Panel
        - OkCancel Dialog
        - Options Panel
        - Readme Panel
        - Select1 Panel
        - Select2 Panel
        - SetupComplete Panel
        - Welcome Panel
        - YesNo Dialog
        - YesNoCopy Dialog
        - easy to create and add custom panels
        - text and images on panels are customizable

      Progress bar/status

      Splash screens shown during install

      Play audio files during install

      Script based (Java)

      Multiple language support (NLS)

      Unattended install from install scripts

      Simple install wizard


Q. Are multiple languages supported?

A. "Install Toolkit for Java" is enabled to support multiple
   languages.  It does this by isolating all text strings used
   in the panels and install program to one or more translation
   files.  The english file used by install is TextBundle.java.
   To support another language, this file would be translated and
   the file would be changed to "TextBundle_en_US.java"
   for US or to the letter
   ISO-3166 + "_" + ISO-639 string returned by "Locale.getLanguage()"
   and "Locale.getCountry()".


Q. There isn't a default GUI panel that has the layout that I
   want to use for my install.  Is there a way to make my own
   panel?

A. Yes.  Since the install script (Installer.java) is written
   in Java, you can use any Java dialog or window.  If you want
   to maintain the same look and feel of the default GUI panels,
   you can start with one of the panels (such as AskText2.java) by
   copying it to another java file.  Then, you can edit this
   new file and place widgets or components wherever you want.
   You can also import the java file into a development tool
   and add the components graphically.  When creating your own
   panels, it is recommended that you implement the methods
   getResult, setImage, setMessage, setWindowTitle, ... as done
   in the default panels.  Then add get and set methods for any
   components you add.  The bulk of the code you add will go in
   the buildContentPanel() method.



------------------------------------------------------------------
Change History
------------------------------------------------------------------

Documentation Change History:
-----------------------------
Jan 9, 1998

    1. First version of document was created
    2. Added section 1, on Java Install Toolkit features


Code Change History:
--------------------
Jan 9, 1998

    1. First version of prototype was created

Jan 27, 1998

    1. Added support for OS/2:
        - CPPOS2.DLL
        - Add folders to desktop and icons in folders
    2. Added ability to create batch files from install script
       and have them uninstalled correctly.

Jan 29, 1998

    1. Restructured JInstall.class and broke into Jfile.class
       and FileSet.class.

    2. Added file program name with version, and file set name
       with version.

    3. Added checking of CRC when comparing to see if files
       are identical.

    4. Added dependency checking before installing file set.
       (Not complete yet)

Mar 10, 1998

    1. Added play and record of install scripts for automatic
       and unattended install.  Use "/r file.scr" to record
       and "/p file.scr" to play it.  You can also initialize
       variables in the install program by using "/l file.scr".
       There is a reserved script filename called "install.script".
       If it exists in the install directory, the install
       program will initialize any variables contained in it
       (only if the /r /p or /l options were not used).

    2. Added dependency checking for WIN32 based upon version
       number of program and filesets.

    3. Added backup of files before installing over a program.
       When uninstalling the newest install, the old files, shortcuts,
       folders, and registry entries are restored.  This enables
       a new version to be backed out and restored to the older
       version.

    4. Added new GUI panel that combines install options and
       destination directory.  (Select3)

    5. Added new GUI panel that allows the user to enter a file
       name, or browse for one.  (SelectFile)

    6. Added wizard to build simple install programs. (Wizard)

March 30, 1998

    1. Reworked uninstall.

    2. Added support for AIX.

April 1, 1998

    1. Removed flickering of GUI panels when moving from one panel
       to the next.

April 8, 1998

    1. Added support for installing from a directory (such as a CD)
       instead of a zip file.
    2. Fixed "New Directory" dialog to close on OK or Cancel.

April 14, 1998

    1. Added "-" to makefile for Wizard

April 15, 1998

    1. Fixed install.zip file generated by Wizard to contain file
       names without base directory path.  If "java Install" was
       run using the bad install.zip file, then an error looking
       for "InstallApplet" was reported.

April 24, 1998

    1. Fixed shortcuts on Win32 to work correctly if the toolkit is
       installed on a drive other than C:

    2. Improved support for NLS by adding the country code + _ +
       language code as the file extension to use for the translation
       files.  The US English file is now "TEXT.en_US".  If the
       current locale file is not found, it defaults to the en_US
       file.  The default locale can be set by adding a
       "locale=XX_xx" parameter in the "install.script" file
       for your install.  If this is set, that locale is used.
       If it can't be found, it reverts back to the "en_US" file.
       If that doesn't exist, it prints an error message, and any
       text on the install panels will be blank.

    3. install.class is now a self-extracting class file that contains
       install.zip.  To install, just run "java install".

    4. Fixed OS/2 folder creation bug on FAT drive, and changed arg1
       of FileSet.addFolder() & FileSet.addShortcut().

    5. Fixed OS/2 duplicate icons in folder bug.  When installing
       on top of existing install, the icons are replaced correctly.

    6. Fixed traps on Win32 when getting registry keys that don't
       exist.

April 27, 1998

    1. Changed extension of language files to be "en_US" instead of
       "US_en".

    2. Obtain Win32 "Start Menu\Programs" path from registry entry
       "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\Programs"

    3. Fixed Win32 folders and icons for non-english languages.


May 7, 1998

    1. Added Registry object to abstract the registry for different
       operating systems.

    2. Added Shortcut object to include description, working dir,
       arguments, icon file.

May 19, 1998

    1. Fixed OS/2 error when installing a long file on a FAT drive.

    2. Fixed OS/2 folder enumeration for FAT drives.

    3. Added support for registry object on OS/2 using binary INI
       files.

    4. Added support for binary INI files on OS/2.

    5. Added support for dependency checking on OS/2 using abstract
       registry and Feature Installer.

    6. Added support for dependency checking on AIX using the lslpp
       utility.  AIX filesets can be specified and checked for
       installation.

    7. Fixed bug with nested folders on desktop on OS/2.

    8. Fixed bugs with deleting one or more filsets when multiple
       filesets were installed.

    9. Added audio support enabling .au files to be played during
       install.

   10. Fixed OS/2 drive not ready bug.

   11. Added method to RunExec to get output of exec as a string.

   12. Added support for extended attributes on OS/2.

   13. Fixed uninstall to remove files, folders, etc. in the
       reverse order that they were created.

   14. Renamed Frame1.class to MainFrame.class.

   15. Added method to JFile to check for long filename support or
       8.3 only for a drive.

   16. Added variables to automatic script files.  The allowed
       variables are {root} and {environment_variable}.  Created
       new InstallProperties class to accomplish this.

   17. Added support for AIX to get free disk space, drive list,
       and environment variables.

June 2, 1998

    1. Changed OS/2 INI support from using IProfile to Prf methods.
       This removed need for large compiler libraries.  This also
       solved the CPPOS2.DLL not found error.

    2. Fixed exception problem with JDK 1.1.6 with JIT enabled.

    3. Fixed Win32 leaving DLL around after install.  (OS/2 still
       leaves DLL)

    4. Fixed HTML documents added to folders on OS/2 to start
       browser instead of text editor.

    5. Modified registry enumeration to return both the keys and
       value names.  It used to return only keys.  (Win32)

    6. Modified registry enumeration and get key value methods to
       return null if the key being searched does not exist. (Win32)

    7. Modified operation of FileSet.addFiles() method.  When "F"
       is passed as parameter, the root directory passed in is
       removed from the destination directory.  For example,
         addFiles("www\html\web\*.*", "c:\dir1\", "FS")
       will unzip all files that start with "www\html\web" and their
       subdirectories, into "c:\dir1\".  If there is a file in
       the zip file "www\html\web\demo\test.html", then this will
       be copied int "c:\dir1\demo\test.html".

    8. Added program description to dependencies.

June 5, 1998

    1. FileSet.createBatchFile() creates directory before creating
       file.

    2. Copy a file for every rule in the fileset, instead of quiting
       after the file is copied once.  This was an error if the
       same file was included in more than one FileSet.addFiles()
       rule.

    3. Added dependency checking for files in file system.

June 9, 1998

    1. Changed long file names used during install and uninstall
       to 8.3 names for use on OS/2 FAT drive.

June 16, 1998

    1. Change install log to use Program Name - Component Name
       (no version).  This enables a different version to be
       installed and the previous version's log file will be
       deleted or backed up.

    2. Fixed Win32 bug where uninstall removes uninstall key, but
       leaves registry key.

    3. Check dependencies based upon DisplayName, not just the
       uninstall keys.

    4. Added color gradient, shadow, and logo to MainFrame.

    5. Fixed bug dialog constructors XXX(Frame parent, String title,
       boolean modal) doesn't change title.  Also changed all
       setWindowTitle(...) to setTitle(...).

    6. Fixed when running install.class with Readme.txt file in same
       directory, the Readme.txt is deleted by cleanup.

June 17, 1998

    1. FileSet constructor created uninstall log.  If copyFileSet()
       was not called, the previous install was messed up.  This
       order has been changed, so that no log or uninstall files are
       created or replaced until copyFileSet() is called.  Any
       batch files being created and added to the log using
       createBatchFile(), should be done AFTER copyFileSet() has
       successfully completed.

    2. Completed OS/2 shortcut support.  Arguments and working
       directory now set the desktop object.

Aug 4, 1998

    1. Remove registry, shortcuts, icons when installing over previous install.

    2. Create shortcut for OS/2 - startup folder & shadow name aren't
       being set in CPPOS2.

    3. Add dependency checking based upon a registry entry.
       addDependency(Registry r, String...)

    4. Enable access to UninstallApplet for pre/post uninstall routines.

    5. Add install(), uninstall() to fileset.

    6. Add setUninstall(), getUninstall to fileset for selective uninstall.

    7. Add AddFile() option to keep from deleting a file when uninstalling.
       This is important for shared files.

    8. Create new Program object that contains FileSet objects and has
       filesize check, dependencies check, install, uninstall.

    9. Bug creating files with correct date when installing in JInstall.

    10. Cancel during install locks up program.

    11. Add method to CPP and Jinstall to enumerate all JDKs installed
        on system.

    12. Add methods to Jfile to modify config, ini, batch files.

    13. YesNoCopy dialog shouldn't pop up during silent install
        - assume Yes to all

    14. Uninstall should undo all file modifications.  Added hooks during
        uninstall by using Uninstall.class.

    15. OS/2 shortcuts for data files are duplicated - add delete of shortcuts.

    16. No popups during silent install.

    17. Add logging of install/uninstall to ascii file or screen.

    18. Add FileSet.createDirectory() so they are deleted during uninstall.

    19. Find drives that support long filenames.

    20. Add method to search for filename in environment variable path list.

    21. Exception on Win32 if Uninstall key is not found during checkDependecies.

    22. Enable setting of uninstall program (java or jre).

    23. Add registry entry checking to dependencies.

    24. Add Readme panel object.

    25. Added setting of uninstall image and save MainFrame properties
        for use during uninstall.

    26. Added BaseInstaller for all install programs to implement.  This
        removes the need to have the installer called InstallApplet.java.

    27. Added ModifyFile object that enables config files to be easily
        manipulated.

    28. Correctly register installed programs with installp for AIX.
        Installed programs with toolkit can be removed using smit.

    29. Environment variables set to "INSTALL_var=xx" can override
        any script variables used by the installer.

    30. Changed the GUI to use a new layout manager.  This provides
        better platform-independent support.

Aug 11, 1998

    1. Fixed Wizard to work with recent changes.  It also compiles
       Installer.java in the project directory if changes were made.

    2. Fixed bug with incorrect logging of files when installing on
       top of a previous installation.

    3. Updated documentation to reflect recent changes.

Aug 21, 1998

    1. Fixed directory not set correctly for Select3.

    2. Add reboot of OS functionality.

    3. Added BaseInstaller to construtor for Program and FileSet.

    4. Moved JInstall.unzip() to FileSet.install2().

    5. For AIX, find next lpp_id using global setting in lpp file.

    6. Added InstallObject, FileObject, DirObject, FolderObject,
       PermissionsObject.  These objects have install() and uninstall()
       methods and are responsible for installing or uninstalling
       themselves.

    7. Changed name of Registry to RegistryObject, Shortcut to
       ShortcutObject.  This enables new objects to be created and
       installed/uninstalled in the future without changing the install
       engine.

    8. Fixed the Wizard to compile the correct Installer.java
       file.

Aug 26, 1998

    1. Fixed bug in DirDialog to show directory listing and drive based
       upon initial directory.

    2. Added Options.setSelectedItem() so the default option can be
       specified.

    3. Add CPPWIN32.isDriveNTFS() to determine if a drive is formated
       with NTFS.  Also added getDriveFormat() which returns NTFS or FAT.

    4. Added remote registry support for Win32.

    5. Added support for Solaris.  Install is correctly registered with
       the Solaris install database.  "pkginfo" can be used to get
       information, and "pkgrm" can be used to remove the product.
       The product can also be removed by using:

           juninst product_uninstall_directory

       Dependency checking for installed products is also supported.
       There are two ways to check dependencies:

           1. Check for package id and/or version

              fs.addDependency(description, "SUNWxwpmn", "3.5.27", "", "");

              The description is used by checkDependencies().  If the
              dependency is not met, then the description is returned
              instead of a hard-to-read package id.

           2. Check for package name and/or version

              fs.addDependency(description , "", "", "Font server", "3.5.27");

       To ignore the version, just pass an empty string "".

    6. Added log file name as parameter that can be passed to a Uninstaller.
       This only affects the way silent uninstall operates.  If the fileset
       is separately uninstallable, then only that fileset is deleted -
       not the entire product.  If the fileset is not separately
       uninstallable, then the entire product is uninstalled.

    7. Added an option to select whether to generate or compile the
       project from the Wizard.  Now, if you modify Installer.java,
       you can compile and create a new install.class without recompressing
       the source files.

Sep 11, 1998

    1. Added version number to uninstall program so older installs won't
       overwrite newer versions.  This file is "itjver".  It is located in
       the same directory as the uninstall program.

    2. Added vendor info to FileSet.  This enables the vendor to list
       phone, fax, email, address, urls, etc. to a fileset.

    3. Directory listing dialog - changed behavior of Enter key to update
       directory listing instead of being equal to pressing the OK key.

    4. Add shared libraries support to AIX.  Introduced a new
       LibraryFileObject to handle this.  Files can now be added to,
       replaced, or deleted from any library file (such as libC.a).
       This works even if the library file is currently being used.

    5. Add backup ZipOutputStream to FileObject so CPPxxx can save files
       to backup file.

    6. For AIX, when uninstalling with installp, an uninstall script
       automatically launches the Java uninstall program.  Now, programs
       and filesets installed with ITJ can be easily uninstalled using
       "installp -u fileset".

    7. Added support for Linux.  The Java installer now runs on Linux
       with nearly complete support.  Dependency checking is integrated
       with the RPM databases.  The support not yet available is that
       ITJ does not register programs it installs with RPM.

    8. Changed the install() and uninstall() methods of InstallObjects
       to also include as a parameter the FileSet being installed or
       uninstalled.

    9. Fixed Wizard to compile Uninstall.java.  If modifications have
       been made to this class, they will not be lost when running the
       Wizard again.

Sep 18, 1988

    1. Added CID return codes for uninstall.

Sep 24, 1998

    1. Added setPermissions() method to CPPs, so platform-specific
       permissions can be set by PermissionsObject.

    2. Added method to CPPs to determine if the current user has
       administrator privileges.  This can be used by the install
       writer to check to see if an administrator operation would
       fail during install.

    3. Added method to CPPs to determine if the current user has
       the ability to install code.  This can be checked by the
       install writer to verify correct permissions.

    4. Install code was changed to allow any user with install permission
       to install code with ITJ.  For Win32, OS2 and Linux, any user can
       install a program, but for AIX and Solaris, only the root user
       can install a program.  On Win95 and OS/2, any user can uninstall
       code, but on the other OSes, only the user that installed the code
       can remove it.

    5. Changed permissions of installed files so that by default, any
       user can run a program installed by a root user.

Sep 30, 1998

    1. Fix null pointer exception in CPPWIN32 FindJDKs if no JDK is found.

    2. Use /tmp directory for all temporary script files generated for
       unix-based installed.

Oct 5, 1998

    1. Get "Program Files" path from ProgramFilesDir instead of
       ProgramFilesPath.

    2. Fixed folder list for double-byte countries for WinNT.

    3. Fixed file read in Jfile and ModifyFile to support double-byte.
       (Readme and License dialogs).

    4. Added a driveObject class to keep track of each drive on the
       system.  This tracks free space, space used by each file set,
       format, long filename support, type of disk, and block size.
       When installing filesets over multiple drives, check diskspace
       works correctly.  Also, check diskspace takes into account
       the cluster size for each file to be installed.

    5. Fixed the CDROM drive not ready error for OS/2.

    6. "Yes to All" should be propogated to the remaining file sets
       during install.  Enable "Yes to All" to be programatically set
       using a static public variable FileSet.yesAll and
       FileSet.noAll.

    7. Fixed dialog positions that were not centered on background.

    8. Limited width of dialogs to a maximum value set by
       WizardLayoutManager.maxWidth.  This was necessary since the dialogs
       for double-byte countries were too wide.

    9. Added creation of directories during the install if there are
       any empty directories in the source data zip file.

   10. Fixed bug when calling CPPWIN32.findJDKs() if no JDK or JRE
       installed.  Also, now detects IBM JDK and JRE.

Oct 8, 1998

    1. Fixed bug with AIX to repair odm file if next lpp id in odm
       file is missing.  This would cause an invalid number exception.

    2. Added dependency checking to uninstall.  If a program selected
       for uninstall has other programs that depend upon it, the program
       cannot be deleted unless an "-f" option is passed to uninstall,
       or the program is selected from the uninstall GUI.  Warning is
       given to the user.  (This only checks programs that were installed
       with ITJ.)

    3. Fixed bug in CPPWIN32.getUninstallDirectory() that caused an
       null pointer exception.

    4. Fixed unicode problems in CPPWIN32 for Win NT.  The methods that
       had bugs with unicode, but have been fixed are:
         getRegKeyValue(), setRegKeyValue(), getRegKeyEnumerate()
         createShortcut(), deleteShortcut(), deleteRegKey()
         getStartMenuPath(), getProgramsDirectory(), getUninstallDirectory()
         createFolder(), deleteFolder(), getFolderList()

Oct 12, 1998

    1. Fixed registry entries added to FileSet.addRegistry() that
       were not being removed during uninstall.

Oct 13, 1998

    1. Fixed bug causing incorrect uninstall program in the WIN32
       uninstall registry key.

    2. Modifies the Installer.java template used by the Wizard to include
       the latest prerequisite checking dialog and to use the
       DependencyObject.

Oct 16, 1998

    1. Fixed self-extracting class file to work with JDK 1.2.

Oct 21, 1998

    1. Copied method ModifyFile.appendText(String) to appendLine(String).
       This method actually adds crlf after the appended text.  There are
       cases when this is not desirable.  To add text without adding crlf
       the appendText(String) method was changed to only add text. If
       any existing code uses the appendText() method, it should be
       changed to use the appendLine() method.

Oct 27, 1998

    1. Fixed exception when checking for CPP.isAdministrator().

Oct 29, 1998

    1. Fixed but in Wizard that did not generate Installer.class
       and install.class correctly.

    2. Fixed install date of product for AIX in history.

Oct 30, 1998

    1. Changed uninstall to only delete Uninst.cla and uninst.gif in
       the log directory, not all files in the log directory.

Nov 2, 1998 (V1.19)

    1. Install date in log was off by one month.

    2. Added ITJ Version to log file.

    3. Added error checking to Program and FileSet to ensure that
       all required constructor parameters are present.  In particular,
       the program name and version, and the fileset name and version
       must be specified.

    4. Modified uninstall to return an error if the specified log
       directory does not have any log files in it.

    5. Added version number to ITJ install program GUI.

Nov 4, 1998 (V1.20)

    1. Fixed a bug with the Wizard not adding install.script to the
       install.class.  This caused any installer generated with the
       wizard to not have the default program name, directories, etc.

    2. Added the ability to include a Win32, OS/2, or AIX JRE with
       any installer using the Wizard.  The JREs are not included with
       ITJ, but need to be obtained by the developer.

    3. Changed the uninstall registry keys to be created and removed
       by a file set automatically added by the Program class.  This
       fileset name is "ITJ Info" and log file "ITJInfo".  This
       name should not be used by any other filesets.

Nov 6, 1998 (V1.21)

    1. Fixed the ".\" exception on AIX during install of all programs.

    2. Changed way of checking for AIX admin permissions from LOGIN env
       var to using whoami and checking for root.

Nov 11, 1998 (V1.22)

    1. Fixed package registering problem with pkginfo on Solaris.

    2. Updated folders, shortcuts, and list folders to work with
       All Users or Current User for Win NT.

    3. Enhanced dependency checking of installed programs for Win32 and
       OS/2 to accept ">version", "<version", "=version" for both the
       program and fileset version numbers.  For example ">=1.1.4" would
       mean that any version 1.1.4 or greater is required.  Also added
       a isInstalled() method to DependencyObject that checks to see if
       a product is installed, without adding it to a FileSet.

Nov 11, 1998 (V1.23)

    1. Fixed problem with CPP classes out of sync.

Nov 13, 1998 (V1.24)

    1. Fixed error with disk space on Solaris.

    2. Added ability for any user to install a program without being
       administrator.  For AIX and Solaris the uninstall program goes into
       /home/user/bin, and the default program directory is /home/user.

    3. Fixed problem with getting environment variables on Solaris.

Nov 16, 1998 (V1.25)

    1. Restore the visible setting of the logo during uninstall.

Nov 17, 1998 (V1.26)

    1. Added support for OS390.

    2. Fixed uninstall to use JRE if it is available for Win32 and OS/2.

Nov 19, 1998 (V1.27)

    1. Added support for locked files being deleted for Win32.

    2. Only copy DLLs in the uninstall directory for the appropriate OS.

    3. Fixed dependency checking on Solaris when version was specified.

    4. Protect Uninstaller from exceptions that occur in developer supplied
       Uninstall.class.

Nov 20, 1998 (V1.28) - alphaWorks code drop

    1. Converted installer to build and use TextBundle.java instead of
       TextBundle.properties.  This was to solve problems with OS390.
       The Wizard and the Makefile for projects created by the Wizard
       were changed.  The .properties files can still be used, but if
       there is a .class file, it will be loaded first.  For an example,
       look in the Projects\Demo1\TextBundle.java file.

    2. Fixed bug in Installer.java that failed to show the MainFrame
       background during install.

    3. Fixed Sample.proj file to resolve the FileSet parameter is zero-
       length error message.

Nov 30, 1998 (V1.29)

    1. Fixed null exception when enumerating files on Solaris.

    2. Fixed classpath duplication in juninst.cmd on OS/2.

Dec 3, 1998 (V1.30)

    1. Fixed the self-extracting class file for OS390.

    2. Added /usr/ucb/ to whoami for Solaris in case it isn't in path.

Dec 4, 1998 (V1.31)

    1. Improved performance when installing from directory structure.

    2. Changed InstallProperties to read \\ as \ from install.script.
       If a variable is to have \, either \ or \\ will be read as \.

Dec 10, 1998 (V1.32)

    1. Readme was being deleted when install.class was cleaning up
       files.

    2. Fixed ASCII files copied for OS390 that had CRLF when created
       on a Windows system are converted to only LF.

Dec 14, 1998 (V1.33)

    1. Added YesNoCopy*.class to uinstall.jar.

    2. Enabled uninstall to work with the new version of jview with
       JNI support.

    3. Added installp.setToEnvironment() to Installer.java for Wizard,
       Demo1, and Toolkit installs.

    4. Changed Makefile generated by the Wizard to not replace the
       TextBundle.java file in the project directory.

Jan 5, 1999 (V1.34)

    1. Added new closeBatchFile(boolean b) method to FileSet so
       that the extra strings appended to the batch file can be
       disabled.  This allows the xxxBatchFile methods to be used
       to create and register with uninstall more than just batch
       files.

    2. Fixed bug with dependency checking that caused exceptions
       with some uninstall registry keys on Win32.

    3. Fixed bug with JDK 1.2 that prevented the self-extracting
       install.class file from running.

    4. Added echo character capabilities to AskText, AskText2 dialogs,
       so they can be used to enter passwords.

Jan 6, 1999 (V1.35) - alphaWorks code drop

    1. Added alpha support to install from the web with Netscape 4 and
       Internet Explorer 4.

Jan 14, 1999 (V1.36)

    1. Made available the drive that is reporting not enough disk space
       when Program.checkDiskSpace() is called.  This drive is contained
       in String Program.checkDiskSpaceDriveError.

    2. Fixed exception that occurred during CPPWin32.getRoot() if the
       environment variable "windir" is not defined.

    3. Fixed the creation/deletion of folders, shortcuts, and registry
       entries for non-English systems and for names that have
       non-English characters on Win95/98.

    4. Fixed exeception in Wizard running under JDK 1.2.

    5. Changed the ModifyFile object to replace any EOF characters
       with \n that are read in from an old DOS file.

Feb 2, 1999 (V1.37) - alphaWorks code drop

    1. Fixed all Installer.java files to correctly choose jre or java
       for uninstall.  They use whichever command invoked them.

    2. Changed selection of which CPP to use based upon a properties
       file CPP.lst.

    3. Changed some CPPDefault methods to work better with UNIX.

    4. Added sorting of directories in DirDialog.

    5. Fixed bug in uninstall for Solaris.

Feb 19, 1999 (V1.38)

    1. Fixed exception in ModifyFile when checking for CRLF, and when
       setting an existing variable that was previously set to nothing.
       Modified this class to insert the platform-specific crlf chars,
       and to recognize crlf or lf.

    2. Fixed diskspace calculation for Linux.

    3. Added method to FileSet that saves a file name to the uninstall
       log so that it is deleted when uninstall is called.  This can
       be used to save the correct date and file size of a file that
       is modified during install, so that it will be deleted at
       uninstall time.

    4. Added global variable to FileObject to indicate if all files
       that were installed should be deleted, whether they were changed
       or not.  Use FileObject.deleteAll=true to set it.

    5. Added the ability to start, stop, enumerate, create, and delete
       services on Win NT.  (Create and Delete NOT tested.  Use at your
       own risk!)

March 2, 1999 (V1.39)

    1. Verified correct operation of create and delete of services on Win NT.

    2. Fixed logging in Installer.java.  Logging can be turned on in the
       install.script file by setting log=file_name or logToScreen=true
       or false.  Events can be added to be logged by setting variable
       logEvents=event1,event2,...

    3. Added several methods to logging to set the log format.

    4. Fixed drive list and disk space for non-English AIX systems.

    5. Changed all CPPs to use an automatically generated unique temporary
       file name for any scripts needed during install.  This will remove
       the security exposure of having a predefined file name that may
       already exist.

    6. Changed the uninstall file mode for unix-based CPPs from 777 to 755.

    7. Enabled font to be changed for dialogs.

    8. Fixed bug with writing Integers to registry using the RegistryOBject.

March 5, 1999 (V1.40)

    1. Fixed the uninstall error with Solaris caused by not having the
       correct check sum for the uninstall script.

    2. Enabled font to be changed for AskFolderName dialog.

    3. Fixed bug with dependency checking on Win32.

March 6, 1999 (V1.41)

    1. Added support to wrapping labels to correctly wrap lines for
       different languages.

April 9, 1999 (V1.42) - alphaWorks code drop

    1. Added support for directories to be added to install.class by
       addclass.class.  This enables files in directories and classes
       in packages to be included and used during install.  (These
       classes are not available for uninstall.)

    2. Added an additional license panel (LicenseLAP) that can be
       used for license acceptance.

    3. Added CPP.getTemporaryDirectory() to locate a temporary directory.

    4. Added support for creating and deleting shortcuts on the desktop
       and Start Menu.  Previously, they could only be created in the
       Start Menu Programs list.

    5. Fixed zip.class incompatability problem that generated zip files
       that wouldn't work with WinZip 6.3.  Still doesn't work with
       earlier versions of WinZip.

April 26, 1999 (V1.43)

    1. Added quotes around the "d:\java_dir\java" command in juninst
       so that if java is installed in a directory with spaces, the
       command will still run.  This only affects Win32.

    2. Changed script file (response file) used to set variables for
       install to use install.res instead of install.script.  The
       code still will look for install.res first, if it doesn't find
       it, then it will use install.script.  This was done to enable
       8.3 file systems to supply a response file without having
       to supply the /l parameter in "java install /l newscriptfile".

    3. Fixed bug that prevents installs created with the wizard from
       running.  Code was added in V1.42-1 to include the path of
       files added to install.class.  However, the wizard is running
       in a different directory, so the project directory was being
       added as part of the file name to be extracted.  As a result,
       all of the code was being placed in a subdirectory under the
       directory that install.class was run in.

April 28, 1999 (V1.44)

    1. Fixed install from the web bug that prevented bourne shell
       from correctly starting the install of the downloaded program.

May 17, 1999 (V1.45)

    1. Fixed exception on Solaris and Linux caused by locale call
       from Java only returning 2 characters instead of 5.

    2. Moved hardcoded strings from Uninstaller.java to TextBundle.java.

    3. Moved hardcoded strings from Applet1.java to AppletText.java
       for install from the web.

    4. Fixed bug with CPPLIN.getTempFileName().

June 8, 1999 (V1.46)

    1. Added support for HP-UX.

    2. Added "" around java.exe in batch file created during download
       from the web to fix failure to run java if spaces are in path for Win32.

June 11, 1999 (V1.47)

    1. Added installation of prototype code for ITJPKG to ITJ
       install program.  ITJ install now installs both ITJ and
       ITJPKG programs.

------------------------------------------------------------------
Known Bugs:
------------------------------------------------------------------
1. On Win95, when running a batch file by selecting one of the
   icons in the folder, the DOS prompt remains open.  When the
   title bar has "Finished - xxxx", it is safe to close the
   window.

2. On Win95, if cancel is pressed during install, a "Java" window
   and the install program's background frame may be left open.
   The Java window can be closed by pressing Ctrl-C.  This should
   close both windows.  The cancel install operation should still
   have been done correctly.

3. On AIX, if you have difficulty running Wizard or Installer
   with exceptions or core dumps occuring, try turning off the JIT.
   This can be done by setting the environment variable:

    For the Korn shell:
        export JAVA_COMPILER=off

    For the Bourne shell:
        JAVA_COMPILER=off
        export JAVA_COMPILER

    For the C shell:
        setenv JAVA_COMPILER off

4. On Solaris and Linux, the label for checkboxes may not be
   aligned properly.

5. On OS390, the directories created during install are not deleted
   at uninstall.

6. If there are any compile errors in Installer.java, Uninstall.java,
   or TextBundle.java when running the Wizard, the Wizard will hang.
   It is recommended that you compile any changes to your code using
   javac or the Makefile.

------------------------------------------------------------------
To Be Completed:
------------------------------------------------------------------
1. Add support for AS400, NT 5.0.

