Preface: Important Information 4 Technical Support 5

Preface:

Important Information 4

Technical Support 5

Installing LabStats:

System Requirements 7

Alternate Scheme Recommendations 9

Pre-Installation Setup 10

Installing LabStats 13

Groups and Stations:

Manage Groups and Stations 22

Group and Station Types 29

Group Status 32

Station Merge 34

Machine Assignments 35

Client Update Manager 37

Lab Alerts 38

Station Management 39

Disassociate MAC Address 40

Product Settings:

LabStats 42

AppUse 46

JuicePress 50

Trouble Tickets 57

LabGrab 61

LabMaps 65

PrinterStats 70

Reports:

Data Options 75

LabStats Reports 78

AppUse Reports 80

PrinterStats Reports 83

Report Manager 84

Custom Data Import 85

Administration:

_|

Preface

This user guide explains how to install and use LabStats and its associated modules.

Topics

Important Information

This section contains important information about your Computer Lab Solutions Product.

About Computer Lab Solutions

LabStats is a suite of software products that helps administrators manage computer labs. LabStats makes it easy to track computer usage, application data, and manage power usage. Designed specifically for computer lab environments, LabStats uses a lightweight client to send usage data to a streamlined database and a single web server to generate reports on computer lab usage.

Product Documentation

The following documents form the LabStats documentation set:

• LabStats User Guide — This document guides you how to use the product.

Technical Support

_|

Technical Support

Every effort has been made to design this software for ease of use and to be problem free. If problems are encountered, contact Technical Support.

Email: [email protected] Phone: 1-801-939-3312 or 1-877-299-6241 Option 2 Hours: 8:00am to 5:00pm MST

Contact Information

Computer Lab Solutions 255 B St

Suite 201

Introduction

How LabStats Works

LabStats 5 has two main parts: the client and the server. The client is a small, background program that runs on your computers. The client gathers information on how the machine is being used and sends that data to the server.

The LabStats Server Portion consists of three parts. The processing agent for clients (Remoting Server), the web interface (IIS + Asp.net) and the database back end. (MSSQL)

For LabStats to function all three parts are needed. The LabStats Remoting Server acts as a gateway for client communication. When clients talk over their intended port (by default 8080 for Windows, 8083 for Mac or Apple based clients and 8081 for Linux distributions) the LabStats Remoting server "picks" up those clients from network based communication. The Remoting Server also takes the client information and sends it off to the database so it can be displayed in the web interface. Without the Remoting Server the clients would not have a way to talk to the LabStats server. Thus it would not process the login, application, power or printer statistics.

Topics

System Requirements

System Requirements

_|

System Requirements

Server Component

SOFTWARE:

Operating System: (either 32 or 64 BIT)

Windows 7*, 2003 SP2, 2003 R2 SP2, 2008 SP2, 2008 R2 Web Server: IIS 6, 7, 7.5, Cassini* Database Server: SQL Server 2008 SQL Server 2008 R2 Express Other Software:

.NET 4.0 Framework **Extended Edition

For IIS 7 or greater Installations: ASP.NET IIS 6 Management Compatibility

For IIS 6 Installations: ASP.NET

*Demo purpose only, not meant for product environment. **Extended Edition of .NET is required

Client Component

SOFTWARE:

Operation System: (either 32 or 64 BIT)

Windows: XP*, Windows 7*, 2003, 2003 R2, 2008, 2008 R2 Mac: 10.4

Linux: Ubuntu 9 or higher, Fedora 14, Red Hat Enterprise 6 (Ubuntu 11 requires a different version on Mono)

Other Software:

.NET 3.5 Framework

Mono Framework for Linux:.2.10.2 HARDWARE:

Enough processing power, RAM, and hard drive space to run the OS in its recommended configuration.

Tiered Server Recommendations 1 to 500 Clients

SOFTWARE:

Operating System: (either 32 or 64 BIT)

4Gb RAM

10Gb Hard Drive Space above what’s needed for the OS.

500 to 1000 Clients

SOFTWARE:

Operating System: (either 32 or 64 BIT)

Windows 2003 SP2, 2003 R2 SP2, 2008 SP2, 2008 R2 Web Server: IIS 6, 7, 7.5

Database Server:

SQL Server 2008 R2 Express SQL Server 2008

HARDWARE:

2.5 GHz Dual Core Processor 4Gb RAM

20Gb Hard Drive Space above what’s needed for the OS.

1000 to 1500 Clients

SOFTWARE:

Operating System: (either 32 or 64 BIT)

Windows 2003 SP2, 2003 R2 SP2, 2008 SP2, 2008 R2 Web Server: IIS 6, 7, 7.5 Database Server: SQL Server 2008 R2 Express SQL Server 2008 HARDWARE:

2.5 GHz Dual Core Processor 4Gb RAM

30Gb Hard Drive Space above what’s needed for the OS.

1500 Clients and above

SOFTWARE:

Operating System: (either 32 or 64 BIT)

Windows 2003 SP2, 2003 R2 SP2, 2008 SP2, 2008 R2 Web Server:

IIS 6, 7, 7.5 Database Server:

SQL Server 2008 R2 Express

SQL Server 2008 – Highly Recommended HARDWARE:

2.5 GHz Quad Core Processor 6Gb RAM

Alternate Scheme Recommendations

_|

Alternate Scheme Recommendations

You can split the Web, Database, and Remoting Servers onto separate machines. The more clients that connect to the Remoting Server the more memory and processing power it will use. Once you exceed 1500 clients, client communication and website response may begin to delay. To avoid this we recommend either adding resources for a single server configuration, a longer check-in interval or one of the following schemes. Keep in mind that a longer check in period should not affect accuracy as login/logout events are sent to the Remoting Server immediately and other events are written to XMLfiles on the client until the next check in. If you have licenses for SQL Server we recommend using it as there are better tools with the standard editions over express.

Scheme Setup 1

Standard LabStats setup with website,

Database, and Remoting Server residing on the same server.

Scheme Setup 2

LabStats website and Remoting Server on one machine and the Database on another.

Scheme Setup 3

LabStats website, Database, and Remoting Server on separate machines.

Scheme Setup 4

Pre-Installation Setup

Pre-Installation Setup

