labstats 5.2 user guide

Preface

Important Information 1 Technical Support 2 Introduction 3 System Requirements 4 Alternate Scheme Recommendations 7 Pre-Installation Setup 8

Installing LabStats

Installing the Server 10 Accessing LabStats 16

Groups and Stations

Manage Groups and Stations 19 Group and Station Types 26 Group Status 29 Station Merge 31 Machines Assignments 32 Client Update Manager 34 Lab Alerts 35 Station Management 36 Disassociate MAC Address 37

Product Settings

LabStats 38 AppUse 42 JuicePress 46 Trouble Tickets 53 LabGrab 56 LabMaps 60 PrinterStats 64

Reports

Data Options 68 LabStats Reports 71 AppUse Reports 74 JuicePress Reports 76 PrinterStats Reports 77 Report Manager 78 Custom Data Import 79

Administration

LabStats Users 81 Backup and Restore 84 Notification Center 86 Permissions Manager 87 Client Settings 88 Licensing 90 Site Settings 92 API Settings 95 Activity Log 96 Public Page 97 Mobile Page 98 Uninstalling LabStats 99

P a g e | 1

LabStats User Guide

PREFACE

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

Important Information This section contains important information about your LabStats Product.

About LabStats 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.

LabStats Release Notes - This document lists the new features, known issues, and closed issues.

P a g e | 2

LabStats User Guide

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-208-473-2222 or 1-877-299-6241 Option 2

Hours: 8:00am to 5:00pm MST

Contact Information

Web: www.labstats.com

Email: [email protected]

Phone: 1-801-939-3312 or 1-877-299-6241 Option 1

Fax: 1-801-823-2210

Hours: 8:00am to 5:00pm MST

Address:

LabStats

255 B St

Suite 201

Idaho Falls, ID 83402

USA

P a g e | 3

LabStats User Guide

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.

P a g e | 4

LabStats User Guide

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) Windows 2003 SP2, 2003 R2 SP2, 2008 SP2, 2008 R2 Web Server:

P a g e | 5

LabStats User Guide

IIS 6, 7, 7.5 Database Server: SQL Server 2008 R2 Express SQL Server 2008

HARDWARE: 2.5 GHz Dual Core Processor 4Gb RAM 10Gb Hard Drive

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

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

1500 Clients and above

P a g e | 6

LabStats User Guide

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

P a g e | 7

LabStats User Guide

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

If you have an IIS and SQL Server cluster environment, you can host the LabStats website and DB hosted on existing servers. You then can dedicate a machine to host the Remoting Server.

P a g e | 8

LabStats User Guide

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.


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



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

P a g e | 9

LabStats User Guide

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

8. Click OK to install


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

In order for .NET applications to run properly under IIS, .N

the following regardless.

1. Open an 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 a

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 complete

the installation.

P a g e | 10

LabStats User Guide

INSTALLING LABSTATS

This chapter describes how to install LabStats.

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

1.

separately for use with alternate production schemes.

2.

for the Web server.

P a g e | 11

LabStats User Guide

Cassini is a lightweight web server which is a great choice for testing or if you have less than 100

computers and you want a web server that requires little management. We do not recommend using

Cassini for more than 30 client machines.

IIS is a powerful web server created by Microsoft. It can handle a high number of computers quite well

it before continuing the installation.

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

Enter your license key

Add groups (and choose a default group)

Download the needed client installers.

P a g e | 12

LabStats User Guide

1. The first step of the setup guide is to set

Please Note: Though you are provided the option to skip entering a password we do not recommend doing

this. There is a known iss

have skipped the password setup and cannot login, contact support for help resetting the password via the

database.

2. In the next step you will need to input a license key. If you are just testing the product for the first time

you can enter your school information and request a demo key.

3.

and

important to enter the same information that you provided to LabStats for our records.

P a g e | 13

LabStats User Guide

