Preface: Important Information 4 Technical Support 5

Transcription

1

2

3 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: Site Management 88 Client Settings 97 Licensing 99 Activity Log 101 Public Page 102 Mobile Page 103 Uninstalling LabStats 10

4

5 3 Preface This user guide explains how to install and use LabStats and its associated modules. Topics Important Information Technical Support

6 4 Preface 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: This document guides you how to use the product. LabStats Release Notes This document lists the new features, known issues, and closed issues.

7 Technical Support 5 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. support@computerlabsolutions.com Phone: or Option 2 Hours: 8:00am to 5:00pm MST Contact Information Web: sales@computerlabsolutions.com Phone: or Option 1 Fax: Hours: 8:00am to 5:00pm MST Address: Computer Lab Solutions 255 B St Suite 201 Idaho Falls, ID USA

8 6 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 Alternate Scheme Recommendations Pre-Installation Setup

9 System Requirements 7 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 Client Component *Demo purpose only, not meant for product environment. **Extended Edition of.net is required 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: 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: IIS 6, 7, 7.5 Database Server: SQL Server 2008 R2 Express SQL Server 2008 HARDWARE: 2.5 GHz Dual Core Processor

10 8 500 to 1000 Clients 4Gb RAM 10Gb Hard Drive Space above what s needed for the OS. 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 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 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 40Gb Hard Drive Space above what s needed for the OS.

11 Alternate Scheme Recommendations 9 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.

12 10 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 12. After installation, run the.net registration for IIS instructions below.

13 11 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 BIT OS: C:\windows\Microsoft.NET\Framework\V \aspnet_regiis.exe iru BIT OS: C:\windows\Microsoft.NET\Framework64\V \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 complete the installation.

14 12 Installing LabStats This chapter describes how to install LabStats. Topics Installing LabStats

15 Installing LabStats 13 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. 2. For this user guide we will review the Easy installation. You will be given the choice to use Cassini or IIS for the Web server. 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 100 client machines. IIS is a powerful web server created by Microsoft. It can handle a high number of computers quite well and is highly customizable to meet your organization s needs. To use IIS, you will

16 14 Installing LabStats 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. 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.

17 Installing LabStats 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. 4. Alternatively you can enter an existing key (we typically send these by . You will want to double click on the key within the before copying to ensure the full key is selected). Select Enter a Key and 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.

18 16 Installing LabStats 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. 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.

19 Installing LabStats 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. 10. Once you have completed the setup guide you can click the button to take you to the home page.

20 18 Installing LabStats 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: Help 1. Open your web browser and navigate to or 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. 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 Another useful tool of the LabStats Web Interface is the search feature. On most pages of the web interface you can click on the search icon, to bring up search boxes within any searchable field. Here is a search within 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.

21 Installing LabStats 19 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 MSI Wrapper: 1. Click to download the Windows (.msi) 2. This file should be over 2 MEG, if the file is less, your MSI didn t create properly. 3. The MSI will install silently using the following command 4. msiexec /qn /i C:\LabStatsMSIWrapper.msi

22 20 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 2. Change the LabStats installer s permission to Run the LabStats installer with root permissions.

23 21 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 Station Management Disassociate MAC Address

24 22 Groups and Stations 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. 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 want to set as default and at the bottom of the info tab click on Make Default Group.

25 Manage Groups and Stations 23 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). 5. Once the desired stations are selected, click the OK button to add the stations to the group. They should now appear in the Assigned Stations list.

26 24 Groups and 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: Title: Start Time: End Time: Status: Publish Level: Recurrence: Information relative to the event being scheduled. The time in which the event starts. The time in which the event ends. 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. 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. By checking this checkbox you will be given options to have this event repeat. 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.

27 Manage Groups and Stations 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. 4. Select the licenses you would like to apply and they will automatically apply to all stations within the group.

28 26 Groups and Stations 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 and the Netmask as , any IP address between and would automatically be added to the group. The Exclusion checkbox prevents stations with a 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.

29 Manage Groups and Stations 27 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. 2. Hide Selected: Select the station you wish to hide, then click this button. This will remove the station from the group, but keep it's Machine association and data history.

30 28 Groups and Stations 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. 7. The groups will now show up under the Associated Groups list

31 Group and Station Types 29 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. 5. Click the Submit button to save the changes.

32 30 Groups and Stations 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 You can assign types to stations and groups through the Manage Groups and Stations page.

33 Group and Station Types 31 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. 4. Choose the appropriate station type from the Station Type dropdown list. 5. The icon for the station will update the next time the page is refreshed.