Please make sure the following is setup prior to installing or upgrading to LabStats 5. This will help to ensure a smooth installation.

Setup IIS with ASP.NET (Windows 2003)

1. Click on Add/Remove Programs within the Control Panel. 2. Click on Add/Remove Windows Components

3. Double-Click on Application Server

4. Click to check Internet Information Services and ASP.NET 5. Click OK to install and finish setup

6. After installation, run the .NET registration for IIS instructions below.

Setup IIS with ASP.NET (Windows 2008)

1. Click on Administrative Tools within the Control Panel 2. Click on Server Manager

3. Right Click on Roles and click Add Roles 4. Once in the Add Role Wizard, click Next 5. Check Web Server (IIS) and click Next 6. Click Next again

7. Under Role Services, click to check the following

8. Application Development >> ASP.NET (Check to add required services) 9. Management Tools >> click to check IIS 6 Management Compatibility 10. Click Next

11. Click Install

|

Setup IIS with ASP.NET (Windows 7)

Please Note: This is for demo purposes only as we do not support running the LabStats server

from Windows 7

1. Click on Programs and Features within the Control Panel. 2. Click on Turn Windows features on or off

3. Click to check Internet Information Services

4. Click the plus on Internet Information Services >> Web Management Tools >> IIS 6 Management Compatibility

5. Click to check IIS 6 Scripting Tools, IIS 6 WMI Compatibility, and IIS Meta base and IIS 6 configuration compatibility.

6. Click the plus on Internet Information Services >> World Wide Web Services >> Application Development Features

7. Click to check ASP.NET (This will check others, this is OK) 8. Click OK to install

9. After installation, run the .NET registration for IIS instructions below.

.NET IIS Registration (If .NET was installed prior to installing IIS)

In order for .NET applications to run properly under IIS, .NET needs to be registered. If you aren’t sure, please run the following regardless.

1. Open a Admin Command Prompt and execute

2. 32 BIT OS: C:\windows\Microsoft.NET\Framework\V4.0.30319\aspnet_regiis.exe –iru 3. 64 BIT OS: C:\windows\Microsoft.NET\Framework64\V4.0.30319\aspnet_regiis.exe –iru

.NET 4 Extended Framework

If you already have .NET 4 installed on the server, our installer will skip over installing it. Having said that, our installer requires the extended version of .NET 4 so please make sure if you already have .NET 4 installed, it’s the extended version. If not, please uninstall .NET 4 or install the extended version before installing LabStats 5. If .NET 4 is not installed, the LabStats 5 installer will install it. If this is the case a reboot may be necessary to

Installing LabStats

This chapter describes how to install LabStats.

Topics

Installing LabStats

_|

Installing LabStats

To install LabStats, complete the following steps:

Installing the Server

The server can be installed by double clicking on the installer file and running through the steps.

1. You will be given a choice between Easy and Custom Install. ‘Easy’ will install all of the required LabStats 5 components, while ‘Custom’ can be used to install the Remoting Server, Web Server, and Database Server separately for use with alternate production schemes.

need to manually install it before continuing the installation.

Licensing

For more information about applying a license and licensing groups, please see the section on

Licensing.

Setup Guide

Walking through this guide will make it a simple matter to:

• Choose a password for the default ‘LabStats’ account • Enter your license key

