Re: [staf-users] Install changes for STAF V3.3.0 (migration to InstallAnywhere)

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 454-5900

Thanks David for the heads-up.  I have silent install question.  If the 
pathname contains space,  Should I do

STAF330-setup-win32 -i silent -DACCEPT_LICENSE=1 
-DUSER_INSTALL_DIR=C:\Program Files\STAF

or

STAF330-setup-win32 -i silent -DACCEPT_LICENSE=1 
-DUSER_INSTALL_DIR="C:\Program Files\STAF"

--
Regards,
Mike Tran
IBM Austin, Texas

David Bender/Austin/IBM@IBMUS 
Sent by: sta...@li...
03/13/2008 03:08 PM

To
sta...@li...
cc

Subject
[staf-users] Install changes for STAF V3.3.0 (migration to 
InstallAnywhere)

Introduction 
------------ 

In STAF V3.3.0 (which we plan to release around the end of March 2008), we 
will 
be migrating our STAF installers from InstallShield MultiPlatform (ISMP) 
to 
InstallAnywhere (IA).  The primary reason for this is that ISMP has 
reached 
end-of-life, and IA is the recommended follow-on product to ISMP.  Similar 

to ISMP, IA is a Java-based multi-platform software installation program. 

Note that if you are currently using automated installs of STAF (using 
ISMP), 
then you will likely need to modify your automated install to work with 
the 
IA STAF installers in STAF V3.3.0. 

This note describes the install-related changes in STAF V3.3.0, and 
includes 
details on changes that will be incompatible with existing automated 
installs 
of STAF.  Please provide any feedback on these changes by replying to the 
staf-users mailing list or by sending an email to bd...@us.... 

Note that the information provided in this note may change between now and 
the 
release of STAF V3.3.0. 

Overview of Install Changes 
--------------------------- 

STAF V3.3.0 will contain the following install-related changes due to the 
migration to IA: 

- The graphical install for STAF will change, but is basically equivalent 
  to the graphical installer for previous versions of STAF. 
- Console (non-graphical) installs for STAF will be supported. 
- Silent and console installs will support all options that are available 
  in the graphical install. 
- A new "STAF Installation Guide" document will be provided that describes 

  the STAF installers (including screen captures and comparisons between 
  ISMP and IA). 
- The IA installers will support additional platforms, including Mac OS X, 

  FreeBSD, z/Linux, Linux AMD64, Linux IA64, Linux PPC64, Solaris x86, and 

  Solaris AMD64. 
- Windows 95, Windows 98, and Windows Millennium will no longer be 
supported 
  (because IA does not support these older Windows operating systems). 
* The file name/type of some STAF installers will change (in particular, 
  the .jar installers will now be native binary executables). 
* The command line parameters for the IA STAF installers are different 
  than the ISMP command line parameters. 
* Uninstaller locations and file names for IA are different than ISMP. 
* Install log file options have changed in IA. 
* Silent install/uninstall options (and corresponding response file 
  options) will be different than earlier versions of STAF. 
* Options to specify the IA temporary directory are different than ISMP. 

Items in the above list that are noted by an asterisk (*) may require you 
to change existing automated installs of STAF to work with STAF V3.3.0. 

The follow sections describe the changes that may require modification 
to existing automated installs of STAF. 

Command-line Options 
-------------------- 

Here is an example of getting help on the command-line options for an IA 
installer (or uninstaller): 

  C:\>STAF330-setup-win32.exe -? 
      Usage: STAF330-setup-win32 [-f <path_to_installer_properties_file> | 
-options] 
            (to execute the installer) 

    where options include: 
      -? 
          show this help text 
      -i [swing | console | silent] 
          specify the user interface mode for the installer 
      -D<name>=<value> 
          specify installer properties 

    notes: 
      1. the path to the installer properties file may be either absolute, 

         or relative to the directory in which the installer resides. 
      2. if an installer properties file is specified and exists, all 
other 
         command line options will be ignored. 
      3. if a properties file named either 'installer.properties' or 
         <NameOfInstaller>.properties resides in the same directory as the 

         installer, it will automatically be used, overriding all other 
command 
         line options, unless the '-f' option is used to point to another 
valid 
         properties file. 
      4. if an installer properties file is specified but does not exist, 
the 
         default properties file, if present, will be used.  Otherwise, 
any 
         supplied command line options will be used, or if no additional 
         options were specified, the installer will be run using the 
default 
         settings. 

Installer File Names/Types 
-------------------------- 

