========================================================================== Author: Carl Nagle UPDATED: July 31, 2007 Copyright (C) SAS Institute General Public License: http://www.opensource.org/licenses/gpl-license.php ==========================================================================
Configure for Execution , Configure for Development
These instructions assume the tester has already installed STAF and SAFS services via the
SetupSAFS script (or alternative methods). If this is not the case, please refer
to the SetupSAFS.README file for information on the SAFS
setup procedure.
Note: If you have installed RRAFS for Rational Robot, SetupSAFS is automatically invoked by
the standard SetupRRAFS install script unless the user cancels the SAFS install when prompted.
SAFS uses Selenium Remote Control using Selenium's Java Client Driver. The Selenium server is used in Proxy Injection Mode via localhost:4444. No other proxy web server is necessary and Selenium does not have to be installed on your application's web server.
We will not attempt to duplicate information on setting up Selenium for general testing. Information for using Selenium outside the context of SAFS can be found on the Selenium website at OpenQA.org.
Back to Top , Configure for Development
If all you want to do is run the SAFS/Selenium engine then setup is fairly simple. Briefly, it requires these steps which are discussed in more detail immediately following:
selenium-server.jar
selenium-java-client-driver.jar
The Project RRAFS.INI file -- by default located in the "C:\SAFS\Project\Datapool\Runtime" directory -- should be copied into your Robot project's Datapool\Runtime directory. Then you can proceed with providing the correct settings consistent with your project. Below we show only those settings that may need editing. Any other settings as shown in the RRAFS.INI are still necessary.
[SAFS_SELENIUM] AUTOLAUNCH=TRUE ;======================================== ;= Java JVM must be 1.5 or greater ;= not needed if "java" finds 1.5 in PATH ;======================================== JVM="C:\Java_15\bin\java.exe" ;======================================================== ;= Uncomment the browser to use ;= Selenium bug prevents *piiexplore and *pifirefox usage ;======================================================== ;BROWSER="*custom C:\Program Files\Internet Explorer\IEXPLORE.EXE" ;BROWSER="*custom C:\Program Files\<path to>\FIREFOX.EXE" ;===================================================== ;= specify Selenium proxyInjectMode forwarding gateway ;= the true gateway selenium needs to the internet\WAN ;===================================================== PROXY=your.normal.gateway.com PORT=80
Provide the settings consistent with your project's SAFSTID.INI or <unique-test>.INI files. Below we show only those settings that may need editing.
[SAFS_ENGINES] First=org.safs.tools.engines.SAFSSELENIUM or Second=org.safs.tools.engines.SAFSSELENIUM etc.. [SAFS_SELENIUM] AUTOLAUNCH=TRUE ;======================================== ;= Java JVM must be 1.5 or greater ;= not needed if "java" finds 1.5 in PATH ;======================================== JVM="C:\Java_15\bin\java.exe" ;======================================================== ;= Uncomment the browser to use ;= Selenium bug prevents *piiexplore and *pifirefox usage ;======================================================== ;BROWSER="*custom C:\Program Files\Internet Explorer\IEXPLORE.EXE" ;BROWSER="*custom C:\Program Files\<path to>\FIREFOX.EXE" ;===================================================== ;= specify Selenium proxyInjectMode forwarding gateway ;= the true gateway selenium needs to the internet\WAN ;===================================================== PROXY=your.normal.gateway.com PORT=80
Back to Top , Configure for Execution
To actually develop new code or keywords for Selenium or other Java-based engines, or to debug Selenium test execution the user would have to prepare their Java development environment. Below are examples suitable for environments like Eclipse. Note: Eclipse for Java development does not use the System \ CLASSPATH to locate class files and other resources.
Back to Top , Configure for Execution , Configure for Development