IT Services



Energy Efficiency and Monitoring Services ITSS Guide




1. EEM ITSS guide

This is a guide to EEM functionality available to members of ITSS. A user guide for non-ITSS is available at which should be used in conjunction with this guide.



2. Introduction

An introduction to EEM is contained in the user guide. Normal service documentation is also available.



3. Permissions

Rights assigned to ITSS have been updated in the latest version of EEM. When a machine is regsitered the units with which the registrant is affiliated are stored with the machine. ITSS for these units have the rights to edit machines and schedules and to wake machines.



4. Task-based documentation

Almost all ITSS functionality can be reached by clicking "ITSS Facilities" at the bottom of eem.ox.ac.uk. The single exception to this is "System status", which is another link on the EEM home page and is a useful link to check that communications between the central EEM server and gateways are working.



4.1. Find a user or machine

  1. On the EEM home page click "ITSS facilities" at the bottom of the page
  2. Log in with Webauth
  3. In "Search for Users and Machines" choose whether you want to search for users or for machines. For users you can search by username or email address. For machines you can search by machine friendly name or by MAC address. The friendly name is, by convention, normally the DNS name of a machine but this is not necessarily the case since users are free to change it. Wildcards are automatically prepended and appended to your search term in all cases. Searches are also case-insensitive.
  4. Click search
  5. In the results of a person search, click the name of the person to view machines in schedules shared with that person
  6. In the results of a machine search, click the machine name to view the machine and its schedule (CHECK MANUAL GROUPS)


4.2. View all users and machines in a unit

  1. On the EEM home page click "ITSS facilities" at the bottom of the page
  2. Log in with Webauth
  3. In the "List of Units that you are ITSS for" click "View" next to the unit which you wish to view. All units for which you are registered ITSS are listed. Please note that in some cases (such as when a unit is renamed) there may be overlap between the lists presented for the old an new names
  4. On the resulting list click the name of the person to view machines in schedules shared with that person, click the machine name next to the person to wake that machine immediately


4.3. Manage a machine

  1. Find the machine using either of the methods listed above
  2. Click the machine name
  3. Edit the machine details at the top of the page as required
  4. Click "Save" at the bottom or top of the page


4.4. Manage a schedule

  1. Find the machine using either of the methods listed above
  2. Click the machine name
  3. Edit the schedule details in the middle of the page as required
  4. Click "Save" at the bottom or top of the page


4.5. Assigning a machine to a different schedule

  1. Find the machine using either of the methods listed above
  2. Click the machine name
  3. Choose the schedule from those that are shared with you with which to associate the machine at the bottom of the page
  4. Click "Save" at the bottom or top of the page


4.6. Waking a specific machine

A machine can be woken from either:
  1. The search results page - click the machine name
  2. The list of users in a unit - click the machine name
  3. The machine page itself - the "Wake machine"


4.7. Waking a specific schedule or group

All machines associated with a schedule or group can be woken from the machine page by clicking "Turn on group now"



4.8. Scan a network

Networks attached to gateways over which you have rights (assigned as part of registration of a gateway) can be scanned and the results viewed in the EEM web interface. Thus can be useful to prepare bulk registrations.
  1. On the EEM home page click "ITSS facilities" at the bottom of the page
  2. Log in with Webauth
  3. Click "scan a network"
  4. After a short delay machines detected by the gateway(s) will be displayed, together with whether ot not they are already registered in EEM


4.9. Bulk registration

Machines can be registered in bulk using csv formatted data. A network can be scanned to prepare the data:
  1. Scan a network (see above)
  2. On the page displaying results of a scan ensure that desired machines are ticked to be included. Note that only unregistered machines can be included. It is possible to select/deselect all machines detected by a certain gateway using the box next to the gateway name.
  3. Click prepare CSV. The bulk registration page will be displayed with the date pre-filled in with machine MAC addresses and friendly names. Please note that you may wish to modify this data before registering the machines (see below).
The fields available for bulk registration are (in order):
  • MAC address of the machine - required
  • Friendly name of the machine - by convention this is the DNS name found using RDNS - required
  • Power consumption of the device - optional, but recommended. Suggested values are:
    • Small Laptop: 10W
    • Standard Laptop: 40W
    • Small Desktop: 80W
    • All-in-one: 90W
    • Workstation: 200W
  • Device type - optional, Suggested values are:
    • Laptop or smaller
    • Desktop/Workstation
    • Server
    • Networked Printer
    • Router/Switch etc.
  • TSM node name - optional, leave blank if the machine isn't backed up to HFS
  • Name of schedule to assign machine to - optional, if left blank the machine will be assigned to an automatically names schedule for this bulk upload
  • Username of person with which the schedule named in 6 will be shared (this person does not need to have signed into EEM, but the username does need to exist)- optional
  • Additional usernames of people with whom the schedule will be shared, one per field - optional
To upload the file:
  1. On the EEM home page click "ITSS facilities" at the bottom of the page
  2. Log in with Webauth
  3. Click "Upload CSV data"
  4. Paste your data into the textarea
  5. Choose whether to create a new schedule (or schedules if you have included them in the data) or assign to an existing on
  6. Click "Register"
  7. If there are any errors in the upload these will be identified and displayed. If there are no errors then the machines will be registered


4.10. Transferring a machine from one person to another

There are two ways of transferring a machine to another person:
  1. The person with whom the machine's schedule is currently shared shares it with the new person, and then disassociates him or herself from the schedule (note that a member of ITSS with rights to manage the machine can associate the second user with the schedule, but not disassociate the first)
  2. A member of ITSS de-registers the machine (see below) which is then re-registered as normal

The first method is preferred since de-registration results in logs being archived off and so not being available in the web interface.



4.11. De-registering machines

A machine can be de-registered by ITSS only. De-registration is only available to members of ITSS with the registrant of the machine was affiliated to at registration.
  1. Find the machine (see above)
  2. If you have rights to de-register machine then a "De-register Machine" link will be available, click it
  3. Confirm that you wish to de-register the machine