Unlike ISMP which provides an executable file (with a bundled JVM) and a 
.jar file (which does not bundle a JVM and requires a JVM on the target 
machine), IA provides 2 binary files (one with a bundled JVM, and one 
without a bundled JVM which requires a JVM on the target machine). 

In STAF 3.2.5, we provided the following files (on Windows 32-bit and 
Linux IA-32, for example): 

STAF325-setup-win32.exe (includes bundled JVM) 
STAF325-setup-win32.jar 
STAF325-setup-linux.bin (includes bundled JVM) 
STAF325-setup-linux.jar 

In STAF 3.3.0 we will provide the following files (on Windows 32-bit and 
Linux IA-32, for example): 

STAF330-setup-win32.exe (includes bundled JVM) 
STAF330-setup-win32-NoJVM.exe 
STAF330-setup-linux.bin (includes bundled JVM) 
STAF330-setup-linux-NoJVM.bin 

Note that we are considering only providing the .exe/.bin files in STAF 
V3.3.0 and later versions (i.e. the only IA installer that would be 
provided is the installer with the bundled JVM).  If this would impact 
your ability to use STAF, please respond with details. 

Uninstaller Location and File Name 
---------------------------------- 

With ISMP the uninstaller was created in directory <install-root>/_uninst 
(and if a _uninst directory already existed, _uninstX where X is "1", 
"2", etc.).  With IA the uninstaller is created in directory 
<install-root>/Uninstall_STAF.  The uninstaller executable is 
<install-root>/Uninstall_STAF/Uninstall_STAF.exe on Windows and 
<install-root>/Uninstall_STAF/Uninstall_STAF on Unix. 

Install Log File 
---------------- 

The STAF IA installers will create a log file called STAFInstall.log in 
the root install directory. 

Note that the log file will always be created (it is not an option that 
can be 
specified when starting the installer) and will be overwritten on each 
install. 

Silent Install 
-------------- 

In ISMP, to perform a silent install you specify option "-silent".  In IA, 

the silent install option is "-i silent".  Here is a comparison: 

  STAF325-setup-win32.exe -silent 

  STAF330-setup-win32.exe -i silent 

In ISMP, to specify silent install options, you use "-W <name>=<value>". 
In IA, to specify silent install options you use "-D<name>=<value>". 

Here are the STAF install properties for IA: 

    - ACCEPT_LICENSE=<value> 
       - Acceptance of the license agreement.  Values are "1" (accept) or 
         "0" (or any value other than "1"). 
       - Default is "0". 
       - Equivalent to "license.selection=<value>" in ISMP. 

    - USER_INSTALL_DIR=<value> 
       - The directory where STAF will be installed. 
       - Default is "C:\STAF" on Windows, "/Library/staf" on Mac OS X, and 

         "/usr/local/staf" on other Unix platforms. 
       - Equivalent to 
"stafinstalldirectory.defaultInstallLocation=<value>" 
         in ISMP. 

    - INSTALLER_UI=<value> 
       - The install UI type ("silent", "swing", or "console"). 
       - No equivalent option in ISMP. 
       - Allows you to specify the install UI type without using the 
         "-i" option. 

    - CHOSEN_INSTALL_SET=<value> 
       - The install set ("Full", "Minimal", or "Custom"). 
       - Default is "Full". 
       - Equivalent to "setupTypes.selectedSetupTypeId=<value>" in ISMP. 

    - CHOSEN_INSTALL_FEATURE_LIST=<comma-separated-short-feature-names> 
       - The Custom features to install. 
       - Valid features are: 
STAF,ExtSvcs,Langs,Samples,Codepage,Docs,Develop 
       - This option has no effect for "Full" or "Minimal" install. 
       - No equivalent option in ISMP. 

    - REGISTER=<value> 
       - Whether to perform STAF registration when STAF is first started. 
       - Values are "1" or "0".  Default is "1". 
       - Not supported as a silent install option on ISMP. 

    - REGISTRATION_NAME=<value> 
       - The name to register.  Default is "". 
       - Not supported as a silent install option on ISMP. 

    - REGISTRATION_EMAIL=<value> 
       - The email to register.  Default is "". 
       - Not supported as a silent install option on ISMP. 

    - REGISTRATION_ORG=<value> 
       - The organization to register.  Default is "". 
       - Not supported as a silent install option on ISMP. 

    - UPDATE_ENVIRONMENT=<value> 
       - Scope of environment/menu updates.  Values are "System", "User", 
         "None".  Default is "System". 
       - Equivalent to "stafOptions.updateEnvironmentVariables=<value>" 
         in ISMP. 

    - START_ON_LOGIN=<value> 
       - Windows-only option. 
       - Whether to start STAF on Login.  Values are "1" or "0". 
         Default is "1". 
       - Not supported as a silent install option on ISMP. 

    - CREATE_START_MENU_ICONS=<value> 
       - Windows-only option. 
       - Whether to create Start menu icons/programs folder for STAF. 
         Values are "1" or "0".  Default is "1". 
       - Not supported as a silent install option on ISMP. 

    - USE_TCP_VERSION=<value> 
       - The default TCP/IP version.  Values are "IPV4" or 
         "IPV4_IPV6".   "IPV4" is the default. 
       - Equivalent to "stafOptions.defaultIPvVersion=<value>" in ISMP. 

    - USE_PERL_VERSION=<value> 
      - Only valid on platforms with Perl support. 
      - The default Perl version.  Values are "5.8" and "5.6".  Default 
        is "5.8". 
      - Not supported as a silent install option on ISMP. 

    - STAF_INSTANCE_NAME=<value> 
      - The default STAF instance name.  Default is "STAF". 
      - Not supported as a silent install option on ISMP. 

