Get started
In this walkthrough, we'll demonstrate how to use Nerrvana's user interface by launching a simple demo test. If you haven’t yet registered an account and received your confirmation email, please do so now before proceeding.
1
Create a New Space
To be able to upload tests, you first need to create a 'Space'. You do this by clicking the 'Add new space' button.
Add new space button
Now type 'Hello World'. Nerrvana shows you the ftp folder it will create once the space is saved.
Save space
After you've saved the space, navigate to https://your_user_name.ftp.nerrvana.com/Hello_World. You'll see two subfolders: _files, where we'll upload Selenium tests and _results, where Nerrvana will store test runs and their results.
Add new space button Next we'll set an FTPS client and upload our tests into the space we just created.
2
Set FTPS client and Upload Tests
Nerrvana supports file uploads and downloads via FTPS protocol. Below are GUI instructions for FileZilla and WinSCP and UNIX command line instructions for LFTP. Prepare an FTPS client of your choice and click one of the logos to see instructions for it.

NOTE! FTPS is not the same thing as SFTP and SCP FTPS in Wiki
FileZilla WinSCP LFTP

click a different logo to get instructions for another FTPS client
As you probably noticed, your FTPS directory is your_user_name.ftp.nerrvana.com. This is also included in your registration email.

To connect, select Site Manager and create a Nerrvana connection. Note: You won't be able to connect using Quickconnect because it uses plain FTP encryption, which isn't supported by Nerrvana. FileZilla instructions Choose either the explicit or implicit FTP over TLS option—either will work. FileZilla instructions Once an FTPS connection is established, you're ready to upload your tests. FileZilla instructions

To use our sample tests in PHP and Java, save the file and unpack it to a folder on your computer. Then navigate to the remote /Hello_World/_files directory in FileZilla and upload the tests. Once this is completed, you'll be ready to create a test run and start your tests.
3
Create Test Run and Launch Tests
Click 'Add new test run' button on Dashboard WinSCP instructions

Select the space ‘Hello World’ (A).

Enter ‘Walkthrough’ as your test run name (B).

Select an executable file from the box showing all of the files we have just uploaded (C).

If you want to launch PHP tests, use simple_google_test_php/rebuildAndRun.sh. For Java tests, use simple_google_test_java/rebuildAndRun.sh. Then select the platforms and browsers (D) to run the tests on.

Select one 'Selenium node per platform' (F) for now. Note: You can read about running parallel tests in Nerrvana here.

For our walkthrough, we will use 'Option 1'—run validation and execute tests once (E), which is the simplest way to run tests.

Click 'Save' and return to Dashboard.

In the Dashboard, we see that our test run is scheduled ('N' = Next) and about to run (A).

As the execution proceeds, the 'N' changes to 'R' (Running) and then to 'OK' (B) and (C). Eventually, all of the icons will read 'OK' (D), which means that the tests were successfully completed. (It's necessary to refresh the page to see the progress.)

Note: OK status only indicates that Nerrvana has successfully executed the tests. It doesn't mean that the tests haven't found problems. Actual test results are contained in reports your tests generate. You can also use 'messages' (see below and in the User's Guide) to display key information in Nerrvana's UI.

4
Check results

Now let's see what Nerrvana can show us about the test run.

The basic screen indicates that the 'Walkthrough' test run was executed on 23 Feb 2012 at 15:32. You can expand this information by clicking it (A) and get detailed data for specific platforms by clicking on them (B).

Here we see a statistics summary for the test run execution (A). Nerrvana launched ten virtual machines (two for each platform): one Selenium Hub where tests were executed and one Selenium node with the platforms we specified. We can see how long the tests ran on each platform and how much inbound and outbound traffic they generated.

Since we requested validation, this data is visible in section (B). If you launched the PHP version of the tests, you'll see a non-fatal validation error we created. It's always a good idea to validate a test run (without launching tests) before executing it for the first time. If your tests fail validation due to PHP/Java version mismatch or missing libraries, please notify us.

Next you'll see statistics (C), messages (D) and a link to the HTTPS site (E) running on top of the FTPS server for the platforms you selected (in this case, Firefox/Win XP SP3), where you can browse files and see reports your test generated.

Note: Messages are generated inside tests and are used to bring important data to the Nerrvana UI. For example, you can use messages to log key test results and see how tests ran without looking at the more detailed reports.


To browse test results via HTTPS, click the Browse link (E) and enter your username and password to access the test run folder.

Here we can see the following information:

(1) The 'Hello_World' folder was created by Nerrvana when we added a new Space. This is where we loaded our tests.

(2) This folder contains all test runs for a particular Space.

(3) 'Walkthrough' was created by Nerrvana when we added a new test run.

(4) 'Walkthrough' test run was executed on 22 Jun 2012 at 00:11.

(5) Results for platforms WinXP SP3 and Firefox 3.6.

There will always be two folders below it.

(6) The first folder _raw_logs contains raw logs from the Hub and nodes to help you debug your tests.

(7) The second folder _files_out contains tests uploaded from the Hub after test's completion. If your tests generated reports, you'll see them below _files_out directory. Our demo tests do not produce any reports, but they save some screenshots in the top level directory. You can see them just below the _files_out directory.

You may notice a discrepancy between time stamps on test run executions (4) and files (8) here. The former is the time tests were launched in your local time zone and (8) is the GMT time when files where uploaded from the Hub to Nerrvana's FTPS server.

Even though the directory structure may look complicated and messy, it is pretty straightforward and logical. You can find a detailed diagram of it in Nerrvana's User Guide.