REMOTE LABORATORY
- GENERIC RIG ACCESS GUIDE
VERSION 1.6
The Labshare Institute© 2012
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 1
Table of Contents
1 User and System Settings ........................................................................................................................ 2
1.1 Remote Access ............................................................................................................................... 4
1.1.1 Account Details for FEIT or Non-AAF Users ................................................................................. 4
1.1.2 Account Details for AAF (Australian Access Federation) Users .................................................... 5
1.2 Queuing for a rig ............................................................................................................................. 9
1.3 Reserving a rig .............................................................................................................................. 10
1.4 Using the Rig Page ....................................................................................................................... 17
1.5 Experiment Data File Transfer ....................................................................................................... 20
1.6 Exiting a Rig .................................................................................................................................. 21
2 FAQ & Troubleshooting ........................................................................................................................... 25
3 About Remote Labs ................................................................................................................................ 26
3.1 Remote Laboratories ..................................................................................................................... 26
3.2 The Rig Apparatus ........................................................................................................................ 26
1.0 04/08/2010 First draft &Internal release version LaReineYeoh
1.1 06/09/2010 Revision & general formatting Ellie Burke
1.2 11/02/2011 Screenshot update Ellie Burke
1.3 07/03/2011 Reservation section added& general revision Ellie Burke
1.4 06/06/2011 Labshare logo added Ellie Burke
1.5 23/06/2011 Revision and general formatting Ellie Burke
1.6 29/02/2012 Revision and general formatting Ellie Burke
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 2
1 User and System Settings
Please note that the settings provided below is specific for the UTS remote labs.
Operating System Browser (tested and supported) Applet Screen Resolution
Windows XP, Vista, 7 Mozilla Firefox 3.6+ Java 6 (latest update) 1024x768 and above
Mac OS 10.6+ Chrome (latest version) Adobe Flash 10+
Linux Internet Explorer 7+
Apple Safari
For the purpose of using the Remote Labs Rigs, it is assumed that users have access to a workstation with
properly working operating system. The current workstation must also have Internet connectivity, preferably
with a bandwidth of at least 512kbps downstream.
Operating System:
- Windows XP, Vista, 7
- Mac OS 10.6
- Linux
Web Browser
Remote Labs have been tested with a number of current web browsers. Labshare recommends Firefox. The
user is responsible for ensuring that the current browser version is up to date.
Web Browser:
- Mozilla Firefox 3.6 and above
- Google Chrome
- Internet Explorer 7 and above
- Apple Safari
Note: Internet Explorer 6 is not recommended for use and Remote Labs operates in a functionality-limited
mode with this browser. Earlier versions of IE will NOT function. Users are recommended to update to the
latest version of Internet Explorer for your operating system.
Java Runtime Engine
A Java Runtime Engine (JRE) plugin is required to access the Remote Labs through a web browser. Java
6.0 is highly recommended with the latest updates applied. If a user is accessing the rig from his/her home
PC and does not have the JRE installed, the user will be automatically asked to install it. Otherwise, the
JRE can be found at: http://www.java.com/en/
Note: The rig control Java applet first loads when the user is directed to the rig and the user is asked to
accept a security warning. If the user does not accept this warning, the rig control applet will not function
correctly and the rig cannot be used.
Note: In many recent Linux distributions, OpenJDK is packaged as the Java version supported by the
distribution package manager. OpenJDK may be successfully used as a Remote Labs compatible JRE.
Video Plugins
Depending on the rig type used you may encounter one or more of the following video formats:
Flash - This requires the Adobe Flash plugin to be installed.
Motion JPEG - Depending on the browser this may either play within the browser using no plug-ins
(Firefox, Chrome, Safari) or using a Java applet deployed when selecting this format (Internet
Explorer).
JPEG Refresh - This uses JPEG images that are automatically refreshed at a user selected period
between 0.25 seconds and 2 seconds and requires no plugins.
WMP Plugin - This requires the Windows Media Player plugin or equivalent (Totem on Linux or
Flip4Mac on Mac OS X) to play the video.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 3
VLC Plugin - This requires the VLC plugin to play the video.
If the user is unsure whether any of these plugins are already installed, check the browser settings. On
Internet Explorer, go to 'Tools' -> 'Manage Add-ons' and on Mozilla Firefox or Google Chrome type
'about:plugins' in the address bar and press the 'Enter' key.
Firewall Issues
Often, private networks (such as companies, universities and even home networks) operate through firewalls
or proxies. Sahara requires the following ports to be open:
3389 (outbound): Remote Desktop Connection
7070 (outbound): Video Feed
If very restrictively configured, these may occasionally disallow data coming from the Remote Labs servers
to a current browser.
When to Queue
Please check the reservation calendar for availability before queuing. Also, please note that “queuing” for a
rig session may result in long wait times due to the high volume of reservations made by other students,
academics and Remote Labs technical officers.
As a general note, it is recommended that users utilise the “Queue” option rather than the “Reservation”
option as this results in higher efficiency for usage and allocation of rigs to more users.
When to Reserve
Reserving a rig session may be helpful for users who do not have time to queue and wait to use a rig.
Reservation can be made through the reservation calendar. Please be aware that the user must log-in within
10 minutes of your reservation period, otherwise the system will drop the user’s reservation once the timer
has expired to allow queuing users to access the rig. The user will not be able to return to the rig without
either queuing or making another reservation.
Please be aware of the notification in red located on top of the session screen that states, “Your session will
be terminated if you do not use this rig within XXX seconds”.
Also, for users that have created a reservation and do not intend to be use the reservation, please be
courteous to others and cancel the reservation so they may use the rig in that time period.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 4
1.1 Remote Access
This guide uses the ‘Shake Table Rig’ as an example how to work with Remote Labs and how to control a rig.
While the web page user interface may look slightly different, access to other rig types will operate in a
similar way.
NOTE: The following step-by-step guide requires the user to have received proper login details of
username and password from The Labshare Institute (TLI), and that the user is able to access the
page.
From the current desktop, the user is to open a new browser window and navigate to the UTS Remote Labs
page, which is also the login page.
1.1.1 Account Details for FEIT or Non-AAF Users
FEIT users
The Labshare Institute (TLI) does not govern remote labs account details for UTS users. Please log in using
your normal UTS FEIT username. All UTS FEIT users must reset their passwords at:
https://webmail.eng.uts.edu.au/myaccounts/
If you are still receiving an error message, please click on the "Contact Support" button and provide specific
details of the error or issue.
Non-AAF (Non-Australian Access Federation) users
Generally, remote labs account details are emailed from TLI to users prior to your class access period.
Please check your email including junk and spam boxes/folders for your account details. If you still can't find
the account details, please click on the "Contact Support" button for the account request.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 5
At the login prompt, enter username and password that you have been provided with.
1.1.2 Account Details for AAF (Australian Access Federation) Users
All users from institutions that are registered with AAF should click on the AAF button to log in to the UTS
Remote Labs.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 6
For first time users, TLI will have provided the user with a URL (with permission for access) that will
automatically direct the user to the page shown below to log in. Please select your own institution from the
drop down list. The example below uses Monash University’s AAF registration information.
When the institution is selected, the user will be directed to their institution’s federated login page. You can
log in using your normal username and password that are provided by your institution.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 7
The user may be presented with a ‘Digital ID Card’ which is unique information that the system requires from
all AAF users to access UTS Remote Labs. Please click on the ‘Confirm’ button to continue.
The user will then be directed to the “Rig Selection” page where a rig can be selected to use. The user can
select the ‘Shake Table’ rig type under the Shake Table tab.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 8
Note the icon for the Shake Table should show an ‘Active’ green arrow as an indicator, meaning the user is
allowed access to the rig. If either the ‘Inactive’ or ‘Locked’ icons show up, the user should contact the course
coordinator to check the access status.
Active: The rig is online and the user may queue to use.
Inactive: User does not have permission to queue for this rig. Permissions are
time –based and the current time is out of the assigned usage period.
Locked: The rig is online, but it is locked. Before a user can queue, a pass key
must be supplied
Free: The rig is online and free to use.
In Use: The rig is online, but being accessed by another user.
Offline: The rig is offline and cannot be used.
Next, a dialog will appear to ask whether the user wishes to reserve, queue or cancel for the selected Rig.
This dialog will indicate if the rig is available and free for use, as per the legend on the ‘Rig Selection’ page.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 9
1.2 Queuing for a rig
To access and use the rig right away, the user can select to queue for the rig type. Click on the “Queue”
button (circled in red) to access the rig.
Note: If the rig status is yellow, the Rig is already in use and the user (who has chosen to queue) will be put
in a queue until the current user and any other queued users ahead are finished. The queue page indicates
the user’s position in the queue. The user’s position in the queue may be forfeited if the user logs out or
navigates away from the queue page.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 10
1.3 Reserving a rig
To be directed to the ‘Reservation’ page, click on the “Reserve” button (circled in red).
The ‘Reservation’ page allows a user to reserve future rig sessions in advance. Availability and time slots
depend on allotted permission for the rig. The permission will be decided by the relevant academic of the
coursework.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 11
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 12
To reserve a rig, a user can select a date by clicking the calendar icon, which is located next to the date
window.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 13
To select the desired time slot, click and drag down to set the reservation period. Click the green check
button to confirm or the red X button to cancel.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 14
A confirmation dialog will appear for the user to click on the “Confirmation Reservation” button.
Another dialog will appear confirming that the reservation is successfully created. Also, the color of your
reservation on the calendar will change to grey.
Once the reservation is made, the system will automatically notify the user via email confirming the
reservation.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 15
To review, change or cancel an existing reservation, go to the “Existing Reservation” tab.
To cancel the reservation, click on the reservation you wish to cancel.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 16
A dialog will appear asking the user to confirm the cancellation.
Once the user clicks “Cancel Reservation” button on the dialog, the selected reservation will be cancelled
and the color of reservation will change to red and will now state, “User Cancellation”. The system will
automatically notify the user via email confirming the cancellation.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 17
1.4 Using the Rig Page
If it is the first time Remote Laboratories is running on a system, the current web browser may display the
following popup, asking the user to confirm the use of a Java applet. This is required for the rig control
software, so the user should click on the “Run” button.
If the rig is free, the user will immediately be taken to the Rig Session page where the user can access the
Shake Table rig control software. Each user has a designated session time frame to conduct their
experiments. A countdown timer at the top left of the page shows how much time the user has left on the rig.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 18
A live video feed is available to view the state of the rig in real-time with a slight, network related time delay.
For this particular rig type, typical PC users are able to view the rigs using “Flash” Video Format (located
under ‘Session Time’). Users can change the video format via a drop down list located on the left of the
screen.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 19
The video panel is moveable by clicking and dragging the title bar to position it anywhere on the current
browser screen as shown in the following 2 figures.
Rig session starts as the user clicks on the green “Launch” button at the bottom left of the screen. A
confirmation request from the current browser may prompt. This will open up a new window in which the
LabVIEW control application will be automatically launched from its remote location. Note that it may take a
couple of seconds for the user’s remote connection to be established.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 20
1.5 Experiment Data File Transfer
After a run is completed, the data displayed on the graph can be saved by clicking on the “Save” button in
the bottom right hand corner of the LabVIEW control program. The data file is then automatically copied to a
server, which can be accessed via the Rig Session page under ‘Session Files’ as circled in orange color.
Any additional files after subsequent runs are stored here consecutively. To save a copy to the current local
drive, the user can simply click on the file – a popup will then appear asking for the details of where the user
wishes to save collected data files.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 21
For user convenience, all files are named with the following convention:
___.txt
Once the user has finished using the rig and saved all the data needed, the user can exit the control software
by clicking on the red “Terminate” button under Rig Control on the webpage. The button will change to yellow
as the rig initiates its shutdown procedure, and the control software will automatically close.
1.6 Exiting a Rig
When the user has finished using the rig completely and redirected to the Rig Session page, the “Finish
Session” buttoncan be pressed to exit the Rig Session page (the white cross in the red box at the top right
hand corner of the page).A popup will appear asking for confirmation of exit.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 22
Selecting “Yes” will close the user’s current remote connection to the rig and redirect the user to the Rig
Selection page.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 23
To exit the RemoteLabs itself, the user can click on the “Logout” button at the top right of the screen.
Once again, a popup will appear asking for confirmation.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 24
Once successfully logged out, the user will be directed back to the main login page.
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 25
2 FAQ & Troubleshooting
Any questions regarding the nature of assessment tasks should initially be directed to the relevant academic.
If theuser encounters any difficulties using the Remote Laboratories, the “Contact Support” button should be
used to report a problem and request assistance. The following popup will appear to enter name and a valid
email address. Then the most appropriate category should be selected from the drop down list, and the
purpose of the help request should be briefly stated. A more detailed description of the problem, comment or
request can be given in the feedback box.
Users are strongly encouraged to leave feedback and comments of their experience with the rigs to help
improve the system, as well as any suggestions for additional features to be included in the future.
For any enquires or assistance, contact the Labshare helpdesk at:
helpdesk@labshare.edu.au
Generic Rig Access Guide
Version 1.6
The Labshare Institute © 2012 Page 26
3 About Remote Labs
3.1 Remote Laboratories
Traditional engineering laboratories require students to be physically present in order to interact with
equipment, limiting both student flexibility and the sharing of facilities between institutions. Conversely,
remote laboratories allow students to use the internet to remotely access physical laboratory equipment. The
interaction is supported by using sensors and cameras so that the student can monitor the laboratory
equipment and actuators so that the equipment can be directly controlled by them. Students carry out
experiments using real equipment, but with much greater flexibility, since access can occur from anywhere
and at any time, and experiments can also be repeated for better learning outcomes.
Of course students can’t actually touch and feel the equipment in a remote lab, but they can still do
everything else. Sometimes, being separated from the equipment is a good idea from a safety viewpoint, or
to teach students about how remotely controlled equipment works. Remotely operating machinery and entire
industrial plants is already a widespread reality these days. Another benefit of a remote lab is that it can give
access to a wider range of experiments which may not be available locally due to expensive or highly
specialized equipment.
There has been significant research undertaken by many groups around the world into the educational
effectiveness of using remote laboratories. This research has consistently shown that remote laboratories
can, if used appropriately in a way that is cognizant of the intended educational outcomes of the laboratory
experience, provide significant benefits. Indeed multiple research studies have shown that whilst there are
some learning outcomes that are achieved more effectively through hands-on experimentation (e.g.
identification of assumptions, specific haptic skills), there are other leaning outcomes that are achieved more
effectively through remotely accessed laboratories (e.g. processing of data, understanding of concepts).
3.2 The Rig Apparatus
Each rig has been constructed in-house to study a variety of physical phenomena, enabling students to
conduct experiments using real equipment in real time. Also, they allow students to analyze the results using
real (as opposed to simulated) data that possess the same variations and imperfections as though they
occur in data collected in a hands-on laboratory. This approach encourages students to develop their
analytical skills and further their understanding when assessing the data and comparing it against a
theoretical result or model.
An interactive, “play and learn” approach is essential to some of these rigs and students are encouraged to
experiment to observe different behaviors and results.
Each rig typically comprises the following basic units:
Hardware unique to the rig
Data acquisition and control unit
Web camera for visual feedback
Rig Control software