Here are some comparisons of silent install options for STAF 3.2.5 (using 
ISMP) and STAF 3.3.0 (using IA): 

  A. (ISMP) STAF325-setup-win32 -is:log c:\temp\ismplog.txt -silent -W 
license.selection="Accept" 

     (IA)   STAF330-setup-win32 -i silent -DACCEPT_LICENSE=1 

  B. (ISMP) STAF325-setup-win32 -is:log c:\temp\ismplog.txt -silent -W 
license.selection="Accept" -W 
stafinstalldirectory.defaultInstallLocation="C:\tools\staf" 

     (IA)   STAF330-setup-win32 -i silent -DACCEPT_LICENSE=1 
-DUSER_INSTALL_DIR=C:\tools\staf 

  C. (ISMP) STAF325-setup-win32 -is:log c:\temp\ismplog.txt -silent -W 
license.selection="Accept" -W setupTypes.selectedSetupTypeId="Minimal" -W 
stafOptions.updateEnvironmentVariables="None" -W 
stafOptions.defaultIPvVersion="IPv4 and IPv6" 

     (IA)   STAF330-setup-win32 -i silent -DACCEPT_LICENSE=1 
-DCHOSEN_INSTALL_SET=Minimal -DUPDATE_ENVIRONMENT=None 
-DUSE_TCP_VERSION=IPV4_IPV6 

Here is a comparison of silent uninstall options for STAF 3.2.5 (using 
ISMP) and STAF 3.3.0 (using IA): 

  D. (ISMP) ProductDir\_uninst\uninstaller -silent 

     (IA)   ProductDir\Uninstall_STAF\Uninstall_STAF.exe -i silent 

You can specify a properties file to use when starting the STAF IA 
Installer. 
The properties file should contain the same -D options that you would 
specify 
on a command-line installation.  For example: 

  STAF330-setup-win32 -f installer.properties 

Here is a sample installer.properties file: 

  INSTALLER_UI=silent 
  ACCEPT_LICENSE=1 
  USER_INSTALL_DIR=C:\\STAF 
  CHOSEN_INSTALL_SET=Full 
  REGISTER=1 
  REGISTRATION_NAME=Joe Smith 
  REGISTRATION_EMAIL=ad...@co... 
  REGISTRATION_ORG=ABC Test 
  UPDATE_ENVIRONMENT=System 
  START_ON_LOGIN=1 
  CREATE_START_MENU_ICONS=1 
  USE_TCP_VERSION=IPV4 
  USE_PERL_VERSION=5.8 
  STAF_INSTANCE_NAME=STAF 

Specifying a Temporary Directory 
-------------------------------- 

In ISMP, you could override the default temporary directory used during 
the 
install (for example, if the default temporary directory did not contain 
enough free space) by using the "is:tempdir <dir>" option. 

In IA, on Windows, the installer uses the directory in the TEMP 
environment variable, and on Unix, the installer uses the directory in 
the IATEMPDIR environment variable.  So, prior to running the installer, 
set the appropriate environment variable to a directory containing enough 
free space. 

STAFInst Changes 
---------------- 

Starting in STAF V3.3.0 the default for the STAF IA installers will be 
to perform a "Full (Recommended)" install.  The "type -r" (recommended) 
option for the STAFInst installers will also be changed to perform a full 
installation (so "type -r" and "type -f" will be equivalent). 

David Bender
STAF/STAX Development
8-1268 (512-838-1268) 
IBM Austin Bldg. 903-5B002
Internet: bd...@us...
-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
staf-users mailing list
sta...@li...
https://lists.sourceforge.net/lists/listinfo/staf-users