install.script

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

:p.A single gzipped or compressed tar file is provided for
Unix systems.  For some platforms that are not supported by InstallShield MultiPlatform 11.5,
such as Linux IA-64, Linux AMD-64, z/OS, AS/400, etc,
this is the only install file provided.
Before installing STAF, you will need to gunzip the gzipped tar file or
uncompress the compressed tar file and then untar it into a temporary
directory from which you will later run the STAFInst command. 
Note that when you untar the file, it will expand into a single
directory named "staf" that will contain the installation files and directories.
:p.
For example, assuming you downloaded the gzipped tar file for Linux IA64
into a temporary directory named /tmp/STAF,
:xmp.
cd /tmp/STAF
gunzip STAF321-linux-ia64.tar.gz
tar -xvf STAF321-linux-ia64.tar
cd staf
:exmp.
:p.
Or, for example, assuming you downloaded the compressed tar file for z/OS
into a temporary directory named /tmp/STAF,
:xmp.
cd /tmp/STAF
compress -d STAF321-zos.tar.Z
tar -xvf STAF321-zos.tar
cd staf
:exmp.
:p.Note that you can delete this temporary directory (e.g. /tmp/STAF) after
you have run the STAFInst command to install STAF to it's target directory.
:p.Optionally, you may prefer to untar STAF on one system and mount the
installable images from other systems.
:p.Once the STAF installation image is ready, you should run the STAFInst
command.  The syntax is as follows.
:xmp.
Usage: STAFInst [-source <source path>] [-target <target path>]
       [-bin <directory>] [-lib <directory>] [-preview]
       [-type < m | r | f >] [-verbose] [-warn]
       [-ro <mode>] [-rx <mode>] [-rw <mode>] [-dp <mode>]
       [-noreg | [-name <name>] [-email <email>] [-org <org>]]
       [-acceptlicense] [-option name=value]...
:exmp.
:p.:xph.-source:exph. specifes the directory in which the STAF files
were untar'd.  In our example above, this would be /tmp/STAF/staf.  The default
is the current directory.  If you are not running STAFInst from the directory
in which STAFInst resides, you must specify :xph.-source:exph..
:p.:xph.-target:exph. specifes where STAF will be installed. The default is
/usr/local/staf.
:p.:xph.-bin:exph. specifies the directory where softlinks to executables
will be created.  If this option is not specified, softlinks to executables
will not be created.
:p.:xph.-lib:exph. specifies the directory where softlinks to libraries will
be created.  If this option is not specified, softlinks to libraries
will not be created.
:p.:xph.-type:exph. specifies the type of installation (the default is rs).
Possible values are
:ul compact.
:li.m - This installs the minimum files necessary to run STAF
:li.r - This installs the recommended set of STAF files, which includes
some external services (LOG, MONITOR, RESPOOL, and ZIP),
as well as language support for C/C++, Java, Perl, Python, Tcl, and Rexx
(if the platform supports these languages)
:li.f - This installs all STAF files, including all supported codepages
:eul.
:p.:xph.-verbose:exph. specifies that all operations performed by STAFInst
should be displayed to the user.
:p.:xph.-warn:exph. specifies that STAFInst should stop execution if it
encounters a warning condition.  An example of a warning condition is trying
to copy or link a non-existant file.  Normally, these warning conditions are
printed and execution continues.
:p.:xph.-preview:exph. displays the intended actions of STAFInst without
touching the file system.
:p.:xph.-ro:exph. allows you to specify the mode bits for STAF files intended
to be read-only.  The default is 444.
:p.:xph.-rx:exph. allows you to specify the mode bits for STAF files intended
to be read-execute.  The default is 555.
:p.:xph.-rw:exph. allows you to specify the mode bits for STAF files intended
to be read-write.  The default is 664.
:p.:xph.-dp:exph. allows you to specify the mode bits for the directories STAF
creates.  The default is 775.
:p.:xph.-noreg:exph. prevents STAF from automatically registering with IBM
Austin.  This option is highly discouraged.  Please see :hdref refid=autoreg.
for more information.
:p.:xph.-name:exph. allows you to specify the name STAF uses when registering.
The default is the empty string.
:p.:xph.-email:exph. allows you to specify the e-mail address STAF uses when
registering.  The default is the empty string.
:p.:xph.-org:exph. allows you to specify the organization STAF uses when
registering.  The default is the empty string.
:p.:xph.-acceptlicense:exph. indicates that you accept the terms of the 
license agreement for this software.  If not specified, the license agreement
will be displayed at the beginning of the installation.
:p.:xph.-option:exph. allows you to specify options for the installed
components.  The allowed name=value pairs are:
:ul compact.
:li.TCP=IPV4 Specifies to use the IPV4-only TCP libraries.  This is the default.
:li.TCP=IPV4_IPV6 Specifies to use the TCP libraries that support both IPv4 and
IPv6.
:eul.
:p.:hp2.IMPORTANT!:ehp2.  In order to start STAF or to use STAF,
you must set some environment variables as described in
section :hdref refid=envvars..  STAFInst does not update these environment
variables for you.
:p.It is recommended that you start STAFProc (see :hdref refid=stproc.) as
root.  This is to ensure that the Process and File System services will have
full access to the system.
.*---------------------------------------------------------------------
:h3.Examples using STAFInst
:p.For the following examples, assume the STAF installation image is in
/tmp/STAF and your current directory is also /tmp/STAF.
:p.To take all the defaults, which will perform a recommended install of
STAF into /usr/local/staf, you
would simply enter
:xmp.
&period./STAFInst -acceptlicense
:exmp.
:p.To perform a recommended install of STAF into /usr/local/staf, and have
softlinks placed into /usr/bin and /usr/lib, you would enter
:xmp.
&period./STAFInst -acceptlicense -bin /usr/bin -lib /usr/lib
:exmp.
:p.To perform a minimum installation of STAF into /opt/staf, you would enter
:xmp.
&period./STAFInst -acceptlicense -target /opt/staf -type m
:exmp.
:p.To perform a preview of a full STAF installation into the default
/usr/local/staf, you would enter
:xmp.
&period./STAFInst -acceptlicense -type f -preview
:exmp.
:p.To perform a default install of STAF and provide your name and e-mail
address for registration, you would enter
:xmp.
&period./STAFInst -acceptlicense -name "Your name" -email "Your e-mail address"
:exmp.
:p.To install STAF in the default locations but change read-only permissions
to 440, read-execute permissions to 550, read-write priveleges to 660, and
directory permissions to 770, you would enter
:xmp.
&period./STAFInst -acceptlicense -ro 440 -rw 550 -rw 660 -dp 770
:exmp.
.*---------------------------------------------------------------------
:ih1.uninstalling
:i2.Unix
:h3 id=ustuins.Uninstalling STAF
:p.
When STAF is installed on Unix systems, a script called STAFUninst is
created which can be used to uninstall STAF.  This file is created in 
the directory where you installed STAF (default is /usr/local/staf).  
All STAF features will be uninstalled; you cannot choose
which features to uninstall.
However, only the files and softlinks that the STAF install created
will be removed.  Any files created after STAF was installed will
not be removed.
:p.
If STAF was installed using InstallShield MultiPlatform, you will
be prompted to logout to complete the uninstall.
:p.
You must uninstall STAF before reinstalling STAF.
Please see :hdref refid=reinstall. for more information. 
.*---------------------------------------------------------------------
:ih1.unixautostart
:i2.Unix
:h3 id=ustuins.Starting STAF automatically during reboot
:p.You can have STAF start automatically during reboot on Unix machines
by using a script file similar to the following:
:xmp.
#!/bin/sh
PATH=/usr/local/staf/bin&colon.$PATH
export PATH
LD_LIBRARY_PATH=/usr/local/staf/lib
export LD_LIBRARY_PATH
CLASSPATH=/usr/local/staf/lib/JSTAF.jar&colon./usr/local/staf/samples/demo/STAFDemo.jar
export CLASSPATH
STAFCONVDIR=/usr/local/staf/codepage
export STAFCONVDIR
STAFCODEPAGE=LATIN_1
export STAFCODEPAGE
nohup /usr/local/staf/bin/STAFProc > /usr/local/staf/stafproc.out
:exmp.
:p.If you did not install STAF to the default directory (/usr/local/staf), 
then you would need to specify the non-default installation directory in
the script file.
:p.Note that on AIX, you need to replace LD_LIBRARY_PATH with LIBPATH,
and on HP-UX, you need to replace LD_LIBRARY_PATH with SHLIB_PATH.
:p.Note that if your Unix operating system does not support the "nohup"
command, then remove it from the last line in the script:
:xmp.
/usr/local/staf/bin/STAFProc > /usr/local/staf/stafproc.out
:exmp.
:p.The console output from STAFProc will be stored in the 
/usr/local/staf/stafproc.out file.
:p.The usage of this script file varies depending on the specific Unix
operating system:
:ul.
:li.On Linux, in general, add the script lines to the /etc/rc.d/rc.local file.
:li.On Linux SuSe, add the script lines to the /etc/init.d/boot.local file.
:li.On Solaris, create a file in /etc/rc2.d (give the file whatever name 
you want, maybe "staf"), and add the script lines to the file.
:li.On AIX, create /etc/rc.something file, and add the script lines to the
file.  Then, change the /etc/inittab so that your file will start
during boot.
:li.On HP-UX, create a file /sbin/init.d (give the file whatever name
you want, maybe "staf'), and add the script lines to the file.  Then
you must put a file called "staf" (the same name used in /sbin/init.d,
containing a variable declaration, like STAF=1) in /etc/rc.config.d.
Finally, you have to create a symbolic link to your /sbin/init.d/staf,
called S84staf, in /sbin/rc3.d.
:eul.
:p.You may get the following error message:
:xmp.
STAFProcess&colon.&colon.processMonitorThread: error opening /dev/tty, errno: 6
:exmp.
:p.However, STAFProc does start despite this message, and functions
normally.

.*---------------------------------------------------------------------
:i2.Linux
:h2 id=linuxins.Linux installation
:p.Note, when you are running STAF on Linux RedHat 9.0 or later, you
may encounter a Segmentation Fault every time you execute the STAF 
executable.  To work around this problem, set the following environment 
variable:
:xmp.
LD_ASSUME_KERNEL=<kernel-version>
:exmp.
:p.The following versions can be specified for :xph.<kernel-version>:exph.
:ul.
:li.:xph.2.4.1:exph. -- Linuxthreads with floating stacks
:li.:xph.2.2.5:exph. -- Linuxthreads without floating stacks
:eul.
:p.For information on Linux operating system library compatability,
see :hdref refid=oscompatibility..


.*---------------------------------------------------------------------
:i2.Solaris
:h2 id=solarisins.Solaris installation
:p.Note that starting in STAF V3.2.0, InstallShield Multi-Platform 11.5 is used.
This version of InstallShield no longer supports Solaris 2.6.  It only supports
Solaris 2.7+.  So, to install STAF on Solaris 2.6, you cannot use
the STAF321-setup-solaris.bin or STAF321-setup-solaris.jar file (both of
which use InstallShield Multi-Platform 11.5).  Instead, you must use
the STAF321-solaris.tar.gz file.  For more information on installing
using a tar.gz file and STAFInst, see :hdref refid=unixsti..

.*---------------------------------------------------------------------
:i2.HP-UX IA64 64-bit
:h2 id=hp64ins.HP-UX IA64 64-bit installation
:p.Note, if you plan to use Java services, or STAF-enabled Java applications
with the 64-bit version of STAF for HP-UX IA64, you must use Java 1.4.1 or
later.  For more information see :hdref refid=jvmcfg..

.*---------------------------------------------------------------------
:i2.OS/400
:h2 id=as400inst.OS/400 installation
:h3.Setup instructions for STAF on OS/400 (iSeries)
:p.Note: STAF will only run on OS/400 V5R2 or newer.

:p.Follow these instructions to install STAF:
:ol.
:li.Create a directory /QIBM/stafinst on your OS/400 system (or use
whatever directory name you prefer).  This will be a temporary 
directory where you'll untar the STAF installer file.
:li.Download latest version of STAF for OS/400 (e.g. STAF321-as400.tar.gz)
from the
.*b2h html <A HREF="http://staf.sourceforge.net/getcurrent.php">Download STAF</A>
website to directory /QIBM/stafinst.
:li.You must install STAF from the OS/400 PASE environment which
simulates the AIX operating system.  To change to the OS/400 PASE
environment, type the following from the AS/400 command line:
:xmp.
  CALL QP2TERM
:exmp.
:li.Unzip the STAF321-as400.tar.gz file and run the STAFInst executable
to install STAF to location /QIBM/staf (or to whatever location you prefer).
See section :hdref refid=unixsti. for more information on STAFInst.
:xmp.
  cd /QIBM/stafinst
  gunzip STAF321-as400.tar.gz
  tar xf STAF321-as400.tar
  cd staf
  . ./STAFInst -target /QIBM/staf -acceptlicense
:exmp.
:p.Notes:
:ul compact.
:li.If gunzip is not available on your OS/400 machine and you have
access to a AIX machine, you can use the AIX gunzip executable on the
OS/400 machine.
:li.If STAF is already installed in /QIBM/staf, and you want to upgrade
to a new version of STAF, you should backup your STAF.cfg file and
then run STAFUninst to uninstall STAF before running STAFInst, and
then restore your backed up STAF.cfg file.  For example, assuming
you've already unzipped the STAF installer tar.gz file in /QIBM/stafinst,
here are the steps to upgrade STAF:
:xmp.
  cd /QIBM/staf
  cp bin/STAF.cfg bin/STAF.cfg_save
  . ./STAFUninst
  cd /QIBM/stafinst/staf
  . ./STAFInst -target /QIBM/staf -acceptlicense
  cd /QIBM/staf
  cp bin/STAF.cfg_save bin/STAF.cfg
:exmp.