4. Alternatively you can enter an existing key (we typically send these by email. You will want to double click

paste the key into the box provided then select Submit Key.

5. Once the license key has been entered you will see a notification that the license has been applied along

with a list of the products you are licensed for. If everything looks correct, hit next.

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.

P a g e | 14

LabStats User Guide

7. If you click on the gear beside the groups, you can set definitions which will help stations to be assigned to

the correct groups as they check in.

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.

P a g e | 15

LabStats User Guide

10. Once you have completed the setup guide you can click the button to take you to the home page.

P a g e | 16

LabStats User Guide

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. page.

3.

Help The LabStats Web Interface is designed to be intuitive to use, however if you are not certain how to use a page,

? 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 Another useful tool of the LabStats Web Interface is the search feature. On most pages of the web interface you

can click on the

Manage Groups and Stations page. Please Note how the station that matches the search criteria now displays in

light blue to make it easier to find.

P a g e | 17

LabStats User Guide

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.

Please Note: For Windows 8 clients, if users use the Email account login option the usernames will be truncated

within LabStats. It will truncate the user name to 5 characters and append a _000 (the 000 will grow with

accounts, ex: _001, _002).

To install the MSI Wrapper: 1. Click to download the Windows (.msi)

2. This file should be over 2 MEG, if

3. The MSI will install silently using the following command

4. msiexec /qn /i C:\LabStatsMSIWrapper.msi

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.

P a g e | 18

LabStats User Guide

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.

2.

3. Run the LabStats installer with root permissions.

To install VMware View client: To install LabStats on a master VMware View image please follow the steps below:

1. Download either the Windows .exe or msi from your LabStats server. To locate this download please

browse to http://yourlabstatsserver/labstats/login.aspx. Once logged in look for "Groups and Stations" >

"Client Installers" > and either click on Windows (.exe) or Windows (.msi)

2. Which installer you choose will determine the vdi option you install with.

EXE: "C:\Path to LabStats.exe" --vdi 1

MSI: msiexec /i "path to LabStatsMSIWrapper.msi" INSTALLVDI=1

3. Start the CLSUserClient (C:\ProgramData\Computer Lab Solutions\CLSUserClient.exe) and click Allow for

the local firewall message. This allows you to make the firewall exception without starting the actual

LabStats service and checking into the server.

vices control panel before you

save your image. If you do the client will get an ID from the server and all your imaged computers

will tell the server they are that client, and confuse the server.

4. Deploy Image

Upon connection from a zero thin client, the CLS Client Service starts & detects a vdi.dat file and doesnt check in

until it finds the hkcu mac address.

Vmware View Config:

You can configure the View Agent CommandsToRunOnConnect and CommandsToRunOnReconnect group policy

settings to pass client computer information to View Agent when users connect and reconnect to View desktops.

View Agent writes this information to the registry in the View desktop. For example, to pass the MAC Address of

the client computer to View Agent when a user connects to a View desktop, enable the

list of commands.

P a g e | 19

LabStats User Guide

GROUPS AND STATIONS

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

Manage Groups and Stations

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.

P a g e | 20

LabStats User Guide

3. You will now be able to enter the name and description you want for the group.

4.

You set your default group during the setup guide. New stations will automatically be assigned to the default

group unless you setup definitions within the other groups. To change the default group select the group that you

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:

1. C

2. save your changes.

P a g e | 21

LabStats User Guide

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.


2. Select the group that you want to add the station to and click Add Station

3.

4.

5. ld

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:

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:

setting this status helps you

easily set reports to only run on groups during their open times.

P a g e | 22

LabStats User Guide

Publish Level:

will only cause the status of open or closed to appear on the published scheduled. Choosing

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

To Create a Schedule:


2. Select the group you want to set a schedule for.

3.

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

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

6. Clic

To edit an event:


2. Select the desired group.

3.

4. Click on the event in the calendar that you want to edit.

5. changes.

To delete an event:


2. Select the desired group.

3.

4. Click on the event in the calendar that you want to delete.

P a g e | 23

LabStats User Guide

5.

6. that you want to delete the event.

Automatically Assigning Stations to Groups

You can have stations automatically assigned to groups through the use of definitions.


2. Select the appropriate group.

3.

4. Choose the Host Name, IP address, or MAC Address tab depending on what type of definition you want to

5. Hostname definitions cause stations to be automatically assigned to a group based off the host name. For

-

- -Library-1). You can provide

host name from being added to the group.

6. 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

P a g e | 24

LabStats User Guide

matching IP address from being added to the group.

Use the Netmask Calculator to calculate the needed values for the IP Address and Netmask fields.

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.

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

P a g e | 25

LabStats User Guide

8. Hide Selected: Select the station you wish to hide, then click this button. This will remove the station from

the group, but keep its Machine association and data history.

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.

4. For changes to the Welcome Message you may need to restart the CLS Remoting Service on the server.

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:


2. Select the parent group (this group cannot contain individual stations).

3.

4.

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

6.

7.

P a g e | 26

LabStats User Guide

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.

3. Provide a name and a description.

5. Using the file browser, select the appropriate image you would like to upload.

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

P a g e | 27

LabStats User Guide

To add a Station Type:

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

3. Provide a name and a description.

5. Using the file browser, select the appropriate image you would like to upload.

To Edit a Station Type:


2. Highlight the Station Type you would like to edit.

3. Click on the pencil image at the bottom of the section.


To Delete a Station Type:


2. Highlight the Station Type you would like to delete.

4. Clic

Assigning Icons to Groups and Stations

You can assign types to stations an

To assign a type to a group:


2. Click on the desired group.

4. Choose the ap

P a g e | 28

LabStats User Guide

To assign a type to a station:

2. Click on the desired station.

