   |
 | |||
 |
| |||
Application Details
| Developer: | Patrick Hornberger |
| Version: | 1.0 |
| Release Date: | 3 March 2010 |
| Compatibility: | iTest 3.4.1 or above |
Recent Support Topics
iTest® Remote
iTest Remote is an application for the iPhone® and iPod touch® that allows the user to remotely control iTest instances to execute and monitor test cases and test suites.
Usage Overview
Once iTest has been configured to be remotely controllable, iTest Remote can be used to browse the project hierarchy and start the execution of test cases and test suites that are present in the user’s iTest workspace. When a test case or test suite is initiated via iTest Remote, the user can:
- Monitor the progress of the test execution
- Review status messages and execution issues in real time or after execution has completed
- Terminate test executions when necessary
The remote control of iTest is provided by a SweetLime server. Fanfare provides a hosted SweetLime server that iTest Remote will talk to by default. Users can configure a secure password that restricts access to their iTest instance(s).
With iTest Remote, multiple instances of iTest can be browsed and controlled at any one time. Remote control can be turned on or off at any time in iTest preferences.
Installation Instructions
Installation is a two-step process:
- Click the "Download" button on this page to download the required iTest plugins. This download is provided as a packaged update that can be installed directly into iTest using the "Software Updates" functionality.
Instructions for installing the iTest plugins as a software update » - Download and install the iTest Remote client application for the iPhone via Apple’s iTunes App Store.
Configuration Instructions
- In iTest, open the preferences dialog (Window/Preferences) and select the “SweetLime Server” entry.
- Make sure the Server field is set to the proper server name. By default this points to a server hosted by Fanfare. This is also the default server that the iTest Remote iPhone client application will use. If you are hosting a dedicated server (see below) then you may change this value to point to it.
- Ensure that the Agent Name field has a value that represents your iTest instance. This value must be unique among all agents registered on the same server. If you attempt to connect, you may receive an error if an agent is already registered with that name. If this happens, simply choose a different name and try again.
- Password is optional but highly recommended. If you leave this blank you will be warned before connecting. Be aware that your data may be viewable by other users if you choose to not enter a password.
- Select the “Enable remote control” checkbox to connect to the server.
- At this point, if there were no connection errors, your instance of iTest is now remotely controllable by the iTest Remote application.
Dedicated Server Installation Instructions (optional)
iTest Remote is configured by default to communicate with a server hosted by Fanfare. If your usage needs or company policy require the use of a dedicated server hosted internally by your company, then you may download and install the separate “SweetLime” server. Here are the specific steps to follow:
- Download this server file and expand to the installation location on your server machine.
- SweetLime server is only supported on Linux server machines. Ensure that you have a proper Java runtime. (Java 1.6 or above – Sun distribution only)
- The SweetLime server is packaged as a web application running under the Jetty web server.
- Within the etc folder under the installation there is a file called jetty.xml.
- Edit this file and change the property “host” within the “addConnector” xml element to point to the IP address of the server that you are running on.
- Change the “port” property to be the port that the server should be listening on.
- Save the file.
- Run the command “bin/jetty.sh start” to start the server.
- Run the command “bin/jetty.sh stop” to shutdown the server.
Known Limitations
- Although the application allows for both portrait and landscape modes, currently the Connection Setup screen works only in portrait mode.
- Turning off the iPhone screen and turning it back on may occasionally cause connectivity problems. It is best to return to the Home screen and restart the application.
Screenshots
Click the thumbnails to see full-size screenshots.
Support
This application is not officially supported by Fanfare. If you have questions about this application or would like to provide feedback or feature requests to the developer, please post to this board on the Fanfare discussion forums. (You must register or log in before you will be allowed to post.)