install.script

Software Testing Automation Framework (STAF)的开发代码

.***************************************************************************
.* Software Testing Automation Framework (STAF)
.* (C) Copyright IBM Corp. 2001
.*
.* This software is licensed under the Common Public License (CPL) V1.0.
.****************************************************************************

.*************************-START-OF-PROLOG-****************************
.*
.*  File Name          : Install SCRIPT
.*  Descriptive Name   : Software Test Automation Framework Installation
.*  Detail:
.*
.*     This file contains the STAF install.
.*
.**************************-END-OF-PROLOG-*****************************
:i1.Registering
:ih1.installation
:i2.Registration
:h1 id=install.Installation
:h2 id=autoreg.Registering STAF
:p.By default, the first time STAF starts after installation, it will
automatically register with IBM Austin.  This is of particular importance,
as keeping an accurate count of the number of users and systems using
STAF helps to ensure the continued support of STAF, as well as, providing
compelling evidence for other groups to adopt STAF.  When installing STAF,
you may optionally include your name, e-mail address, and organization.
This allows us to send you information about updates to STAF, as well as
allowing us to better understand which types of groups are benefitting
from STAF.  If you are installing large numbers of STAF systems, we don't
expect you to continually enter this information.  We would ask that you enter
this information only once.
:p.While STAF registration is enabled by default, all of the installers
allow you to bypass this registration.  Please see the installation section
for your specific platform.
.*---------------------------------------------------------------------
:i1.Upgrading
:ih1.upgrading
:i2.Upgrading
:h2 id=reinstall.Upgrading/Migrating
:p.You can install STAF to a directory with an existing version of STAF already
installed.  In this case the installer will prompt you to decide if you want
to do an upgrade installation.  If you choose to do the upgrade installation,
all of STAF files will be upgraded to the new version.  Any files created after
STAF was installed (e.g. additional services, log files, updated STAF.cfg, etc)
will not be removed.
:p.Note that if you are upgrading from a pre-V3.0 version of STAF, the installer
will perform a silent uninstallation of the existing version of STAF, before
proceeding with the upgrade installation.
:p.When upgrading an existing version of STAF, it is recommended that you 
shutdown the existing version of STAF before beginning the upgrade
installation.
:p.You can have multiple versions of STAF installed on the same system (note 
that they must be installed to different installation directories).
.*---------------------------------------------------------------------
:ih1.installation
:i2.Installation of IPv6 enabled version of STAF 
:h2 id=ipv6inst.Installation of IPv6 enabled version of STAF
:p.The operating system must have IPv6 support to install a IPv6 enabled version 
of STAF.
:p.If you select to have the support for IPv6 installed, but you do not have
the machine configured with an IPv6 IP address, if you use the default STAF.cfg
file, you will get an error "No supported IPv6 address" when starting STAF, and
STAF will fail to start.  This is because by default the TCP Connnection
Provider will use the default (IPv4_IPv6) option for the PROTOCOL option.  If
you do not have an IPv6 IP address configured on the machine, you will need to
see the PROTOCOL option to IPv4.  See section :hdref refid=staftcp.
for more details on setting this option.
.*---------------------------------------------------------------------
:ih1.installation
:i2.Windows
:h2 id=wininst.Windows installation
:h3.Installing Using InstallShield MultiPlatform 11.5
:p.STAF provides the following two methods to install STAF on Windows.
Both methods use InstallShield MultiPlatform 11.5:
:ul.
:li.If you already have Java 1.2 or later installed,
download file STAF321-setup-win32.jar to a temporary directory.  
To start the install of STAF, type the following from the temporary
directory:
:xmp.
  java -jar STAF321-setup-win32.jar
:exmp.
:li.If you do not have Java 1.2 or later installed,
download file STAF321-setup-win32.exe (which comes with
a bundled JVM) to a temporary directory.
To start the install of STAF, type the following from the temporary
directory:
:xmp.
  STAF321-setup-win32
:exmp.
:eul.

You will be guided through the following steps:
:ol.
:li.On the Welcome panel, click Next to continue.
:li.On the next panel, carefully read the license agreement.  If you accept
the terms of the license agreement, click on "I accept the terms of the
license agreement", and then click on Next.
:li.Click Next to install STAF to the default directory, or click Browse
to install STAF to a different directory.
:li.If an existing version of STAF is already installed in the specified 
installation directory, you will see a panel advising that this would be an
upgrade installation.  If you want to proceed with the upgrade, click on Next.
Otherwise, click on Back to go to the previous panel and select a different
install location.
:li.If there are multiple versions of STAF already installed on the machine,
you will see a panel showing the install locations and versions.  Note that the
new installation will override the existing environment updates for the other
versions of STAF (for example, the new version of STAF will have its bin
directory as the first entry in the PATH environment variable).  Click on Next 
to continue.
:li.Choose the type of install that best suits your needs:
:ul.
:li.Typical - This installs STAF with the suggested configuration,
providing the most common and useful pieces of STAF.  This includes
the standard external services (Log, Monitor, Resource Pool, and Zip),
language support (C/C++, Java, REXX, Perl, Python, and Tcl), 
documentation, samples, and demos.  This install type is recommended 
for most users.
:li.Custom - This installs STAF with the features you choose.  
This install type is recommended for advanced users.  It allows you
to choose which features of STAF you want to install, including:
:ul compact.
:li.External Services: Log, Monitor, Resource Pool, Zip
:li.Language Support: C/C++, Java, Rexx, Perl, Python, and Tcl
:li.Documentation
:li.Samples and demos
:li.Service developer header files and libraries
:li.Additional codepages.  Note that installing the additional 
codepage files is highly discouraged, as the additional codepage files
take up significant disk space.
:eul.
:li.Full - This installs all STAF files, including all supported codepages.
:li.Minimal - This will install the absolute minimum files necessary
to run STAF.
:eul.

:li.Choose options for the install:
:ul.
:li.Select whether you want to Update the Environment (variables and menus) for
the System, User, or None.  If you select System, the System environment
variables and Windows menus will be updated.  If you select User, the
currently logged-in user's environment variables and Windows menus
will be updated.  If you select None, no environment variables or Windows
menus will be updated and you will have to update environment variables
for STAF as described in section :hdref refid=envvars..

:li.Select whether you want STAF to automatically start when you login
(by adding STAF to your StartUp folder).  This option is not available if you
selected None for Update Environment.

:li.Select whether you want icons placed on the "Start Programs" menu.
This option is not available if you selected None for Update Environment.

:li.Select whether you want icons placed on the "Quick Start" menu.
This option is not available if you selected None for Update Environment.

:li.Select whether you want STAF to automatically register with IBM Austin.
We strongly encourage you to keep this option selected.  Please see
:hdref refid=autoreg. for more information.  If this option is selected, you
will be given the opportunity to, optionally, enter the following information:
:ul compact.
:li.Your name
:li.Your e-mail address
:li.Your organization
:eul.

:li.Select whether you want to use the IPv4 TCP libraries only, or if you want
to use the TCP libraries that support both IPv4 and IPv6 (see 
:hdref refid=ipv6inst. for more information on the operating system requirements
for the TCP libraries that support both IPv4 and IPv6).

:li.Click Next to continue.

:eul.

:li.If you selected to place icons on the "Start Programs" menu, you
will be asked to specify the program folder name where the icons
will be placed or you may use the default folder name.  It is recommended that
you include the STAF version number in the folder name, so that you can easily
distinguish it in case other versions of STAF are installed on the machine. 
Click Next to continue.

:li.A panel will be displayed allowing you to specify the value for the STAF
instance name for this version of STAF.  Since multiple instances of STAFProc
can be run at the same time on the same system, the STAF_INSTANCE_NAME 
environment variable can be used to specify a name for each STAFProc instance.
You can leave the default instance name as "STAF", or you can change the
instance name.  Note, this value will only be used in the STAFEnv script file
that will be created for you.  Click on Next to continue.

:li.A panel will be displayed so you can review your installation options.
If you want to change anything, click Back.  Otherwise, click Next to
start copying files.

:li.When the install is complete, you should get a message that the
InstallShield Wizard has successfully installed STAF.  Click on Next to
continue.

:li.If this was an upgrade installation from STAF V2.x, you will next see a panel
indicating that the default STAF V3 STAF.cfg has been installed in the bin
directory in the install location.  Note that the 2.x STAF.cfg file has been
copied to bin/STAF.cfg.ismp.bak.  Click on Next to continue.