4

5. The icon for the station will update the next time the page is refreshed.

P a g e | 29

LabStats User Guide

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:

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

7. Click the button.

8. Fill in the appropriate information (each option is explained below).

9.

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.

Display Message: If you set a display message, then the message will appear instead of the status name for

schedules. For example, by default the

This means that on

Lab is Open

appear on schedu

To edit an existing status:


2. Select the status you want to modify from the dropdown list.


4.

P a g e | 30

LabStats User Guide

To delete an existing status:


2. Select the status you want to delete from the dropdown list.

3.

P a g e | 31

LabStats User Guide

Station Merge 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.

To merge multiple computers a time:

1. Navigate to Groups and Stations -> Station Merge -> Mass Merge

2. Select the appropriate

3.

4. The list will now group stations by the selected the criteria.

5. Make any necessary changes to the source and target assignments.

6.

P a g e | 32

LabStats User Guide

Machines Assignments A station is basically a container linked to a physical machine. As time goes on, you will probably replace your old

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.

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-

Assigning Machines to Stations

To manually assign a machine to a station:


2.

3. Select the station that will be linked to the machine.

4.

5.

To drop a machine from a station:


2.

3. Select the station that you want to Unassign from a machine.

4.

P a g e | 33

LabStats User Guide

To assign a new machine to an existing station:


2.

3. Select the appropriate station.

4.

5.

6. Select the appropriate station.

7.

8.

9.

10.

To create a new station:


2.

3. Select an appropriate Station name and choose a group to assign it to.

4.

P a g e | 34

LabStats User Guide

Client Update Manager

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.

3.

4.

allows you to upload a bundle

containing updated client installers.

Note:

will want to keep it checked if you want to avoid downgrading clients by mistake.

P a g e | 35

LabStats User Guide

Lab Alerts LabAlerts will show a message to selected stations. Title: The title that shows up in the caption of our popup. Message: The message (which can contain html) that will be displayed.

Click on Preview to see how it will look.

The message will pop up on each client in the group for the selected period of time. If Allow

P a g e | 36

LabStats User Guide

Station 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:

Click on the "Export" button, located at the lower left corner of the Stations list. Whatever is filtered for, at the time of clicking that button, will be exported in CSV format.

P a g e | 37

LabStats User Guide

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. entitled

5. After this is done all you need to do is wait for the other machines to check in with their actual MAC address (usually within the next 5 minutes based on client check interval).+

P a g e | 38

LabStats User Guide

PRODUCT SETTINGS

This chapter explains how to use the Product Settings menu in 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.

P a g e | 39

LabStats User Guide

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:

If this box is checked, then user data older than the amount of days specified will be deleted.

Remove Logins Older Than:

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 whether or not the machine is on.

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. Clic 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.

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.

P a g e | 40

LabStats User Guide

3.

Purge Data

This section allows you to remove old data from the database. To remove old data: 1. an 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.

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.

You can also set how often the public page will refresh by selecting an appropriate value from

Ignored MACs

computer. Ex. VMware Workstation uses common MAC addresses for their VMNET adapters. This will cause your clients to mimic each other, to prevent this add the common MAC address to the Ignored MACs list.

P a g e | 41

LabStats User Guide

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 where users don't log

in and out with their own user names. If you choose this setting, then LabStats will consider

the computer as available when it's been idle for a specified amount of time. If you choose

this type, then a text box will show up where you can enter how much idle time counts the

computer as available.

To change the tracking type:

1. Select the groups you want to apply the tracking type to. 2. Choose which tracking type you want. 3. Click Save.

P a g e | 42

LabStats User Guide

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.

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

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

Track New Apps by Default: If this box is checked, new applications that are reported to AppUse will be

tracked automatically. If this box isn't checked, then you will have to manually

set applications to be tracked.

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.

P a g e | 43

LabStats User Guide

To create a new exception:

1.

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.

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:

Navigate to: Product Settings -> AppUse -> Known Applications.

P a g e | 44

LabStats User Guide

To change which applications are tracked:

1. Tick the box next to every application you want tracked.

2.

To search for a specific application:

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

2. Enter search criteria into the text

To hide applications from the list:

1. Tick the checkbox next to applications that should not show up in the list.

2.

3. If you want to see your ignore

ignored applications to appear in the list.

4.

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.

3. Select the applications to include in the group.

4. new group.

P a g e | 45

LabStats User Guide

To edit an application group:

1. Select the group that you want to edit.

2. Click the pencil icon.


4.

To delete an application group:

1. Select the group that you want to delete.

2. Click the trash icon.

3.

You can filter for groups you've created by clicking on the magnifying glass.

P a g e | 46

LabStats User Guide

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).

4.

Power Scheme Options:

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.

P a g e | 47

LabStats User Guide

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:

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

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.

