org.safs.selenium.util

Class SeleniumServerRMIInjector

java.lang.Object

org.safs.selenium.util.SeleniumServerRMIInjector

public class SeleniumServerRMIInjector
extends java.lang.Object

This class is used to provide our RMI support into a SeleniumServer process.

• Launching a standalone Selenium Server SeleniumPlus RMI support.
• Launching a hub (in grid mode) Selenium Server with SeleniumPlus RMI support.
• Launching a node (in grid mode) Selenium Server with SeleniumPlus RMI support.

Required parameters:
-jar fullpath/to/selenium-server-standalone-<version>.jar
-timeout=N Controls how long (in seconds) the client is allowed to be gone before the session is reclaimed
-browserTimeout=N Controls how long (in seconds) the browser is allowed to hang
-Djava.rmi.server.hostname=<full hostname or ip address>

The correct hostname is imperative as later versions of Java seem to resolve the our hostname to "localhost" or "127.0.0.1" which will cause connection failures on remote systems trying to communicate with this RMI Server.)

One of the following:

-safs.rmi.server (no arg: default SeleniumPlus RMI Server)
-safs.rmi.server <full.package.classname> (alternative/custom RMI Server)
-Dsafs.rmi.server <full.package.classname> (alternative/custom RMI Server)

Other JVM params--including those needed by Selenium Server ( -Dwebdriver...)--must also be provided and will have already been applied to this JVM process.

Consequently, a typical command-line invocation of this Java program would look like:

 <pathTo>/bin/java 
 
     -Xms51m -Xmx1g (or -Xmx2g)
     -cp <pathTo>/seleniumplus.jar;<pathTo>/JSTAFEmbedded.jar;<pathTo>selenium-server-standalone-<version>.jar
     
     -Dsafs.rmi.server 
     -Dwebdriver.log.file="webdriver.console" 
     -Dwebdriver.firefox.logfile="firefox.console" 
     -Dwebdriver.safari.logfile="safari.console" 
     -Dwebdriver.ie.logfile="ie.console" 
     -Dwebdriver.opera.logfile="opera.console" 
     -Dwebdriver.chrome.logfile="chrome.console" 
     -Dwebdriver.chrome.driver="<pathTo/chromedriver.exe" 
     -Dwebdriver.ie.driver="<pathTo/IEDriverServer.exe"
     
     org.safs.selenium.util.SeleniumServerRMIInjector 
     
     -jar <pathTo>/selenium-server-standalone-<version>.jar;
     -timeout=20
     -browserTimeout=60
 

Optional parameters:
-port N, optional, the port number for Selenium Server. If not provided, the default port will be used. For "standalone" and "hub" the default port number is 4444; While for "node", it is 5555.
-role TheServerRole, optional, if not provided, a standalone server will be launched.
TheServerRole could be "hub", and selenium server will be launched as a hub (in grid mode) for other node to connect.
TheServerRole could be "node", and selenium server will be launched as a node (in grid mode) to connect a hub. **Note** Hub's information must also be provided. Ex: -role node -hub http://hub.machine:port/grid/register

See Also:

SeleniumRMIServer, SeleniumServer, SeleniumRMIAgent, SeleniumAgent

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_RMISERVER_CLASSNAME 'org.safs.selenium.rmi.server.SeleniumServer'
static java.lang.String	PROPERTY_RMISERVER 'safs.rmi.server'
protected static java.lang.String	rmiServerClassname

Method Summary

Modifier and Type	Method and Description
protected static void	launchRMIServer() Start an RMI Server class specified on the command-line, if any.
static void	main(java.lang.String[] args) This class entry point is used to provide our RMI support into a SeleniumServer process.
protected static java.lang.String[]	processArgs(java.lang.String[] args)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

rmiServerClassname

protected static java.lang.String rmiServerClassname

PROPERTY_RMISERVER

public static final java.lang.String PROPERTY_RMISERVER

'safs.rmi.server'

See Also:

Constant Field Values

DEFAULT_RMISERVER_CLASSNAME

public static final java.lang.String DEFAULT_RMISERVER_CLASSNAME

'org.safs.selenium.rmi.server.SeleniumServer'

Method Detail

processArgs

protected static java.lang.String[] processArgs(java.lang.String[] args)
                                         throws java.io.IOException

Throws:

java.io.IOException

launchRMIServer

protected static void launchRMIServer()
                               throws java.lang.InstantiationException,
                                      java.lang.IllegalAccessException,
                                      java.lang.ClassNotFoundException

Start an RMI Server class specified on the command-line, if any. If none was specified, then nothing happens.

Throws:

java.lang.ClassNotFoundException

java.lang.IllegalAccessException

java.lang.InstantiationException

main

public static void main(java.lang.String[] args)

This class entry point is used to provide our RMI support into a SeleniumServer process.