:li.Next you will see a panel informing you that the installer has created a
STAFEnv.bat file in the root install location that you can use to set the
required environment variables for this version of STAF.  Click on Next to 
continue.

:li.On Windows NT/2000/XP/2003/Vista systems, click Finish to exit the wizard.
On Windows 95/98/ME systems, you will get a message that you must restart your
system to complete the installation.

:eol.
.*---------------------------------------------------------------------
:ih1.uninstalling
:i2.Windows
:h3.Uninstalling STAF
:p.To uninstall STAF on Windows systems, open the Control Panel and 
double click on the "Add/Remove Programs" icon.  Scroll down through 
the list of installed programs and select "STAF V3.x.x" and click
on the "Add/Remove..." button.
When uninstalling STAF 2.3 and later (when it was installed using InstallShield
MultiPlatform), all STAF features will be uninstalled; you cannot
choose which features to uninstall.  Also, any files created after
STAF was installed will not be removed.
:p.
Note that if you have more than one version of STAF installed on a machine,
only the last installed version will be displayed in Add/Remove Programs.  If
you wish to uninstall the earlier versions, there is an "Uninstall STAF" icon in
the Start Programs folder for that version of STAF.  Note that if the earlier
version is 2.6.5 or earlier, you will need to open a command prompt, go to the
_uninst directory in the root install location, and run "uninstaller.exe".  For
STAF versions 2.6.6 or later, there will be an "Uninstall STAF" icon in the 
Start Programs folder for that version of STAF.
:p.
When uninstalling STAF 2.2 or earlier, when you click on the 
"Add/Remove..." button, a panel will be displayed asking whether you
want to completely uninstall STAF or prepare for a reinstallation of 
STAF.  The latter choice should be used if you are planning to reinstall
STAF on this system.  Select the option that you want and click Ok.

.*---------------------------------------------------------------------
:h3.Performing a Silent Installation or Uninstallation of STAF
:p.If you need to install or uninstall the same STAF configuration 
multiple times or in multiple locations, you can bypass the InstallShield MultiPlatform 11.5
Installer GUI and perform a silent installation or uninstallation 
to save time.
:h4.Silent Installation
:p.In a silent installation, STAF will be installed with the 
default options.  To perform a silent installation on Windows, issue 
the following command:
:xmp.
  STAF321-setup-win32 -is&colon.log c:\temp\ismplog.txt -silent -W license.selection="Accept"
:exmp.
or
:xmp.
  java -Dis&colon.debug=1 -jar STAF321-setup-win32.jar -silent -W license.selection="Accept"
:exmp.
:p.After performing a silent installation of STAF on Windows 95/98/ME
systems, you must restart your system to complete the installation
(e.g. sets environment variables for STAF).
:p.You can also use a response file for the responses you normally 
specify manually when you run the InstallShield MultiPlatform 11.5 Installer GUI.  To create a
response file, you can run a non-silent installation, specifying the
response file name, and select the responses during the installation:
:xmp.
  STAF321-setup-win32 -options-record settings.txt 
:exmp.
:p.To specify a response file for a silent STAF installation, issue the
following command:
:xmp.
  STAF321-setup-win32 -is&colon.log c:\temp\ismplog.txt -silent -options settings.txt
:exmp.
:p.You can also override installation settings when doing a silent
installation.  For example, to install STAF with the default options,
except for specifying a different install location, issue the following command:
:xmp.
  STAF321-setup-win32 -is&colon.log c:\temp\ismplog.txt -silent -W license.selection="Accept" -W stafinstalldirectory.defaultInstallLocation="C:\tools\staf"
:exmp.

:p.The following table shows the most commonly-used "-W" silent install options:
:table cols='2* * 2*' align='l c l'.
:tcap.-W silent install options
:thd.
:c.Option
:c.Default Value
:c.Description
:ethd.
:row.
:c.-W license.selection=
:c.N/A
:c.Specify the value "Accept" to indicate that you have read the STAF license
agreement and that you accept the terms of the license agreement.  You are
required to use this option and set the value to "Accept".
:row.
:c.-W stafinstalldirectory.defaultInstallLocation=
:c."C:\STAF"
:c.The directory in which STAF should be installed.
:row.
:c.-W setupTypes.selectedSetupTypeId=
:c."Typical"