Message body: The actual message you want to appear on each station effected by the power

scheme.

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.

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.

3. Provide a name for the Schedule.

4.

5.

6. A calendar tool will now appear on the screen. Double click on a time you want to schedule a

scheme to be used.

P a g e | 48

LabStats User Guide

7. Provide a start time and end time.

8. Choose the scheme you want to use.

9.

10. days.

reoccur.

11.

12. Repeat steps 7-12 to schedule more schemes.

13. Select the groups/stations you want the schedule to apply to.

14. Click to save your changes.

JuicePress Settings

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

JuicePress Settings.

P a g e | 49

LabStats User Guide

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.

Wake On Lan Retry Interval: The duration to wait between retries in minutes.

Machine Override Settings

This section allows you to specify specific power usage settings for different models of computers.

P a g e | 50

LabStats User Guide

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.

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".

Click on the checkboxes for each machine that you want to override and then enter a Baseline kWh/Day

value. Click Save to apply the new value.

Group Override Settings

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

P a g e | 51

LabStats User Guide

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.

1.

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 Add a User Exception: 1.

2.

3.

4.

P a g e | 52

LabStats User Guide

To Remove a User Exception:

1. 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.


4.

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.

2. the

executable as shown in the known application list (i.e. word.exe).

3. Enter a description describing the exception.

4.

To Delete an Application Exception: 1. 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.


4.

P a g e | 53

LabStats User Guide

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

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.

3. Select the station the problem applies to.

4. Choose an appropriate category, severity, and status for the problem.

5. Provide a note that describes the problem in detail.

6.

P a g e | 54

LabStats User Guide

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.

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:

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

To add a new severity level:

1.

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.

P a g e | 55

LabStats User Guide

To remove a severity level:

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 severity level:

1. Select the severity level you wish to edit

2. Click on the pencil icon at the bottom of the page.


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:

1. Type a name for the status in the name box.

2. Type a description for the status in the description box.

3. Click the Add button.

To remove a status:

1.

To modify a status:

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


3. Click on the green checkmark to save changes.

P a g e | 56

LabStats User Guide

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.

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.

*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 Class Code: This code will appear under the "Class" dropdown in a Reservation

Request.

Name: The name of the class.

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 the Info tab click the

P a g e | 57

LabStats User Guide

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. My Reservations: Click this to see a list of all reservations you have submitted.

P a g e | 58

LabStats User Guide

Reservation Request

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.

Allow Public Use of Lab: If this is checked, then LabMaps and the public page will reflect available

stations. If it is unchecked, all stations will be shown as In Use or

Unavailable.

reservation system had been submitted.

Reservation Approval Page

Lab Managers can approve or deny reservation requests by navigating to Groups and Stations >>

P a g e | 59

LabStats User Guide

This page shows all the reservations users have made.

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 Approve/Deny choice.

P a g e | 60

LabStats User Guide

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:

You can embed LabMaps within your own website.

1. Click on the

P a g e | 61

LabStats User Guide

Map Creator

A basic LabMap can be created by following these steps:

1. Navigate to: Product Settings -> LabMaps - > Map Creator.

2.

3. Drag stations from the stations box.

4.

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

Display Options:

computer icon depending on which of the three bubbles you select.

Size Controls: The size controls allow you to control the size of your icons, station labels, and map

left to right to make the icon and label smaller or larger.

ap and the right box

specifies the height.

P a g e | 62

LabStats User Guide

My Images:

hand side of the map editor.

To use an icon, select the appropriate image from the drop down box and drag it

used as the background image.

To add a custom icon, click on the add icon. This will bring up a file browser for

you to select which file you want to upload. Once you have selected the icon you

want, simply provide a name and click the save button. This makes the icon

available for use.

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

4.

P a g e | 63

LabStats User Guide

5. 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.

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 This section allows you to control what color your LabMaps icons will be when the computers are on, off, and in use, as well as which types of maps to display on the Public Page (HTML or Map List). Please Note: The Silverlight Viewer is no longer available as of version 5.2.30303.134

Navigate to Product Settings -> LabMaps -> Map Settings

P a g e | 64

LabStats User Guide

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. the Add/Edit Printer page.

4. On the Add/Edit Printer page, enter the IP Address of the printer that you would like to add and click on

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

P a g e | 65

LabStats User Guide

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

Description: The Description is gathered from the printer. If the printer does not provide this information, it will show as Null

Serial Number:

The Serial Number is gathered from the printer. If the printer does not provide this information, it will show as Null

P a g e | 66

LabStats User Guide

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.

View the status information by highlighting the printer and selecting the Status tab.

PrinterStats Settings

To change the PrinterStats settings: 1. Log in to LabStats. 2. Navigate to Product Settings -> PrinterStats -> Settings.

labstats 5.2 user guide

Documents