34 32 Groups and Stations 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: Status Description: Status Color: Availability: Display Message: A name representing the status. A description used to help identify what the status is used for. The color you want the status to appear as on the schedule. This represents whether or not the group is available for use while this status in effect. If you set a display message, then the message will appear instead of the status name for schedules. For example, by default the Open status does not have a display message. This means that on schedules where this status is assigned, the word Open appears. If you assign a display message of The Lab is Open, the phrase The Lab is Open will appear on schedules in place of Open.

35 Group Status 33 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. 2. Select the status you want to delete from the dropdown list. 3. Click the Delete button.

36 34 Groups and Stations 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. 4. The list will now group stations by the selected the criteria. 5. Make any necessary changes to the source and target assignments. 6. Click the merge button.

37 Machine Assignments 35 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. 3. Select the station that will be linked to the machine. 4. Select a machine from the Unassigned Machines list. 5. Click the Assign Machine to Station button.

38 36 Groups and Stations 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. 3. Select an appropriate Station name and choose a group to assign it to. 4. Click the Create Station button.

39 Client Update Manager 37 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 Downgrade option at Administration >> Client Settings. This option is checked by default, you will want to keep it checked if you want to avoid downgrading clients by mistake.

40 38 Groups and Stations Lab Alerts Lab Alerts LabAlerts will show a message to selected stations. Title: Message: The title that shows up in the caption of our popup. The message (which can contain html) that will be displayed. 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.

41 Station Management 39 Station Management 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.

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

43 Product Settings 41 Product Settings This chapter explains how to use the Product Settings menu in LabStats. Topics LabStats AppUse JuicePress Trouble Tickets LabGrab LabMaps PrinterStats

44 42 Product Settings 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: Report Remote User As In Use: Anonymize Usage Statistics: Remove Old Login History Data: 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. If this box is checked, the computer will show up as in use when someone is using it remotely. If this box is checked, LabStats won't keep track of the actual user names. It will store irreversible hashes of the user names. If this box is checked, then user data older than the amount of days specified will be deleted.

45 LabStats 43 Remove Logins Older Than: Show Offline Clients as Available: Tracking Exception Settings This option specifies how long data should be kept for when the Remove Old Login History Data box is checked. 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" 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.

46 44 Product Settings 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 This page allows you to enter MAC addresses that aren t unique from computer to 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

47 LabStats 45 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: Novell: Environment Variable: Inactivity: 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. The Novell tracking type gathers user information from the Novell NetWare client. 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. 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.

48 46 Product Settings 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. Minimum Record Length: Auto Delete Old App Data: Delete App Data Older Than: Ignore New Apps by Default: Track New Apps by Default: AppUse Exception Settings The shortest amount of time an application can be used and still have its usage recorded in the database. If this box is selected, then data older than the specified amount of time will be deleted. This option specifies how long data should be kept for when the Auto Delete Old Application Data box is checked. When this box is checked, new applications will show up as ignored. 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. 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.

49 AppUse 47 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: Navigate to: Product Settings -> AppUse -> Known Applications. To change which applications are tracked: 1. Tick the box next to every application you want tracked. 2. Click Track Selected.

50 48 Product Settings 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. 3. Select the applications to include in the group. 4. Click Save to save the new group.

51 AppUse 49 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. You can filter for groups you've created by clicking on the magnifying glass.

52 50 Product Settings 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). Click the Save button to save your changes.

53 JuicePress 51 Power Scheme Options: Scheme Name: Display Color: Description: Client behavior is driven by: Show message after: Log user out after: Sleep monitor after: Action to take: Take action after: Message body: 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. 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. A short description that explains when this scheme is supposed to be used. 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. This setting will determine how soon after the scheme starts that you want the message to appear on the user s screen. How long to wait before logging out the user of the station. How long to wait before putting the monitor to sleep. What action to perform on the station. How soon the action will take place after the scheme starts or after the user has been inactive. 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. 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. 5. Click on the schedule name under the Schedules section. 6. A calendar tool will now appear on the screen. Double click on a time you want to schedule a scheme to be used.

54 52 Product Settings 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. 13. Select the groups/stations you want the schedule to apply to.

55 JuicePress 53 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: Power Usage When On: Power Usage When in Standby: Power Usage When Off: Default Baseline: Default Electricity Rate: Wake On Lan Retries: Wake On Lan Retry Interval: 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. The amount of watts a computer uses when it is fully on. The amount of watts a computer uses when it is standby mode. 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. The amount of KWh used per day in a lab. The cost of power per kwh where your organization is located. The number of retries when attempting a wakeup. The duration to wait between Wake on Lan retries in minutes. Machine Override Settings This section allows you to specify specific power usage settings for different models of computers.