Selenium Plugin

The Selenium plugin is designed to be able to start/stop the Selenium Server from within Clarive. Selenium Server should be on a Unix machine.

What is Selenium

Selenium is a test automation tool for handling browsers for testing web applications.

Installing

To install the plugin, place the cla-selenium-plugin folder inside $CLARIVE_BASE/plugins directory in the Clarive instance.

SeleniumServer Resource

To configurate the Selenium Server Resource open:

In Clarive SE: Resources -> ClariveSE.

In Clarive EE: Resources -> Selenium.

This Resource is for saving your Selenium Server settings:

• Server - This is the Selenium hostname.
• Path - Full path to Selenium Server jar file.
• Port - The Selenium Server port. The default is 4444.
• Session timeout - Specifies the timeout before the server automatically kills a session that has had no activity in the last X seconds. The default is 1800.

X-Framebuffer options:

• Enabled - This option should be checked if you want run Selenium tests with Xvfb (X virtual framebuffer).
• Command - Command for running Xvfb. The default command is: export DISPLAY=:10;Xvfb :10 -ac

Example:

	Server: Resource-server
	Path: /home/selenium/selenium-server.jar
	Port: 4444
	Session timeout: 1800
	Enabled: True
	Command: export DISPLAY=:10;Xvfb :10 -ac

Start Selenium Server

This service will start the Selenium Server that you select from SeleniumServer Resource.

The various parameters are:

• Selenium Server (variable name: server) - You only need to select the Selenium Server Resource you want to start from Clarive.

Stop Selenium Server

This service will stop the Selenium Server that you select from SeleniumServer Resource.

The various parameters are:

• Selenium Server (server) - You only need to select the Selenium Server Resource you want to stop from Clarive.

It is recommended that you use the service in the step POST in your deployment.

How to use

In Clarive EE

Once the plugin is placed in its folder, you can find this service in the palette in the section of generic service and can be used like any other palette op.

Start/Stop example:

    Selenium Server: Selenium server

Or using vars:

    Selenium Server: ${selenium-server}

In Clarive SE

Rulebook

If you want to use the plugin through the Rulebook, in any do block, use this ops as examples to configure the different parameters:

Start example:

do:
   - selenium_start:
       server: 'selenium_resource'          # Required. Use the mid set to the resource you created 

Stop example:

do:
   - selenium_stop:
       server: 'selenium_resource'     # Required. Use the mid set to the resource you created

Outputs

Success

The service will return the response from the console output.

Possible configuration failures

Task failed

You will get the error from the console output.

Variable required

Error in rulebook (compile): Required argument(s) missing for op "selenium_stop": "server"

Make sure you have all required variables defined.

Not allowed variable

Error in rulebook (compile): Argument `Server` not available for op "selenium_start"

Make sure you are using the correct paramaters (make sure you are writing the variable names correctly).

More questions?

Feel free to join Clarive Community to resolve any of your doubts.