install.script

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

:c.Indicates the type of installation.  The valid values are "Typical", "Full",
and "Minimal".
:row.
:c.-W stafOptions.updateEnvironmentVariables=
:c."System"
:c.Indicates the type of environment variables and Windows menus to update.  The
valid values are "System", "User", and "None".
:row.
:c.-W stafOptions.defaultIPvVersion=
:c."IPv4 only"
:c.Indicates whether to install support for IPv4 only or for IPv4 and IPv6.
The valid values are "IPv4 only" and "IPv4 and IPv6".
:etable.
:p.For example, to do a silent installation of type "Mimimal", without updating
environment variables, and with the support for IPv4 and IPv6:
:xmp.
STAF321-setup-win32 -is&colon.log c:\temp\ismplog.txt -silent -W license.selection="Accept" -W setupTypes.selectedSetupTypeId="Minimal" -W stafOptions.updateEnvironmentVariables="None" -W stafOptions.defaultIPvVersion="IPv4 and IPv6"
:exmp.

:h4.Silent Uninstallation
:p.The silent uninstallation uninstalls all STAF components.  To perform 
a silent uninstallation, issue the following command:
:xmp.
  ProductDir/_uninst/uninstaller -silent
:exmp.
.*---------------------------------------------------------------------
:h3.Installing STAF as a Windows service
:p.If you wish to have STAFProc start automatically on Windows when the
operating system is rebooted (without requiring a user to log on to Windows),
you can install STAF as a Windows service.
:p.These instructions assume you have copied INSTSRV.EXE and SVRANY.EXE 
(available from the Windows Resource Kit) into C:\WINNT\SYSTEM32.
:ol.
:li.Create a base STAF service which by default is started automatically when the system boots. 
:xmp.
instsrv STAF c:\winnt\system32\srvany.exe
:exmp.
:li.Start the Windows Registry Editor by typing regedit and find:
:xmp.
My Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\STAF
:exmp.
:li.Create a new string value with the name Description. Set the 
value to Automatically start STAF service.
:li.Create a new Key with name Parameters. Inside the new key, create 
a new string value with the name Application and set the value to 
c:\staf\bin\stafproc.exe. 
:li.Close the Registry Editor.
:li.If on Windows 2000, open the following program:
:xmp.
Start > Programs > Administrative Tools > Services
:exmp.
:li.If on Windows 2000 Terminal Server, open the following program:
:xmp.
Start > Programs > Administrative Tools > Management Console (Windows 2000 Terminal Server)
Services and Applications > Services
:exmp.
:li.If on Windows XP Professional, open the following program:
:xmp.
Start > Settings > Control Panel > Administrative Tools > Services
:exmp.
:li.Locate STAF, right click on the STAF entry, and select Properties. 
:li.From the 'Log On' tab, click 'Allow service to interact with 
desktop', then click on Apply and then click on OK. 
:li.Next, type:
:xmp.
net start staf
:exmp.
:li.Check that STAF is now running from a command prompt:
:xmp.
staf local ping ping
:exmp.
:li.Note that when running STAF as a Windows service, you should not 
have STAFProc automatically start when users log on to Windows.  You
should either deselect the "Start STAF on user login" option when
installing STAF, or delete STAF from Start > Programs > Startup folder.
:li.Note that STAF should not be started or shutdown with the commands
on the start menu when STAF is configured as a service. 
:eol.
.*---------------------------------------------------------------------
:ih1.installation
:i2.Unix
:h2 id=unixinst.Unix installation
:h3.Installing Using InstallShield MultiPlatform 11.5
:p.
STAF provides the following two methods to install STAF on Unix using
InstallShield MultiPlatform 11.5 (for operating systems that are supported by InstallShield MultiPlatform 11.5).
:ul.
:li.If you already have Java 1.2 or later installed,
download file STAF321-setup-xxxxx.jar to a temporary directory.  
To start the install of STAF, type the following from the temporary
directory:
:xmp.
  java -jar STAF321-setup-xxxxx.jar
:exmp.
:li.If you do not have Java 1.2 or later installed,
download file STAF321-setup-xxxxx.bin (which comes with
a bundled JVM) to a temporary directory, replacing xxxxx with the
name of the operating system.
To start the install of STAF, type the following from the temporary
directory:
:xmp.
  ./STAF321-setup-xxxxx.bin        
: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, and Resource Pool),
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
:li.Language Support: C/C++, Java, Rexx, Perl, Python, and Tcl (if 
supported for your operating system)
:li.Documentation
:li.Samples and demos
:li.Service developer header files and libraries
:li.Additional codepages
: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 for the System, User, or
None.  If you select System, the System environment variables will be updated.
If you select User, the currently logged-in user's environment variables
will be updated.  If you select None, no environment variables 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 softlinks to be created.
If you select to create softlinks, by default, softlinks to executables
will be created in the /usr/bin directory and softlinks to libraries
will be created in the /usr/lib directory.  Optionally, you can
specify different directories for the softlinks.

: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 which version of Perl you want to be the default Perl
support for STAF.

: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.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.sh 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.You will get a message that you must logout and login to complete
the installation.

:eol.

: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 Unix, issue 
the following command (where xxxxx is the operating system, such
as "linux", "aix", etc.):
:xmp.
  STAF321-setup-xxxxx.bin -is&colon.log /tmp/ismplog.txt -silent -W license.selection="Accept"
:exmp.
or
:xmp.
  java -Dis&colon.debug=1 -jar STAF321-setup-xxxxx.jar -silent -W license.selection="Accept"
:exmp.
:p.After performing a silent installation of STAF, be sure to logout and
login 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-xxxxx.bin -options-record settings.txt 
:exmp.
:p.To specify a response file for a silent STAF installation, issue the
following command:
:xmp.
  STAF321-setup-xxxxx.bin -is&colon.log /tmp/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-xxxxx.bin -is&colon.log /tmp/ismplog.txt -silent -W license.selection="Accept" -W stafinstalldirectory.defaultInstallLocation="/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."/usr/local/staf"
:c.The directory in which STAF should be installed.
:row.
:c.-W setupTypes.selectedSetupTypeId=
:c."Typical"
:c.Indicates the type of installation.  The valid values are "Typical", "Full",
and "Minimal".
:row.
:c.-W stafOptions.updateEnvironmentVariables=
:c."System"
:c.Indicates the type of environment variables to update.  The
valid values are "System", "User", and "None".
:row.
:c.-W stafOptions.defaultIPvVersion=
:c."IPv4 only"
:c.Indicates whether to install support for IPv4 only or for IPv4 and IPv6.
The valid values are "IPv4 only" and "IPv4 and IPv6".
:etable.
:p.For example, to do a silent installation of type "Mimimal", without updating
environment variables, and with the support for IPv4 and IPv6:
:xmp.
STAF321-setup-xxxxx.bin -is&colon.log /tmp/ismplog.txt -silent -W license.selection="Accept" -W setupTypes.selectedSetupTypeId="Minimal" -W stafOptions.updateEnvironmentVariables="None" -W stafOptions.defaultIPvVersion="IPv4 and IPv6"
:exmp.

:h4.Silent Uninstallation
:p.The silent uninstallation uninstalls all STAF components.  To perform 
a silent uninstallation, issue the following command:
:xmp.
  ProductDir/_uninst/uninstaller.bin -silent
:exmp.
.*---------------------------------------------------------------------
:p.
:h3 id=unixsti.Installing Using STAFInst