Lab Tutor
Lab Tutor
This document was, as far as possible, accurate at the time of release. However, changes may have been made to the
software and hardware it describes since then. ADInstruments Pty Ltd reserves the right to alter specifications as
required. Late-breaking information may be supplied separately.
Trademarks of ADInsruments
PowerLab, LabChart, LabTutor, LabAuthor and MacLab are registered trademarks of ADInstruments Pty Ltd. The
names of specific recording units, such as PowerLab 26T, are trademarks of ADInstruments Pty Ltd. Chart, Scope and
LabTutor Server (application programs) and LabTutor Online are trademarks of ADInstruments Pty Ltd.
Other Trademarks
Apple, Mac and Macintosh are registered trademarks of Apple Computer, Inc.
Windows, Windows 7 and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation.
All other trademarks are the property of their respective owners.
All rights reserved. No part of this document may be reproduced by any means without the prior written permission
of ADInstruments Pty Ltd.
Web: adinstruments.com
Technical Support: [email protected]
Documentation: [email protected]
Contents
1 Introduction
Using .This
. . . .Document
..............................................................5
What is
. . LabTutor
. . . . . . . . . Suite?
........................................................5
Upgrading
. . . . .from
. . . . .LabTutor
. . . . . . . . .3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2 System Configuration
10
Hardware
. . . . . and
. . . . Software
. . . . . . . . .Requirements
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
LabTutor
. . . . . . . . Server
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
LabTutor
. . . . . . . . Client
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
LabAuthor
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Virtual
. . . . . .Machines
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Network
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Wireless
. . . . . . . Networks
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Internet
. . . . . . .Access
. . . . . . and
. . . .Proxy
. . . . . .Servers
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Checking
. . . . . . . .Network
. . . . . . . . Connection
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Required
. . . . . . . .Ports
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Firewalls
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Antivirus
. . . . . . . .Products
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Multiple
. . . . . . . Sites
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Backups
. . . .and
. . . .Disaster
. . . . . . . Recovery
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Snapshots
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Backups
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Using
. . . . .Snapshots
. . . . . . . . . and
. . . . Backups
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Disaster
. . . . . . .Recovery
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3 Course Administration
28
Completing
. . . . . . .Experiments
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Reviewing
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Experiment
. . . . . . .Data
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Archiving
. . . . . . . . Student
. . . . . . . Data
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Exporting
. . . . . . . . Student
. . . . . . . .Answers
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
39
LabTutor
. . . . .Server
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Software
. . . . . . . Updates
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Uploaded
. . . . . . . . Experiments
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Server
. . . . . Recovery
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Restarting
. . . . . . . . .LabTutor
. . . . . . . . .Server
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Remote
. . . . . . .Access
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Security
. . . . . . .Certificate
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
LabTutor
. . . . .Client
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
LabTutor
. . . . .Online
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Changing
. . . . . . . . Server
. . . . . . Hardware
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Activating
. . . . . . . . LabTutor
. . . . . . . . . Online
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Diagnosing
. . . . . . . . . .Connectivity
. . . . . . . . . . . Issues
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Licensing
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
5 LabAuthor
48
Experiment
. . . . . . .Flow
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Example
. . . . Data
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Audio. .and
. . . .Video
. . . . . .vs. .Other
. . . . . .Media
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Instructor's
. . . . . . Material
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Optimizing
. . . . . . Experiments
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Experiment
. . . . . . .Properties
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Learning
. . . . Modules
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
6 Troubleshooting
60
FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Introduction
This document describes the recommended supported work-flows for the LabTutor
Teaching Suite and addresses frequent issues and questions, including:
System and infrastructure requirements and recommendations
Networking setup and connection troubleshooting
Data backup and disaster recovery
Course administration
Common student issues
LabTutor Online setup and configuration
Frequently asked questions (FAQ)
Introduction
information from any computer within your local network. All student
experiment data is stored on LabTutor Server for easy access.
2. LabTutor Online - An internet-based service that provides the ability for
students to view their experimental data and to complete and submit
experiment reports. This is can be done from any device that has an internet
connection and a web browser that supports Flash or HTML5. LabTutor
Online also allows administrators to review students experiments over the
Internet.
3. LabTutor Client - Displays the LabTutor Experiments from the LabTutor
Server. LabTutor Client silently handles communication with LabTutor
Server and the PowerLab, and should be installed on each computer in the
student laboratory. LabTutor experiments contain all instructions needed by
students, as well as interactive components that sample and display real data
from a PowerLab.
4. LabAuthor - A tool for customizing or creating LabTutor experiments for
your courses. LabAuthor can be used on a stand-alone computer that need
not be connected to LabTutor Server or the network. Once you are finished
creating or editing an experiment it can be exported from LabAuthor as an
experiment installer, and installed to LabTutor Server.
The focus of the LabTutor Teaching Suite is split into two areas:
Classroom - Experiments are performed through a web browser on a
computer running the LabTutor Client software. Experimental data is saved
to LabTutor Server via the local network.
Outside Institution Network - Experiments from the LabTutor Server are
transferred via the Internet to LabTutor Online. With LabTutor Online
students can log on from anywhere with an internet connection to view
experiments, analyze data, view media content and complete reports.
Chapter 1
Introduction
How to upgrade
Before upgrading to LabTutor 4, all LabTutor version 3 experiments should be
backed-up onto an external drive or media, and all associated LabTutor 3 software
uninstalled. LabTutor 3 and 4 cannot operate concurrently.
Custom Experiments created in earlier versions of LabAuthor may still be used with
your upgraded LabTutor Server, however a few important things to take into
consideration:
For your experiment installer to be able to be installed and give rise to a
functional experiment on LabTutor Server, it must be saved in the same
version of LabAuthor as LabTutor Server. i.e. It is best practice to upgrade
LabAuthor at the same time as upgrading LabTutor Server, with the same
version.
To re-save an experiment installer created in an earlier version of LabAuthor:
1. Double-click on the out-dated experiment installer and install the
contained experiment files locally.
2. Open the experiment (.adiexp) file with the upgraded version of
LabAuthor
3. Re-save the experiment File > Save Experiment As...
4. Re-save the experiment installer File > Save Experiment Installer...
5. The experiment installer may now be uploaded and installed to LabTutor
Server
Chapter 1
Introduction
System
Configuration
While LabTutor Server can be installed on just about any modern computer, it is
important to make sure that the computer you select to install LabTutor Server is
sufficiently equipped to run your LabTutor Teaching Lab. It is recommended that you
run the LabTutor Installation Advisor (adinstruments.com/LabTutor-Server-Advisor)
on the prospective LabTutor Server computer before you install and configure the
software. In general your LabTutor Server computer needs to meet the system
requirements. In addition, you should consider installing an uninterruptible power
supply (UPS) on the server to protect data from power outages, implementing a reliable
backup scheme and physically locating the server in a secure location. The LabTutor
Server should be kept running at all times, where possible.
The best practice for LabTutor Server is to install it on a dedicated server. There are a
number of reasons why this is the recommended option:
Having a dedicated server avoids software conflicts with other web server
applications.
Performance of the LabTutor Server will be better as it does not have to
share resources with other services, providing the best overall user
experience.
It is easier to backup and recover in the event of a disaster.
LabTutor Server needs to be installed on a computer that allows for a web-based
application to operate. LabTutor Server cannot be installed on a computer that is
currently providing services on port 80 and/or 443 (e.g. it has Internet Information
Services (IIS) or Apache installed). It is also recommend that the LabTutor Server
computer be assigned a static IP address, and not a dynamic one, and should ideally
have a Domain Name System (DNS) for it (e.g. labtutor.university.com).
It is important to note that when using LabTutor Online, large amounts of outgoing
data will be sent from LabTutor Server to LabTutor Online. Because of this, it is
recommended that your LabTutor Server has an Internet connection with a good
upload speed to avoid delays in transferring student data from LabTutor Server to
LabTutor Online.
10
To provide your users with the best LabTutor experience it is important to make sure
that LabTutor and LabTutor Client machines are adequately equipped to run your
teaching course. Failing to have adequate hardware for either the client or server
machines could result in a poor user experience, so getting it right from the start is
critical.
LabTutor Server is at the heart of the LabTutor Suite and it is therefore pertinent that
the right choices be made regarding the server's hardware, configuration and location.
While LabTutor Server can be installed on just about any modern computer, it is
important to make sure that the computer you select to install LabTutor Server is
adequately equipped to run your LabTutor Teaching Lab. The system requirements
for LabTutor Server can vary greatly depending on the number of PowerLabs being
used and the number of students that will be using LabTutor per semester.
ADInstruments provides a small utility called the LabTutor Server Installation Advisor,
which can be run on a prospective server computer to determine if it meets the
recommended system requirements for running LabTutor Server in a particular
environment. The LabTutor Server Installation Advisor can be downloaded from
adinstruments.com/LabTutor-Server-Advisor.
Chapter 2
System Configuration
11
The results of the analyses are then displayed, with any issues highlighted by either a
red cross for a fail, or a yellow exclamation mark for a warning. Any fail messages
should be addressed before installing LabTutor Server.
12
LabTutor Server
The general software requirements for LabTutor Server are as follows:
Microsoft Windows 7 or Windows Server 2008/2008 R2 recommended,
Windows Vista SP1, or Windows Server 2003/2003 R2 supported
Adobe Reader 8.0 or later is required to view all language experiment report
PDFs. Adobe Reader X or later is required to annotate experiment report
PDFs. The latest version of Adobe Reader is recommended.
Chapter 2
System Configuration
13
The actual hardware requirements for LabTutor Server will be somewhat dependent
on your needs. ADInstruments always recommends running LabTutor Server
Installation Advisor on the server prior to installing LabTutor Server. If you are looking
at buying a new computer to run LabTutor Server on please see the example system
recommendations below for an idea of what specifications your server should have.
When buying or building a computer for LabTutor Server you should consider the
following:
A full size computer case with good airflow and a full size ATX motherboard
A quad core CPU over a dual core CPU if possible
8GB (or more) of RAM. RAM is relatively cheap and will help with
performance of the system
Two good-sized hard disks in RAID-1. This will provide some protection from
drive failures
A good quality power supply (PSU)
Install a 64-bit Operating System
Have the server on an uninterruptible power supply (UPS)
The following is a list of general considerations for LabTutor Server:
Where possible have a dedicated LabTutor Server machine. By having a
dedicated server you will avoid conflicts with other software, and you will get
the best overall performance from the system.
Locate the server machine in a physically secure location; restrict access.
Have a reliable backup scheme in place so that your LabTutor Server data is
regularly backed up in case of a disaster.
Leave the LabTutor Server computer running around-the-clock, especially if
you are using LabTutor Online.
If you are using LabTutor Online ensure that your Internet connection has a
sufficient upload speed. LabTutor Server can transfer large amount of data to
LabTutor Online, and having a good upload speed will help avoid delays in
transferring this data.
The following are some examples of recommend hardware configurations:
1 - 10 PowerLabs with 100-500 students per semester:
Quad Core CPU recommended, Dual Core minimum
2GB RAM recommended, 1GB minimum
14
LabTutor Client
The following are the general hardware and software requirements for LabTutor
Client:
Microsoft Windows 7 or later, or Windows Vista SP1 or later supported
Microsoft .NET v2.0 Service Pack 2 or v3.5 Service Pack 1 required
Internet Explorer 9 recommended, IE 7 minimum
Dual Core CPU recommended
2 GB RAM recommended, 1GB minimum
1Gbps network connection to LabTutor Server recommended, 100Mbps
minimum
10 GB free hard drive space
Flash Player plug-in for Internet Explorer 9.0.115 or later is required to play
video and audio
LabAuthor
The following are the general hardware and software requirements for LabAuthor:
Microsoft Windows 7 or later, or Windows Vista SP1 or later supported
Chapter 2
System Configuration
15
Virtual Machines
LabTutor Server and Virtual Machines
LabTutor Server can work very well in enterprise-class virtual environments and there
are no known compatibility issues with running LabTutor Server in a virtual machine.
However, ADInstruments recommends using native installs where possible to
maximize performance.
Due to the rich and engaging content provided, LabTutor Server can be resource
demanding - it may stream high-quality videos to many clients and has to do CPUintensive file conversions when uploading student data to LabTutor Online. With a
whole lab of students recording or viewing data, disk space access and network access
must be reliable.
If you wish to install LabTutor Server on a virtual machine it is advised not to use
'desktop' virtualization software such as VMware Fusion or Workstation, Sun's Virtual
Box, or Parallel's Desktop. Server-orientated virtualization platforms such as VMware's
ESXi, Citrix's XenServer or Microsofts Hyper-V are more suitable. Ideally the
LabTutor Server virtual machine should be given its own large dedicated physical disk
or RAID array, have high-priority access to CPU resources, enough dedicated RAM (as
recommended by the LabTutor Installation Advisor) and a dedicated network to the
storage host (important if virtual machine data is stored on a storage area network,
SAN).
LabTutor Server can be installed on an Intel-based Macintosh computer running Boot
Camp provided it meets the minimum system requirements.
LabTutor Client and Virtual Machines
16
LabTutor Client and LabAuthor require Microsoft Windows and Internet Explorer to
operate. If your teaching labs are equipped with Intel-based Macintosh computers, you
can use the LabTutor Teaching Suite by using Internet Explorer on Microsoft Windows
in Boot Camp.
Virtual machine software such as Parallel's Desktop for Mac or VMware Fusion may
be used, however for best performance and reliability, ADInstruments recommend
and support LabTutor use with Boot Camp only. Virtual machines should only be
used if you require access to Macintosh applications and need the ability to switch
between Mac and Windows operating systems during the class. While using LabTutor
Client in a virtual machine should work, it is important to note that it is not currently a
supported configuration.
LabTutor Client and thin-client Workstations
LabTutor Client may work on thin-client setups, however this depends very much on
your particular setup and there is no easy one-size-fits-all answer as to how it will
perform. Thin-clients are great for running applications like Microsoft Word, checking
email, browsing the Internet etc, but are not ideal for things that involve heavy disk
usage (due to contention - all the clients will likely be accessing the same storage array),
or heavy network usage.
For example, if the students watch a video in a LabTutor Experiment then that video
probably has to be streamed from LabTutor Server to each of the virtual desktops
running under the virtual host, and from there, to each of the client machines.
Depending on the setup, this could be a problematic bottleneck, although some thinclient solutions have been getting much better at handling this. Another potential
confounder is the high-rate sampling used in some experiments.
In these sorts of situations ADInstruments recommends that you do a small trial of
running LabTutor in this setup, which should give some indication of what your system
can cope with, and what it can't. For example, having a few of the classroom machines
access the videos in one of the experiments would likely give a very good indication of
how things will run.
It's recommended that you get in contact with your ADInstruments representative
with some information about your setup so further advice can be given.
Chapter 2
System Configuration
17
Network
Key Information
Use 1Gbps network where possible
Avoid wireless networks
LabTutor Server needs direct Internet access - no proxy servers
LabTutor Server requires use of ports 80, 443 & 8005 on the server
Run Net Checker utility to help diagnose connection issues
LabTutor 4 has been designed to work in a networked environment where there is a
central server that has LabTutor Server installed, clients in a laboratory that have
LabTutor Client installed and content able to be accessed outside of the campus
though LabTutor Online.
The LabTutor 4 Suite requires that all computers (clients and server) be connected
together via a Local Area Network (LAN). Before installing LabTutor Server and
LabTutor Client you should verify that clients can connect to the server computer over
the network. Depending on how your network is managed, you may be required to
consult with your IT department before deploying the LabTutor 4 Suite.
The LabTutor Server Installation Advisor utility assists in making sure that the server's
network connection is suitable. ADInstruments recommends the use of a 1Gbps wired
network for LabTutor Suite as this will provide users with the best overall experience
and performance. For optimal performance, clients should have the same network
connectivity speed as the server. i.e. if LabTutor Installation Advisor recommends a
1Gbps network speed for the server, then if possible, the clients should all have a
1Gbps connection back to the server.
Having an inadequate network setup could result in a poor user experience, so
attaining recommended specifications is critical for reliably running a successful
LabTutor 4 course.
LabTutor Client machines do not require access to the Internet, however LabTutor
Server requires a direct connection to the Internet to obtain software updates and
experiments installers, as well as to connect to LabTutor Online.
Wireless Networks
For performance and reliability reasons ADInstruments does not recommend or
support the use of wireless networks with LabTutor Suite. There are a number of
18
Net Checker
Net Checker is a small utility that can be run on a LabTutor Server, providing clear
feedback regarding your current network configuration. It checks that LabTutor Server
is able to communicate with LabTutor Online and the ADInstruments web page. If Net
Chapter 2
System Configuration
19
Checker returns a failed result, you will likely have to consult with your IT department
and rectify your network settings.
Net Checker is installed with LabTutor Server and is available from the ADInstruments
program group in the Start menu. It is also available to download from
ADInstruments.com.
Required Ports
LabTutor Server requires exclusive use of ports 80, 443 and 8005 on the server where it
is installed. Ports 80 and 443 are used by clients and administrators to connect to the
LabTutor Server and access experiments and administration pages. Port 8005 is used
internally by the Apache Tomcat process to communicate with itself. The ports used by
LabTutor Server cannot be changed or configured. If you have other software causing
a port conflict, that software must be altered or removed for LabTutor Server to
20
function correctly.
The LabTutor Server installer program will warn you if it detects that there is another
application utilizing port 80, 443 or 8005 before installing the software. This is however
just a warning and LabTutor Server can still be installed. However, LabTutor Server
will not function until the required ports become available. Typically if this is a
departmental server the most likely reason port 80 and 443 are in use is because this
computer has a web server installed on it, such as IIS or Apache. In this case you either
need to uninstall the conflicting product from the server, or install LabTutor Server on
a different machine. The LabTutor Installation Advisor can also be used on existing
servers to detect this.
Firewalls
When LabTutor Server is installed, the installer automatically adds the required rules
to the Windows Firewall to allow LabTutor Server to communicate with clients on
ports 80 and 443. If clients are having issues connecting to the server check that firewall
exceptions are still in place in the Windows Firewall control panel item. If the
LabTutor Server exception is missing, and there are no other exceptions to allow ports
80 and 443 through the firewall, then you will need to manually add this exception to
the firewall. If your server is running a firewall other than the Windows Firewall you
may need to manually add exceptions for LabTutor Server on ports 80 and 443.
Remember that LabTutor Server needs a direct connection to the Internet to
communicate with LabTutor Online and ADInstruments.com. Net Checker can be run
on the LabTutor Server machine to ensure that a direct connection to the Internet is
available (see the 'Net Checker' section for more information).
Antivirus Products
Many antivirus products can interfere with the normal operation and performance of
LabTutor Server and LabTutor Client. This is because many antivirus products
perform realtime scanning of web page content. Because LabTutor content is all served
over HTTP this realtime scanning can add significant overhead to page load times, and
in some cases, prevent LabTutor from functioning. If you experience performance
issues with LabTutor it is recommended that you disable any realtime antivirus
software scanning for HTTP, and that any antivirus Internet Explorer add-ons are
disabled.
Incompatible Software
If you have Skype installed on the same machine as LabTutor Server, this can result in
ports 80 and 443 being used by Skype, and therefore not being available for LabTutor
Chapter 2
System Configuration
21
Server. You can get around this by disabling Skype from using ports 80 and 443 for
incoming connections. Go into Skype and click Tools > Options > Advanced >
Connection and uncheck the box that says Use port 80 and 443 as alternatives for
incoming connections. VMware Server also has the same issues, and should not be
installed on the same machine as LabTutor Server.
Multiple Sites
If you have multiple locations which need to access LabTutor Server, the ideal solution
is to have a LabTutor Server hosted at each location, however, there may be situations
where this is not practical or possible. If you must have one centrally-hosted LabTutor
Server then you need to ensure that the networks connecting the remote locations to
this central location are adequate - have a fast and reliable connection. Ideally this
connection should be 1Gbps, however this may not be attainable.
If you require your LabTutor Server to be accessed from multiple locations, you will
need to get specific details of the network connection (such as link speed, latency,
contention levels and if there are link backups in case of primary link failure) from your
IT department and contact your ADInstruments representative for further advice.
a full copy of the LabTutor Server data directory. The combination of both backups
and snapshots will provide you with an easy way to restore server or move LabTutor
Server data.
Snapshots ensure that all necessary parts of the database are correctly stored for a
backup to occur, but are not a full backup themselves. Both snapshots and backups are
required for restoring a database and should therefore be performed daily.
Snapshots
Backups
Settings\All Users\Application
Chapter 2
System Configuration
23
Restoring a Backup
24
If you need to restore the LabTutor Server data to an older version, you must firstly
stop the LabTutor Server service using the Service Controller in the ADInstruments
folder in the Start Menu. Then replace the LabTutor Server folder with the backup
copy before restarting the service.
It is important to ensure that the version of LabTutor Server that is currently installed
matches the version that was installed when the backup was taken. The LabTutor
Server service may take up to five minutes to start due to the restoration process.
For the location of the LabTutor Server data folder see the 'Backups' section.
Disaster Recovery
In the unfortunate event that a computer running LabTutor Server fails in some way
and is not immediately recoverable, it is a priority to ensure that students can continue
to use LabTutor with minimal disruption.
Ensure that you have a written plan for a disaster recovery scenario that has been
discussed with other staff and stakeholders. An A3 PDF template is installed with
LabTutor Server and available from the Start menu: ADInstruments > LabTutor
Server > Backup and Recovery. Digital and printed versions of this should be filled out
with information specific to your LabTutor set-up, and kept in an easily accessible
location.
In the event of a disaster (e.g. a complete failure of the LabTutor Server computer) the
best option is to have a standby computer that is ready to take on the workload of the
failed LabTutor Server computer.
System Configuration
25
LabTutor Server
Ideally this would be a physical computer, however as a short-term solution,
a Virtual Machine may be used.
The hardware and software specifications should be as close to the primary
LabTutor Server as possible. However, it is understandable that this machine
may be of a lower specification, so use the LabTutor Server Installation
Advisor to check how it matches the recommended requirements for a
LabTutor Server computer.
If the computer is of lower specification, you should evaluate the effect this
will have on your laboratory and make any necessary preparations. This
might mean having a plan for laboratory sessions taking longer or having
extra staff being able to help in the laboratory (this will obviously depend on
your environment and setup). Remember that this is a temporary solution,
so a lower specification machine may be acceptable for the short-term, and
most modern entry-level computers will function sufficiently as a LabTutor
Server for a definitive period until your primary LabTutor Server has been
restored.
Do not install this spare computer with LabTutor Server. Doing so may cause
conflicts, especially if both servers are configured to connect to LabTutor
Online. Instead, have the installer handy and make sure it is the same as the
installed version on the primary LabTutor Server.
Ideally this spare computer will not be in active use, but if this isnt possible,
ensure that it can be easily acquired i.e. you won't have to wait for another
user to finish work, or have to copy data off before you can use it.
This spare computer should, if possible, be installed with a clean Operating
System that is the same version as your primary LabTutor Server. As with
your primary server, it should not be installed with any software that could
conflict with LabTutor Server or the ports that are required for LabTutor
access.
Pre-configure any network/domain access, and anything else that will make it
quicker to get this computer functioning as a LabTutor Server with short
notice.
The computer name for your substitute computer must be unique on the
network, i.e. not the same as your primary LabTutor Server.
It is advisable to have a full disk image of your primary LabTutor Server,
both as a clean computer with only the OS installed, and with LabTutor
Server in a working state. In the event of a disk failure to your primary server,
26
this image will help you get the primary machine running sooner. There are
many third party software packages that can do this, such as Acronis or
BootIT NG.
Ensure that you have a written plan for a disaster recovery scenario that has been
discussed with other staff and stakeholders. This should be in an easily accessible
location in both digital and printed form.
In the event of a disaster (e.g. a complete failure of the LabTutor Server computer) the
best option is to have a standby computer that is ready to take on the workload of the
failed LabTutor Server computer.
Chapter 2
System Configuration
27
Course
Administration
Start of Semester
At the start of a course there are several things that you should do:
1. Install experiments
Install all of the experiments needed for the semester.
2. Create a course
Give the course a name that students will be able to recognize (e.g. BIOL101).
3. Add experiments
Add experiments to the course.
28
1. Add experiments
Experiments you add to a course are immediately available to students, but
you don't have to add all of the experiments to the course at the very start of
the semester. If you don't want students to access experiments too far in
advance, you can add experiments to the course throughout the semester.
Chapter 3
Course Administration
29
End of Semester
At the end of a course there are several things that you should do to tidy up LabTutor
Server and prepare for the next course.
3. Deactivate students
Deactivated students cannot start, preview, edit or submit any experiments,
but they can still view experiments they have started. Deactivated students
are not allocated with new LabTutor Online licenses. You can also delete
students to completely revoke their access to LabTutor.
If you do not deactivate students at the end of the semester and you are in
Bulk licensing mode, they will be automatically issued a new LabTutor Online
license when they next log in to LabTutor, once the current license expires.
30
Students
LabTutor Server includes tools to help you manage your student list. The import
function allows entire student lists to be imported and set up with a login credentials.
Deleting students
Students must be deactivated before they can be deleted. This makes it harder to
accidentally remove a student and lose their data.
Chapter 3
Course Administration
31
Passwords
If you don't give students passwords they are prompted to create one the first time
they log into LabTutor. If they forget or lose their password, these can be reset in the
administration pages.
Group Login
Students can form a group to work on an experiment by logging in together on the
same computer.
available to the new group. When the students log back into the original group, the
data will be available again. Logging in individually will allow the student access to all of
the experiments they have been working on.
Session Expiry
Students will be logged out after 30 minutes or more of inactivity. This will occur when
they next try to navigate on the page, or sample data from the PowerLab. All student
data will be retained.
The same user is only allowed to be logged into one machine at a time. If you are
logged into a machine as 'USER1' and then log into a different machine with the same
user, the first session will expire. This happens within 30 seconds of the user logging in
somewhere else, but usually you will see it within 5 seconds. If the first session is
inactive (i.e. page idle) it may display for longer, but any attempt to sample data or
answer questions will force LabTutor to check the session is permitted.
Completing Experiments
What can students do with completed experiments?
Depending on course options set in the administration pages, reports are able to be
printed, submitted or emailed.
Printed reports
The report page can be printed if the print option has been activated by the
administrator in the course list. This does not submit the report, but brings up the
print dialog and prints a correctly-formatted report. Using the browser's print function
will print the report page, however page breaks and formatting may be incorrect.
Submitted reports
Clicking the Submit button will tag the experiment as completed and the student will
no longer be able to make changes, but will still able to view the experiment. When
students submit their experiment, administrators can configure themselves to be
emailed a PDF of the report page. The administration pages can also be used to allow a
student to resubmit an experiment.
Emailed reports
There are two separate ways that reports can be emailed. If the Email button is
Chapter 3
Course Administration
33
available, students can email a PDF or .docx file of the report page to themselves or to
any other valid email address. This does not submit the report. If the option to email a
submission report has been selected, then when the student submits, the report page
will automatically be sent to the configured email address.
Reviewing
LabTutor provides a review feature to allow Instructors and Administrators to view
student reports and experiments. Experiments can be reviewed multiple times
regardless of whether they have been submitted or remain in progress. The way in
which experiments are accessed for reviewing depends on which LabTutor licensing
mode is being used.
Instructors and Administrators are able to view students' experiments at any time
using the Student Data Review feature. Reviewing allows you to:
View a student's experiment in its entirety.
Access information about when the experiment was started and when it was
last accessed, the time spent doing the experiment and whether the
experiment has been submitted, locked or is in progress.
Experiments are sorted by date started, with those accessed first at the top of the list.
Reviewing a student experiment does not change its status or store a record of that
experiment as having being reviewed. No changes, annotations or comments can be
made when reviewing experiments
34
Marking
The marking and assessment of experiments is not an inherent feature of LabTutor
and no changes, annotations or comments can be made when reviewing experiments.
Adobe Reader X now allow you to add comments to PDFs, which would allow you to
annotate the student report pages that LabTutor emails to you. For this, the latest
version of Adobe Reader is recommended.
Experiment Data
What is Student Data?
Student data is any recorded data, answers to questions, or information entered into
tables that is generated or added by a student. The data for each experiment is
associated with the student who generated it and is stored within the LabTutor Server
file system.
If the student was logged in as part of a group when the data was generated, each
student in the group has the data associated with their login details. This ensures that if
the members of the group want to submit individual reports or split into smaller
groups, that their original data is not lost.
Student data is managed through the LabTutor Server database. The LabTutor Server
database maintains the integrity of the associations between each student and their
experimental data. The database tags the student data as being in one of four states: In
Progress, Past Due, On LabTutor Online, or Submitted. Once students have started an
experiment, the state of that experiment session becomes In Progress. Students can
access an experiment by previewing it, but it will not be In Progress and no student
data will be stored.
Chapter 3
Course Administration
35
Experiment Cache
Versions of LabTutor prior to LabTutor 4 Suite used an experiment files cache which
had to be cleared before each student session, when all students used the same login.
Because LabTutor 4 Suite saves all student data directly to the LabTutor Server
database, there is no experiment files cache and it is not necessary to clear files
between student sessions. Each student will see their experiments in the same state
they left them the last time they logged out. The only exception to this is if a student is
a member of a group and the branches of the group experiment data have been
collapsed by an administrator or instructor.
Chapter 3
Course Administration
37
38
Maintenance &
Technical Info
LabTutor Server
Software Updates
Uploaded Experiments
You can access experiment installers that have been uploaded to LabTutor Server
through the administration pages.
Chapter 4
39
LabTutor Server stores its data in a folder in the ADInstruments area of the (hidden)
Program Data or Application Data folder. Under no circumstances should you
interfere with the these files directly, as this may cause LabTutor Server to stop
working.
Server Recovery
Data is saved back to the server at regular intervals upon user interactions and major
commits. Sampled data is regularly sent back to LabTutor Server so that in the event of
a system failure most data will be retained
PowerLab may crash and will need to be reset (switched on and off).
Remote Access
LabTutor Server requires outgoing access to the Internet to contact and synchronize
with LabTutor Online, and to download experiments and updates. However, under no
circumstances should it allow incoming connections over the Internet. Allowing
computers to connect to LabTutor Server over the Internet is a security risk and not a
recommended or supported configuration. LabTutor Server has been designed and
optimized to run over a Local Area Network (LAN), and not over the Internet. If
students log directly into LabTutor Server from the Internet, this will result in
extremely compromised performance and functionality. These students would also
need to have LabTutor Client installed on their computer, which is not compatible with
Macintosh or Linux operating systems. If students require remote access to their data,
LabTutor Online is the only supported solution. LabTutor Online removes all of the
complications of performance, security and operating system dependence for accessing
student data over the Internet.
Security Certificate
The default security certificate that is generated for LabTutor is a self-signed SSL
certificate. This means that you have to install the root certificate for the LabTutor
Server on all computers that access the administration pages, if you wish to remove the
security warnings from browsers. It is possible to supply your own SSL certificate for
use with LabTutor Server that is generated by a trusted Certificate Authority (CA) such
as VeriSign or Go Daddy, or one generated by your own Certificate Authority, such as
Active Directory Certificate Services (AD CS).
LabTutor Server requires the SSL certificate to be in Tomcat format (pkcs12). Many
CAs will allow you to download the certificate in Tomcat format directly. Alternatively
Chapter 4
41
OpenSSL can be used to convert most certificate formats into the pkcs12 format. The
certificate must be generated with the standard Tomcat password of "changeit".
Once you have the certificate in pkcs12 format you can install it by backing up the
existing "server.p12" file, replacing it with the new certificate, and restarting LabTutor
Server. You can inspect the certificate in your browser to verify it matches the
certificate you expected. The "server.p12" can be found in the following locations:
Windows
Vista,
Windows
7
and
Server
\ProgramData\ADInstruments\LabTutor Server\ssl
2008:
C:
LabTutor Client
LabTutor Client is installed on each computer in the student laboratory. LabTutor
Client works in the background and silently handles communication with LabTutor
Server and the PowerLab. Once LabTutor Client is installed, you access can LabTutor
through your Internet Explorer web browser.
The easiest way for students to access LabTutor is to provide a desktop shortcut or
browser bookmark to the student login page. The student login page can also be
manually entered into your web browser:
http://<LabTutor Server computer name> e.g. http://labtutor-server/
http://<LabTutor Server IP Address> e.g. http://192.168.1.58/
Updates
LabTutor Client must always be the same version as the LabTutor Server. There are
three recommended ways for updating LabTutor Client computers:
Method 1: Via the LabTutor Login Page
If the server detects that the client computer is running an old version of LabTutor
Client, you will be prompted to update to a newer version when you try to log in. The
update will be provided directly from the LabTutor Server, rather than over the
Internet.
Method 2: Using the LabTutor Suite DVD
You can install LabTutor Client from the supplied LabTutor Suite DVD.
Method 2: Administrative Deployment (recommended for many computers)
42
The LabTutor Client MSI installer supports administrator deployment from the
command line for silent, first-time or updated installs.
LabTutor Online
Once a student has edited their experiment in LabTutor Online, the student will no
longer be able to record data in the laboratory using LabTutor Client.
Students must complete data acquisition and analysis (tables, graphs etc.) before
editing their experiment via LabTutor Online.
Chapter 4
43
Licensing
There are two modes of operation for LabTutor Client, depending on the licensing
model that is purchased:
1. PowerLabs Required - A student can log in and start an experiment if the
computer on which LabTutor Client is installed has a PowerLab connected.
LabTutor Client must also be able to connect to LabTutor Server. Students
are able to edit experiments on computers that have LabTutor Client
installed and that can connect to LabTutor Server.
Administrators may empower students to create their own accounts on LabTutor. This
Chapter 4
45
Bulk licenses remain valid for 6 months from their time of activation. A bulk license
becomes activated when a student first logs in to LabTutor Server or Online, provided
sufficient licenses are available.
Bulk licenses must be activated within 12 months of purchase. Exceeding 12
months will deem the license invalid, and these licenses will be removed from
LabTutor Server.
If a student is allocated a license and has his/her account deleted within a week
of doing so, the license will become available for another student to use. If a
student account is deleted more than a week after being allocated a license,
their license will become obsolete.
Unless a snapshot is taken prior to deactivating LabTutor Online, active bulk
licenses will be lost. Any available licenses prior to deactivation will be retained.
46
Once all purchased bulk licenses have been activated, subsequent first-time
student logins may continue to be allocated licenses, with up to 10% of the
original number of licenses being purchased able to be attained in advance.
Any additional licenses used will be deducted from future purchases.
Students with invalid bulk licenses will prompt an error upon logging in to LabTutor
Client or Online, and be unable to preview or edit any experiments. This will also affect
group sessions regardless of whether all other members of the group are licensed. The
unlicensed user or users will have their login symbol grayed out in the Logged in
dialog, whereas licensed users will appear blue.
Chapter 4
47
LabAuthor
Best Practice
Have LabAuthor and LabTutor Server on separate computers.
Install Experiments in a local folder in your User directory and execute the
experiment.adiexp file to open the experiment in LabAuthor.
Install your own custom experiments in a separate location to the supplied
ADInstruments experiments to avoid confusion.
Experiment Flow
ADInstruments-authored LabTutor experiments conform to a high standard. Each
experiment is structured in a similar way and includes background information,
detailed experimental setup and exercises as well as easy-to-follow data acquisition,
analysis and reporting protocols.
48
Experiment Flow
ADInstruments experiments follow a linear flow so that students don't need to
navigate backwards and forwards throughout the lab.
General flow used by ADInstruments:
1. Introduction and background information
2. Equipment Setup
3. Experimental Exercise
4. Analysis of Results
5. Report
Example Data
Using LabAuthor you can record and embed example data into a LabTutor data panel
which demonstrates what the student should typically see when the experiment is
carried out. Recording example data is identical to recording data normally using the
LabTutor panel. It simply needs to be "marked" as example data.
The students performing the experiment will be able to access the example data by
right-clicking on the Start/Stop button and choosing Add Example Data
Chapter 5
LabAuthor
49
Provide a low resolution video for LabTutor Online (for fast internet
viewing), and a high resolution version for in the laboratory (where local
network bandwidth is less of an issue).
Poster Images
playing.
Play correctly on all major browsers and platforms (Including iPad and
iPhone).
Advantages of using mp3 audio files with Flow Player
Built-in cross-platform audio player
Play correctly on all major browsers and platforms (Including iPad and
iPhone).
Note: when previewing an experiment in LabAuthor with .h264 encoded videos,
50
users will not be able to watch the video content. When accessed through a LabTutor
Server these videos will play as expected.
Other Media
LabAuthor can also embed other types of media files such as wav, wma, aac, avi, mov
or wmv. For a full list, see the LabAuthor help.
These file formats rely on external software and will be displayed/played only
if the required software is installed and set up correctly (e.g., Adobe Reader,
Flash, QuickTime, Windows Media Player etc.). As such, performance can be
temperamental. The recommended practice is to use content that is fully
supported (.h264 encoded video, and mp3 audio files).
Instructor's Material
Documents can be added to the LabTutor experiment that can be accessed from the
LabTutor Server interface.
Location
If there is a folder named Instructors Material in the experiment directory when the .
ltexp installer is created, then any files in that folder will appear in the Instructors
Material section of the LabTutor Server administration pages. The instructors material
folder should not contain any sub folders.
Chapter 5
LabAuthor
51
The correct location of the Instructors Material folder for a LabTutor experiment.
Optimizing Experiments
It is important to keep the file size of experiments to a minimum to ensure that
experiments perform optimally, particularly when using LabTutor Online. Larger file
sizes will still work; however students may find themselves in a queue while waiting to
download an experiment. Depending on the volume of students and recorded data,
queuing time may vary from a few seconds to several hours. This is not an ideal
situation and should be avoided by following these best practices.
1. Sampling rate
To reduce file size, choose the lowest suitable sampling rate for the recorded data. For
example, a default sampling rate of 1000 samples per second (i.e. 1k/s) is suitable for
most human biological recordings (e.g. spirometry, ECG, EOG, finger pulse and blood
pressure). Other signals may require a higher sampling rate (e.g. EMG at 4k/s), or a
lower rate will do (e.g. pharmacology organ bath experiments at 200400 samples/s).
There are certain special cases for which high sampling rates are required for quality
data, such as when recording action potentials.
52
5. Combine Channels
If you are proficient using LabChart, you may feel confident enough to try to combine
two or more Channels using an arithmetic equation. You can have an arithmetic
equation running on the channel you are recording into. For example, to differentiate
Channel 1, select Arithmetic from the channel drop-down menu and enter: =
Differentiate( Ch1 ). This will return the derivative of channel 1 into Channel 1. Refer
to the Arithmetic section of the LabChart 7 Help for further information and
formulae.
Experiment Properties
When you use LabAuthor to create or edit an experiment it is important to provide
good experiment properties. In particular:
Experiment Title: This is the full name of the experiment as seen by the
student. In some circumstances you may wish to give an indication as to the
Chapter 5
LabAuthor
53
Learning Modules
Learning Modules allow related experiments to be grouped together, with different
components intended to be accessed in the classroom or laboratory (Client) and
outside of the classroom (LabTutor Online). Each component in a learning module is
only accessible once the previous component has been submitted. This creates a
seamless learning experience, whilst giving educators increased control over the
student's work-flow to benefit them maximally through active reinforcement and selfevaluation.
How to create a 'Learning Module' experiment:
1. Open an existing experiment, or create a new one, in LabAuthor
2. Navigate to Edit > Experiment Properties
54
3. Check the box labeled Learning module: and define a title for the learning
module. All experiments that you want to include in this learning module
must be given the same learning module title. N.B: If you have previously
authored a learning module, it will be available from the drop-down for this
field.
4. Define an Order: for this learning module component. In this example, the
tutorial is the first learning module component, so the number '10' is
assigned as its order. Assigning orders in increments of '10' means that
supplementary or alternative components can easily be integrated into an
existing learning module, without having to reassign the entire order. i.e. if
an educator decides to implement a second tutorial component, they may do
so, and assign any number from '11-19' as its order (assuming the next
component's order is '20').
Chapter 5
LabAuthor
55
5. Click OK
6. Repeat steps 2-5 for each component of a given learning module, giving each
a relevant title and order number. i.e. For a Blood Pressure Learning Module
comprising a tutorial, pre-lab quiz, laboratory session, patient case study and
evaluation, the following attributes would be applied in the Experiment
Properties dialog for each.
Learning module title: 'Blood Pressure'
Experiment title: 'Tutorial'; Order: '10'
Experiment title: 'Pre-lab Quiz'; Order: '20'
Experiment title: 'Laboratory Session'; Order: '30'
Experiment title: 'Patient Case Study'; Order: '40'
Experiment title: 'Evaluation'; Order: '50'
Other Considerations:
Ensure the Experiment author is identical for every component of the
learning module. Experiment properties must be consistent throughout all
components of a Learning Module for them to be recognized and grouped
correctly by LabTutor. If you edit a component of an ADInstruments'
Learning Module, an option 'Keep this experiment part of the
ADInstruments' Learning Module' is selected by default. Keep this selected
to maintain the edited component as belonging to the original Learning
Module. If you are editing every component of an ADInstruments'
Learning Module, it is recommended that you uncheck this and ensure the
56
The experiment installer will save with the following attributes: '<Learning
module name> - <Experiment title>.ltexp'
Learning modules can be distinguished from traditional experiments in the
Course pages by light-blue text:
The Experiment title: should be kept brief and only describe that discrete
learning module component. Ie. "Tutorial", as opposed to "Autonomic
Nervous System - Tutorial". The learning module title is displayed as the
'parent' of the learning module drop-down, and appears in the student
pages as below:
Chapter 5
LabAuthor
57
Troubleshooting
If a group login includes a mix of students who have submitted or started different
learning module components independently, the following error will be shown:
Chapter 5
LabAuthor
59
Troubleshooting
This section contains some frequently asked questions and describes actions to take if
you encounter problems using the LabTutor Suite. Further information can be found in
the LabTutor Server help and via adinstruments.com
Technical Support
There is always the potential for problems to arise that will stop LabTutor Server from
functioning correctly, if you find yourself in such a situation please contact your
ADInstruments representative for further assistance. They will be able to assist you in
gathering diagnostic information from your server to help resolve the issue.
Forum
The ADInstruments Software Forum provides an interactive online environment
where PowerLab users and ADInstruments product and application specialists can
share their knowledge and expertise. It provides a great place to ask questions, make
suggestions, share ideas, tips and experiments. You can access the forum at
adinstruments.com/forum/
FAQ
If the experiment is saved on different computers but not on the server, how can I
access this and continue working?
In LabTutor 4, experiments must be installed to LabTutor Server to function
properly. Local experiment installs are for creation and editing using LabAuthor
and are not intended for usage in a classroom situation as data sampled and
recorded outside of LabAuthor will not be saved.
How many copies of the same experiment can be submitted? What if a student is
working on the same experiment by logging on from different computers?
Each student can only submit an experiment once. The number of computers a
student uses to perform an experiment does not matter, as all data is stored on the
LabTutor Server. Students cannot have more than one active session. If a student
60
logs in using another browser or computer, the other session will automatically be
logged out upon navigating to a new page or performing an action, such as
sampling data.
What happens if a student starts an experiment with one group, then leaves to
join another group without the first group logging out and logging back in?
Students cannot have more than one active session. If a student logs in with
another group of users, then the first group will be logged out automatically and
they will need to log back in without that student.
What will happen if a student logs in to LabTutor Client and/or Online using two
different browsers/browser windows at the same time?
Students cannot have more than one active session. If a student logs in using
another browser or computer, the other session will automatically be logged out.
Is there a way to setup LabTutor to use another port besides 80, 443, or 8005?
No
How do I find out what programs are using ports 80 and 443?
The LabTutor Installation Advisor will detect this situation if it arises. You can also
manually check this from the LabTutor Server computer. Open a command
prompt window by looking in All Programs > Accessories and right click on the
command prompt item, then select 'Run as Administrator'. Once the window
opens type 'netstat -oan'. This will show you a list of all the listening services, the
port they are using and the process ID. This information can then be given to
your Tech Support provider. The most common scenario is that these ports are
already in use by Skype.
How do I stop Skype and VMware Server using ports 80 and 443?
If you have Skype installed on the same machine as LabTutor Server, this can
result in ports 80 and 443 being utilized by Skype, and therefore not being
available for LabTutor Server. You can get around this without reducing the
standard functionality of Skype or uninstalling it. Go into Skype and click Tools >
Options > Advanced > Connection and uncheck the box that says 'Use port 80
and 443 as alternatives for incoming connections'. VMware Server also has the
same issues, and shouldnt be installed on the same machine as LabTutor Server.
What is the minimum Hard Drive size for running LabTutor server?
This depends on a number of factors including the number of students, number
of experiments, and the amount of data collected. It is recommended that you use
the Installation Advisor.
Chapter 6
Troubleshooting
61
62
Chapter 6
Troubleshooting
63
You must use LabAuthor to add the Instructors Material to an experiment. These
files are then installed along with the experiment, and accessed via the Instructors
Material tab in the administration pages.
What is the required format for importing/exporting student list?
You can import student details in bulk from a file. The file containing the list of
student details should be formatted so that the details for each student are on a
separate row, with columns separated either by tabs (.txt) or commas (.csv), or the
file should be in Microsoft Excel 97-2003 format (.xls). Note that for Excel
documents, only data contained on the first sheet of the document can be
imported.
For exporting a student list you can choose which columns of data are exported by
checking the boxes beside each one. The Licensed, Active and Protected fields
export a value of 1 for yes and 0 for no. The export may be limited to a subset of
the whole student list by selecting for only those students who are Licensed, Active
or Protected. Data can be exported in comma separated value (.csv), tab delimited
(.txt) or Microsoft Excel 97-2003 (.xls) formats.
Is it possible to get a list of students who have or have not submitted an
experiment?
You can use the Student Data tab within the administration pages to see which
experiments have not been submitted, and by whom. You can also print this page
out. The Find and Manage option allows you to see the status of all unmarked
student data, whilst the Status tab allows you to search for an experiment based on
its status.
Is it possible to annotate and return student experiments?
No, this functionality is not currently available from LabTutor Server. You can
print or export the report pages (PDF or docx), and manually annotate the
experiment.
What is the minimum version of Adobe Acrobat required to view the report
PDFs?
PDFs generated by LabTutor Server are saved as version 1.4 (Acrobat 5 or above),
which most common PDF viewers should be able to read. It is recommended that
you always use the latest version of Adobe Reader available.
What is the minimum version of Microsoft Word required create docx files?
You must have Microsoft Word 2007 or later installed on LabTutor Server in
order to be able to create docx reports. There are many software products and
64
services that students can use to view and edit docx files (Microsoft Office,
OpenOffice.org, Google Docs etc.)
Is it possible for a student to just see a relevant course?
Yes, there are a couple of ways you can do this with restricted courses.
How to assign an existing student to a restricted course:
1. Log in to LabTutor Server as an Administrator or Instructor (must be
assigned to that course)
2. Navigate to Student > Find and Edit
3. Search for that student and click Edit
4. Unrestricted courses will be listed in Course list for that student and
restricted courses in Available courses
5. Double-click a restricted course, or highlight and click ^ Add ^ to have that
restricted course added to that student's course list, now able to be accessed
from their homepage.
How to assign a new student to a restricted course:
1. Log in to LabTutor Server as an Administrator or Instructor (must be
assigned to that course)
2. Go to Students > Add a Student.
3. Enter a unique student User Name.
4. Enter a unique User ID.
5. Enter the students Given name and Family name.
6. You can also enter an Email address if desired.
7. Click the Protected checkbox if necessary.
8. By default, all unrestricted courses are displayed in this student's Course
list. All restricted courses will be listed in Available courses and may be
added to the Course list by selecting and clicking ^ Add ^, or doubleclicking. Courses in the Course list will be available and displayed on that
students home page.
9. Click Save.
The other approach is to navigate to a new or existing course in the Server Admin
pages, check the box Allow students to add this course with access code:, define an
course access code and communicate this to relevant student(s). They are then able
to add (assign) themselves to this course by logging in, clicking the + Add course
button on the student home page and entering the relevant course access code.
Chapter 6
Troubleshooting
65
In either case, the result will be that the restricted course becomes visible and
available on that student's home page.
How many client machines can access the server at any one time?
Our tests indicate that over 200 users can simultaneously access LabTutor Server.
However, this depends on the specification of the server and client computers, and
the experiments that the students are conducting. In general, we advise that a
computer with high specifications should be used for the LabTutor Server
computer.
Where are the student experiments saved by default on the Server, and can this
location be changed?
It is saved to the LabTutor Server folder on the computer running LabTutor
Server, this location cannot be changed. The path to this data folder depends on
the version of Windows you are running:
Server).
Is it possible to simultaneously open two different experiments in LabAuthor to
edit or combine them?
No, LabAuthor does not allow users to open and edit more than one experiment
at once.
LabTutor Online is missing some images when viewing from an iPad. How can I
fix this?
This can be fixed by clearing your web browser's cache. For iOS Safari, navigate to
Settings > Safari > Clear Cookies and Data.
Can I use LabTutor Server with a wireless network?
Wireless networks are not supported for a classroom situation because of
potential wireless interference and the bandwidth required when sampling data
from the PowerLab using multiple client computers. A 1Gbps wired network
connection is recommended for optimal performance.
Students have just updated Client in the student pages, why are their PowerLabs
now not being recognized?
If students' PowerLabs are not being recognized by Client after a version update,
have them log out, switch their PowerLab off and on, and then log back into Client.
Why does the next Learning Module component appear greyed out and is unable
to be accessed in the student's course page?
Each Learning Module component must be submitted before the subsequent
component can be accessed. Therefore, each component of the Learning Module
must contain a report page (LabAuthor) and have 'Display Submit button' (Server
admin pages) configured for that particular course.
Chapter 6
Troubleshooting
67
68