• Add groups (and choose a default group • Download the needed client installers.

1. The first step of the setup guide is to set the password for the default admin user ‘LabStats’. In previous versions the default password was preset to ‘labstats’.

Installing LabStats

_|

3. If you already have an account with Computer Lab Solutions you can retrieve your current license by selecting ‘Retrieve Your Key’ and entering your Account ID (your school’s Customer ID Number) and your server address. It is important to enter the same information that you provided to Computer Lab Solutions for our records.

6. The next step of the setup guide will allow you to add groups and set a default group. This will be the group that stations will automatically be assigned when they check in unless they meet the requirements of a definition associated with another group.

Installing LabStats

_|

8. The hostname definitions can be set using wildcards, and multiple definitions can be entered by separating them with a comma.

9. The next step in the setup guide allows you to download the Client Installers that you will need. From here you can also see the number of stations that have checked in to each group.

Accessing LabStats

Web Interface

When logging into the web interface directly (rather than through the setup guide), follow these steps. Keep in mind this applies only to the default IIS settings. If you have altered your default

settings the path to log into LabStats may have changed:

1. Open your web browser and navigate to http://localhost/LabStats or

http://[ServerAddress]/LabStats from another computer

2. Click on the “Sign In” link on the upper right hand corner of the page.

3. Enter “LabStats” for the user name and the password that you set during the setup guide.

Help

The LabStats Web Interface is designed to be intuitive to use, however if you are not certain how to use a page, you can click on the ‘?’ (help) icon at the top right of most panels and a popup box will appear with more information about the options on the page. Below is an example of the help box from the LabStats Settings Page:

Search

Installing LabStats

_|

Installing Clients

The client is a small executable that runs as a service on your machines. The client for Windows, Mac, and Linux can be downloaded from the web interface. In order to run the client on Linux, you will need to install the Mono framework before installing the LabStats client.

To download the client:

1. Navigate to: Groups and Stations -> Client Installers.

2. Select the Client Version that you want to install (typically the latest version is recommended) from the dropdown list.

3. Click on the appropriate download link for the operating system you are installing the client on.

4. Make sure your Current Settings match your LabStats Server.

To install the Windows client:

1. Click to download the Windows (.exe)

2. Double click the installer and follow the on screen instructions.

To install the Mac Client:

1. Download and run the Native Mac Client .PKG installer

2. Do not download the Native Mac Client .PKG installer using Safari as it will attempt to unpack the .PKG and this will adversely affect the installer.

To install the Linux client:

1. Install the MONO framework. You can find information on how to install MONO for your Linux distribution at http://mono-project.com.

|

Groups and Stations

This chapter explains how to use the Groups and Stations menu in LabStats.

Topics

Manage Groups and Stations

Group and Station Types

Group Status

Station Merge

Machine Assignments

Client Update Manager

Lab Alerts

Manage Groups and Stations

Manage Groups and Stations

The “Manage Groups and Stations” page is the main area you will use for managing your groups and stations. This page allows you to organize your stations and groups along with controlling certain settings. You can access this page by navigating to: Groups and Stations -> Manage Groups and Stations.

Creating Groups

Once you have installed the client on your stations, you may want to create additional groups, or make changes to groups you created through the setup guide. Groups give you a convenient way of organizing your stations. One possible way to organize your groups is to have each group consist of the computers in a particular room.

To create a group:

1. Navigate to: Groups and Stations -> Manage Groups and Stations. 2. Click on the “Add Group” button.

3. You will now be able to enter the name and description you want for the group. 4. Click the “OK” button to save your changes.

Manage Groups and Stations

_|

Now that you have created your groups, you need to manage your stations. You can change the name of your stations by selecting the station that you want to change, click on the info tab and click the pencil next to “Station Name.”

Press “OK” to save your changes.

Stations can be assigned to a group automatically through definitions, rules that associate a station to a group based off of common hostnames, IP addresses, or MAC addresses. If you do not have definitions set up (or if a station does not fit into the definitions) it will

automatically be assigned to the default group.

To Change a Station’s Group:

1. Navigate to: Groups and Stations -> Manage Groups and Stations.

2. Select the group that you want to add the station to and click Add Station 3. Next check the box next to “Show all stations”

4. Select the stations from the “Add Station” list (hold control to select multiple stations).

Setting up a Schedule:

Schedules allow you to tell LabStats when a group is open, closed, etc. The schedule helps you in two different ways.

1. It allows you to easily run reports on your groups for only certain periods of time. For example, you may only want to figure out the usage percent for a Lab during its open hours.

2. It allows students to have an idea of when a lab is available.

Schedule Options:

To Create a Schedule:

1. Navigate to: Groups and Stations -> Manage Groups and Stations. 2. Select the group you want to set a schedule for.

3. Click on the “Schedule” tab.

4. Double click on the day and the time you would like to start the schedule on.

Title: Information relative to the event being scheduled. Start Time: The time in which the event starts.

End Time: The time in which the event ends.

Status: An open status signifies that the group’s computers are available for use

during the event. Close means the group’s computers are unavailable. Correctly setting this status helps you easily set reports to only run on groups during their open times.

Publish Level: This option allows you to control what event details are published to the

server. “Status Only” will only cause the status of open or closed to appear on the published scheduled. Choosing “All Details” causes the subject to appear on the published schedule.

Recurrence: By checking this checkbox you will be given options to have this event

Manage Groups and Stations

_|

5. Choose the appropriate options (as described below).

6. Click “OK”.

To edit an event:

1. Navigate to: Groups and Stations -> Manage Groups and Stations. 2. Select the desired group.

3. Click the “Schedule” tab. 4. Click on

5. the event in the calendar that you want to edit.

6. Make the necessary changes and press ‘OK’ to save your changes.

To delete an event:

1. Navigate to: Groups and Stations -> Manage Groups and Stations. 2. Select the desired group.

3. Click the “Schedule” tab.

4. Click on the event in the calendar that you want to delete. 5. Click the “Delete” button.

6. Click “OK” to confirm that you want to delete the event.

Assigning Licenses to Your Groups

Now that you have created your groups, you need to assign licenses to those groups.

To assign licenses to your groups:

1. Navigate to Groups and Stations.

2. Click on the group you want to apply licenses to. 3. Click on the Licenses tab.

Automatically Assigning Stations to Groups

You can have stations automatically assigned to groups through the use of definitions. 1. Navigate to: Groups and Stations -> Manage Groups and Stations.

2. Select the appropriate group. 3. Click on the “Definitions” tab.

4. Choose the Host Name, IP address, or MAC Address tab depending on what type of definition you want to create and press the ‘+’ button to create a Definition.

5. Hostname definitions cause stations to be automatically assigned to a group based off the host name. For example, if you provided “North-Library*” as the Hostname, any station that has a host name starting with “North-Library” would be automatically added to this group (i.e North-Library-1). You can provide any regular expression for the Hostname box. The “Exclusion” checkbox prevents stations with a matching host name from being added to the group.

6. On each of the definition tabs you will find a button that says “Assign Stations Now.” This button will allow you to automatically move any existing stations into your group that match the definition. Note: This applies only to stations that are in the

Unassigned Group. IP Address Definitions:

IP address definitions cause stations to be automatically added to a group based on an IP address. For example, if you set the IP address as 192.168.1.0 and the Netmask as

255.255.255.0, any IP address between 192.168.1.0 and 192.168.1.255 would automatically be added to the group. The “Exclusion” checkbox prevents stations with a matching IP address from being added to the group.

Manage Groups and Stations

_|

MAC Address Definitions:

MAC address definitions cause stations that meet certain MAC addresses to be automatically added to a particular group. The exclusion checkbox will prevent a computer with a

matching MAC address from being added.

Managing your groups

To view the details about all stations in a group, select the group and click the Stations tab.

1. Unassign: Select the stations you wish to unassign, then click this button.

Welcome Message

Here you can set the Group's Welcome Message.

1. Input the text you wish to display to all stations in the group. 2. Adjust the Display Time Accordingly, then click save.

3. The message will display whenever a user logs into a station in this group.

JuicePress group tab

Wake or shutdown an entire group that is licensed for JuicePress with the click of a button in the JuicePress group tab.

Building Your Hierarchy

The great thing about LabStats 5 is that you can have groups contained within groups. This allows you to create a hierarchy. By assigning groups to be child groups of other groups, you will naturally build your hierarchy.

To assign a group to another group:

1. Navigate to: Groups and Stations -> Manage Groups and Stations. 2. Select the parent group (this group cannot contain individual stations). 3. Select the “Associations” tab.

4. Click the “Add Group” button.

5. Select the groups you want to include (Hold the ctrl key down to select multiple groups).

6. Click “OK”.

Group and Station Types

_|

Group and Station Types

Group and Station Types

LabStats allows you to assign special icons to your groups. For example, you could assign a special icon to the groups that represent departments. You can also assign special icons to your stations. For example, you could assign a laptop icon to stations that represent laptops.

Managing Group/Station Types

To add a Group Type:

1. Navigate to: Groups and Stations -> Groups Types.

2. Click the “Add New Group Type…” link. This will bring up a dialog box.

3. Provide a name and a description.

4. Click on the “…” button to bring up a file browser.

5. Using the file browser, select the appropriate image you would like to upload. 6. Press the “OK” button.

To Edit a Group Type:

1. Navigate to: Groups and Stations -> Groups Types. 2. Highlight the Group Type you would like to edit. 3. Click on the pencil image at the bottom of the section. 4. Make the necessary changes.

To Delete a Group Type:

1. Navigate to: Groups and Stations -> Group Types. 2. Highlight the Station Type you would like to delete. 3. Press the ‘Trash Can’ icon at the bottom of the section. 4. Click “OK” to confirm the deletion.

To add a Station Type:

1. Navigate to: Groups and Stations -> Station Types.

2. Click the “Add New Station Type…” link. This will bring up a dialog box. 3. Provide a name and a description.

4. Click on the “…” button to bring up a file browser.

5. Using the file browser, select the appropriate image you would like to upload. 6. Press the “OK” button.

To Edit a Station Type:

1. Navigate to: Groups and Stations -> Station Types. 2. Highlight the Station Type you would like to edit. 3. Click on the pencil image at the bottom of the section. 4. Make the necessary changes.

5. Click the “Submit” button to save the changes.

To Delete a Station Type:

1. Navigate to: Groups and Stations -> Station Types. 2. Highlight the Station Type you would like to delete. 3. Press the ‘Trash Can’ icon at the bottom of the section. 4. Click “OK” to confirm the deletion.

Assigning Icons to Groups and Stations

Group and Station Types

_|

To assign a type to a group:

1. Navigate to: Groups and Stations -> Manage Groups and Stations. 2. Click on the desired group.

3. Click on the “Info” tab if it’s not already selected.

4. Choose the appropriate group type from the “Group Type” dropdown list. 5. Click the “Save” button.

To assign a type to a station:

1. Go to the “Manage Groups and Stations” page. 2. Click on the desired station.

3. Click on the “Info” tab if it’s not already selected.

Group Status

Group Status

The default group statuses are opened and closed. However, you can add your own custom statuses that can be used on the calendar and reports.

To add a new status:

1. Navigate to: Groups and Stations -> Group Status. 2. Click the button.

3. Fill in the appropriate information (each option is explained below). 4. Click the “Save” button.

Status Options:

The following information details what the options are there are for the statuses:

Status Name: A name representing the status.

Status Description: A description used to help identify what the status is used for.

Status Color: The color you want the status to appear as on the schedule.

Availability: This represents whether or not the group is available for use while this status in effect.

Group Status

_|

To edit an existing status:

1. Navigate to: Groups and Stations -> Group Status.

2. Select the status you want to modify from the dropdown list. 3. Make the necessary changes.

4. Click the “Save” button.

To delete an existing status:

1. Navigate to: Groups and Stations -> Group Status.

Station Merge

Station Merge

Eventually you’ll run into the situation where you have replaced the computers in one of your labs with new computers. LabStats has mechanisms to merge the information from the old computers into the new computers.

To merge one computer at a time:

1. Navigate to Groups and Stations -> Station Merge -> One-to-One Merge 2. Click the checkbox of the old computer on the Source side.

3. Click the checkbox of the new computer on the Target side. 4. Click the “Merge Selected Stations” button.

To merge multiple computers a time:

1. Navigate to Groups and Stations -> Station Merge -> Mass Merge 2. Select the appropriate

3. “Match On” option from the dropdown box.

Machine Assignments

_|

Machine Assignments

Machines Assignments

A station is basically a container linked to a physical machine. As time goes on, you will probably replace your old machines with new machines. As you replace the old machines, you’ll change your stations to point to the new machines. This allows you to keep historical information for several machines as if they were always one machine.

Automatic Station Creation

By default, LabStats automatically creates a station for every new machine that checks in. It is useful to turn off this option when old machines are being replaced with new machines. You can turn off this option by doing the following:

1. Navigate to: Groups and Stations -> Machine Assignments. 2. Uncheck the “Automatically Assign Stations” checkbox. 3. Changes will automatically be saved.

Please Note: Once you disable this setting new clients that check in can be found here: Groups

and Stations-> Machine Assignments under the “Unassigned Machines” list.

Assigning Machines to Stations

To manually assign a machine to a station:

1. Navigate to: Groups and Stations -> Machine Assignments. 2. Select the “Assign” tab.

To drop a machine from a station:

1. Navigate to: Groups and Stations -> Machine Assignments. 2. Select the “Unassign” tab.

3. Select the station that you want to Unassign from a machine. 4. Click the “Unassign” button.

To assign a new machine to an existing station:

1. Navigate to: Groups and Stations -> Machine Assignments. 2. Select the “Unassign” tab.

3. Select the appropriate station.

4. Click the “Unassign” button to drop the old machine. 5. Select the “Assign” tab.

6. Select the appropriate station.

7. Choose the new machine from the “Unassigned Machines” list. 8. Click the “Assign Machine to Station” button.

9. Choose the old machine from the “Unassigned Machines” list. 10. Click the “Delete Selected Machines” button.

To create a new station:

1. Navigate to: Groups and Stations -> Machine Assignments. 2. Click on the “Create New Station” link.

Client Update Manager

_|

Client Update Manager

Client Update Manager

Updated versions can be pushed out to your clients through the “Client Update Manger.” This tool can be found by logging in to LabStats and navigating to: Groups and Stations -> Client

Update Manager.

To change the client version:

1. Select the stations you want to modify.

2. Choose the appropriate version from the “Available Versions” drop down box. 3. Click the “Apply to Selected Clients” button.

4. You will see a notice stating, “Your choice was saved and ‘X’ client(s) will be updated at their next scheduled checkin.”

The “Upload Client Bundle” button brings up a dialog box that allows you to upload a bundle containing updated client installers.

Note: If you want to downgrade the version you will need to uncheck the “Disable Client

Lab Alerts

Lab Alerts

LabAlerts will show a message to selected stations.

Click on Preview to see how it will look.

Set the “Message Duration” and decide if the message can be dismissed by checking the “allow dismissal” box. Click Send Message when ready.

The message will pop up on each client in the group for the selected period of time. If Allow Dismissal was checked the user will be able to press the ‘X’ to close the message.

Title: Message:

The title that shows up in the caption of our popup.

Station Management

_|

Station Management

S

tation Management

Hiding Stations:

1. Select the station you wish to hide. 2. Click "Hide Selected".

Unhiding Stations:

If you have hidden stations on the Groups and Station's "Stations" tab or from Station Management

1. Click "Show Only Hidden Stations" to view them.

2. Select the stations that you want to unhide and press "Unhide Selected".

Assign Station Types:

1. Select the stations you wish to change the Station Type for. 2. Press "Assign Station Types.

3. Select the desired type from the dropdown menu. 4. Press "ok"

Deleting Stations:

Deleting selected stations will delete the station and its history. Doing so is irreversible. If the client software is still installed, the station will be recreated once it checks in again.

Deleting History:

This will delete UserTracker, AppUse and JuicePress history for the selected stations.

Export Stations List:

Disassociate MAC Address

Disassociate MAC Address

NOTE: Make sure to add the similar (run ipconfig /all or ifconfig to determine the similar MAC address) MAC address (VMware, virtualbox, Microsoft LoopBack Adapter, OPEN AFS) to the Ignored MAC address area located at Product Settings > LabStats > Ignore MAC Address. This should be done before using the following feature.

1. Navigate to Groups and Stations -> Disassociate MAC Addresses

2. From here you can choose the station out of the Groups and Stations List 3. Then you can select the MAC addresses you wish to disassociate

4. Once all MAC addresses are selected (except for the “real” one) you can then click on the button entitled “Delete Selected MAC Addresses”

Product Settings

_|

Product Settings

This chapter explains how to use the Product Settings menu in LabStats.

LabStats

LabStats

LabStats provides the core functionality of the server. Every other module such as LabMaps, AppUse, JuicePress, PrinterStats and LabAlerts expand upon the capabilities of LabStats. With LabStats alone, you can track how often your computers are being used along with who is using them.

LabStats Settings

Under the LabStats settings page, Product Settings -> LabStats -> LabStats Settings, there are three different sections that control the LabStats settings.

User Tracker Settings

Minimum Record Length: The smallest login record length that can be recorded to the database. For example, if this setting is set to 1 minute but a user was only logged in for 59 seconds, that login will not be recorded to the database.

Report Remote User As In Use:

If this box is checked, the computer will show up as in use when someone is using it remotely.

Anonymize Usage Statistics:

If this box is checked, LabStats won't keep track of the actual user names. It will store irreversible hashes of the user names.

Remove Old Login History Data:

LabStats

_|

Tracking Exception Settings

"Tracking Exception Settings" allows you to specify which user names shouldn't be tracked. You can either enter specific user names or you can use regular expressions to control which user names shouldn't be tracked. The two text boxes at the top allow you to filter the list so you can find the specific exceptions you are looking for. The following information details how to complete common tasks.

Adding an Exception

1. Click the ‘+’ button at the bottom of the page to add a new exception.

2. Type in the user name you want to exclude or a regular expression in the "Exclude Pattern" text box.

3. Type in an appropriate description for the exclusion in the "Description" text box. 4. Click "Submit” to save the exception.

Removing an Exception

1. Select the exception you want to remove and then click the trashcan at the bottom of the section to delete the exception.

Editing an Exception

1. Select the exception you want to edit.

2. Click the trashcan at the bottom of the section. 3. Click "Submit” to save the changes.

Remove Logins Older Than:

This option specifies how long data should be kept for when the “Remove Old Login History Data” box is checked.

Show Offline Clients as Available:

If this box is checked, then computers with no one logged in to them will show up as available regardless of

Purge Data

This section allows you to remove old data from the database. To remove old data:

1. Click the calendar beside the “Date” text box. This will bring up a calendar in which you can select a date. Data prior to the selected date will be deleted.

2. Click the checkboxes for the types of data you wish to remove. 3. Click the “Remove History” button.

Public Page Settings

The Public Home Page will show live usage statistics for certain groups. An administrator can control which groups are shown on this page by logging in to LabStats and navigating to: Product Settings -> LabStats -> Public Page Settings.

Groups to Display on Public Page

To change which groups are shown on the Public Home Page:

1. Check each group you want to have displayed on the Public Page.

2. Hit the “Save Settings” button.

You can also set how often the public page will refresh by selecting an appropriate value from the “Page Refresh Interval” dropdown list.

Ignored MACs

LabStats

_|

MAC address to the Ignored MACs list.

Client Tracking Type

The tracking type helps LabStats know where it should gather user name information from. By default, the Standard tracking type will be used. The following information details what the different tracking types are used for:

Standard: The standard tracking type will base user information of the windows

user name. If you are using local user accounts or Active Directory, then this is the preferred method.

Novell: The Novell tracking type gathers user information from the Novell

NetWare client.

Environment Variable:

The Environment variable tracking type gathers user information from an environmental variable. If you choose this type, then a text box will show up where you can enter what variable is supposed to be used.

Inactivity: The inactivity setting allows you to track usage settings for computers

AppUse

AppUse

AppUse is an optional add-on to LabStats that allows you to track application usage. With AppUse, you will be able to see how often various applications are used on your machines.

AppUse Settings

The AppUse Settings page allows you to control the basic settings of AppUse. You can reach this page by logging in to LabStats and navigating to: Product Settings -> AppUse -> AppUse

Settings.

AppUse Exception Settings

This list contains rules about which applications should not be included in AppUse reports. The names of the rules contain regular expressions. Whenever an application has a name that matches one of the regular expressions, it will not be included in reports.

Minimum Record Length: The shortest amount of time an application can be used and still have its usage recorded in the database.

Auto Delete Old App Data: If this box is selected, then data older than the specified amount of time will be deleted.

Delete App Data Older Than: This option specifies how long data should be kept for when the “Auto Delete Old Application Data” box is checked.

Ignore New Apps by Default: When this box is checked, new applications will show up as ignored.

AppUse

_|

To create a new exception:

1. Press the ‘+’ button to create a new exception.

2. Fill in the "Application Exclusion" text field with a regular expression matching the desired rule. If you have a specific application you can just put the name of the executable in this field (i.e. word.exe).

3. Fill in the "Description" text box with an appropriate description describing the exception. 4. Click the "Submit" button to save the exception.

To delete an exception:

1. Highlight the exception row and select the ‘Trash Can’ icon at the bottom of the page.

To edit an exception:

1. Highlight the exception row and select the pencil icon at the bottom of the page. 2. Make the desired changes.

3. Click the "Submit" button to save the changes.

Known Applications

AppUse keeps a list of all applications that have been launched on your various stations. This list is automatically populated based off of the applications that have been launched on your machines. From this list, you can choose which applications are tracked.

To view the known applications list:

To search for a specific application:

1. Click the magnifying glass at the bottom of the page

2. Enter search criteria into the text boxes under the “Name” or “Display Name” column.

To hide applications from the list:

1. Tick the checkbox next to applications that should not show up in the list. 2. Press the “Ignore Selected” button to ignore these applications.

3. If you want to see your ignored applications, click the “Show Ignored” checkbox. This will cause the ignored applications to appear in the list.

4. Tick the checkbox and press the “Don’t Ignore Selected” button on ones you no longer wish to hide.

Application Groups

Here you can group your applications. Example groupings are suites like Microsoft Office, Adobe CS5, Internet Browsers, etc.

To add an application group:

1. Click the + icon.

2. Type a name for the group.

AppUse

_|

To edit an application group:

1. Select the group that you want to edit. 2. Click the pencil icon.

3. Make the necessary changes. 4. Click ‘Save’ to save your changes.

To delete an application group:

1. Select the group that you want to delete. 2. Click the trash icon.

3. Click ‘Delete’ to confirm the deletion.

JuicePress

JuicePress

JuicePress is a power management utility that allows you to better control how much electricity your computers use. With JuicePress, you can do the following:

1. Assign power schedules to your computers to optimize when they are on, off, and in standby.

2. Run reports to get an idea how much electricity your computers are using. 3. See how efficiently electricity is being used.

Power Schemes

Power Schemes specify what power options should be used when the scheme is in effect. Once the Power Schemes are created, you can then assign certain Power Schemes to be used during certain parts of the day.

To create a Power Scheme:

1. Navigate to: Product Settings -> JuicePress -> Power Schemes. 2. Click the + button.

3. Choose the appropriate options for the Power Scheme (Options are described below).

JuicePress

_|

Power Scheme Options:

Editing a Power Scheme:

1. Navigate to: Product Settings -> JuicePress -> Power Schemes. 2. Select the Power Scheme you want to modify.

3. Make the appropriate changes. 4. Click the “Save” button.

Power Schedules

JuicePress allows you to assign Power Schedules to your computers. Power Schedules detail when the computer is to be on, off, and in standby.

To Create a Power Schedule:

1. Navigate to: Product Settings -> JuicePress - > Power Schedules. 2. Click on the ’+’ button.

3. Provide a name for the Schedule. 4. Click the ‘OK’ button.

Scheme Name: This is the name of the Power Scheme. If you loaded an existing scheme, this is where you can change the scheme name. If you are creating a custom scheme, this is where you would assign the name of the new scheme.

Display Color: This is the color that will display in the Power Schedules when this scheme is selected. You can assign various colors to each scheme. Use the drop down menu to select the color of your choice.

Description: A short description that explains when this scheme is supposed to be used.

Client behavior is driven by: The “User Inactivity” option causes the effects of the scheme to only take place after a user has been inactive for a period of time. “The Schedule” option causes the effects of the scheme to take place even if a user is actively using the machine.

Show message after: This setting will determine how soon after the scheme starts that you want the message to appear on the user’s screen.

Log user out after: How long to wait before logging out the user of the station.

Sleep monitor after: How long to wait before putting the monitor to sleep.

Action to take: What action to perform on the station.

Take action after: How soon the action will take place after the scheme starts or after the user has been inactive.

7. Provide a start time and end time. 8. Choose the scheme you want to use.

9. If you need your computers to wake up, choose “Wake Up” as the start action.

10. Click the “Recurrence” checkbox if you want this scheduled item to be repeated for other days. Once you check the box, you’ll be given option to specify how often you want the event to reoccur.

11. Click the “Save” button to save the changes. 12. Repeat steps 7-12 to schedule more schemes.

JuicePress

_|

Click to save your changes.

JuicePress Settings

You can access the JuicePress Settings page by navigating to: Product Settings -> JuicePress -> JuicePress Settings.

The following information details what settings you can change for JuicePress.

Minimum Record Length: If a computer is in a particular power state for less than the time specified in this setting, no records will be created to reflect that. For example, if computer A was in sleep mode for 30 seconds and this setting is set to 1 minute; no entry record will be created to show that the machine was in sleep mode for 30 seconds.

Power Usage When On: The amount of watts a computer uses when it is fully on.

Power Usage When in Standby:

The amount of watts a computer uses when it is standby mode.

Power Usage When Off: The amount of watts a computer uses when it is turned off. Most computers will still use some electricity even when they are turned off.

Default Baseline: The amount of KWh used per day in a lab.

Default Electricity Rate: The cost of power per kWh where your organization is located.

Wake On Lan Retries: The number of retries when attempting a wakeup.

To assign custom power usage settings to a model:

1. Click on the pencil icon next to the machine name.

2. Text boxes will now appear for you to enter the on, off, and standby power usage settings.

3. Update the boxes to the power usage settings you wish to use. 4. Click the green check mark icon to save.

To remove a model's custom power usage settings:

1. Click on the “X” icon next to the model’s name.

2. Click on the "OK" button on the pop-up window that appears.

Machine Power Baseline Settings

The Machine Power Baseline Settings section allows you to specify what baseline you want to be used for certain types of machines. The baselines specified here will take precedence over the group baseline settings and the "Default Station Baseline".

JuicePress

_|

Group Override Settings

This section allows you to specify specific power usage settings for different groups.

To assign custom power usage settings to a model:

1. Click on the pencil icon next to the group name:

2. Text boxes will now appear for you enter the on, off, and standby power usage settings. 3. Update the boxes to the power usage settings you wish to use.

4. Click the check mark icon to save.

To remove a group’s custom power usage settings:

1. Click on the “X” icon next to the model name.

2. Click on the "OK" button on the pop-up window that appears.

JuicePress Exceptions

You can access the JuicePress Exceptions page by navigating to: Product Settings -> JuicePress -> JuicePress Exceptions.

User exception settings keep JuicePress from logging out or shutting down the computer when certain users are logged in.

To Remove a User Exception:

1. Highlight the exception row and select the ‘Trash Can’ icon at the bottom of the page to delete the exception.

To Edit a User Exception:

1. Highlight the row containing the exception you would like to edit. 2. Click on the pencil icon at the bottom of the section.

3. Make the appropriate changes.

4. Click “Submit” button to save the changes.

Application exception settings keep JuicePress from logging out or shutting down a computer when certain applications are in use.

To Add an Application Exception:

1. Click the ‘+’ icon to create a new exception.

2. Enter the application name in the “Name” Textbox. The application name should be the name of the executable as shown in the known application list (i.e. word.exe).

3. Enter a description describing the exception. 4. Click “Submit” button to add the exception.

To Delete an Application Exception:

1. Highlight the exception row and select the ‘Trash Can’ icon at the bottom of the page to delete the exception.

To Edit an Application Exception:

1. Highlight the row containing the exception you would like to edit. 2. Click on the pencil icon at the bottom of the section.

3. Make the appropriate changes.

Trouble Tickets

_|

Trouble Tickets

Trouble Tickets

Trouble Tickets is a feature included with LabStats. Trouble Tickets allows you to keep track of problems your machines are experiencing.

Viewing Existing Trouble Tickets

You can view your existing trouble tickets by logging in to LabStats and navigating to: Product

Settings -> Trouble Tickets ->View Tickets. You can sort the list by clicking on one of the

column headings such as “Title.” You can filter the list by clicking on the various filter icons.

Creating a New Trouble Ticket

To create a new trouble ticket, follow these steps:

1. Navigate to: Product Settings -> Trouble Tickets -> Add New... 2. Provide a title that will help uniquely identify the issue.

Trouble Ticket Settings

Edit Categories:

Navigate to: Product Settings -> Trouble Tickets -> Trouble Ticket Settings -> Edit Categories.

These settings allow you to choose what categories tickets can be assigned to.

To add a new category:

1. Press the ‘+’ Icon at the bottom of the page. 2. Enter a name for your Category.

3. Type a description for the category in the description box. 4. Click the Submit button.

To remove a category:

1. Select the category you wish to remove. 2. Press the trashcan at the bottom of the page. 3. Click Delete to confirm Deletion.

To modify a category:

1. Select the category you wish to Edit

2. Click on the pencil icon at the bottom of the page. 3. Change the description and name as needed. 4. Click Submit to confirm changes.

Edit Severity:

Trouble Tickets

_|

To add a new severity level:

1. Press the ‘+’ Icon at the bottom of the page. 2. Enter a name for your severity level.

3. Type a description for the severity level in the description box. 4. Click the Submit button.

To remove a category:

1. Select the severity level you wish to remove. 2. Press the trashcan at the bottom of the page. 3. Click Delete to confirm Deletion.

To modify a category:

1. Select the severity level you wish to Edit

2. Click on the pencil icon at the bottom of the page. 3. Change the description and name as needed. 4. Click Submit to confirm changes.

Edit Statuses:

Navigate to: Product Settings -> Trouble Tickets -> Trouble Ticket Settings -> Edit Statuses.

These settings allow you to choose what statuses can be assigned to a ticket. A status represents the standing of a ticket. For example, a status of open would mean that the work is being done to resolve the issue whereas a status of closed would mean the issue is resolved.

To add a new status:

To remove a status:

1. Click on the ‘x’ next to a status name.

To modify a status:

LabGrab

_|

LabGrab

LabGrab

LabGrab is an optional add-on to LabStats that allows users to reserve labs and allows administrators to manage user reservation requests. To select LabGrab Settings navigate to Product Settings -> LabGrab -> LabGrab Settings.

*When LDAP is enabled, user accounts will be created per the LDAP settings. If you are not allowing LDAP user accounts to be created automatically, you will need to create user accounts manually (matching LDAP user names) and give the relevant permissions (public user).

Class Settings

Here you can add a class list for users to choose from in their Reservation Request

Make Groups Reservable

To make your groups reservable, navigate to Groups and Stations >> Manage Groups and Stations and select the group that you want to make reservable ad click on the Info tab. From

Require authentication in order to use LabGrab:

When this is checked, users will have to login to the LabStats interface in order to submit a Reservation Request.

Once this is checked, users that are logged in will see a "My Reservations" link in the Reservation System

Allow users to create their own user accounts:

When this is checked, users will be able to create their own accounts for requesting reservations.

Class Code: This code will appear under the "Class" dropdown in a Reservation Request.

Reservation System

To access the reservation system, navigate to the Public Page and click on the “Reservation System” button.

Here users can view all reservations for reservable labs.

Show reservations: Select the labs you wish to see a schedule for. If you do not see a highlighted block of time, then there are no reservations for that lab.

Request Reservation: Click here to open a Reservation Request.

LabGrab

_|

Reservation Request

When the user clicks the “Request Reservation” button, they will see a confirmation that their reservation system had been submitted.

By clicking on the “My Reservations” button a user can view, edit, or cancel their reservations:

Reservation Approval Page

Lab Managers can approve or deny reservation requests by navigating to Groups and Stations >> “Reservation Requests”

Requested Room: The room/lab you wish to reserve.

Reason: If necessary, explain why you need to reserve this lab.

Class: Select the class code for which you are affiliated.

Additional Requests: Any further information you need to supply for your reservation.

Start/End times: The starting and ending date and time for your desired reservation.

Group: The name of the group for reservation.

Name: The name of the person desiring the reservation.

Requested Date/Time:

The time block that is being requested by the user for reservation.

Submission Date: The date and time that the reservation was submitted from the Reservation System.

Approve/Deny: Clicking either of these will prefill the "Approval Status" in the Reservation Approval dialog box with their respective

LabMaps

_|

LabMaps

LabMaps

LabMaps is an optional add-on to LabStats that allows you to visually show the availability of a lab. A lab map shows each computer in the lab with a color representing the availability of the machine.

Map List

Navigate to Product Settings -> LabMaps -> Map List

This section lists the various LabMaps that have been created.

To create a LabMap:

1. Click on the "Create New Map" button at the bottom. This will open the Map Creator. Note: You must have Microsoft Silverlight installed in order to create a LabMap

To publish a LabMap:

1. Select the check box for the appropriate map.

2. Click on the "Publish Selected Maps" button at the bottom of the page.

To Unpublish a LabMap:

1. Select the check box for the appropriate map

2. Click on the "Unpublish Selected Maps" button at the bottom of the page.

To Delete a LabMap:

1. Select the check box for the appropriate map

2. Click on the "Delete Selected Maps" button at the bottom of the page.

To Embed a LabMap:

Map Creator

A basic LabMap can be created by following these steps:

1. Navigate to: Product Settings -> LabMaps - > Map Creator. 2. Click on a group from the “Group Hierarchy” box.

3. Drag stations from the stations box.

4. Enter a title for the LabMap in the “Title” box. 5. Click the disk Icon at the top to save.

The following information below describes the controls and features of the LabMap editor.

Description: This text field allows you to enter a description that will help users better understand what this LabMap is for.

Background Color:

This control allows you to select what you want the background color of the map to be. If you want to use a background image instead of a color, read about “Custom Icons” below.

LabMaps

_|

Custom Station Icons

A new feature of LabStats 5 is the ability to use your own custom icons to represent the stations.

To create a new station icon:

1. Edit a PNG or GIF picture to include a transparent area. The status color representing if the machine is in use, offline, or available will show in this area.

2. Open or create a new LabMap. 3. Select: Edit -> Icon Editor

Size Controls: The size controls allow you to control the size of your icons, station labels, and map dimensions. For “Station Size” and “Station Label Size,” simply drag the slider from left to right to make the icon and label smaller or larger.

The left “Map Dimensions” box specifies the width of the map and the right box specifies the height.

My Images: The “My Images” section allows you to use a background image and place special icons on your map. To get to this section, click on the “My Images” tab on the left hand side of the map editor.

To use an icon, select the appropriate image from the drop down box and drag it onto the screen. If you have the “Background” bubble checked, the icon will be used as the background image.

5. Click the “Upload” button to upload the PNG or GIF picture you created.

6. Click each corner of the transparent section. You will start to see how the status color will appear on your custom icon as you are clicking the corners.

7. Provide a name and description. 8. Click the “Save” button.

9. Click the button to exit out of the editing tool.

To use a custom station icon:

1. Open the appropriate LabMaps in the LabMaps editor.

2. Click on the icon of the computer that will use the custom station icon.

3. The right side of the editor will now contain a drop down list of icons to choose from. Select the custom icon from the drop down list.

Map Settings

LabMaps

_|

PrinterStats

PrinterStats

PrinterStats is an optional add-on to LabStats that allows you to track printer usage. With PrinterStats, you will be able to see how often individual printers are used as well as information about that usage.

Managing Printers

To add a printer:

1. Log in to LabStats.

2. Navigate to: Product Settings -> PrinterStats -> Printers. A list of existing printers will be displayed.

3. Click on the ‘+’ button at the bottom left corner of the window to bring up the Add/Edit Printer page.

PrinterStats

_|

Details about the Printer will be collected by LabStats and displayed:

Printer Name The printer name generally matches the hostname by default but can be changed to specify who owns the printer or where it is located.

Manufacturer The Manufacturer is the name of the manufacturer which is gathered from the printer and can be edited.

Model The Model is the model name and number that is gathered from the printer and can be edited.

Printer Type The printer type such as Ink Jet or Laser is gathered from printer and can be edited

Color Color indicates whether the printer has the ability to print in color

Duplexing Duplexing indicates whether the printer has duplexing ability

HostName The host name is gathered from the printer and cannot be edited

IP Address The IP address will match the IP that you entered when querying for the printer information

Subnet The subnet will be gathered from the printer and cannot be edited.

MAC Address The MAC address is gathered from the printer and cannot be edited. If the printer does not provide the MAC Address information it will be listed as Undetermined

Managing the Printer Group

Add a group for your printers and then under the Associations tab choose Add Printer and select the printer that you added and choose OK to add.

|

PrinterStats Settings

To change the PrinterStats settings:

1. Log in to LabStats.

2. Navigate to: Product Settings -> PrinterStats -> Settings.

3. Health Check:

Here you can set how often the printer is checked for errors. The default is set to 1 Minute. 4. Notifications:

Reports

LabStats and its add-on modules have a variety of useful reports. This chapter explains how to use the Reports menu in LabStats.

Data Options

_|

Data Options

Data Options

The following table lists all the possible data options you might see in a report. Some options only appear on certain reports. This list has been placed in alphabetical order for convenience purposes.

Average: This option only appears on the “Average Usage” report. Selecting “Day” causes the report to show the average amount of logins or users for each day during a week. Selecting “Hour” causes the report to show the average amount of logins or users for each hour of the day. The “Day & Hour” option causes the report to generate average usage information for each hour of the entire week.

Avg Results by Selected Interval:

If this box is checked, you will see the average information for each interval. For example, let’s say that you have the date range covering three days and also have this box checked. In this scenario you also have the Interval set to “Hour of the Day.” With these options selected, you will only get 24 data points on the graph (one for each hour of a day). Each time point on the graph will represent the average usage for that time interval for all three days. So for the 1:00 PM point, you’ll have the average information for 1:00 PM to 2:00 PM for the three days.

Comparison Type: If group is selected, then there will be separate bars for each group for each time interval. If combined is selected, then all the groups will show up as one bar for a given time internal.

Exclude Existing Sessions:

This option excludes logins from being counted if the user is still logged in.

Filter By Group Status:

This dropdown menu allows you to only include time intervals in the report in which a status takes places. For example, if you choose the “Open” option, then only data will be included in the report for times in which the groups were scheduled as open.

Historical Perspective:

When you select the “Current” perspective, the report will be run based on your current group and stations assignments. The report will assume that the stations and groups have always been organized in their current setup. When you select the “Timeline” perspective, LabStats will take in account to how the stations and groups were assigned for each time interval in the report.

Interval: The interval represents what time units will be used on the graph.

Limit Days: This option allows you to only include information for certain days.

Limit Hours: This option allows you to only include information for certain hours.

Limit Results to Extremes: