Definitions, Critical Reminders, SAFS Tools, Install Instructions, Setup Notes, New Stuff
|SAFS||Software Automation Framework Support|
|SAFS Driver||The tool that initializes, opens, parses, and routes SAFS test records to available SAFS Engines.|
|SAFS Engine||A keyword-driven automation tool capable of interpreting and executing SAFS test records.|
|SAFS/DriverCommands||A SAFS Engine for tool-independent Driver Commands|
|SAFS/RobotJ (RFT)||A SAFS Engine for testing using Functional Tester by IBM Rational.|
|SAFS/TC (TCAFS)||A SAFS Engine for testing using TestComplete by AutomatedQA.|
|SAFS/DROID (DRD)||A SAFS Engine for testing using the Android SDK.|
|SAFS/IOS (IOS)||A SAFS Engine for testing using the Apple XCode SDK. (SAFS for Mac Only)|
|SAFS/SELENIUM (Se)||A SAFS Engine for testing using Selenium.|
|SAFS IBT (Pat.Pend.)||An embedded SAFS Engine for Image-Based Testing. (Patent Pending)|
|JSAFS||Java API for embedding SAFS in custom frameworks or your own Advanced Runtime.|
This release supports installing SAFS on 32-Bit and 64-Bit Windows Operating Systems.
This release, along with all future releases, provides a simplified install process that supports STAF 3.X installing with Java 1.5 or greater. All the latest functionality of SAFS on Windows--including JSAFS, and supported tools like IBM Rational Functional Tester, AutomatedQA TestComplete, Android SDK, Selenium, and Image-Based Testing are included in this release.
This release does NOT support installing SAFS on the Apple Mac for IOS testing, or installing and testing on Linux or Unix. For SAFS Mac and IOS Support please download SAFS Mac support and consult the SAFS Mac Release Notes.
If you are using RRAFS you must continue to use\install STAF V2 unless you have applied RRAFSPatch2010.01.14. That patch provides STAF V3 support to RRAFS.
If installing STAF V2 you MUST have Java 1.5 as the default JVM--NOT Java 1.6 or later.
Affected customizations from previous releases:
If you have taken advantage of any of the customization capabilities of this framework, then you must take some simple precautions prior to installing this new release. Installing a new version of the framework will install new, default versions of customizable files.
If you have a modified SAFSTID.INI in your install directory, you should make a back-up, then evaluate how and if you want to merge with the new file.
SAFS Batch Files
If you have previously installed the SAFS Framework then you may have manually modified batch files or VBS scripts to handle custom project paths. You will need to backup modified files and evaluate how and if you want to merge such changes with the new files.
In addition, some of the Batch files have been modified to show support for 64-bit Windows systems where Java is being invoked. These batch files must be properly edited to launch a 32-bit JVM.
SAFS Project Files
If you have previously installed and edited any of the INI or BAT files in the SAFS\Project or SAFS\samples directories then you will need to backup these modified files and evaluate how and if you want to merge such changes with the new files.
SAFS Object Mapping Files
If you have previously installed and edited any of the following files then you will need to backup the modified files and evaluate how and if you want to merge your edits with the new (default) versions of these files:
Failure to perform any of these prescribed backups may erase your prior customizations. Hopefully, you have backed them up somewhere already as part of your normal ongoing activities... Right?!
It is important to note that 64-bit systems might have a 64-bit Java JVM installed. Testing has shown that we can install 32-bit SAFS and STAF using the 64-bit JVM, but SAFS and STAF will require a 32-bit Java JVM to use at runtime. SAFS Batch scripts in the SAFS install directories, including those in the SAFS\Project space may need to be edited to point to the desired 32-bit JRE installed on the 64-bit system.
Note: STAFWrap.DLL and DDVariableStore.DLL have been refactored in order to support both STAF V2.X and STAF V3.X
STAFWrap.DLL, ComponentFunctions.DLL, DDVariableStore.DLL and associated scripts for registering DVariableStore.DLL are included in the SAFS\bin directory. The SetupSAFS script does register and\or move files to system directories as necessary.
COM classes supporting COM access to STAF for use in VBScript and other COM-related features exist in the latest version of DDVariableStore.DLL. Consult the sourcecode in CVS or any VBA or COM object browser until more proper documentation is made available. A very rudimentary "RUTHere" test script for this COM STAF interface can be found in SAFS\bin\DDVariableStoreTest.VBS.
A Java Runtime Environment (JRE) and Windows Scripting Host V5.6 or later is required.
RRAFS (Rational Robot) users might do best to extract into their ".\Program Files\Rational\Rational Test\sqabas32" directory. (Although this should not be necessary with a RRAFS release since that includes the SAFS install files already. Only do this if you are upgrading SAFS without upgrading RRAFS.)
Enable "OVERWRITE Existing Files" if you are overwriting a previous release of SAFS.
The installation will prompt to confirm the installation of SAFS and the version of STAF to install, if any. The user has the option to skip these installations by pressing "No" or "Cancel" when prompted.
You do not need to reinstall STAF if you already have STAF installed. However, you can choose to reinstall STAF to overwrite STAF 2.X with the new STAF V3.X version.
This should run a simple SAFS Test and generate logs in:
The installation will not install any program that will appear in Control Panel's "Add/Remove Program" application. However, depending upon the STAF install scenario, STAF might install "Software Testing Automation Framework" into the Control Panel's "Add/Remove Program" application.
|SetupRRAFS||IBM Rational Robot Setup for SAFS Testing|
|SetupRobotJ||IBM Rational Functional Tester Setup for SAFS Testing.|
|SetupTCAFS||AQA TestComplete Setup for SAFS Testing.|
|SetupAndroid||Android Setup for SAFS Testing.|
|SetupSelenium||Selenium Quick Start for SAFS Testing.|
Carl Nagle, SAS Project Manager, SAFSDEV Subscribe to appropriate Support Forums to review support archives and ask questons.